Admin-Sistemas ·

Implementación paso a paso de backup automatizado con Restic en S3 y restauración point‑in‑time

Introducción

En entornos Linux, la pérdida de datos puede tener consecuencias críticas. Restic es una herramienta de backup moderna, segura y eficiente que permite almacenar copias en repositorios remotos como Amazon S3 o compatibles (MinIO, Wasabi, etc.). Este artículo muestra, paso a paso, cómo instalar Restic, crear un repositorio en S3, automatizar backups con systemd y validar la capacidad de restaurar datos en un punto específico en el tiempo (point‑in‑time).

1. Preparación del entorno

1.1 Requisitos previos

  • Servidor Linux (Debian/Ubuntu, CentOS/RHEL o Rocky) con acceso a internet.
  • Cuenta con acceso a un bucket S3 (AWS, DigitalOcean Spaces, Wasabi, etc.)
  • Permisos PutObject, GetObject y ListBucket para el bucket.
  • Usuario con privilegios sudo.

1.2 Instalación de Restic

Restic está disponible en los repositorios oficiales y como binario estático.

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

En CentOS/RHEL 8+

sudo dnf install -y epel-release sudo dnf install -y restic

O bien, descargar el binario más reciente

VERSION=$(curl -s https://api.github.com/repos/restic/restic/releases/latest | grep tag_name | cut -d ’”’ -f4) wget https://github.com/restic/restic/releases/download/${VERSION}/restic_${VERSION}_linux_amd64.bz2 bzip2 -d restic_${VERSION}linux_amd64.bz2 chmod +x restic${VERSION}linux_amd64 sudo mv restic${VERSION}_linux_amd64 /usr/local/bin/restic

1.3 Configuración de credenciales S3

Restic utiliza variables de entorno para autenticarse contra S3.

# Crear un archivo de entorno seguro
sudo mkdir -p /etc/restic
sudo touch /etc/restic/restic.env
sudo chmod 600 /etc/restic/restic.env

cat > /etc/restic/restic.env <<EOF AWS_ACCESS_KEY_ID=TU_ACCESS_KEY AWS_SECRET_ACCESS_KEY=TU_SECRET_KEY AWS_DEFAULT_REGION=us-east-1 RESTIC_REPOSITORY=s3:s3.amazonaws.com/mi-bucket-backup RESTIC_PASSWORD=UnaContraseñaSegura EOF

Es recomendable usar awscli o aws configure para validar credenciales antes de usarlas con Restic.

2. Creación y prueba del repositorio

2.1 Inicializar el repositorio

sudo -u backup bash -c 'source /etc/restic/restic.env && restic init'

Si el bucket está vacío, Restic creará la estructura necesaria. El comando devuelve un mensaje como created restic repository.

2.2 Realizar el primer backup

Supongamos que queremos respaldar /etc y /var/www.

sudo -u backup bash -c 'source /etc/restic/restic.env && \
restic backup /etc /var/www --exclude /var/www/tmp --verbose'

El flag --verbose muestra información de progreso; --exclude evita copiar directorios temporales.

2.3 Verificar snapshots creados

sudo -u backup bash -c 'source /etc/restic/restic.env && restic snapshots'

Deberá aparecer una tabla con el ID del snapshot, la fecha y los directorios respaldados.

3. Automatización con systemd

3.1 Crear usuario dedicado

sudo useradd -r -s /usr/sbin/nologin backup
sudo mkdir -p /var/backups/restic
sudo chown backup:backup /var/backups/restic

3.2 Servicio systemd para backup diario

Archivo de unidad: /etc/systemd/system/restic-backup.service

[Unit]
Description=Restic backup service
After=network-online.target
Wants=network-online.target

[Service] Type=oneshot User=backup Group=backup EnvironmentFile=/etc/restic/restic.env ExecStart=/usr/local/bin/restic backup /etc /var/www
—exclude /var/www/tmp
—tag daily
—quiet

[Install] WantedBy=multi-user.target

3.3 Timer systemd (ejecución diaria a las 02:30)

Archivo de timer: /etc/systemd/system/restic-backup.timer

[Unit]
Description=Run Restic backup daily at 02:30

[Timer] OnCalendar=--* 02:30:00 RandomizedDelaySec=15m Persistent=true

[Install] WantedBy=timers.target

Activar y comprobar:

sudo systemctl daemon-reload
sudo systemctl enable --now restic-backup.timer
systemctl list-timers --all | grep restic-backup

3.4 Rotación de snapshots (retención)

Restic incluye la política forget. Creamos otro servicio:

# /etc/systemd/system/restic-forget.service
[Unit]
Description=Restic forget old snapshots
After=restic-backup.service

[Service] Type=oneshot User=backup Group=backup EnvironmentFile=/etc/restic/restic.env ExecStart=/usr/local/bin/restic forget
—keep-daily 7
—keep-weekly 4
—keep-monthly 12
—prune

[Install] WantedBy=multi-user.target

Y su timer para ejecutar una vez al día después del backup:

# /etc/systemd/system/restic-forget.timer
[Unit]
Description=Run Restic forget after backup

[Timer] OnCalendar=--* 03:00:00 Persistent=true

[Install] WantedBy=timers.target

4. Pruebas de restauración point‑in‑time

4.1 Identificar snapshot a restaurar

sudo -u backup bash -c 'source /etc/restic/restic.env && \
restic snapshots --json | jq .[0]'

El campo time muestra la marca temporal. Copia el snapshot ID que necesitas.

4.2 Restaurar a una ubicación temporal

SNAPID=abcdef12
DEST=/tmp/restore-test
mkdir -p $DEST
sudo -u backup bash -c "source /etc/restic/restic.env && \
restic restore $SNAPID --target $DEST"

Comprueba que los archivos esperados existen:

ls -l $DEST/etc/hosts
diff -r $DEST/etc /etc | wc -l   # debería ser 0 si no hubo cambios

4.3 Restauración parcial (un solo archivo)

sudo -u backup bash -c "source /etc/restic/restic.env && \
restic restore $SNAPID --target $DEST --include /etc/ssh/sshd_config"

Esta técnica es útil para recuperar configuraciones sin sobrescribir todo el sistema.

4.4 Simulación de desastre y recuperación completa

1. Elimina deliberadamente un directorio:

sudo rm -rf /var/www/html

2. Restaura el snapshot más reciente:

LATEST=$(sudo -u backup bash -c 'source /etc/restic/restic.env && restic snapshots --latest 1 --quiet')
sudo -u backup bash -c "source /etc/restic/restic.env && \
restic restore $LATEST --target /"

3. Verifica integridad:

systemctl status apache2   # o nginx

5. Troubleshooting y errores comunes

5.1 Credenciales inválidas

Mensaje típico:

error: could not locate credentials: no such file or directory

Solución: Asegúrate de que /etc/restic/restic.env existe, tiene permisos 600 y contiene variables correctas. Usa env | grep AWS bajo el usuario backup para validar.

5.2 Problemas de conectividad S3

error: unable to list objects: Get "https://s3.amazonaws.com/mi-bucket-backup/...": dial tcp: lookup s3.amazonaws.com: no such host

Solución: Verifica resolución DNS y conectividad saliente (puertos 443). Si usas un endpoint privado (VPC), incluye la variable RESTIC_REPOSITORY=s3:s3.us-east-1.amazonaws.com/mi-bucket-backup o --s3-url.

5.3 Falta de espacio en el bucket

error: bucket does not have enough space

Acción: habilita la política de ciclo de vida en S3 para mover objetos a Glacier o revisa la política forget para eliminar snapshots antiguos.

5.4 Restauración fallida por permisos

restic restore: cannot create file ... permission denied

Ejecuta la restauración como usuario con privilegios adecuados (sudo -u backup para leer, sudo para escribir en /) o usa --target /tmp/restore y luego mueve manualmente con rsync -a.

5.5 Snapshots no aparecen en restic snapshots

Posibles causas:

  • Variable RESTIC_PASSWORD equivocada → Restic abre otro repositorio.
  • Archivo de entorno no cargado en la sesión del servicio → Añade EnvironmentFile al unit.

Conclusión

Implementar backups automatizados con Restic sobre S3 combina seguridad (cifrado de datos y autenticación IAM) y eficiencia (deduplicación y compresión). Siguiendo los pasos descritos —instalación, configuración de credenciales, creación del repositorio, pruebas iniciales, automatización con systemd y validación de restauraciones point‑in‑time—, los administradores pueden garantizar la disponibilidad de la información crítica y reducir el tiempo de recuperación ante incidentes. Además, la inclusión de políticas de retención (forget) y un plan de pruebas periódico evita sorpresas en momentos de crisis. Mantén el archivo de entorno bajo control de versiones seguro y revisa los logs de systemd (journalctl -u restic-*) para detectar fallos tempranos.