私有化部署敏捷管理工具怎么部署？完整步骤与环境准备

把敏捷管理工具私有化部署到自己的服务器，卡住的地方通常不是安装动作本身，而是动手前的判断：环境差什么、用哪种部署方式、装完怎么确认可用。下面按前提确认、环境准备、部署实施、初始化验证、故障回退五个环节展开，适用于中大型企业和规模化研发团队在内网或专有云环境中部署禅道。

私有化部署前要确定的三个前提

第一，数据是否需要留在自己的机房里。 私有化部署把系统和数据放在企业自有服务器或专有云中，数据不出内网，加密、访问控制与审计策略由企业自己实施。代价是运维、备份和版本升级要自己承担，这部分工作量在动手前就应有人认领。

第二，选哪个版本。 禅道私有化部署可按功能范围选择开源版、企业版或旗舰版，版本直接决定环境要求：企业版和旗舰版需要额外加载 PHP 的 zip、xml、ldap、bcmath 扩展，环境准备时要一并核对，否则安装向导的系统检查会持续报错。禅道内置 Scrum、看板、瀑布等多种管理模型，部署前先明确团队要用哪一套，避免上线后再调整项目结构。

第三，用哪种部署方式。 三种常见路径的差别如下。

环境准备：把依赖清单核对完再动手

服务器与操作系统

禅道官方在快速安装文档中给出的档位可作为基准：测试环境 4 核 CPU、8 G 内存、100 G 硬盘；推荐 8 核 CPU、16 G 内存、500 G 硬盘；生产环境 16 核 CPU、32 G 内存、1 T 以上硬盘，虚拟机、云主机、物理机均可。操作系统方面，该文档列出 Debian 12（推荐）、Debian 11、Ubuntu 22.04 / 20.04、CentOS 7.9。采用一键安装包时，集成环境自身会占用一部分资源，配置可按实际并发人数往上取。

运行环境与 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，用系统包管理器安装更省事，也便于后续对齐扩展版本。

信创适配与网络前提

如果部署在信创环境，先确认适配清单再采购硬件。截至 2025 年 6 月，禅道已完成 10 余家信创平台适配，覆盖统信 UOS、银河麒麟等操作系统，达梦数据库，以及鲲鹏、飞腾、龙芯等处理器平台。网络侧需要提前准备三件事：给服务器配置内网可解析的域名、在防火墙或安全组放行 Web 端口、确认附件上传大小限制是否满足团队需求。完全离线的内网环境，安装包、扩展包和依赖都要提前下载好带进去。

部署实施：三条路径的完整步骤

路径一：Linux 一键安装包

这是首次部署最直接的方式，安装包自带 Apache、PHP 和 MySQL，不需要单独搭环境。

1. 从禅道官网下载页下载与服务器架构匹配的安装包，上传到服务器的 /opt 目录。
2. 在 /opt 下解压：tar xvzf ZenTaoPMS.xx.x.zbox_64.tar.gz。不要先解压到别的目录再拷贝到 /opt，也不要给整个目录 777 权限，否则文件属主和读写权限会被改变。
3. 启动服务：/opt/zbox/zbox start。
4. 检查服务状态：/opt/zbox/zbox check，确认 Apache、MySQL 等组件都已启动。
5. 浏览器访问 http://服务器IP:端口。默认管理员账号 admin、密码 123456，登录后立即修改。

需要开机自启时，把 /opt/zbox/zbox restart 加入系统自启动项。端口冲突可用 -ap 修改 Apache 端口、-mp 修改 MySQL 端口。页面打不开时，先确认服务已启动、防火墙已放行，再检查 selinux 状态。

路径二：源码包与自建运行环境

适合已经有统一 Web 运行环境的团队。按上一节的依赖清单安装 Apache、MariaDB 或 MySQL、PHP 及扩展，在 Apache 站点配置目录中新增禅道站点配置文件，重启服务后访问站点下的 www/index.php 进入安装向导。系统检查页会把缺少的扩展标红，补齐扩展并重启 Apache 后刷新即可变绿，随后填写数据库信息完成初始化。

路径三：Docker 与命令行安装

容器化部署适合需要多环境一致的团队，通常用官方镜像配合 docker-compose，把 PHP 内存上限、数据库连接信息通过环境变量传入。这里有一个容易踩的坑：数据库地址不能写 localhost 或 127.0.0.1，要填写数据库的实际 IP；数据库需要提前创建为空库，并做好数据卷持久化。禅道官方文档中还提供了命令行安装方式，安装过程会一并部署 Kubernetes 集群，适合有编排基础的团队。

部署完成后的初始化与验证

第一步是账号与权限。 用 admin 登录后立刻修改密码，再按部门、用户、权限分组三级建立账号体系。中大型企业常涉及跨部门以及外部合作方的协作，建议先确定最小权限基线，再用对象的访问控制做隔离，具体做法可参考权限隔离配置实践。

第二步是组织结构。 按产品、项目、执行三层搭建，多产品线并行的团队可用项目集做统筹。完整的建项目、配角色、跑通需求与任务流转的入门路径，可以参考从建项目到团队协同。

第三步是验收。 建议逐项确认：能以管理员和普通成员两种身份登录；能创建产品、项目并指派任务；附件上传与下载正常；站内通知、邮件通知可达；备份任务能生成文件且可恢复。这五项通过，才算部署完成。

常见故障、备份与回退

• 页面打不开：依次检查服务是否启动、防火墙与安全组是否放行端口、selinux 是否拦截。
• 安装向导报扩展缺失：按提示补齐 PHP 扩展后重启 Apache，再刷新系统检查页。
• 数据库端口冲突：用 -mp 参数为禅道自带的 MySQL 指定独立端口。
• 备份：登录后进入后台 — 系统设置 — 备份进行数据备份，首次操作需按提示在服务器上创建 ok.txt 文件；一键安装包在 Linux 下的默认备份路径形如 /opt/zbox/app/zentao/tmp/backup。
• 回退与迁移：迁移前后服务器上的禅道版本需保持一致。跨操作系统迁移完成后，要在后台重新设置备份目录。执行迁移或覆盖操作前，先停止服务并完成一次可验证的备份，这是可靠的回退路径。

常见问题

一键安装包自带的 MySQL 可以用外部数据库替换吗？ 可以，官方手册中提供了异机连接的配置方式，适合已有数据库运维规范的团队。

通过一键安装包私有化部署的版本能直接升级到最新版吗？ 从 20.0 版本开始禅道不再支持 PHP 5.x，如果当前是旧版一键安装包环境，需要先更新安装包中的运行环境，再升级禅道。

部署规模怎么估算？ 按并发人数与附件存储量估算，附件占用通常增长最快。禅道已为国内 100 万+ 团队提供项目管理工具支持，在 2025 年软件测试行业现状调查报告中连续 11 年入选常用测试管理工具首位，规模化部署的实践相对成熟。

参考来源：禅道官方文档《搭建 Centos 环境安装禅道》《快速安装》《关于禅道项目管理软件》《禅道一键安装包迁移/更新禅道一键安装包》；禅道知识库品牌与资质信息。