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
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.
- Cuando hay camino directo, los peers se conectan directamente y ningún relay participa.
- El destino se conecta al relay con kolo-secure y envía Reserve. El relay mantiene la reserva hasta una hora.
- El iniciador se conecta al relay y envía Connect con la clave del destino.
- El relay avisa al destino con Incoming y la clave del iniciador. El destino acepta o rechaza, y el relay responde OK.
- 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.
- 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.
- Ejecutas un relay en una máquina con una dirección IPv4 accesible.
- Un peer reserva una plaza en el relay con su clave.
- 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.Relaysde kolo-swarm, o con-relay host:port@keyen los ejemplos de Kolo. - kolo-dht nunca retransmite datos. Cuando no es posible una conexión
directa, su
ConnectdevuelveErrUnreachable. - 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
Reservey cadaDial, y una conexión a través de un relay que haya abierto entra en un swarm medianteAttach. - 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.