~/conhecimento/monitoramento-in-band-via-tunel-wireguard

Monitoramento In-Band via Túnel WireGuard

publicado em 18/08/2026 às 19:41 atualizado em 20/11/2026 às 07:27

📖 Documentação SRE: Monitoramento Resiliente via Túnel WireGuard

Objetivo: Estabelecer uma rede VPN (Virtual Private Network) leve e imune a quedas de link (Multi-WAN) e trocas de IP dinâmico (DDNS). O servidor Linux atuará como "Concentrador" e os roteadores MikroTik como "Clientes", garantindo que a coleta SNMP e ICMP ocorra via IP privado fixo.

Topologia da Rede (In-Band):

  • Servidor VPN (Matriz): Servidor Linux nativo (Echelon).
  • Clientes VPN (Filiais): Roteadores MikroTik (RouterOS v7).
  • Rede do Túnel: 10.255.255.0/24
  • Porta de Comunicação: 51820 / UDP

🛠️ PARTE 1: Preparando o Servidor Linux (Matriz)

Esta etapa é feita apenas uma vez na máquina física/virtual (fora do Docker).

1. Instalação e Geração de Chaves

Acesse o terminal do servidor Linux e instale o pacote nativo:

apt update && apt install wireguard -y

Gere o par de chaves de segurança do servidor:

cd /etc/wireguard
umask 077
wg genkey | tee privatekey | wg pubkey > publickey

Copie e guarde o conteúdo dessas duas chaves (você precisará delas):

cat privatekey
cat publickey

2. Criando o Arquivo de Configuração Principal

Crie e edite o arquivo da placa de rede virtual:

nano /etc/wireguard/wg0.conf

Cole a estrutura abaixo. Substitua <CHAVE_PRIVADA_DO_SERVIDOR> pela chave privatekey gerada no passo anterior.

[Interface]
Address = 10.255.255.1/24
ListenPort = 51820
PrivateKey = <CHAVE_PRIVADA_DO_SERVIDOR>

# Os blocos [Peer] dos clientes serão adicionados aqui embaixo futuramente.

Salve e saia (Ctrl+X, Y, Enter).

3. Liberação Rigorosa de Firewall

Para o túnel funcionar, a porta 51820 UDP precisa estar aberta em duas camadas:

  1. No Linux (UFW/Iptables):
ufw allow 51820/udp
  1. No Hipervisor (Proxmox / Nuvem): Acesse o painel web do seu Proxmox (ou painel da Nuvem) e crie uma regra de entrada (Inbound) permitindo o protocolo UDP na porta 51820. Se esquecer isso, os MikroTiks nunca alcançarão o Linux.

4. Ativando o Serviço

Passe o controle para o gerenciador de serviços do Linux para que o túnel suba automaticamente no boot:

systemctl enable --now wg-quick@wg0
systemctl status wg-quick@wg0

🚀 PARTE 2: Como adicionar um Novo MikroTik (Passo a Passo)

Sempre que um novo cliente (Ex: Sektor, MelloAIT) entrar no seu monitoramento, execute exatamente este roteiro.

Passo A: Configuração no MikroTik do Cliente

Abra o New Terminal no WinBox do cliente.

1. Criar a interface de túnel:

/interface wireguard add name=wg-monitoramento listen-port=13231 mtu=1420

2. Pegar a Chave Pública deste MikroTik:

/interface wireguard print

Ação: Copie a public-key que aparece na tela. Você vai colar ela no Linux no Passo B.

3. Atribuir o IP da VPN: Defina qual será o IP deste roteador (Ex: .2, .3, .4). Nunca esqueça a máscara /24!

/ip address add address=10.255.255.X/24 interface=wg-monitoramento comment="IP Monitoramento WireGuard"

4. Criar o apontamento para o Servidor (Peer): Atenção: Substitua <CHAVE_PUBLICA_DO_SERVIDOR> pela publickey que você gerou no Linux lá na Parte 1. Substitua o endpoint-address pelo IP público do Echelon.

/interface wireguard peers
add interface=wg-monitoramento public-key="<CHAVE_PUBLICA_DO_SERVIDOR>" endpoint-address=187.110.161.52 endpoint-port=51820 allowed-address=10.255.255.1/32 persistent-keepalive=25 comment="Servidor Echelon"

5. Liberar o Monitoramento no Firewall do MikroTik: Coloque as liberações no topo das regras de Input para evitar que o bloqueio padrão ("Drop all") descarte a coleta.

/ip firewall filter
add action=accept chain=input src-address=10.255.255.1 protocol=icmp comment="ACCEPT: Ping VPN Monitoramento" place-before=0
add action=accept chain=input src-address=10.255.255.1 dst-port=161 protocol=udp comment="ACCEPT: SNMP VPN Monitoramento" place-before=1

Passo B: Autorização no Servidor Linux (Echelon)

O Linux precisa saber que esse novo MikroTik tem permissão para conectar.

1. Edite o arquivo:

nano /etc/wireguard/wg0.conf

2. Adicione o novo bloco [Peer] no final do arquivo: Cole a Chave Pública do MikroTik (copiada no Passo A.2) e coloque o mesmo IP que você configurou no Passo A.3 (desta vez terminando com /32).

[Peer]
# Nome do Novo Cliente
PublicKey = <CHAVE_PUBLICA_DO_NOVO_MIKROTIK>
AllowedIPs = 10.255.255.X/32

Salve o arquivo.

3. Reinicie o túnel graciosamente:

systemctl restart wg-quick@wg0

Passo C: Atualização dos Coletores (Docker)

Agora que o túnel fechou, aponte os rasparadores para o novo IP interno.

  1. Edite o telegraf.conf: Atualize o domínio público do cliente para o novo IP 10.255.255.X nos blocos [[inputs.ping]] e [[inputs.snmp]].
  2. Edite o prometheus.yml: Atualize os targets do cliente para 10.255.255.X nos jobs mk-rede e mk-dhcp.
  3. Reinicie os contêineres:
docker restart telegraf prometheus
  1. Ajuste o Grafana (se necessário): Atualize as variáveis ("Variables") do Dashboard para ler o novo endereço IP numérico.

⚕️ Guia de Troubleshooting SRE (Solução de Problemas)

Se o IP interno não pingar, faça a checagem nesta exata ordem:

1. O "Aperto de Mãos" (Handshake) ocorreu?

No Linux, rode: wg show

  • Se a linha latest handshake existir: O túnel está perfeito. O WireGuard fez o trabalho dele. Vá para o item 3.
  • Se a linha não existir e rx for 0: As chaves não batem, ou o pacote não está chegando no Linux. Vá para o item 2.

2. Verificando o Fluxo de Pacotes (Tx/Rx)

No WinBox do cliente, vá em WireGuard -> Peers. Olhe os contadores:

  • Tx sobe e Rx zerado: O MikroTik está enviando, mas o Linux ignora. Causa: O firewall do Proxmox não está liberando a porta 51820 UDP, ou a Chave Pública do MikroTik que está no wg0.conf do Linux foi digitada com um espaço a mais.
  • Tx e Rx zerados: O MikroTik não sabe pra onde atirar. Causa: endpoint-address errado, ou falta da instrução persistent-keepalive=25.

3. Túnel de pé, mas Ping falha ("Timeout" ou "Unreachable")

  • No Linux: O erro Destination address required significa que o MikroTik ainda não deu o primeiro "Oi". Aguarde o persistent-keepalive agir.
  • No MikroTik (O mais comum):
  1. Você esqueceu de colocar a máscara /24 no /ip address da interface wg-monitoramento.
  2. A sua regra de Firewall /ip firewall filter liberando o ICMP e o SNMP não está no topo da lista (antes da regra de Drop Geral).

4. Erro de Serviço no Linux ("wg0 already exists")

Se rodar o systemctl restart wg-quick@wg0 e ele falhar avisando que a interface já existe, significa que você subiu o túnel manualmente antes.

  • Solução: Derrube a manual e suba pelo Systemd.
wg-quick down wg0
systemctl start wg-quick@wg0

Precisa disso implementado na sua empresa?

Eu faço o trabalho para você, com segurança e documentação.

>_ SOLICITAR ORÇAMENTO