SLV Backup - Быстрый старт | SLV - The AI Agent Kit for Solana Devs

🗄️ SLV Backup

SLV Backup создает зашифрованные инкрементальные backups вашей ноды с использованием restic. Все данные шифруются на стороне клиента с помощью AES-256 до загрузки - сервер никогда не видит ваши данные в открытом виде.

Legacy mode: SLV также поддерживает незашифрованные backups tar+zstd (без --restic). Мы настоятельно рекомендуем использовать --restic для всех новых backups.

Prerequisites

SLV CLI установлен на целевой ноде
доступ sudo (требуется для full-disk backup)
выполнен вход (slv login) с активной подпиской на storage
установлен restic (apt install restic)

Create an Encrypted Backup

bash

sudo slv backup create --restic --yes

sudo slv backup create --restic --yes

text

🗄️  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.

🗄️  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.

What happens on first run

Генерируется случайный пароль шифрования и сохраняется в ~/.slv/restic-password (mode 0600)
На ERPC Cloud Storage инициализируется repository restic
Выполняется backup всего диска (за исключением системных pseudo-filesystems)

Subsequent runs

Загружаются только измененные файлы (incremental). Deduplication помогает снижать затраты на storage.

List Backups

bash

sudo slv backup list

sudo slv backup list

Показывает как snapshots restic, так и legacy tar backups в cloud storage.

Restore from Backup

Восстановить последний snapshot:

bash

sudo slv backup restore latest

sudo slv backup restore latest

Восстановить конкретный snapshot:

bash

sudo slv backup restore b6925e6d

sudo slv backup restore b6925e6d

Восстановить legacy tar backup:

bash

sudo slv backup restore backup-mynode-20260318.tar.zst

sudo slv backup restore backup-mynode-20260318.tar.zst

Verify Backup Integrity

bash

sudo restic -r rest:https://<apiKey>:[email protected]/v3/storage/restic/ \
  --password-file ~/.slv/restic-password check

sudo restic -r rest:https://<apiKey>:[email protected]/v3/storage/restic/ \
  --password-file ~/.slv/restic-password check

Set Up Automated Backups (Cron)

bash

sudo slv backup create --restic --cron daily

sudo slv backup create --restic --cron daily

Interval	Description
`daily`	Запускать один раз в день
`weekly`	Запускать один раз в неделю
`monthly`	Запускать один раз в месяц
`off`	Удалить cron job

Retention

По умолчанию snapshots старше 7 дней автоматически удаляются:

bash

sudo slv backup create --restic --retention 14

sudo slv backup create --restic --retention 14

Customize Excludes

Посмотреть текущий список исключений:

bash

slv backup create --list-excludes

slv backup create --list-excludes

Добавить дополнительные пути в исключения:

bash

sudo slv backup create --restic --exclude /home/solv/ledger --exclude /home/solv/snapshots

sudo slv backup create --restic --exclude /home/solv/ledger --exclude /home/solv/snapshots

Encryption & Security

Feature	Detail
Encryption	AES-256-CTR + Poly1305-AES (client-side)
Integrity	SHA-256 content-addressable storage
Deduplication	Content-defined chunking
Server-side visibility	None - server only sees encrypted blobs
Password file	`~/.slv/restic-password` (mode 0600)
Excluded from backup	`~/.slv/restic-password`, `~/.slv/api.yml`, `~/.slv/backup.env`

⚠️ IMPORTANT: Сделайте отдельную резервную копию файла ~/.slv/restic-password. Без него ваши backups будут безвозвратно потеряны.

Options Reference

Option	Description
`--restic`	Использовать restic для зашифрованного инкрементального backup (рекомендуется)
`-r, --region <region>`	Регион storage (по умолчанию: eu)
`--exclude <path>`	Дополнительные пути для исключения (можно повторять)
`--include <path>`	Убрать из стандартных исключений (можно повторять)
`--list-excludes`	Показать текущий список исключений и выйти
`--retention <days>`	Удалять snapshots старше N дней (по умолчанию: 7)
`--cron <interval>`	Настроить cron job (daily/weekly/monthly/off)
`-y, --yes`	Пропустить prompts подтверждения
`--upload`	Legacy: загрузить tar backup в cloud storage
`-o, --output <path>`	Legacy: путь выходного файла для tar backup

Legacy Mode (tar+zstd)

Для обратной совместимости по-прежнему поддерживаются незашифрованные tar backups:

bash

sudo slv backup create --upload --yes     # Unencrypted tar backup

sudo slv backup create --upload --yes     # Unencrypted tar backup

Note: Legacy backups не шифруются. Мы рекомендуем перейти на --restic для всех новых backups.