Configuración de túnel VPN site‑to‑site con WireGuard y failover automático con keepalived
Introducción
En entornos corporativos es frecuente la necesidad de conectar dos sedes de forma segura y con alta disponibilidad. WireGuard se ha posicionado como una solución VPN ligera, rápida y fácil de configurar. Sin embargo, por sí sola no ofrece mecanismos de failover cuando el nodo principal falla. En este artículo vamos a combinar WireGuard con keepalived para crear un túnel site‑to‑site con failover automático.
El objetivo es:
- Instalar y configurar WireGuard en dos pares de servidores (primary y backup) en cada sede.
- Configurar keepalived para que gestione una IP virtual que flote entre los pares.
- Verificar la conmutación por error y resolver problemas comunes.
Requisitos previos
Hardware y software
- Dos centros de datos (Sede A y Sede B) con al menos dos servidores cada una (uno activo, otro standby).
- Ubuntu Server 22.04 LTS o Debian 12 (los comandos están probados en estas versiones).
- Acceso root o sudo sin contraseña.
- Conexión IP pública o privada entre ambas sedes.
Puertos y firewall
WireGuard usa UDP, por defecto el puerto 51820. keepalived necesita VRRP (IP protocolo 112) y IP multicast. Asegúrese de permitir:
iptables -A INPUT -p udp --dport 51820 -j ACCEPT
iptables -A INPUT -p vrrp -j ACCEPT
iptables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
Instalación y configuración básica de WireGuard
1. Instalación del paquete
# En ambos servidores de cada sede
apt update
apt install -y wireguard iproute2
2. Generación de claves
En cada nodo generamos una pareja de claves públicas/privadas:
# Ejemplo en srv-a-primary wg genkey | tee /etc/wireguard/privatekey | wg pubkey > /etc/wireguard/publickeyRepetir en srv-a-backup, srv-b-primary y srv-b-backup
Guarde las claves en variables para usarlas después:
PRIV_A_PR=$(cat /etc/wireguard/privatekey)
PUB_A_PR=$(cat /etc/wireguard/publickey)
# ... idem para los demás
3. Configuración del interfaz WireGuard
Crearemos /etc/wireguard/wg0.conf en cada nodo. A continuación la configuración del nodo activo de la Sede A (srv-a-primary):
[Interface] Address = 10.10.0.1/24 # IP interna del túnel PrivateKey = ${PRIV_A_PR} ListenPort = 51820Peer: Sede B (primary)
[Peer] PublicKey = ${PUB_B_PR} Endpoint = 203.0.113.22:51820 # IP pública del nodo primary B AllowedIPs = 10.10.0.0/24 PersistentKeepalive = 25
En el nodo backup de la Sede A (srv-a-backup) la configuración es idéntica, pero cambiamos la IP interna si deseamos (ej. 10.10.0.2) y Endpoint apuntará a la IP pública del nodo primary de la Sede B.
4. Activar el túnel
# En cada servidor systemctl enable wg-quick@wg0 systemctl start wg-quick@wg0Verificar
wg show
Configuración de keepalived para IP flotante
1. Instalación
apt install -y keepalived
2. Diseño de la IP virtual
Definiremos una IP virtual en la red de gestión de cada sede (p.ej. 192.168.10.100/24). Esta IP será anunciada por el nodo activo y absorbida por el standby en caso de falla.
3. Archivo de configuración de keepalived
Ejemplo para srv-a-primary (/etc/keepalived/keepalived.conf):
vrrp_instance VI_1 {
state MASTER
interface eth0 # interfaz de salida a Internet
virtual_router_id 51
priority 150 # mayor prioridad = master
advert_int 1
authentication {
auth_type PASS
auth_pass secret123
}
virtual_ipaddress {
192.168.10.100/24 dev wg0 label wg0:vip
}
}
En srv-a-backup cambiamos state BACKUP y asignamos una priority menor (por ejemplo 100):
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 {
192.168.10.100/24 dev wg0 label wg0:vip
}
}
4. Integración con WireGuard
Al asignar la IP virtual al interfaz wg0, cualquier tráfico que llegue a 192.168.10.100 será encaminado por el túnel. Además, cuando el nodo activo falle, keepalived moverá la IP al backup manteniendo la conectividad.
5. Habilitar y probar
systemctl enable keepalived systemctl start keepalivedVerificar que la IP virtual está presente
ip addr show wg0
Simular failover: en master
systemctl stop keepalived
En backup debe asumir la IP automáticamente
ip addr show wg0
Pruebas de conectividad y validación
Ping y traceroute
Desde la Sede B:
ping -c 4 192.168.10.100
traceroute 192.168.10.100
Si todo está correcto, los paquetes atraviesan el túnel wg0 y llegan al nodo activo.
Comprobación de failover
- En la Sede A, detenga WireGuard en el nodo master:
systemctl stop wg-quick@wg0 - Observe que keepalived detecta la caída (VRRP advert missing) y promueve al backup.
- Verifique que la IP virtual sigue respondiendo:
ping -c 4 192.168.10.100
Sección de troubleshooting
Errores comunes
- VRRP no anuncia la IP virtual: revisa que la interfaz especificada en
interfacesea la correcta y que no haya conflictos de MAC. - WireGuard no se levanta: verifica que la clave privada exista y que el puerto 51820 no esté bloqueado por
ufwoiptables. - El ping falla después del failover: comprueba que la ruta por defecto en el nodo backup apunte al
wg0y queAllowedIPsincluya la subred completa del túnel. - Duplicado de dirección IP: si ambos nodos creen ser master, revisa la prioridad y los tiempos
advert_int. Incrementaprioritydel nodo que debe ser master.
Comandos útiles de diagnóstico
# Estado de keepalived systemctl status keepalived keepalived --dump-confEstado de WireGuard
wg show wg showconf wg0
Logs
journalctl -u keepalived -f journalctl -u wg-quick@wg0 -f
Reinicio ordenado
Para aplicar cambios sin perder conectividad:
# Primero actualizar la configuración de keepalived en backup systemctl reload keepalivedLuego, si es necesario, reiniciar WireGuard en master
systemctl restart wg-quick@wg0
Conclusión
Combinar WireGuard con keepalived permite crear un túnel VPN site‑to‑site robusto y con failover automático, ideal para entornos donde la continuidad del negocio es crítica. La solución es ligera, fácil de mantener y se basa en herramientas nativas de Linux, lo que simplifica la auditoría y el parcheado.
Recuerde siempre:
- Mantener las claves privadas seguras y rotarlas periódicamente.
- Monitorear los logs de keepalived y WireGuard con una herramienta de observabilidad (ej. Prometheus + Grafana).
- Probar el failover regularmente en una ventana controlada para garantizar que la conmutación funciona como se espera.
Con esta guía, cualquier sysadmin puede implementar una arquitectura de VPN de alta disponibilidad en cuestión de minutos, mejorando la resiliencia de la infraestructura de red corporativa.