Caso de uso

Peers atrás do roteador de casa.

A maioria dos pares se conecta direto através dos seus NATs, com uma pequena ajuda do nó que guardou o anúncio. Para os que não conseguem, um relay que você mesmo roda pode uni-los.

As peças

As bibliotecas necessárias. Cada uma tem passos de instalação e um exemplo compilado na documentação.

Como funciona na prática

  1. Anunciar e procurar

    Um peer anuncia o seu topic com um registro assinado nos servidores mais próximos dele, e procura os outros do mesmo jeito.

  2. Atravessar o NAT

    O servidor que guardou o registro repassa um pedido de conexão, e os dois peers abrem um caminho direto através dos seus NATs. Nada repassa dados da aplicação.

  3. Um relay, só se você pedir

    Quando os dois NATs escolhem portas aleatórias, o caminho direto falha com um erro. O seu app pode então passar o endereço e a chave de uma kolo-relay que você roda, e os peers se conectam de ponta a ponta através dela.

Bom saber

Nada no Kolo escolhe um relay nem recorre a um por conta própria. O relay repassa texto cifrado que não consegue ler, mas vê quais chaves conversam, quando e quanto. Um relay sem lista de permitidos deixa qualquer um usar a sua banda. O Kolo é só IPv4.

Próximo passo