Files
mrleeandDevin 9d75fb1d3e
CI / verify (push) Canceled after 0s
fix: 收敛正确性缺口并补齐质量门禁
备份、隧道生命周期、日志、会话与设置项存在一批「静默失效」问题,本次一并收敛。

正确性:
- 备份归档补上 session_secret 与 frp 配置。缺密钥时换机恢复后库里所有凭据都解不开,
  界面表现为「配置都在、一执行就报解密失败」;同时支持口令加密(scrypt + AES-256-GCM)。
- 修复「立即备份」必失败:tar 头用的是遍历时的文件尺寸,而 logs、frpc 配置在打包期间
  还在增长,读出的字节多于声明值导致 archive/tar 报错、整份备份作废。改为打开后重新
  取尺寸并用 LimitReader 兜住,被截短时补零保持条目结构完整。
- 数据库改用 VACUUM INTO 生成一致性快照。直接打包正在写入的 SQLite 文件可能得到
  结构完整但内容自相矛盾的副本,恢复后才暴露。
- Cloudflare 启动改用 StartAuto,Shutdown 显式 StopAll,子进程绑定应用 ctx。此前
  重启会把用户手动停掉的隧道重新拉起,退出也可能留下孤儿进程。
- Nginx 访问/错误日志加轮转(200MB 阈值、gzip 归档、USR1 重开),读取改为从文件尾
  分块倒读,并跨当日归档统计。此前日志只增不减,读接口每次全量扫描。
- 过期会话改由日任务清理;删除反代规则时同步清掉流量累计,避免同名规则重建继承旧读数。
- 启动加就绪门:Nginx bootstrap 完成后再放行 FRP 对账、Agent 隧道与 Cloudflare 自启。

设置项:
- 新增设置项注册表(internal/settings/registry.go),白名单与默认值从它派生,
  并记录每个键的消费者,防止再出现「界面能改、后端没人读」的黑洞设置。
- 接上三个此前不生效的设置项:timezone(启动与保存时应用到 time.Local)、
  theme(后端为权威源,挂载时覆盖本地偏好、顶栏切换回写)、log_retention_days
  (控制日志归档保留天数)。

工程质量:
- gofmt 全量格式化 23 个历史文件,CI 增加格式化门禁。
- 前端引入 ESLint(flat config)与 lint 脚本,CI 增加 lint 步骤;顺带修掉
  logDisplay 的 let→const 与 LogsView 模板内直接改 prop 两处问题。
- 删除无引用的 pnpm-lock.yaml,prototype/ 加入忽略列表。
- 打包版本对齐:Docker manifest 同步到 2.0.0,CI 校验 VERSION 与 package.json 一致。

验证:gofmt 0 文件、go vet、go test ./...、npm run lint/typecheck/test/build 全绿。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-10-24 16:30:00 +08:00

92 lines
3.0 KiB
Go

package backup
import (
"context"
"fmt"
"log/slog"
"path/filepath"
"time"
"github.com/havline/havline/internal/notify"
"github.com/havline/havline/internal/settings"
)
// AutoInterval 自动备份间隔。scheduler 启动时会先跑一轮,靠「最新备份是否还在间隔内」
// 判断该不该备份,因此频繁重启(NAS 上很常见)不会重复备份。
const AutoInterval = 24 * time.Hour
// AutoRunner 定期导出一份归档、回读校验、再按保留份数剪枝。
type AutoRunner struct {
svc *Service
settings *settings.Store
notify *notify.Service
logger *slog.Logger
now func() time.Time
}
func NewAutoRunner(svc *Service, settingsStore *settings.Store, notifySvc *notify.Service, logger *slog.Logger) *AutoRunner {
if logger == nil {
logger = slog.Default()
}
return &AutoRunner{svc: svc, settings: settingsStore, notify: notifySvc, logger: logger, now: time.Now}
}
// Run 跑一轮。失败只通知、不返回错误:scheduler 的任务没有重试机制,通知才是可见性来源。
func (r *AutoRunner) Run(ctx context.Context) {
if r == nil || r.svc == nil || r.settings == nil {
return
}
enabled, err := r.settings.GetBool(ctx, settings.KeyBackupAutoEnabled)
if err != nil || !enabled {
return
}
archives, err := r.svc.List()
if err != nil {
r.logger.Warn("读取备份列表失败", "module", "BACKUP", "error", err.Error())
return
}
if len(archives) > 0 && !dueForBackup(archives[0].ModTime, r.now(), AutoInterval) {
return
}
// 自动备份不加密:口令没法安全地存在同一台设备上(存了就等于没加密),
// 需要加密归档的用户走「立即备份 / 立即下载」手动流程。
path, err := r.svc.Export(ctx)
if err != nil {
r.fail(ctx, fmt.Sprintf("导出备份失败:%s", err.Error()))
return
}
entries, err := r.svc.Verify(ctx, path)
if err != nil {
// 校验不过的归档不算一份可用备份:删掉并如实告警,别让用户以为已经有备份
if removeErr := r.svc.Remove(filepath.Base(path)); removeErr != nil {
r.logger.Warn("删除校验失败的备份失败", "module", "BACKUP", "error", removeErr.Error())
}
r.fail(ctx, fmt.Sprintf("备份校验失败:%s", err.Error()))
return
}
removed, err := r.svc.Prune(KeepCount(ctx, r.settings))
if err != nil {
r.logger.Warn("剪枝旧备份失败", "module", "BACKUP", "error", err.Error())
}
r.logger.Info("自动备份完成", "module", "BACKUP",
"file", filepath.Base(path), "entries", entries, "removed", removed)
}
// dueForBackup 判断该不该做一次备份:没有备份,或最新一份已超过间隔。
func dueForBackup(newest, now time.Time, interval time.Duration) bool {
if newest.IsZero() {
return true
}
return now.Sub(newest) >= interval
}
func (r *AutoRunner) fail(ctx context.Context, message string) {
r.logger.Error("自动备份失败", "module", "BACKUP", "error", message)
if r.notify != nil {
r.notify.Alert(ctx, notify.EventBackupFailure, "自动备份失败", message)
}
}