Implementación paso a paso de BorgBackup con política 3‑2‑1
Introducción
La estrategia 3‑2‑1 es un estándar de la industria para garantizar la disponibilidad y la integridad de los datos críticos: tres copias, en dos tipos de medios diferentes y una copia fuera del sitio. En este artículo veremos cómo lograrla con BorgBackup, una herramienta de backup basada en deduplicación y cifrado robusto.
Dividiremos la implementación en cuatro bloques principales:
- Instalación y configuración básica de Borg.
- Creación de backups locales cifrados.
- Replicación a un servidor remoto y a un bucket de almacenamiento en la nube.
- Automatización de pruebas de restauración point‑in‑time.
1. Instalación y preparación del entorno
1.1. Requisitos de hardware y software
Para seguir este tutorial necesitaremos:
- Una máquina Linux (Debian/Ubuntu o CentOS) como cliente de backup.
- Un servidor remoto (SSH) con suficiente espacio para la segunda copia.
- Una cuenta en un servicio compatible con S3 (ej. Wasabi, Backblaze B2 o AWS S3).
- Paquetes:
borg,ssh,curl,python3-pipyrclone(para la nube).
1.2. Instalación de Borg y Rclone
# En Debian/Ubuntu sudo apt-get update sudo apt-get install -y borgbackup rcloneEn CentOS/RHEL
sudo yum install -y epel-release sudo yum install -y borgbackup rclone
Verificamos la versión:
borg --version
rclone version
1.3. Creación del usuario dedicado
Es buena práctica ejecutar los backups con un usuario sin privilegios de root.
sudo adduser --system --group --home /var/backups borguser
sudo mkdir -p /var/backups/local
sudo chown borguser:borguser /var/backups/local
2. Configuración de backups locales cifrados
2.1. Generación de la clave de cifrado
Borg utiliza una passphrase para cifrar los repositorios. La crearemos y la almacenaremos en un archivo seguro.
# Como borguser
export BORG_PASSPHRASE=$(openssl rand -base64 32)
echo $BORG_PASSPHRASE > ~/.borg_passphrase
chmod 600 ~/.borg_passphrase
Para que Borg la lea automáticamente, añadimos al .bashrc:
export BORG_PASSPHRASE=$(cat ~/.borg_passphrase)
2.2. Inicialización del repositorio local
# Ruta del repositorio REPO=/var/backups/local/borg_repoCrear el repositorio (cifrado AES256)
borg init —encryption=repokey $REPO
Con repokey la clave se guarda dentro del repositorio, pero también está cifrada con la passphrase anterior.
2.3. Definición de la política de retención
Usaremos borg prune para mantener:
- 7 backups diarios.
- 4 semanales.
- 12 mensuales.
borg prune $REPO \
--keep-daily=7 \
--keep-weekly=4 \
--keep-monthly=12 \
--list
2.4. Script de backup diario
Guardamos el siguiente script en /usr/local/sbin/borg-daily.sh y le damos permisos de ejecución.
#!/bin/bash set -euo pipefailVariables
REPO=“/var/backups/local/borg_repo” SRC=“/etc /home /var/www” LOG=“/var/log/borg-daily.log” DATE=$(date +“%Y-%m-%d_%H-%M”)
Ejecutar backup
borg create —stats —compression lz4
“$REPO::$DATE” $SRC >> $LOG 2>&1Prune
borg prune $REPO
—keep-daily=7 —keep-weekly=4 —keep-monthly=12
—list >> $LOG 2>&1
Programamos con cron (como borguser):
0 2 * * * /usr/local/sbin/borg-daily.sh
3. Replicación a servidor remoto y a la nube
3.1. Configuración del repositorio remoto (SSH)
En el servidor remoto creamos la carpeta de backup y el mismo usuario borguser (o usamos claves SSH).
# En el cliente
ssh borguser@remotesrv "mkdir -p /srv/borg/remote_repo"
# Inicializar (solo la primera vez)
borg init --encryption=repokey ssh://borguser@remotesrv//srv/borg/remote_repo
El comando de replicación utiliza borg transfer (disponible desde Borg 1.2). Si tu versión no lo tiene, usa rsync sobre el repositorio.
# Replicar el último backup al remoto
LATEST=$(borg list $REPO --short --last 1)
borg transfer $REPO::"$LATEST" ssh://borguser@remotesrv//srv/borg/remote_repo
3.2. Configuración de Rclone para el bucket S3
Instalamos y configuramos el remoto S3:
rclone config
# Selecciona "n" para new remote
# Nombre: mycloud
# Tipo de storage: s3
# Provider: AWS (compatible con la mayoría)
# Access key, Secret key, Region, etc.
Una vez creado, probamos la conexión:
rclone ls mycloud:borg-backups
3.3. Script de replicación a remoto y nube
#!/bin/bash set -euo pipefailREPO=“/var/backups/local/borg_repo” REMOTE=“ssh://borguser@remotesrv//srv/borg/remote_repo” CLOUD=“mycloud:borg-backups”
Replicar al servidor remoto
LATEST=$(borg list $REPO —short —last 1) borg transfer $REPO::“$LATEST” $REMOTE
Subir al bucket S3 (usando rclone copy)
Exportamos la passphrase para que rclone no la solicite
export BORG_PASSPHRASE=$(cat ~/.borg_passphrase)
Crear un archivo tar del backup (opcional, para S3)
TMP_TAR=“/tmp/borg_${LATEST}.tar” borg export-tar $REPO::“$LATEST” $TMP_TAR
Copiar a la nube
rclone copy $TMP_TAR $CLOUD —progress
Limpieza
rm -f $TMP_TAR
Programamos este script a las 03:30 h, después del backup diario:
30 3 * * * /usr/local/sbin/borg-replicate.sh
3.4. Verificación de integridad en cada destino
Después de cada replicación ejecutamos:
# Local borg check $REPORemoto
borg check $REMOTE
Nube (descarga y check rápido)
rclone copy $CLOUD/borg_${LATEST}.tar /tmp/restore_check.tar borg extract /tmp/restore_check.tar —list
Estos comandos detectan corrupción de datos antes de que sea demasiado tarde.
4. Pruebas automatizadas de restauración point‑in‑time
4.1. Por qué probar la restauración
Un backup sin restauración es inútil. Las pruebas periódicas garantizan que:
- Los datos cifrados pueden desencriptarse con la passphrase actual.
- Los procesos de extracción funcionan con la versión de Borg instalada.
- Los tiempos de recuperación cumplen con los SLA.
4.2. Script de prueba de restauración
#!/bin/bash set -euo pipefailREPO=“/var/backups/local/borg_repo” TESTDIR=“/var/tmp/borg_restore_test” LOG=“/var/log/borg-restore-test.log”
Seleccionar un backup aleatorio de los últimos 30 días
ARCHIVE=$(borg list $REPO —short —last 30 | shuf -n 1)
Crear directorio temporal
mkdir -p $TESTDIR
Extraer solo un archivo representativo (p.ej. /etc/hosts)
borg extract $REPO::“$ARCHIVE” /etc/hosts —target $TESTDIR >> $LOG 2>&1
Verificar que el archivo exista y tenga contenido
if [[ -s $TESTDIR/etc/hosts ]]; then echo ”$(date): RESTORE SUCCESS for $ARCHIVE” >> $LOG else echo ”$(date): RESTORE FAILURE for $ARCHIVE” >> $LOG fi
Limpieza
rm -rf $TESTDIR
Programamos la prueba semanal:
0 4 * * 0 /usr/local/sbin/borg-restore-test.sh
4.3. Alertas y reportes
Utilizamos mail o sendmail para notificar fallos:
if grep -q "FAILURE" $LOG; then
mail -s "BorgRestore Test FAILED" admin@example.com < $LOG
fi
5. Troubleshooting y errores comunes
5.1. “Password incorrect” al iniciar Borg
Cause frecuente: la passphrase no se exporta correctamente. Verifique:
echo $BORG_PASSPHRASE | wc -c # debe coincidir con la longitud esperada
cat ~/.borg_passphrase # sin caracteres extraños
Si se usa sudo, asegúrese de preservar el entorno (sudo -E).
5.2. “Repository does not exist” en la replicación
Compruebe la ruta SSH y los permisos del usuario remoto:
ssh borguser@remotesrv "ls -l /srv/borg/remote_repo"
Si la carpeta no existe, créela y vuelva a inicializar el repositorio.
5.3. Fallos de rclone copy por credenciales expiradas
Algunos proveedores (AWS) rotan las claves. Renueve la configuración con:
rclone config reconnect mycloud:
También revise los logs de rclone (--log-file /var/log/rclone.log --log-level DEBUG).
5.4. “Archive not found” al intentar restaurar
Esto indica que el nombre del archivo está mal o que el snapshot fue eliminado por prune. Use:
borg list $REPO --short
para listar los snapshots disponibles y ajustar la política de retención si es necesario.
5.5. Rendimiento lento en la extracción
Recomendaciones:
- Use compresión
lz4para backups ynonepara restauraciones si la CPU es el cuello de botella. - Monte el destino de restauración en un disco SSD.
- Ejecute
borg check --repairen caso de corrupción detectada.
Conclusión
Implementar BorgBackup siguiendo la política 3‑2‑1 brinda una solución de backup fiable, cifrada y altamente disponible. Con sólo tres scripts –backup diario, replicación y pruebas de restauración– y la correcta configuración de SSH y Rclone, conseguimos:
- Tres copias de los datos (local, remoto y nube).
- Dos medios diferentes (disco físico y almacenamiento en la nube).
- Una copia fuera del sitio que protege contra desastres locales.
La automatización de pruebas point‑in‑time garantiza que, cuando llegue el momento, la restauración se realice sin sorpresas. Recuerde revisar periódicamente los logs, rotar las claves de cifrado y actualizar Borg a la última versión estable para beneficiarse de mejoras de rendimiento y seguridad.
comentarios(0)
$ dejar comentario