这篇文章基于 easysoft/zentao:-，实测引擎 ZenTao配套 MariaDB测试网站 Ubuntu Linux。

研发一忙。需求就散在聊天记录、表格和口头承诺里：产品经理改一版 Excel，开发对不上行号，测试不知道该验哪条；缺陷在群文件里传来传去，对几次就丢了上下文。再大一点的团队还要同时管多条产品线、多次迭代。没有一个「产品 / 项目 / 测试」既能分开又能衔接的地方，周会只能靠人肉对账。

把整套流程放到商业 SaaS。授权按人计费，需求和缺陷出域也过不了内网审计。自建 Jira 一类重型网站，对「先把项目管理跑起来」又偏重。更省事的做法是：数据留在自己的服务器浏览器打开就能管需求、任务和 Bug。

是国产开源项目管理软件，在浏览器里管产品、项目、测试、文档和组织。官方镜像是/easysoft/zentao。这篇文章跟做开源版标签-,跟命令不要写latest.

使用者痛点：

• 需求信息碎片化导致沟通成本高: 需求分散在Excel表格与聊天记录中；无法统一追踪，
• 缺陷跟踪无序导致上下文丢失: 缺陷文件在群聊中频繁转发，一旦被覆盖难以追溯。
• 跨产品线协作效率低下: 多条产品线同时推进，需要统一视图与权限控制。老实说，
• 商业 SaaS 成本高且外部审计风险大: 需要按人计费且数据外泄风险较大。
• 自建大型网站技术门槛高且维护成本高昂: 需要配置复杂且难以快速上线。
• 缺乏可视化操作向导导致新手上手慢速: 手动部署脚本易出错。
• 缺少安全加固措施导致生产环境易被攻击或误操作导致数据丢失.
• 部署后日志不友好导致排障时间长.
• 缺少自动升级机制造成安全更新滞后 .
• P10：如何快速迁移到新版本而不破坏现有数据?.
• P11：怎样才能让旧数据库迁移到新容器时保持一致性?.
• P12：如何通过简单配置开启 HTTPS 并防火墙安全?.
• P13：如果遇到 Docker Compose 启动异常，我该如何定位问题?.

主要场景与能力概览：

二 环境要求 & 前置准备：

• * 程序：Linux，DockerEngine + Compose V2；CPU ≥ 4 核 / 内存 ≥ 8 GB；磁盘建议≥ 40 GB，存储容量≈ 50 MB + MariaDB约 100 MB。按理说，* 架构支持 amd64 或 arm64。* 容器端口映射默认:::;若占用请改为"1234:". * 确认已安装 Docker 和 Compose： bash docker --version docker compose version * 若未装 Docker，可使用轩辕镜像一键安装脚本： bash bash < 或备用地址： bash bash < * 更多请参阅 * 若宿主机某端口已被占用，可将Compose端口改为":"并访问 http://IP:/。

三 标签怎么选？——保持稳定性与可复现性：

• * 官方提供大量标签。包括开源版、公司版,旗舰版,IPD还有 PHP7/k8s 等变体。* 本教程仅拉取开源版本时间戳标签，例如`-` 或 `2024-10-01`；话说回来，切勿使用 `latest`，因为它会随新版滚动导致脚本失效。* 使用 Compose 时请确保 `image:` 指定的是同一个时间戳标签。并将所有实例都切换至该标签，以免出现混合版本数据结构不兼容的问题。* 如果需要升级，只需修改 `docker-compose.yml` 的 `image:` 行并执行 `docker compose pull && docker compose up -d` 即可。不要仅改 tag 而不拉取对应镜像层。* 商业版或已归档仓库请勿混用。

四 拉取镜像：

建议使用轩辕镜像加速拉取：

docker pull docker.xuanyuan.run/easysoft/zentao:-
docker pull docker.xuanyuan.run/library/mariadb:

Mysql 镜像首次拉取可能出现超时可再执行一次一样命令即可恢复下载完整层。怎么说呢，如成功则显示以下摘要信息：

IMAGE ID SIZE
docker.xuanyuan.run/easysoft/zentao:- 053271d83559 .1GB
docker.xuanyuan.run/library/mariadb: 92e50059ea0a .44GB

五 Docker Compose 部署——比较容易做到零基础上线：


* 创建工作目录并赋权：

bash
mkdir -p /www/wwwroot/zentao/{data,mysql}
chown -R "$USER:$USER" /www/wwwroot/zentao
cd /www/wwwroot/zentoa




编写  docker-compose.yml ：

yaml
services:
zentao-db:
从image来看，docker.xuanyuan.run/library/mariadb:
containername: zentao-db
restart: unless-stopped
environment:
MYSQLROOTPASSWORD: ChangeMeZentaoDb
MYSQLDATABASE: zentao
TZ这方面，Asia/Shanghai
command:
- --character-set-server=utf8mb4
- --collation-server=utf8mb4unicodeci
volumes:
- ./mysql:/var/lib/mysql

至于zentao。image: docker.xuanyuan.run/easysoft/zentao:-
containername: zentaa
restart: unless-stopped
dependson:
zentaa-db:
condition: servicehealthy
ports这方面，- ":"
volumes:
- ./data:/data
environment:
MYSQLINTERNAL:"false"
ZTMYSQLHOST:zentaod-b
ZTMYSQLPORT:""
ZTMYSQLUSER:"root"
ZTMYSQLPASSWORD:"ChangeMeZentoaDb"
ZTMYSQLDB:"zentaa"
PHPMAXEXECUTIONTIME:""
PHPMEMORYLIMIT:"512M"
PHPPOSTMAXSIZE:"128M"
PHPUPLOADMAX_FILESIZE:"128M"
networks:
- zenta-net 

networks:
zenta-net:{driver:'bridge'}




说到开启服务，

bash
docker compose pull && \
docker compose up -d && \
docker compose ps && \
docker compose logs -f --tail=20 &




等待  状态显示 healthy 与 Up。首次启动 MariaDB 初始化约44秒，请耐心等待。



当日志出现 “Apache is ready”和 “继续完成后续安装向导”。按 Ctrl+C 停止日志跟踪，接下来打开浏览器访问 http://服务器IP:<端口>/ 完成安装向导。



关键配置说明 



配置项
意义




MYSQL_INTERNAL
false 表示使用外部 MariaDB


ZTMYSQLHOST
容器内部服务名。不填宿主机 IP


./data
禅道持久化目录，包括附件与会话


./mysql
MariaDB 数据文件目录




注意 


密码务必强壮并与数据库 root 密码一致。

如第六节 step5 报 JSON 空响应。只需等待日志中 “Zentaa is ready to use”，接下来直接访问首页登录即可。


六 浏览器安装向导 —— 步骤拆解与常见问题解决：



访问入口http://服务器IP:<端口>/。

1️⃣ **欢迎页**：点击“开始安装”，勾选授权协议后继续。1️⃣ **程序检查**：确认 PHP
及 `/data` 可写。若提示错误，请检查挂载目录权限。1️⃣ **数据库配置**：



参数
填写值 



时区 
Asia/Shanghai 

数据库服务器 
cento-db 

数据库端口 
默认空即80?，)
…，…，…，…，?，?，…，备注：








…，…，…，…，….
，…..，…，…，…，…，...?，...?，...?，?...，?...，?，…..
，...?，…，...
...
…，…，…，…，…，…，…，…，…，…，…，…，…，…，…，…，…，…........
，….........
，…...
​
，…..，…..
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​​
​
​
…，·················
.........
…，…，..?，…..
，…，…，…，…，…，.…，…，…，…，.....
…，…，…
，…，…..，.…，…，.
…，..?，…..
..，?，.?，?.，?，.?..，?.，?，?.，?.
，…，….，?，?..，?，.
…，?，?..........
......
......
............
...








...




时区 = Asia/Shanghai # 必填，无误差范围极小；不过，数据库服务器 = cento-db # Compose 内部名称；数据库端口 = "" # 默认空即3306；字符集 = utf8mb4;按理说，使用者名 = root;密码 = ChangeMe_Zentoa_Db;库名 = zentaol;# 同 Compose 中设置。正在创建表结构 ...
新增索引 ...
完成 …text
Zentaa is ready to use.
RoadRunner server started;text
POST : install.php?其实，m=install&f=step5&zin=
Response :
Error : Unexpected end of JSON input.
text
Step5 后
刷新即可跳转首页登录页面。​





❗ 常见问题 – Step5 JSON 空响应


这不是错误，而是禅道内部前后端交互造成的空响应。在日志中看到 "Zentaa is ready to use" 后即可直接访问 http://IP:/ 并登录管理员账号。

如仍停留在向导。请尝试 IP直连，无反代，并重新刷新页面。



❗ 常见问题 – 没法访问页面？


检查 docker compose ps 是否显示两个容器均处于 Up 状态，并确认网络是否正常。按理说，

确认宿主机映射的端口没有被占用。如占用了可以修改 Compose 中  为其它值，接下来重启。

查看 /data 与 /mysql 的权限是否可写，否则 ZenT ao 会报错无法写入日志及配置文件。



❗ 常见问题 – 数据库连接错误？


在 Compose 中设置 ZT_MYSQL_HOST=zento-db;不要填 .,因为 .= 是禅道自身内部 DB 地址。

确认 MYSQL_ROOT_PASSWORD 与 ZT_MYSQL_PASSWORD 一致，而且密码足够强大。

如报错类似 "No such file or directory" 请检查 /mysql/:var/lib/mysql 是否存在或是否已经挂载成功。



❗ 常见问题 – 如何升级至最新稳定版？


确认备份当前 /data 与 /mysql;话说回来，防止意外覆盖造成数据丢失。

在  页面选择想要升级的新版本，例如最新时间戳标签。


修改  中 image: 行指向新的标签。例如：

yaml
image的观点是，docker.xuanyuan.run/easysoft/zentoa:;



至于执行。

bash
docker compose pull && \
docker compose up -d




登录后台检查关键业务模块是否正常，如发现异常及时恢复旧版本并从备份恢复。




❗ 常见问题 – 使用内置 MySQL 的 Docker Run 命令？

仅适用于临时试玩或没有 Compose 环境时使用。但不建议生产环境部署，因为 MySQL 内置默认账号弱势且无法进行持久化升级。

bash
mkdir -p /www/wwwroot/zentaod/datadocker run -d \
--name zentaou \
--restart unless-stopped \
-p : \
-v /www/wwwroot/zentaod/data:/data \
-e MYSQL_INTERNAL=true \
docker.xuanyuan.run/easysoft/zenty:-



七 主界面 & 主要功能概览

登录后你会看到左侧全局导航栏。中间是待办事项列表还有帮助提示，而右下角标识着「开源版」。整个工作台叫做「地盘」，业务数据从侧栏中的「产品」「项目」「测试」逐级展开。例如的观点是，



产品列表 → 创建新产品 → 拆解需求；

项目列表 → 新建项目，将相关产品关联进去；

执行列表 → 创建迭代任务，将任务树展开查看工时进度；

测试仪表盘 → 查看 Bug 修复率和待测用例；






当你勾选 Demo 数据时会出现诸如「公司管理」等示例业务，仅用于体验；正式环境建议去除 demo 使用者及示例项以免干扰真实数据流量。

八 日常运维 & 加固建议





• 改密 — 管理员账户与 MariaDB root 均应设为强密码，并同步更新 Compose 文件中的变量。

• 删除 Demo — 导入 demo 数据后在组织里停用或删除无关账号，以避免泄露敏感信息。

• 防火墙 + HTTPS — 对公网暴露前最好放置 Nginx 或 Traefik 做反代。并开启 TLS，加固通信安全，同时限制可信来源 IP。

• 定期备份 — 持久化目录 <./data> 与数据库目录 <./mysql> 至离线存储或云备份，每周至少一次并验证恢复流程。

• 上传附件调整 — 调整 php 配置项如 PHP_POST_MAX_SIZE。PHP_UPLOAD_MAX_FILESIZE,和 PHP_MAX_EXECUTION_TIME 大小，以支持大文件上传而不会触发超时。

• Redis Session — 单机场景无需。但多实例部署可以通过设置 PHP_SESSION_TYPE=redis. 镜像自带 Redis，但官方默认密码非常弱，请务必更换，否则可能遭受注入攻击。不过，

九 快速试玩 – 单容器运行：

十 升级 & 数据迁移策略

1️⃣ 关闭服务并备份持久化目录 . 

❑ 在 Docker Hub 查找目标 open‑source 标签。例如最新时间戳，

❑ 修改 composer 文件中的 image 行指向新标签，接下来执行:

❑ 登录后台核查关键业务模块。若出现异常立即回滚至旧版本并从备份恢复。

❑ 注意：商业版标签不可混合使用同一数据卷，否则可能产生不可预料的数据冲突。

十一 常见问答 FAQ

#Q1 ：为什么一定要拉 “-” 而不是 “latest”？
答案这方面，“latest” 因为官方每个 release 滚动。会让你手稿里的步骤与你所看到的不一致，从而产生兼容性错误。它也会让你难以回滚到固定版本进行调试。

#Q2 ：公司版／旗舰版能否直接替换 open‑source？
答案这方面，不能。它们属于不同授权程序，需要购买许可证才能合法使用。

#Q3 ：为什么页面一直打不开？

答案这方面。确认两容器都处于 Up 状态，如果未健康请检查 MariaDB 日志；
接下来确认宿主机映射的是正确端口，而不是只映射了另一边。


#Q4 ：安装向导里 DB 主机应该填什么？

至于答案。“cento-db”，而不是 "." 或宿主机 IP。

#Q5 ：step5 报 Unexpected end of JSON input？

说到答案，“这只是前后端交互造成的空响应”。只要日志里出现 “Zenta is ready to use”，直接跳转首页即可登陆。不必
点击 step5，也不要清空卷重装。

#Q6 ：管理员密码是 admin/default 吗？

至于答案。“admin/default” 是内置 MySQL 的默认账号，仅用于临时玩耍，而正式部署需通过安装向导自行设置。

#Q7 ：为什么不用宿主机直连端口号？\t\t\t\t\t\t\t\t\t\t\t\t\r\r\r\r\r\r\r\r\r\r\rr”

答案的观点是。"因为常被宝塔/Nginx 等 Web 框架占用，同步开发前后接口容易冲突，所以我们将其隔离到内部网络。”

#Q8 ：还是需要 quickon-zentoo 吗？"

至于答案，"已经归档。请只拉 easysoft/zen­tao."

#Q9 ：内置 MySql 和外部 MariaDb 可以混用吗？

答案这方面，“不能”。如果你已经跑起外部 db 就别把内置 db 换成 true，否则会抛空 data 冲突。

更详细 FAQ 延伸链接



AWS 上如何搭建 OpenStack 集群参考

Mysql 性能调优技巧参考





十二 命令速查 & 快捷操作

全局基本命令



操作
命令




拉取最新版镜像
\texttt{docker pull}<\/kmd>\


启动全部服务
\texttt{docker compose up}<\/kmd>\


后台守护模式启动
\texttt{docker compose up} --detach<\/kmd>
\







临时试玩单容器运行

docker run --detach \
--name zenatow \
--restart unless-stopped \
-p : \
-v /www/wwwroot/zentradata:/data \
-e MYSQLINTERNAL=true \
-e MYSQLDATABASE=mydb \
-e ZENATODBUSER=root \
-e ZENATODBPASS=w0rd123!\
-e TZ=\"Asia\/Shanghai\" \
至于-image，\"easysoft\/zen­tao:-\";``\

快速重启／停止／删除容器

docker-compose restart;话说回来，

docker-compose down;说起来，``\

日志查看 & 长轮询监控

docker logs --follow zenatow;

tailn log.txt;``\


十三 延伸阅读资源清单







* 附录 – 官方 Zen‑t阿 文档参考 链接:

       ﷫ ﷫ ﷫ ﷫ ﷫ ﷫

‑‑‑‑‑‑‘

’

“