Admin-Sistemas ·

WireGuard site-to-site con failover automático usando Keepalived

Introducción a WireGuard y la necesidad de alta disponibilidad

WireGuard se ha consolidado como el protocolo VPN moderno por excelencia: minimalista, con criptografía robusta y rendimiento superior a OpenVPN o IPsec. Sin embargo, en despliegues site-to-site críticos, un único túnel representa un punto único de fallo. Cuando el enlace principal cae, toda la comunicación entre sedes se interrumpe.

La solución clásica implica múltiples conexiones WireGuard con rutas estáticas, pero la conmutación manual o mediante scripts frágiles no es fiable. Aquí entra Keepalived, una implementación de VRRP (Virtual Router Redundancy Protocol) que permite failover automático de direcciones IP virtuales y, combinado con scripts de seguimiento, puede cambiar rutas dinámicamente.

Este artículo aborda un escenario real: dos sedes (Sede A y Sede B) conectadas mediante dos enlaces WAN distintos. Cada sede tiene dos servidores WireGuard que forman túneles redundantes. Keepalived monitorea la salud de cada túnel y, si uno falla, promueve automáticamente el túnel de respaldo, reescribiendo las tablas de enrutamiento sin intervención humana.

Arquitectura de la solución

Consideremos la siguiente topología:

  • Sede A: dos servidores (gw-a1 con IP 10.0.1.1, gw-a2 con IP 10.0.1.2) conectados a dos proveedores distintos (ISP1, ISP2).
  • Sede B: dos servidores (gw-b1 con IP 10.0.2.1, gw-b2 con IP 10.0.2.2) con sus propios enlaces.
  • Redes internas: 192.168.1.0/24 (Sede A) y 192.168.2.0/24 (Sede B).

Se establecen dos túneles WireGuard:

  • Túnel primario: entre gw-a1 (puerto 51820) y gw-b1 (puerto 51820).
  • Túnel secundario: entre gw-a2 (puerto 51820) y gw-b2 (puerto 51820).

Cada túnel obtiene una dirección interna de la subred 10.200.0.0/24. El primario usa 10.200.0.1/32 en A y 10.200.0.2/32 en B; el secundario usa 10.200.0.3/32 y 10.200.0.4/32 respectivamente.

Keepalived en cada sede gestiona una IP virtual (VIP) que actuará como gateway para la red local. La VIP será 192.168.1.254 en Sede A y 192.168.2.254 en Sede B. Solo el nodo activo anuncia la VIP y establece la ruta por el túnel correspondiente.

Instalación y configuración básica de WireGuard

En ambos servidores de cada sede, instalamos WireGuard y creamos las claves:

# En todos los nodos
apt update && apt install wireguard keepalived -y
wg genkey | tee /etc/wireguard/private.key | wg pubkey > /etc/wireguard/public.key
chmod 600 /etc/wireguard/private.key

Configuración del túnel primario en gw-a1 (archivo /etc/wireguard/wg0.conf):

[Interface]
PrivateKey = <clave_privada_gw-a1>
Address = 10.200.0.1/32
ListenPort = 51820
Table = off
PostUp = ip rule add from 10.200.0.1 table 100
PostUp = ip route add 10.200.0.2/32 dev wg0 table 100
PostDown = ip rule del from 10.200.0.1 table 100

[Peer] PublicKey = <clave_publica_gw-b1> Endpoint = <IP_publica_gw-b1>:51820 AllowedIPs = 10.200.0.2/32 PersistentKeepalive = 25

Nota clave: Table = off evita que WireGuard agregue rutas automáticamente. Controlaremos el enrutamiento manualmente desde Keepalived.

Configuración del túnel secundario en gw-a2 (archivo /etc/wireguard/wg1.conf):

[Interface]
PrivateKey = <clave_privada_gw-a2>
Address = 10.200.0.3/32
ListenPort = 51821
Table = off
PostUp = ip rule add from 10.200.0.3 table 200
PostUp = ip route add 10.200.0.4/32 dev wg1 table 200
PostDown = ip rule del from 10.200.0.3 table 200

[Peer] PublicKey = <clave_publica_gw-b2> Endpoint = <IP_publica_gw-b2>:51821 AllowedIPs = 10.200.0.4/32 PersistentKeepalive = 25

Repetir configuración simétrica en los nodos de Sede B, intercambiando direcciones y claves.

Keepalived: configuración del failover

Keepalived usará VRRP para gestionar la VIP y scripts de seguimiento para verificar la conectividad del túnel y cambiar rutas. En cada sede, ambos nodos ejecutan Keepalived, pero solo uno estará en estado MASTER.

Archivo /etc/keepalived/keepalived.conf en gw-a1 (nodo primario):

global_defs {
   enable_script_security
   script_user root
}

vrrp_script check_wg_primary { script “/usr/local/bin/check_wg_tunnel.sh primary” interval 5 timeout 3 fall 2 rise 2 }

vrrp_script check_wg_secondary { script “/usr/local/bin/check_wg_tunnel.sh secondary” interval 5 timeout 3 fall 2 rise 2 }

vrrp_instance VI_1 { state MASTER interface eth0 # Interfaz de red local virtual_router_id 51 priority 150 advert_int 1 authentication { auth_type PASS auth_pass secret123 } virtual_ipaddress { 192.168.1.254/24 dev eth0 } track_script { check_wg_primary check_wg_secondary } notify_master “/usr/local/bin/wg_failover.sh master” notify_backup “/usr/local/bin/wg_failover.sh backup” notify_fault “/usr/local/bin/wg_failover.sh fault” }

En gw-a2 (nodo secundario), mismo archivo pero con state BACKUP y priority 100.

Scripts de verificación y failover

El script /usr/local/bin/check_wg_tunnel.sh comprueba si el túnel está activo enviando un ping al peer interno:

#!/bin/bash
TUNNEL=