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
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.
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.
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.