禅道数据备份有五种方法：一、后台一键备份数据库与附件元数据；二、停服务后整目录打包；三、分离备份数据库、附件及配置文件并校验；四、Web后台配置定时自动备份；五、Docker环境下分别备份数据卷、数据库和镜像。
如果您正在使用禅道项目管理软件，为防止数据丢失或系统异常导致业务中断，定期执行数据备份是关键操作。以下是多种可靠、可验证的禅道系统数据备份方法：
一、通过禅道后台界面一键备份
该方式无需接触服务器文件系统或数据库命令，适合管理员日常快速执行，备份内容包含数据库快照与附件元数据，生成的压缩包可直接用于后续还原。
1、使用管理员账号登录禅道系统。
2、点击左下角后台进入系统管理区域。
3、依次点击数据 → 备份，进入备份页面。
4、点击立即备份按钮，等待页面提示“备份成功”及生成的备份文件名（如 zentao_20260406_152231.sql.gz）。
5、备份文件默认保存在禅道安装目录下的 tmp/backup/ 子目录中，建议立即将该文件下载至本地安全位置。
二、停止服务后整目录打包备份（适用于一键安装包）
此方法确保文件一致性，避免因服务运行导致附件或数据库文件被写入锁定，适用于 Windows XAMPP 或 Linux ZBOX 等集成环境，备份结果为完整可迁移副本。
1、在 Windows 环境下：打开 XAMPP 控制面板，依次点击Apache 和 MySQL 对应的 Stop 按钮，确认服务已停止；关闭面板程序。
2、在 Linux 环境下：执行命令 sudo /opt/zbox/zbox stop，确认无 zbox 进程残留。
3、Windows 用户复制整个 xampp 目录（含 zentao 子目录）。
4、Linux 用户执行：sudo cp -prf /opt/zbox /opt/zbox_bak，完成全量目录备份。
5、备份完成后，可重新启动服务：sudo /opt/zbox/zbox start（Linux）或重启 XAMPP 面板（Windows）。
三、分离备份数据库与附件（手工精细备份）
该方案将数据库与文件系统解耦，便于差异化存储、加密或异地归档，适用于对备份粒度和安全性有更高要求的运维场景。
1、备份数据库：执行 mysqldump 命令导出 SQL 文件，例如：mysqldump -u root -p zentao > /backup/zentao_$(date +%Y%m%d).sql。
2、备份附件目录：Linux 下执行 sudo cp -prf /opt/zbox/app/zentao/www/data/upload /backup/upload_$(date +%Y%m%d)；Windows 下复制 xampp/htdocs/zentao/www/data/upload 全目录。
3、备份配置与自定义代码：同步复制 zentao/config/my.php 及 zentao/www/extension/（如有插件）等关键路径。
4、为所有备份文件添加时间戳并校验 md5 值，例如：md5sum /backup/zentao_20260406.sql，记录校验码供还原时比对。
四、启用定时自动备份（后台计划任务）
禅道 10.6 及以上版本支持在 Web 后台配置周期性自动备份，免除人工干预，保障备份策略持续生效，适用于生产环境常态化防护。
1、管理员登录后，进入后台 → 系统 → 定时页面。
2、点击新建任务，类型选择数据备份。
3、设置执行时间（如每天凌晨 2:00）、备份频率（每日/每周）、保留份数（建议至少保留 7 份）。
4、勾选同时备份附件选项，确保上传文件不遗漏。
5、保存后观察任务状态栏，确认首次执行成功并生成对应备份记录于后台 → 数据 → 备份列表中。
五、Docker 环境下的备份策略
针对容器化部署的禅道实例，需分别处理镜像层、卷挂载数据与外部数据库，避免仅备份容器而丢失持久化内容，确保恢复时环境可重现。
1、确认数据卷挂载路径，典型为 /data/zentao/data，执行 tar -czf zentao-data-$(date +%Y%m%d).tar.gz -C /data/zentao/ data。
2、若使用独立 MySQL 容器，进入其容器执行 mysqldump -u root -p zentao > /backup/zentao.sql，再将文件拷出宿主机。
3、备份当前运行镜像：执行 docker commit zentao zentao-custom:20260406，随后 docker save zentao-custom:20260406 > zentao-image-20260406.tar。
4、将上述三个备份文件（data tar、SQL、image tar）统一归档，并标注部署版本与构建时间。
