SLV Backup - Inicio rápido

🗄️ SLV Backup

SLV Backup crea copias de seguridad cifradas e incrementales de tu nodo con restic. Todos los datos se cifran en el lado del cliente con AES-256 antes de subirse: el servidor nunca ve tus datos en texto plano.
Modo heredado: SLV también admite copias de seguridad tar+zstd sin cifrar (sin --restic). Te recomendamos encarecidamente usar --restic para todas las copias de seguridad nuevas.

Requisitos previos

  • SLV CLI instalado en el nodo de destino
  • Acceso sudo (necesario para la copia de seguridad del disco completo)
  • Sesión iniciada (slv login) con una suscripción de almacenamiento activa
  • restic instalado (apt install restic)

Crear una copia de seguridad cifrada

bash
sudo slv backup create --restic --yes
🗄️  SLV Backup (restic mode)

  Region:    default
  Retention: 7 days

⚠️  Restic encryption password generated and saved to:
   /home/solv/.slv/restic-password
   BACK UP THIS FILE — without it, backups cannot be restored.

🔧 Initializing restic repository (if needed)...
📦 Creating restic backup...

Files:       151263 new,     0 changed,     0 unmodified
Dirs:        22486 new,     0 changed,     0 unmodified
Added to the repository: 4.107 GiB (1.837 GiB stored)

processed 151263 files, 4.366 GiB in 0:50
snapshot b6925e6d saved

✅ Restic backup complete
🧹 Applying retention policy (keep within 7 days)...
✅ Backup complete.

Qué ocurre en la primera ejecución

  1. Se genera una contraseña de cifrado aleatoria y se guarda en ~/.slv/restic-password (modo 0600)
  2. Se inicializa un repositorio de restic en ERPC Cloud Storage
  3. Se hace una copia de seguridad de todo el disco (excepto los pseudosistemas de archivos del sistema)

Ejecuciones posteriores

Solo se suben los archivos modificados (copia incremental). La deduplicación mantiene bajos los costes de almacenamiento.

Listar las copias de seguridad

bash
sudo slv backup list
Muestra tanto las instantáneas de restic como las copias de seguridad tar heredadas que hay en el almacenamiento en la nube.

Restaurar desde una copia de seguridad

Restaura la instantánea más reciente:
bash
sudo slv backup restore latest
Restaura una instantánea concreta:
bash
sudo slv backup restore b6925e6d
Restaura una copia de seguridad tar heredada:
bash
sudo slv backup restore backup-mynode-20260318.tar.zst

Verificar la integridad de la copia de seguridad

Para ejecutar restic check por tu cuenta, conéctate con una clave de acceso al almacenamiento. Este endpoint no acepta las API keys de RPC.
  1. Abre la página de Storage, ve a Claves de acceso al almacenamiento y haz clic en Emitir clave. Para check basta con Solo lectura.
  2. Copia la URL del repositorio restic que se muestra justo después de crear la clave. Solo se muestra una vez: si la pierdes, revoca la clave y emite una nueva.
  3. Ejecuta check con esa URL:
bash
sudo restic -r '<RESTIC_REPOSITORY_URL>' \
  --password-file ~/.slv/restic-password check

Configurar copias de seguridad automáticas (cron)

bash
sudo slv backup create --restic --cron daily
IntervaloDescripción
dailySe ejecuta una vez al día
weeklySe ejecuta una vez por semana
monthlySe ejecuta una vez al mes
offElimina el trabajo de cron

Retención

De forma predeterminada, las instantáneas con más de 7 días de antigüedad se eliminan automáticamente:
bash
sudo slv backup create --restic --retention 14

Personalizar las exclusiones

Consulta la lista de exclusiones actual:
bash
slv backup create --list-excludes
Añade rutas de exclusión adicionales:
bash
sudo slv backup create --restic --exclude /home/solv/ledger --exclude /home/solv/snapshots

Cifrado y seguridad

CaracterísticaDetalle
CifradoAES-256-CTR + Poly1305-AES (en el lado del cliente)
IntegridadAlmacenamiento direccionado por contenido con SHA-256
DeduplicaciónFragmentación definida por el contenido
Visibilidad en el servidorNinguna: el servidor solo ve blobs cifrados
Archivo de contraseña~/.slv/restic-password (modo 0600)
Excluido de la copia de seguridad~/.slv/restic-password, ~/.slv/api.yml, ~/.slv/backup.env
⚠️ IMPORTANTE: Guarda una copia de tu archivo ~/.slv/restic-password por separado. Sin él, tus copias de seguridad se pierden sin posibilidad de recuperación.

Referencia de opciones

OpciónDescripción
--resticUsa restic para una copia de seguridad incremental cifrada (recomendado)
-r, --region <region>Región de almacenamiento (predeterminada: eu)
--exclude <path>Rutas adicionales que excluir (se puede repetir)
--include <path>Quita una ruta de las exclusiones predeterminadas (se puede repetir)
--list-excludesMuestra la lista de exclusiones actual y sale
--retention <days>Elimina las instantáneas con más de N días de antigüedad (predeterminado: 7)
--cron <interval>Configura el trabajo de cron (daily/weekly/monthly/off)
-y, --yesOmite las confirmaciones
--uploadModo heredado: sube la copia de seguridad tar al almacenamiento en la nube
-o, --output <path>Modo heredado: ruta del archivo de salida de la copia de seguridad tar

Modo heredado (tar+zstd)

Por compatibilidad con versiones anteriores, se siguen admitiendo las copias de seguridad tar sin cifrar:
bash
sudo slv backup create --upload --yes     # Unencrypted tar backup
Nota: Las copias de seguridad heredadas no están cifradas. Te recomendamos migrar a --restic para todas las copias de seguridad nuevas.