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)ygw-a2 (IP: 10.0.0.2) - Sede B:
gw-b1 (IP: 10.1.0.1)ygw-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).keepalivedpara VRRP y gestión de IP flotante.- iptables o
nftablespara 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 wg0no muestra10.0.0.254. - Causa frecuente: Keepalived se ejecuta antes de que
wg-quick@wg0haya creado la interfaz. - Solución: Añadir
depend_on = wg0en la secciónvrrp_scripto retrasar el arranque de Keepalived conExecStartPre=/bin/sleep 5en el unit file.
Problema 2 – El túnel se cae al hacer failover
- Síntoma: Después del cambio de nodo,
wg showindicapeer: DOWN. - Causa: La regla
Endpointdel 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 medianteEndpoint = IP pública de la red+PersistentKeepalive. Alternativamente, usar un DNS dinámico yEndpoint = 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_ipaddressno 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 -Dpara 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
wg0mediantePostUp/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.