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:
- No Linux (UFW/Iptables):
ufw allow 51820/udp
- 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-keyque 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.
- Edite o
telegraf.conf: Atualize o domínio público do cliente para o novo IP10.255.255.Xnos blocos[[inputs.ping]]e[[inputs.snmp]]. - Edite o
prometheus.yml: Atualize os targets do cliente para10.255.255.Xnos jobsmk-redeemk-dhcp. - Reinicie os contêineres:
docker restart telegraf prometheus
- 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 handshakeexistir: O túnel está perfeito. O WireGuard fez o trabalho dele. Vá para o item 3. - Se a linha não existir e
rxfor 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á nowg0.confdo Linux foi digitada com um espaço a mais. - Tx e Rx zerados: O MikroTik não sabe pra onde atirar. Causa:
endpoint-addresserrado, ou falta da instruçãopersistent-keepalive=25.
3. Túnel de pé, mas Ping falha ("Timeout" ou "Unreachable")
- No Linux: O erro
Destination address requiredsignifica que o MikroTik ainda não deu o primeiro "Oi". Aguarde opersistent-keepaliveagir. - No MikroTik (O mais comum):
- Você esqueceu de colocar a máscara
/24no/ip addressda interfacewg-monitoramento. - A sua regra de Firewall
/ip firewall filterliberando 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