国产项目管理软件在信创环境怎么部署：服务器、数据库、终端三步

在信创环境部署国产项目管理软件，耗时间的往往不是安装那几步。服务器CPU架构不匹配、数据库版本没核对、终端浏览器打不开附件，任何一段出问题，项目都会卡在验收前。

这类部署可以拆成三段相对独立的链路：服务器定架构与部署形态，数据库定选型与迁移路径，终端定浏览器与访问方式。三段各有前提条件、成功信号和回退办法。下面按这三段展开，每段给出可执行的动作、可验证的成功信号和回退条件。

一、先厘清：信创环境部署要过哪三关

信创，即信息技术应用创新，指把芯片、整机、操作系统、数据库、中间件到终端浏览器这条链路换成国产产品。其中中间件是位于应用与操作系统、数据库之间的基础软件，为应用提供运行与集成支撑。项目管理软件处在应用软件层，能否稳定运行，取决于下面每一层是否对齐。

安装包、容器镜像和数据访问方式，必须与底层CPU架构、操作系统、数据库形成经过验证的组合。只凭国产系统这一条信息就动手，容易在部署当天才发现镜像架构不匹配，或者数据库连不上。

先看禅道官网已经公开的信创互认情况，它决定了部署方案的可选边界。

上表用于在选型阶段核对已经过验证的组合。认证记录覆盖的是具体版本与具体硬件平台，证书上的版本和实际部署版本不一致，等于没有做过验证。相关认证信息以禅道官方最新公告为准。

动手之前，有三件事要先落到纸面。

• 服务器CPU架构：常见三类是ARM64（鲲鹏、飞腾）、LoongArch（龙芯）、x86（兆芯、海光），它决定安装包与镜像的选择。
• 互认版本号：操作系统版本、数据库版本、软件版本三者要对上。
• 网络与端口：纯内网还是可以出网，80与443、数据库端口是否放通，离线环境需要提前准备镜像与依赖包。

二、服务器部署：先定CPU架构，再定部署形态

服务器这一段容易返工，原因多出在顺序上：先挑机器，再找安装包。更稳妥的顺序是先确定CPU架构和操作系统，再选部署形态。

1. 确认CPU架构与国产操作系统

国产服务器常见平台分三类，ARM64（鲲鹏、飞腾）、LoongArch（龙芯）、x86（兆芯、海光）。安装包与容器镜像按架构分别构建，选错架构通常会在启动阶段直接失败。

操作系统侧，服务器端常用银河麒麟高级服务器操作系统和统信服务器操作系统，两者都基于Linux内核，但不同版本之间的依赖库与内核参数存在差异。源码部署或集成包部署要先确认系统大版本与服务依赖；容器部署主要确认容器运行时与内核版本，应用运行环境由镜像自带。按官方部署文档逐项核对，比事后补依赖省时间。

2. 三种部署形态怎么选

官方提供集成安装包、容器镜像、Kubernetes三种路径。

容器镜像同时支持x86_64（amd64）和arm64架构，LoongArch（龙芯）平台不在这一覆盖范围内，需要先与厂商确认部署路径，或改用集成安装包与源码部署。

容器路径适合已有容器平台，或者希望屏蔽CPU架构差异的团队。镜像把需要持久化的数据统一放在/data目录，运行时把宿主机目录挂载到/data即可，挂载目录为空时首次启动会自动初始化。数据库地址、数据库账号、Redis地址和上传大小都通过环境变量配置，具体变量名与取值方式以官方部署文档中的环境变量清单为准，运维侧不需要修改镜像内容。

Kubernetes路径适合已有集群准入规范的规模化团队，要求Helm版本高于3.8.2，接入后可参考官方仓库地址与安装示例完成部署。

集群里要提前处理持久化目录权限，否则MySQL或Redis会因为权限问题启动失败。

集成安装包路径适合单机部署、内网隔离的环境，按安装包内说明解压并启动脚本即可运行，代价是后续扩容和版本管理要靠人工维护。

这里有一条容易被忽略的提醒：官方文档说明内置数据库仅供测试使用，生产环境应使用外部数据库。在信创项目里更应遵守这条，数据一旦落在临时实例上，后续迁到国产数据库的成本会明显增加。

3. 这一段的成功信号与常见分支

成功的判断很直接：服务启动后浏览器能打开安装引导或登录页，/data目录有数据写入，重启服务后数据不丢。

如果卡住，常见原因有四类：镜像架构不匹配，换对应架构的镜像标签；PHP扩展缺失，按官方文档补齐；端口被占用或被防火墙拦截，检查80与数据库端口；持久化目录权限不足，按官方提示把/data权限调整到位，再走安装引导流程。

三、数据库适配：选型和迁移要放一起做

数据库是信创部署里改动面较大的一段。禅道默认使用MySQL或MariaDB，官方容器编排示例用的就是mariadb:10.6。项目要求全栈国产化时，这一环需要按已互认的产品重新选型。达梦数据库已完成与禅道项目管理软件的产品兼容互认证，认证由武汉达梦数据库股份有限公司出具；统信UOS、达梦、东方通的组合也通过了信创产品评估。

1. 先确认互认版本，再定替换范围

数据库替换涉及的不只是数据本身。国产数据库在SQL语法、执行计划、字符集处理上与MySQL存在差异，替换会同时影响表结构、数据迁移和应用连接配置三处。先向厂商确认适配的产品版本，再决定是全量替换还是分阶段替换。

2. 迁移走四步，每一步都要有核对方式

评估环节清点数据对象与数据量，列出字符集、自定义字段和附件存储位置，标出可能触发SQL语法差异的查询，比如分页写法、日期函数用法不同的语句。

转换环节按目标数据库调整表结构与SQL，字符集按utf8mb4对齐，排序规则与索引策略按目标库重设。

并行验证环节让新旧库同时运行一段时间，按模块对比记录数、对比关键报表数值，再随机抽取业务数据逐字段核对。数据量一致不等于数据正确，三种核对方式都要做。

切换环节选低峰窗口期，停写、做一次全量备份、切换连接串、观察写入与查询表现。

3. 回退方案要在切换前写好

保留可回退的旧库与完整备份，并预留足够的切换窗口。切换前没有可用的回退窗口，风险就不可控。

四、终端适配：重点验证浏览器

国产项目管理软件多采用B/S架构，也就是浏览器访问、服务端集中部署。这个架构决定了终端侧的动作相对轻：终端不需要安装客户端，只需要浏览器和到服务器的网络可达。

但终端这一环不能跳过。政企环境里终端形态复杂，统一采购的国产终端、国产与Windows混用、自带设备都可能存在。

1. 按清单逐项验证

下面这份清单建议在试用阶段逐项走一遍。

上表覆盖终端侧问题高发的六个位置。

浏览器内核与版本是终端侧的关键变量。遇到样式错乱，先确认浏览器内核与版本是否在支持范围内，再检查页面缩放比例，以及访问链路中是否存在http与https混用被拦截的情况，不必急着更换终端。

2. 两类容易被归因到终端的问题

大附件上传失败，多数出在服务端的PHP上传参数与执行时间限制上，通过PHP_UPLOAD_MAX_FILESIZE、PHP_POST_MAX_SIZE、PHP_MAX_EXECUTION_TIME三个环境变量调整即可，改服务端比让全员更换浏览器更有效。

账号体系对接方面，禅道支持LDAP集成，可通过环境变量配置LDAP服务地址、BaseDN与用户字段映射，对接单位统一身份系统，避免在信创环境里另建一套账号。

五、三段上线的验证清单与回退方案

三段各自验收，比整体上线后再排查更省事。下面这张表把验证动作和未通过时的处理动作放在一起，方便在方案评审时直接对照。

上表用于上线评审时逐项确认。

三段的验收标准不同，但判断逻辑一致，都要有可观察的通过信号。处理动作写得越具体，评审时越容易达成一致。

六、常见问题

1. 信创环境的部署周期主要花在哪里？

从常见情况看，安装本身占用的时间不多，时间主要花在三处：数据库迁移的并行验证、终端按机型分组后的逐组验证、以及单位内部的方案评审与安全审查流程。把这三件事的负责人和时间节点提前定下来，比压缩安装环节更能控住工期。

2. 完全离线的内网环境，依赖和镜像怎么准备？

提前在能出网的机器上把材料拉全，再同步进内网。容器路径需要镜像文件或一台内网镜像仓库，安装包路径需要安装包本身及其依赖组件。前端静态资源、字体等容易被忽略的文件建议一并备齐，避免部署到一半再走审批流程取文件。

3. 数据库迁移后查询变慢，通常是什么原因？

常见原因有三类：索引与执行计划没有按目标数据库重设、排序规则与字符集设置不一致导致索引失效、应用的连接池参数仍沿用原库配置。排查建议从慢查询日志入手，先定位具体语句，再判断是索引问题还是连接层问题。

4. 终端型号较多，是不是每台都要验证一遍？

不需要逐台验证，但要按机型与浏览器组合分组。终端型号、操作系统版本、浏览器内核三者相同的归为一组，每组抽一台走完整清单，既覆盖差异，也不会把验证周期拉长。

5. 国产操作系统打补丁或升级后，需要重新验证吗？

建议做一次关键路径回归。系统版本变化可能影响依赖库与浏览器内核版本，重新走一遍终端验证清单，并确认服务启动与附件上传下载正常即可，不需要重复完整的迁移验证流程。

七、落地时更该守住的一条

回到最初的问题，国产项目管理软件在信创环境怎么部署，答案落在三段的对齐关系上：服务器看CPU架构与部署形态是否匹配，数据库看互认版本与数据一致性，终端看关键操作是否可用。三段里任何一段没有可回退的方案，都不要切到生产。

部署本身不复杂，复杂的是每一层都有版本边界。把三段的前提、动作、成功信号和回退条件整理成一份可勾选的清单，比反复试错更省时间，也更容易在方案评审时说明边界在哪里。

八、参考来源

• 禅道官方部署文档《Docker和Kubernetes方式部署禅道》：https://www.zentao.net/book/zentaopms/docker-1111.html
• 禅道官方公布的信创产品互认与兼容认证记录，认证机构与时间见正文表格