Nós e infraestrutura

Como configurar um nó Bitcoin completo

31 de janeiro de 2024 · 21 min de leitura · Atualizado em
Uma mão ao lado de um minicomputador, um disco externo e um cabo de rede preparados para montar um nó em casa.

Este guia é uma tradução do original em inglês, que é o texto de referência. Ler em inglês

Rodar um nó Bitcoin (em inglês) é um passo fundamental para ter controle sobre as próprias finanças na era digital. Aqui você vai ver como funcionam os nós de Bitcoin, que papel têm na rede e quais são as opções para rodar um nó próprio.

A descentralização do Bitcoin se apoia na rede de nós. Cada nó valida todos os blocos e todas as transações conforme as regras de consenso. Os nós de arquivo também mantêm uma cópia completa da blockchain, enquanto os nós podados guardam apenas os blocos recentes. Essa arquitetura distribuída impede que uma única entidade controle ou manipule a rede. Por isso, rodar um nó é fundamental para preservar duas propriedades centrais do Bitcoin, a resistência à censura e a soberania monetária.

Um nó completo permite que você verifique transações por conta própria, preserve sua privacidade (em inglês) e ajude a tornar a rede mais resistente. Você pode conferir o estado da blockchain sem depender de informações de terceiros, como propõe o princípio criptoanarquista “não confie, verifique”.

Montar um nó Bitcoin mudou muito desde o início da rede. No começo, só dava para rodar o Bitcoin Core em computadores de uso geral. Hoje há hardware especializado e várias distribuições de software. Você pode montar o seu com um computador de placa única, como uma Raspberry Pi, ou escolher um aparelho de linha premium que venha pronto para ligar e priorize a facilidade de uso e a confiabilidade.

Os pacotes e sistemas operacionais feitos para nós Bitcoin facilitaram muito a montagem. A Umbrel, a Start9 e o myNode têm interfaces simples que cuidam de boa parte da complexidade técnica e preservam a segurança e a autonomia de um nó completo. Essas plataformas costumam oferecer serviços extras, como funções da rede Lightning, exploradores de blocos e interfaces para carteiras.

A rede Lightning amplia as funções do nó com transações rápidas e de baixo custo que mantêm as garantias de segurança da camada base. Se rodar um nó Lightning junto com seu nó completo de Bitcoin, você vai poder processar pagamentos, gerenciar canais e participar da economia da Lightning à medida que ela cresce. Essa segunda camada ganha importância conforme o Bitcoin amplia sua capacidade para atender à demanda mundial.

Serviços como o BTCPay Server permitem usar um nó pessoal também no comércio ou numa empresa. Hospedando o próprio sistema de pagamentos, comerciantes podem aceitar bitcoins sem depender de terceiros, manter o controle das finanças, reduzir custos e ganhar privacidade. É um passo em direção ao dinheiro eletrônico de pessoa para pessoa que o whitepaper do Bitcoin descreve.

Um servidor Electrum merece atenção à parte. Se rodar o servidor junto com um nó completo, você vai poder passar às carteiras Electrum dados da blockchain que verificou por conta própria. Assim, evita depender de servidores de terceiros que poderiam comprometer a privacidade ou manipular dados das transações. Essa é a configuração de referência para a autonomia e a segurança da carteira.

O hardware importa na hora de escolher como montar o nó. Uma Raspberry Pi pode dar conta do básico. Tarefas mais exigentes, como rotear pagamentos na Lightning ou rodar uma instalação do BTCPay Server com alto volume, podem exigir hardware mais potente. O espaço necessário cresce com a blockchain, então planejar e gerenciar o armazenamento faz parte da operação do nó.

Os nós Bitcoin tendem a integrar mais serviços e oferecer interfaces melhores, mantendo os princípios de autonomia e descentralização. O trabalho de desenvolvimento continua reduzindo as barreiras técnicas e ampliando as funções para que mais pessoas possam rodar um nó. Os nós continuam com um papel central na segurança e na resistência da rede.

Em resumo, rodar um nó Bitcoin é um desafio técnico e uma declaração de princípios. É uma forma de praticar a autonomia e participar da rede, duas ideias centrais da revolução do Bitcoin. Conforme o ecossistema amadurece, as ferramentas e plataformas devem ganhar recursos e ficar mais fáceis de usar. Os nós continuam essenciais para o funcionamento e a segurança da rede.

Guia passo a passo

Montar um nó Bitcoin completo do zero exige escolher o hardware, instalar o software, configurar a rede e integrar os serviços. Com este guia, você vai montar, em ordem, um nó pronto para validar a camada base e operar na rede Lightning.

O nó aparece como uma pilha com uma camada por passo. Na base está o passo 1, com o hardware e o Linux, um SSD de 2 TB, um firewall e chaves SSH. O passo 2, em laranja, é o Bitcoin Core, que baixa e verifica cada bloco da rede Bitcoin. Acima, os passos 3 e 4 ficam lado a lado. O servidor Electrum, Fulcrum ou Electrs, deixa uma carteira como o Sparrow no seu notebook dispensar servidores de terceiros. A Lightning, com o LND ou o Core Lightning, mantém canais com outros nós Lightning. No alto, o passo 5 reúne painéis e aplicativos como o ThunderHub, o RTL, o mempool e o BTCPay. Você pode acessá-los de qualquer lugar pelo Tor, por uma VPN ou por SSH. O passo 6 sai do computador e mostra os backups das palavras-semente, dos canais e das configurações. Um sistema como o umbrelOS ou o StartOS faz os passos 2 a 5 por um painel web.
Cada passo acrescenta uma camada apoiada na de baixo. O Bitcoin Core precisa terminar a primeira sincronização para o servidor Electrum e a Lightning poderem usá-lo. Os backups do passo 6 são a única parte guardada fora do computador.

Passo 1: escolha e prepare o hardware. Escolha o hardware conforme o desempenho de que você precisa e seu orçamento. Para uma configuração confiável, use um mini-PC (Intel NUC, Beelink ou similar) com processador de pelo menos quatro núcleos, 8 GB de RAM e um SSD NVMe de 2 TB. O disco de 2 TB dá margem para a blockchain crescer, já que a cadeia completa ocupa cerca de 780 GB no fim de 2026. Se o orçamento estiver apertado, uma Raspberry Pi 5 com 8 GB de RAM e um SSD externo por USB 3.0 funciona, mas a sincronização inicial leva mais tempo. Reserve 2 TB para ela também. Com os dados para desfazer blocos e o estado da cadeia, o Bitcoin Core 32.1 pede cerca de 900 GB, então um disco de 1 TB fica quase cheio hoje. Grave o Ubuntu Server ou o Debian minimal na unidade de inicialização e faça a configuração básica. Crie um usuário comum com sudo e pare de fazer login como root. Configure o SSH para login por chave e desative a autenticação por senha. Ative um firewall (ufw) que permita apenas o SSH e as portas que você vai usar. Ative o unattended-upgrades para as correções de segurança. Se alguém puder roubar o computador, escolha criptografia de disco completo (LUKS) no instalador. Você vai ter que digitar a passphrase após cada reinicialização.

A opção pronta para instalar. Se preferir evitar a administração do Linux, um sistema para nós faz os passos 2 a 5 para você por um painel web e uma loja de aplicativos. O umbrelOS foi feito para o Umbrel Home. Também roda no seu hardware, com suporte da comunidade da Umbrel, numa Raspberry Pi 5 ou 4 a partir de um cartão microSD, ou num PC x86 a partir de uma unidade USB ou instalado num disco interno. Acesse pelo endereço umbrel.local. O StartOS roda no Server One da Start9, na maioria dos computadores x86_64, em placas ARM64 e RISC-V e na Raspberry Pi 4. A Pi 5 fica de fora e a própria Start9 desaconselha a Pi para Bitcoin. Uma postagem no fórum em novembro de 2023 cita o cofundador Matt Hill: “Não recomendamos mais a Pi para Bitcoin em nenhuma configuração.” Instale primeiro o Bitcoin Core e espere terminar a sincronização. Depois, instale o Electrs ou o Fulcrum e confira a conexão pelo Sparrow conforme o passo 3. Você abre mão do controle de cada ajuste em troca de um ciclo de atualizações que outra pessoa mantém.

Passo 2: instale e configure o Bitcoin Core. Baixe a versão mais recente do Bitcoin Core e verifique as assinaturas GPG com as chaves de assinatura publicadas. Extraia o binário e crie um usuário do sistema só para rodar o processo. O código-fonte do Bitcoin Core inclui uma unidade do systemd (contrib/init/bitcoind.service) que roda o processo como usuário bitcoin, reinicia o processo se ele falhar e o isola do resto do sistema. Ajuste os caminhos e use a unidade para evitar iniciar o bitcoind à mão. Crie o arquivo bitcoin.conf com as configurações essenciais. Use server=1 para ativar a RPC e txindex=1 se for rodar o Fulcrum, pois o Electrs dispensa esse ajuste. Use dbcache=4096 para alocar RAM e acelerar a primeira sincronização. Quando acabar, reduza o valor ou apague a linha. Desde o Bitcoin Core 31, o padrão é 1.024 MiB em computadores com pelo menos 4 GiB de RAM. Inclua suas credenciais de rpcauth. Inicie o Bitcoin Core e comece o download inicial de blocos. Acompanhe com bitcoin-cli getblockchaininfo e consulte o campo verificationprogress.

Está faltando espaço no disco? prune=550 (o mínimo em MiB) guarda só os blocos recentes depois de validar todos. O nó continua conferindo cada regra de consenso. A poda é incompatível com txindex e com o Electrs e o Fulcrum, o que impede o passo 3. Se desativar a poda depois, você vai precisar baixar toda a cadeia de novo. Decida antes de começar a sincronização.

Três linhas de bitcoin.conf e quanto custa mudar cada uma depois da primeira sincronização. dbcache=4096, com padrão de 1.024 MiB (450 MiB em computadores com menos de 4 GiB de RAM), aumenta o cache de moedas na RAM e acelera a primeira sincronização. Para mudar depois, basta editar a linha e reiniciar. txindex=1, desativado por padrão, cria um índice de todas as transações. O Fulcrum precisa dele e o Electrs não. Se ativar depois, o Bitcoin Core monta o índice com os blocos que já estão no disco, o que leva horas. prune=550 apaga blocos antigos depois de verificá-los. O padrão, 0, guarda todos os blocos. A poda é incompatível com txindex=1, Electrs e Fulcrum. Se desativá-la depois, o nó baixa toda a cadeia de novo, cerca de 800 GB. Escolha primeiro o servidor Electrum, pois duas dessas três linhas dependem dele.
Duas dessas linhas custam tempo se você mudar depois de sincronizar. Para mudar dbcache, basta reiniciar. Se ativar txindex depois, o nó leva horas para montar o índice. Se desativar a poda, vai precisar baixar toda a cadeia de novo.

Rede e Tor. Por padrão, o Bitcoin Core se conecta a outros nós pela clearnet. Isso mostra seu endereço IP a esses nós e revela ao seu provedor de internet que você roda um nó. Para que o tráfego com outros nós passe pelo Tor, instale o Tor (sudo apt install tor) e adicione proxy=127.0.0.1:9050 e listen=1 ao bitcoin.conf. Se quiser que as conexões automáticas de saída cheguem só a nós onion, adicione onlynet=onion. O Bitcoin Core cria o próprio serviço onion pela porta de controle do Tor, de modo que outros nós possam acessar o seu sem encaminhar portas. Em /etc/tor/torrc, ative ControlPort 9051, CookieAuthentication 1, CookieAuthFileGroupReadable 1 e DataDirectoryGroupReadable 1. Reinicie o Tor e adicione o usuário que roda o bitcoind ao grupo do Tor (debian-tor no Debian e no Ubuntu). O guia do Tor do Bitcoin Core (doc/tor.md) explica que o nó continua escutando em todas as interfaces. Um nó que descobrir seu endereço pode se conectar pela clearnet. Para evitar isso, defina também bind=127.0.0.1:8334=onion. Confira com bitcoin-cli -netinfo. Seu endereço .onion aparece nos endereços locais. Para um nó híbrido, com clearnet para velocidade e Tor para os nós onion, deixe de fora proxy e onlynet e defina onion=127.0.0.1:9050. Desse modo, só passam pelo Tor as conexões .onion. Se sua conexão tiver limite de dados, use maxuploadtarget= seguido de um limite diário em MiB para que o envio de dados a outros nós não passe desse valor.

Seu nó tem duas portas. A porta onion, 127.0.0.1:8334, só aceita conexões do Tor que roda na mesma máquina. Os outros nós .onion chegam ao seu endereço .onion pelo Tor. O Tor cria esse endereço quando o Bitcoin Core o pede pela porta de controle do Tor, 9051. Suas conexões de saída passam pelo Tor e chegam só a nós .onion. A outra porta é a 8333, que escuta em todas as interfaces de rede. Um nó que saiba seu IP pode se conectar diretamente pela clearnet. Adicionar bind=127.0.0.1:8334=onion fecha essa porta. As linhas de bitcoin.conf funcionam assim. proxy=127.0.0.1:9050 faz suas conexões saírem pelo Tor. onlynet=onion só deixa sair para nós .onion. listen=1 aceita conexões de entrada, que proxy= desativa. bind=127.0.0.1:8334=onion faz o nó escutar só na porta onion. Confira com bitcoin-cli -netinfo, que lista seu endereço .onion entre os endereços locais.
A linha bind fecha a porta da clearnet. Pelo Tor, outros nós chegam ao seu endereço .onion. Sem bind=127.0.0.1:8334=onion, a porta 8333 continua escutando em todas as interfaces de rede.

Passo 3: instale um servidor Electrum para conectar carteiras. Quando o nó terminar de sincronizar, instale um servidor do protocolo Electrum para conectar suas carteiras. O Fulcrum e o Electrs são as duas opções principais. O Electrs guarda um índice pequeno, de cerca de 10% do tamanho da blockchain, e foi feito para uso pessoal. O Fulcrum monta um índice bem maior (o README pedia 133 GB de disco em agosto de 2023) e precisa de txindex=1 no Bitcoin Core. Configure o servidor Electrum para se conectar à interface RPC do Bitcoin Core. A primeira indexação lê toda a blockchain do nó e leva muitas horas. O README do Fulcrum estima de 4 a mais de 20 horas, dependendo do computador e do disco. Quando acabar, conecte uma instância da Sparrow Wallet ao endereço do servidor e confira se ela mostra a altura de bloco correta.

Passo 4: configure o serviço da Lightning. Instale o LND (Lightning Network Daemon) ou o Core Lightning junto com seu nó completo. Configure o serviço para buscar os dados da blockchain no Bitcoin Core local. Gere uma semente nova para a carteira Lightning e grave-a em metal imediatamente. Financie o primeiro canal com uma transação on-chain para o endereço de financiamento da carteira Lightning. Abra um canal com um nó de roteamento bem conectado. Procure no 1ML ou no Amboss nós com boa disponibilidade, boas conexões e políticas de taxas razoáveis. Para conseguir rotear pagamentos, comece com um canal de 1.000.000 a 5.000.000 satoshis.

Passo 5: instale ferramentas para gerenciar e monitorar o nó. Instale uma interface web para monitorar e controlar os serviços do nó. O ThunderHub e o Ride The Lightning oferecem painéis completos para gerenciar canais Lightning, ver o histórico de pagamentos e configurar o nó. Você pode hospedar o mempool.space para ter um explorador de blocos privado e um visualizador do mempool. Se tiver um comércio, o BTCPay Server permite aceitar pagamentos em bitcoins direto no nó. Acesse os painéis por um serviço onion do Tor, uma VPN ou um túnel SSH para manter as portas fechadas para a internet. Um proxy reverso com HTTPS criptografa a conexão, mas mantém a página de login exposta na internet. Se precisar de um proxy desses, por exemplo para uma loja BTCPay em que os clientes pagam, proteja-o como explica o erro 4.

Passo 6: automatize os backups e organize a manutenção. Automatize o backup dos dados essenciais, incluindo o backup estático de canais (SCB, Static Channel Backup), os arquivos de carteira e as configurações do nó. Copie o arquivo SCB para um destino remoto ou armazenamento criptografado na nuvem sempre que mudar. O LND regrava channel.backup quando um canal abre ou fecha, e o Core Lightning atualiza emergency.recover quando um canal abre. Um script que monitora o arquivo detecta cada mudança. Uma tarefa do cron agendada em intervalos pode perder alguma. Ao restaurar o SCB junto com a semente, o saldo já consolidado dos canais voltam on-chain. O nó da outra ponta fecha cada canal que tem com você. Configure atualizações automáticas do sistema para instalar as correções de segurança. Monitore o espaço livre e crie um alerta para quando cair abaixo de 50 GB. Organize a manutenção. Procure atualizações do Bitcoin Core e da Lightning todo mês, confira os canais toda semana e verifique a integridade dos backups a cada trimestre.

O que cada backup recupera quando o disco do nó falha. A semente da Lightning são 24 palavras no LND ou o arquivo hsm_secret no Core Lightning (12 palavras nos nós criados desde a versão 25.12). Grave a semente em metal uma vez. Ao restaurá-la num nó novo, você recupera seus bitcoins on-chain. O backup dos canais, channel.backup no LND ou emergency.recover no Core Lightning, fica fora do computador e precisa ser copiado sempre que um canal abre ou fecha. Para restaurar num nó novo, você precisa também da semente. Os canais não voltam abertos. O nó da outra ponta fecha cada canal, a sua parte volta à sua carteira on-chain e a parte dele volta à carteira dele. Copie também as configurações, bitcoin.conf, lnd.conf e torrc, sempre que mudar alguma. A blockchain dispensa backup, pois o nó baixa de novo. Nunca restaure uma cópia antiga de channel.db do LND. Você pode perder os fundos de um canal.
A semente e o backup dos canais funcionam juntos. A semente recupera seus bitcoins on-chain. Se restaurar o backup dos canais junto com a semente, sua parte de cada canal volta on-chain quando o nó da outra ponta fecha o canal.

Erros comuns a evitar

1. Usar um dbcache baixo demais durante o download inicial de blocos. O cache do Bitcoin Core afeta muito a velocidade de sincronização. Desde o Bitcoin Core 31, o padrão é 1.024 MiB em computadores com pelo menos 4 GiB de RAM (continua em 450 MiB em máquinas com menos memória e versões anteriores). Um cache pequeno exige muito mais leituras e gravações no disco durante a IBD. Se tiver RAM suficiente, aloque de 2.048 a 4.096 MB para dbcache durante a primeira sincronização. Depois, reduza o valor ou volte ao padrão para a operação normal.

2. Abrir canais Lightning antes de entender a liquidez. Muitos operadores novos abrem vários canais pequenos com nós escolhidos ao acaso. Isso reduz a capacidade de roteamento e desperdiça taxas on-chain. Antes de abrir canais, estude como a rede se conecta, identifique nós centrais bem conectados e planeje os canais para oferecer rotas úteis. Como abrir cada canal custa uma taxa on-chain, boas escolhas poupam dinheiro e ajudam o nó a funcionar melhor desde o início.

3. Deixar para ativar o índice de transações quando precisar dele. Para obter o melhor desempenho, defina txindex=1 antes ou durante a primeira sincronização. Se ativar depois, o Bitcoin Core vai ter que reler toda a blockchain para montar o índice, o que pode levar muitas horas. Planeje todos os serviços antes de iniciar a IBD para saber quais índices precisa. Se for rodar o Fulcrum ou um explorador de blocos, ative txindex desde o início (o Electrs não precisa dele).

4. Expor os painéis de administração à internet. Os painéis do ThunderHub, do RTL e do BTCPay Server nunca devem ficar acessíveis diretamente da internet sem autenticação e criptografia adequadas. Quem assumir o controle de um painel pode controlar todos os seus canais e fundos Lightning. Acesse o ThunderHub e o RTL só por serviços onion do Tor, um túnel VPN ou um encaminhamento de porta por SSH. Uma loja do BTCPay Server é diferente porque os clientes precisam acessar as páginas de pagamento. Se aceitar pagamentos do público, coloque o BTCPay atrás de HTTPS com certificado válido e proteja o login de administração com senha forte e autenticação de dois fatores. Se precisar expor o ThunderHub ou o RTL para acesso remoto, use senhas fortes, HTTPS com certificados válidos e uma lista de IPs autorizados.

Duas maneiras de acessar de fora de casa os painéis que rodam no nó doméstico, como o ThunderHub e o RTL. Por um túnel, com Tor, VPN ou SSH, você entra e o painel continua privado. Ninguém mais consegue entrar pela internet. Se abrir a porta do painel no roteador, a página de login fica pública e qualquer pessoa pode tentar adivinhar a senha. Quem entrar no painel pode mover seus fundos. Se precisar abrir uma porta, use HTTPS, uma senha forte e uma lista de IPs autorizados.
Mantenha os painéis atrás de um túnel. Com Tor, VPN ou um túnel SSH, você entra e outras pessoas não têm por onde acessar. Uma porta aberta mostra a página de login para qualquer pessoa.

Perguntas frequentes

Quanto tempo leva a primeira sincronização da blockchain?

Num mini-PC moderno com um SSD NVMe rápido, a primeira sincronização leva um ou dois dias. Numa Raspberry Pi 5 com SSD, conte com cerca de dois a quatro dias. Numa Pi 4, leva mais. A velocidade do disco e a memória do computador são os fatores principais. Por isso ajuda aumentar dbcache durante a sincronização (veja o erro 1). Um disco mecânico pode levar semanas. A conexão também importa. Em novembro de 2026, a sincronização baixa cerca de 800 GB. Só esse download leva cerca de 18 horas a 100 Mbps e o dobro a 50 Mbps. Você pode acompanhar em tempo real com bitcoin-cli getblockchaininfo ou pelo painel da plataforma.

Posso rodar um nó Bitcoin numa Raspberry Pi em 2026?

Uma Raspberry Pi 5 com 8 GB de RAM e um SSD externo serve para rodar um nó completo de Bitcoin com funções básicas da Lightning. As limitações de desempenho aparecem quando você adiciona serviços como indexadores Electrum ou o BTCPay Server. A primeira sincronização leva bem mais tempo do que em hardware x86. A Pi 5 serve para um nó mínimo que valida blocos e gerencia poucos canais Lightning. Para um nó com vários serviços, invista num mini-PC com processador x86. Você vai perceber a melhora de desempenho e confiabilidade.

Preciso de um endereço IP fixo para rodar um nó Bitcoin?

Um nó Bitcoin funciona bem com um endereço IP dinâmico, que é o que a maioria das conexões residenciais oferece. O nó mantém uma lista de outros nós e se reconecta automaticamente quando seu IP muda. A Lightning precisa de uma identidade estável, que vem da chave pública do nó e independe do IP. Se usar o Tor, outros nós podem acessar o seu pelo endereço .onion, independentemente do IP. O encaminhamento de porta para conexões de entrada (porta 8333) é opcional para a operação básica.

Qual é a velocidade mínima de internet para um nó Bitcoin?

O volume de dados importa mais que a velocidade. O bitcoin.org pede uma velocidade de upload de pelo menos 400 quilobits por segundo. Em novembro de 2026, a primeira sincronização baixa cerca de 800 GB. Depois disso, o bitcoin.org estima cerca de 20 GB de download por mês e diz que “é comum nós completos em conexões rápidas enviarem 200 gigabytes ou mais por mês”. Se seu plano tiver limite de dados, maxuploadtarget limita quanto o nó envia. Uma conexão comum de banda larga residencial dá conta de um nó completo e um nó Lightning.

Recursos relacionados

Faz parte do nosso curso de Bitcoin:Este tema é explicado em Como configurar seu nó de Bitcoin passo a passo, do curso Rede Lightning e nós de Bitcoin.
Categoria: Nós e infraestrutura

Continue lendo

← Voltar aos cursos