Подключить сервер

Чтобы защищать сервер, на него ставится агент arcula. Агент сам ходит в панель: входящие порты на сервере открывать не нужно. Подключение — одна команда на сервере и код в браузере.

Подходят Ubuntu 22.04 и 24.04, Debian 12 на amd64 или arm64 с systemd. Docker не обязателен: без него агент найдёт только то, что на хосте.

Хранилище лучше подключить заранее — без него план защиты не сохранить. См. Подключить хранилище.

1. Поставить агент

ЛК → «Серверы» → «+ Сервер». ЛК покажет строку установки и кнопку «Скопировать». Выполните строку на сервере:

curl -fsSL https://panel.example.com/install.sh | sudo sh

Адрес в строке — вашей панели. Скрипт:

• скачивает с панели arcula и restic 0.18.1 под архитектуру сервера и сверяет их с SHA256SUMS;
• кладёт arcula в /usr/local/bin/arcula, restic — в /var/lib/arcula/bin/restic;
• ставит и запускает службу arcula-agent;
• запускает arcula login.

Хотите сначала прочитать скрипт:

curl -fsSL https://panel.example.com/install.sh -o install.sh
sudo sh install.sh

Агент уже стоит — достаточно sudo arcula login.

2. Подтвердить код

arcula login покажет код и ссылку и будет ждать:

Open https://panel.example.com/connect and enter the code  WDJB-MJHT
or go straight to: https://panel.example.com/connect?code=WDJB-MJHT
Waiting for approval… (the code is valid for 10 minutes)

1. Откройте ссылку. Или введите код на странице «+ Сервер», в шаге «Подтвердите код», и нажмите «Дальше».
2. На странице «Подтверждение кода» сверьте код с терминалом. Там же — имя хоста, система, IP и время запроса. Подтверждайте только то, что запускали сами.
3. Задайте «Имя сервера» — так он будет подписан в ЛК. По умолчанию — имя хоста.
4. Нажмите «Подключить». Чужой запрос — «Отклонить».

Код живёт 10 минут. Истёк — запустите sudo arcula login ещё раз.

Если эта машина уже была подключена, страница предупредит: подключение создаст новый сервер, а у прежнего останутся история и бэкапы.

Без терминала, например из cloud-init, скрипт не ждёт подтверждения: показывает код и выходит, подключение завершит служба. Код введите на странице «+ Сервер».

3. Первое обнаружение

Сразу после подключения агент обходит сервер: Docker и Compose-проекты, тома, базы, каталоги в /opt, /srv, /var/www, настройки хоста. Значения секретов он не читает. В терминале — итог и ссылка на план:

Server linked as "prod-db-01".
The arcula-agent service is started.
Found: 3 projects, 2 databases, 1 needs a decision.
Confirm the protection plan in the panel: https://panel.example.com/servers/<server_id>

ЛК после «Подключить» сам откроет «План защиты». Пока агент не прислал найденное, там «Ждём, что найдёт агент». Обычно это минута — страница обновится сама.

4. Подтвердить план

Пока план не подтверждён, бэкапов нет. В списке серверов у такого сервера — «План защиты не подтверждён — бэкапов нет».

Выберите, что защищать, как часто и в какие хранилища, и нажмите «Подтвердить план». Подробно — в статье Выбрать, что защищать.

Агент получит план при следующем сигнале — он выходит на связь раз в минуту, — создаст репозитории в хранилищах и сразу сделает первый бэкап.

Проверить сервер

На сервере:

sudo arcula doctor

Проверяет права на файлы агента, службу, связь с панелью, часы, restic, место для staging и доступ к хранилищам плана. До подтверждения плана тоже работает.

После первого бэкапа sudo arcula status покажет то же, что строка сервера в ЛК.