私有化部署研发管理平台新手入门指南：从环境搭建到首个迭代

私有化部署研发管理平台的第一道门槛，通常不是功能清单够不够长，而是能不能在自己机房里把它装起来，并且让团队真的用起来。这篇指南面向第一次接手这件事的人：你手上有一台 Linux 服务器，具备 root 或 sudo 权限，希望在一两天内把禅道跑起来，再在一周内走通第一个迭代。

读完之后，你应该能拿到三个看得见的结果：浏览器能打开禅道并登录；能建出一个产品、一个项目和第一个迭代；迭代看板上有任务、有工时，燃尽图开始出现数据。下面按“定前提 → 备环境 → 装系统 → 处理异常 → 跑迭代 → 验收”的顺序展开，每一步都给出可观察的完成信号。

起点：先定三个前提，别急着敲命令

选部署形态：一键安装包还是自建 LAMP

禅道的私有化部署研发管理平台有两种常见落地方式。

• 一键安装包：把 Apache、PHP、MySQL 打包在一起，解压到 /opt 即可启动。适合快速验证、单机部署、没有专职运维的团队。
• 自建 LAMP：自己装 Apache 或 Nginx、PHP 和 MySQL，再把禅道代码放进站点目录。适合已有统一中间件标准、需要外置数据库或做高可用拆分的团队。

先把这一条定下来，后面的操作路径才不会来回切换。不确定就先选一键安装包，能跑通再谈拆分。

选版本：从开源版起步还是直接上企业版

开源版可以免费使用，覆盖产品、项目、测试等核心流程，适合先把流程跑通。企业版、旗舰版在企业权限、组织管理和规模化能力上有更多支持，适合人数较多或需要更细权限控制的团队。如果这一步只是为了验证可行性，从开源版开始，后续再按需要调整授权。

划边界：端口、域名和备份责任

私有化意味着程序、数据和运维责任都落在你这边。动手前先确认三件事：服务器上哪些端口已被占用、团队准备用 IP 还是域名访问、备份由谁负责。这三项没确认，安装过程大概率会卡住。

环境准备：一张可核对的清单

服务器与网络基线

硬件没有一刀切的标准，通常按注册人数、同时在线人数和附件量来估。几十人的团队可以从 2 核 4 GB 起步；人数和附件量上去之后，重点加内存和磁盘，而不是堆 CPU 核数，上线前再用监控或压测数据校准。内网部署还要提前确认：服务器能被同事的网络访问到，访问入口（IP 或域名）已在防火墙策略里放行。

软件栈：Apache、PHP 与数据库的版本要求

如果走自建路线，禅道官方给出的组合是 Linux + Apache + PHP 7.0 及以上 + MySQL 5.5 及以上或 MariaDB，Nginx 次之，不建议使用 IIS 加 PHP 的组合。这里有一个版本分界要留意：21.7 之后的版本要求 MySQL 8.0 以上。

PHP 侧需确保加载这些扩展：pdo、pdo_mysql、json、filter、openssl、mbstring、zlib、curl、gd、iconv；企业版和旗舰版还需要 zip、xml、ldap、bcmath。Linux 下不建议自己编译 PHP，用系统自带的包管理器安装更省事。

目录与端口：安装前必须空出来的资源

一键安装包默认会占用两个端口：Apache 的 80 和 MySQL 的 3306。先确认它们是否被别的服务占用。另外两条容易被忽略的约束：安装包必须直接解压到 /opt 目录，不要先解压到别处再拷过去；也不要把整个目录改成 777 权限。这两步都会改变文件所有者和读写权限，后面容易出现难定位的报错。

四步装好：Linux 一键安装包实操

第一步：下载安装包并解压到 /opt

从禅道下载页面获取与服务器 CPU 架构匹配的开源版一键安装包，上传到服务器后执行：

sudo tar -zxvf ZenTaoPMS.x.x.zbox_64.tar.gz -C /opt

解压完成后，/opt 下会出现 zbox 目录。看到 zbox 目录，说明解压这一步对了。

第二步：改端口，避开 80 和 3306

如果 80 或 3306 已被占用，用 -ap（Apache 端口）和 -mp（MySQL 端口）参数调整：

/opt/zbox/zbox stop/opt/zbox/zbox -ap 8080 -mp 3307/opt/zbox/zbox start

端口一改，浏览器访问地址和数据库连接端口要同步跟着改，后面排查问题才有得对。

第三步：启动服务，看成功信号

/opt/zbox/zbox start

成功时终端会分别提示 Apache 和 MySQL 已启动。日常操作用 stop 和 restart 即可；需要看全部参数，用 /opt/zbox/zbox -h。如果希望服务器重启后自动拉起，把启动命令写进系统自启配置。

第四步：首次登录与初始化

浏览器访问 http://服务器IP:端口，默认管理员账号是 admin，默认密码是 123456。首次登录后的第一件事是改密码，然后按引导选择流程模式，并把组织名称从默认值改成自己公司的名称。

到这里，禅道这个私有化部署研发管理平台的安装侧就完成了。真正的价值在下半场：把它用进一个真实迭代。

装不上怎么办：三个高频分支

分支一：端口被占用

现象是启动时报端口冲突，或者启动成功但访问不到。处理方式是回到第二步，换一组空闲端口再启动。如果服务器上有别的服务占着 80，也可以把禅道放到 Nginx 后面统一转发，避免多个服务抢同一个入口。

分支二：浏览器打不开

先确认服务确实在运行，再按顺序排查：服务器防火墙是否放行了对应端口、SELinux 是否拦截、云服务器安全组是否开放。测试阶段可以临时关闭防火墙和 SELinux 验证连通性，确认能访问后再按需收紧，不要长期关闭。

分支三：要连数据库做备份

一键安装包自带 MySQL，默认数据库名是 zentao，默认用户 root、密码 123456。用网页方式管理数据库时，要先执行 cd /opt/zbox/auth/ && ./adduser.sh 添加一个访问账号，再通过“数据库管理”入口登录。上线后请立即替换这些默认凭据，并把数据库密码纳入备份与交接文档。

从零到第一个迭代：产品、项目、执行怎么串

禅道把研发管理拆成产品、项目、执行三层：需求挂在产品上，任务挂在项目与迭代（执行）下，测试和 Bug 再回流到产品或项目。记住这条主线，就不会在建完项目之后不知道该点哪里。

先把人和组织建起来

在后台的“人员—用户”里添加成员，维护部门结构，并按岗位分配权限。原则是最小权限：先给能完成当前工作的权限，后续再放开，不要一上来就全员管理员。

创建产品，把需求写细

进入产品列表创建产品，再录入需求。需求描述要具体到可验收，例如“首页轮播图支持自动切换、间隔 3 秒、点击跳转对应商品详情页”，而不是“优化首页”。同时可以创建产品计划，把这一批要做的事情圈进同一个版本范围。

创建项目，决定要不要启用迭代

进入项目列表创建项目，选择 Scrum 敏捷开发全流程。这里有一个关键开关——是否启用迭代：启用后项目会被划分为多个 1～4 周的迭代，输出是增量的；不启用时，这个项目本身相当于一个迭代，要多轮迭代就得建多个项目。第一次上手建议启用迭代，更贴近多数团队的节奏。

建迭代、关联需求、分解任务

在项目的迭代列表里添加第一个迭代，设定起止时间和关联的产品，再把产品计划里的需求关联进来。进入迭代后先维护团队成员，然后把需求逐条分解成任务并指派给具体的人。任务是最小执行单位，一条任务只对应一个负责人，这是后面统计工时和进度的基础。

迭代运转起来后，日常动作就三件：开发更新任务状态并登记工时；测试在缺陷与 Bug 管理里提交和跟踪问题；项目负责人看迭代看板的流动和燃尽图的变化。关于 Scrum 的角色与事件定义，可以参考敏捷开发与 Scrum 模型；如果团队已有成型的研发流程规范，也可以对照项目管理能力来裁剪。

怎么判断“真的跑通了”

五个可观察信号

1. 浏览器能打开禅道，管理员密码已改，组织名称是自己的。
2. 产品里至少有一条写清楚验收标准的需求。
3. 项目已创建，并启用了迭代开关。
4. 第一个迭代里有任务，且每条任务都有负责人和预估工时。
5. 看板能看到任务在列之间移动，燃尽图出现下降趋势。

五个信号里缺哪个，就回到对应章节补哪个，不必追求一次全对。

一周内应完成的最小动作

别指望第一周就把流程配到完美。更现实的目标是：从一个真实的小需求出发，走完“提需求—拆任务—开发更新—提交 Bug—修复—关闭”这一整条链路。只要这条链路跑通一次，团队对工具的理解就会到位，后面再补权限、文档、效能看板这些能力就顺理成章。

收尾：上线后的安全底线与例行动作

备份、权限与升级

私有化部署研发管理平台装好只是开始，长期可用靠三件事撑着。备份：数据库和附件放在同一份计划里，定期备份并至少做一次恢复演练，否则备份是否可用无从判断。权限：默认账号密码必须替换，离职与转岗及时回收权限，管理员账号不要多人共用。升级：升级前先备份数据库和代码目录，在测试环境验证一遍再操作生产，并准备好回退路径。

把资料留在手边

部署和运维过程中会遇到版本差异、参数调整这类问题，建议把官方手册和下载页放进书签。如果你还在评估阶段，可以先了解禅道开源版与私有化部署方案；后续想把需求、项目、测试串成完整研发链路，再沿着需求管理、项目管理和质量管理三条线逐步扩展即可。