SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor · Atualizado 2026-11-18

Como funciona o WireGuard: roteamento por chaves

Entenda por que AllowedIPs funciona como tabela de rotas e controle de acesso, como ocorre o handshake Noise e por que a configuracao wg0.conf fica clara.

Como o WireGuard funciona, em uma ideia

O WireGuard associa cada pacote a uma chave pública. Esse mecanismo chama-se encaminhamento por chaves criptográficas, e constitui todo o projeto: a linha AllowedIPs junto de um peer é a tabela de encaminhamento dos pacotes que saem da sua máquina e a lista de controlo de acesso dos pacotes que chegam desse peer. Uma definição, duas funções. Leia AllowedIPs dessa forma e qualquer ficheiro de configuração do WireGuard torna-se compreensível.

Não existe uma tabela de sessões indexada por endereço IP nem uma base de dados de utilizadores. Um peer é uma chave pública mais o conjunto de endereços que essa chave pode utilizar. O handshake e os temporizadores existem para manter essa associação válida enquanto a rede subjacente muda. Se quiser ter um túnel funcional antes de aprofundar a teoria, crie um com uma VPN WireGuard autoalojada no seu próprio VPS e volte aqui quando uma linha de configuração lhe causar dúvidas.

AllowedIPs é uma tabela de encaminhamento e uma lista de acesso

Comece pelo tráfego de saída. O kernel encaminha um pacote para o dispositivo wg0 da forma habitual, através da tabela de encaminhamento principal. Em seguida, o WireGuard compara o endereço de destino desse pacote com uma tabela que contém os prefixos permitidos de todos os peers, começando pelo prefixo mais específico. A correspondência identifica um peer, que identifica uma chave pública, que identifica uma chave de sessão e um endpoint UDP. O pacote é cifrado para esse peer e enviado para esse endpoint.

Se o AllowedIPs de nenhum peer abranger o destino, nada é enviado, porque não existe uma chave com a qual o pacote possa ser enviado.

ping: sendmsg: Required key not available

Esse erro tem uma única causa: o endereço que tentou alcançar não está listado em nenhum peer. Um erro diferente, ping: sendmsg: Destination address required, significa que um peer foi identificado, mas o WireGuard não tem um endpoint para ele, porque nenhum foi configurado e nenhum foi aprendido até ao momento.

Agora, considere o tráfego de entrada. Um pacote UDP chega à porta de escuta. O WireGuard encontra a sessão através do índice do recetor no cabeçalho, desencripta e autentica a carga útil e, em seguida, verifica o contador numa janela deslizante contra replay. Só depois lê o pacote interno. Nesse momento, uma pesquisa pelo prefixo mais específico do endereço de origem tem de identificar o peer de envio autenticado. Se isso não acontecer, o pacote é descartado. Com a depuração dinâmica ativada, o kernel imprime o motivo numa linha como esta:

wg0: Packet has unallowed src IP (10.8.0.9) from peer 2 (203.0.113.10:51820)

É por isso que um peer no lado do servidor recebe um /32. Um peer configurado com AllowedIPs = 10.8.0.2/32 pode enviar pacotes a partir de 10.8.0.2 e de nenhum outro endereço. Escreva 0.0.0.0/0 nesse campo e esse cliente poderá declarar qualquer endereço IPv4 de origem cujo prefixo mais específico o associe a esse peer, mas não um endereço atribuído a outro peer por um prefixo mais específico.

Os prefixos sobrepostos são resolvidos pela especificidade, porque a pesquisa usa o prefixo mais específico. Prefixos idênticos em dois peers comportam-se de forma diferente: a entrada passa para o peer configurado por último, e o primeiro peer deixa de receber esse tráfego sem que seja impresso qualquer erro. wg show wg0 allowed-ips imprime a tabela que está efetivamente no kernel. Essa é a tabela relevante quando o ficheiro em disco e o estado em execução deixam de coincidir.

Lendo um ficheiro de configuração com o encaminhamento por chave criptográfica em mente

O lado do servidor:

[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = <server private key>

[Peer]
PublicKey = <laptop public key>
AllowedIPs = 10.8.0.2/32

O lado do cliente:

[Interface]
Address = 10.8.0.2/32
PrivateKey = <laptop private key>

[Peer]
PublicKey = <server public key>
Endpoint = vpn.example.com:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

A mesma palavra-chave tem efeitos opostos nos dois lados. No cliente, indica “enviar todos os destinos para este peer”. No servidor, indica “aceitar apenas este endereço deste peer”. A assimetria está nos valores, não em nenhuma das funções.

Metade destas chaves nem sequer pertence ao protocolo. Address, DNS, MTU, PostUp e SaveConfig pertencem a wg-quick, o script de shell que ativa a interface. Não são definições do protocolo WireGuard; wg-quick processa-as separadamente. wg-quick strip wg0 apresenta a configuração reduzida que a ferramenta wg carrega efetivamente. É a forma mais rápida de ver essa separação.

O que o handshake realmente faz

O handshake do WireGuard é Noise_IKpsk2, do Noise Protocol Framework. A parte IK é a mais útil para um sysadmin: a chave pública estática do responder já é conhecida pelo iniciador, porque é a PublicKey no seu bloco [Peer], e o iniciador envia a sua própria chave pública estática dentro da primeira mensagem, cifrada. Portanto, não há troca de certificados nem uma ida e volta para validar a identidade. Um observador passivo não consegue saber qual chave está a iniciar a ligação, a menos que tenha a chave privada do responder.

O custo é uma ida e volta. A mensagem de iniciação tem 148 bytes, a resposta tem 92 bytes e os dados começam a fluir imediatamente depois. Cada lado gera um novo par de chaves efémeras Curve25519 para cada handshake, e as chaves de sessão resultam de uma cadeia de operações Diffie-Hellman que combina as chaves estáticas e efémeras. As chaves privadas efémeras são eliminadas depois, o que fornece sigilo futuro: alguém que grave o seu tráfego hoje e roube a chave privada do servidor no próximo ano continuará sem conseguir ler o tráfego gravado.

Uma iniciação de handshake transporta um timestamp TAI64N, e cada peer memoriza o maior timestamp que recebeu do outro. Assim, uma iniciação repetida é rejeitada. Os pacotes de dados transportam um contador de 64 bits usado como nonce, e o recetor mantém uma janela deslizante dos contadores vistos recentemente. Isto permite lidar com repetições e reordenação significativa sem manter estado de ligação ao estilo do TCP.

As chaves de sessão não duram muito tempo, e os temporizadores estão compilados no software, não sendo configuráveis.

GráficoWireGuard protocol timers, in seconds
Os dados por trás deste gráfico
[
  {
    "label": "REKEY_TIMEOUT",
    "seconds": 5,
    "notes": "resend a handshake initiation that got no answer, plus up to 333 ms of random jitter"
  },
  {
    "label": "KEEPALIVE_TIMEOUT",
    "seconds": 10,
    "notes": "send a keepalive after receiving data and sending none back"
  },
  {
    "label": "REKEY_ATTEMPT_TIME",
    "seconds": 90,
    "notes": "stop retrying the handshake and drop the packets queued for that peer"
  },
  {
    "label": "REKEY_AFTER_TIME",
    "seconds": 120,
    "notes": "the peer that initiated the current session begins a fresh handshake when it next sends"
  },
  {
    "label": "REJECT_AFTER_TIME",
    "seconds": 180,
    "notes": "the old session key is refused and traffic stops"
  }
]

Estas são constantes da especificação do protocolo, não medições. Estes 5 temporizadores ajudam a gerir o ciclo de vida da sessão. Quando uma chave de sessão atinge 120 segundos, o peer que iniciou esse handshake começa um novo na próxima vez que enviar dados; o responder não muda de chave com base neste temporizador. Após 180 segundos, a chave antiga é recusada diretamente, e o tráfego para até um novo handshake ser concluído. Uma iniciação sem resposta é reenviada após 5 segundos, acrescida de uma variação aleatória de até um terço de segundo, e as tentativas param após cerca de 90 segundos. É por isso que wg show apresenta latest handshake como uma idade relativa e que um túnel saudável e com tráfego mantém essa idade baixa. Uma idade que aumenta enquanto está a enviar tráfego ativamente significa que os handshakes estão a falhar, não que o túnel está inativo.

Por que um peer não tem função de cliente nem de servidor

As duas extremidades executam código idêntico e usam o mesmo formato de configuração. Não existe um modo de servidor. A assimetria que se observa vem de Endpoint, e Endpoint é opcional.

Um peer com um endpoint configurado pode iniciar um handshake. Um peer sem endpoint aguarda e depois aprende o endereço e a porta do outro lado a partir do primeiro pacote autenticado corretamente. Esse endpoint aprendido é armazenado e atualizado sempre que chega um pacote válido de um endereço novo. É assim que funciona o roaming: um laptop que muda de Wi-Fi para uma rede móvel mantém o mesmo túnel, porque uma sessão é identificada pela chave e pelo índice, não pelo endereço IP. Nada é reconectado, porque nada esteve conectado no sentido TCP.

O mesmo mecanismo cria um facto importante: o peer com o endereço público mantém sempre o último IP público conhecido do outro lado, e wg show mostra esse valor.

Primitivas fixas, sem negociação

Não existe uma lista de conjuntos de cifras no WireGuard. O protocolo usa ChaCha20-Poly1305 para encriptação autenticada, Curve25519 para acordo de chaves, BLAKE2s para hashing e HKDF para derivação de chaves. Todas as implementações usam essas primitivas. Por isso, não há uma fase de negociação para analisar nem uma possibilidade de downgrade para uma opção mais fraca. O compromisso é real: se uma dessas primitivas for comprometida, a correção exige uma nova versão de todo o protocolo e uma atualização nas duas extremidades, não uma alteração de configuração. Essa decisão elimina grande parte do código e dos modos de falha presentes num túnel baseado em TLS. É sobretudo isso que está por trás da comparação em WireGuard em comparação com OpenVPN.

Por que a porta não responde a um scanner

As mensagens de início e resposta do handshake contêm um campo chamado mac1; as respostas com cookie não contêm esse campo. Trata-se de um MAC (código de autenticação de mensagem) calculado sobre a mensagem com uma chave derivada da chave pública estática do recetor. Um remetente que não conheça essa chave pública não consegue produzir um mac1 válido, e o recetor descarta esse pacote sem enviar qualquer resposta. Não há erro, reset nem mensagem ICMP.

O resultado visível é uma varredura UDP que não recebe resposta.

sudo nmap -sU -p 51820 vpn.example.com

O nmap reporta open|filtered, que é a mesma resposta apresentada para uma porta que uma firewall descarta silenciosamente. Uma porta UDP não filtrada, sem nenhum serviço à escuta, normalmente devolve um erro ICMP de porta inacessível. Nesse caso, o nmap reporta closed.

Um segundo campo, mac2, trata da pressão causada por ataques de negação de serviço. Quando o recetor está sob carga, responde a uma mensagem de início ou resposta com um mac1 válido, mas sem um mac2 válido, usando uma resposta com cookie de 64 bytes associada ao endereço de origem do remetente. O recetor recusa executar operações dispendiosas com chaves públicas até que o remetente use esse cookie para calcular um mac2 válido. Isso comprova que o endereço de origem é alcançável antes de executar operações dispendiosas com chaves públicas. Esse mecanismo só é ativado sob carga.

Por que 0.0.0.0/0 transforma um peer na rota predefinida

Como AllowedIPs é a tabela de encaminhamento, AllowedIPs = 0.0.0.0/0, ::/0 seleciona esse peer para destinos que não estejam abrangidos por um prefixo mais específico atribuído a outro peer. Essa é toda a configuração de túnel completo.

O encaminhamento que faz isto funcionar é mais interessante do que a própria linha. Uma rota predefinida simples através de wg0 entraria num ciclo, porque o pacote UDP cifrado que transporta o seu tráfego também tem de sair da máquina e corresponderia à sua própria rota predefinida. wg-quick evita isso com encaminhamento baseado em políticas. Marca os próprios pacotes de saída do WireGuard com um fwmark, coloca a rota predefinida do túnel numa tabela de encaminhamento separada e adiciona regras para que apenas o tráfego sem marcação chegue a essa tabela. Execute ip rule show para ver o resultado:

32764:	from all lookup main suppress_prefixlength 0
32765:	not from all fwmark 0xca6c lookup 51820
32766:	from all lookup main

0xca6c é 51820 em hexadecimal, e 51820 também é o número da tabela. A regra suppress_prefixlength 0 faz com que a tabela principal ignore a sua própria rota predefinida. Assim, rotas específicas, como a da sua sub-rede local, continuam a ter prioridade, enquanto todo o restante tráfego passa para a tabela do túnel. Um túnel dividido não precisa de nada disso: uma lista mais restrita, como AllowedIPs = 10.8.0.0/24, 10.20.0.0/16, torna-se um conjunto de rotas normais na tabela principal.

Uma coisa que um túnel completo não corrige por si só é a resolução de nomes, porque o resolver que o cliente aprendeu da rede local normalmente permanece configurado e a sua rota é mais específica. Esse é um trabalho separado, abordado em DNS que escapa para fora de um túnel WireGuard.

Para que serve realmente PersistentKeepalive

O WireGuard não envia nada quando não há tráfego. Não há heartbeat, atualização da sessão nem qualquer outra atividade na rede. Esse silêncio ajuda a conservar a bateria e também ajuda no caso do scanner descrito acima, mas interrompe uma configuração específica.

Um peer atrás de NAT (network address translation) ou de uma firewall stateful só pode ser alcançado a partir do exterior enquanto existir um mapeamento nesse dispositivo, e esse mapeamento foi criado por um pacote de saída. Os tempos de vida comuns dos mapeamentos UDP começam nos 30 segundos. Quando o mapeamento expira, os pacotes vindos do lado público são descartados pelo dispositivo intermédio, e o túnel parece estar inativo até que o peer atrás de NAT envie alguma coisa. PersistentKeepalive = 25 envia um pacote autenticado vazio sempre que passam 25 segundos sem qualquer pacote autenticado a atravessar o túnel de ou para esse peer. O tráfego real reinicia a contagem, pelo que, num túnel ocupado, o pacote vazio raramente é enviado. Num túnel inativo, o intervalo nunca excede esse tempo de vida comum mais curto, mantendo o mapeamento aberto.

Configure-o no peer atrás de NAT. Um servidor com um endereço público e uma porta UDP aberta não precisa desta opção, e configurá-la nesse lado apenas acrescenta tráfego. Não a confunda com o keepalive automático, que é enviado 10 segundos depois de um peer receber dados e não ter nada próprio para enviar de volta. Esse mecanismo está sempre ativo e não pode ser configurado.

Encaminhar a sua LAN pelo túnel não é uma funcionalidade do WireGuard

Suponha que o peer B esteja numa rede doméstica 192.168.50.0/24 e que o peer A precise de aceder a essa rede. Dois sistemas diferentes têm de concordar com isto, e apenas um deles é o WireGuard.

A parte do WireGuard: adicione 192.168.50.0/24 ao AllowedIPs de B em A. Assim, A seleciona B para esse prefixo e aceita de B pacotes com esses endereços de origem, exceto quando um prefixo mais específico seleciona outro peer. Sem isto, o encaminhamento por cryptokey não tem uma chave para o destino nem permissão para a origem.

A parte do kernel: em B, net.ipv4.ip_forward tem de ser 1, ou o kernel descarta todos os pacotes desencriptados que não sejam destinados ao próprio B. A forward chain da firewall de B tem de permitir o tráfego. Os hosts da LAN precisam de uma rota de retorno para 10.8.0.0/24, ou B tem de aplicar source NAT para que as respostas voltem através de B.

A função do WireGuard termina quando entrega o pacote desencriptado ao kernel. Tudo o que acontece depois é encaminhamento e filtragem normais do Linux. Por isso, esta falha aparece nos contadores de nft list ruleset ou em ip -s link show wg0, e não em wg show. Se preferir gerir os peers através de uma interface web, executar wg-easy no Docker gera as entradas dos peers por si. No entanto, o encaminhamento continua a depender do suporte do kernel e da firewall do host. A mesma separação mantém-se quando uma camada de coordenação distribui o prefixo por si: anunciar uma rede privada a partir de um VPS com um router de sub-rede Tailscale substitui a edição manual de AllowedIPs em cada peer, mas continua a ser necessário ativar o encaminhamento IP no router. O Tailscale gere as suas próprias regras de firewall por predefinição.

Por que o WireGuard reside no kernel

wg0 é um controlador de dispositivo de rede. Os pacotes chegam até ele pela pilha de roteamento normal, são criptografados por workers do kernel e saem por um socket UDP sem passar pelo userspace. O WireGuard foi integrado ao Linux principal na versão 5.6, em março de 2020. Ubuntu 24.04 e Debian 13 já o incluem, portanto apenas o pacote wireguard-tools está ausente.

Ser uma interface normal tem consequências práticas. tcpdump -ni wg0 mostra os pacotes internos em texto simples, enquanto tcpdump -ni eth0 udp port 51820 mostra os pacotes externos criptografados. Comparar os dois permite identificar imediatamente qual direção está com problema. O netfilter e o traffic shaping tratam wg0 como qualquer outro link. Quando o módulo do kernel não está disponível, como em ambientes de virtualização de contêineres que compartilham o kernel do host, wireguard-go implementa o mesmo protocolo no userspace sobre um dispositivo TUN. Isso reduz o throughput, porque cada pacote atravessa o limite entre o kernel e o userspace duas vezes.

O que o WireGuard não protege

O modelo de ameaças é deliberadamente limitado, e um protocolo tão silencioso pode levar a falsas expectativas. Tenha isto claro.

  • Ele não oculta que está a usar WireGuard. As mensagens de handshake têm tamanhos fixos, o primeiro byte indica o tipo de mensagem e o transporte é UDP. A inspeção profunda de pacotes reconhece-o facilmente, e uma rede que bloqueie VPNs pode bloqueá-lo. A ofuscação foi excluída por decisão de projeto.
  • Ele não oculta o volume nem o momento do tráfego. Os payloads só recebem padding até ao limite de 16 bytes, por isso um observador continua a ver quando envia dados e aproximadamente quanto envia.
  • Mantém o último endpoint conhecido. O peer com o endereço público armazena o IP público atual do outro lado, e wg show apresenta-o. Juntamente com um endereço do túnel fixo na configuração, isso constitui um identificador estável que acompanha um utilizador entre redes. No seu próprio VPS, isto não é um problema. É também por isso que os serviços comerciais acrescentam uma camada acima do protocolo.
  • Autentica uma chave, não uma pessoa. Quem tiver o ficheiro da chave privada é o peer. Mantenha /etc/wireguard com o modo 700 e os ficheiros de chave com 600.
  • Não existe uma lista de revogação nem expiração. O acesso termina quando elimina a entrada do peer de todos os servidores que a armazenam, e as chaves estáticas permanecem válidas até serem removidas.

Nada disto torna o WireGuard fraco. Torna-o pequeno, e esse é o objetivo: autentica e cifra, deixando a gestão de identidades e a atribuição de endereços para aquilo que construir acima dele. Uma camada de coordenação do tipo descrito em WireGuard comparado com Tailscale existe precisamente para preencher essa lacuna, usando o mesmo plano de dados que acabou de consultar. Depois de essa camada estar implementada, a decisão seguinte é quem pode alcançar um serviço que executa dentro do túnel, que é o que a escolha entre Tailscale serve e funnel determina para uma única porta.

FAQ

O que é o encaminhamento por chave criptográfica no WireGuard?

O encaminhamento por chave criptográfica é a regra que associa cada pacote a uma chave pública. Cada entrada de peer contém uma lista de prefixos em AllowedIPs. No tráfego de saída, o WireGuard escolhe o peer comparando o destino do pacote com a lista de cada peer, usando primeiro o prefixo mais específico. Assim, a lista funciona como uma tabela de encaminhamento. No tráfego de entrada, depois de o pacote ser desencriptado e autenticado, uma pesquisa pelo prefixo mais específico do endereço de origem interno tem de selecionar esse mesmo peer. Caso contrário, o pacote é descartado. Assim, a lista também funciona como uma lista de controlo de acesso. O WireGuard não tem uma configuração de encaminhamento separada nem uma firewall interna separada, porque essa lista desempenha as duas funções.

Preciso de configurar PersistentKeepalive nos dois peers?

Não. Configure-o no lado que está atrás de NAT (tradução de endereços de rede) ou de uma firewall com estado, que normalmente é o cliente. O WireGuard não envia nada enquanto está inativo. Por isso, o mapeamento que permite ao lado remoto alcançar esse peer expira, muitas vezes em menos de um minuto, e o túnel parece ficar inativo numa direção. PersistentKeepalive = 25 envia um pacote autenticado vazio sempre que passam 25 segundos sem tráfego autenticado de ou para esse peer. Isso mantém o mapeamento aberto. Um peer com um endereço público e uma porta UDP aberta não precisa desta opção.

Por que motivo o ping através do túnel apresenta "Required key not available"?

Porque o endereço de destino não está dentro de nenhum AllowedIPs de peer. O encaminhamento por chave criptográfica não encontrou uma chave com a qual pudesse encriptar o pacote, e o kernel recusou enviá-lo. Execute wg show wg0 allowed-ips e compare o resultado com o endereço para o qual está a fazer ping. O erro semelhante Destination address required indica um problema diferente: foi encontrado um peer correspondente, mas o WireGuard não tem um endpoint para ele, porque não foi configurado nenhum e ainda não chegou desse peer qualquer pacote autenticado.

Uma firewall pode detetar e bloquear o WireGuard?

Sim. O WireGuard autentica e encripta o tráfego, mas não tenta disfarçar-se. As mensagens de início e resposta do handshake têm, respetivamente, 148 e 92 bytes, as respostas de cookie têm 64 bytes, o primeiro byte de cada mensagem identifica o seu tipo e o transporte usa UDP. Por isso, a inspeção profunda de pacotes identifica o protocolo sem dificuldade. As redes que bloqueiam UDP ou identificam protocolos por impressão digital vão bloqueá-lo. Ocultar o túnel significa encapsulá-lo noutro protocolo ou serviço. Isso requer uma ferramenta separada e não uma configuração do WireGuard.

Este artigo foi útil?