一、禅道软件简介禅道项目管理软件是一款国产开源项目管理软件。
它集项目集管理、产品管理、项目管理、质量管理、DevOps、知识库、BI效能、工作流、学堂、反馈管理、组织管理和事务管理于一体，是一款专业的研发项目管理软件，完整覆盖了研发项目管理的核心流程。
禅道目前提供多种解决方案： 规模化敏捷解决方案、DevOps一体化解决方案、自动化测试解决方案，研发效能解决方案、禅道基于IM+AI的研发协同解决方案、企业创新能力解决方案、企业决策分析解决方案，让每一个项目都可实现高效管理。
二、安装方式（一）使用禅道智能应用平台安装禅道智能应用平台是一个开源轻量级应用交付平台。
通过应用市场，可以一键安装企业级软件，不仅具备高可用特性，还支持自动与手动备份，当有新版本发布时，可以查看软件的更新日志，决定是否升级，快捷方便。
禅道智能应用平台特点云原生应用市场。
这是禅道智能应用平台的核心功能，用户可以通过应用市场，选择和安装需要的应用。
多租户。
平台支持多租户管理，用户可将应用装在不同空间，各空间有独立资源配额与权限控制规则。
服务管理。
即对从应用市场安装的应用进行管理，可进行启动、关闭、重启、删除、升级等操作，查看输出日志。
服务原生具高可用特性（多节点集群），单节点时能在服务出问题时重启。
域名管理。
服务安装时分配默认域名，可修改。
若有自己的 DNS 服务，可将泛解析设到平台，用自己的域名地址。
平台管理。
平台集成命令行管理工具，支持一键安装与卸载及集群节点扩容，能方便查看后台服务运行状态。
在Linux系统中安装禅道智能应用平台如果您刚接触禅道智能应用平台，建议使用我们提供的 All-in-One 安装模式, 它能够帮助您零配置快速部署。
1. 准备 Linux 机器若要以 All-in-One 模式进行安装，您仅需参考以下对机器硬件和操作系统的要求准备一台主机。
1.1 硬件推荐配置操作系统最低配置Debian Bookworm(推荐) Bullseye2 核 CPU, 4 GB 内存, 40 GB 磁盘空间Ubuntu 22.04, 20.042 核 CPU, 4 GB 内存, 40 GB 磁盘空间1.2 节点要求节点必须能够通过SSH 连接。
节点上可以使用sudo/curl等基础命令。
1.3f 容器运行时您的集群必须有一个可用的容器运行时。
如果您使用 q 搭建集群, 会探测本地是否已安装docker, 如果已安装docker则使用docker, 否则将使用默认内置的containerd1.4 网络和DNS要求建议您的操作系统处于干净状态（不安装任何其他软件），否则可能会发生冲突。
支持访问公网，如果有网络访问控制，需要放行.qucheng.com/.qucheng.cn2. 下载安装禅道智能应用平台命令行工具

curl -sfL https://pkg.qucheng.com/quickon/get.sh | sh -执行脚本完成后, 检查是否安装成功q version3. de f 开始安装在本快速入门教程中, 您只需执行一行命令即可进行安装, 其模板如下所示：q init -p quickon3.1 开源版一般来说,对于All-in-One安装, 不需要修改任何配置。
如果你想自定义集群网络、访问域名等高级的功能，可以通过参数来配置：# 示例, 更多参数参考使用 q init --helpq 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. 环境准备环境与配置测试环境推荐配置备注Docker20版本20版本以上操作系统Linux或WindowsLinux镜像支持 x86_64 和 arm64 架构CPU1核心2核心内存1G4G硬盘10G50G以上注意：生产环境可以按照禅道的用户数以及项目的规模增减配置。
生产环境建议运行在Linux系统查看Docker版本：docker -vDocker version 27.0.3, build 7d4bcd8查看CPU架构：uname -aLinux nat7 6.6.13+bpo-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.6.13-1~bpo12+1 (2024-02-15) x86_64 GNU/Linux2. 下载禅道镜像目前支持在线下载和离线导入两种部署禅道镜像的方式，可根据自己环境进行选择。
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注意：为了方便国内用户拉取镜像，每次发版会在docker官方镜像仓库和禅道镜像仓库都推送镜像。
禅道版本和镜像tag对应关系如下：禅道版本镜像标签开源版以数字开头，如20.3企业版以biz开头，如biz10.2旗舰版以max开头，如max5.2IPD版以ipd开头，如ipd2.22.2 离线导入导入镜像步骤如下：下载禅道镜像归档压缩包到U盘，或者刻录成光盘。
将U盘或光盘的禅道镜像归档复制到离线主机的临时目录， 如/tmp解压并载入镜像：# 命令实例sudo gunzip -c [镜像归档文件名] | docker load# 如：sudo gunzip -c zentao_20.3.tar.gz | docker loadda07e39e2957: Loading layer [======================>] 85.5kB/85.5kBfeab8630a9c5: Loading layer [======================>] 11.73MB/11.73MBd7508f92bff7: Loading layer [======================>] 86.37MB/86.37MB5ca65d83e7b7: Loading layer [======================>] 80.38MB/80.38MBed0cfb41d961: Loading layer [======================>] 2.673MB/2.673MBc00e8d737e49: Loading layer [======================>] 10.3MB/10.3MBa186fa70a0c6: Loading layer [======================>] 7.121MB/7.121MB95e38b2ff244: Loading layer [======================>] 7.473MB/7.473MBf4afc75280d8: Loading layer [======================>] 191.7MB/191.7MB60721d394939: Loading layer [======================>] 89.6kB/89.6kB6db6be18e64c: Loading layer [======================>] 15.87kB/15.87kBcf41eda4f35b: Loading layer [======================>] 191.7MB/191.7MBLoaded image: hub.zentao.net/app/zentao:20.33. 启动禅道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 zentaonet3.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注意：如果需要远程连接数据库，可以增加一个端口映射 -p [主机端口]:3306如果在单个主机上部署多个禅道系统，只需要指定不同的 [容器名]、[主机端口]、[容器IP]、[mac地址]、[禅道目录]即可部署多个禅道系统，例如：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.33.3 查看容器是否启动成功执行如下命令查看容器是否启动成功，如果没有则启动失败，去掉-d选项进行前台运行调试容器，如有任何问题请咨询禅道商务同事。
# 查看禅道容器docker ps | grep zentao# 查看禅道容器日志docker logs -f zentao4. 安装禅道浏览器直接访问 http://宿主机ip:宿主机映射端口最后根据提示进行操作，即可安装成功。
欢迎下载使用禅道，如果在使用过程过中遇到任何问题，欢迎联系我们，我们会给予您及时的帮助。