禅道 Windows 20.6 迁移到 Linux 详细步骤(使用相同版本即可)

---

1. 备份 Windows 服务器数据

（1）备份上传文件

• 路径：C:\xampp\zentao\www\data\upload\1
• 操作：
  1. 右键 1 目录，选择 “发送到” → “压缩(zipped) 文件夹”。
  2. 生成 1.zip，保存到 C:\xampp\zentao\www\data\upload\1.zip。

---

（2）备份数据库

方法 1：使用 Navicat

1. 连接 Windows MySQL，选择 zentao 数据库。
2. 右键 导出 SQL 文件，确保 包含表结构和数据。
3. 保存为 zentao.sql。

方法 2：使用 MySQL Workbench

1. 连接 zentao 数据库，选择 Data Export 选项。
2. 选择 zentao，勾选 表结构和数据，导出 SQL 文件。

---

2. 上传备份文件到 Linux

（1）上传 1.zip 和 zentao.sql

• 使用 WinSCP 或其他 SFTP 工具，将以下文件上传到 Linux /opt/ 目录：
  • C:\xampp\zentao\www\data\upload\1.zip
  • zentao.sql

---

3. 在 Linux 服务器安装禅道

（1）下载 Linux 版禅道

官网只提供一个最新链接,按照我给的链接替换就可以下载linux版本( https://www.zentao.net/dl/zentao/版本号/ZenTaoPMS-版本号-zbox_amd64.tar.gz)

cd /opt
wget https://www.zentao.net/dl/zentao/20.6/ZenTaoPMS-20.6-zbox_amd64.tar.gz

（2）解压

tar -zxvf ZenTaoPMS-20.6-zbox_amd64.tar.gz

• 解压后，禅道目录位于 /opt/zbox/。

---

4. 还原 Windows 数据

（1）移动 1.zip 文件到正确位置

• 解压 Linux 版禅道后执行

mv /opt/1.zip /opt/zbox/app/zentao/www/upload/

（2）解压 1.zip

cd /opt/zbox/app/zentao/www/upload/
unzip 1.zip

• 确保 1 目录正确解压到 /opt/zbox/app/zentao/www/upload/1。

（3）设置文件权限

chmod -R 755 /opt/zbox/app/zentao/www/upload

---

5. 数据库操作

（1）创建 MySQL 用户

/opt/zbox/auth/adduser.sh

输入账号/密码

账号: root
密码: 123456

（2）导入数据库

/opt/zbox/bin/mysql -u root -P 3306 -p zentao < /opt/zentao.sql

---

6. 启动、停止和重启禅道

（1）启动禅道（Apache + MySQL）

/opt/zbox/zbox start

（2）停止禅道

/opt/zbox/zbox stop

（3）重启禅道

/opt/zbox/zbox restart

---

7. 访问禅道

（1）检查是否启动

ps -ef | grep zbox

（2）浏览器访问

http://your-linux-server-ip:80

如果正常显示登录页面，迁移成功！🎯

---

8. 设置开机自启动

（1）创建 systemd 服务

nano /etc/systemd/system/zentao.service

添加以下内容：

[Unit]
Description=ZenTao Service
After=network.target

[Service]
ExecStart=/opt/zbox/zbox start
ExecStop=/opt/zbox/zbox stop
Restart=always
User=root
WorkingDirectory=/opt/zbox

[Install]
WantedBy=multi-user.target

（2）启用服务

systemctl daemon-reload
systemctl enable zentao

（3）验证是否生效

systemctl start zentao
systemctl status zentao

这样，禅道将在服务器开机时自动启动！🚀

在 Linux 服务器上，修改禅道 CSRF 过滤配置，需要编辑 my.conf 文件，并添加 filterCSRF = false 选项。

---

nginx代理https无法登录解决步骤

1. 打开 my.conf 配置文件

nano /opt/zbox/app/zentao/config/my.conf

2. 添加/修改 CSRF 配置

在文件末尾或适当位置添加：

$config->framework->filterCSRF = false;

3. 保存并退出

按 Ctrl + X，然后按 Y，最后回车。

4. 重启禅道

/opt/zbox/zbox restart

---

验证

1. 访问禅道网页：

   http://your-linux-server-ip
   

2. 检查 CSRF 相关问题是否已解决。

这样，你已成功关闭禅道的 CSRF 保护。🚀