Implementación de replicación síncrona ZFS en Proxmox para HA y DR
Introducción
En entornos de virtualización con Proxmox VE, la disponibilidad de las máquinas virtuales (VM) es crítica. ZFS, con su integridad de datos y capacidades de replicación, permite crear una arquitectura de alta disponibilidad (HA) y recuperación ante desastres (DR) sin depender de soluciones propietarias.
Este artículo muestra cómo configurar replicación síncrona de discos ZFS entre dos nodos Proxmox, cubrirá la creación de pools, la configuración de zfs send/receive con ssh, la integración con el gestor de recursos de Proxmox y los pasos de verificación.
1. Preparación de los nodos
1.1. Requisitos de hardware y software
- Dos servidores con CPU x86_64, al menos 8 GB RAM y discos SSD/HDD.
- Proxmox VE 8.x instalado y actualizado (
apt update && apt full-upgrade). - Kernel con soporte ZFS (paquete
proxmox-firmwareya lo incluye). - Acceso root por ssh sin contraseña entre nodos (claves públicas).
1.2. Instalación del paquete ZFS
apt install -y zfsutils-linux
El paquete instala zpool, zfs y utilidades de envío/recepción.
1.3. Configuración de claves SSH
En el nodo proxmox1:
ssh-keygen -t ed25519 -f /root/.ssh/id_ed25519 -N ""
ssh-copy-id -i /root/.ssh/id_ed25519.pub root@proxmox2
Repite al revés para que la replicación sea bidireccional si se necesita.
2. Creación y configuración de los pools ZFS
2.1. Diseño del pool
Se recomienda usar mirror o raidz1/2 según la tolerancia a fallos deseada. En este ejemplo usamos mirror con dos discos.
2.2. Creación del pool en cada nodo
En proxmox1:
zpool create -f -o ashift=12 \
-O acltype=posixacl -O xattr=sa -O normalization=formD \
-O canmount=off -O mountpoint=none rpool mirror /dev/sdb /dev/sdc
En proxmox2 repite la misma línea, cambiando el nombre del pool si lo deseas (p. ej. rpool2).
2.3. Creación de datasets para VMs
Proxmox crea automáticamente datasets bajo rpool/data. Para un control explícito:
zfs create -o mountpoint=none rpool/vmdata
zfs create -o mountpoint=/rpool/vmdata rpool/vmdata/100
Donde 100 es el ID de la VM. Repite para cada VM que deseas replicar.
3. Configuración de replicación síncrona
3.1. Principios de zfs send y zfs receive
El flujo típico es:
zfs snapshot rpool/vmdata/100@sync
zfs send -R -p rpool/vmdata/100@sync | ssh root@proxmox2 zfs receive -F rpool2/vmdata/100
El flag -R incluye snapshots y propiedades, -p preserva propiedades, y -F fuerza la sobrescritura del dataset destino.
3.2. Script de replicación automática
Guardamos el siguiente script en /usr/local/sbin/zfs-repl-sync.sh y lo marcamos como ejecutable:
#!/bin/bash SRC_POOL="rpool" DST_POOL="rpool2" DST_HOST="proxmox2" VM_ID=$1 # Se pasa como argumento TIMESTAMP=$(date +%Y%m%d%H%M%S)if [[ -z “$VM_ID” ]]; then echo “Uso: $0 <VM_ID>” exit 1 fi
SNAP=”${SRC_POOL}/vmdata/${VM_ID}@sync-${TIMESTAMP}” zfs snapshot $SNAP zfs send -R -p $SNAP | ssh root@${DST_HOST} zfs receive -F ${DST_POOL}/vmdata/${VM_ID} zfs destroy $SNAP
Este script crea un snapshot con marca temporal, envía los datos y elimina el snapshot local.
3.3. Programación con systemd timer
Creamos un servicio que invoque el script para la VM 100 cada 5 minutos.
# /etc/systemd/system/zfs-repl-100.service [Unit] Description=Replicación síncrona ZFS para VM 100[Service] Type=oneshot ExecStart=/usr/local/sbin/zfs-repl-sync.sh 100
/etc/systemd/system/zfs-repl-100.timer
[Unit] Description=Timer para replicación ZFS VM 100 cada 5 min
[Timer] OnBootSec=2min OnUnitActiveSec=5min Persistent=true
[Install] WantedBy=timers.target
Activamos:
systemctl daemon-reload
systemctl enable --now zfs-repl-100.timer
3.4. Configuración de HA en Proxmox
En la interfaz web de Proxmox:
- Ir a Datacenter → HA → Resources.
- Seleccionar la VM y pulsar Enable HA.
- Definir Target node como
proxmox1yproxmox2en modo migration.
Proxmox intentará mover la VM al nodo secundario si el primario falla; el dataset ZFS ya está sincronizado, por lo que el arranque será inmediato.
4. Verificación y pruebas de conmutación
4.1. Comprobación de integridad del snapshot
zfs list -t snapshot -r rpool/vmdata/100
Verifica que el snapshot @sync-YYYYMMDDHHMMSS exista en ambos nodos.
4.2. Simulación de fallo del nodo primario
Detenemos el nodo proxmox1:
ssh root@proxmox1 "shutdown -r now"
En la UI de Proxmox, la VM debería pasar a running en proxmox2. Si no, revisa los logs:
journalctl -u pve-cluster -u pve-ha-crm
4.3. Verificación de rendimiento
Durante la replicación, monitorea el ancho de banda:
nload -u M -t eth0
Para medir latencia de escritura en el pool destino:
fio --filename=/rpool2/vmdata/100/disk.img --rw=write --bs=1M --size=1G --name=write_test
5. Troubleshooting
5.1. Error común: zfs receive: cannot receive on existing dataset
- Causa: El dataset de destino ya contiene datos que no son parte del stream.
- Solución: Usa
-F(forzar) o destruye el dataset antes de la primera replicación:ssh root@proxmox2 "zfs destroy -r rpool2/vmdata/100"
5.2. Error: ssh: connect to host proxmox2 port 22: Connection timed out
- Causa: Firewall o clave SSH no configurada.
- Solución: Verifica que
iptablesoufwpermita el puerto 22 y que la clave pública exista en/root/.ssh/authorized_keysdel nodo destino.
5.3. Problema de “split-brain”
Si ambos nodos pierden conectividad y continúan aceptando escrituras, los datasets pueden divergir.
- Habilita
zfs set sync=standard rpoolpara que las escrituras esperen a confirmación del disco. - Usa
zfs rollbackal snapshot anterior y re‑inicia la replicación.
5.4. Replicación demasiado lenta
- Comprueba la MTU de la interfaz (
ip link show) y ajusta a 9000 si la red lo soporta. - Activa compresión ZFS en el pool:
zfs set compression=lz4 rpool. - Reduce la frecuencia del timer o usa
zfs send -L(large block) para menos overhead.
Conclusión
Implementar replicación síncrona de ZFS entre nodos Proxmox permite lograr una solución de alta disponibilidad y recuperación ante fallos robusta y de bajo coste. La combinación de snapshots, zfs send/receive y la integración nativa de Proxmox HA garantiza que, ante la caída de un nodo, las VMs continúen operativas sin pérdida de datos.
Los pasos descritos —preparación de nodos, creación de pools, scripting de replicación y pruebas de conmutación— forman una base que puedes adaptar a entornos más complejos, como clusters de tres o más nodos, o la incorporación de cifrado ZFS para mayor seguridad.
Recuerda monitorizar continuamente la salud de los discos (SMART), validar los snapshots y revisar los logs de HA. Con una configuración adecuada, tu infraestructura Proxmox será resiliente, escalable y fácil de mantener.