Jira替代私有化部署：环境要求、数据迁移与升级路径

Atlassian 官方迁移页面已给出时间表：Data Center 产品将于 2029 年 3 月 28 日结束生命周期，2026 年 3 月 30 日起停止向新客户销售，2028 年 3 月 30 日起停止向现有客户销售及扩容。对仍要求本地部署、数据不出内网的企业，Jira 替代已从“选不选”变成“怎么落地”，Jira 替代私有化部署也因此成为一项需要按工程推进的任务。

替代对象通常不止 Jira Software。Atlassian 体系里还有 Jira Service Management、Confluence，微软体系里常见 Azure DevOps Server。先列清在用的系统、插件与集成，再谈迁移，范围才不会中途膨胀。下文产品信息取自各厂商官网与公开文档，具体能力以正式兼容清单和合同为准。

先划清替代边界：要迁的不只是工单

迁移项目常见的偏差，是一开始只盯 Issue 表，上线后才发现权限、附件、自动化规则和报表没有承接。对系统多、审计要求高的中大型企业，先把替代边界写成清单：

• 系统：Jira Software、Jira Service Management、Confluence 是否都在范围内。
• 数据与配置：项目、工作项、评论、历史、附件、用户组、工作流、自定义字段、权限方案。
• 集成：代码仓库、CI/CD、统一身份认证、即时通讯通知、报表。

清单确认后，再区分必须迁移、归档只读和直接停用。这个判断会直接影响环境规格、迁移工期与停机窗口。

私有化部署的环境要求：先过兼容性这一关

禅道官方安装手册给出的基线是 Linux + Apache（或 Nginx）+ PHP + MySQL/MariaDB。PHP 7.0 以上是较早版本的通用要求，21.7 之后 MySQL 需要 8.0 以上；实际版本以所选禅道版本和操作系统为准。PHP 需加载 pdo、pdo_mysql、json、filter、openssl、mbstring、zlib、curl、gd、iconv；企业版、旗舰版还要 zip、xml、ldap、bcmath。Windows 一键包集成了 Apache、MySQL、PHP，适合快速验证；安装路径不要带中文，首次登录后立即修改默认管理员密码。

信创环境要核对到具体型号与版本。禅道公开资料显示，其已完成与统信 UOS、银河麒麟、达梦数据库、东方通中间件，以及鲲鹏、龙芯等平台的兼容互认。互认有具体的产品版本，采购前应索取对应证书，并在目标环境做一次部署验证。

容量不要照搬固定配置。按在线人数、附件总量与年增速、历史数据保留年限、备份窗口四项估算；数据库、附件存储、备份目录分开放。安装包可从禅道官网下载。

下面这张表用于部署前逐项确认，任何一项只停留在“厂商说支持”，都不算通过。

数据迁移：把 Jira 数据分成三层再动手

Jira 替代私有化部署的数据迁移，不是把 Issue 表导出再导入。Atlassian 官方备份结构里，entities.xml 和 activeobjects.xml 存业务与配置数据，data/attachments、avatars、logos 是独立目录。只导出 Issue 表，附件和历史一定缺失。把数据拆成三层，顺序会更清楚：

• 配置层：用户组、角色、工作流、自定义字段、权限与通知方案。
• 业务层：项目、Epic、Story、Task、Bug、评论、历史、关联、迭代与发布。
• 资产层：附件、头像、项目图标、Confluence 页面与常用宏。

先定字段落点再导入，返工最少。

字段映射没有通用答案。先建目标系统的字段字典，再逐项确认；无法一一对应的字段，宁可留在描述或备注，也不要硬塞。

禅道官方迁移范围包括项目、迭代、Epic、Story、Task、Bug、发布等核心数据，也支持新增 Issue 类型、自定义字段和工作流；Confluence 侧可迁移空间、页面、附件和常用宏。流程通常是“确认迁移方式—准备 Jira 数据—导入禅道—数据确认—导入成功”，厂商可提供全程支持。

源端是 Jira Cloud，还要先看导出边界。Atlassian 官方文档给出的建议上限是总数据 25GB、附件 50–100GB；自动化流程、第三方应用数据、部分 Jira Service Management 能力不在导出范围内，需单独处理。

验收不要只看条数。至少做四件事：抽样对照字段与状态；打开附件确认可下载；按一条真实业务链走完创建、流转、关闭；抽查权限与历史。条数对得上、业务跑不通，仍然算迁移失败。

升级路径：覆盖安装、数据库迁移与回滚

私有化部署的升级不是点一下“更新”。禅道官方手册把升级拆成覆盖程序和执行数据库迁移两步，升级前要备份的也不只是数据库。配置文件、改动过的代码、数据库、附件，四类都要备。一键包可停服务后备份整个 /opt/zbox；手工环境用 mysqldump 导出数据库，再单独打包附件目录。备份后做一次恢复验证，确认备份真的能用。

1. 测试环境用同版本数据演练，确认目标版本、PHP/MySQL 版本和插件兼容。
2. 停服务、冻结写入，做全量备份。
3. 覆盖新版本程序文件，不要把旧目录移走再解压，避免路径嵌套。
4. 访问 /zentao/upgrade.php 执行数据库升级，过程中不要关闭页面。
5. 登录检查项目、任务、Bug、附件、文档、权限和集成，再备份一次。
6. 出问题就恢复旧程序目录与备份数据，回到升级前状态。

跨大版本不要一步到位。官方手册对源码包、Windows 一键包、Linux 一键包和 Docker 分别给了升级方式；版本跨度大时，按中间稳定版本逐级升级，测试环境通过后再动生产。Docker 切换镜像时保留数据卷，避免容器重建把附件和数据库带走。具体步骤可对照禅道使用手册。

三条落地路线怎么选

路线一，一次性切换：系统少、流程标准化程度高、能接受完整停机窗口。成本低，风险集中。

路线二，分批迁移：按事业部或项目群分批导入，先试点再复制。周期长，但每次影响范围小。

路线三，并行过渡：旧系统保留只读，新系统承接日常协作，历史查询走旧系统。适合审计要求高、数据量大的组织，前提是明确只读期限与归档责任。

判断看四个变量：自定义字段与插件复杂度、停机窗口、历史保留要求、团队分布。复杂度高、窗口短，优先分批；合规要求强、查询频繁，优先并行过渡。比较不同版本的承接能力，可先看版本对比。

把迁移当成一次流程盘点

Jira 替代私有化部署，装好环境只是起点。真正决定上线质量的，是替代边界是否清楚、字段映射是否验证、升级回滚是否演练。把这三件事写成清单，迁移就从高风险切换变成可检查的工程。厂商资料取自官网与公开文档，具体版本、兼容范围和迁移能力以正式清单为准。