Na maior parte do tempo, dois peers se conectam diretamente: o servidor kolo-dht que guardou um registro ajuda os dois a abrir um caminho através dos seus NATs. Alguns pares não conseguem se conectar assim, por exemplo quando os dois peers estão atrás de NATs que escolhem uma nova porta aleatória para cada destino, ou atrás de um firewall que só deixa o tráfego sair. Nesses casos, o kolo-relay pode ajudar.
Como funciona
Direto, ou por um relay
O relay nunca é uma alternativa silenciosa: quem escolhe é o seu app, pelo endereço e pela chave dele.
- Quando existe um caminho direto, os peers se conectam diretamente e nenhum relay participa.
- O alvo se conecta ao relay com kolo-secure e envia Reserve. O relay mantém a reserva por até uma hora.
- O iniciador se conecta ao relay e envia Connect com a chave do alvo.
- O relay avisa o alvo com Incoming e a chave do iniciador. O alvo aceita ou recusa, e o relay responde OK.
- O relay junta os dois streams. Dentro deles os peers abrem a própria conexão kolo-secure, de ponta a ponta, e o alvo confere que é o iniciador anunciado.
- O relay não consegue ler os pacotes. Ele fica sabendo as duas chaves, os dois endereços, quando a sessão começa e termina, e o tamanho e o ritmo dos pacotes. Cada sessão tem limites: 1 hora, 1 GiB em cada sentido, 60 segundos parada.
- Você roda um relay em um host com um endereço IPv4 alcançável.
- Um peer reserva uma vaga no relay com a sua chave.
- Outro peer pede essa chave ao relay, e o relay junta os dois e copia os bytes entre eles.
Os dois peers então rodam uma conexão kolo-secure comum, de ponta a ponta, através do relay. O relay repassa um texto cifrado que ele não consegue ler.
Desligado, a menos que você informe um
- Nada no Kolo escolhe um relay por conta própria. Um relay só é usado
quando a sua aplicação o informa: na
Config.Relaysda kolo-swarm, ou com-relay host:port@keynos exemplos do Kolo. - A kolo-dht nunca retransmite dados. Quando uma conexão direta não é
possível, o
Connectdela retornaErrUnreachable. - Com relays na lista, a kolo-swarm tenta primeiro a conexão direta e os relays quando ela falha. Com a lista vazia, ela não roda nenhum código de relay.
- Só com a kolo-relay, a sua aplicação passa o endereço e a chave do relay
em cada
ReserveeDial, e uma conexão por relay que ela abriu entra em um swarm por meio deAttach. - Não existe relay público. Você roda o seu com
kolo-node relay: veja Rode a sua própria infraestrutura.
Em qual conexão eu estou?
Primeiro a direta, o relay como alternativa. No primeiro contato, a kolo-swarm só tenta os relays depois que a conexão direta falhou, o que pode levar até 3 vezes 45 segundos quando os punches começam mas nunca conectam. Um peer que precisou de um relay antes é discado diretamente e pelos relays ao mesmo tempo, e uma conexão direta que funciona substitui a que passa pelo relay.
Em Go, Peer.Direct() é falso para um peer alcançado por um relay, e o
Conn() dele é um *kolorelay.Conn cujo RelayPublicKey() nomeia o
relay. A kolo-sync aceita as duas conexões do mesmo jeito.
Bom saber
O que o operador de um relay consegue ver, nas palavras do README da kolo-relay:
O que o relay fica sabendo: as duas chaves de cada sessão, os endereços dos dois clientes, quais chaves têm reservas, quando as sessões começam e terminam, e o tamanho e o ritmo dos pacotes internos. Ele não consegue ler nem alterar esses pacotes, e sempre pode descartá-los, atrasá-los ou encerrá-los.
O Kolo é só IPv4, no relay também.