Admin-Sistemas ·

Configuración site‑to‑site con WireGuard y failover automático usando Keepalived

Introducción

En entornos empresariales, la conectividad entre sedes debe ser confiable y tolerante a fallos. WireGuard se ha convertido en la opción predilecta para crear túneles VPN por su simplicidad, rendimiento y seguridad basada en criptografía moderna. Sin embargo, una única interfaz peer puede convertirse en punto único de falla si el enlace físico o el servidor que la hospeda deja de estar disponible.

Este artículo muestra cómo combinar WireGuard con Keepalived para lograr failover automático y alta disponibilidad (HA) de los túneles site‑to‑site. Se describen los pasos de instalación, configuración, pruebas y solución de problemas, todo con comandos reales y explicaciones del porqué de cada decisión.

Requisitos previos

Topología de ejemplo

  • Dos oficinas: Sede A y Sede B.
  • Cada sede cuenta con dos servidores Linux (Ubuntu 22.04 LTS) que actuarán como gateways HA:
    • Sede A: gw-a1 (IP: 10.0.0.1) y gw-a2 (IP: 10.0.0.2)
    • Sede B: gw-b1 (IP: 10.1.0.1) y gw-b2 (IP: 10.1.0.2)
  • Una red interna en cada sede (ej. 192.168.10.0/24 en A y 192.168.20.0/24 en B).
  • Conectividad IP entre los pares de servidores a través de un ISP o enlace dedicado.

Software necesario

En cada servidor instalaremos:

  • wireguard (kernel module + userspace tools).
  • keepalived para VRRP y gestión de IP flotante.
  • iptables o nftables para NAT y firewall.

Instalación de WireGuard y Keepalived

WireGuard

# apt update
# apt install -y wireguard wireguard-tools
# modprobe wireguard
# systemctl enable wg-quick@wg0

El paquete wireguard incluye el módulo del kernel y la utilidad wg. wg-quick@wg0 es el servicio que levanta la interfaz wg0 usando el archivo /etc/wireguard/wg0.conf.

Keepalived

# apt install -y keepalived
# systemctl enable keepalived

Keepalived provee VRRP (Virtual Router Redundancy Protocol) que permite que una IP flotante (por ejemplo 10.0.0.254 en la sede A) sea "propietaria" del nodo activo. Cuando el nodo activo falla, la IP flota automáticamente al nodo en espera.

Configuración de WireGuard con IP flotante

Generación de claves

Ejecutar en cada nodo:

# wg genkey | tee privatekey | wg pubkey > publickey

Copiar la clave pública de cada nodo al peer correspondiente.

Archivo wg0.conf en Sede A (gw-a1)

[Interface]
PrivateKey = <privkey-gw-a1>
Address = 10.200.200.1/24
ListenPort = 51820
# IP flotante que se anunciará al peer B
PostUp = ip addr add 10.0.0.254/32 dev wg0
PostDown = ip addr del 10.0.0.254/32 dev wg0

[Peer] PublicKey = <pubkey-gw-b1> Endpoint = 203.0.113.10:51820 # IP pública del nodo B AllowedIPs = 192.168.20.0/24, 10.1.0.0/24 PersistentKeepalive = 25

En la sección PostUp/PostDown añadimos la IP flotante 10.0.0.254. La IP será accesible sólo cuando gw-a1 sea el nodo maestro de Keepalived.

Archivo wg0.conf en Sede B (gw-b1)

[Interface]
PrivateKey = <privkey-gw-b1>
Address = 10.200.200.2/24
ListenPort = 51820
PostUp = ip addr add 10.1.0.254/32 dev wg0
PostDown = ip addr del 10.1.0.254/32 dev wg0

[Peer] PublicKey = <pubkey-gw-a1> Endpoint = 198.51.100.10:51820 # IP pública del nodo A AllowedIPs = 192.168.10.0/24, 10.0.0.0/24 PersistentKeepalive = 25

Configuración de Keepalived (VRRP)

En gw-a1 (maestro) y gw-a2 (backup) usamos el mismo virtual_router_id y la IP flotante 10.0.0.254.

# /etc/keepalived/keepalived.conf (gw-a1)
vrrp_instance VI_1 {
    state MASTER
    interface eth0
    virtual_router_id 51
    priority 150
    advert_int 1
    authentication {
        auth_type PASS
        auth_pass secret123
    }
    virtual_ipaddress {
        10.0.0.254/32 dev wg0 label wg0:vip
    }
}
# /etc/keepalived/keepalived.conf (gw-a2)
vrrp_instance VI_1 {
    state BACKUP
    interface eth0
    virtual_router_id 51
    priority 100
    advert_int 1
    authentication {
        auth_type PASS
        auth_pass secret123
    }
    virtual_ipaddress {
        10.0.0.254/32 dev wg0 label wg0:vip
    }
}

Repetimos la lógica en la sede B con virtual_router_id 52 y la IP 10.1.0.254. La IP flotante se asigna a la interfaz wg0, de modo que el tráfico VPN siempre sale por la IP activa.

Reglas de NAT y firewall

Habilitar el reenvío de paquetes

# sysctl -w net.ipv4.ip_forward=1
# echo "net.ipv4.ip_forward=1" >> /etc/sysctl.d/99-sysctl.conf

Masquerade para la red interna

En cada nodo maestro (el que posee la IP flotante) agregamos una regla de NAT que utilice la IP virtual. De esta forma, si el nodo maestro falla, el backup tomará la misma IP y la regla seguirá funcionando.

# iptables -t nat -A POSTROUTING -s 192.168.10.0/24 -o wg0 -j MASQUERADE --to-source 10.0.0.254
# iptables -A FORWARD -i wg0 -o eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT
# iptables -A FORWARD -i eth0 -o wg0 -s 192.168.10.0/24 -j ACCEPT

Guarda las reglas para que persistan tras reboot (por ejemplo con iptables‑save o netfilter‑persistent).

Pruebas de conectividad y failover

Verificar el túnel

# wg show wg0
# ping -c 3 10.200.200.2   # Desde gw-a1 a gw-b1
# ping -c 3 192.168.20.10   # Desde un host interno de la sede A a la red B

Simular fallo del nodo maestro

En la sede A, detén Keepalived en gw-a1:

# systemctl stop keepalived

Observa que Keepalived en gw-a2 asume la IP 10.0.0.254 (verifica con ip a show wg0). Inmediatamente, las pruebas de ping deben seguir funcionando porque el tráfico ahora sale por gw-a2.

Comprobación de conmutación inversa

Reinicia el nodo original y verifica que vuelva a ser MASTER (prioridad mayor). Keepalived realizará la transición sin interrumpir la sesión VPN gracias a la persistencia de la IP flotante.

Sección de Troubleshooting

Problema 1 – La IP flotante no se asigna a wg0

  • Síntoma: ip a show wg0 no muestra 10.0.0.254.
  • Causa frecuente: Keepalived se ejecuta antes de que wg-quick@wg0 haya creado la interfaz.
  • Solución: Añadir depend_on = wg0 en la sección vrrp_script o retrasar el arranque de Keepalived con ExecStartPre=/bin/sleep 5 en el unit file.

Problema 2 – El túnel se cae al hacer failover

  • Síntoma: Después del cambio de nodo, wg show indica peer: DOWN.
  • Causa: La regla Endpoint del peer sigue apuntando a la IP pública del nodo que falló.
  • Solución: Configurar PersistentKeepalive = 25 (ya hecho) y permitir que WireGuard descubra la nueva IP mediante Endpoint = IP pública de la red + PersistentKeepalive. Alternativamente, usar un DNS dinámico y Endpoint = vpn.example.com:51820.

Problema 3 – NAT no funciona tras failover

  • Síntoma: Los hosts internos pierden conectividad a la red remota.
  • Causa: La regla de iptables está vinculada a la IP estática del nodo anterior.
  • Solución: Utilizar la IP flotante en la regla (como en el ejemplo) y guardar la regla en ambos nodos. Verificar con iptables -t nat -L -v.

Problema 4 – Keepalived entra en estado FAULT

  • Síntoma: Logs de Keepalived muestran Entering FAULT state.
  • Causa: Direcciones IP configuradas en virtual_ipaddress no coinciden con la interfaz especificada.
  • Solución: Asegurarse de que la interfaz exista y tenga una dirección IP primaria antes de que Keepalived intente asignar la virtual. Revisar keepalived -n -D para modo de depuración.

Conclusión

Combinar WireGuard con Keepalived permite crear túneles site‑to‑site que no solo son rápidos y seguros, sino también resilientes ante fallos de hardware o de enlace. La clave está en:

  • Asignar la IP flotante a la interfaz wg0 mediante PostUp/PostDown.
  • Configurar VRRP con prioridades adecuadas y sincronizar la IP virtual en ambos lados del enlace.
  • Utilizar NAT basado en la IP flotante para que el tráfico continúe fluyendo sin cambios al cambiar de nodo.
  • Probar exhaustivamente el failover y conservar reglas de firewall idénticas en todos los nodos.

Siguiendo los pasos detallados en este artículo, cualquier sysadmin podrá desplegar una solución de VPN de alta disponibilidad con un esfuerzo mínimo, manteniendo la infraestructura de red simple y fácil de gestionar.