一、禅道软件简介

禅道项目管理软件是一款国产开源项目管理软件。它集项目集管理、产品管理、项目管理、质量管理、DevOps、知识库、BI效能、工作流、学堂、反馈管理、组织管理和事务管理于一体，是一款专业的研发项目管理软件，完整覆盖了研发项目管理的核心流程。

禅道目前提供多种解决方案： 规模化敏捷解决方案、DevOps一体化解决方案、自动化测试解决方案，研发效能解决方案、禅道基于IM+AI的研发协同解决方案、企业创新能力解决方案、企业决策分析解决方案，让每一个项目都可实现高效管理。

二、安装方式

（一）使用禅道智能应用平台安装

禅道智能应用平台是一个开源轻量级应用交付平台。通过应用市场，可以一键安装企业级软件，不仅具备高可用特性，还支持自动与手动备份，当有新版本发布时，可以查看软件的更新日志，决定是否升级，快捷方便。

禅道智能应用平台特点

1. 云原生应用市场。这是禅道智能应用平台的核心功能，用户可以通过应用市场，选择和安装需要的应用。
2. 多租户。平台支持多租户管理，用户可将应用装在不同空间，各空间有独立资源配额与权限控制规则。
3. 服务管理。即对从应用市场安装的应用进行管理，可进行启动、关闭、重启、删除、升级等操作，查看输出日志。服务原生具高可用特性（多节点集群），单节点时能在服务出问题时重启。
4. 域名管理。服务安装时分配默认域名，可修改。若有自己的 DNS 服务，可将泛解析设到平台，用自己的域名地址。
5. 平台管理。平台集成命令行管理工具，支持一键安装与卸载及集群节点扩容，能方便查看后台服务运行状态。

在Linux系统中安装禅道智能应用平台

如果您刚接触禅道智能应用平台，建议使用我们提供的 All-in-One 安装模式, 它能够帮助您零配置快速部署。

1. 准备 Linux 机器

若要以 All-in-One 模式进行安装，您仅需参考以下对机器硬件和操作系统的要求准备一台主机。

1.1 硬件推荐配置

1.2 节点要求

• 节点必须能够通过SSH 连接。
• 节点上可以使用sudo/curl等基础命令。

1.3 容器运行时

您的集群必须有一个可用的容器运行时。 如果您使用 q 搭建集群, 会探测本地是否已安装docker, 如果已安装docker则使用docker, 否则将使用默认内置的containerd

1.4 网络和DNS要求

• 建议您的操作系统处于干净状态（不安装任何其他软件），否则可能会发生冲突。
• 支持访问公网，如果有网络访问控制，需要放行*.qucheng.com/*.qucheng.cn

2. 下载安装禅道智能应用平台命令行工具

curl -sfL https://pkg.qucheng.com/quickon/get.sh | sh -

执行脚本完成后, 检查是否安装成功

q version

3. 开始安装

在本快速入门教程中, 您只需执行一行命令即可进行安装, 其模板如下所示：

q init -p quickon

3.1 开源版

一般来说,对于All-in-One安装, 不需要修改任何配置。如果你想自定义集群网络、访问域名等高级的功能，可以通过参数来配置：

# 示例, 更多参数参考使用 q init --help
q init -p quickon --domain <自定义域名>

4. 验证安装结果

输出信息会显示Web控制台的IP地址和端口号, 默认的端口是32379 您可能需要配置端口转发规则并在安全组中开放端口，以便外部用户访问控制台。

（二）禅道官网下载安装

如何用Windows安装禅道

1. 下载windows一键安装包

进入禅道官网，进入 下载中心 ，下载对应版本的windows一键安装包。

2. 运行安装包

双击下载的文件解压到某一分区的目录下，进入 ZenTao 文件夹，点击 ZenTao.exe 文件启动面板。

注意：若安装包所在路径包含中文等特殊符号，启动禅道时会出现错误提示。需要修改路径后重新启动禅道。

3. 设置

点击设置按钮，可以卸载服务、查看服务、设置语言、查看帮助、检查更新、切换主题操作。

卸载服务时，会卸载运行控制面板里所有的服务。

4. Apache服务相关操作

Apache可以进行查看日志、修改端口、修改密码、安装服务、卸载服务、停止服务、启动服务、安装服务操作。

以上操作中除了查看日志，修改端口、重新安装都会重新启动Apache服务。

修改端口时，会自动检查端口是否被占用，如果被占用会有相应的提示并不可修改。

相关的操作，都可以通过查看日志或者右侧的面板日志来查看到。

5. Apache用户访问验证

系统默认不启用Apache用户访问验证，如果不需要，可跳过这一步。

如需Apache用户访问验证，需要勾选启用Apache用户访问验证，点击【访问禅道】，进入验证页面。在验证页面中输入用户名和密码，点击【登录】。

注：Apache用户访问验证的初始账号：zentao,密码：123456。

6. 登录禅道

Apache用户访问验证成功后，进入欢迎页面，点击页面中的【试用按钮】，进入登录页面。

在登录页面中输入用户名和密码，点击按钮【登录】。

初次默认的管理员账号是：用户名：admin  密码：123456。

7. 修改禅道密码

超级管理员登录禅道后，系统会自动检测密码安全级别，提示用户修改密码。按照提示进行修改后，点击按钮【保存】，即为修改成功。

如果需要维护密码安全设置可以到 后台—安全 页面中进行修改。

注意：从禅道18.12系列版本开始，禅道的Windows一键安装包不再集成git和svn。

如果需要使用集成git和svn功能，可下载集成包覆盖到禅道一键安装包的代码目录。

下载地址：https://dl.zentao.net/zbox/win/vcsbundle-2024.03.1-win64.exe

下载解压直接覆盖后，可以在ZenTao/bin 下查看到git 和sliksvn的文件夹。

（三）使用Docker 安装禅道

1. 环境准备

注意：

• 生产环境可以按照禅道的用户数以及项目的规模增减配置。
• 生产环境建议运行在Linux系统

查看Docker版本：

docker -v
Docker version 27.0.3, build 7d4bcd8

查看CPU架构：

uname -a
Linux nat7 6.6.13+bpo-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.6.13-1~bpo12+1 (2024-02-15) x86_64 GNU/Linux

2. 下载禅道镜像

目前支持在线下载和离线导入两种部署禅道镜像的方式，可根据自己环境进行选择。

2.1 在线下载

禅道镜像已放于Docker Hub上，地址为：https://hub.docker.com/r/easysoft/zentao/tags

可根据所需版本拉取对应版本的镜像，默认latest为禅道开源最新版本。

sudo docker pull [镜像名]:[镜像标签]

例如拉取禅道开源版20.3版本命令如下：

sudo docker pull hub.zentao.net/app/zentao:20.3

注意：

禅道版本和镜像tag对应关系如下：

2.2 离线导入

导入镜像步骤如下：

• 下载禅道镜像归档压缩包到U盘，或者刻录成光盘。
• 将U盘或光盘的禅道镜像归档复制到离线主机的临时目录， 如/tmp
• 解压并载入镜像：

# 命令实例
sudo gunzip -c [镜像归档文件名] | docker load
# 如：
sudo gunzip -c zentao_20.3.tar.gz | docker load
da07e39e2957: Loading layer [======================>]   85.5kB/85.5kB
feab8630a9c5: Loading layer [======================>]  11.73MB/11.73MB
d7508f92bff7: Loading layer [======================>]  86.37MB/86.37MB
5ca65d83e7b7: Loading layer [======================>]  80.38MB/80.38MB
ed0cfb41d961: Loading layer [======================>]  2.673MB/2.673MB
c00e8d737e49: Loading layer [======================>]   10.3MB/10.3MB
a186fa70a0c6: Loading layer [======================>]  7.121MB/7.121MB
95e38b2ff244: Loading layer [======================>]  7.473MB/7.473MB
f4afc75280d8: Loading layer [======================>]  191.7MB/191.7MB
60721d394939: Loading layer [======================>]   89.6kB/89.6kB
6db6be18e64c: Loading layer [======================>]  15.87kB/15.87kB
cf41eda4f35b: Loading layer [======================>]  191.7MB/191.7MB
Loaded image: hub.zentao.net/app/zentao:20.3

3. 启动禅道

3.1 创建docker网络驱动

sudo docker network create --subnet=[ip范围] [网络驱动名]

• ip范围：例如172.172.172.0/24的意思是，IP可以指定范围为172.172.172.1到172.172.172.254；
• 网络驱动名：创建的网络驱动名，可随意指定；

例如：

sudo docker network create --subnet=172.172.172.0/24 zentaonet

3.2 启动禅道容器

命令格式如下：

sudo docker run \
--name [容器名] \
-p [主机端口]:80 \
--network=[网络驱动名] \
--ip [容器IP] \
--mac-address [mac地址] \
-v [主机禅道目录]:/data \
-e MYSQL_INTERNAL=true \
-d hub.zentao.net/app/zentao:[镜像标签]

参数说明：

• 容器名：启动的容器名字，可随意指定；
• 主机端口：主机端口为web访问端口；
• 网络驱动名：上文创建的网络驱动名zentaonet；
• 容器IP：在网络驱动范围内选择一个作为该容器的固定ip；
• mac地址：指定固定的mac地址，建议范围为02:42:ac:11:00:00 到 02:42:ac:11:ff:ff；
• 主机禅道目录：必须指定，方便附件等数据的持久化；
• MYSQL_INTERNAL=true：启用容器内置MySQL，默认用户名为root，密码是123456
• 镜像标签：禅道版本

例如：在主机上创建空目录/data/zentao，执行如下命令

sudo docker run \
--name zentao \
-p 80:80 \
--network=zentaonet \
--ip 172.172.172.172 \
--mac-address 02:42:ac:11:00:00 \
-v /data/zentao:/data \
-e MYSQL_INTERNAL=true \
-d hub.zentao.net/app/zentao:20.3

sudo docker run \
--name zentao2 \
-p 8080:80 \
-p 3306:3306 \
--network=zentaonet \
--ip 172.172.172.173 \
--mac-address 02:42:ac:11:00:01 \
-e MYSQL_INTERNAL=true \
-v /data/zentao2:/data \
-d hub.zentao.net/app/zentao:20.3

3.3 查看容器是否启动成功

执行如下命令查看容器是否启动成功，如果没有则启动失败，去掉-d选项进行前台运行调试容器，如有任何问题请咨询禅道商务同事。

# 查看禅道容器
docker ps | grep zentao
# 查看禅道容器日志
docker logs -f zentao

4. 安装禅道

浏览器直接访问 http://宿主机ip:宿主机映射端口

最后根据提示进行操作，即可安装成功。 

欢迎下载使用禅道，如果在使用过程过中遇到任何问题，欢迎联系我们，我们会给予您及时的帮助。