MySQL 备份（backup）

功能与前置要求

• 使用 mysqldump（--single-transaction + routines / triggers / events）导出 SQL 文件，支持 gzip 压缩与网络压缩传输。
• 必须在运行 Qidun 的机器上安装 MySQL 客户端（mysqldump 位于 PATH 中），否则备份会失败。
• 备份实例来自 MySQL 监控中登记的实例。
• 产物路径：<数据目录>/mysql-backups/<实例名>/<库名>-时间戳.sql[.gz]。

公共备份配置

「备份设置」面板配置全局默认（未做实例级覆盖时全部生效）：

字段	默认	说明
自动备份	停用	总开关；启用后按备份时间每日触发
每日备份时间	03:00	错峰时刻
保留份数	7	超限自动删除最旧备份（文件 + 记录）
gzip 压缩	压缩	备份文件 .sql.gz
压缩传输	压缩	mysqldump 客户端-服务器 --compress（低带宽收益大）

实例级覆盖

「实例备份」表格中每个实例可单独设置：自动备份开关（行内下拉直接切换）、备份时间、保留份数、gzip 与压缩传输（每项均可选「默认(公共)」）。点击配置按钮在弹窗中修改。

手动备份 / 取消 / 查看记录

操作	行为
立即备份	实例行操作；提示「备份已开始」，3 秒后自动刷新状态
取消备份	备份进行中显示；确认后中止本次任务
状态列	5 秒轮询实时显示「备份中 X分Y秒 · 已写 N · 增长中 / 无进展」；疑似卡死 时红色显示「自动中止中…」
查看	备份记录行操作；弹窗显示完整信息 + 内容预览（开头 4096 字节），可快速确认备份有效性

「备份记录」列出最近 20 条：时间 / 实例 / 库 / 大小 / 状态（成功绿 / 失败红）/ 文件位置 / 详情（失败原因）。更多历史在「系统日志 → MySQL 备份」。

恢复方法

恢复（在服务器上执行；gzip 包先解压） 面板不提供在线恢复按钮（避免误操作覆盖生产库）；备份文件位置在记录与弹窗中给出完整路径，按需拷贝或就地恢复。

安全与可靠性机制

• 密码不进命令行：mysqldump 凭据写入临时 defaults-extra-file，进程列表不可见。
• 卡死自动中止：60 秒无数据产出判定卡死，自动中止并 critical 告警（可配 15–1440 分钟总超时）。
• 原子写：先写 .tmp 再改名，避免半截文件被当作有效备份；空产物自动删除。
• 备份成功 info / 失败 critical 告警，全部写入审计与备份记录。