O teu cliente WireGuard liga-se, funciona durante um minuto e depois fica calado: alcanças o servidor a partir do cliente, mas o servidor já não consegue devolver-te nada. Um SSH a partir do lado do servidor bloqueia, um dispositivo da LAN atrás do cliente fica inalcançável, o handshake expira em silêncio. A correção é quase sempre uma linha no cliente: PersistentKeepalive = 25. Este guia explica exatamente o que essa opção faz, porque 25 segundos é o número mágico, e a que lado do túnel pertence.
Dúvidas sobre a sua configuração? Cole o seu .conf no verificador de configuração WireGuard: assinala cada peer com Endpoint mas sem PersistentKeepalive, além de chaves na secção errada e valores mal formados. Nada sai do seu navegador.
Um caso que nenhum valor de keepalive resolve: quando é o próprio servidor que está atrás de CGNAT, nada de fora consegue alcançá-lo. A saída é correr o servidor numa máquina com IPv4 público, por exemplo um VPS Cloud da Contabo (link afiliado), a partir de 5,50 € por mês em 24 meses (preço consultado a 17 de outubro de 2026). Se preferir um fornecedor dos EUA com 30 dias de reembolso, o VPS Basic da Ultahost custa 5,52 $ por mês em 24 meses (1 GB de RAM, IPv4 dedicado, lido a 21 de outubro de 2026), suficiente para um servidor WireGuard com poucos dispositivos. Não sabe se a sua ligação está atrás de CGNAT? O verificador de porta WireGuard, gratuito, compara o endereço WAN mostrado pelo router com o seu IP público e diz-lhe se um reencaminhamento de porta pode funcionar. Fornecedor ainda por escolher? Comparativos: melhor VPS para uma VPN e Contabo vs Hetzner vs OVH, pelo preço realmente cobrado. Outra opção: HostPapa Unmanaged VPS Lite (link de afiliado) a 2,95 $ por mês num prazo de 3 anos, depois ao preço normal (1 núcleo, 1 GB de RAM, 25 GB NVMe, acesso root por SSH, garantia de reembolso de 30 dias, consultado a 28 de outubro de 2026).
Ainda não escolheu o servidor? A nossa classificação dos VPS mais baratos para WireGuard compara o que cada fornecedor cobra de facto por um servidor utilizável.
A resposta curta
Se um peer estiver atrás de NAT e precisar de continuar alcançável, adiciona isto ao bloco [Peer] na configuração desse peer:
[Peer]
PublicKey =...
Endpoint = server.example.com:51820
AllowedIPs = 0.0.0.0/0
PersistentKeepalive = 25
Reinicia o túnel e o problema do túnel mudo após inatividade desaparece. Tudo o que se segue é o porquê.
O que o PersistentKeepalive faz
Por conceção, o WireGuard é silencioso: quando não há nada para enviar, não envia nada. Sem keepalives, sem heartbeats, sem conversa. Isso torna-o eficiente e difícil de identificar por fingerprint - mas quebra um cenário específico.
Quando um cliente está atrás de NAT (um router doméstico, um operador móvel, uma firewall de escritório), o equipamento NAT cria um mapeamento temporário na primeira vez que o cliente envia um pacote para fora. É esse mapeamento que permite ao servidor enviar as respostas de volta para o endereço interno correto - pensa nele como um furo aberto no NAT. Crucialmente, esse furo expira após um período de inatividade, muitas vezes algures entre 30 segundos e alguns minutos no UDP. Assim que fecha, os pacotes do servidor deixam de ter para onde ir, e o peer fica inalcançável até o cliente voltar a falar primeiro.
PersistentKeepalive resolve isto enviando um pequeno pacote keepalive vazio ao peer a cada N segundos. Esse minúsculo tráfego mantém o mapeamento NAT renovado, por isso o furo nunca fecha e o peer continua alcançável mesmo em repouso.
Porquê 25 segundos
A recomendação oficial do WireGuard é 25 segundos, e o raciocínio é simples. Os timeouts NAT UDP comuns situam-se entre 30 segundos e alguns minutos, e o valor mais curto que se encontra regularmente ronda os 30 segundos. Enviar um keepalive a cada 25 segundos renova o mapeamento com uma pequena margem antes desse limite dos 30 segundos - frequente o suficiente para nunca deixar o furo fechar, raro o suficiente para não custar quase nada.
Podes descer mais se o teu NAT for invulgarmente agressivo (15 é um próximo passo razoável), ou subir para poupar bateria no móvel, mas 25 é o valor recomendado pela documentação (o valor predefinido é 0, ou seja, desativado), e não por acaso. Não penses demasiado nisto.
O que diz o quickstart oficial do WireGuard (secção "NAT and Firewall Traversal Persistence", wireguard.com/quickstart, lido a 24/10/2026, citação em inglês): "A sensible interval that works with a wide variety of firewalls is 25 seconds. Setting it to 0 turns the feature off, which is the default, since most users will not need this, and it makes WireGuard slightly more chatty."
Onde o colocar: cliente vs servidor
É aqui que as pessoas erram. O keepalive vai no peer que precisa de continuar alcançável através de um NAT:
| Configuração | Keepalive no cliente? | Keepalive no servidor? |
|---|---|---|
| Cliente móvel atrás de NAT -> servidor com IP público | Sim (= 25) | Não |
| Servidor com IP público limpo | (não aplicável) | Não necessário |
| Ambas as extremidades atrás de NAT (peer-to-peer) | Sim | Sim |
No caso normal - um portátil ou telemóvel atrás de um router a falar com um VPS com IP público real - só o cliente precisa de PersistentKeepalive = 25, no bloco [Peer] que descreve o servidor. O servidor não precisa de nenhum na direção dos seus clientes: o cliente inicia sempre, e o servidor limita-se a responder para o endereço de origem de onde veio o último pacote. Um servidor com IP público limpo é exatamente a configuração em que evitas por completo o problema de NAT do lado do servidor.
Exemplo de configuração [Peer]
Eis um bloco de peer completo do lado do cliente com o keepalive no lugar:
[Interface]
PrivateKey = <client-private-key>
Address = 10.66.66.2/32
DNS = 10.66.66.1
[Peer]
PublicKey = <server-public-key>
Endpoint = vpn.example.com:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25
Aplica-o com um reinício do túnel:
sudo wg-quick down wg0 && sudo wg-quick up wg0
Confirma que teve efeito - wg show lista o intervalo por baixo do peer:
sudo wg show
# persistent keepalive: every 25 seconds
Se estiveres a montar configurações de raiz, os modelos de configuração WireGuard prontos a usar já incluem a linha keepalive no bloco certo para cada plataforma.
Se o túnel se mantém mas as transferências grandes travam depois da correção do keepalive, o suspeito seguinte é o tamanho dos pacotes: a calculadora de MTU do WireGuard gratuita dá a MTU certa a partir de um ping e adiciona a linha PersistentKeepalive = 25 ao mesmo excerto de configuração.
O erro "interval must be in range"
PersistentKeepalive espera um simples número inteiro de segundos, validado contra o intervalo 0-65535. Se vires interval must be in range ou must be in range 0 to 65535, passaste algo que não é um inteiro válido nessa janela:
- Um sufixo de unidade - escreve
25, não25s. - Um decimal -
25, não25.0. - Um número negativo, ou um valor acima de 65535.
- Um espaço estranho ou caractere invisível colado de uma página web.
Um valor de 0 é legal e significa desativado - o mesmo que deixar a linha de fora por completo. Por isso PersistentKeepalive = 0 não serve de nada; usa um intervalo real como 25.
Keepalive definido mas continua sem funcionar
Se adicionaste a linha e o túnel continua a ficar calado após inatividade, percorre estas causas honestas por ordem:
- Definido no lado errado. É o peer que está atrás de NAT que precisa dele. Um keepalive apenas no servidor com IP público não mantém aberto o furo NAT de um cliente.
- Timeout NAT mais curto do que o teu intervalo. Alguns carrier-grade NAT fecham os mapeamentos UDP mais depressa do que 30 segundos. Desce o intervalo para 15 e testa de novo.
- Uma firewall bloqueia o caminho. Se a porta UDP subjacente estiver filtrada, nenhum keepalive passará - confirma que a porta do WireGuard está mesmo aberta em ambas as extremidades.
- O endpoint mudou (roaming). Se o cliente mudou de rede e o seu endereço público mudou, o servidor pode continuar a apontar para o
Endpointantigo. O keepalive ajuda o servidor a acompanhar a nova origem, mas umEndpointdesatualizado do lado do cliente pode ainda assim falhar.
Sem servidor, só uma rede que bloqueia? Se quer fazer passar o seu próprio portátil pelo Wi-Fi de um hotel, escritório ou campus que corta o WireGuard, uma aplicação VPN com um modo de ofuscação integrado faz o encapsulamento por si: o Proton VPN oferece Stealth, um túnel TLS ofuscado disponível em todos os planos, incluindo o gratuito, e o NordVPN oferece NordWhisper, que faz o tráfego VPN parecer tráfego web normal e agora corre os seus servidores ofuscados (links de afiliado). Contra uma DPI estatal, um servidor privado encapsulado com Xray REALITY resiste melhor; o nosso guia anti-DPI compara os dois caminhos.
Plano pago, Black Friday 2026: a oferta de parceiros da Proton, verificada em 28 de outubro de 2026, é VPN Plus a 2,49 $/mês por 2 anos (59,76 $ nos primeiros 24 meses, depois 83,88 $ por ano), com garantia de reembolso de 30 dias e 10 dispositivos. A página de compra mostra o preço do seu país, e a Proton não divulga data de fim.
Keepalive vs handshake do WireGuard
São dois temporizadores diferentes, e ajuda separá-los. O WireGuard renova o seu handshake criptográfico aproximadamente a cada dois minutos - mas apenas quando há tráfego real a proteger. Numa ligação inativa sem keepalive, nenhum tráfego significa nenhuma renovação de handshake, e entretanto o furo NAT fecha-se em silêncio.
PersistentKeepalive preenche exatamente essa lacuna: mantém um fio de tráfego numa ligação de outro modo inativa, mantendo o mapeamento NAT aberto entre handshakes para que o túnel esteja pronto no instante em que dados reais precisam de circular. O keepalive não substitui o handshake; mantém o caminho vivo para que o handshake possa acontecer quando for preciso.
Um servidor com IP público elimina metade do problema
A maioria das dores de cabeça com keepalive vem do NAT do lado do servidor - um equipamento VPN atrás de um router doméstico, duplo NAT, uma firewall do fornecedor. Põe o servidor num IPv4 público limpo e o único NAT que resta é o do cliente, onde um único PersistentKeepalive = 25 é tudo o que precisas. Um Contabo Cloud VPS 4 a 5,50 EUR/mês dá-te root completo e um verdadeiro IP público sem firewall do fornecedor para combater - exatamente as condições em que o keepalive do lado do cliente é a única coisa que tens de definir. Para perceber a mecânica de NAT que esta opção contorna, vê a explicação simples do que é o NAT.
O nosso gerador de configuração WireGuard gratuito inclui PersistentKeepalive = 25 nas configurações de cliente que cria, com chaves, AllowedIPs e Endpoint coerentes dos dois lados. O gerador é gratuito e sem conta, até 250 dispositivos, e a sua exportação ZIP junta cada .conf de cliente e o seu código QR em PNG, prático para configurar um escritório ou uma família inteira de uma só vez.
Gere aqui as suas configurações WireGuard
Introduza o endereço do servidor, escolha o número de dispositivos e leia cada código QR na app.
Todas as chaves são geradas no seu navegador (Curve25519 / X25519). Nada é enviado para os nossos servidores - a sua configuração permanece 100% privada.
IPv4 público ou domínio da máquina que vai correr o WireGuard. Ainda sem servidor? Deixe vazio e adicione depois.
Grátis, sem conta: até 250 clientes, cada .conf com o seu código QR, e um ZIP com todos os ficheiros.
Tudo o que o dispositivo envia para a internet passa pelo seu servidor.
Definições avançadasSub-rede do túnel, DNS, redes site-to-site. Os valores predefinidos servem para a maioria dos casos.
Opcional. Indique a sub-rede local atrás do servidor e/ou atrás de um cliente que funciona como gateway do local (um router, um Raspberry Pi, um NAS). O gerador adiciona cada rede aos AllowedIPs do servidor, dá a cada peer as rotas para as outras redes e escreve as regras de reencaminhamento nos gateways. Deixe um campo vazio para um cliente normal.
O que descarregas
wg0.conf
para o servidor
client1.conf
um por dispositivo
QR (exemplo)
para a app móvel
Pré-visualização ilustrativa: linhas e QR fictícios, nenhuma chave real. Os teus ficheiros reais são gerados no teu navegador ao clicar.
Para ter o essencial à mão: a WireGuard Cheat Sheet gratuita (PDF de 5 páginas em inglês, download direto, sem registo) reúne as tabelas de keepalive e MTU, os comandos wg genkey/wg pubkey/wg genpsk e as quatro verificações de servidor numa linha a correr primeiro quando um túnel não passa tráfego. O WireGuard Self-Hosting Kit pago (9 USD, em inglês) acrescenta uma checklist de diagnóstico com 12 causas e 11 modelos de configuração.
Uma VPN muda o seu IP. Não muda o seu navegador.
Um túnel substitui o endereço que um serviço vê. Não altera nada do que o seu navegador anuncia por conta própria - tipos de letra, ecrã, fuso horário, pilha gráfica - e essa combinação costuma bastar para o reconhecer de uma sessão para a outra.
Meça a sua impressão digital de navegador - medição passiva, sem perguntas, sem conta, sem e-mail.
Para ir mais longe
- Que porta o WireGuard usa e como abri-la
- O que é o NAT, explicado de forma simples
- Modelos de configuração WireGuard prontos a usar 2026
- MTU do WireGuard: corrigir o túnel travado
- O handshake do WireGuard não se completa: a lista completa de correções
Fontes e referências:
- Quickstart do WireGuard e documentação do wg-quick
- Protocolo e design do WireGuard - wireguard.com
- Arch Wiki - WireGuard (notas sobre PersistentKeepalive)
Publicado a 2026-06-29. A recomendação dos 25 segundos e o comportamento do PersistentKeepalive vêm da documentação oficial do WireGuard; os intervalos de timeout NAT variam conforme o dispositivo, por isso confirma no teu próprio router ou operador se for necessário um intervalo mais curto.
Lembrete: correr o WireGuard e auto-hospedar um VPN é legal na UE, nos EUA, no Canadá. A VPNSmith publica este conteúdo para fins educativos.
Link de afiliado
★ Datacenter GDPR em Nuremberg · ✓ IPv4 dedicado incluído · porta de 200 Mbit/s
Aloje a sua VPN no seu próprio VPS → ContaboCloud VPS 4 · 5,50 €/mês · Cartão ou PayPal · pedidos de fora da UE aceites→Preço verificado em 17/10/2026, prazo de 24 meses


