kolo docsbeta

Relay

Cuando dos peers no pueden alcanzarse, un relay que ejecutes tú puede unirlos. Está desactivado a menos que lo actives.

En esta página

Casi siempre, dos peers se conectan directamente: el servidor de kolo-dht que guardó un registro les ayuda a abrir un camino a través de sus NAT. Algunas parejas no pueden conectarse así, por ejemplo cuando los dos peers están detrás de NAT que eligen un puerto aleatorio nuevo para cada destino, o detrás de un cortafuegos que solo deja salir tráfico. En esos casos, kolo-relay puede ayudar.

Cómo funciona

Todos los pasos

Directo, o a través de un relay

El relay nunca es una alternativa silenciosa: lo elige tu app, por su dirección y su clave.

  1. Cuando hay camino directo, los peers se conectan directamente y ningún relay participa.
  2. El destino se conecta al relay con kolo-secure y envía Reserve. El relay mantiene la reserva hasta una hora.
  3. El iniciador se conecta al relay y envía Connect con la clave del destino.
  4. El relay avisa al destino con Incoming y la clave del iniciador. El destino acepta o rechaza, y el relay responde OK.
  5. El relay une los dos streams. Dentro de ellos los peers abren su propia conexión kolo-secure, de extremo a extremo, y el destino comprueba que es el iniciador anunciado.
  6. El relay no puede leer los paquetes. Conoce las dos claves, las dos direcciones, cuándo empieza y termina la sesión, y el tamaño y el ritmo de los paquetes. Cada sesión tiene límites: 1 hora, 1 GiB en cada sentido, 60 segundos sin actividad.
  1. Ejecutas un relay en una máquina con una dirección IPv4 accesible.
  2. Un peer reserva una plaza en el relay con su clave.
  3. Otro peer le pide al relay esa clave, y el relay une a los dos y copia los bytes entre ellos.

Después, los dos peers establecen una conexión normal de kolo-secure de extremo a extremo, a través del relay. El relay reenvía texto cifrado que no puede leer.

Desactivado a menos que lo indiques

  • Nada en Kolo elige un relay por su cuenta. Un relay solo se usa cuando tu aplicación lo indica: en Config.Relays de kolo-swarm, o con -relay host:port@key en los ejemplos de Kolo.
  • kolo-dht nunca retransmite datos. Cuando no es posible una conexión directa, su Connect devuelve ErrUnreachable.
  • Con relays en la lista, kolo-swarm intenta primero la conexión directa y prueba los relays cuando esta falla. Con la lista vacía no ejecuta nada de código de relay.
  • Con kolo-relay solo, tu aplicación pasa la dirección y la clave del relay a cada Reserve y cada Dial, y una conexión a través de un relay que haya abierto entra en un swarm mediante Attach.
  • No hay ningún relay público. Ejecutas el tuyo con kolo-node relay: consulta Ejecuta tu propia infraestructura.

¿Por qué conexión voy?

Primero la directa, el relay como alternativa. En el primer contacto, kolo-swarm solo prueba los relays cuando la conexión directa ha fallado, lo que puede tardar hasta 3 veces 45 segundos cuando las perforaciones empiezan pero nunca conectan. A un peer que antes necesitó un relay se le llama directamente y a través de los relays a la vez, y una conexión directa que funciona sustituye a la que pasa por el relay.

En Go, Peer.Direct() es false para un peer al que se llega a través de un relay, y su Conn() es un *kolorelay.Conn cuyo RelayPublicKey() identifica el relay. kolo-sync acepta cualquiera de las dos conexiones de la misma forma.

Conviene saber

Lo que puede ver quien opera un relay, en palabras del README de kolo-relay:

Lo que el relay llega a saber: las dos claves de cada sesión, las direcciones de los dos clientes, qué claves tienen reservas, cuándo empiezan y terminan las sesiones, y el tamaño y el ritmo de los paquetes internos. No puede leerlos ni cambiarlos, y siempre puede descartarlos, retrasarlos o cortarlos.

Kolo solo usa IPv4, también en el relay.