Admin-Sistemas ·

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-pip y rclone (para la nube).

1.2. Instalación de Borg y Rclone

# En Debian/Ubuntu
sudo apt-get update
sudo apt-get install -y borgbackup rclone

En 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_repo

Crear 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 pipefail

Variables

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>&1

Prune

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 pipefail

REPO=“/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 $REPO

Remoto

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 pipefail

REPO=“/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 lz4 para backups y none para restauraciones si la CPU es el cuello de botella.
  • Monte el destino de restauración en un disco SSD.
  • Ejecute borg check --repair en 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.