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