本地部署软件3种离线安装方式

本地部署软件时，服务器常常没有外网。离线安装能否落地，不取决于安装包大小，而取决于运行环境、依赖、数据目录和回滚路径是否一起准备好。中大型企业和规模化研发团队常受内网、信创或安全隔离约束。以禅道为例，常见做法有三种：一键安装包、Docker 镜像离线导入、源码包配合自建 LAMP/LNMP。下面按操作顺序拆开，并给出选择条件。

离线安装前，先确认四个前提

确认架构与系统。 执行 uname -m 和 cat /etc/os-release，记录 x86_64 还是 arm64、发行版和版本号。安装包、镜像、PHP 与数据库依赖都要与这套环境匹配。本文以 Linux 服务器为例。

准备依赖清单。 一键安装包自带运行环境；Docker 方式要先离线装好 Docker Engine；源码方式要准备 Web 服务器、PHP、数据库及扩展。同版本、同架构的依赖包和系统补丁要一起带入内网。

介质可追溯。 在联网机器下载安装包和镜像归档，记录版本号与 SHA256，通过企业允许的介质转入内网，保留校验记录。不要用来路不明的第三方整合包。

先备份再动手。 虚拟机快照、数据目录、数据库导出和旧版本安装包至少保留一份。生产环境先在隔离的验证环境走一遍。

方式一：一键安装包，开箱即用

禅道 Linux 一键安装包内置 Apache、PHP、MySQL 和 XXD，不需要再单独安装运行环境。从 18.5 版本开始，安装包分为 x86_64 和 arm64 两个包，下载前先确认服务器架构。

1. 在联网机器从禅道下载页下载对应版本和架构的包，校验 SHA256 后转入内网。
2. 把包放到 /opt，执行 tar xvzf ZenTaoPMS.<版本>.zbox_64.tar.gz。官方特别说明：不要解压到别的目录再拷贝到 /opt，否则文件所有者和读写权限会改变；也不要直接把整个目录设成 777。
3. 执行 /opt/zbox/zbox start 启动服务，再用 /opt/zbox/zbox status 查看 Apache、MySQL、XXD 是否运行。
4. 浏览器访问 http://服务器IP:端口。默认管理员账号 admin、密码 123456，首次登录后立即修改；数据库默认 root、密码 123456 也要改。
5. 端口被占用时可加 --aport 8080 --mport 3307 改端口。

验证：zbox status 显示 running，登录页能打开，新建项目、任务和 Bug 正常，上传附件不报错；重启服务后数据仍在。回滚：升级前备份 /opt/zbox 整个目录，异常时停止服务，恢复旧目录和备份数据，再用旧版本启动。

适合已有标准 Linux、暂无容器平台的场景。

方式二：Docker 镜像离线导入，环境一致

Docker 方式把运行环境封装在镜像里，离线部署的关键是先把镜像归档带进内网。禅道官方 Docker 文档给出的测试环境是 1 核 CPU、1 GB 内存、10 GB 硬盘，推荐 2 核、4 GB 内存、50 GB 以上硬盘；生产环境再按用户数和项目规模上调。

1. 离线安装 Docker Engine 20 及以上版本，可从发行版 ISO、本地软件源或官方静态二进制包准备；安装后执行 docker -v 和 systemctl enable --now docker 确认。
2. 在联网机器下载对应版本的镜像归档。官方 Docker 文档的“离线导入”一节提供 zentao_<版本>.gz；也可以在联网机器 docker pull 后执行 docker save -o zentao_<版本>.tar <镜像名>:<标签> 自行归档。
3. 把归档转入内网。官方归档用 gunzip -c zentao_<版本>.gz | docker load 导入；自行保存的 tar 包用 docker load -i zentao_<版本>.tar。再用 docker images 确认镜像已存在。
4. 创建数据目录，例如 /data/zentao，然后启动容器：

docker run -d --name zentao -p 80:80 \  -v /data/zentao:/data \  -e MYSQL_INTERNAL=true \  hub.zentao.net/app/zentao:<版本>

数据必须挂载到 /data。 禅道容器把数据库、附件、配置和日志都放在这个目录；不挂载，容器重建后数据会丢。官方建议生产环境使用外部数据库，内置 MySQL 更适合测试验证；使用外部数据库时，用 ZT_MYSQL_* 环境变量传入地址、端口、账号和库名。

验证：docker ps 能看到容器，docker logs -f zentao 没有持续报错，浏览器能打开登录页，上传附件正常；执行 docker restart zentao 后数据仍在。回滚：升级前备份 /data/zentao，保留旧镜像标签；新镜像启动失败时，停止并删除新容器，用旧镜像挂载同一数据目录启动。生产环境不要使用 latest，固定版本标签。

适合已有容器平台、需要多套环境一致或后续迁移的团队。

方式三：源码包加自建环境，控制力更强

源码包不包含运行环境，需要自己准备 Web 服务器、PHP 和数据库。禅道官方给出的基线是 Linux + Apache + PHP 7.0 以上 + MySQL 5.5 以上/MariaDB；21.7 版本后 MySQL 需要 8.0 以上，具体版本以所装禅道版本的安装文档为准。PHP 需要 pdo、pdo_mysql、json、filter、openssl、mbstring、zlib、curl、gd、iconv 扩展；企业版、旗舰版还需要 zip、xml、ldap、bcmath，并按官方文档安装 ionCube。

离线准备时，在同版本、同架构的联网机器上用包管理器下载 RPM/DEB 及依赖，再在内网搭建本地软件源。不要混用不同发行版或不同大版本的依赖包。

1. 下载源码包并转入内网，解压到 Web 根目录，例如 /var/www/html/zentaopms。
2. 把站点根目录指向 zentaopms/www，配置 Apache 或 Nginx 解析 PHP，按官方文档设置伪静态和目录权限。不要让站点根目录停留在源码包外层。
3. 在 MySQL/MariaDB 中创建空数据库和专用账号，授予该库的必要权限。
4. 浏览器访问站点，按安装向导填写数据库地址、端口、账号、密码和库名，设置管理员账号，完成初始化。
5. 安装完成后删除或重命名 www/install.php，限制数据库端口只对应用服务器开放，并检查 www/data、www/tmp 的写入权限。

验证：php -m 能看到所需扩展，安装向导没有缺扩展或连不上数据库的报错，登录后能新建项目、任务和 Bug，附件上传正常；重启 Web 服务和数据库后再次登录，数据仍在。回滚：升级前用 mysqldump 导出数据库，备份代码目录和 www/data 附件目录，保留旧代码包；正式环境失败时，按“停服务、留日志、恢复数据库和代码、旧版本启动、验证登录”的顺序回退。

适合已有标准 LAMP/LNMP 环境、需要自定义 PHP 或数据库版本或信创适配的团队。ARM 或信创环境要先确认包、镜像和依赖有对应架构版本；禅道部分版本已完成与统信、麒麟、达梦等平台的兼容性适配，具体以官方信创解决方案和互认清单为准。

三种方式怎么选

实际选择时，按三个问题判断：

• 有没有现成的容器平台？ 有，优先 Docker；没有，不要为了装一套软件先搭容器平台。
• 服务器是不是 ARM 或信创环境？ 先确认对应架构的包、镜像和依赖，再谈安装方式。
• 是否已有统一的 Web 服务器和数据库？ 有，源码方式更容易复用现有运维体系；没有，一键包更省事。

这三种本地部署软件的离线安装方式没有统一答案。选择标准不是哪个更先进，而是谁能用现有团队、现有依赖稳定运行，并且出问题时能回滚。

上线前验证与回滚

无论选哪种方式，上线前至少做四项检查：

1. 服务与页面：进程或容器处于 running，端口正在监听，可用 ss -lntp 核对；首页返回 200，管理员能登录。
2. 核心功能：新建项目、任务和 Bug，上传附件，确认没有权限或扩展报错。
3. 持久化：重启服务或容器，数据仍在；Docker 方式重点检查 /data 挂载。
4. 备份与安全：备份数据库和附件，在验证环境恢复一次；修改默认密码，限制数据库端口，按规范配置 HTTPS 和日志。

离线环境还要配置内网时间源，避免日志、会话和证书校验异常。回滚时先停服务、保留日志，再恢复数据目录或数据库，用旧版本启动并验证登录。没有备份就不要覆盖安装目录，也不要在生产环境直接试新版本。

本地部署软件的离线安装，说到底是一项准备工作：先把架构、依赖、介质、端口和备份确认清楚，再选一条团队能长期维护的路径。三种方式都能把禅道送进内网，差别在于你愿意把复杂度放在安装阶段，还是放在后续运维阶段。

操作细节依据禅道官方《Linux 用一键安装包》《Docker 方式部署禅道》《搭建 CentOS 环境安装禅道》整理，版本差异以官网当前文档为准。