2 Commits
Author SHA1 Message Date
mrleo1nidandClaude Opus 5.5 83832fc734 Веб-морда: поиск, фильтры, сортировка и пагинация клиентов; раскладка настроек
Release / release (push) Successful in 1m18s
CI / test (push) Successful in 1m19s
- список клиентов: поиск по домену и названию, фильтр по статусу (чипы
  со счётчиками), сортировка по любой колонке, пагинация 10/25/50/100;
  состояние в URL — отфильтрованный вид можно сохранить ссылкой
- размеры последних бэкапов одним запросом вместо запроса на клиента
- шапка выровнена по колонке контента; настройки на всю ширину:
  ntfy и Telegram двумя карточками, на узком экране — друг под другом

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 22:42:32 +03:00
mrleo1nidandClaude Opus 5.5 c6942605c1 Обновление бинарника через .new + mv: запущенный файл нельзя перезаписать
CI / test (push) Successful in 1m18s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 22:34:59 +03:00
10 changed files with 882 additions and 414 deletions

No files matched your search

+21 -2
View File
@@ -74,8 +74,27 @@ jobs:
PUBLIC="${PUBLIC_URL:-https://gitea.hsrv.site}"
DL="${PUBLIC%/}/${GITHUB_REPOSITORY}/releases/download/${TAG}"
NOTES="$(printf '## Обновление сервера\n\n```bash\nsudo curl -fsSL %s/backupctl-linux-amd64 -o /usr/local/bin/backupctl\nsudo chmod 755 /usr/local/bin/backupctl\nsudo install -d /opt/backup-master/dist\nfor a in amd64 arm64; do sudo curl -fsSL %s/backupctl-linux-$a -o /opt/backup-master/dist/backupctl-linux-$a; done\nsudo systemctl restart backup-master\n```\n\nАгенты обновляются той же командой `agent.sh` без `--token`: конфиг сохраняется.\n\n## Изменения\n\n%s\n' \
"${DL}" "${DL}" "${CHANGES}")"
# Работающий бинарник нельзя перезаписать (Text file busy) — качаем
# во временный файл и подменяем через mv.
NOTES="$(cat <<EOF
## Обновление сервера
\`\`\`bash
REL=${DL}
sudo install -d /opt/backup-master/dist
for a in amd64 arm64; do sudo curl -fsSL "\$REL/backupctl-linux-\$a" -o "/opt/backup-master/dist/backupctl-linux-\$a"; done
sudo install -m 755 "/opt/backup-master/dist/backupctl-linux-\$(dpkg --print-architecture)" /usr/local/bin/backupctl.new
sudo mv -f /usr/local/bin/backupctl.new /usr/local/bin/backupctl
sudo systemctl restart backup-master && backupctl version
\`\`\`
Агенты обновляются той же командой \`agent.sh\` без \`--token\`: конфиг сохраняется.
## Изменения
${CHANGES}
EOF
)"
PAYLOAD="$(jq -n --arg tag "$TAG" --arg body "$NOTES" \
'{tag_name: $tag, name: $tag, body: $body, draft: false, prerelease: false}')"
+235 -233
View File
@@ -1,233 +1,235 @@
# backup-master
Сервис бэкапов для VPS. Делает три вещи:
- принимает и хранит бэкапы, у него есть простая веб-морда для одного админа;
- агент на каждом сервере раз в сутки собирает бэкап по категориям, корректно дампит базы и записывает, какие версии софта стоят;
- восстанавливает бэкап **на новом сервере**: готовит систему (на основе [vps_installer](https://gitea.hsrv.site/mrleo1nid/vps_installer)), ставит **те же версии** утилит, раскладывает конфиги и данные, запускает сервисы.
Всё это делает один бинарник `backupctl`. Как он устроен внутри — в [docs/DESIGN.md](docs/DESIGN.md).
## Установка сервера
Ставим из [последнего релиза](https://gitea.hsrv.site/mrleo1nid/backup-master/releases/latest). Ссылка `releases/download/latest/...` всегда ведёт на свежую версию. Чтобы поставить конкретную версию, замените `latest` на тег, например `v0.1.0`.
```bash
REL=https://gitea.hsrv.site/mrleo1nid/backup-master/releases/download/latest
ARCH=$(dpkg --print-architecture) # amd64 или arm64
# пользователь и каталоги
sudo useradd -r -s /usr/sbin/nologin -d /var/lib/backup-master backup-master
sudo install -d -o backup-master -g backup-master -m 700 /var/lib/backup-master
sudo install -d /opt/backup-master/dist
# бинарники: свой — в /usr/local/bin, оба — в dist для раздачи агентам
for a in amd64 arm64; do sudo curl -fsSL "$REL/backupctl-linux-$a" -o "/opt/backup-master/dist/backupctl-linux-$a"; done
sudo curl -fsSL "$REL/checksums.txt" -o /tmp/backupctl-checksums.txt
(cd /opt/backup-master/dist && grep backupctl-linux /tmp/backupctl-checksums.txt | sha256sum -c -)
sudo install -m 755 "/opt/backup-master/dist/backupctl-linux-$ARCH" /usr/local/bin/backupctl
backupctl version
# администратор веб-морды
sudo -u backup-master BM_DATA=/var/lib/backup-master backupctl admin-passwd admin
# systemd: поправьте BM_PUBLIC_URL на внешний адрес сервера
sudo curl -fsSL "$REL/backup-master.service" -o /etc/systemd/system/backup-master.service
sudo sed -i 's|https://backup.example.com|https://backup.ВАШ-ДОМЕН|' /etc/systemd/system/backup-master.service
sudo systemctl daemon-reload
sudo systemctl enable --now backup-master
```
Сервер слушает `127.0.0.1:8080`, TLS даёт Caddy:
```bash
curl -fsSL "$REL/Caddyfile.example" # блок для /etc/caddy/Caddyfile, замените домен
sudo systemctl reload caddy
```
Агентам сервер раздаёт бинарники из `BM_DIST` (`/opt/backup-master/dist`).
### Caddy на другом хосте (например, сервер в VM Proxmox, Caddy на хосте)
Здесь Caddy проксирует не на `127.0.0.1`, а на IP виртуалки. В примере VM — `10.0.0.10`, хост Proxmox — `10.0.0.1`.
На VM сервис должен слушать сеть, а порт должен быть открыт только хосту с Caddy:
```bash
sudo sed -i 's|BM_LISTEN=127.0.0.1:8080|BM_LISTEN=0.0.0.0:8080|' /etc/systemd/system/backup-master.service
sudo systemctl daemon-reload && sudo systemctl restart backup-master
sudo ufw allow from 10.0.0.1 to any port 8080 proto tcp # если на VM включён UFW
```
На хосте с Caddy сначала проверьте доступ — должно вернуться `ok`:
```bash
curl -s http://10.0.0.10:8080/healthz
```
Затем укажите в Caddyfile адрес VM:
```
backup.example.com {
request_body {
max_size 200GB
}
reverse_proxy 10.0.0.10:8080 {
transport http {
read_timeout 6h
write_timeout 6h
}
}
}
```
```bash
sudo systemctl reload caddy
```
`BM_TRUST_PROXY=1` (включён в юните) говорит серверу брать IP клиента из `X-Forwarded-For` от Caddy — по нему ограничивается перебор пароля. Поэтому порт 8080 должен быть доступен **только** с хоста Caddy, иначе заголовок можно подделать. Если включён файрвол Proxmox для VM, разрешите 8080 и там.
Если Caddy с хоста получает 502, а на VM `curl http://127.0.0.1:8080/healthz` отвечает `ok`, проблема в `BM_LISTEN` или в файрволе.
### Администратор
Логин и пароль задаёт одна команда. Её же используют, чтобы сменить логин, пароль или оба сразу. Перезапуск сервиса не нужен, все открытые сессии сбрасываются:
```bash
sudo -u backup-master BM_DATA=/var/lib/backup-master backupctl admin-passwd новый_логин
```
**Обновление сервера:** снова выполните блок «бинарники», затем `sudo systemctl restart backup-master`. Агенты обновляются командой `curl -fsSL https://backup.ВАШ-ДОМЕН/agent.sh | sudo bash` без `--token`, конфиг при этом сохраняется.
### Уведомления
В «Настройках» включаются каналы: **ntfy** и/или **Telegram**. Оба необязательные, уведомления уходят во все настроенные.
Уведомления приходят:
- об ошибках бэкапа;
- когда от клиента нет бэкапа дольше заданного срока (по умолчанию 26 ч);
- если включено — и об успешных бэкапах. В Telegram они приходят без звука.
Каждое уведомление содержит ссылку на карточку клиента.
Как подключить Telegram:
1. Создайте бота у [@BotFather](https://t.me/BotFather) и скопируйте токен.
2. Напишите боту что-нибудь (или добавьте его в группу). Затем откройте `https://api.telegram.org/bot<токен>/getUpdates` и возьмите `chat.id`. У групп он вида `-100…`.
3. В «Настройках» укажите токен и chat id. Чатов можно несколько, через запятую. Для группы с темами дополнительно укажите ID темы.
4. Отметьте «Отправить тестовое уведомление» и сохраните — на странице будет видно, дошло ли сообщение в каждый канал.
Если `api.telegram.org` недоступен с сервера бэкапов, укажите в поле «Адрес Bot API» свой [Bot API сервер](https://github.com/tdlib/telegram-bot-api) или прокси.
## Добавление клиента
1. В веб-морде нажмите «Добавить клиента» и укажите домен сервера.
2. Выполните на сервере выданную команду:
```bash
curl -fsSL https://backup.example.com/agent.sh | sudo bash -s -- --token bm_... --now
```
Команда ставит `backupctl`, конфиг `/etc/backup-agent/agent.yaml` и таймер `backup-agent.timer` (03:00 ± 30 мин), показывает план (`backupctl plan`) и запускает первый бэкап.
3. В карточке клиента видно, что попадает в бэкап, версии софта и предупреждения. Например, cron запускает скрипт, который не попадает ни в одну категорию.
Полезные команды на клиенте:
```bash
sudo backupctl plan # что будет в бэкапе (дампы реально выполняются во временный каталог)
sudo systemctl start backup-agent # бэкап сейчас
journalctl -u backup-agent -f
sudo backupctl backup --heavy # с heavy-частями вне расписания
```
## Восстановление
В карточке клиента нажмите «Команда восстановления». Токен живёт 24 часа и даёт доступ только на чтение бэкапов этого клиента. Если нужен конкретный бэкап, откройте его и нажмите «Восстановить из этого бэкапа». На чистой Ubuntu 24.04:
```bash
curl -fsSL https://backup.example.com/restore.sh | sudo bash -s -- --token bm_...
```
Что происходит:
1. Показывается сводка бэкапа и запрашивается подтверждение.
2. Базовая подготовка системы (`internal/restore/provision.sh`): пользователь с sudo, hostname, fail2ban, UFW, blocklist, SSH hardening. Docker, Caddy и Telegraf ставятся **тех же версий apt-пакетов**, если такие версии ещё есть в репозитории. Спрашиваются только логин и пароль пользователя.
3. Распаковка: файлы ложатся на свои места, docker-тома — прямо в тома.
4. Категории восстанавливаются по порядку:
- 3x-ui, Nebula и sing-box ставятся той версии, что была на старом сервере. Если скачать не получилось, используется копия бинарника из бэкапа;
- база x-ui кладётся на место;
- compose-проекты: образы закрепляются по digest (`compose.restore.yml`), базы поднимаются, в них заливаются дампы, затем запускается весь проект;
- systemd-сервисы включаются и запускаются так, как было на старом сервере.
5. В конце выводятся итог и список того, что осталось сделать: DNS, lighthouse, перезагрузка.
Флаги:
- `--backup ID` — конкретный бэкап;
- `--skip-heavy` — без MinIO Stoat;
- `--skip-provision` — повторный прогон без базовой подготовки;
- `--user NAME`, `--yes`, `--keep-staging`.
## Что бэкапится
Встроенный каталог — [internal/catalog/default.yaml](internal/catalog/default.yaml):
| Категория | Что входит |
|---|---|
| system | правила UFW, все crontab (`/var/spool/cron/crontabs`), `ban-blacklist`, `/etc/sysctl.d` |
| xui | `/etc/x-ui` (снимок базы через `VACUUM INTO`, без логина в панель), `/root/cert`, версия 3x-ui |
| nebula | `/etc/nebula`, юнит, версия |
| caddy | `/etc/caddy`, `/var/www`, сертификаты |
| telegraf | `/etc/telegraf`, sudoers |
| sing-box-warp | `/opt/sing-box-warp`, `/etc/sing-box-warp`, юнит, sysctl, версия sing-box-extended |
| scripts | `/var/scripts`, `update-geosite.sh` |
| pnvpanel | `/opt/PnvPanel` целиком, кроме `pgdata`; `pg_dump`; том `ticket_uploads` |
| stoat | `/opt/stoat`, кроме `data/db` и `data/rabbit`; `mongodump`; `data/minio` идёт отдельной heavy-частью раз в неделю |
| stoat-mbot | `/opt/stoat-mbot` целиком, восстанавливается после stoat |
| psiphon | отключён |
Compose-проекты, которых нет в каталоге, находятся автоматически (`docker compose ls`). Они бэкапятся с настройками по умолчанию и помечаются в морде как «авто». Базы распознаются по образу (postgres, mongo, mysql, mariadb) и дампятся без остановки.
Каталог для конкретного клиента можно переопределить в его карточке (YAML):
```yaml
categories:
- {name: scripts, disabled: true} # отключить встроенную
- name: hostdb # своя категория с дампом
type: files
paths: [/etc/mysql]
dumps:
- name: full_dump.sql
cmd: mysqldump --all-databases --single-transaction
restore_cmd: mysql < "$DUMP_FILE"
```
## Сборка из исходников
```bash
make build # dist/backupctl-linux-amd64, dist/backupctl-linux-arm64
make test
```
Без make:
```bash
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags "-s -w" -o dist/backupctl-linux-amd64 ./cmd/backupctl
```
CI (Gitea Actions):
- `.gitea/workflows/ci.yml` на каждый push и PR проверяет форматирование, запускает vet и тесты и собирает бинарники;
- `release.yml` на тег `v*` публикует релиз с бинарниками, `checksums.txt` и файлами из `deploy/`.
Новый релиз:
```bash
git tag v0.2.0 && git push origin v0.2.0
```
## Хранение
Бэкапы лежат в `/var/lib/backup-master/backups/<домен>/<дата>-<id>/`: `main.tar.zst`, heavy-части и `manifest.json`. Архив — обычный tar+zstd, его можно разобрать и без backupctl:
```bash
zstd -dc main.tar.zst | tar -tv
```
Ротация:
- обычные бэкапы — по схеме GFS: последний всегда + N дневных, недельных и месячных (по умолчанию 7/4/6);
- heavy-части — только последние `heavy_keep` (по умолчанию 1).
# backup-master
Сервис бэкапов для VPS. Делает три вещи:
- принимает и хранит бэкапы, у него есть простая веб-морда для одного админа;
- агент на каждом сервере раз в сутки собирает бэкап по категориям, корректно дампит базы и записывает, какие версии софта стоят;
- восстанавливает бэкап **на новом сервере**: готовит систему (на основе [vps_installer](https://gitea.hsrv.site/mrleo1nid/vps_installer)), ставит **те же версии** утилит, раскладывает конфиги и данные, запускает сервисы.
Всё это делает один бинарник `backupctl`. Как он устроен внутри — в [docs/DESIGN.md](docs/DESIGN.md).
## Установка сервера
Ставим из [последнего релиза](https://gitea.hsrv.site/mrleo1nid/backup-master/releases/latest). Ссылка `releases/download/latest/...` всегда ведёт на свежую версию. Чтобы поставить конкретную версию, замените `latest` на тег, например `v0.1.0`.
```bash
REL=https://gitea.hsrv.site/mrleo1nid/backup-master/releases/download/latest
ARCH=$(dpkg --print-architecture) # amd64 или arm64
# пользователь и каталоги
sudo useradd -r -s /usr/sbin/nologin -d /var/lib/backup-master backup-master
sudo install -d -o backup-master -g backup-master -m 700 /var/lib/backup-master
sudo install -d /opt/backup-master/dist
# бинарники: свой — в /usr/local/bin, оба — в dist для раздачи агентам
for a in amd64 arm64; do sudo curl -fsSL "$REL/backupctl-linux-$a" -o "/opt/backup-master/dist/backupctl-linux-$a"; done
sudo curl -fsSL "$REL/checksums.txt" -o /tmp/backupctl-checksums.txt
(cd /opt/backup-master/dist && grep backupctl-linux /tmp/backupctl-checksums.txt | sha256sum -c -)
# через .new + mv: запущенный бинарник напрямую не перезаписать (Text file busy)
sudo install -m 755 "/opt/backup-master/dist/backupctl-linux-$ARCH" /usr/local/bin/backupctl.new
sudo mv -f /usr/local/bin/backupctl.new /usr/local/bin/backupctl
backupctl version
# администратор веб-морды
sudo -u backup-master BM_DATA=/var/lib/backup-master backupctl admin-passwd admin
# systemd: поправьте BM_PUBLIC_URL на внешний адрес сервера
sudo curl -fsSL "$REL/backup-master.service" -o /etc/systemd/system/backup-master.service
sudo sed -i 's|https://backup.example.com|https://backup.ВАШ-ДОМЕН|' /etc/systemd/system/backup-master.service
sudo systemctl daemon-reload
sudo systemctl enable --now backup-master
```
Сервер слушает `127.0.0.1:8080`, TLS даёт Caddy:
```bash
curl -fsSL "$REL/Caddyfile.example" # блок для /etc/caddy/Caddyfile, замените домен
sudo systemctl reload caddy
```
Агентам сервер раздаёт бинарники из `BM_DIST` (`/opt/backup-master/dist`).
### Caddy на другом хосте (например, сервер в VM Proxmox, Caddy на хосте)
Здесь Caddy проксирует не на `127.0.0.1`, а на IP виртуалки. В примере VM — `10.0.0.10`, хост Proxmox — `10.0.0.1`.
На VM сервис должен слушать сеть, а порт должен быть открыт только хосту с Caddy:
```bash
sudo sed -i 's|BM_LISTEN=127.0.0.1:8080|BM_LISTEN=0.0.0.0:8080|' /etc/systemd/system/backup-master.service
sudo systemctl daemon-reload && sudo systemctl restart backup-master
sudo ufw allow from 10.0.0.1 to any port 8080 proto tcp # если на VM включён UFW
```
На хосте с Caddy сначала проверьте доступ — должно вернуться `ok`:
```bash
curl -s http://10.0.0.10:8080/healthz
```
Затем укажите в Caddyfile адрес VM:
```
backup.example.com {
request_body {
max_size 200GB
}
reverse_proxy 10.0.0.10:8080 {
transport http {
read_timeout 6h
write_timeout 6h
}
}
}
```
```bash
sudo systemctl reload caddy
```
`BM_TRUST_PROXY=1` (включён в юните) говорит серверу брать IP клиента из `X-Forwarded-For` от Caddy — по нему ограничивается перебор пароля. Поэтому порт 8080 должен быть доступен **только** с хоста Caddy, иначе заголовок можно подделать. Если включён файрвол Proxmox для VM, разрешите 8080 и там.
Если Caddy с хоста получает 502, а на VM `curl http://127.0.0.1:8080/healthz` отвечает `ok`, проблема в `BM_LISTEN` или в файрволе.
### Администратор
Логин и пароль задаёт одна команда. Её же используют, чтобы сменить логин, пароль или оба сразу. Перезапуск сервиса не нужен, все открытые сессии сбрасываются:
```bash
sudo -u backup-master BM_DATA=/var/lib/backup-master backupctl admin-passwd новый_логин
```
**Обновление сервера:** снова выполните блок «бинарники», затем `sudo systemctl restart backup-master`. Агенты обновляются командой `curl -fsSL https://backup.ВАШ-ДОМЕН/agent.sh | sudo bash` без `--token`, конфиг при этом сохраняется.
### Уведомления
В «Настройках» включаются каналы: **ntfy** и/или **Telegram**. Оба необязательные, уведомления уходят во все настроенные.
Уведомления приходят:
- об ошибках бэкапа;
- когда от клиента нет бэкапа дольше заданного срока (по умолчанию 26 ч);
- если включено — и об успешных бэкапах. В Telegram они приходят без звука.
Каждое уведомление содержит ссылку на карточку клиента.
Как подключить Telegram:
1. Создайте бота у [@BotFather](https://t.me/BotFather) и скопируйте токен.
2. Напишите боту что-нибудь (или добавьте его в группу). Затем откройте `https://api.telegram.org/bot<токен>/getUpdates` и возьмите `chat.id`. У групп он вида `-100…`.
3. В «Настройках» укажите токен и chat id. Чатов можно несколько, через запятую. Для группы с темами дополнительно укажите ID темы.
4. Отметьте «Отправить тестовое уведомление» и сохраните — на странице будет видно, дошло ли сообщение в каждый канал.
Если `api.telegram.org` недоступен с сервера бэкапов, укажите в поле «Адрес Bot API» свой [Bot API сервер](https://github.com/tdlib/telegram-bot-api) или прокси.
## Добавление клиента
1. В веб-морде нажмите «Добавить клиента» и укажите домен сервера.
2. Выполните на сервере выданную команду:
```bash
curl -fsSL https://backup.example.com/agent.sh | sudo bash -s -- --token bm_... --now
```
Команда ставит `backupctl`, конфиг `/etc/backup-agent/agent.yaml` и таймер `backup-agent.timer` (03:00 ± 30 мин), показывает план (`backupctl plan`) и запускает первый бэкап.
3. В карточке клиента видно, что попадает в бэкап, версии софта и предупреждения. Например, cron запускает скрипт, который не попадает ни в одну категорию.
Полезные команды на клиенте:
```bash
sudo backupctl plan # что будет в бэкапе (дампы реально выполняются во временный каталог)
sudo systemctl start backup-agent # бэкап сейчас
journalctl -u backup-agent -f
sudo backupctl backup --heavy # с heavy-частями вне расписания
```
## Восстановление
В карточке клиента нажмите «Команда восстановления». Токен живёт 24 часа и даёт доступ только на чтение бэкапов этого клиента. Если нужен конкретный бэкап, откройте его и нажмите «Восстановить из этого бэкапа». На чистой Ubuntu 24.04:
```bash
curl -fsSL https://backup.example.com/restore.sh | sudo bash -s -- --token bm_...
```
Что происходит:
1. Показывается сводка бэкапа и запрашивается подтверждение.
2. Базовая подготовка системы (`internal/restore/provision.sh`): пользователь с sudo, hostname, fail2ban, UFW, blocklist, SSH hardening. Docker, Caddy и Telegraf ставятся **тех же версий apt-пакетов**, если такие версии ещё есть в репозитории. Спрашиваются только логин и пароль пользователя.
3. Распаковка: файлы ложатся на свои места, docker-тома — прямо в тома.
4. Категории восстанавливаются по порядку:
- 3x-ui, Nebula и sing-box ставятся той версии, что была на старом сервере. Если скачать не получилось, используется копия бинарника из бэкапа;
- база x-ui кладётся на место;
- compose-проекты: образы закрепляются по digest (`compose.restore.yml`), базы поднимаются, в них заливаются дампы, затем запускается весь проект;
- systemd-сервисы включаются и запускаются так, как было на старом сервере.
5. В конце выводятся итог и список того, что осталось сделать: DNS, lighthouse, перезагрузка.
Флаги:
- `--backup ID` — конкретный бэкап;
- `--skip-heavy` — без MinIO Stoat;
- `--skip-provision` — повторный прогон без базовой подготовки;
- `--user NAME`, `--yes`, `--keep-staging`.
## Что бэкапится
Встроенный каталог — [internal/catalog/default.yaml](internal/catalog/default.yaml):
| Категория | Что входит |
|---|---|
| system | правила UFW, все crontab (`/var/spool/cron/crontabs`), `ban-blacklist`, `/etc/sysctl.d` |
| xui | `/etc/x-ui` (снимок базы через `VACUUM INTO`, без логина в панель), `/root/cert`, версия 3x-ui |
| nebula | `/etc/nebula`, юнит, версия |
| caddy | `/etc/caddy`, `/var/www`, сертификаты |
| telegraf | `/etc/telegraf`, sudoers |
| sing-box-warp | `/opt/sing-box-warp`, `/etc/sing-box-warp`, юнит, sysctl, версия sing-box-extended |
| scripts | `/var/scripts`, `update-geosite.sh` |
| pnvpanel | `/opt/PnvPanel` целиком, кроме `pgdata`; `pg_dump`; том `ticket_uploads` |
| stoat | `/opt/stoat`, кроме `data/db` и `data/rabbit`; `mongodump`; `data/minio` идёт отдельной heavy-частью раз в неделю |
| stoat-mbot | `/opt/stoat-mbot` целиком, восстанавливается после stoat |
| psiphon | отключён |
Compose-проекты, которых нет в каталоге, находятся автоматически (`docker compose ls`). Они бэкапятся с настройками по умолчанию и помечаются в морде как «авто». Базы распознаются по образу (postgres, mongo, mysql, mariadb) и дампятся без остановки.
Каталог для конкретного клиента можно переопределить в его карточке (YAML):
```yaml
categories:
- {name: scripts, disabled: true} # отключить встроенную
- name: hostdb # своя категория с дампом
type: files
paths: [/etc/mysql]
dumps:
- name: full_dump.sql
cmd: mysqldump --all-databases --single-transaction
restore_cmd: mysql < "$DUMP_FILE"
```
## Сборка из исходников
```bash
make build # dist/backupctl-linux-amd64, dist/backupctl-linux-arm64
make test
```
Без make:
```bash
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags "-s -w" -o dist/backupctl-linux-amd64 ./cmd/backupctl
```
CI (Gitea Actions):
- `.gitea/workflows/ci.yml` на каждый push и PR проверяет форматирование, запускает vet и тесты и собирает бинарники;
- `release.yml` на тег `v*` публикует релиз с бинарниками, `checksums.txt` и файлами из `deploy/`.
Новый релиз:
```bash
git tag v0.2.0 && git push origin v0.2.0
```
## Хранение
Бэкапы лежат в `/var/lib/backup-master/backups/<домен>/<дата>-<id>/`: `main.tar.zst`, heavy-части и `manifest.json`. Архив — обычный tar+zstd, его можно разобрать и без backupctl:
```bash
zstd -dc main.tar.zst | tar -tv
```
Ротация:
- обычные бэкапы — по схеме GFS: последний всегда + N дневных, недельных и месячных (по умолчанию 7/4/6);
- heavy-части — только последние `heavy_keep` (по умолчанию 1).
+280
View File
@@ -0,0 +1,280 @@
package server
import (
"cmp"
"net/http"
"net/url"
"slices"
"strconv"
"strings"
)
// Параметры списка клиентов живут в URL: ссылку на отфильтрованный вид можно сохранить.
type clientsQuery struct {
Q string
Status string // "" — все
Sort string
Desc bool
Page int
Per int
}
var (
sortColumns = []string{"domain", "name", "status", "last_backup", "size", "last_seen"}
perOptions = []int{10, 25, 50, 100}
statusOrder = []struct{ Key, Title string }{
{"fail", "ошибка"}, {"stale", "просрочен"}, {"never", "нет бэкапов"}, {"ok", "ok"}, {"off", "отключён"},
}
)
// defaultDesc — направление по умолчанию при выборе колонки: даты и размеры — сначала большие.
func defaultDesc(col string) bool {
switch col {
case "last_backup", "size", "last_seen":
return true
}
return false
}
func parseClientsQuery(r *http.Request) clientsQuery {
v := r.URL.Query()
q := clientsQuery{
Q: strings.TrimSpace(v.Get("q")),
Status: v.Get("status"),
Sort: v.Get("sort"),
Page: 1,
Per: 25,
}
if !slices.ContainsFunc(statusOrder, func(s struct{ Key, Title string }) bool { return s.Key == q.Status }) {
q.Status = ""
}
if !slices.Contains(sortColumns, q.Sort) {
q.Sort = "domain"
}
switch v.Get("dir") {
case "asc":
q.Desc = false
case "desc":
q.Desc = true
default:
q.Desc = defaultDesc(q.Sort)
}
if p, err := strconv.Atoi(v.Get("page")); err == nil && p > 0 {
q.Page = p
}
if p, err := strconv.Atoi(v.Get("per")); err == nil && slices.Contains(perOptions, p) {
q.Per = p
}
return q
}
func (q clientsQuery) values() url.Values {
v := url.Values{}
if q.Q != "" {
v.Set("q", q.Q)
}
if q.Status != "" {
v.Set("status", q.Status)
}
if q.Sort != "domain" || q.Desc {
v.Set("sort", q.Sort)
if q.Desc != defaultDesc(q.Sort) {
if q.Desc {
v.Set("dir", "desc")
} else {
v.Set("dir", "asc")
}
}
}
if q.Page > 1 {
v.Set("page", strconv.Itoa(q.Page))
}
if q.Per != 25 {
v.Set("per", strconv.Itoa(q.Per))
}
return v
}
func (q clientsQuery) url() string {
if enc := q.values().Encode(); enc != "" {
return "/?" + enc
}
return "/"
}
// StatusURL — ссылка на фильтр по статусу (с первой страницы).
func (q clientsQuery) StatusURL(status string) string {
q.Status, q.Page = status, 1
return q.url()
}
// SortURL — ссылка для заголовка колонки: повторный клик меняет направление.
func (q clientsQuery) SortURL(col string) string {
if q.Sort == col {
q.Desc = !q.Desc
} else {
q.Sort, q.Desc = col, defaultDesc(col)
}
q.Page = 1
return q.url()
}
func (q clientsQuery) SortMark(col string) string {
if q.Sort != col {
return ""
}
if q.Desc {
return "↓"
}
return "↑"
}
// DirParam — значение dir для формы поиска, если направление отличается от умолчания колонки.
func (q clientsQuery) DirParam() string {
return q.values().Get("dir")
}
func (q clientsQuery) PageURL(p int) string {
q.Page = p
return q.url()
}
type statusChip struct {
Key, Title string
Count int
URL string
Active bool
}
type pageLink struct {
N int
URL string
Current bool
Gap bool
}
type clientsView struct {
Query clientsQuery
Rows []clientRow
Chips []statusChip
Total int // всего клиентов
Found int // после поиска и фильтра
From, To int
Pages []pageLink
Prev string
Next string
PerOpts []int
}
func (s *Server) webClients(w http.ResponseWriter, r *http.Request) {
q := parseClientsQuery(r)
clients, err := s.st.ListClients()
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
sizes, err := s.st.LastSizes()
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
v := buildClientsView(q, clients, sizes)
s.render(w, r, "clients", map[string]any{"V": v})
}
func buildClientsView(q clientsQuery, clients []*Client, sizes map[int64]int64) *clientsView {
v := &clientsView{Query: q, Total: len(clients), PerOpts: perOptions}
// поиск
needle := strings.ToLower(q.Q)
var matched []clientRow
for _, c := range clients {
if needle != "" && !strings.Contains(strings.ToLower(c.Domain), needle) && !strings.Contains(strings.ToLower(c.Name), needle) {
continue
}
row := clientRow{Client: c, LastSize: sizes[c.ID]}
row.StatusClass, row.StatusText = clientStatus(c)
matched = append(matched, row)
}
// чипы статусов считаются по результату поиска, до фильтра по статусу
counts := map[string]int{}
for _, r := range matched {
counts[r.StatusClass]++
}
v.Chips = append(v.Chips, statusChip{Title: "все", Count: len(matched), URL: q.StatusURL(""), Active: q.Status == ""})
for _, st := range statusOrder {
if counts[st.Key] == 0 && q.Status != st.Key {
continue
}
v.Chips = append(v.Chips, statusChip{Key: st.Key, Title: st.Title, Count: counts[st.Key], URL: q.StatusURL(st.Key), Active: q.Status == st.Key})
}
rows := matched[:0:0]
for _, r := range matched {
if q.Status == "" || r.StatusClass == q.Status {
rows = append(rows, r)
}
}
rank := map[string]int{}
for i, st := range statusOrder {
rank[st.Key] = i
}
slices.SortStableFunc(rows, func(a, b clientRow) int {
var c int
switch q.Sort {
case "name":
c = cmp.Compare(strings.ToLower(a.Name), strings.ToLower(b.Name))
case "status":
c = cmp.Compare(rank[a.StatusClass], rank[b.StatusClass])
case "last_backup":
c = cmp.Compare(a.LastBackupAt, b.LastBackupAt)
case "size":
c = cmp.Compare(a.LastSize, b.LastSize)
case "last_seen":
c = cmp.Compare(a.LastSeenAt, b.LastSeenAt)
}
if q.Desc {
c = -c
}
if c == 0 { // стабильный вторичный порядок — по домену
c = cmp.Compare(a.Domain, b.Domain)
}
return c
})
// пагинация
v.Found = len(rows)
pages := max(1, (v.Found+q.Per-1)/q.Per)
if q.Page > pages {
q.Page = pages
v.Query = q
}
start := (q.Page - 1) * q.Per
end := min(start+q.Per, v.Found)
v.Rows = rows[start:end]
if v.Found > 0 {
v.From, v.To = start+1, end
}
if pages > 1 {
if q.Page > 1 {
v.Prev = q.PageURL(q.Page - 1)
}
if q.Page < pages {
v.Next = q.PageURL(q.Page + 1)
}
last := 0
for p := 1; p <= pages; p++ {
if p != 1 && p != pages && (p < q.Page-2 || p > q.Page+2) {
continue
}
if last != 0 && p > last+1 {
v.Pages = append(v.Pages, pageLink{Gap: true})
}
v.Pages = append(v.Pages, pageLink{N: p, URL: q.PageURL(p), Current: p == q.Page})
last = p
}
}
return v
}
+87
View File
@@ -0,0 +1,87 @@
package server
import (
"fmt"
"net/http/httptest"
"strings"
"testing"
"time"
)
func testClients() ([]*Client, map[int64]int64) {
now := time.Now().Unix()
var cs []*Client
sizes := map[int64]int64{}
for i := 1; i <= 30; i++ {
c := &Client{ID: int64(i), Domain: fmt.Sprintf("srv%02d.example.com", i), Name: fmt.Sprintf("srv%02d", i),
StaleHours: 26, LastBackupAt: now - int64(i)*60, CreatedAt: now}
sizes[c.ID] = int64(i) * 1000
cs = append(cs, c)
}
cs[0].Name = "Нидерланды" // srv01
cs[1].LastBackupAt = 0 // srv02 — never
cs[2].LastErrorAt = now // srv03 — fail
cs[3].Disabled = true // srv04 — off
cs[4].LastBackupAt = now - 100*3600 // srv05 — stale
return cs, sizes
}
func view(t *testing.T, rawQuery string) *clientsView {
t.Helper()
cs, sizes := testClients()
r := httptest.NewRequest("GET", "/?"+rawQuery, nil)
return buildClientsView(parseClientsQuery(r), cs, sizes)
}
func TestClientsSearchFilter(t *testing.T) {
v := view(t, "q=нидер")
if v.Found != 1 || v.Rows[0].Domain != "srv01.example.com" {
t.Fatalf("поиск по названию: %d", v.Found)
}
if v := view(t, "q=SRV1"); v.Found != 10 { // srv10..srv19
t.Fatalf("поиск без учёта регистра: %d", v.Found)
}
v = view(t, "status=fail")
if v.Found != 1 || v.Rows[0].Domain != "srv03.example.com" {
t.Fatalf("фильтр fail: %+v", v.Found)
}
chips := map[string]int{}
for _, c := range v.Chips {
chips[c.Key] = c.Count
}
if chips[""] != 30 || chips["never"] != 1 || chips["off"] != 1 || chips["stale"] != 1 || chips["ok"] != 26 {
t.Fatalf("счётчики: %v", chips)
}
}
func TestClientsSortAndPaging(t *testing.T) {
v := view(t, "")
if v.Found != 30 || len(v.Rows) != 25 || v.Rows[0].Domain != "srv01.example.com" || v.Next == "" {
t.Fatalf("первая страница: found=%d rows=%d", v.Found, len(v.Rows))
}
v = view(t, "page=2")
if len(v.Rows) != 5 || v.From != 26 || v.To != 30 || v.Prev == "" || v.Next != "" {
t.Fatalf("вторая страница: %+v", v)
}
if v := view(t, "page=99"); v.Query.Page != 2 {
t.Fatalf("страница за пределами: %d", v.Query.Page)
}
v = view(t, "sort=size&per=10")
if v.Rows[0].Domain != "srv30.example.com" || len(v.Rows) != 10 {
t.Fatalf("размер по убыванию по умолчанию: %s", v.Rows[0].Domain)
}
if v := view(t, "sort=size&dir=asc"); v.Rows[0].Domain != "srv01.example.com" {
t.Fatalf("размер по возрастанию: %s", v.Rows[0].Domain)
}
if v := view(t, "sort=status"); v.Rows[0].StatusClass != "fail" {
t.Fatalf("сортировка по статусу: %s", v.Rows[0].StatusClass)
}
// повторный клик по текущей колонке меняет направление
if u := view(t, "sort=size").Query.SortURL("size"); !strings.Contains(u, "dir=asc") {
t.Fatalf("SortURL: %s", u)
}
// фильтр сохраняется в ссылках пагинации
if u := view(t, "q=srv&status=ok").Query.PageURL(2); !strings.Contains(u, "q=srv") || !strings.Contains(u, "status=ok") {
t.Fatalf("PageURL: %s", u)
}
}
+159 -129
View File
@@ -1,129 +1,159 @@
:root {
--bg: #f6f7f9;
--panel: #ffffff;
--text: #1c2128;
--muted: #6b7280;
--border: #dfe3e8;
--accent: #2f6fde;
--accent-text: #ffffff;
--ok: #1f8a4c;
--ok-bg: #e3f4ea;
--warn: #9a6400;
--warn-bg: #fdf1d8;
--fail: #c0362c;
--fail-bg: #fbe5e3;
--code-bg: #eef1f5;
}
@media (prefers-color-scheme: dark) {
:root {
--bg: #14171c;
--panel: #1c2027;
--text: #e4e7eb;
--muted: #9aa3ae;
--border: #2e343d;
--accent: #5b8ff0;
--ok: #4cc27f;
--ok-bg: #18342a;
--warn: #e0ad4a;
--warn-bg: #3a2f17;
--fail: #f07167;
--fail-bg: #3d1f1d;
--code-bg: #232831;
}
}
* { box-sizing: border-box; }
body {
margin: 0;
background: var(--bg);
color: var(--text);
font: 15px/1.5 system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
}
a { color: var(--accent); text-decoration: none; }
a:hover { text-decoration: underline; }
code, pre { font-family: ui-monospace, "Cascadia Mono", Consolas, monospace; font-size: 13px; }
code { background: var(--code-bg); padding: 1px 5px; border-radius: 4px; }
.top {
display: flex; align-items: center; justify-content: space-between; gap: 16px;
padding: 10px 24px; background: var(--panel); border-bottom: 1px solid var(--border);
}
.brand { font-weight: 600; color: var(--text); }
.top nav { display: flex; align-items: center; gap: 18px; }
.top nav a { color: var(--muted); }
.top nav a.active { color: var(--text); font-weight: 500; }
main { max-width: 1200px; margin: 0 auto; padding: 24px; }
h1 { font-size: 24px; margin: 0 0 8px; display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
h2 { font-size: 18px; margin: 32px 0 12px; }
.head { display: flex; justify-content: space-between; align-items: flex-start; gap: 16px; flex-wrap: wrap; margin-bottom: 16px; }
.actions { display: flex; gap: 8px; flex-wrap: wrap; }
.muted { color: var(--muted); }
.small { font-size: 13px; }
.right { text-align: right; }
.empty { color: var(--muted); padding: 24px 0; }
.hint { color: var(--muted); font-size: 13px; margin: 4px 0 12px; }
.table-wrap { overflow-x: auto; background: var(--panel); border: 1px solid var(--border); border-radius: 8px; }
table { width: 100%; border-collapse: collapse; }
th, td { padding: 9px 12px; text-align: left; border-bottom: 1px solid var(--border); vertical-align: top; }
th { font-size: 13px; font-weight: 500; color: var(--muted); }
tr:last-child td { border-bottom: none; }
td.num, th.num { text-align: right; font-variant-numeric: tabular-nums; white-space: nowrap; }
.badge { display: inline-block; padding: 1px 8px; border-radius: 10px; font-size: 12px; font-weight: 500; white-space: nowrap; }
.badge.ok { background: var(--ok-bg); color: var(--ok); }
.badge.stale, .badge.never { background: var(--warn-bg); color: var(--warn); }
.badge.fail { background: var(--fail-bg); color: var(--fail); }
.badge.off { background: var(--code-bg); color: var(--muted); }
.ok-text { color: var(--ok); }
.fail-text { color: var(--fail); }
ul.results { list-style: none; padding: 0; margin: 0 0 16px; }
.facts { display: flex; flex-wrap: wrap; gap: 12px 32px; margin: 16px 0; }
.facts dt { font-size: 12px; color: var(--muted); }
.facts dd { margin: 0; }
.card { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 20px; }
.card.narrow, .login { max-width: 520px; }
.card h2:first-of-type { margin-top: 0; }
label { display: block; margin-bottom: 12px; font-size: 14px; }
label.check { display: flex; align-items: center; gap: 8px; }
input, textarea {
display: block; width: 100%; margin-top: 4px; padding: 7px 10px;
background: var(--bg); color: var(--text); border: 1px solid var(--border); border-radius: 6px; font: inherit;
}
input[type=checkbox] { display: inline; width: auto; margin: 0; }
textarea { font-family: ui-monospace, "Cascadia Mono", Consolas, monospace; font-size: 13px; }
.grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(150px, 1fr)); gap: 0 16px; }
button, .button {
display: inline-block; padding: 7px 14px; border-radius: 6px; border: 1px solid var(--border);
background: var(--panel); color: var(--text); font: inherit; cursor: pointer;
}
button:hover, .button:hover { text-decoration: none; filter: brightness(0.97); }
button.primary, .button.primary { background: var(--accent); border-color: var(--accent); color: var(--accent-text); }
button:disabled { opacity: 0.5; cursor: not-allowed; }
button.link { background: none; border: none; padding: 0; color: var(--muted); }
button.danger { background: var(--fail-bg); border-color: var(--fail-bg); color: var(--fail); }
button.link.danger { background: none; }
form.inline { display: inline; }
.error { background: var(--fail-bg); color: var(--fail); padding: 10px 14px; border-radius: 6px; }
.warnings { background: var(--warn-bg); color: var(--warn); padding: 10px 14px; border-radius: 6px; margin: 12px 0; }
.warnings ul { margin: 8px 0 0; padding-left: 20px; font-size: 13px; }
.danger-zone { margin-top: 32px; color: var(--muted); }
.danger-zone form { margin-top: 12px; max-width: 420px; }
.danger-zone input { margin-bottom: 8px; }
.cmd { display: flex; gap: 8px; align-items: flex-start; margin: 16px 0; }
.cmd pre { flex: 1; margin: 0; padding: 12px; background: var(--code-bg); border-radius: 6px; white-space: pre-wrap; word-break: break-all; }
pre.json { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 16px; overflow-x: auto; }
.login { margin: 10vh auto; }
.login form { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 20px; }
@media (max-width: 640px) {
main { padding: 16px; }
.top { padding: 10px 16px; }
.cmd { flex-direction: column; }
}
:root {
--bg: #f6f7f9;
--panel: #ffffff;
--text: #1c2128;
--muted: #6b7280;
--border: #dfe3e8;
--accent: #2f6fde;
--accent-text: #ffffff;
--ok: #1f8a4c;
--ok-bg: #e3f4ea;
--warn: #9a6400;
--warn-bg: #fdf1d8;
--fail: #c0362c;
--fail-bg: #fbe5e3;
--code-bg: #eef1f5;
}
@media (prefers-color-scheme: dark) {
:root {
--bg: #14171c;
--panel: #1c2027;
--text: #e4e7eb;
--muted: #9aa3ae;
--border: #2e343d;
--accent: #5b8ff0;
--ok: #4cc27f;
--ok-bg: #18342a;
--warn: #e0ad4a;
--warn-bg: #3a2f17;
--fail: #f07167;
--fail-bg: #3d1f1d;
--code-bg: #232831;
}
}
* { box-sizing: border-box; }
body {
margin: 0;
background: var(--bg);
color: var(--text);
font: 15px/1.5 system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
}
a { color: var(--accent); text-decoration: none; }
a:hover { text-decoration: underline; }
code, pre { font-family: ui-monospace, "Cascadia Mono", Consolas, monospace; font-size: 13px; }
code { background: var(--code-bg); padding: 1px 5px; border-radius: 4px; }
.top { background: var(--panel); border-bottom: 1px solid var(--border); }
/* шапка выровнена по той же колонке, что и контент */
.top .wrap {
max-width: 1200px; margin: 0 auto; padding: 10px 24px;
display: flex; align-items: center; justify-content: space-between; gap: 16px;
}
.brand { font-weight: 600; color: var(--text); }
.top nav { display: flex; align-items: center; gap: 18px; }
.top nav a { color: var(--muted); }
.top nav a.active { color: var(--text); font-weight: 500; }
main { max-width: 1200px; margin: 0 auto; padding: 24px; }
h1 { font-size: 24px; margin: 0 0 8px; display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
h2 { font-size: 18px; margin: 32px 0 12px; }
.head { display: flex; justify-content: space-between; align-items: flex-start; gap: 16px; flex-wrap: wrap; margin-bottom: 16px; }
.actions { display: flex; gap: 8px; flex-wrap: wrap; }
.muted { color: var(--muted); }
.small { font-size: 13px; }
.right { text-align: right; }
.empty { color: var(--muted); padding: 24px 0; }
.hint { color: var(--muted); font-size: 13px; margin: 4px 0 12px; }
.table-wrap { overflow-x: auto; background: var(--panel); border: 1px solid var(--border); border-radius: 8px; }
table { width: 100%; border-collapse: collapse; }
th, td { padding: 9px 12px; text-align: left; border-bottom: 1px solid var(--border); vertical-align: top; }
th { font-size: 13px; font-weight: 500; color: var(--muted); }
tr:last-child td { border-bottom: none; }
td.num, th.num { text-align: right; font-variant-numeric: tabular-nums; white-space: nowrap; }
.badge { display: inline-block; padding: 1px 8px; border-radius: 10px; font-size: 12px; font-weight: 500; white-space: nowrap; }
.badge.ok { background: var(--ok-bg); color: var(--ok); }
.badge.stale, .badge.never { background: var(--warn-bg); color: var(--warn); }
.badge.fail { background: var(--fail-bg); color: var(--fail); }
.badge.off { background: var(--code-bg); color: var(--muted); }
.ok-text { color: var(--ok); }
.fail-text { color: var(--fail); }
ul.results { list-style: none; padding: 0; margin: 0 0 16px; }
.facts { display: flex; flex-wrap: wrap; gap: 12px 32px; margin: 16px 0; }
.facts dt { font-size: 12px; color: var(--muted); }
.facts dd { margin: 0; }
.card { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 20px; }
.card.narrow, .login { max-width: 520px; }
.card h2:first-of-type { margin-top: 0; }
label { display: block; margin-bottom: 12px; font-size: 14px; }
label.check { display: flex; align-items: center; gap: 8px; }
input, textarea {
display: block; width: 100%; margin-top: 4px; padding: 7px 10px;
background: var(--bg); color: var(--text); border: 1px solid var(--border); border-radius: 6px; font: inherit;
}
input[type=checkbox] { display: inline; width: auto; margin: 0; }
textarea { font-family: ui-monospace, "Cascadia Mono", Consolas, monospace; font-size: 13px; }
.settings { display: flex; flex-direction: column; gap: 16px; }
.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(340px, 1fr)); gap: 16px; align-items: start; }
.cards .card { height: 100%; }
.toolbar { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; margin-bottom: 12px; }
.toolbar input[type=search] { flex: 1 1 260px; width: auto; margin: 0; }
.toolbar select { margin: 0; }
select {
padding: 7px 10px; background: var(--bg); color: var(--text);
border: 1px solid var(--border); border-radius: 6px; font: inherit;
}
.chips { display: flex; flex-wrap: wrap; gap: 6px; }
.chip {
display: inline-flex; align-items: center; gap: 6px; padding: 4px 10px; border-radius: 14px;
border: 1px solid var(--border); color: var(--muted); font-size: 13px; white-space: nowrap;
}
.chip:hover { text-decoration: none; color: var(--text); }
.chip.active { background: var(--accent); border-color: var(--accent); color: var(--accent-text); }
.chip .count { opacity: 0.75; font-variant-numeric: tabular-nums; }
th a { color: inherit; }
th a.sorted { color: var(--text); }
.pager { display: flex; flex-wrap: wrap; justify-content: space-between; align-items: center; gap: 12px; margin-top: 12px; color: var(--muted); font-size: 13px; }
.pager .pages { display: flex; gap: 4px; flex-wrap: wrap; }
.pager .pages a, .pager .pages span { min-width: 32px; text-align: center; padding: 4px 8px; border-radius: 6px; border: 1px solid var(--border); }
.pager .pages span.current { background: var(--accent); border-color: var(--accent); color: var(--accent-text); }
.pager .pages span.gap { border: none; }
.grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(150px, 1fr)); gap: 0 16px; }
button, .button {
display: inline-block; padding: 7px 14px; border-radius: 6px; border: 1px solid var(--border);
background: var(--panel); color: var(--text); font: inherit; cursor: pointer;
}
button:hover, .button:hover { text-decoration: none; filter: brightness(0.97); }
button.primary, .button.primary { background: var(--accent); border-color: var(--accent); color: var(--accent-text); }
button:disabled { opacity: 0.5; cursor: not-allowed; }
button.link { background: none; border: none; padding: 0; color: var(--muted); }
button.danger { background: var(--fail-bg); border-color: var(--fail-bg); color: var(--fail); }
button.link.danger { background: none; }
form.inline { display: inline; }
.error { background: var(--fail-bg); color: var(--fail); padding: 10px 14px; border-radius: 6px; }
.warnings { background: var(--warn-bg); color: var(--warn); padding: 10px 14px; border-radius: 6px; margin: 12px 0; }
.warnings ul { margin: 8px 0 0; padding-left: 20px; font-size: 13px; }
.danger-zone { margin-top: 32px; color: var(--muted); }
.danger-zone form { margin-top: 12px; max-width: 420px; }
.danger-zone input { margin-bottom: 8px; }
.cmd { display: flex; gap: 8px; align-items: flex-start; margin: 16px 0; }
.cmd pre { flex: 1; margin: 0; padding: 12px; background: var(--code-bg); border-radius: 6px; white-space: pre-wrap; word-break: break-all; }
pre.json { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 16px; overflow-x: auto; }
.login { margin: 10vh auto; }
.login form { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 20px; }
@media (max-width: 640px) {
main { padding: 16px; }
.top .wrap { padding: 10px 16px; }
.cards { grid-template-columns: 1fr; }
.cmd { flex-direction: column; }
}
+19
View File
@@ -325,6 +325,25 @@ func (s *Store) ListBackups(clientID int64, status string) ([]*Backup, error) {
return out, nil
}
// LastSizes возвращает размер последнего успешного бэкапа по каждому клиенту одним запросом.
func (s *Store) LastSizes() (map[int64]int64, error) {
rows, err := s.db.Query(`SELECT client_id, total_size FROM backups b WHERE status = ?1 AND id = (
SELECT id FROM backups WHERE client_id = b.client_id AND status = ?1 ORDER BY created_at DESC, id DESC LIMIT 1)`, StatusComplete)
if err != nil {
return nil, err
}
defer rows.Close()
out := map[int64]int64{}
for rows.Next() {
var id, size int64
if err := rows.Scan(&id, &size); err != nil {
return nil, err
}
out[id] = size
}
return out, rows.Err()
}
// LatestComplete возвращает последний успешный бэкап клиента.
func (s *Store) LatestComplete(clientID int64) (*Backup, error) {
var id int64
+41 -4
View File
@@ -1,15 +1,39 @@
{{define "title"}}Клиенты — backup-master{{end}}
{{define "content"}}
{{$v := .V}}{{$q := .V.Query}}
<div class="head">
<h1>Клиенты</h1>
<h1>Клиенты <span class="muted small">{{$v.Total}}</span></h1>
<a class="button primary" href="/clients/new">Добавить клиента</a>
</div>
{{if .Clients}}
{{if $v.Total}}
<form method="get" action="/" class="toolbar">
<input type="search" name="q" value="{{$q.Q}}" placeholder="Поиск по домену или названию" autofocus>
{{if $q.Status}}<input type="hidden" name="status" value="{{$q.Status}}">{{end}}
{{if ne $q.Sort "domain"}}<input type="hidden" name="sort" value="{{$q.Sort}}">{{end}}
{{with $q.DirParam}}<input type="hidden" name="dir" value="{{.}}">{{end}}
<select name="per" onchange="this.form.submit()" title="Строк на странице">
{{range $v.PerOpts}}<option value="{{.}}" {{if eq . $q.Per}}selected{{end}}>по {{.}}</option>{{end}}
</select>
<button>Найти</button>
{{if or $q.Q $q.Status}}<a class="button" href="/">Сбросить</a>{{end}}
</form>
<div class="chips toolbar">
{{range $v.Chips}}<a class="chip {{if .Active}}active{{end}}" href="{{.URL}}">{{.Title}} <span class="count">{{.Count}}</span></a>{{end}}
</div>
{{if $v.Rows}}
<div class="table-wrap">
<table>
<thead><tr><th>Домен</th><th>Название</th><th>Статус</th><th>Последний бэкап</th><th class="num">Размер</th><th>Агент на связи</th></tr></thead>
<thead><tr>
<th><a href="{{$q.SortURL "domain"}}" {{if eq $q.Sort "domain"}}class="sorted"{{end}}>Домен {{$q.SortMark "domain"}}</a></th>
<th><a href="{{$q.SortURL "name"}}" {{if eq $q.Sort "name"}}class="sorted"{{end}}>Название {{$q.SortMark "name"}}</a></th>
<th><a href="{{$q.SortURL "status"}}" {{if eq $q.Sort "status"}}class="sorted"{{end}}>Статус {{$q.SortMark "status"}}</a></th>
<th><a href="{{$q.SortURL "last_backup"}}" {{if eq $q.Sort "last_backup"}}class="sorted"{{end}}>Последний бэкап {{$q.SortMark "last_backup"}}</a></th>
<th class="num"><a href="{{$q.SortURL "size"}}" {{if eq $q.Sort "size"}}class="sorted"{{end}}>Размер {{$q.SortMark "size"}}</a></th>
<th><a href="{{$q.SortURL "last_seen"}}" {{if eq $q.Sort "last_seen"}}class="sorted"{{end}}>Агент на связи {{$q.SortMark "last_seen"}}</a></th>
</tr></thead>
<tbody>
{{range .Clients}}
{{range $v.Rows}}
<tr>
<td><a href="/clients/{{.ID}}">{{.Domain}}</a></td>
<td>{{if ne .Name .Domain}}{{.Name}}{{end}}</td>
@@ -22,6 +46,19 @@
</tbody>
</table>
</div>
<div class="pager">
<span>{{$v.From}}–{{$v.To}} из {{$v.Found}}{{if ne $v.Found $v.Total}} (всего {{$v.Total}}){{end}}</span>
{{if $v.Pages}}
<div class="pages">
{{if $v.Prev}}<a href="{{$v.Prev}}">←</a>{{end}}
{{range $v.Pages}}{{if .Gap}}<span class="gap">…</span>{{else if .Current}}<span class="current">{{.N}}</span>{{else}}<a href="{{.URL}}">{{.N}}</a>{{end}}{{end}}
{{if $v.Next}}<a href="{{$v.Next}}">→</a>{{end}}
</div>
{{end}}
</div>
{{else}}
<p class="empty">Ничего не найдено. <a href="/">Сбросить фильтры</a></p>
{{end}}
{{else}}
<p class="empty">Клиентов пока нет. Добавьте первый — получите команду установки агента.</p>
{{end}}
+11 -9
View File
@@ -9,15 +9,17 @@
<body>
{{if ne .Page "login"}}
<header class="top">
<a class="brand" href="/">backup-master</a>
<nav>
<a href="/" {{if or (eq .Page "clients") (eq .Page "client") (eq .Page "backup")}}class="active"{{end}}>Клиенты</a>
<a href="/settings" {{if eq .Page "settings"}}class="active"{{end}}>Настройки</a>
<form method="post" action="/logout" class="inline">
<input type="hidden" name="csrf" value="{{.CSRF}}">
<button class="link">Выйти</button>
</form>
</nav>
<div class="wrap">
<a class="brand" href="/">backup-master</a>
<nav>
<a href="/" {{if or (eq .Page "clients") (eq .Page "client") (eq .Page "backup")}}class="active"{{end}}>Клиенты</a>
<a href="/settings" {{if eq .Page "settings"}}class="active"{{end}}>Настройки</a>
<form method="post" action="/logout" class="inline">
<input type="hidden" name="csrf" value="{{.CSRF}}">
<button class="link">Выйти</button>
</form>
</nav>
</div>
</header>
{{end}}
<main>
+29 -19
View File
@@ -13,29 +13,39 @@
<p class="error">Ни один канал уведомлений не настроен.</p>
{{end}}
{{end}}
<form method="post" action="/settings" class="card narrow">
<form method="post" action="/settings" class="settings">
<input type="hidden" name="csrf" value="{{.CSRF}}">
<h2>ntfy</h2>
<label>URL топика <input name="ntfy_url" value="{{.NtfyURL}}" placeholder="https://ntfy.example.com/backups"></label>
<label>Авторизация <input name="ntfy_auth" type="password" autocomplete="off" placeholder="{{if .NtfyAuthSet}}задана — оставьте пустым, чтобы не менять{{else}}tk_... или user:password{{end}}"></label>
{{if .NtfyAuthSet}}<label class="check"><input type="checkbox" name="ntfy_auth_clear" value="1"> Удалить авторизацию</label>{{end}}
<p class="hint">Пустой URL — ntfy выключен.</p>
<div class="cards">
<section class="card">
<h2>ntfy</h2>
<label>URL топика <input name="ntfy_url" value="{{.NtfyURL}}" placeholder="https://ntfy.example.com/backups"></label>
<label>Авторизация <input name="ntfy_auth" type="password" autocomplete="off" placeholder="{{if .NtfyAuthSet}}задана — оставьте пустым, чтобы не менять{{else}}tk_... или user:password{{end}}"></label>
{{if .NtfyAuthSet}}<label class="check"><input type="checkbox" name="ntfy_auth_clear" value="1"> Удалить авторизацию</label>{{end}}
<p class="hint">Пустой URL — ntfy выключен.</p>
</section>
<h2>Telegram</h2>
<label>Токен бота <input name="tg_token" type="password" autocomplete="off" placeholder="{{if .TGTokenSet}}задан — оставьте пустым, чтобы не менять{{else}}123456:ABC... от @BotFather{{end}}"></label>
{{if .TGTokenSet}}<label class="check"><input type="checkbox" name="tg_token_clear" value="1"> Удалить токен (выключить Telegram)</label>{{end}}
<label>Chat ID <input name="tg_chats" value="{{.TGChats}}" placeholder="123456789, -1001234567890"></label>
<p class="hint">Можно несколько через запятую. Личный чат — ваш числовой id (напишите боту и откройте <code>https://api.telegram.org/bot&lt;токен&gt;/getUpdates</code>), группа — id вида <code>-100…</code>, бот должен быть её участником.</p>
<label>ID темы (необязательно) <input name="tg_thread" value="{{.TGThread}}" placeholder="для группы с темами"></label>
<label>Адрес Bot API (необязательно) <input name="tg_api_url" value="{{.TGAPIURL}}" placeholder="https://api.telegram.org"></label>
<p class="hint">Свой Bot API сервер или прокси, если api.telegram.org недоступен с сервера бэкапов.</p>
<section class="card">
<h2>Telegram</h2>
<label>Токен бота <input name="tg_token" type="password" autocomplete="off" placeholder="{{if .TGTokenSet}}задан — оставьте пустым, чтобы не менять{{else}}123456:ABC... от @BotFather{{end}}"></label>
{{if .TGTokenSet}}<label class="check"><input type="checkbox" name="tg_token_clear" value="1"> Удалить токен (выключить Telegram)</label>{{end}}
<label>Chat ID <input name="tg_chats" value="{{.TGChats}}" placeholder="123456789, -1001234567890"></label>
<p class="hint">Можно несколько через запятую. Личный чат — ваш числовой id (напишите боту и откройте <code>https://api.telegram.org/bot&lt;токен&gt;/getUpdates</code>), группа — id вида <code>-100…</code>, бот должен быть её участником.</p>
<div class="grid">
<label>ID темы <input name="tg_thread" value="{{.TGThread}}" placeholder="необязательно"></label>
<label>Адрес Bot API <input name="tg_api_url" value="{{.TGAPIURL}}" placeholder="https://api.telegram.org"></label>
</div>
<p class="hint">Тема — для группы с темами. Свой Bot API сервер или прокси — если api.telegram.org недоступен с сервера бэкапов.</p>
</section>
</div>
<h2>Что отправлять</h2>
<label class="check"><input type="checkbox" name="notify_success" value="1" {{if .NotifySuccess}}checked{{end}}> Сообщать и об успешных бэкапах (в Telegram — без звука)</label>
<p class="hint">Ошибки бэкапа и отсутствие бэкапа дольше заданного у клиента срока приходят всегда, во все настроенные каналы.</p>
<label class="check"><input type="checkbox" name="test" value="1"> Отправить тестовое уведомление после сохранения</label>
<button class="primary">Сохранить</button>
<section class="card">
<h2>Что отправлять</h2>
<label class="check"><input type="checkbox" name="notify_success" value="1" {{if .NotifySuccess}}checked{{end}}> Сообщать и об успешных бэкапах (в Telegram — без звука)</label>
<p class="hint">Ошибки бэкапа и отсутствие бэкапа дольше заданного у клиента срока приходят всегда, во все настроенные каналы.</p>
<label class="check"><input type="checkbox" name="test" value="1"> Отправить тестовое уведомление после сохранения</label>
<button class="primary">Сохранить</button>
</section>
</form>
<p class="hint">Логин и пароль администратора меняются на сервере: <code>backupctl admin-passwd &lt;логин&gt;</code></p>
{{end}}
-18
View File
@@ -122,24 +122,6 @@ type clientRow struct {
LastSize int64
}
func (s *Server) webClients(w http.ResponseWriter, r *http.Request) {
clients, err := s.st.ListClients()
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
var rows []clientRow
for _, c := range clients {
row := clientRow{Client: c}
row.StatusClass, row.StatusText = clientStatus(c)
if b, err := s.st.LatestComplete(c.ID); err == nil {
row.LastSize = b.TotalSize
}
rows = append(rows, row)
}
s.render(w, r, "clients", map[string]any{"Clients": rows})
}
func (s *Server) webClientNew(w http.ResponseWriter, r *http.Request) {
s.render(w, r, "client_new", nil)
}