Como configurar uma watchtower na Lightning

Por que você precisa de uma watchtower na Lightning

Se você rodar um nó Lightning, como mostra o guia Como rodar um nó Lightning, a segurança dos seus fundos depende de você conseguir monitorar a blockchain em busca de tentativas de fraude. Se o outro nó do canal transmitir uma transação de compromisso antiga em que tinha um saldo maior, você tem um prazo limitado, em geral de 144 a 2.016 blocos, para responder com uma transação de penalidade e reivindicar todo o saldo do canal.

O problema é que seu nó precisa estar online para detectar essas tentativas de fraude e reagir a elas. Se faltar luz, a internet cair ou o hardware falhar durante esse prazo, você não consegue se defender. Uma watchtower monitora a blockchain para você e, se detectar uma tentativa de fraude, transmite automaticamente a transação de penalidade.

Com este guia, você vai aprender a proteger seu nó Lightning com uma watchtower, tanto com o LND quanto com o Core Lightning.

Como funcionam as watchtowers

Como a watchtower detecta uma tentativa de fraude

1. Registro: a cada atualização do estado de um canal, seu nó Lightning envia para a watchtower um indício de fraude e os dados criptografados da penalidade. Com os dois, ela pode montar uma transação de penalidade sem conhecer os saldos dos canais nem seu histórico de transações.
2. Monitoramento: a watchtower verifica cada bloco novo em busca de transações que correspondam a algum dos indícios registrados.
3. Resposta: se encontrar uma correspondência, é porque o outro nó transmitiu uma transação de compromisso antiga. A watchtower descriptografa os dados da penalidade correspondente e transmite a transação que envia o saldo de quem tentou trapacear para você.
4. Resultado: você recebe os dois saldos. A penalidade recolhe o de quem tentou trapacear, e o estado antigo já pagava o seu para você. A watchtower integrada ao LND recolhe os dois na mesma transação. Ela e o The Eye of Satoshi devolvem os fundos sem reter nenhuma parte, descontada a taxa on-chain. As duas deixam de fora os pagamentos que ainda estavam em trânsito naquele momento.

Como fica a privacidade

Protocolos de watchtower bem projetados reduzem ao mínimo os dados a que o operador tem acesso.

• A watchtower só descobre algo sobre um canal quando alguém de fato tenta cometer uma fraude. No funcionamento normal, os indícios e os dados criptografados da penalidade não revelam nada sobre os canais.
• Só pelos indícios, a watchtower não consegue descobrir os saldos dos canais, com quem você os abriu nem seu histórico de pagamentos.
• A watchtower só descobre os detalhes de um canal se precisar montar uma transação de penalidade, o que só acontece diante de uma tentativa real de fraude.

Com esse desenho, usar uma watchtower afeta pouco a sua privacidade na Lightning (em inglês), embora o operador consiga ver o endereço IP de onde você se conecta, a menos que você use o Tor. A watchtower não descobre a chave pública do seu nó. O LND usa chaves de sessão separadas para se comunicar com as watchtowers, e o plugin do Core Lightning usa um par de chaves próprio.

Como configurar uma watchtower no LND

O LND já inclui um cliente e um servidor de watchtower. Você pode usar um segundo servidor seu como watchtower ou se conectar à de um terceiro em quem confia.

O cliente de watchtower vem desativado (wtclient.active=false). Ative-o assim que abrir seu primeiro canal. A noite anterior a uma viagem já é tarde. A cada atualização do canal, seu nó envia para a watchtower a penalidade do saldo que acabou de revogar. Ele nunca envia depois as penalidades dos saldos mais antigos, por isso ela só protege os saldos revogados a partir da ativação do cliente. Há mais detalhes na aula Backups e watchtowers na Lightning.

Pré-requisitos

• Um LND atualizado: em novembro de 2026, a versão 0.21.6 ou a 0.20.7, as que o nosso aviso de segurança sobre o kernel Linux (em inglês) pede que os nós Lightning usem.
• Acesso à linha de comando ou à API do seu nó com o LND. No Umbrel e na Start9, as telas de configuração do nó bastam. O passo a passo está mais abaixo.
• Se for rodar sua própria watchtower, um servidor ou dispositivo separado com o LND instalado.

A: conecte-se a uma watchtower que já existe

O mais simples é usar uma watchtower que outra pessoa opera, como o nó com o LND de um amigo que tenha a função ativada. O LND orienta os operadores a não publicar a chave da watchtower, por isso eles costumam compartilhá-la em particular. Peça ao operador a URI da watchtower (pubkey@host:port).

1. Ative o cliente de watchtower no seu arquivo lnd.conf.

[wtclient]
wtclient.active=true

2. Reinicie o LND para aplicar a configuração. Se ele rodar como um serviço do systemd chamado lnd, use este comando.

sudo systemctl restart lnd

3. Adicione uma watchtower com a chave pública e o endereço dela.

lncli wtclient add pubkey@host:port

4. Verifique a conexão.

lncli wtclient towers

O comando lista todas as watchtowers registradas e o estado de cada uma. A watchtower que você adicionou deve aparecer. Em session_info, active_session_candidate: true indica que seu nó pode abrir novas sessões de backup com essa watchtower. num_sessions conta quantas sessões o nó abriu até agora. O próximo passo mostra se os backups estão mesmo chegando às suas watchtowers.

5. Confira se o nó está criando sessões.

lncli wtclient stats

O comando mostra quantas atualizações de backup seu nó enviou para as watchtowers (num_backups). A contagem deve subir conforme você fizer transações pela Lightning, enquanto num_failed_backups fica em zero.

B: rode seu próprio servidor de watchtower

Se quiser o máximo de autonomia, rode sua própria watchtower num dispositivo separado. Assim você não precisa confiar num operador externo.

1. No servidor da sua watchtower, instale o LND e ative o serviço de watchtower no lnd.conf.

[watchtower]
watchtower.active=true
watchtower.listen=0.0.0.0:9911

2. Inicie o LND no servidor da watchtower e crie a carteira dele, como faria em qualquer nó com o LND. A chave da watchtower deriva dessa carteira. Ela começa a escutar na porta 9911 e não precisa de canais nem de fundos próprios.

3. Obtenha a chave pública da watchtower.

lncli tower info

O comando mostra a chave pública da watchtower e os endereços em que ela escuta. A URI reúne essa chave pública, uma @ e o endereço e a porta que seu nó vai usar para se conectar, como em pubkey@host:9911. Se você também preencher watchtower.externalip com o endereço IP da watchtower no lnd.conf dela, o campo uris do comando vai mostrar a URI completa.

4. No seu nó Lightning principal, adicione a watchtower como indicado na opção A. Use a URI do passo 3.

Sugestão de hardware: um computador pequeno de baixo consumo e com conexão estável à internet, como uma Raspberry Pi, pode funcionar como watchtower. Como qualquer nó com o LND, a watchtower precisa de uma fonte de blocos novos. Pode ser um nó com o Bitcoin Core ou o Neutrino, o cliente leve integrado ao LND, que acompanha a blockchain pelos nós completos de outras pessoas em vez de usar um nó próprio. O LND também funciona com um nó podado do Bitcoin Core, que só guarda blocos recentes, embora assim fique mais lento e use mais banda. O guia de segurança do LND recomenda usar um nó sem poda. O The Eye of Satoshi, tratado mais abaixo, precisa do Bitcoin Core.

Como configurar uma watchtower no Umbrel e na Start9

Se usar o Umbrel ou a Start9, ative o cliente e adicione as watchtowers nas configurações do próprio nó. Você pode fazer isso sem a linha de comando. Em novembro de 2026, os passos correspondem ao aplicativo Lightning Node do Umbrel (versão 0.21.6) e ao StartOS 0.4.

No Umbrel, use o aplicativo Lightning Node, que roda o LND.

1. Abra o Lightning Node, clique no menu de três pontos da tela principal e escolha Advanced Settings.
2. Abra o grupo Watchtower, ative Watchtower Client e clique em Save and Restart Node.
3. Quando o nó voltar, abra Advanced Settings de novo, cole a URI da watchtower (pubkey@host:port) no campo abaixo de Watchtower Client e clique em Add. Cada watchtower que você adicionar vai aparecer na lista abaixo.

No mesmo grupo, Watchtower Service permite usar esse nó como watchtower para outras pessoas e mostra a URI quando você salvar as alterações e reiniciar. Também há Watchtower Client Sweep Fee Rate, a opção wtclient.sweep-fee-rate do LND (10 sat/vB por padrão).

Para conferir as watchtowers pela linha de comando, abra Settings no umbrelOS. Entre em Advanced settings, depois em Terminal e App, e escolha o Lightning Node. Isso abre um terminal dentro do contêiner do LND, onde lncli wtclient towers e lncli wtclient stats funcionam como mostrado acima. Se você se conectar por SSH (ssh umbrel@umbrel.local), ponha docker exec -it lightning_lnd_1 antes de cada comando, como em docker exec -it lightning_lnd_1 lncli wtclient towers.

Na Start9, use o serviço do LND.

1. Abra o serviço do LND e entre na página actions & config.
2. Em Watchtower, abra Watchtower Client Settings, defina Enable Watchtower Client como Enabled e adicione a URI de cada watchtower em Add Watchtowers. O LND reinicia e adiciona as watchtowers da lista a cada inicialização.

Se for rodar uma watchtower para outras pessoas, escolha em Watchtower Server o endereço em que elas vão poder se conectar. Por padrão, é o endereço onion do Tor. Watchtower Server Info mostra a URI para compartilhar. O serviço do Core Lightning no StartOS tem configurações próprias de watchtower, tratadas na seção seguinte. Para o gerenciamento geral do nó, consulte o guia Como configurar um nó Lightning para uso pessoal.

Opções de watchtower para o Core Lightning

O ecossistema do Core Lightning (CLN) usa implementações externas de watchtower. Já o LND tem um sistema integrado.

The Eye of Satoshi (teos)

O TEOS é uma implementação de watchtower independente compatível com o CLN. O projeto segue as propostas de especificação BOLT para watchtowers. A última versão marcada com tag, a v0.2.0, é de fevereiro de 2023, e a alteração mais recente no repositório é de outubro de 2025. O TEOS ainda funciona como descrito abaixo, mas recebe pouca manutenção, então compile-o a partir do código-fonte atual e mantenha atualizada a máquina que hospeda a watchtower.

Na Start9, o serviço do Core Lightning já inclui o The Eye of Satoshi, tanto o plugin cliente quanto a watchtower. Na página actions & config, Watchtower Settings inclui uma chave Watchtower Client com uma lista de URIs de watchtowers (tower_id@host:port) e uma chave Watchtower Server. Watchtower Client Info mostra quais watchtowers seu nó usa. Voluntários compartilham watchtowers públicas na lista de watchtowers altruístas (em inglês) do projeto. A maioria dos registros é de 2022 e 2023, então, depois de registrar uma watchtower, confira se ela aparece como acessível. Há mais sobre isso na seção Como conferir se as watchtowers estão funcionando. Os passos abaixo servem para um nó com o Core Lightning que você mesmo configurou.

1. Instale o servidor de watchtower teos no dispositivo secundário. Estes comandos do guia de instalação do projeto compilam o teos com a ferramenta cargo do Rust e instalam dois programas em ~/.cargo/bin, teosd (a watchtower) e teos-cli (a ferramenta de controle).

git clone https://github.com/talaia-labs/rust-teos.git
cd rust-teos
cargo install --locked --path teos

2. Configure o teos com as credenciais de RPC do seu Bitcoin Core num arquivo teos.toml na pasta de dados do teos (~/.teos/ por padrão).

# ~/.teos/teos.toml
btc_network = "mainnet"
btc_rpc_user = "your_rpc_user"
btc_rpc_password = "your_rpc_password"
btc_rpc_connect = "127.0.0.1"
btc_rpc_port = 8332
# the default, 127.0.0.1, only accepts connections from this machine
api_bind = "0.0.0.0"
api_port = 9814

3. Inicie o servidor teos.

teosd

4. No seu nó com o CLN, instale o plugin cliente do teos. Ele instala um programa chamado watchtower-client em ~/.cargo/bin.

git clone https://github.com/talaia-labs/rust-teos.git
cd rust-teos
cargo install --locked --path watchtower-plugin

5. Carregue o plugin no CLN.

lightning-cli plugin start ~/.cargo/bin/watchtower-client

Se você iniciar o plugin desse jeito, ele para quando o CLN reiniciar, e os backups também param. Para carregá-lo a cada inicialização, adicione uma linha como plugin=/home/you/.cargo/bin/watchtower-client ao arquivo de configuração do CLN (~/.lightning/config por padrão). Use o caminho da sua própria pasta pessoal.

6. Registre o nó no seu servidor teos com o identificador que teos-cli gettowerinfo mostra na watchtower.

lightning-cli registertower tower_id@host:port

Boas práticas para configurar watchtowers

Use várias watchtowers

Se o outro nó tentar trapacear enquanto seu nó e sua única watchtower estiverem offline, ninguém vai reagir. Por isso, use mais de uma. Os dois clientes usam várias watchtowers de formas diferentes.

• Core Lightning: o plugin envia cada atualização para todas as watchtowers que você registrar, então cada uma guarda uma cópia completa. Se uma ficar offline, as outras continuam cobrindo todos os saldos.
• LND: o cliente envia cada atualização para uma única watchtower. Preenche com essa watchtower uma sessão de até 1.024 atualizações (wtclient.max-updates) e abre a sessão seguinte com a próxima watchtower da lista. Assim, suas watchtowers dividem o seu histórico entre si e, num nó com poucos pagamentos, uma única watchtower pode ficar com todas as suas atualizações recentes por muito tempo. Se o outro nó publicar um saldo antigo, a watchtower que o guarda precisa estar online. Com o LND, a confiabilidade de cada watchtower importa mais que a quantidade. Comece com uma watchtower sua, em hardware separado.

Com qualquer um dos dois clientes, uma watchtower que você adicionar mais tarde só guarda as atualizações feitas depois que você a adicionar. Cada cliente funciona com um tipo de watchtower. O cliente do LND usa watchtowers com o LND (porta 9911) e o plugin do Core Lightning usa watchtowers com o The Eye of Satoshi (porta 9814). Procure ter entre 2 e 3 watchtowers independentes.

• Uma watchtower própria em hardware separado
• Uma ou duas watchtowers mantidas pela comunidade
• Se quiser, uma watchtower hospedada num VPS em outra região

Como conferir se as watchtowers estão funcionando

Confira periodicamente se as conexões com suas watchtowers estão ativas.

# Check tower status
lncli wtclient towers

# Check backup statistics
lncli wtclient stats

As estatísticas devem mostrar que a contagem de backups cresce conforme seus canais têm atividade. Se os números pararem de subir enquanto você faz pagamentos, investigue a conexão com a watchtower. Se num_pending_backups continuar crescendo, a watchtower que o LND usa não está aceitando backups. Adicione outra e rode lncli wtclient remove seguido da chave pública da que travou. Assim, o LND repassa os backups pendentes para as outras.

No Core Lightning, lightning-cli listtowers mostra o estado de cada watchtower, que deve ser reachable. Se aparecer subscription error, a assinatura com aquela watchtower acabou. Nas configurações padrão, ela dura 10.000 atualizações ou cerca de um mês. Rode registertower de novo para renová-la.

Distribuição geográfica

Use infraestrutura diferente para a watchtower e o nó principal. Se os dois rodarem no mesmo equipamento, uma única falha derruba o nó e a proteção dele. Se estiverem na mesma casa, uma queda de energia desliga os dois. O ideal é ter o nó principal em casa e a watchtower num servidor hospedado separado ou na casa de um amigo em quem você confia.

Armazenamento

Os servidores de watchtower guardam um indício de fraude e uma penalidade criptografada a cada atualização de canal de cada cliente registrado. O espaço necessário cresce com o número de clientes e a frequência das atualizações dos canais deles, mas cada uma ocupa pouco, algumas centenas de bytes (cerca de 330 no LND). Uma watchtower que atende a algumas dezenas de nós precisa de pouquíssimo espaço adicional.

Quando você realmente precisa de uma watchtower?

Estes são os cenários que importam na prática ao decidir se você precisa de uma watchtower.

• Nó offline por muito tempo: se o nó ficar offline por mais que o menor período de espera, cerca de um dia nos canais pequenos do LND, o outro nó pode transmitir um estado antigo de má-fé e fazer com que ele prevaleça. As watchtowers protegem você durante esse prazo.
• Falha no hardware: se o armazenamento do nó falhar e você perder os estados dos canais, não vai conseguir reagir por conta própria às tentativas de fraude. Uma watchtower guarda os indícios de fraude separadamente.
• Desastres naturais: um incêndio, uma inundação ou outro evento pode destruir seu hardware. Uma watchtower em outra região continua monitorando.

Na prática, tentativas de fraude são extremamente raras na rede Lightning. O incentivo econômico pesa contra quem pensa em trapacear, porque, se a tentativa falhar, a penalidade tira todos os fundos do canal dessa pessoa. Ainda assim, como rodar uma watchtower custa tão pouco, vale ter essa proteção como seguro, sobretudo à medida que os saldos crescem. Um bom gerenciamento dos canais, junto com a proteção de uma watchtower, dá a defesa mais forte para seus fundos na Lightning.

Quanto custa uma watchtower

Opção	Esforço de configuração	Custo de operação	Nível de confiança
Watchtower da comunidade	5 minutos	Sem custo para você	Você confia no operador
Watchtower própria numa Raspberry Pi	Entre 1 e 2 horas	A eletricidade que um computador pequeno consome	Você tem o controle
Watchtower num VPS	30 minutos	Um plano básico de VPS	Você confia no provedor do VPS

Para a maioria de quem opera um nó em casa, combinar uma watchtower própria com uma da comunidade dá uma proteção robusta a um custo mínimo. Há mais sobre a operação e a segurança do nó no nosso guia completo.

Perguntas frequentes

Uma watchtower pode ver meus pagamentos pela Lightning ou os saldos dos meus canais?

Não. Durante o funcionamento normal, a watchtower só guarda indícios de fraude e dados criptografados da penalidade que não consegue descriptografar. Ela só descobre os detalhes de um canal se houver uma tentativa real de fraude e precisar montar uma transação de penalidade. Em condições normais, seu histórico de pagamentos, os saldos dos canais e a identidade de quem tem canais com você continuam privados.

O que acontece se minha watchtower ficar offline ao mesmo tempo que meu nó?

Se seu nó e sua watchtower ficarem offline ao mesmo tempo, ninguém monitora durante esse período. Por isso, a watchtower deve rodar em hardware separado do nó e ter energia e conexão à internet próprias. Assim, uma única queda de energia, interrupção da internet ou desastre não derruba os dois. Com o Core Lightning, cada watchtower que você registrar guarda todas as atualizações, então uma segunda ou terceira protege você enquanto uma estiver offline. O LND envia cada atualização para uma única watchtower, então a confiabilidade de cada uma importa mais que a quantidade. Comece com uma própria em hardware separado.

Uma watchtower pode roubar meus fundos?

Não. A watchtower só tem os dados necessários para montar transações de penalidade, que enviam os fundos para seu endereço. Não consegue montar transações que desviem os fundos para um endereço próprio. O pior que uma watchtower maliciosa pode fazer é deixar de agir diante de uma tentativa de fraude. Rodar a sua própria watchtower elimina essa dúvida. Com o Core Lightning, você também pode registrar várias, cada uma com todas as atualizações.

Preciso de uma watchtower se meu nó estiver sempre online?

Um nó que se mantém online 24/7, como mostra o guia Como rodar um nó Lightning em casa, pode detectar tentativas de fraude e reagir por conta própria. Ainda assim, nenhum sistema está “sempre online” de verdade. Falhas no hardware ou no software, quedas de energia e interrupções da internet acabam acontecendo com todo mundo. Rodar uma watchtower custa muito pouco e serve de seguro contra esses eventos inevitáveis. A pergunta é quando seu nó vai ficar offline e se você vai estar protegido quando isso acontecer.