私有化部署项目管理软件服务器配置：硬件、系统与数据库

服务器配低了，上线三个月就得迁移；配高了，预算过不了。私有化部署项目管理软件的配置难点不在单台机器的参数，而在硬件、操作系统、数据库三层之间的相互约束：内存怎么切分、磁盘放在哪、版本能不能对上。

这篇文章按可执行的顺序走：先用团队规模算出容量基线，再分别确定硬件、系统与数据库的配置，最后给出上线前的验证清单。文中涉及的版本与环境要求会注明来源，实际数字请以厂商官方文档的当前版本为准。

先用规模算基线，再谈配置

配置决策需要三个输入量，缺一个就只能拍脑袋。

• 注册用户数：决定账号、权限与组织结构的规模，也决定备份文件的大小。
• 同时在线人数：真正影响 CPU 和内存的是瞬时并发请求，不是总人数。研发团队的访问集中在上午站会和下班前提交，峰值通常出现在这两个时段。
• 附件与历史数据量：需求文档、原型图、测试截图、安装包会日积月累。程序本体占用的空间很小，禅道官方问答给出的程序与环境占用约 300 MB，磁盘增长几乎全部来自附件和数据库。

附件带来的不只是容量问题。磁盘的随机读写能力直接决定列表页、搜索和报表的响应速度，机械硬盘和低端网络存储在附件量大时会明显拖慢体验。数据盘优先选 SSD，这笔投入比多买两个 CPU 核心更划算。

把这三个量写下来，再对照后面的分档表，配置范围就能收窄到一个可讨论的区间。团队如果是从 SaaS 迁回内网的，历史附件量常被低估，先盘点再采购，可以避免上线后二次扩容。

硬件：CPU、内存、磁盘与带宽怎么分档

禅道官方 Docker 部署文档给出的基线是：测试环境 1 核 CPU、1 GB 内存、10 GB 磁盘，推荐配置 2 核 CPU、4 GB 内存、50 GB 以上磁盘；官方问答另给出运行环境门槛为 Linux 2 GB 内存以上、Windows 3 GB 内存以上、CPU 2 GHz 以上。这些数字是能跑起来的底线，不等于生产环境够用。

官方只给基线，生产配置要按用户数与项目规模往上调。 下面这张表是常见实践区间，用于快速定位量级，不是精确测算结果。

表中的数据盘容量按附件年增长估算，团队若经常传递视频或大体积安装包，请按实际盘点结果上浮。这类私有化部署项目管理软件的负载特征是读多写少，CPU 一般不是瓶颈，优先把预算放在内存和 SSD 上。

几个容易漏掉的细节：

• 内存要给操作系统留余量。 应用、数据库、系统缓存和备份进程共享同一块内存，任何一项超配都会触发内存回收，反而拖慢整体响应。
• 带宽按内网场景规划。 纯内网访问不需要大带宽，跨机房或远程办公接入才需要考虑专线与出口带宽，附件下载是主要消耗项，按峰值并发下载数估算即可。
• 安装包按内网条件准备。 隔离环境要提前备好离线安装包与依赖包；有外网条件的可从官方下载安装包页面获取对应版本与部署方式。

操作系统：发行版选择与安全基线

禅道官方安装文档推荐 Linux + Apache + PHP 7.0 以上 + MySQL 5.5 以上或 MariaDB 的组合，Nginx 次之，不推荐 IIS + PHP。Linux 发行版属于主线选择，Windows 更多用于小规模试用。

CentOS 7 已停止维护，继续沿用意味着安全补丁断供。替代路线有两条：迁移到 Rocky Linux、AlmaLinux 这类 RHEL 兼容发行版，运维习惯基本不变；或者转到 Ubuntu LTS、Debian，软件包更新更活跃，官方文档也常以 Debian 系为例。选择依据是团队现有运维能力，不是版本号的新旧。

系统装完之后，有四件事要在部署前做完：

1. 用包管理器装 PHP，不要手工编译。 官方文档明确不推荐自行编译 PHP，发行版仓库的软件包在升级和扩展管理上更省事。
2. 补齐 PHP 扩展。 基础需要 pdo、pdo_mysql、json、filter、openssl、mbstring、zlib、curl、gd、iconv；企业版和旗舰版还需要 zip、xml、ldap、bcmath。扩展缺失会在安装向导的系统检查页直接报错。
3. 设定时区与时间同步。 时区不一致会让日志、任务提醒和燃尽图的时间线出现偏差，部署时一并配好，比事后排查省事。
4. 调通防火墙与 SELinux。 端口放行、SELinux 策略、目录读写权限三处任何一处不通，都会表现为安装页打不开或附件上传失败。

信创环境下的系统选择

如果项目要求国产化，操作系统可在统信 UOS、银河麒麟等发行版中选择，CPU 平台覆盖鲲鹏、飞腾、龙芯、兆芯、海光等。禅道已完成多项兼容性认证，官方镜像同时支持 x86_64 与 arm64 架构。选型时先确认目标环境的适配记录，再决定版本，信创适配清单会随认证推进更新，采购前核对最新状态。

数据库：内置与外置的取舍，以及内存参数

一键安装包自带 Apache、PHP 和 MySQL，解压即可使用，数据默认落在 /opt/zbox 目录下。测试和试点用内置数据库没有问题，生产环境建议换成外置数据库，官方 Docker 文档也持同样建议。原因不在性能，而在运维：内置数据库的数据目录和程序目录绑在一起，系统盘吃紧时迁移麻烦，备份和扩容都要迁就安装包的结构。

先对版本，再调参数

版本匹配是这一步常被忽略的环节。禅道 21.7 版本之后要求 MySQL 8.0 以上，早于该版本的部署可以用 MySQL 5.5 以上版本或 MariaDB。先按目标禅道版本确认数据库版本要求，再讨论内存参数，否则调优做完还要重装。不同版本对数据库与运行环境的支持范围不同，选型阶段可对照版本与授权说明确认。

InnoDB 内存参数怎么设

MySQL 官方在 InnoDB 相关文档中给出的经验区间，是把缓冲池设为物理内存的 50%～75%，同时给操作系统留出余量。落到实际机器上，可以按下面这张表取起始值，再根据运行情况调整。

缓冲池超过 1 GB 时，同时设置 innodb_buffer_pool_instances 拆成多个实例，减少线程争抢；调整缓冲池大小时，新值需要是 innodb_buffer_pool_chunk_size × innodb_buffer_pool_instances 的整数倍，否则 MySQL 会自动取整。这些参数属于数据库侧配置，改完需要重启或按官方说明在线调整，务必先在测试环境验证。

国产数据库适配

信创项目常要求国产数据库，禅道已适配达梦、OceanBase 等产品，安装向导中可以直接选择数据库类型并填入连接信息。国产数据库的部署与调优逻辑与 MySQL 不同，建议由数据库侧团队一并参与，把参数、备份方式和升级路径在部署阶段定下来，而不是上线后再补。

部署形态：什么时候该把数据库拆出去

单机部署把所有组件放在一台服务器上，运维简单，适合作为起步形态。判断是否拆分，看的是运维信号，不是团队人数。 出现下面这些信号时，就该考虑把数据库挪出去。

拆分之后要处理三件配套的事：应用服务器到数据库服务器的网络延迟要低；异机连接需要在数据库侧放开访问来源；防火墙和安全组要单独放行数据库端口。这些配置漏掉任何一项，表现都是安装向导连不上数据库。

拆分和容器化都不会改变前面的容量结论，只是把同一份资源需求重新分配到不同机器上。

三层配置的协同校验

三层各自配好还不算完，配置之间必须能对上账。上线前把下面四组关系核一遍：

• 内存账：数据库缓冲池 + PHP 进程 + 系统缓存 + 备份进程，合计不超过物理内存。内存账是超配风险集中的环节。
• 磁盘账：系统盘放程序与日志，数据盘放数据库文件与附件目录，备份目录单独规划。三者混在一起的唯一后果是系统盘先满。
• 版本账：操作系统内核、PHP 版本、数据库版本、禅道版本之间要相互兼容。版本链条中有一处不匹配，安装向导的系统检查就会拦下来。
• 字符集：数据库统一用 utf8mb4，避免后续导入数据时出现乱码返工。

上线前的验证清单

配置完成不等于可以交付。下面几项验证做不完，建议不要切换正式使用。

• 备份可用性演练：备份成功不等于能恢复。用备份文件在测试环境完整恢复一次，记录耗时，确认附件目录和数据库处于同一时间点。
• 功能回归：登录、新建项目、需求流转、缺陷提交、附件上传下载、报表导出各走一遍。附件要测试大文件，报表要测试大数据量。
• 并发访问验证：在站会时段模拟多人同时访问，观察响应时间和内存水位。
• 监控与告警：磁盘使用率、内存水位、慢查询、备份任务结果都要有告警，不要等用户反馈才发现问题。
• 升级与回退路径：确认下一版本的升级方式，并保留可回退的完整备份。

常见问题

官方给的最低配置，能直接上生产吗？

不建议。官方给出的 2 核 4 GB 一类配置是运行门槛，适用于试用和功能验证。生产环境要叠加附件存储、备份空间和并发访问的余量，按前面的分档表取一个偏保守的值，后续再按内存水位和磁盘增速调整。

数据库一定要用独立服务器吗？

不一定。20 人以内、附件量不大时，单机部署完全够用，运维成本也更低。当出现系统盘频繁告警、备份窗口拉长、数据库写等待升高这些信号时，再拆出独立数据库服务器。迁移路径是清晰的，不必为了预留而提前增加运维负担。

国产化环境需要额外注意什么？

先确认操作系统与 CPU 平台是否在官方适配清单内，再做数据库选型。国产数据库的参数体系与 MySQL 不同，需要数据库侧团队参与配置和备份方案设计。部署前把适配证明、认证记录整理归档，验收时通常要用到。

私有化部署的项目管理软件上线后，扩容怎么做？

先看增长来自哪里。磁盘增速快，加数据盘或迁移数据目录即可；内存水位长期偏高，优先加内存并同步上调数据库缓冲池；数据库写等待升高，再考虑把数据库拆到独立服务器。按这个顺序扩容，每次只动一个变量，问题定位会清楚很多。