数据备份管理平台

• 服务端插件化，客户端零安装：所有驱动/插件/工具只装在平台服务端；用户客户端机器与被管理的数据库服务器什么都不安装、无需任何 Agent。
• 完全离线运行：所有依赖随平台包自带（JDBC 驱动、JRE、原生驱动、备份工具离线包），运行时零联网。部署后运行 python scripts/check_offline.py 自检。
• 真实执行，如实失败：所有备份/恢复/同步均为真实操作，连接失败或依赖缺失时任务如实失败并给出明确原因与修复指引，不做任何仿真兜底。
• 迁移前预校验：类型映射矩阵、数据级试写、字符集冲突、容量预估、主键/外键检查——结构或数据不合适在启动前拦截。

# 1. 初始化元数据数据库
python init_db.py

# 2. 启动平台（同时启动后台调度器）
python run.py

浏览器访问 http://<服务器IP>:8080，默认账号 admin / admin123（请立即修改）。

备份任务执行前，请先在「系统设置 → SSH 主机」纳管数据库服务器（或使用任务级 SSH 凭据）。

平台面向完全离线环境设计：运行时不安装任何东西，一切依赖随离线包自带。

1. 构建离线包：PyInstaller 打包（Python 依赖全内置）+ drivers/（JDBC 驱动 jar）+ jdk/（JRE，达梦/Oracle JDBC 通道必需）+ 备份工具离线包。
2. 部署后自检：python scripts/check_offline.py —— 五层检查（Python 依赖 / JDBC jar / JVM / dmPython / 外部工具），缺失项给出处置指引。
3. 备份工具：仅支持离线包上传安装（备份插件页 SFTP 上传），不依赖在线源。

平台提供 REST API 供外部系统调用，认证方式为 Bearer Token。

登录 Web 页面 → 浏览器控制台（F12）执行：

fetch("/api/tokens", {
  method: "POST",
  headers: {"Content-Type": "application/json"},
  body: JSON.stringify({name: "外部监控系统"})
}).then(r => r.json()).then(d => console.log(d.token));

返回的 token（bk_ 前缀）明文仅此一次展示，平台仅存哈希。

TOKEN="bk_xxxxxxxx"

# 列出备份任务
curl -s -H "Authorization: Bearer $TOKEN" http://<服务器IP>:8080/api/tasks

# 立即执行一次全量备份
curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{"backup_type":"full"}' \
  http://<服务器IP>:8080/api/tasks/22/run

# 查询最近备份记录
curl -s -H "Authorization: Bearer $TOKEN" \
  "http://<服务器IP>:8080/api/records?limit=10"

# 触发巡检
curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  http://<服务器IP>:8080/api/inspection/run

# 数据同步任务迁移前预校验
curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  http://<服务器IP>:8080/api/sync-tasks/9/precheck

# 数据迁移（预检查 → 结构 → 全量 → 校验 一站式）
curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{"plan_id":1}' \
  http://<服务器IP>:8080/api/migration/run

docker pull ghcr.io/zhh9126/backup-platform:latest
docker pull ghcr.io/zhh9126/backup-platform:v1.3.3   # 固定版本（可回滚）

// /etc/docker/daemon.json
{"registry-mirrors": ["https://docker.m.daocloud.io", "https://dockerproxy.com"]}

# 有网机器导出
docker save ghcr.io/zhh9126/backup-platform:v1.3.3 -o backup-platform.tar
# 内网机器导入
docker load -i backup-platform.tar

docker run -d --name backup-platform \
  -p 8080:8080 \
  -v backup-data:/app/instance \
  -v backup-files:/app/backups \
  --restart unless-stopped \
  ghcr.io/zhh9126/backup-platform:latest

services:
  backup-platform:
    image: ghcr.io/zhh9126/backup-platform:latest
    ports: ["8080:8080"]
    volumes:
      - ./instance:/app/instance
      - ./backups:/app/backups
    restart: unless-stopped

docker build -t backup-platform:local .

以下工具装在数据库服务器上即可（数据库自带），平台经 SSH 远程执行并动态发现工具路径；平台机自身装有客户端时也可本机执行（零安装回退）。

数据迁移/同步连接通道：原生 Python 驱动优先（pymysql / psycopg2 / oracledb thin），JDBC 兜底（驱动 jar 随包，达梦/金仓/Oracle 全覆盖）。

• 概览：仪表盘（任务数、累计备份体积、成功失败统计）
• 备份管理：数据库备份、文件备份、存储管理（三级存储 + 合成全量）、保护策略、备份插件
• 记录：备份记录、恢复记录、恢复校验
• 数据恢复管理：数据恢复、数据库部署
• 灾备管理：数据迁移、数据同步、数据对比、容灾链路、克隆服务、恢复演练
• 实时管控：实时管控时间线（RT / CDP / PITR）
• 运维：巡检、智能告警、数据价值挖掘、智能体、系统设置

典型操作：

1. 数据库备份：在「数据库备份」新建任务，填写连接、备份类型、调度、保留策略与存储目标。
2. 文件备份：在「文件备份」先纳管远程主机，再建文件任务；全量生成 *_full.tar.gz，增量基于源快照仅打包变化文件。
3. 数据同步：新建同步任务（源/目标连接 + 表 + 字段映射 + 写入模式 + 同步模式），运行前自动执行迁移前预校验，也可点「预检」单独查看报告。
4. 数据对比：在「数据对比」新建对比任务（源/目标连接 + 表清单，支持跨名映射），报告逐行展示差异定位与修复指引。
5. 数据库部署：在「数据库部署」上传安装包，选择目标主机一键部署，实时查看安装日志。
6. 克隆服务：选择备份记录一键克隆（免审批直通），就绪后展示连接串，到期自动销毁。
7. 恢复校验：配置策略定期对最近成功备份做可恢复性校验，查看报告与成功率 KPI。
8. 巡检：点击"立即巡检"或配置定时巡检，查看 pass/warn/fail 明细。
9. AI 智能体：对话式助手支持查询任务/记录/存储用量、执行备份/巡检（需确认）、知识库问答。

• 使用 gunicorn 运行：gunicorn -w 2 -b 0.0.0.0:8080 run:app
• 元数据 SQLite 建议定期备份（instance/meta.db）
• 备份产物目录与数据库服务器网络隔离，配置三级存储异地容灾
• 离线环境部署完成后首先运行 python scripts/check_offline.py 自检

• 密码 AES 加密存储（元数据库中不含明文）
• 备份密码通过临时选项文件 / 环境变量注入，不出现在命令行（防 ps 泄露）
• API Token 仅存哈希；会话 Cookie HttpOnly
• 默认账号请立即修改；生产环境建议限制来源 IP

MIT（社区版免费供个人学习、内部部署与中小规模生产环境使用。企业级增强请联系作者：📧 1547358466@qq.com）