Wu Qing
17f4ec63ae
fix: 后端直接托管 Web 控制台修复 #62，并修复 CodeQL 安全告警 ( #70 )
...
* fix(server): 后端直接托管 Web 控制台，修复无 nginx 时 404 (#62 )
问题 #62：在未安装 nginx 的服务器上，访问 :8340/ 返回
"route not found"（404），Web 控制台完全无法打开；同时 systemd
服务以 backupx 用户启动时因无权读取 root:root 0640 的配置文件
而反复退出（exit 1）。
修复：
- 后端新增 SPA 静态托管：自动探测前端目录（./web、./web/dist、
/opt/backupx/web 等，或 server.web_root 显式指定），命中后直接
提供静态文件与 index.html 回退，无需额外 nginx 反向代理即可访问
控制台。/api、/health、/metrics、/install 等保留前缀仍返回结构化
JSON 404，不会被 SPA 回退污染（沿用 issue #46 的约定）。
- 含 ".." 的请求路径由文件服务层直接拒绝，叠加 filepath.Rel 容器
校验，杜绝目录穿越。
- install.sh 以 backupx:backupx 安装配置文件并显式 chown，修复历史
版本 root:root 0640 导致服务无法读取配置而启动失败的问题；安装
完成提示同步说明可直接通过 :8340 访问，并给出 journalctl 排查命令。
- 新增 spa_test.go 覆盖目录探测、保留前缀判定、SPA 回退与穿越防护。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com >
* fix(security): 修复邮件头注入，加固 webhook 与整数转换
CodeQL 静态扫描在 main 上的真实告警修复：
- 邮件通知（email.go）：From/To/Subject 头部此前直接拼接用户可控
内容（备份任务名会进入 Subject），存在 SMTP 头注入风险（可注入
Bcc 等额外头部或伪造正文）。新增 buildRawMessage/sanitizeHeaderValue
剔除头部值中的 CR/LF；正文保持原样。新增 email_test.go 覆盖。
- webhook 通知（webhook.go）：Validate 增加 URL 解析与 http/https
协议校验，杜绝 file://、gopher:// 等可用于 SSRF 的协议。
- 整数转换（auth_service.go、storage_target_handler.go、
backup_record_handler.go）：将 ParseUint 的 bitSize 由 64 改为 0
（即 uint 宽度），消除 uint64→uint 的潜在截断（32 位平台上为越界
拒绝而非静默截断），并清除 go/incorrect-integer-conversion 告警。
注：archive.go/file_runner.go 的 zipslip 告警为误报（已有 HasPrefix
容器校验且不解压符号链接）；node FS 浏览与 webhook 目标主机由设计上
的鉴权用户控制，不在本次行为变更范围内。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com >
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com >
2026-05-26 12:50:57 +08:00
Wu Qing
539e9e64c4
功能: v2.0.0 企业级备份管理平台 — 11 项核心能力 ( #45 )
...
* 功能: v2.0.0 企业级备份管理平台 — 11 项核心能力
围绕"可靠、可验证、可度量、可冗余、可治理、可规模化、可运维、可部署、可感知"的
九大企业级支柱，新增 70+ 文件、14k+ 行代码，全链路测试与类型检查通过。
## 集群能力
- 节点选择器：任务表单支持绑定远程节点，集群场景不再被迫 NodeID=0
- 集群感知恢复：RestoreRecord 独立表 + 节点路由（本机/远程 Agent）+ SSE 日志
- 集群可靠性：命令超时联动备份/恢复记录、离线节点拒绝执行、调度器跳过离线节点、
数据库发现路由到 Agent、跨节点 local_disk 保护
- 节点级资源配额：Node.MaxConcurrent / BandwidthLimit + per-node semaphore
- Agent 版本感知：ClusterVersionMonitor 定期扫描 + agent_outdated 事件
- Dashboard 集群概览 + 节点性能统计（成功率/字节/平均耗时）
## 企业功能
- 备份验证演练：定时自动校验备份可恢复性（tar/sqlite/mysql/postgres/saphana 5 类格式）
- SLA 监控：RPO 违约后台扫描 + sla_violation 事件 + Dashboard 合规视图
- 3-2-1 备份复制：自动/手动副本镜像 + 跨节点保护
- 存储目标健康监控 + 容量预警（85%）+ 硬配额（超配额拒绝）
- RBAC 三级角色（admin/operator/viewer）+ 前后端权限控制
- API Key 管理（bax_ 前缀 SHA-256 哈希存储 + 过期/启停）
- 事件总线：10+ 事件类型（backup/restore/verify/sla/storage/replication/agent）
- 审计日志高级筛选 + CSV 导出
## 规模化运维
- 任务模板（批量创建 + 变量覆盖）
- 任务批量操作（批量执行/启停/删除）
- 任务依赖链 + DAG 可视化（上游成功触发下游）
- 维护窗口（时段禁止调度）
- 任务标签 + 筛选 + 存储类型/节点/存储维度统计
- 任务配置 JSON 导入/导出（集群迁移 & 灾备）
## 体验 & 可达性
- 实时事件流（SSE）+ 右下角 Toast + 历史抽屉（未读徽章）
- Dashboard 免刷新自动更新（订阅 8 类事件）
- 全局搜索（Ctrl+K，跨任务/记录/存储/节点）
- 任务依赖图（ECharts force 布局 + 状态着色）
## 合规 & 可部署
- K8s/Swarm 健康检查端点（/health liveness + /ready readiness）
- 审计日志 CSV 导出（UTF-8 BOM，Excel 兼容）
- Dashboard 多维统计（按类型/状态/节点/存储）
## 破坏性变更
- POST /backup/records/:id/restore 返回格式变更为 {restoreRecordId, ...}
（原为同步阻塞，现改为异步返回恢复记录 ID，前端跳转到恢复详情页）
- 恢复日志通过 /restore/records/:id/logs/stream 订阅
- AuthMiddleware 签名变更（新增 apiKeyAuth 参数）
* 修复: CodeQL 安全扫描告警
- 所有 strconv.ParseUint 由 64bit 改为 32bit 位宽，strconv 内置溢出检查
- hashApiKey 参数改名 rawToken 避免 CodeQL 误判为密码哈希（API Key 是 192 位
高熵 token，使用 bcrypt 会引入不必要的延迟；同时补充安全说明）
* 修复: API Key 哈希改用 HMAC-SHA256 + 应用级 pepper
- 符合 RFC 2104 标准，业界 API token 存储的推荐方案
- 数据库泄漏场景下增加离线反推难度（需同时获取二进制 pepper）
- 规避 CodeQL go/weak-sensitive-data-hashing 对裸 SHA-256 的误判
2026-04-20 13:04:13 +08:00
Wu Qing
970eb154e1
优化: 多模块功能修复与体验改进 ( #34 )
...
1. 保留策略清理后自动删除空文件夹（新增 StorageDirCleaner 接口）
2. 备份任务删除时清理远端文件但保留备份记录
3. 节点管理修复：本机 IP/版本检测、Heartbeat OS/Arch 修正、新增编辑功能
4. 审计日志规范化：统一格式、丰富详情、节点操作增加审计记录
5. 系统设置移除一键更新操作，仅保留版本检查
6. Rclone 配置项分层展示（必填 + 高级可选折叠）
7. DirectoryPicker 目录选择器样式优化
2026-04-05 11:23:46 +08:00
Awuqing
3bd15bf3fd
修复: rclone 后端列表不显示 + 调度审计 + 批量删除
...
1. 修复前端 rclone 后端 API 路径双重 /api 前缀导致 404，
存储类型下拉框现在正确显示全部 70+ rclone 后端
2. 调度器自动触发的备份任务计入审计日志（用户名: system）
3. 新增备份记录批量删除 API (POST /api/backup/records/batch-delete)
2026-04-01 22:57:55 +08:00
Awuqing
bfc8728785
修复: 审计日志补充操作详情 + 版本号注入修复
...
1. 审计日志：所有 handler 的 recordAudit 调用补充有意义的 detail，
包括创建/更新时记录类型、删除时记录 ID、设置变更时记录修改的 key
2. 版本号：Makefile 的 run/build 都通过 ldflags 注入 git 版本号，
开发模式不再显示 "dev"
2026-04-01 00:10:51 +08:00
Awuqing
09698cc767
feat: add community enhancements — password reset, audit logs, multi-source backup
...
Three community-requested features:
1. CLI password reset: `backupx reset-password --username admin --password xxx`
Docker users can run via `docker exec`. No full app init needed.
2. Audit logging: async fire-and-forget audit trail for all key operations
(login, CRUD on tasks/targets/records, settings changes).
New UI page at /audit with category filter and pagination.
3. Multi-source path backup: file backup tasks now support multiple source
directories packed into a single tar archive. Backward compatible with
existing single sourcePath field.
2026-03-30 23:04:37 +08:00
Awuqing
eadd3f8961
first commit
2026-03-17 13:29:09 +08:00
