restic en servidor pequeño: copias cifradas y verificables
$ índice
Un servidor modesto (2 vCPU, discos normales, un puñado de servicios y una base de datos) suele acabar con un script de rsync a un disco externo y una fe razonable en que «eso funciona». Funciona hasta que alguien borra un fichero hace tres semanas, hasta que el disco de destino revienta a la vez que el origen, o hasta que hay que demostrar que la copia se puede restaurar. Ahí empieza el problema real: no falta copia, falta histórico, verificación y cifrado.
En el blog ya montamos restic contra S3/B2 y lo programamos con systemd. Esta pieza va de lo que faltaba: qué garantiza restic por dentro, cómo montar un destino propio sin nube (SFTP o rest-server en modo append-only), cómo volcar bases de datos sin dejar ficheros temporales con datos sensibles y cómo verificar de verdad en lugar de confiar en que el timer hizo su trabajo.
Por qué restic y no rsync (ni borg)
| Criterio | rsync | borg | restic |
|---|---|---|---|
| Histórico de versiones | No (o hardlinks a mano con --link-dest) |
Sí | Sí |
| Deduplicación | No | Sí (CDC, buzhash) | Sí (CDC, Rabin) |
| Cifrado en cliente | No | Sí | Sí |
| Qué hay que instalar en destino | rsync y SSH | borg y sus dependencias | Nada con S3/B2; rest-server o sftp-server con destino propio |
| Distribución | Sistema | Python + libs | Binario estático único |
Coste de prune |
No aplica | Moderado | Alto: reescribe packs |
| Montaje FUSE | No | Sí | Sí |
| Modo append-only | No aplica | borg serve --append-only |
rest-server y rclone serve restic (ambos con --append-only) |
La fila que decide en un servidor pequeño es la cuarta: restic no necesita agente ni usuario con shell completo en el destino. A cambio, prune es más caro que en borg, porque reescribe packs para recuperar espacio. Si vienes de borg, la comparativa larga está en BorgBackup: backups deduplicados y cifrados con retención GFS.
Qué garantiza restic por dentro
Un repositorio es un árbol de ficheros y directorios. Cada backup crea una instantánea: un documento JSON cifrado que describe el estado de un conjunto de rutas en un momento dado. Los ficheros se trocean en blobs de tamaño variable mediante content-defined chunking con Rabin fingerprints y ventana deslizante de 64 bytes (blobs de 512 KiB a 8 MiB, 1 MiB de media; el polinomio se sortea al crear el repositorio, lo que complica los ataques de marca de agua). Cada blob se identifica por el SHA-256 de su contenido: de ahí que dos backups del mismo /etc solo suban lo que cambia.
Los blobs van en ficheros pack dentro de data/. Todos se escriben una vez y nunca se modifican, y su nombre es el hash de su contenido: sha256sum contra el nombre del fichero comprueba integridad sin más herramientas.
El cifrado no es opcional y ocurre siempre en el cliente: AES-256 en modo contador (CTR) para el contenido y Poly1305-AES como MAC, con 16 bytes de IV y 16 de MAC por fichero. La contraseña no cifra los datos: con scrypt se deriva una clave que descifra la clave maestra, y lo que hay en keys/ es exactamente eso, la clave maestra cifrada, en un fichero JSON por contraseña. Tres consecuencias:
- El proveedor de almacenamiento ve paquetes cifrados y nombres hasheados, nada más. Puede alojar tus copias sin poder leerlas.
- Si se pierde la contraseña, los datos son irrecuperables. Sin puerta trasera. Añade una segunda clave (
restic key add) y guárdala fuera del servidor respaldado. - Varias claves son varias contraseñas para el mismo repositorio, y cambiar la contraseña (
restic key passwd) solo reescribe ese fichero: no re-cifra nada. Es cómodo, y también significa que rotar contraseñas no te protege de una clave antigua que alguien conservó.
Desde el formato de repositorio v2 (restic 0.14+, y lo que crea restic init hoy) los datos se comprimen con zstd en modo auto. La 0.19.0 añadió los niveles fastest y better y redujo memoria en check, copy, diff y stats. Un repositorio antiguo en v1 no se convierte solo: hay que ejecutar restic migrate upgrade_repo_v2 y después prune --repack-uncompressed para ir comprimiendo lo ya guardado.
Lo que restic no es: no es una imagen de sistema (no hay bare-metal restore), no toma instantáneas atómicas del sistema de ficheros ni de una base de datos en caliente, y no sustituye a vzdump/Proxmox Backup Server si lo que quieres es levantar una VM entera. Es copia de ficheros a nivel de aplicación, con histórico y verificación.
Instalación y creación del repositorio
Debian 13 empaqueta la 0.18.0. La última estable es la 0.19.1 (julio de 2026). Elige una y no mezcles:
apt policy restic
apt install restic
restic version
# Alternativa: binario oficial en /usr/local/bin (recomendado si quieres 0.19.x)
VER=0.19.1
cd /tmp
curl -LO https://github.com/restic/restic/releases/download/v${VER}/restic_${VER}_linux_amd64.bz2
bunzip2 restic_${VER}_linux_amd64.bz2
install -m 0755 restic_${VER}_linux_amd64 /usr/local/bin/restic
restic version
restic self-update solo tiene sentido sobre el binario oficial de /usr/local/bin. Si usas el paquete, actualiza con apt y no mezcles los dos.
Ojo con lo que trae cada Debian: bookworm (12) se quedó en la 0.14.0, trixie (13) trae la 0.18.0 y la 0.19.1 solo está en unstable. Por debajo de 0.17 no existe --stdin-from-command —el volcado de bases de datos de más abajo— y por debajo de 0.14 no hay compresión. Si el servidor es Debian 12, no lo dudes: binario oficial.
La contraseña va en un fichero que solo lea root, nunca en el script ni en la línea de comandos (donde acaba en ps):
install -d -m 0700 /etc/restic
openssl rand -base64 32 > /etc/restic/password
chmod 0600 /etc/restic/password
chown root:root /etc/restic/password
restic recorta espacios y saltos de línea al leer el fichero, así que el \n final de openssl rand no molesta; lo que no debe haber son espacios al principio o al final de una contraseña escrita a mano, porque se perderán en silencio.
Y el entorno, en un fichero aparte, para que lo usen tanto los comandos manuales como systemd:
# /etc/restic/env
RESTIC_REPOSITORY=sftp:backup@backup.example.net:/srv/restic/servidor01
RESTIC_PASSWORD_FILE=/etc/restic/password
RESTIC_CACHE_DIR=/var/cache/restic
chmod 0600 /etc/restic/env
set -a; . /etc/restic/env; set +a
restic init
Si el repositorio es local, que no esté dentro de ninguna ruta que vayas a respaldar (bucle garantizado). Y nada de repositorios sobre CIFS/SMB —ni respaldar datos que vivan en uno—: la documentación lo desaconseja por problemas de compatibilidad con núcleos antiguos.
Qué respaldar y qué excluir
El patrón que funciona en un servidor pequeño es: configuración, datos de aplicación, homes y volcados de base de datos. Todo lo demás sobra y solo engorda el repositorio.
# /etc/restic/exclude.txt
/proc
/sys
/dev
/run
/tmp
/var/tmp
/var/cache
/var/lib/docker/overlay2
/home/*/.cache
/srv/restic-repo
restic backup /etc /home /root /srv /var/www \
--exclude-file=/etc/restic/exclude.txt \
--exclude-caches \
--tag diario --host servidor01
--exclude-caches salta directorios marcados con CACHEDIR.TAG. --host y --tag no son cosmética: son los filtros de forget, check y restore, y sin ellos acabas con políticas de retención que no controlas.
Para las bases de datos, copiar /var/lib/mysql en caliente es una lotería. Lo correcto es volcar y enviar el volcado por stdin, sin fichero temporal con datos sensibles en disco. --stdin-from-command (0.17+) ejecuta el comando, guarda su salida y, si el comando falla, aborta sin crear snapshot; con una tubería a --stdin eso no se detecta y te queda un backup vacío con aspecto de bueno:
# /etc/restic/mysql.cnf (0600 root). --defaults-extra-file debe ir PRIMERO
[client]
user=backup
password=CambiarEsta
host=localhost
restic backup --stdin-from-command --stdin-filename mysql-todas.sql \
--tag db --host servidor01 -- \
mysqldump --defaults-extra-file=/etc/restic/mysql.cnf \
--single-transaction --quick --routines --events --all-databases
restic backup --stdin-from-command --stdin-filename pg-todas.sql \
--tag db --host servidor01 -- \
pg_dumpall --clean
Tres matices que cuestan descubrir tarde: mysqldump lee credenciales de ~/.my.cnf y bajo systemd HOME puede no existir, de ahí --defaults-extra-file; --single-transaction solo es consistente con tablas InnoDB (con MyISAM de por medio, no hay instantánea); y --all-databases incluye el esquema mysql con los hashes de contraseñas, así que el repositorio pasa a contener material sensible. En PostgreSQL, pg_dumpall necesita leer todas las bases: usa un rol con pg_read_all_data y PGPASSFILE=/etc/restic/pgpass (0600) en el entorno de la unidad, no el superusuario del sistema.

Destino propio sin nube
Tres opciones sensatas, de menos a más infraestructura:
- SFTP a otro host que ya tengas. Solo necesitas una cuenta sin shell interactiva y el subsistema sftp. Cuidado con
ForceCommandagresivos: rompen sftp con facilidad. - rest-server, el servidor HTTP oficial. Aporta la pieza que más se echa de menos:
--append-only. Con append-only el cliente no puede borrar ni sobrescribir, así que un servidor comprometido puede enviar basura, pero no destruir el histórico. - Objetos (S3, B2) con backend nativo o rclone, con object lock o versionado inmutable si el proveedor lo permite. Es lo que mejor sobrevive a un ransomware; del tema ya escribimos en copias inmutables con Object Lock.
# En el destino: rest-server exige .htpasswd salvo que uses --no-auth
htpasswd -B -c /srv/restic/.htpasswd backup
rest-server --path /srv/restic --append-only --listen :8000 \
--tls --tls-cert /etc/ssl/certs/backup.pem --tls-key /etc/ssl/private/backup.key
# En el cliente (/etc/restic/env, 0600)
RESTIC_REPOSITORY=rest:https://backup.example.net:8000/servidor01/
RESTIC_REST_USERNAME=backup
RESTIC_REST_PASSWORD=ponla_en_el_fichero_de_entorno
Dos letras pequeñas. La primera: HTTP plano con autenticación Basic manda la contraseña en claro en cada petición; o TLS en rest-server, o un proxy delante. La segunda: para recuperar espacio necesitas forget y prune, y eso exige permiso de borrado. El patrón recomendado es un cliente separado y bien protegido que abra el repositorio sin append-only solo para la purga. Y si el repositorio es append-only, la política de forget debe apoyarse en --keep-within y no en --keep-daily/--keep-weekly: quien pueda añadir snapshots puede inundar las últimas semanas con basura y expulsar los legítimos con una política de «conserva N por periodo».
Retención: forget, prune y el filtro que falta
forget quita instantáneas de la lista; prune borra los blobs que ya no referencia nadie y reescribe packs. Dos ejecuciones, una política por tipo de dato:
# ficheros: una semana de diarios, un mes largo de semanales, un año de mensuales
restic forget --tag diario --host servidor01 \
--keep-daily 7 --keep-weekly 5 --keep-monthly 12
# volcados de BD: política propia, y aquí sí el prune (es la cara)
restic forget --tag db --host servidor01 \
--keep-daily 14 --keep-monthly 6 --prune
¿Por qué el --tag? Porque sin él, forget aplica la política a todos los snapshots de ese host. No borra de más —agrupa por host y rutas, y cada grupo recibe la política por separado—, pero acabas decidiendo la retención de los volcados de base de datos sin haberlo decidido. Y si algún día añades --group-by '', entonces sí mezclas todo en un solo grupo y la política se aplica al conjunto: ese es el comando que borra lo que no debía. Si cambias --group-by en backup, cámbialo igual en forget.
Dos avisos que cuestan caros:
prunees la operación con más I/O del ciclo. De madrugada, conniceeionice, y no encadenada a cada backup. Con el disco lleno,prune --max-repack-size 0minimiza el espacio temporal (solo sirve después de haber hechoforget).- El histórico no te salva de un borrado lógico que tú propagas: si borras el fichero y lanzas
forgetcon la política equivocada, desaparece cuandoprunelimpia.
Verificar, que es justo lo que nadie hace
Un backup sin restaurar es una hipótesis:
restic check # estructura, índices y coherencia
restic check --read-data-subset=10% # lee y descifra un 10% aleatorio de los packs
restic check --read-data-subset=3/10 # bloque fijo: rotando 1/10…10/10 cubres todo
restic snapshots --latest 5 # los 5 últimos de cada grupo host+rutas
restic stats --mode raw-data
restic diff <snapshotA> <snapshotB>
check a secas valida índices y metadatos, no el contenido de todos los packs. Para saber que los datos se leen hay que leerlos, y aquí está el detalle que se malinterpreta: --read-data-subset=10% elige un subconjunto aleatorio en cada ejecución, y la documentación avisa de que no garantiza recorrer todo el repositorio por muchas veces que lo lances. Si quieres cobertura garantizada, usa la forma n/t, que parte los packs en t grupos fijos y revisa el grupo n: rotando del 1/10 al 10/10 tienes el repositorio completo en diez semanas, sin discusión. --read-data completo, una vez al año, sigue siendo la prueba de fuego.
Y el simulacro de restauración, que se puede y se debe automatizar:
rm -rf /srv/restore-test
restic restore latest --target /srv/restore-test --include /etc
diff -rq /etc /srv/restore-test/etc
restic mount /mnt/restic # requiere fuse3; se desmonta con fusermount -u /mnt/restic
restic mount es lo más cómodo para recuperar «aquel fichero de hace tres semanas» sin restaurar nada: monta las instantáneas como directorios de solo lectura.
Programarlo con systemd
Cron vale, pero systemd da registro por unidad, dependencia de red y ejecución diferida si el servidor estaba apagado. El patrón completo de servicio y timer está en Backup cifrado con restic, systemd y S3; aquí queda lo mínimo, con la ruta del binario oficial:
# /etc/systemd/system/restic-backup.service
[Unit]
Description=Backup restic de servidor01
Wants=network-online.target
After=network-online.target
OnFailure=restic-fallo@%n.service
[Service]
Type=oneshot
EnvironmentFile=/etc/restic/env
ExecStart=/usr/local/bin/restic backup /etc /home /root /srv /var/www \
--exclude-file=/etc/restic/exclude.txt --exclude-caches \
--tag diario --host servidor01
Nice=10
IOSchedulingClass=idle
# /etc/systemd/system/restic-backup.timer
[Unit]
Description=Backup diario restic
[Timer]
OnCalendar=*-*-* 03:30:00
Persistent=true
RandomizedDelaySec=15m
[Install]
WantedBy=timers.target
systemctl daemon-reload
systemctl enable --now restic-backup.timer
systemctl list-timers restic-backup.timer
journalctl -u restic-backup.service -n 30 --no-pager
Mismo patrón para una unidad mensual de forget y otra semanal de check --read-data-subset=n/10. Si el backup falla, que lo diga: OnFailure= o un chequeo externo de la última instantánea. Un timer que falla en silencio es peor que no tener timer, porque genera confianza.
Qué significa cada código de salida
Automatizar un backup es leer el resultado, no solo lanzarlo. restic backup devuelve:
| Código | Significado | Qué hacer |
|---|---|---|
| 0 | Backup correcto, snapshot creado | Nada |
| 1 | Error fatal, sin snapshot | Mirar el journal: el backup de ese día no existe |
| 3 | Snapshot incompleto: algún fichero no se pudo leer | Revisar permisos; el snapshot sirve, pero le faltan ficheros |
| 10 | El repositorio no existe | Ruta o credenciales mal; no es un fallo del backup |
| 11 | Repositorio bloqueado por otro proceso | restic unlock si el proceso murió; si no, esperar a que termine |
| 12 | Contraseña incorrecta | Revisar RESTIC_PASSWORD_FILE |
El 3 es el que engaña: hay snapshot, el comando «funciona» y falta justo el fichero que necesitas. En el chequeo externo, alerta con cualquier código distinto de 0.
Ajuste fino para un servidor modesto
Cuatro mandos bastan, y ninguno hace falta el primer día:
# Limitar CPU (por defecto restic usa todos los núcleos)
GOMAXPROCS=1 restic backup /etc --tag diario --host servidor01
# Limitar el ancho de banda de subida, en KiB/s (útil con SFTP por WAN)
restic backup --limit-upload 4096 /etc --tag diario --host servidor01
# Conexiones concurrentes al backend (5 por defecto, 2 en el backend local)
restic -o rest.connections=3 backup /etc --tag diario --host servidor01
# Compresión: auto por defecto; max cambia CPU por tamaño
restic backup --compression max /etc --tag diario --host servidor01
--limit-upload y --limit-download son opciones globales y van en KiB/s. GOMAXPROCS=1 reduce algo el consumo de memoria, y --read-concurrency sube el rendimiento en discos rápidos. En un servidor pequeño el orden de prioridades es: no comerse la CPU del servicio que estás respaldando, no saturar el enlace y no llenar el disco. El resto es ruido.
Los errores que se repiten
- La contraseña solo existe en el servidor respaldado. Servidor muerto, repositorio ilegible. Guárdala fuera (gestor de contraseñas y papel) y añade una segunda clave con
restic key add. - Nunca se ejecuta
check --read-data. La corrupción se descubre el día de la restauración. - Se verifica con un porcentaje y se cree que cubre todo. 10 % aleatorio no es 10 % garantizado: rota
n/t. - Repositorio en el mismo disco que los datos. No protege de un borrado, de un ransomware ni de un
rm -rfcon sudo. - Copiar los ficheros de la base de datos en caliente. Volcado lógico por
--stdin-from-command; si el volumen es enorme, instantánea del FS, que es otro artículo. forgetcon filtros de más o de menos. Sin--tagdecides la retención de datos que no querías tocar; con--group-by ''mezclas todo en un grupo y la política cae sobre el conjunto.- Nadie mira el resultado. Un timer que falla en silencio es peor que no tenerlo.
Checklist para producción
- Binario 0.19.x en
/usr/local/binyrestic versioncomprobado (o el 0.18.0 del paquete, pero sin mezclar). - Contraseña de 32 bytes en
/etc/restic/password(0600, root) y copia fuera del servidor. - Segunda clave con
restic key add, guardada aparte. - Repositorio remoto, nunca en el mismo disco; rest-server con
--append-onlyy TLS, u object lock en el bucket. - Excludes revisados (
/proc, cachés, overlays de Docker, el propio repositorio). - Volcados de BD por
--stdin-from-command, con--defaults-extra-file(MySQL) oPGPASSFILE(PostgreSQL) en 0600. forget --tag diarioyforget --tag dben ejecuciones separadas, con--prunesolo en la última; en append-only,--keep-within.check --read-data-subset=n/10semanal rotandon, y--read-datacompleto anual.- Restauración de prueba hecha al menos una vez, cronometrada y documentada.
Fuentes
- Diseño del repositorio (chunking, cifrado, formato v2): https://restic.readthedocs.io/en/stable/100_references.html
- Preparación del repositorio, CIFS/SMB y claves: https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html
backup, exclusiones y--stdin-from-command(código de salida): https://restic.readthedocs.io/en/stable/040_backup.htmlchecky--read-data-subset(subconjunto aleatorio frente an/t): https://restic.readthedocs.io/en/stable/045_working_with_repos.htmlforget,pruney consideraciones de append-only: https://restic.readthedocs.io/en/stable/060_forget.html- rest-server (
--append-only,.htpasswd, TLS): https://github.com/restic/rest-server - Notas de 0.19.0 (09-06-2026) y 0.19.1 (05-07-2026): https://github.com/restic/restic/releases
- Versión empaquetada en Debian: https://tracker.debian.org/pkg/restic
comentarios(0)
$ dejar comentario