Резервни копия и възстановяване
Всяка инстанция на Artavolo може да създаде един шифрован архив, който съдържа всичко необходимо за нейното възстановяване: базата данни на приложението, базата с данни (по една таблица за всеки лист) и качените файлове. Enterprise изданието изпълнява това по график и може да копира архива в S3-съвместим контейнер.
Ключът за шифроване
Задайте BACKUP_ENCRYPTION_KEY преди първото резервно копие:
- Docker:
ARTAVOLO_BACKUP_ENCRYPTION_KEYв.env(openssl rand -hex 32), след товаdocker compose up -d. - LAMP:
define('BACKUP_ENCRYPTION_KEY', '...');вincludes/config.php.
Пазете копие на ключа извън сървъра (мениджър на пароли, разпечатано в сейф). Архив не може да се отвори без него и няма начин за възстановяване. Смяната на ключа засяга само новите архиви; пазете старите ключове, докато пазите старите архиви.
Архивите са artavolo-backup-YYYYMMDD-HHMMSS.abk: AES-256-CTR със случаен IV, удостоверени с HMAC-SHA256 върху целия файл. Етикетът за цялост се проверява, преди да се дешифрира каквото и да е, така че грешен ключ или повреден файл се отхвърлят веднага.
Стартиране на резервно копие
От командния ред (във всяко издание):
# Docker
docker compose exec -u www-data app php utilities/backup.php
# LAMP
php utilities/backup.php
Опции: --no-uploads (само базите данни), --path=/mnt/backups, --keep=30 (срок на съхранение в дни), --no-s3, --plain (некриптиран zip, само за ръчно пренасяне на данни). Архивът се записва в data/backups/ (Docker: томът app_backups), освен ако не е зададен друг път.
От администрацията (Enterprise): Настройки → Резервни копия → „Стартирай резервно копие сега“. Същата страница настройва дневния график (час, по времето на сървъра), локалната папка, срока на съхранение, дали се включват качените файлове и S3-съвместимата цел. Cron задачата, която се доставя с инстанцията, стартира изпълнението в рамките на пет минути от избрания час. Неуспешно изпълнение праща имейл на всички администратори; всяко изпълнение се вижда в дневника на промените като backup.run или backup.failed.
Копирайте архивите извън хоста. С Docker: docker compose cp app:/var/www/html/data/backups ./backups. При S3 цел копирането става автоматично след всяко изпълнение; срокът на съхранение важи и там.
Проверка на архив
php utilities/restore.php artavolo-backup-20260911-030001.abk --dry-run
Това проверява етикета, дешифрира във временна папка, показва манифеста (версия, инстанция, време на създаване) и размера на всяка част, и премахва временните файлове. Правете го всеки месец и веднъж на тестова машина, за да докажете, че пълното възстановяване по-долу работи.
Възстановяване
Възстановяването замества двете бази данни, посочени в includes/config.php, и копира качените файлове върху текущите. Първо спрете уеб сървъра (или намалете контейнера на приложението до нула).
# Docker: a fresh stack with the same .env (same ARTAVOLO_BACKUP_ENCRYPTION_KEY)
docker compose up -d db
docker compose run --rm -u www-data app php utilities/restore.php /var/www/html/data/backups/artavolo-backup-20260911-030001.abk --yes
docker compose up -d
# LAMP
php utilities/restore.php /path/to/artavolo-backup-20260911-030001.abk --yes
php utilities/clear-cache.php
--no-uploads възстановява само базите данни, --no-database само качените файлове, --extract=/tmp/out разархивира, без да пипа инстанцията, --key=... подава ключа, когато config.php още не съществува. Възстановяването записва backup.restored в дневника на промените.
Възстановяване в инстанция, която работи с по-нова версия на приложението, се поддържа: след това изпълнете php utilities/migrate.php, за да се актуализира схемата.
Какво не е в архива
includes/config.php (съдържа идентификационни данни за базата данни и тайни; пазете го заедно с ключа), езиковите пакети в lang/, ако сте ги редактирали, и лицензионният ключ (също в базата данни, така че се възстановява с нея).