Um node Lightning pode estar ligado, sincronizado e com canais abertos e, mesmo assim, ser invisível para o resto da rede. Ele consegue sair: paga, roteia pelos canais que já tem e abre canais novos. Mas ninguém consegue entrar. Outro node que queira abrir canal com você, um provedor de liquidez ou um peer tentando se reconectar depois de uma queda batem na porta e não encontram ninguém.
Olhando de dentro, não dá para perceber: o painel do node mostra tudo verde. É preciso olhar de fora, e é isso que o teste “Meu node está acessível?” do BR⚡LN faz.
Como o teste funciona
Você cola a pubkey do node. O teste busca no grafo público da Lightning os endereços que o node anuncia e tenta se conectar a cada um, pela clearnet e pelo Tor, como faria qualquer outro node. Se quiser testar um endereço específico, use o formato pubkey@ip:porta.
Ao conectar, o teste faz o começo do handshake da Lightning, a parte do protocolo que cifra a conversa entre dois nodes. Esse primeiro passo só é respondido corretamente por quem tem a chave privada daquela pubkey. Por isso, “acessível” aqui quer dizer mais que porta aberta: quer dizer que quem respondeu naquele endereço é o seu node. Um testador de portas comum diria que está tudo certo mesmo se outro programa, ou outro node, estivesse ocupando a porta.
Logo depois desse passo, a conexão fecha. O teste não abre canal, não pede nada ao node e não precisa de nenhum acesso a ele. E, para não virar um scanner de portas, ele exige a pubkey, só se conecta a IPs públicos e aceita até 10 testes por hora de cada lugar.
Os quatro resultados
✅ Acessível pela clearnet: o node respondeu de fora, pela internet comum. Qualquer node consegue se conectar e abrir canal com você.
🧅 Acessível só pelo Tor: funciona, mas só para quem também usa Tor. As conexões são mais lentas e oscilam, e muitas carteiras e provedores de liquidez preferem clearnet.
❌ Não acessível de fora: o node anuncia endereço, mas nenhum respondeu.
⚠️ O node não anuncia endereço: ninguém consegue chegar até ele por conta própria. Ele só conversa com quem ele mesmo procura.
Abaixo do resumo, cada endereço aparece com o seu resultado e, quando responde, o tempo de conexão em milissegundos. Endereços IPv6 aparecem como não testados, porque o servidor do teste não tem IPv6.
O que fazer em cada caso
O node não anuncia endereço
O node precisa dizer à rede onde encontrá-lo. No LND, isso é a opção externalip, para a clearnet, ou o Tor ligado (tor.active e tor.v3), para anunciar um endereço .onion. No Core Lightning, é a opção announce-addr. Depois de mudar, reinicie o node e dê um tempo para o novo anúncio se espalhar pelo grafo.
Não acessível pela clearnet
Vale conferir nesta ordem:
O node está no ar? Parece óbvio, mas é a primeira causa.
A porta. A padrão da Lightning é a 9735. Ela precisa estar liberada no firewall da máquina e redirecionada no roteador para o IP interno do node.
O endereço anunciado está certo? Se o IP da sua casa mudou, o grafo ainda pode ter o antigo. Teste com
pubkey@seu-ip-de-agora:9735: se esse responde e o anunciado não, o problema é o anúncio, não a rede.CGNAT. Muitas operadoras no Brasil colocam vários clientes atrás de um mesmo IP público. Se o IP que aparece no seu roteador, na parte de internet (WAN), está entre 100.64 e 100.127, você está atrás de CGNAT, e redirecionar porta não adianta. As saídas são pedir um IP público à operadora (algumas fazem isso), ficar só no Tor ou usar um endereço público fora da sua casa.
Acessível só pelo Tor
Se foi escolha sua, por privacidade, tudo bem: o node funciona. Se você quer também a clearnet, o guia Node acessível por Tor e clearnet compara as opções, do modo híbrido à clearnet sem expor a sua casa.
O .onion não respondeu
O teste pelo Tor pode levar até 30 segundos, e o Tor oscila: repita antes de concluir que caiu. Se continuar falhando, confira se o Tor do node está no ar. Se ele foi reinstalado e gerou um endereço novo, o grafo pode estar com o antigo até o node se anunciar de novo.
Clearnet sem expor a sua casa
Abrir a porta direto da sua internet mostra o IP real da sua casa para a rede inteira. Para os membros do BR⚡LN Club, a BR⚡LN Clearnet dá ao node um endereço público, no Brasil ou nos EUA, sem abrir portas no roteador e sem depender da operadora, o que também resolve o CGNAT. É um serviço pago à parte, com preço subsidiado pelo clube.
Acessível hoje, e amanhã?
Um teste mostra o node naquele momento. Uma atualização, uma troca de roteador ou o IP que muda podem deixar o node inacessível sem você perceber.
Com a conta grátis do BR⚡LN, você acompanha o seu node em Meu node e recebe o Raio-X por e-mail toda semana. O acesso por clearnet e Tor é um dos itens da nota.
Criar a conta grátis e acompanhar o meu node
Dentro do BR⚡LN Club, o Node Check testa a clearnet e o Tor do seu node a cada 30 minutos e avisa no chat do clube quando algo muda. No chat você também encontra quem já passou pelo mesmo problema, do CGNAT ao .onion que sumiu.