Перейти к содержимому

Статья 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 bzip2
cd /tmp
wget https://github.com/restic/restic/releases/download/v0.19.1/restic_0.19.1_linux_amd64.bz2
bunzip2 restic_0.19.1_linux_amd64.bz2
install -m 755 restic_0.19.1_linux_amd64 /usr/local/bin/restic
restic version
restic 0.19.1 compiled with go1.26.4 on linux/amd64

Дальше обновление одной командой: restic self-update. Номер последней версии смотрите на странице релизов.

restic читает настройки из переменных. Сохраните их в файл, доступный только root:

Окно терминала
mkdir -p /etc/restic
openssl rand -base64 32 > /etc/restic/password
chmod 600 /etc/restic/password
nano /etc/restic/env
RESTIC_REPOSITORY=/backup/restic-repo
RESTIC_PASSWORD_FILE=/etc/restic/password
Окно терминала
chmod 600 /etc/restic/env
set -a; source /etc/restic/env; set +a

Сохраните пароль вне сервера, например в менеджере паролей. Без него восстановить данные невозможно, даже имея все файлы репозитория.

Локальная папка или подключённый диск:

RESTIC_REPOSITORY=/backup/restic-repo

SFTP на другой сервер. Нужен вход по SSH-ключу без пароля (SSH-ключи). Удобно описать сервер в /root/.ssh/config:

Host backupsrv
HostName IP_СЕРВЕРА_БЭКАПОВ
User backup
IdentityFile /root/.ssh/id_backup
RESTIC_REPOSITORY=sftp:backupsrv:/home/backup/restic-repo

На удалённом сервере ставить restic не нужно, достаточно SSH. Перед первым запуском один раз подключитесь ssh backupsrv, чтобы принять ключ хоста.

S3-совместимое хранилище (облачный объектный storage любого провайдера):

RESTIC_REPOSITORY=s3:https://s3.example.com/my-backups
AWS_ACCESS_KEY_ID=КЛЮЧ_ДОСТУПА
AWS_SECRET_ACCESS_KEY=СЕКРЕТНЫЙ_КЛЮЧ

Бакет restic создаст сам при init, если у ключа есть такие права. На лабораторном сервере все три варианта проверены: локальная папка, SFTP к другому пользователю и S3-эндпоинт.

Окно терминала
restic init
created restic repository e6ee1bb0a5 at /backup/restic-repo
Please note that knowledge of your password is required to access
the repository. Losing your password means that your data is
irrecoverably lost.
Окно терминала
restic backup /srv/data --exclude '*.cache'
no parent snapshot found, will read all files
Files: 5 new, 0 changed, 0 unmodified
Dirs: 7 new, 0 changed, 0 unmodified
Added to the repository: 6.680 MiB (6.679 MiB stored)
processed 5 files, 6.676 MiB in 0:00
snapshot 882b6b62 saved

Повторный запуск после изменения одного файла:

using parent snapshot 882b6b62
Files: 0 new, 1 changed, 4 unmodified
Dirs: 0 new, 6 changed, 1 unmodified
Added to the repository: 4.513 KiB (2.535 KiB stored)
processed 5 files, 6.676 MiB in 0:00
snapshot 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 snapshots
ID Time Host Tags Paths Size
-----------------------------------------------------------------------------
882b6b62 2026-11-18 16:33:18 vps /srv/data 6.676 MiB
24087945 2026-11-18 16:33:19 vps /srv/data 6.676 MiB
-----------------------------------------------------------------------------
Timestamps shown in local time
2 snapshots

Что изменилось между снапшотами: restic diff 882b6b62 24087945. Список файлов: restic ls latest.

forget удаляет лишние снапшоты по правилам, --prune освобождает место от блоков, которые больше не нужны. Сначала всегда смотрите результат с --dry-run:

Окно терминала
restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune --dry-run
Applying Policy: keep 7 daily, 4 weekly, 6 monthly snapshots
keep 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 snapshot
24087945 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/restore
restoring snapshot 24087945 of [/srv/data] at 2026-11-18 16:33:19 +0100 CET by root@vps to /root/restore
Summary: 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 check
restic check --read-data-subset=5%
check snapshots, trees and blobs
[0:00] 100.00% 2 / 2 snapshots
read 5.0% of packfiles
[0:00] 100.00% 1 / 1 packs
no errors were found

Первая команда проверяет структуру, вторая дополнительно скачивает и сверяет 5% данных. Раз в несколько месяцев делайте пробное восстановление: только оно доказывает, что бэкап рабочий.

Скрипт /usr/local/bin/restic-backup.sh:

#!/bin/bash
set -euo pipefail
set -a; source /etc/restic/env; set +a
restic backup /srv/data /etc --exclude-file=/etc/restic/excludes --tag daily
restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune
restic check --read-data-subset=5%
Окно терминала
chmod 700 /usr/local/bin/restic-backup.sh
touch /etc/restic/excludes

Сервис /etc/systemd/system/restic-backup.service:

[Unit]
Description=Restic backup
Wants=network-online.target
After=network-online.target
[Service]
Type=oneshot
Environment=RESTIC_CACHE_DIR=/var/cache/restic
ExecStart=/usr/local/bin/restic-backup.sh
Nice=10
IOSchedulingClass=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:00
RandomizedDelaySec=15m
Persistent=true
[Install]
WantedBy=timers.target
Окно терминала
systemctl daemon-reload
systemctl enable --now restic-backup.timer
systemctl start restic-backup.service # пробный запуск
journalctl -u restic-backup.service -n 30
systemctl list-timers restic-backup.timer

Persistent=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.