BR⚡LN Club

Guia BR⚡LN

Como montar um node Lightning em casa

Um node Lightning é um computador ligado o tempo todo que guarda os seus canais e os seus sats, sem depender de empresa nenhuma. Este guia mostra o caminho com o LightningOS, o sistema grátis e de código aberto mantido pelo BR⚡LN.

O que você precisa

  • Um computador só para o node, ligado 24 horas: um mini PC x86 (amd64) ou um Raspberry Pi 5.
  • Um SSD. Rodando o Bitcoin Core completo em casa, a blockchain ocupa centenas de gigabytes: conte com 1 TB ou mais. Usando um Bitcoin remoto (veja o passo 3), um SSD menor basta.
  • Internet estável e, se possível, um nobreak: node que cai toda hora perde canais e reputação.
  • Alguns sats on-chain para abrir os primeiros canais.

Passo 1: o sistema operacional

Instale o Ubuntu Server no mini PC (ou o Debian 12 no Raspberry Pi 5, que tem um guia próprio no repositório). Uma instalação limpa, só com o acesso SSH, é o ponto de partida ideal.

Passo 2: instalar o LightningOS

Num Ubuntu limpo, um comando instala tudo: Postgres, Tor, o LND e o painel de controle.

curl -fsSL https://raw.githubusercontent.com/jvxis/brln-os-light/main/lo_bootstrap.sh | sudo ACCEPT_MIT_LICENSE=1 bash

No fim, o instalador mostra o endereço do painel, que abre pelo navegador de outro computador da mesma rede, na porta 8443. Se você já tem um node com LND e Bitcoin rodando, não use esse comando: o repositório tem um instalador próprio para nodes existentes.

Importante: o painel do LightningOS é para a sua rede local. Nunca abra a porta 8443 no roteador para a internet; para acessar de fora, use uma VPN como o Tailscale.

Passo 3: o Bitcoin do node

Todo node Lightning precisa conversar com um node Bitcoin. Há dois caminhos:

  • Bitcoin Core em casa: você valida tudo sozinho, mas a primeira sincronização leva dias.
  • Bitcoin remoto: o assistente do LightningOS aceita credenciais de um Bitcoin RPC. Os membros do BR⚡LN Club usam o node Bitcoin do clube e começam no mesmo dia, sem baixar a blockchain inteira.

Passo 4: a carteira e a seed

O assistente cria a carteira do LND e mostra a seed, uma lista de 24 palavras. Anote em papel, guarde longe do computador e nunca fotografe nem salve na nuvem. Sem a seed não há como recuperar os fundos on-chain se o disco morrer.

Passo 5: o primeiro canal

Deposite sats na carteira on-chain do node e abra um ou dois canais com nodes estáveis e bem conectados. Canais muito pequenos rendem pouco e muitos nodes grandes só aceitam canais a partir de um tamanho mínimo; no Explorador das ferramentas você vê os canais e as taxas de qualquer node antes de escolher.

Passo 6: proteja os canais

  • Backup dos canais: o LND mantém um arquivo channel.backup que muda a cada canal aberto ou fechado. Copie esse arquivo para fora do node sempre que ele mudar.
  • Watchtower: uma torre de vigia reage se alguém tentar fechar um canal seu com um estado antigo enquanto o seu node está fora do ar. O clube oferece a sua para os membros.

Passo 7: teste o node de fora

Com o node no ar, faça o Raio-X do seu node: uma nota de 0 a 100 com acesso, canais, concentração e taxas. E use o Meu node está acessível? para confirmar que outros nodes conseguem se conectar ao seu pela internet e pelo Tor. Para entender as opções de conexão, leia Tor, clearnet ou os dois.

Perguntas frequentes

Quanto custa montar um node Lightning?

O LightningOS é grátis. O custo é o do computador e do SSD, mais os sats que você coloca nos canais. Um mini PC usado e um SSD já servem para começar.

Preciso deixar o node ligado o tempo todo?

Sim. Um node fora do ar não encaminha pagamentos, e os peers acabam fechando canais com quem vive desconectado.

Dá para usar um Raspberry Pi?

Dá: o LightningOS tem instalação para Raspberry Pi 5 com Debian 12. Use um SSD, não cartão de memória.

Preciso baixar a blockchain inteira?

Só se for rodar o Bitcoin Core em casa. Com um Bitcoin remoto, como o do BR⚡LN Club para membros, o node começa no mesmo dia.