idoop/zentao

禅道Docker镜像

镜像概述和主要用途

该Docker镜像用于快速部署禅道（Zentao）项目管理工具，支持开源版和专业版，集成了Apache、MySQL和PHP环境，提供开箱即用的部署体验，适用于团队项目管理、任务跟踪、缺陷管理等场景。

核心功能和特性

• 支持禅道开源版和专业版多版本标签
• 集成ZBOX环境（Apache+MySQL+PHP），无需额外配置基础服务
• 支持数据持久化存储，通过挂载卷保留配置和数据
• 提供环境变量配置，支持自定义数据库账号、密码及网络设置
• 内置升级机制，可通过更换镜像版本实现平滑升级

标签（Tags）

开源版

• 18.1,18.2,18.3,latest
• 17.0,17.1,17.2,17.3,17.4,17.5,17.6,17.6.1
• 16.0,16.1,16.2,16.3,16.4,16.5
• 15.2,15.3,15.4,15.5,15.6,15.7,15.7.1
• 15.0.1, 15.0.2,15.0.3,15.2
• 12.0, 12.0.1, 12.3, 12.3.2, 12.4.4, 12.5.3
• 11.3, 11.4.1, 11.5.1, 11.6, 11.6.1, 11.6.5, 11.7
• 10.0,10.1,10.3,10.4,10.5,10.6
• 9.6.3,9.7,9.8,9.8.3

专业版

• pro-8.7.1,pro
• pro-8.2,pro-8.3,pro-8.4,pro-8.5.1,pro-8.5.3
• pro-7.1,pro-7.3,pro-7.5.1
• pro-6.7.3

快速启动

开源版

bash
mkdir -p /data/zbox && \
docker run -d -p 80:80 -p 3306:3306 \
        -e ADMINER_USER="root" -e ADMINER_PASSWD="password" \
        -e BIND_ADDRESS="false" \
        -v /data/zbox/:/opt/zbox/ \
        --add-host smtp.exmail.qq.com:163.177.90.125 \
        --name zentao-server \
        idoop/zentao:latest

专业版

bash
mkdir -p /data/zbox && \
docker run -d -p 80:80 -p 3306:3306 \
        -e USER="root" -e PASSWD="password" \
        -e BIND_ADDRESS="false" \
        -v /data/zbox/:/opt/zbox/ \
        --add-host smtp.exmail.qq.com:163.177.90.125 \
        --name zentao-server-pro \
        idoop/zentao:pro

注意：确保主机的80端口和3306端口未被占用。

环境配置

环境变量说明

• ADMINER_USER：设置数据库Adminer账号
• ADMINER_PASSWD：设置数据库Adminer密码
• BIND_ADDRESS：若设为false，MySQL服务将不绑定地址
• SMTP_HOST：设置SMTP服务器IP和主机（解决邮件发送问题），也可通过docker-compose.yaml的extra_host或docker run的--add-host参数配置

默认账号信息

• 禅道Web登录管理员账号：admin，默认密码：*******
• MySQL root账号密码：*******，首次登录请修改密码

版本升级

若需升级禅道版本，只需使用最新镜像启动容器并挂载相同的zbox路径即可：

bash
# 停止并备份旧容器
docker stop zentao-server
docker rename zentao-server zentao-server-bak

# 备份zbox数据
cp -r /data/zbox /data/zbox-bak

# 拉取最新镜像
docker pull idoop/zentao:latest

# 使用最新镜像启动新容器（挂载相同路径）
docker run -d -p 80:80 -p 3306:3306 \
        -e ADMINER_USER="root" -e ADMINER_PASSWD="password" \
        -e BIND_ADDRESS="false" \
        -v /data/zbox/:/opt/zbox/ \
        --add-host smtp.exmail.qq.com:163.177.90.125 \
        --name zentao-server \
        idoop/zentao:latest

# 查看升级日志
docker logs -f zentao-server

升级过程日志示例：

Installed Zentao version: 11.0
New Zentao version: 11.4
Backuping config/my.php and upload ...
Upgrading Zentao ...
Restoring config/my.php and upload ...
Upgraded Zentao version to: 11.4
Please visit your Zentao website to complete the upgrade task.
ZBOX是Apache、Mysql、PHP的精简的集成环境。使用时，需要将其解压到/opt目录。

/opt/zbox/zbox -h     可以获取帮助
/opt/zbox/zbox start  启动脚本

Mysql 用户名root，密码为123456。

更多可以访问http://www.zentao.net/goto.php?item=zbox.
Start Apache success
Start Mysql success
Start xxd success

等待日志出现Start xxd success后，访问禅道网站完成升级向导。确认升级无误后，可删除备份：docker rm -f zentao-server-bak && rm -rf /data/zbox-bak

详细升级步骤参见：禅道官方文档

构建镜像

克隆仓库，如需自定义可修改Dockerfile或docker-entrypoint，然后执行构建命令：

bash
git clone https://github.com/idoop/zentao.git
cd zentao
# 可选：修改Dockerfile或docker-entrypoint
docker build -t zentao .

FAQ

升级或重启时插件自动移除？

启动容器时添加ZENTAO_VER环境变量（例如-e ZENTAO_VER="12.3.stable"），解决Dockerfile中的ZENTAO_VER与/opt/zbox/app/zentao/VERSION文件版本不一致的问题：

bash
docker run -d -p 80:80 -p 3306:3306 \
        -e ADMINER_USER="root" -e ADMINER_PASSWD="password" \
        -e BIND_ADDRESS="false" \
        -e ZENTAO_VER="12.3.stable" \
        -v /data/zbox/:/opt/zbox/ \
        --add-host smtp.exmail.qq.com:163.177.90.125 \
        --name zentao-server \
        idoop/zentao:latest

相关链接

• GitHub仓库：https://github.com/idoop/zentao
• DockerHub：https://hub.docker.com/r/idoop/zentao/
• 官方支持：[***]