1. 项目概述：为什么选择禅道，以及它能为你带来什么

如果你是一个刚刚接触项目管理，或者团队里第一次需要引入一个工具来管理任务、Bug和文档，听到“禅道”这个名字可能会觉得有点玄乎。其实，它就是一个开源的、一体化的项目管理软件，你可以把它理解为你团队工作的“数字大本营”。我最早接触禅道，也是从一个纯小白的身份开始的，当时团队从Excel表格和混乱的微信群聊切换过来，那种从无序到有序的体验，至今记忆犹新。对于小白来说，部署禅道最大的障碍往往不是软件本身有多复杂，而是面对服务器、环境这些陌生的概念时产生的畏难情绪。这篇内容，我就以一个过来人的身份，把部署禅道的每一步都掰开揉碎，确保你跟着做，一定能成功跑起来。

简单说，禅道能帮你和你的团队解决几个核心痛点：任务谁来做、做到哪一步了（项目管理），软件出了什么问题、谁在修复（Bug管理），以及需求文档、技术方案放哪里（文档管理）。它把这些功能都集成在了一起，避免了信息在不同工具间跳转的损耗。部署它，相当于给你的团队搭建了一个专属的、高度定制化的工作协同平台。整个过程，其实就像组装一个乐高模型，说明书（本文）已经非常详细，你只需要按顺序找到对应的零件（安装包、环境），然后拼接起来。放心，我们不涉及任何复杂的底层开发，纯粹是“安装-配置-使用”的流程。

2. 部署前的核心准备：理清思路与备齐“弹药”

在动手之前，花十分钟理清思路，能避免后面几个小时的无用功。部署禅道，本质上是在一台服务器（可以是云服务器、公司内网的物理机，甚至是你自己的高性能个人电脑）上，安装一个由“网页服务+数据库+编程语言环境”组成的套件。对于小白，最友好的方式就是使用禅道官方提供的“一键安装包”。这个安装包已经像是一个预配好的套餐，把需要用到的Apache（网页服务器）、PHP（编程语言环境）、MySQL（数据库）都打包好了，省去了我们单独安装和配置的麻烦，极大降低了门槛。

2.1 环境与工具准备清单

你需要准备以下几样东西，请对照检查：

1. 一台服务器/电脑：这是禅道安家的地方。

   • 最低配置：CPU 1核，内存 2GB，硬盘 20GB。这是能跑起来的最低要求，如果团队人数稍多（超过10人），建议内存提升到4GB以上。
   • 推荐：购买一台云服务器。国内常见的阿里云、腾讯云都有针对新用户的非常优惠的“轻量应用服务器”，选择Linux系统（如CentOS 7.9或Ubuntu 20.04）的镜像，一个月也就几十块钱。用云服务器的好处是稳定、有公网IP方便随时随地访问，并且配置过程全网通用。本文后续步骤将以在CentOS 7.9系统的云服务器上操作为例。
   • 备选：如果你只想在本地局域网体验，可以用一台闲置的电脑安装Linux系统来操作。

2. 禅道一键安装包：去禅道官方网站的“下载”页面，找到对应你服务器操作系统版本的安装包。例如，我们的服务器是64位的Linux，就下载“Linux 64位一键安装包”。务必下载官方版本，安全有保障。

3. 远程连接工具：因为服务器通常没有图形界面，我们需要通过命令行来操作它。

   • Windows用户：推荐使用PuTTY或Xshell（个人免费版）。
   • Mac/Linux用户：直接使用系统自带的“终端”（Terminal），通过ssh命令连接。

4. 一个顺手的文本编辑器：用于偶尔修改配置文件。比如Notepad++(Windows) 或VS Code(跨平台)。

注意：整个部署过程需要在Linux命令行下完成。别怕，我会给出每一条需要你输入的命令，你只需要复制粘贴（在PuTTY或终端里鼠标右键即为粘贴），然后按回车执行即可。遇到任何错误，优先检查命令是否抄错，包括大小写和符号。

2.2 理解部署的核心逻辑

为了让你不是机械地跟着做，这里简单说一下我们在干什么：我们通过远程工具登录到服务器，把下载好的禅道安装包上传到服务器，然后解压、执行安装脚本。这个脚本会自动安装并启动Apache、PHP、MySQL服务，同时初始化禅道所需的数据库。安装完成后，我们通过服务器的IP地址，在电脑的浏览器里就能访问禅道的登录页面了。整个过程，我们就像在服务器上运行了一个“安装向导”程序。

3. 详细部署步骤实操：从零到一的完整记录

现在，我们进入最核心的实操环节。请确保你已经拥有一台安装了CentOS 7.9（或其他Linux发行版）的服务器，并知道了它的公网IP地址和root用户密码。

3.1 第一步：远程连接服务器与基础检查

打开你的远程连接工具（这里以PuTTY为例）。

1. 在“Host Name”栏输入你的服务器公网IP地址。
2. 端口保持默认的22。
3. 连接类型选择“SSH”。
4. 点击“Open”。首次连接会弹出安全警告，点击“是”或“Accept”即可。
5. 登录用户名为root，然后输入你的root密码（输入时密码不可见，正常输入后回车）。

连接成功后，你会看到一个以[root@你的服务器主机名 ~]#结尾的命令行界面。这个#符号表示你拥有最高权限。

首先，我们更新一下系统软件包并安装一个可能用到的小工具wget（用于网络下载）：

yum update -y yum install -y wget

3.2 第二步：下载与解压禅道一键安装包

我们需要进入一个合适的目录来存放安装包，通常放在/opt目录下是个好习惯。

cd /opt

接下来，使用wget命令下载禅道安装包。你需要去官网复制最新版一键安装包的直链地址。假设我们下载的是18.0版本（请以官网最新为准）：

wget https://www.zentao.net/dl/ZenTaoPMS.18.0.zbox_64.tar.gz

下载完成后，使用tar命令解压这个压缩包：

tar -zxvf ZenTaoPMS.18.0.zbox_64.tar.gz

解压后会生成一个名为zbox的文件夹。这个文件夹就是禅道所有的运行环境。

3.3 第三步：启动禅道服务并设置开机自启

进入zbox文件夹，并启动内置的Apache和MySQL服务：

cd /opt/zbox ./zbox start

如果看到Starting Apache success和Starting MySQL success的提示，说明服务启动成功。

为了让服务器重启后禅道能自动运行，我们需要将启动命令添加到系统服务。使用以下命令：

./zbox stop ./zbox start

先停止再启动，是为了确保服务状态正确。然后，将启动命令写入系统的rc.local文件：

echo '/opt/zbox/zbox start' >> /etc/rc.d/rc.local

别忘了给这个文件加上执行权限：

chmod +x /etc/rc.d/rc.local

3.4 第四步：配置防火墙与安全组（关键！）

这是小白最容易卡住的一步。服务器本身有防火墙，云服务器还有一层“安全组”规则。两者都需要放行禅道使用的端口。

A. 禅道默认端口：

• Apache（网页访问）：80(HTTP) 和443(HTTPS)。我们先用80端口。
• MySQL数据库：3306。这个端口千万不要对公网开放，非常危险！一键安装包默认只允许本地访问。

B. 配置服务器防火墙（firewalld/CentOS 7）：

# 添加http服务到防火墙规则（默认放行80端口） firewall-cmd --permanent --add-service=http # 重载防火墙配置使其生效 firewall-cmd --reload # 查看已放行的端口，确认80端口在列表中 firewall-cmd --list-ports

C. 配置云服务器安全组（以腾讯云/阿里云为例）：这是网页端的操作。

1. 登录你的云服务器控制台。
2. 找到你的实例，进入“安全组”配置。
3. 点击“添加规则”。
4. 规则方向：入方向。
5. 协议端口：TCP:80（或填写HTTP(80)）。
6. 源IP：0.0.0.0/0（表示允许所有IP访问，仅用于测试。生产环境建议设置为公司固定IP）。
7. 策略：允许。
8. 保存。

3.5 第五步：访问禅道并完成初始化安装

在完成上述所有步骤后，打开你本地电脑的浏览器，在地址栏输入：

http://你的服务器公网IP

如果一切顺利，你将会看到禅道的安装引导页面！

1. 选择安装方式：点击“开源版”。
2. 环境检测：页面会自动检查PHP、MySQL等环境，一键安装包通常全部通过（绿色√）。
3. 数据库设置：这是关键一步。
   • 数据库账号：root
   • 数据库密码：禅道一键安装包默认的MySQL密码是123456。（务必在安装成功后修改！）
   • 数据库地址：127.0.0.1:3306（表示本机）
   • 点击“保存”。
4. 设置管理员账号：为你自己设置一个超级管理员的登录账号、密码和邮箱。请务必记住这个账号密码！
5. 安装完成：点击登录，输入刚才设置的管理员账号，即可进入禅道的主界面。恭喜你，部署成功了！

4. 部署后的关键配置与优化

安装成功只是第一步，要让禅道真正好用、安全，还需要进行一些必要的配置。

4.1 修改默认的MySQL root密码

使用一键安装包默认的密码风险极高。我们需要修改它。

# 登录到MySQL命令行，使用默认密码 /opt/zbox/bin/mysql -u root -p Enter password: 123456 # 输入时不可见，输入后回车

登录成功后，提示符会变成mysql>。执行以下命令修改密码（这里举例改为一个强密码MyNewPass123!）：

SET PASSWORD FOR 'root'@'localhost' = PASSWORD('MyNewPass123!'); FLUSH PRIVILEGES; exit;

重要：修改后，需要同步修改禅道配置文件中的数据库连接密码。编辑配置文件：

vi /opt/zbox/app/zentao/config/my.php

找到$config->db->password这一行，将其值修改为你刚刚设置的新密码MyNewPass123!，然后保存退出（按Esc，输入:wq，回车）。最后重启禅道服务使配置生效：

cd /opt/zbox ./zbox restart

4.2 配置域名访问与HTTPS（可选但推荐）

长期使用IP访问不便于记忆，也不专业。如果你有域名，可以将其解析到服务器IP，然后在禅道中配置。

1. 域名解析：在你的域名服务商后台，添加一条A记录，将你的域名（如zentao.yourcompany.com）指向服务器公网IP。
2. 修改禅道配置：同样编辑/opt/zbox/app/zentao/config/my.php文件。
   • 找到$config->webRoot，确保其值为''（空）。
   • 找到$config->domain，将其值改为你的域名，如'zentao.yourcompany.com'。
   • 保存并重启服务。

启用HTTPS：为了数据传输安全，强烈建议启用HTTPS。你可以使用云服务商提供的免费SSL证书（如阿里云、腾讯云的SSL证书服务），申请后下载证书文件（包含.key和.crt文件），将其上传到服务器，并配置Apache的虚拟主机。由于步骤稍复杂，且一键安装包的Apache配置路径在/opt/zbox/etc/apache下，建议在有一定基础后再进行，或参考禅道官方文档关于HTTPS的配置。

4.3 数据备份策略

你的项目数据、Bug记录都在数据库里，定期备份是生命线。最简单的方法是使用MySQL自带的mysqldump工具，结合Linux的crontab定时任务。

创建一个备份脚本/opt/backup_zentao.sh：

#!/bin/bash # 定义备份目录和文件名 BACKUP_DIR="/opt/zentao_backup" DATE=$(date +%Y%m%d_%H%M%S) DB_NAME="zentao" # 禅道默认数据库名 DB_USER="root" DB_PASS="MyNewPass123!" # 替换为你的真实密码 # 创建备份目录 mkdir -p $BACKUP_DIR # 执行备份 /opt/zbox/bin/mysqldump -u$DB_USER -p$DB_PASS $DB_NAME > $BACKUP_DIR/zentao_backup_$DATE.sql # 压缩备份文件（可选） gzip $BACKUP_DIR/zentao_backup_$DATE.sql # 删除7天前的备份文件，防止磁盘占满 find $BACKUP_DIR -name "*.sql.gz" -mtime +7 -delete

给脚本执行权限：

chmod +x /opt/backup_zentao.sh

添加每天凌晨2点执行的定时任务：

crontab -e

在打开的编辑器中添加一行：

0 2 * * * /opt/backup_zentao.sh

保存退出。这样，每天都会自动备份并保留最近7天的数据。

5. 常见问题与排查技巧实录

即使步骤再详细，实操中也可能遇到各种“坑”。这里记录几个我遇到和常见的问题。

5.1 浏览器访问显示“无法连接”或“连接被拒绝”

这是最常见的问题，99%的原因出在网络和端口上。

排查思路：

1. 检查服务是否运行：在服务器上执行./zbox status，查看Apache和MySQL是否都是running。
2. 检查服务器本地能否访问：在服务器上执行curl http://127.0.0.1。如果能看到禅道的HTML代码，说明服务本身正常。
3. 检查防火墙：执行firewall-cmd --list-ports确认80端口已放行。如果没放行，按3.4步骤添加。
4. 检查云服务器安全组：这是最容易被忽略的！务必去云控制台确认安全组规则已添加80端口入方向。
5. 检查IP是否正确：确认你浏览器里输入的IP地址是服务器的公网IP，而不是内网IP。

5.2 安装页面数据库连接失败

在禅道安装引导页，填写数据库信息后点击保存，提示连接失败。

可能原因及解决：

1. 密码错误：再次确认输入的MySQL密码是默认的123456（如果你没改过）。
2. MySQL服务未启动：回到服务器命令行，cd /opt/zbox然后./zbox restart，再查看状态。
3. 数据库地址或端口错误：确保地址是127.0.0.1，端口是3306。一键安装包数据库只监听本地。
4. 之前安装残留：如果是第二次安装，可能之前创建的zentao数据库已存在。可以尝试在MySQL命令行里DROP DATABASE zentao;删除旧库，然后刷新安装页面重试。

5.3 访问速度慢或页面加载异常

可能原因：

1. 服务器配置过低：2GB内存的服务器，在团队人数较多、同时在线操作时可能会卡顿。考虑升级服务器配置。
2. 网络问题：如果是海外服务器，国内访问可能会慢。可以考虑选用国内节点的云服务器。
3. 浏览器缓存：尝试清除浏览器缓存，或使用无痕模式访问。
4. PHP会话（session）目录权限问题：偶尔会出现。可以检查/opt/zbox/tmp/目录的权限，确保Apache用户（通常是daemon或www-data）有读写权限。执行chmod -R 777 /opt/zbox/tmp可以临时解决，但生产环境建议设置更精确的权限。

5.4 如何升级禅道版本？

当新版禅道发布后，升级是必要的。升级前务必完整备份！

1. 按照4.3节的方法，手动执行一次数据库备份。
2. 备份整个/opt/zbox/app/zentao目录（这是禅道的代码和附件）。
3. 前往官网下载新版的一键安装包。
4. 停止旧服务：./zbox stop。
5. 解压新安装包到另一个目录，例如/opt/zbox_new。
6. 将旧目录下的app/zentao整个复制到新目录的对应位置（覆盖）。
7. 修改新目录下的禅道配置文件/opt/zbox_new/app/zentao/config/my.php，确保数据库连接信息正确。
8. 进入新目录，启动服务：cd /opt/zbox_new && ./zbox start。
9. 通过浏览器访问，禅道通常会自动引导进行数据库升级。按照提示操作即可。
10. 测试无误后，可以关闭旧服务，并将新目录重命名为原来的/opt/zbox。

这个过程听起来复杂，但核心就是“备份数据 -> 替换程序 -> 自动升级数据库”。只要备份做好，可以大胆尝试。

6. 从部署到上手：给团队管理员的初期建议

系统跑起来了，作为第一个管理员，你除了自己熟悉，更重要的是让团队用起来。这里分享几点初期推广的心得：

1. 角色与权限规划：禅道有“管理员”、“产品经理”、“研发”、“测试”、“项目经理”等默认角色。不要一开始就给所有人“管理员”权限。根据团队成员的实际职责分配角色，权限遵循最小化原则。可以在“后台-人员-权限”里细细配置。

2. 项目与产品的概念：这是禅道设计的核心。产品代表你要做的“东西”（如“XX办公系统”），里面管理需求、计划、发布。项目代表为了完成某个产品目标或特定任务而进行的一系列工作（如“XX办公系统V1.0开发项目”）。一个产品下可以有多个项目。初期可以先创建一个产品和一个对应的项目，让团队在这个框架下运作。

3. 工作流的定制：禅道默认的工作流（如Bug从“激活”到“解决”到“关闭”）可能不符合你们团队的习惯。作为管理员，可以进入“后台-流程-工作流”进行自定义。例如，为Bug增加一个“验证中”的状态。但建议初期先使用默认流程，跑顺1-2个迭代后再根据实际痛点调整，避免过度定制带来混乱。

4. 导入初始数据：如果团队之前用Excel管理任务，可以利用禅道的“导入”功能（在项目-任务列表页面）批量导入初始任务，降低切换成本。虽然需要整理一下Excel格式，但比一个个手动创建高效得多。

5. 召开一个简短的启动会：不要只是发个通知和链接。花30分钟，向团队演示一遍：如何登录、如何查看分配给我的任务、如何更新任务进度、如何提交一个Bug。现场让大家操作一遍，解决第一个“卡点”，比发十份文档都管用。

部署工具只是开始，让工具融入团队的工作习惯，才能真正产生价值。过程中肯定会遇到阻力，比如有人觉得麻烦、不如当面说。作为推动者，你需要耐心，并持续展示工具带来的好处：比如任务责任清晰了、不会再遗忘、讨论有据可查。当团队开始依赖禅道来追溯“当时这个需求是怎么定的”、“这个Bug是谁在跟进”时，你的部署工作就真正成功了。