mirror of
https://github.com/Awuqing/BackupX.git
synced 2026-05-06 20:02:41 +08:00
* 功能: 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 的误判
202 lines
6.0 KiB
Go
202 lines
6.0 KiB
Go
package http
|
||
|
||
import (
|
||
"fmt"
|
||
|
||
"backupx/server/internal/apperror"
|
||
"backupx/server/internal/service"
|
||
"backupx/server/pkg/response"
|
||
"github.com/gin-gonic/gin"
|
||
)
|
||
|
||
type BackupTaskHandler struct {
|
||
service *service.BackupTaskService
|
||
auditService *service.AuditService
|
||
}
|
||
|
||
// describeTaskInput 提取审计日志中通用的调度和存储目标描述。
|
||
func describeTaskInput(input service.BackupTaskUpsertInput) (cronDesc string, storageCount int) {
|
||
cronDesc = "仅手动执行"
|
||
if input.CronExpr != "" {
|
||
cronDesc = input.CronExpr
|
||
}
|
||
storageCount = len(input.StorageTargetIDs)
|
||
if storageCount == 0 && input.StorageTargetID > 0 {
|
||
storageCount = 1
|
||
}
|
||
return
|
||
}
|
||
|
||
func NewBackupTaskHandler(taskService *service.BackupTaskService, auditService *service.AuditService) *BackupTaskHandler {
|
||
return &BackupTaskHandler{service: taskService, auditService: auditService}
|
||
}
|
||
|
||
func (h *BackupTaskHandler) List(c *gin.Context) {
|
||
items, err := h.service.List(c.Request.Context())
|
||
if err != nil {
|
||
response.Error(c, err)
|
||
return
|
||
}
|
||
response.Success(c, items)
|
||
}
|
||
|
||
// ListTags 返回系统内所有任务用过的唯一标签列表,供前端标签选择器的建议词。
|
||
func (h *BackupTaskHandler) ListTags(c *gin.Context) {
|
||
tags, err := h.service.ListTags(c.Request.Context())
|
||
if err != nil {
|
||
response.Error(c, err)
|
||
return
|
||
}
|
||
response.Success(c, tags)
|
||
}
|
||
|
||
func (h *BackupTaskHandler) Get(c *gin.Context) {
|
||
id, ok := parseUintParam(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
item, err := h.service.Get(c.Request.Context(), id)
|
||
if err != nil {
|
||
response.Error(c, err)
|
||
return
|
||
}
|
||
response.Success(c, item)
|
||
}
|
||
|
||
func (h *BackupTaskHandler) Create(c *gin.Context) {
|
||
var input service.BackupTaskUpsertInput
|
||
if err := c.ShouldBindJSON(&input); err != nil {
|
||
response.Error(c, apperror.BadRequest("BACKUP_TASK_INVALID", "备份任务参数不合法", err))
|
||
return
|
||
}
|
||
item, err := h.service.Create(c.Request.Context(), input)
|
||
if err != nil {
|
||
response.Error(c, err)
|
||
return
|
||
}
|
||
cronDesc, storageCount := describeTaskInput(input)
|
||
recordAudit(c, h.auditService, "backup_task", "create", "backup_task", fmt.Sprintf("%d", item.ID), item.Name,
|
||
fmt.Sprintf("创建备份任务「%s」,类型: %s, 调度: %s, 存储: %d 个目标", item.Name, input.Type, cronDesc, storageCount))
|
||
response.Success(c, item)
|
||
}
|
||
|
||
func (h *BackupTaskHandler) Update(c *gin.Context) {
|
||
id, ok := parseUintParam(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
var input service.BackupTaskUpsertInput
|
||
if err := c.ShouldBindJSON(&input); err != nil {
|
||
response.Error(c, apperror.BadRequest("BACKUP_TASK_INVALID", "备份任务参数不合法", err))
|
||
return
|
||
}
|
||
item, err := h.service.Update(c.Request.Context(), id, input)
|
||
if err != nil {
|
||
response.Error(c, err)
|
||
return
|
||
}
|
||
updCronDesc, updStorageCount := describeTaskInput(input)
|
||
recordAudit(c, h.auditService, "backup_task", "update", "backup_task", fmt.Sprintf("%d", item.ID), item.Name,
|
||
fmt.Sprintf("更新备份任务「%s」,类型: %s, 调度: %s, 存储: %d 个目标", item.Name, input.Type, updCronDesc, updStorageCount))
|
||
response.Success(c, item)
|
||
}
|
||
|
||
func (h *BackupTaskHandler) Delete(c *gin.Context) {
|
||
id, ok := parseUintParam(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
result, err := h.service.Delete(c.Request.Context(), id)
|
||
if err != nil {
|
||
response.Error(c, err)
|
||
return
|
||
}
|
||
recordAudit(c, h.auditService, "backup_task", "delete", "backup_task", fmt.Sprintf("%d", id), result.TaskName,
|
||
fmt.Sprintf("删除备份任务「%s」(ID: %d),关联记录 %d 条,已清理远端文件 %d 个", result.TaskName, id, result.RecordCount, result.CleanedFiles))
|
||
response.Success(c, gin.H{"deleted": true})
|
||
}
|
||
|
||
// BatchToggle / BatchDelete 批量操作。
|
||
// Body: {"ids": [1,2,3], "enabled": true} (enabled 仅 toggle 用)
|
||
func (h *BackupTaskHandler) BatchToggle(c *gin.Context) {
|
||
var input struct {
|
||
IDs []uint `json:"ids" binding:"required,min=1"`
|
||
Enabled bool `json:"enabled"`
|
||
}
|
||
if err := c.ShouldBindJSON(&input); err != nil {
|
||
response.Error(c, apperror.BadRequest("BACKUP_TASK_BATCH_INVALID", "批量操作参数不合法", err))
|
||
return
|
||
}
|
||
results := h.service.BatchToggle(c.Request.Context(), input.IDs, input.Enabled)
|
||
succ := 0
|
||
for _, r := range results {
|
||
if r.Success {
|
||
succ++
|
||
}
|
||
}
|
||
action := "batch_enable"
|
||
label := "启用"
|
||
if !input.Enabled {
|
||
action = "batch_disable"
|
||
label = "停用"
|
||
}
|
||
recordAudit(c, h.auditService, "backup_task", action, "backup_task", "", "",
|
||
fmt.Sprintf("批量%s %d/%d 个任务", label, succ, len(results)))
|
||
response.Success(c, results)
|
||
}
|
||
|
||
func (h *BackupTaskHandler) BatchDelete(c *gin.Context) {
|
||
var input struct {
|
||
IDs []uint `json:"ids" binding:"required,min=1"`
|
||
}
|
||
if err := c.ShouldBindJSON(&input); err != nil {
|
||
response.Error(c, apperror.BadRequest("BACKUP_TASK_BATCH_INVALID", "批量删除参数不合法", err))
|
||
return
|
||
}
|
||
results := h.service.BatchDeleteTasks(c.Request.Context(), input.IDs)
|
||
succ := 0
|
||
for _, r := range results {
|
||
if r.Success {
|
||
succ++
|
||
}
|
||
}
|
||
recordAudit(c, h.auditService, "backup_task", "batch_delete", "backup_task", "", "",
|
||
fmt.Sprintf("批量删除 %d/%d 个任务", succ, len(results)))
|
||
response.Success(c, results)
|
||
}
|
||
|
||
func (h *BackupTaskHandler) Toggle(c *gin.Context) {
|
||
id, ok := parseUintParam(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
var input service.BackupTaskToggleInput
|
||
if err := c.ShouldBindJSON(&input); err != nil && err.Error() != "EOF" {
|
||
response.Error(c, apperror.BadRequest("BACKUP_TASK_TOGGLE_INVALID", "备份任务启停参数不合法", err))
|
||
return
|
||
}
|
||
current, err := h.service.Get(c.Request.Context(), id)
|
||
if err != nil {
|
||
response.Error(c, err)
|
||
return
|
||
}
|
||
enabled := !current.Enabled
|
||
if input.Enabled != nil {
|
||
enabled = *input.Enabled
|
||
}
|
||
item, err := h.service.Toggle(c.Request.Context(), id, enabled)
|
||
if err != nil {
|
||
response.Error(c, err)
|
||
return
|
||
}
|
||
action := "enable"
|
||
actionLabel := "启用"
|
||
if !enabled {
|
||
action = "disable"
|
||
actionLabel = "停用"
|
||
}
|
||
recordAudit(c, h.auditService, "backup_task", action, "backup_task", fmt.Sprintf("%d", id), item.Name,
|
||
fmt.Sprintf("%s备份任务「%s」", actionLabel, item.Name))
|
||
response.Success(c, item)
|
||
}
|