backup-master: сервер бэкапов, агент и восстановление VPS

Один бинарник backupctl:
- server: API для агентов и restore, веб-морда (один админ), SQLite,
  ретеншн GFS, heavy-части, уведомления ntfy, раздача agent.sh/restore.sh;
- backup/plan: сбор по каталогу категорий (files/systemd/xui/compose),
  горячие дампы Postgres/Mongo/MySQL, снимок x-ui.db, docker-тома,
  digest образов, проверка crontab, потоковая отправка tar.zst;
- restore: провижининг на основе vps_installer с теми же версиями пакетов,
  recipes 3x-ui/nebula/sing-box нужных версий, восстановление compose
  с заливкой дампов и закреплением образов по digest.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

internal/server/templates/backup.html

@@ -0,0 +1,30 @@
+{{define "title"}}Бэкап #{{.Backup.ID}} — backup-master{{end}}
+{{define "content"}}
+{{$b := .Backup}}
+<p><a href="/clients/{{.Client.ID}}">← {{.Client.Domain}}</a></p>
+<div class="head">
+  <h1>Бэкап #{{.Backup.ID}} <span class="badge {{if eq .Backup.Status "complete"}}ok{{else if eq .Backup.Status "failed"}}fail{{else}}stale{{end}}">{{.Backup.Status}}</span></h1>
+  {{if eq .Backup.Status "complete"}}
+  <form method="post" action="/clients/{{.Client.ID}}/restore-token" class="inline">
+    <input type="hidden" name="csrf" value="{{.CSRF}}">
+    <input type="hidden" name="backup" value="{{.Backup.ID}}">
+    <button class="primary">Восстановить из этого бэкапа</button>
+  </form>
+  {{end}}
+</div>
+{{with .Backup.Error}}<p class="error">{{.}}</p>{{end}}
+<dl class="facts">
+  <div><dt>Создан</dt><dd>{{ts .Backup.CreatedAt}}</dd></div>
+  <div><dt>Размер</dt><dd>{{bytes .Backup.TotalSize}}</dd></div>
+  <div><dt>Агент</dt><dd>{{.M.AgentVersion}}</dd></div>
+  <div><dt>Части</dt><dd>{{range .Backup.Parts}}{{if eq .Status "complete"}}<a href="/backups/{{$b.ID}}/parts/{{.Name}}">{{.Name}}</a> {{bytes .Size}}<br>{{else}}<span class="muted">{{.Name}}: {{.Status}}</span><br>{{end}}{{end}}</dd></div>
+</dl>
+{{if .M.Warnings}}
+<details class="warnings" open>
+  <summary>Предупреждения ({{len .M.Warnings}})</summary>
+  <ul>{{range .M.Warnings}}<li>{{.}}</li>{{end}}</ul>
+</details>
+{{end}}
+<h2>Манифест</h2>
+<pre class="json">{{.Raw}}</pre>
+{{end}}

internal/server/templates/client.html

@@ -0,0 +1,132 @@
+{{define "title"}}{{.Client.Domain}} — backup-master{{end}}
+{{define "content"}}
+{{$csrf := .CSRF}}
+<div class="head">
+  <div>
+    <h1>{{.Client.Domain}} <span class="badge {{.StatusClass}}">{{.StatusText}}</span></h1>
+    {{if ne .Client.Name .Client.Domain}}<p class="muted">{{.Client.Name}}</p>{{end}}
+  </div>
+  <div class="actions">
+    <form method="post" action="/clients/{{.Client.ID}}/restore-token" class="inline">
+      <input type="hidden" name="csrf" value="{{$csrf}}">
+      <button class="primary" {{if not .Latest}}disabled title="Нет успешных бэкапов"{{end}}>Команда восстановления</button>
+    </form>
+    <form method="post" action="/clients/{{.Client.ID}}/token" class="inline" onsubmit="return confirm('Старый токен перестанет работать. Продолжить?')">
+      <input type="hidden" name="csrf" value="{{$csrf}}">
+      <button>Новый токен агента</button>
+    </form>
+  </div>
+</div>
+{{with .Error}}<p class="error">{{.}}</p>{{end}}
+{{if .Client.LastError}}<p class="error">Последняя ошибка ({{ts .Client.LastErrorAt}}): {{.Client.LastError}}</p>{{end}}
+
+<dl class="facts">
+  <div><dt>Последний бэкап</dt><dd title="{{ts .Client.LastBackupAt}}">{{ago .Client.LastBackupAt}}</dd></div>
+  <div><dt>Heavy-части</dt><dd title="{{ts .Client.LastHeavyAt}}">{{ago .Client.LastHeavyAt}}</dd></div>
+  <div><dt>Агент на связи</dt><dd title="{{ts .Client.LastSeenAt}}">{{ago .Client.LastSeenAt}}</dd></div>
+  {{with .Latest}}<div><dt>Система</dt><dd>{{.Hostname}}{{with .OS.PrettyName}} · {{.}}{{end}}{{with .OS.Arch}} · {{.}}{{end}}</dd></div>{{end}}
+</dl>
+
+{{with .Latest}}
+<h2>Что бэкапится <span class="muted small">по последнему бэкапу</span></h2>
+<div class="table-wrap">
+<table>
+  <thead><tr><th>Категория</th><th>Тип</th><th>Версия</th><th>Сервис</th><th>Содержимое</th></tr></thead>
+  <tbody>
+  {{range .Categories}}
+  <tr>
+    <td>{{.Name}}{{if .Auto}} <span class="badge stale" title="Проект найден автоматически и не описан в каталоге — бэкапится с настройками по умолчанию">авто</span>{{end}}</td>
+    <td>{{.Type}}</td>
+    <td>{{.Version}}{{with .Compose}}{{with .Git}}<span class="muted small" title="{{.Remote}}">git {{printf "%.8s" .Commit}}{{if .Dirty}}*{{end}}</span>{{end}}{{end}}</td>
+    <td>{{with .Service}}{{.Unit}} {{if .Active}}<span class="ok-text">active</span>{{else}}<span class="muted">inactive</span>{{end}}{{if not .Enabled}} <span class="muted">(disabled)</span>{{end}}{{end}}</td>
+    <td class="small">
+      {{if .Paths}}{{join .Paths ", "}}{{end}}
+      {{range .Dumps}}<br>дамп {{.Kind}}{{with .Service}} ({{.}}){{end}}{{end}}
+      {{range .Volumes}}<br>том {{.Name}}{{end}}
+      {{if .Heavy}}<br>heavy: {{join .Heavy ", "}}{{if .HeavySkipped}} <span class="muted">(не в этот раз)</span>{{end}}{{end}}
+    </td>
+  </tr>
+  {{else}}
+  <tr><td colspan="5" class="muted">Ни одной категории не найдено.</td></tr>
+  {{end}}
+  </tbody>
+</table>
+</div>
+{{if .Packages}}
+<p class="small muted">Пакеты: {{range $k, $v := .Packages}}{{$k}}={{$v}} &nbsp; {{end}}</p>
+{{end}}
+{{if .Warnings}}
+<details class="warnings" open>
+  <summary>Предупреждения ({{len .Warnings}})</summary>
+  <ul>{{range .Warnings}}<li>{{.}}</li>{{end}}</ul>
+</details>
+{{end}}
+{{end}}
+
+<h2>История</h2>
+{{if .Backups}}
+<div class="table-wrap">
+<table>
+  <thead><tr><th>#</th><th>Дата</th><th>Статус</th><th class="num">Размер</th><th>Части</th><th></th></tr></thead>
+  <tbody>
+  {{range .Backups}}
+  {{$b := .}}
+  <tr>
+    <td><a href="/backups/{{.ID}}">{{.ID}}</a></td>
+    <td>{{ts .CreatedAt}}</td>
+    <td><span class="badge {{if eq .Status "complete"}}ok{{else if eq .Status "failed"}}fail{{else}}stale{{end}}">{{.Status}}</span>{{with .Error}} <span class="small muted">{{.}}</span>{{end}}</td>
+    <td class="num">{{if .TotalSize}}{{bytes .TotalSize}}{{end}}</td>
+    <td class="small">{{range .Parts}}{{if eq .Status "complete"}}<a href="/backups/{{$b.ID}}/parts/{{.Name}}">{{.Name}}</a> ({{bytes .Size}}) {{else if eq .Status "deleted"}}<span class="muted">{{.Name}} удалена</span> {{end}}{{end}}</td>
+    <td class="right">
+      <form method="post" action="/backups/{{.ID}}/delete" class="inline" onsubmit="return confirm('Удалить бэкап #{{.ID}}?')">
+        <input type="hidden" name="csrf" value="{{$csrf}}">
+        <button class="link danger">удалить</button>
+      </form>
+    </td>
+  </tr>
+  {{end}}
+  </tbody>
+</table>
+</div>
+{{else}}
+<p class="empty">Бэкапов ещё нет.</p>
+{{end}}
+
+<h2>Настройки</h2>
+<form method="post" action="/clients/{{.Client.ID}}/settings" class="card">
+  <input type="hidden" name="csrf" value="{{$csrf}}">
+  <label>Название <input name="name" value="{{.Client.Name}}"></label>
+  <div class="grid">
+    <label>Дневных копий <input type="number" min="0" name="keep_daily" value="{{.Client.KeepDaily}}"></label>
+    <label>Недельных <input type="number" min="0" name="keep_weekly" value="{{.Client.KeepWeekly}}"></label>
+    <label>Месячных <input type="number" min="0" name="keep_monthly" value="{{.Client.KeepMonthly}}"></label>
+    <label>Тревога через, ч <input type="number" min="0" name="stale_hours" value="{{.Client.StaleHours}}"></label>
+    <label>Heavy раз в, дней <input type="number" min="0" name="heavy_every_days" value="{{.Client.HeavyEveryDays}}"></label>
+    <label>Хранить heavy, шт <input type="number" min="0" name="heavy_keep" value="{{.Client.HeavyKeep}}"></label>
+  </div>
+  <label class="check"><input type="checkbox" name="disabled" value="1" {{if .Client.Disabled}}checked{{end}}> Клиент отключён (агент получает отказ)</label>
+  <label>Переопределения каталога (YAML)
+    <textarea name="config_yaml" rows="12" spellcheck="false" placeholder="categories:
+  - {name: scripts, disabled: true}      # отключить встроенную категорию
+  - name: extra                          # добавить свою
+    type: files
+    paths: [/srv/extra]
+    dumps:
+      - name: full_dump.sql
+        cmd: mysqldump --all-databases
+        restore_cmd: mysql &lt; &quot;$DUMP_FILE&quot;">{{.Client.ConfigYAML}}</textarea>
+  </label>
+  <p class="hint">Категория с тем же <code>name</code>, что во встроенном каталоге, заменяет её целиком. Поля: type (files|systemd|xui|compose), paths, exclude, detect, service, version_cmd, install, keep_binaries, ensure_dirs, post_restore, dumps, dir, skip_services, heavy_paths, restore_after.</p>
+  <button class="primary">Сохранить</button>
+</form>
+
+<details class="danger-zone">
+  <summary>Удаление клиента</summary>
+  <form method="post" action="/clients/{{.Client.ID}}/delete">
+    <input type="hidden" name="csrf" value="{{$csrf}}">
+    <p>Будут удалены все бэкапы клиента. Введите домен для подтверждения:</p>
+    <input name="confirm" placeholder="{{.Client.Domain}}">
+    <button class="danger">Удалить клиента и бэкапы</button>
+  </form>
+</details>
+{{end}}

internal/server/templates/client_new.html

@@ -0,0 +1,12 @@
+{{define "title"}}Новый клиент — backup-master{{end}}
+{{define "content"}}
+<h1>Новый клиент</h1>
+{{with .Error}}<p class="error">{{.}}</p>{{end}}
+<form method="post" action="/clients" class="card narrow">
+  <input type="hidden" name="csrf" value="{{.CSRF}}">
+  <label>Домен <input name="domain" value="{{.Domain}}" placeholder="nl1.example.com" required autofocus></label>
+  <p class="hint">По домену бэкап находится при восстановлении. Он же станет hostname нового сервера, если на старом hostname не задан.</p>
+  <label>Название (необязательно) <input name="name" value="{{.Name}}"></label>
+  <button class="primary">Создать и получить токен</button>
+</form>
+{{end}}

internal/server/templates/clients.html

@@ -0,0 +1,28 @@
+{{define "title"}}Клиенты — backup-master{{end}}
+{{define "content"}}
+<div class="head">
+  <h1>Клиенты</h1>
+  <a class="button primary" href="/clients/new">Добавить клиента</a>
+</div>
+{{if .Clients}}
+<div class="table-wrap">
+<table>
+  <thead><tr><th>Домен</th><th>Название</th><th>Статус</th><th>Последний бэкап</th><th class="num">Размер</th><th>Агент на связи</th></tr></thead>
+  <tbody>
+  {{range .Clients}}
+  <tr>
+    <td><a href="/clients/{{.ID}}">{{.Domain}}</a></td>
+    <td>{{if ne .Name .Domain}}{{.Name}}{{end}}</td>
+    <td><span class="badge {{.StatusClass}}">{{.StatusText}}</span>{{if and (eq .StatusClass "fail") .LastError}} <span class="muted small" title="{{.LastError}}">{{.LastError}}</span>{{end}}</td>
+    <td title="{{ts .LastBackupAt}}">{{ago .LastBackupAt}}</td>
+    <td class="num">{{if .LastSize}}{{bytes .LastSize}}{{end}}</td>
+    <td title="{{ts .LastSeenAt}}">{{ago .LastSeenAt}}</td>
+  </tr>
+  {{end}}
+  </tbody>
+</table>
+</div>
+{{else}}
+<p class="empty">Клиентов пока нет. Добавьте первый — получите команду установки агента.</p>
+{{end}}
+{{end}}

internal/server/templates/layout.html

@@ -0,0 +1,27 @@
+<!doctype html>
+<html lang="ru">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>{{block "title" .}}backup-master{{end}}</title>
+<link rel="stylesheet" href="/static/style.css">
+</head>
+<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>
+</header>
+{{end}}
+<main>
+{{template "content" .}}
+</main>
+</body>
+</html>

internal/server/templates/login.html

@@ -0,0 +1,15 @@
+{{define "title"}}Вход — backup-master{{end}}
+{{define "content"}}
+<div class="login">
+  <h1>backup-master</h1>
+  {{if .NoAdmin}}
+  <p class="error">Администратор не задан. На сервере выполните:<br><code>backupctl admin-passwd &lt;логин&gt;</code></p>
+  {{end}}
+  {{with .Error}}<p class="error">{{.}}</p>{{end}}
+  <form method="post" action="/login">
+    <label>Логин <input name="user" autocomplete="username" required autofocus></label>
+    <label>Пароль <input name="password" type="password" autocomplete="current-password" required></label>
+    <button class="primary">Войти</button>
+  </form>
+</div>
+{{end}}

internal/server/templates/settings.html

@@ -0,0 +1,17 @@
+{{define "title"}}Настройки — backup-master{{end}}
+{{define "content"}}
+<h1>Настройки</h1>
+{{if .Saved}}<p class="ok-text">Сохранено.</p>{{end}}
+<form method="post" action="/settings" class="card narrow">
+  <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}}
+  <label class="check"><input type="checkbox" name="notify_success" value="1" {{if .NotifySuccess}}checked{{end}}> Сообщать и об успешных бэкапах</label>
+  <label class="check"><input type="checkbox" name="test" value="1"> Отправить тестовое уведомление после сохранения</label>
+  <p class="hint">Ошибки бэкапа и отсутствие бэкапа дольше заданного у клиента срока приходят всегда.</p>
+  <button class="primary">Сохранить</button>
+</form>
+<p class="hint">Логин и пароль администратора меняются на сервере: <code>backupctl admin-passwd &lt;логин&gt;</code></p>
+{{end}}

internal/server/templates/token.html

@@ -0,0 +1,10 @@
+{{define "title"}}{{.Title}} — backup-master{{end}}
+{{define "content"}}
+<h1>{{.Title}}</h1>
+<p>{{.Note}}</p>
+<div class="cmd">
+  <pre id="cmd">{{.Cmd}}</pre>
+  <button type="button" onclick="navigator.clipboard.writeText(document.getElementById('cmd').textContent).then(()=>{this.textContent='Скопировано'})">Копировать</button>
+</div>
+<p><a href="/clients/{{.Client.ID}}">← к клиенту {{.Client.Domain}}</a></p>
+{{end}}