WireGuard

O que este assunto resolve

Peers, chaves, AllowedIPs, endpoints, routing, firewall, roaming e MTU.

Acompanhe o estado e o caminho do pacote

Valide underlay primeiro, depois negociação/estado do túnel, rotas, políticas, MTU e caminho de retorno.

Entrada → classificação/estado → decisão → tabela → next-hop/saída → counters

Projete antes de configurar

• Defina o domínio de falha e o comportamento esperado de convergência.
• Documente endereçamento, identificadores, timers, MTU e fronteiras de política.
• Prefira estado explícito e observável a suposições.
• Planeje rollback e acesso fora de banda antes de mudanças de risco.

Comandos e verificação

A sintaxe varia por plataforma e release. Os exemplos abaixo vêm do conteúdo existente do portal e devem ser validados na documentação da plataforma-alvo antes do uso em produção.

wg show
ip addr show wg0
ip route
ip route get 10.20.0.10
ss -lun
tcpdump -ni any udp port 51820

/interface/wireguard/print detail
/interface/wireguard/peers/print detail
/ip/address/print where interface~"wireguard"
/ip/route/print detail
/ip/firewall/filter/print detail stats

# Exemplo
/interface wireguard
add name=wg-site listen-port=51820

/interface wireguard peers
add interface=wg-site public-key="CHAVE_PUBLICA_REMOTA" \
    allowed-address=10.20.0.0/24 endpoint-address=198.51.100.2 \
    endpoint-port=51820

Fluxo orientado por evidências

1. Defina origem, destino, janela de tempo e sintoma exato.
2. Estabeleça o estado saudável esperado e compare com o observado.
3. Inspecione counters, tabelas, logs e capturas antes de resets.
4. Teste uma hipótese por vez e prefira mudanças reversíveis.
5. Repita o teste original após a correção e verifique efeitos colaterais.

WireGuard protocol documentation

Use o padrão/RFC vigente e a documentação da release exata em operação. A sintaxe do fabricante é detalhe de implementação; o comportamento do protocolo deve ser entendido de forma independente.

Comprove o comportamento em topologia controlada

Monte a menor topologia que reproduza o mecanismo, capture tráfego de controle e dados, introduza uma falha proposital e diagnostique antes de aplicar a correção.

Tópicos relacionados