Статья 135 из 141
Гайды
Бэкапы restic на VPS: шифрованные инкрементные копии в папку, по SFTP и в S3
restic — программа для резервного копирования. Она шифрует данные на стороне сервера, режет файлы на блоки и хранит каждый блок один раз. Первый бэкап полный, следующие загружают только изменения, но каждый снимок (снапшот) можно восстановить целиком. Хранилище не видит содержимого: без пароля репозитория данные не прочитать.
Все команды и выводы ниже получены на Ubuntu 24.04 с restic 0.19.1 (ноябрь 2026). Имя хоста в выводах заменено на vps.
Что понадобится
Заголовок раздела «Что понадобится»| Ресурс | Значение |
|---|---|
| RAM | от 512 МБ, больше при миллионах файлов |
| Место под репозиторий | примерно объём данных плюс изменения за срок хранения |
| Куда сохранять | другой сервер по SFTP или S3-совместимое хранилище |
Бэкап на тот же диск защищает только от случайного удаления. От потери сервера защищает копия в другом месте. Общие правила: бэкапы.
Установка
Заголовок раздела «Установка»В Ubuntu 24.04 есть пакет restic, но версии 0.16.4, и команда self-update в нём отключена. Свежую версию берите с GitHub проекта:
apt install -y bzip2cd /tmpwget https://github.com/restic/restic/releases/download/v0.19.1/restic_0.19.1_linux_amd64.bz2bunzip2 restic_0.19.1_linux_amd64.bz2install -m 755 restic_0.19.1_linux_amd64 /usr/local/bin/resticrestic versionrestic 0.19.1 compiled with go1.26.4 on linux/amd64Дальше обновление одной командой: restic self-update. Номер последней версии смотрите на странице релизов.
Пароль и переменные окружения
Заголовок раздела «Пароль и переменные окружения»restic читает настройки из переменных. Сохраните их в файл, доступный только root:
mkdir -p /etc/resticopenssl rand -base64 32 > /etc/restic/passwordchmod 600 /etc/restic/passwordnano /etc/restic/envRESTIC_REPOSITORY=/backup/restic-repoRESTIC_PASSWORD_FILE=/etc/restic/passwordchmod 600 /etc/restic/envset -a; source /etc/restic/env; set +aСохраните пароль вне сервера, например в менеджере паролей. Без него восстановить данные невозможно, даже имея все файлы репозитория.
Где хранить репозиторий
Заголовок раздела «Где хранить репозиторий»Локальная папка или подключённый диск:
RESTIC_REPOSITORY=/backup/restic-repoSFTP на другой сервер. Нужен вход по SSH-ключу без пароля (SSH-ключи). Удобно описать сервер в /root/.ssh/config:
Host backupsrv HostName IP_СЕРВЕРА_БЭКАПОВ User backup IdentityFile /root/.ssh/id_backupRESTIC_REPOSITORY=sftp:backupsrv:/home/backup/restic-repoНа удалённом сервере ставить restic не нужно, достаточно SSH. Перед первым запуском один раз подключитесь ssh backupsrv, чтобы принять ключ хоста.
S3-совместимое хранилище (облачный объектный storage любого провайдера):
RESTIC_REPOSITORY=s3:https://s3.example.com/my-backupsAWS_ACCESS_KEY_ID=КЛЮЧ_ДОСТУПАAWS_SECRET_ACCESS_KEY=СЕКРЕТНЫЙ_КЛЮЧБакет restic создаст сам при init, если у ключа есть такие права. На лабораторном сервере все три варианта проверены: локальная папка, SFTP к другому пользователю и S3-эндпоинт.
Инициализация и первый бэкап
Заголовок раздела «Инициализация и первый бэкап»restic initcreated restic repository e6ee1bb0a5 at /backup/restic-repo
Please note that knowledge of your password is required to accessthe repository. Losing your password means that your data isirrecoverably lost.restic backup /srv/data --exclude '*.cache'no parent snapshot found, will read all files
Files: 5 new, 0 changed, 0 unmodifiedDirs: 7 new, 0 changed, 0 unmodifiedAdded to the repository: 6.680 MiB (6.679 MiB stored)
processed 5 files, 6.676 MiB in 0:00snapshot 882b6b62 savedПовторный запуск после изменения одного файла:
using parent snapshot 882b6b62
Files: 0 new, 1 changed, 4 unmodifiedDirs: 0 new, 6 changed, 1 unmodifiedAdded to the repository: 4.513 KiB (2.535 KiB stored)
processed 5 files, 6.676 MiB in 0:00snapshot 24087945 savedЗагружено 4,5 КиБ вместо 6,7 МиБ. Полезные опции backup:
| Опция | Что делает |
|---|---|
--exclude '*.log' |
исключить по шаблону |
--exclude-file=/etc/restic/excludes |
шаблоны из файла, по одному в строке |
--tag daily |
метка для фильтрации снапшотов |
--one-file-system |
не заходить в другие файловые системы |
Базы данных не копируйте как файлы на лету. Сначала сделайте дамп (pg_dump, mariadb-dump) в папку, а её отдайте restic.
Снапшоты
Заголовок раздела «Снапшоты»restic snapshotsID Time Host Tags Paths Size-----------------------------------------------------------------------------882b6b62 2026-11-18 16:33:18 vps /srv/data 6.676 MiB24087945 2026-11-18 16:33:19 vps /srv/data 6.676 MiB-----------------------------------------------------------------------------Timestamps shown in local time2 snapshotsЧто изменилось между снапшотами: restic diff 882b6b62 24087945. Список файлов: restic ls latest.
Политика хранения: forget и prune
Заголовок раздела «Политика хранения: forget и prune»forget удаляет лишние снапшоты по правилам, --prune освобождает место от блоков, которые больше не нужны. Сначала всегда смотрите результат с --dry-run:
restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune --dry-runApplying Policy: keep 7 daily, 4 weekly, 6 monthly snapshotskeep 2 snapshots:ID Time Host Tags Reasons Paths Size---------------------------------------------------------------------------------------882b6b62 2026-11-18 16:33:18 vps oldest daily snapshot /srv/data 6.676 MiB oldest weekly snapshot oldest monthly snapshot24087945 2026-11-18 16:33:19 vps daily snapshot /srv/data 6.676 MiB weekly snapshot monthly snapshot---------------------------------------------------------------------------------------Правила считаются отдельно для каждого хоста и набора путей. Политика выше хранит последние 7 дней, 4 недели и 6 месяцев.
Восстановление
Заголовок раздела «Восстановление»Весь снапшот в отдельную папку:
restic restore latest --target /root/restorerestoring snapshot 24087945 of [/srv/data] at 2026-11-18 16:33:19 +0100 CET by root@vps to /root/restoreSummary: Restored 12 files/dirs (6.676 MiB) in 0:00Файлы восстанавливаются с полным путём: /root/restore/srv/data/.... Один файл:
restic restore latest --target /root/restore --include /srv/data/site/index.htmlНе восстанавливайте сразу поверх рабочих данных. Сначала в отдельную папку, проверьте, потом переносите.
Проверка репозитория
Заголовок раздела «Проверка репозитория»restic checkrestic check --read-data-subset=5%check snapshots, trees and blobs[0:00] 100.00% 2 / 2 snapshotsread 5.0% of packfiles[0:00] 100.00% 1 / 1 packsno errors were foundПервая команда проверяет структуру, вторая дополнительно скачивает и сверяет 5% данных. Раз в несколько месяцев делайте пробное восстановление: только оно доказывает, что бэкап рабочий.
Запуск по расписанию: systemd
Заголовок раздела «Запуск по расписанию: systemd»Скрипт /usr/local/bin/restic-backup.sh:
#!/bin/bashset -euo pipefailset -a; source /etc/restic/env; set +a
restic backup /srv/data /etc --exclude-file=/etc/restic/excludes --tag dailyrestic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prunerestic check --read-data-subset=5%chmod 700 /usr/local/bin/restic-backup.shtouch /etc/restic/excludesСервис /etc/systemd/system/restic-backup.service:
[Unit]Description=Restic backupWants=network-online.targetAfter=network-online.target
[Service]Type=oneshotEnvironment=RESTIC_CACHE_DIR=/var/cache/resticExecStart=/usr/local/bin/restic-backup.shNice=10IOSchedulingClass=idleСтрока RESTIC_CACHE_DIR обязательна. Без неё под systemd restic падает с ошибкой unable to locate cache directory: neither $XDG_CACHE_HOME nor $HOME are defined: мы проверили это на практике.
Таймер /etc/systemd/system/restic-backup.timer:
[Unit]Description=Daily restic backup
[Timer]OnCalendar=*-*-* 03:30:00RandomizedDelaySec=15mPersistent=true
[Install]WantedBy=timers.targetsystemctl daemon-reloadsystemctl enable --now restic-backup.timersystemctl start restic-backup.service # пробный запускjournalctl -u restic-backup.service -n 30systemctl list-timers restic-backup.timerPersistent=true запустит пропущенный бэкап, если сервер был выключен в 03:30.
Через cron проще, но без журнала systemd. Файл /etc/cron.d/restic:
30 3 * * * root /usr/local/bin/restic-backup.sh >> /var/log/restic-backup.log 2>&1Частые проблемы
Заголовок раздела «Частые проблемы»| Симптом | Причина и решение |
|---|---|
Fatal: wrong password or no key found |
Неверный пароль или не загружены переменные из /etc/restic/env. |
unable to locate cache directory под systemd |
Добавьте Environment=RESTIC_CACHE_DIR=/var/cache/restic. |
repository is already locked |
Прошлый запуск прервался. Убедитесь, что restic не работает (pgrep restic), и выполните restic unlock. |
| SFTP зависает при первом подключении | Не принят ключ хоста. Подключитесь один раз вручную через ssh. |
unknown command "self-update" |
Версия из apt. Поставьте бинарник с GitHub. |
| Репозиторий растёт, хотя снапшоты удаляются | forget без --prune не освобождает место. Запустите restic prune. |