一、禅道简介

1. 禅道是什么？功能强大的项目管理软件。

禅道是一款专业的国产开源研发项目管理软件，集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体，完整覆盖了研发项目管理的核心流程。

管理思想基于国际流行的敏捷项目管理方法——Scrum，在遵循其价值观的基础上，结合国内项目研发现状，整合了任务管理、需求管理、Bug 管理、用例管理等多种功能，覆盖软件从计划到发布的整个生命周期。

禅道分为多个版本，主要有开源版、专业版、企业版。开源版免费且开放源代码，可二次开发；专业版在开源版基础上增加增强功能，更适合企业内部流程化管理；企业版在专业版功能上，增加了运维管理、OA 办公管理、反馈管理和文档的版本管理、在线预览等功能，为企业项目管理流程提供更全面的支撑。

2. 为什么选择禅道进行项目管理？

首先，禅道功能全面。它涵盖了任务管理、需求管理、Bug 跟踪、版本控制、团队协作、项目报表等各个方面。任务管理功能可帮助项目经理分配任务和跟踪进度；需求管理功能能收集和管理用户需求；Bug 跟踪功能提高产品质量；版本控制功能确保项目稳定性；团队协作功能提升团队效率；项目报表功能辅助决策。

其次，禅道具有开源性质。对于小型公司和初创公司来说，免费且可根据自身需要定制的禅道尤为重要。同时，强大的社区支持使用户能获取帮助、分享经验，促进软件的持续改进和升级。

再者，禅道高度可定制。用户可以根据自己的需要，对禅道的界面、功能、工作流程等进行定制，使其更好地满足不同公司的管理场景。

总之，禅道以其全面的功能、开源性质、高度可定制性和强大的社区支持，成为众多企业进行项目管理的理想选择。

二、安装方式总览

1. 多种安装方式介绍，如智能应用平台安装、官网下载安装、Docker 安装等。

禅道提供了多种安装方式，以满足不同用户的需求。

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

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

其特点包括云原生应用市场、多租户管理、服务管理、域名管理和平台管理等。在 Linux 系统中安装禅道智能应用平台，若刚接触，建议使用 All-in-One 安装模式，能够零配置快速部署。首先准备一台符合要求的 Linux 机器，节点必须能够通过 SSH 连接，且可以使用 sudo、curl 等基础命令，集群必须有一个可用的容器运行时。然后下载安装禅道智能应用平台命令行工具，执行安装命令，最后验证安装结果，开放端口以便外部用户访问控制台。

（2）禅道官网下载安装

对于 Windows 系统，可进入禅道官网的下载中心，下载对应版本的 windows 一键安装包。双击安装包解压到某一分区的目录下，进入 ZenTao 文件夹，点击 ZenTao.exe 文件启动面板。但要注意，若安装包所在路径包含中文等特殊符号，启动禅道时会出现错误提示，需修改路径后重新启动禅道。安装完成后，可进行设置操作，如卸载服务、查看服务、设置语言等。同时，系统默认不启用 Apache 用户访问验证，若需要可勾选启用，输入初始账号 zentao 和密码 123456 进行登录。

（3）使用 Docker 安装禅道

首先获取禅道最新版本的镜像 Tag，可访问禅道官网查询所安装版本的最新版本编号，或访问 Docker Hub，查看最新版本的 Tag。然后进行备份，可通过禅道后台备份或命令行备份。备份完成后，停止旧版禅道容器并清理，再启动新版镜像。此外，还可以通过脚本控制禅道容器或使用 Docker compose 维护禅道容器。

三、禅道智能应用平台安装

1. 准备 Linux 机器，硬件和操作系统要求。

禅道智能应用平台在 Linux 系统中的安装对机器硬件和操作系统有一定要求。操作系统方面，推荐使用 Debian Bookworm 或 Bullseye，最低配置为 2 核 CPU、4GB 内存和 40GB 磁盘空间；Ubuntu 22.04 或 20.04 同样要求 2 核 CPU、4GB 内存和 40GB 磁盘空间。

节点必须能够通过 SSH 连接，并且节点上可以使用 sudo、curl 等基础命令。同时，集群必须有一个可用的容器运行时。如果使用 q 搭建集群，会探测本地是否已安装 docker，如果已安装 docker 则使用 docker，否则将使用默认内置的 containerd。

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

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

下载安装禅道智能应用平台命令行工具非常简单，只需执行一行命令：

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

。执行脚本完成后，可以通过输入

q version

来检查是否安装成功。

3. 开始安装及参数配置。

在本快速入门教程中，安装禅道智能应用平台只需执行一行命令即可进行安装，其模板如下所示：q init -p quickon。

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

# 示例, 更多参数参考使用 q init --help

，或者

q init -p quickon --domain <自定义域名>

来进行高级配置。

4. 验证安装结果。

安装完成后，输出信息会显示 Web 控制台的 IP 地址和端口号，默认的端口是 32379。此时，可能需要配置端口转发规则并在安全组中开放端口，以便外部用户访问控制台。这样可以确保禅道智能应用平台能够被外部用户正常访问和使用，实现高效的项目管理和团队协作。

四、禅道官网下载安装（Windows）

1. 下载 windows 一键安装包。

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

2. 运行安装包及注意事项。

双击下载的文件解压到某一分区的目录下，进入 ZenTao 文件夹，点击 ZenTao.exe 文件启动面板。注意：若安装包所在路径包含中文等特殊符号，启动禅道时会出现错误提示。需要修改路径后重新启动禅道。

3. 设置功能详解。

点击设置按钮，可以卸载服务、查看服务、设置语言、查看帮助、检查更新、切换主题操作。卸载服务时，会卸载运行控制面板里所有的服务。语言支持中文简体、中文繁体、English。主题支持蓝色、绿色、粉色。

4. Apache 服务相关操作。

Apache 可以进行查看日志、修改端口、修改密码、安装服务、卸载服务、停止服务、启动服务、重新安装安装操作。以上操作中除了查看日志，修改端口、重新安装都会重新启动 Apache 服务。修改端口时，会自动检查端口是否被占用，如果被占用会有相应的提示并不可修改。相关的操作，都可以通过查看日志或者右侧的面板日志来查看到。

5. Apache 用户访问验证。

系统默认不启用 Apache 用户访问验证，如果不需要，可跳过这一步。如需 Apache 用户访问验证，需要勾选启用 Apache 用户访问验证，点击【访问禅道】，进入验证页面。在验证页面中输入用户名和密码，点击【登录】。注：Apache 用户访问验证的初始账号：zentao,密码：123456。

6. 登录禅道及修改密码。

Apache 用户访问验证成功后，进入欢迎页面，点击页面中的【试用按钮】，进入登录页面。在登录页面中输入用户名和密码，点击按钮【登录】。初次默认的管理员账号是：用户名：admin 密码：123456。超级管理员登录禅道后，系统会自动检测密码安全级别，提示用户修改密码。按照提示进行修改后，点击按钮【保存】，即为修改成功。

五、禅道官网下载安装（Linux）

1. 下载对应版本安装包。

访问禅道官网，选择合适的版本进行下载。禅道提供了多种版本供用户选择，用户可以根据自己的需求和系统环境选择相应的安装包。一般来说，64 位的 Linux 系统可以选择对应的 64 位安装包，32 位系统则选择 32 位安装包。

2. 安装步骤详解。

• 首先，将下载好的安装包放到

   /opt 

  目录下，使用命令解压上面下载的安装包，例如：

  tar -zxvf ZenTaoPMS.xxx.zbox_64.tar.gz

  。

• 然后，在

   /opt/zbox

  目录下通过

   ./zbox start 

  命令就可以启动自带 Apache 和 MySQL 了。如果不在安装目录下，也可以通过全路径的方式来启动，如

   /opt/zbox/zbox start

  。需要注意的是，启动禅道会默认启动禅道内的 Tomcat 和 MySQL，默认使用的端口分别是 80 和 3306。如果服务器上这两端口被占用或端口未开放（防火墙），可以先不启动禅道。

• 若启动成功可直接访问：服务器 ip 便能看到禅道页面。

3. 配置与优化。

• 端口修改：若默认配置未启动成功，可以进行端口修改。例如，通过以下命令修改 Apache 服务器的端口号为 8080：

  /opt/zbox/zbox -ap 8080

  ；修改 mysql 服务器的端口号为 8090：

  /opt/zbox/zbox -mp 3307

  。接着，使用以下命令开放端口：

  firewall-cmd --zone=public --add-port=8080/tcp --permanent

  （开放 Apache 端口）和

  firewall-cmd --zone=public --add-port=3307/tcp --permanent

  （开放 MySQL 端口），然后执行

  firewall-cmd --reload

  重启防火墙，最后通过

  /opt/zbox/zbox restart

  重启禅道。

• 数据库配置：对于配置自带数据库，有兴趣的用户可自行探索。例如，可以给禅道自带的 MySQL 中开一个用户，使用

   /opt/zbox/auth/adduser.sh

  命令开一个权限，输入新用户的用户名密码。还可以修改

  my.cnf

  文件，进入

  /opt/zbox/etc/mysql

  目录进行操作。

• 远程连接设置：对于 navicat 远程连接 linux 禅道 mysql，可以进行以下设置。首先，修改 mysql 数据库 user 表 root 用户的 host 值为

  %

  ，执行命令

   /opt/zentao/bin/mysql -uroot -p123456

  ，进入数据库后执行

  use mysql;update user set host='%' where user='root';select host,user from user;

  （报错不用管），然后执行flush privileges进行刷新。若远程登录仍提示错误，可以执行

  /opt/zentao/bin/mysql -uroot -p123456

  ，进入数据库后执行

  use mysql;grant all privileges on. to 'root'@'%' identified by '123456' with grant option;flush privileges;

  。如果还是不行，可以检查

  my.cnf

  文件，在

  bind-address=127.0.0.1

  行前加#注释，重启禅道，此时 navicat 远程连接可能成功。

六、Docker 方式部署禅道

1. 介绍 Docker 部署的优势。

Docker 部署禅道具有诸多优势。首先，隔离性强，每个容器都是独立运行的，可以避免依赖冲突和版本问题。其次，可移植性好，容器可以在不同的操作系统和硬件平台上运行。操作简便，容器化的应用程序可以快速部署、启动和停止，以及进行扩展和更新。据统计，使用 Docker 部署禅道可以将安装和配置时间缩短 50%以上，大大提高了部署效率。

2. 具体部署步骤。

• 安装 Docker：在 Linux 系统中安装 Docker 非常简单，可以按照以下步骤进行。更新系统软件包，执行

  sudo apt-get update

  ；安装 Docker，执行

  sudo apt-get install docker-ce

  ；启动 Docker 服务，执行

  sudo systemctl start docker

  ；验证安装，执行sudo docker version。

• 下载禅道镜像：访问 dockerhub 链接，查看最新版本的禅道镜像，例如执行

  docker pull easysoft/zentao:12.5.2

  下载镜像。

• 创建持久化目录：执行

  mkdir -p /data/zentao/pms /data/zentao/mysql/data

  创建用于存储禅道数据和 MySQL 数据的目录。

• 启动禅道容器：执行

  docker run --name zentao -p 80:80 -v /data/zentao/pms:/www/zentaopms -v /data/zentao/mysql/data:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=abcd@1234 -d easysoft/zentao:12.5.2

  启动禅道容器，将容器的 80 端口映射到主机的 80 端口，并将容器命名为“zentao-app”。

3. 升级与维护配置。

3.1升级禅道：升级新版前，请详细阅读禅道升级日志，全面了解新版本特性，确定是否升级。升级前，请做好数据备份，并确定备份文件的有效性。请选择业务低峰时段进行升级，以免备份或升级过程影响正常访问。具体步骤如下：

• 获取最新版镜像：访问禅道官网查询所安装版本的最新版本编号，或访问 Docker Hub，查看最新版本的 Tag。例如拉取 18.5 的镜像，执行

  docker pull hub.zentao.net/app/zentao:18.5

  。

• 备份：可以通过禅道后台备份或命令行备份。禅道后台备份适用于数据量较小的情况，如果数据量超过 10G，建议通过命令行进行备份。命令行备份步骤如下：先查看本机有足够的空间进行备份，执行

  df -h

  ；查看运行的容器，执行

  docker ps

  ；进入禅道容器，执行

  docker exec -it <禅道容器名或禅道容器 ID> bash

  ；进入禅道容器的 bin 目录，执行

  cd /apps/zentao/bin

  ；生成备份脚本，执行

  bash init.sh

  ，根据提示输入 PHP 路径和禅道 URL；执行备份脚本，执行bash backup.sh。

• 停止旧版禅道容器并清理：

  执行docker stop <旧版禅道容器名或 ID>

  停止旧版容器，执行

  docker rm <旧版禅道容器名或 ID>

  清理停止的容器。

• 启动新版镜像：执行

  docker run -d --name <新版禅道容器名> -v /data/zentao:/data -p <主机端口>:80 -p <主机端口>:3306 -e MYSQL_INTERNAL=true hub.zentao.net/app/zentao:<新版镜像 Tag>

  启动新版禅道容器。

3.2维护配置：可以通过脚本控制禅道容器或使用 Docker compose 维护禅道容器。

• 通过脚本控制禅道容器：禅道容器运行命令的参数比较多，建议写个 bash 脚本，控制禅道容器的关闭与启动。例如以下示例脚本 zentao_ctl.sh：

#!/bin/bash

action=${1:?Usage: $0 <start|stop>}

action=${action,,}

Tag="18.5"

case $action in

"start")

docker run -d \\

--name zentao \\

-v /data/zentao:/data \\

-p 8080:80 \\

-p 13306:3306 \\

-e MYSQL_INTERNAL=true \\

hub.zentao.net/app/zentao:${Tag:-latest};;

"stop")

docker stop zentao \\

&& docker rm zentao;;

*)

echo "Usage: $0 <start|stop>";

esac

• 通过 Docker compose 维护禅道容器：Docker 从 20 版本开始支持插件机制，建议安装 compose 插件，Windows 系统需要独立下载 docker-compose 命令。创建 docker-compose.yml 文件：

version: '2'

networks:

zentao-net:

driver: bridge

ipam:

driver: default

config:

- subnet: 172.16.8.0/24

gateway: 172.16.8.254

services:

# zentao service

zentao:

image: hub.zentao.net/app/zentao:18.5

container_name: zentaoports:

- '8080:80'

volumes:

- /data/zentao:/data

environment:

- MYSQL_INTERNAL=true

- PHP_MAX_EXECUTION_TIME=120

- PHP_MEMORY_LIMIT=512M

- PHP_POST_MAX_SIZE=128M

- PHP_UPLOAD_MAX_FILESIZE=128M

mac_address: 02:42:ac:11:00:ff

networks:

zentao-net:

ipv4_address: 172.16.8.8

启动禅道容器，执行

docker compose up -d

，查看日志，停止容器。

七、代码安装步骤演示（Windows）

1. 准备工作及环境要求。

在安装禅道之前，确保你的 Windows 系统满足以下要求：

• 确保系统有足够的磁盘空间，建议至少有 1GB 的可用空间。

• 如果电脑没有安装过 VC 运行环境，安装禅道时可能会提示安装 VC++环境，所以最好提前安装好 VC++运行环境。

2. 下载安装包及解压。

• 进入禅道官网，进入下载中心，下载对应版本的 windows 一键安装包。例如，下载地址：https://www.zentao.net/downloads.html。

• 双击下载的文件，将其解压到某一分区的根目录，比如 E:\xampp 或 D:\xampp，必须是根目录。

3. 修改配置文件。

• 修改数据库密码：禅道服务启动后，会提示修改数据库密码。可以在控制运行面板左上角服务–修改数据库密码里查看到当前的数据库密码。也可以在 xampp/zentao/config/my.php 里查看到数据库密码。如需增强数据库的安全性，可以点击 MySQL 服务器下拉菜单中的修改密码，弹窗中会显示默认账户和密码，你可以修改设置新的密码，点按钮【确定】后，数据库密码自动修改。注意：数据库密码须 6 - 12 位，包括大写字母 + 小写字母 + 数字。

• Apache 用户访问验证：系统默认不启用 Apache 用户访问验证，如果不需要，可跳过这一步。如需 Apache 用户访问验证，需要勾选启用 Apache 用户访问验证，点击【访问禅道】，进入验证页面。在验证页面中输入用户名和密码，点击【登录】。注：Apache 用户访问验证的初始账号：zentao,密码：123456。

4. 安装过程中的常见问题及解决方法。

问题一：启动禅道时提示安装 VC++环境。

• 解决方法：按照提示安装 VC++运行环境即可。可以从微软官方网站下载相应的 VC++安装包进行安装。

问题二：安装包所在路径包含中文等特殊符号时启动禅道出现错误提示。

• 解决方法：修改路径，将安装包解压到不包含中文、下划线等特殊符号的分区根目录，如 E:\xampp 或 D:\xampp，然后重新启动禅道。

问题三：端口被占用。

• 解决方法：有两种方法。一.请删除当前 xampp 包，然后下载 windows 一键安装包（未加安全设置）的包安装使用。二.在传统界面同时按下 Win 键 + R 键，在搜索框中输入 msconfig 然后按回车键。点击”服务”标签卡，选择”隐藏所有的微软服务”，然后点击全部禁用。点击”启动”标签卡, 点击”打开任务管理器”，然后禁用全部启动项并确定。然后重新启动计算机。当弹出“系统配置实用程序”的时候，选中此对话框中的”不再显示这条信息”并点击确定即可。

八、代码安装步骤演示（Linux）

1. 系统准备及依赖安装。

在进行禅道的代码安装之前，需要确保 Linux 系统满足一定的要求并安装必要的依赖。首先，确保系统有足够的磁盘空间，建议至少有 2GB 的可用空间，以保证安装过程的顺利进行以及后续禅道的正常运行。

禅道在 Linux 系统中的安装通常需要依赖一些软件包，如 httpd（Apache 服务器）、mariadb（数据库服务器）和 php 及其相关扩展。以 CentOS 7 系统为例，可以使用以下命令安装这些依赖：

yum -y install httpd

yum -y install mariadb mariadb-server

yum -y install php php-pdo php-mysql php-mbstring php-ldap php-gd php-json php-xml php-zip

安装完成后，启动 httpd 服务和 mariadb 服务，并设置为开机自启动：

systemctl start httpd.service

systemctl enable httpd.service

systemctl start mariadb.service

systemctl enable mariadb.service

2. 下载与解压安装包。

访问禅道官网，找到“下载链接”，点击“安装包下载”中的“源码包”即可下载禅道安装包。将下载好的安装包上传到服务器上的/opt目录中。然后使用以下命令解压安装包：

cd /opt

tar -zxvf ZenTaoPMS.xxx.zbox_64.tar.gz

3. 配置文件修改及服务启动。

• 数据库配置：数据库安装设置，重置数据库 root 账号密码，执行该命令前必须开启 mariadb 服务。命令：

mysql_secure_installation

若结果显示“Enter current password for root (enter for none):”，则输入当前 root 账号密码，刚安装默认为空，直接回车即可。“Set root password? [Y/n]”，输入 y 回车。“New password:”，输入密码。“Re-enter new password:”，重复输入密码。“Remove anonymous users? [Y/n]”，输入 y 回车。“Disallow root login remotely? [Y/n]”，输入 y 回车。“Remove test database and accessto it? [Y/n]”，输入 y 回车。“Reload privilege tables now? [Y/n]”，输入 y 回车。

• 服务启动：启动禅道服务前，可以先检查一下端口是否被占用。如果禅道默认使用的端口（80 和 3306）被占用，可以通过修改配置文件来更改端口。例如，修改禅道安装目录下的配置文件，找到对应的端口设置项，将其修改为未被占用的端口。

启动禅道服务：

/opt/zbox/zbox start

若结果显示“Start Apache success Start Mysql success”，则启动成功。

4. 故障排除与优化。

故障排除：

• 如果启动禅道服务时出现问题，可以查看禅道的日志文件，通常位于禅道安装目录下的某个特定位置，以查找错误信息并进行相应的故障排除。例如，如果出现数据库连接问题，可以检查数据库配置是否正确，包括数据库用户名、密码、端口等。

• 若输入服务器 IP 地址后无法访问网页，可以做以下处理：关闭 selinux 和防火墙，刷新网页重新进入。临时关闭防火墙命令：

  systemctl stop firewalld

  ；永久关闭防火墙命令：

  systemctl disable firewalld

  。临时关闭 selinux 命令：

  setenforce 0

  ；永久关闭 selinux 命令：

  sed -ri 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config

  。禅道使用的是 apache 服务，查看 80 端口是否被占用。查看 80 端口命令：

  lsof -i:80

  ，如没有 lsof 请下载，命令：

  yum -y install lsof

  。

优化：

• 可以考虑对禅道的性能进行优化。例如，可以调整数据库的缓存大小、优化数据库查询语句等。同时，定期备份禅道的数据，以防止数据丢失。可以使用禅道自带的备份功能或者通过数据库工具进行备份。

• 对于大规模使用禅道的情况，可以考虑使用负载均衡技术，将请求分发到多个禅道服务器上，以提高系统的可用性和性能。据统计，使用负载均衡技术可以将禅道的响应时间缩短 30%以上，大大提高了用户体验。

九、安装后的配置与优化

1. 个性化设置

在禅道中，用户可以根据自己的喜好和习惯进行个性化设置。禅道 15 版本中，增加了对需求概念的选择。用户可以在“后台”-“模型”-“需求概念”下，根据团队的喜好和习惯选择使用软件需求、研发需求、软需、故事和需求等作为在禅道中显示的概念。管理员还可以添加需求概念，点击“设置需求概念”，在输入框中填写概念，点击“保存”，可以在软需列表中看到刚刚添加的概念。其他用户登陆时，可以在“个性化设置”中进行设置。如果用户没有在“个性化设置”下对需求概念进行设置，那么将默认使用“研发需求”的概念。设置后，可以看到产品下的需求概念已经发生变化。

2. 性能优化策略

禅道的性能优化可以从多个方面进行。首先，可以优化项目集列表及产品列表的加载性能。如禅道 18.4.beta1 发布，优化了项目集列表及产品列表的加载性能，修复了 18.4.alpha1 版本 Bug。同时，优化离线本地化使用禅道的性能。对于大数据量的情况，可以考虑使用禅道新版 App1.2 版本，该版本优化了移动端的性能，兼容禅道最新版本，确保在大数据量的情况下可以稳定和流畅运行。此外，还可以优化地盘仪表盘的加载性能，提高用户体验。

3. 安全设置

在“后台”-“安全”中，可以对密码安全及弱口令进行设置。在“后台”-“安全”-“弱口令扫描”中，会列出弱口令用户的信息。禅道安装部署的域名、禅道用户账户、禅道用户密码、禅道配置的参数请求方式等信息需要妥善保管，避免泄露。同时，设置强密码，关闭密码检查、关闭强制修改弱密码、关闭强制首次登录修改密码等操作可以提高系统的安全性。例如，登录后台管理系统，找到“后台”-“安全”-“密码安全设置”，进行相应的设置。如果调用禅道 SDK 类中方法出现错误提示“Trying to get property of non-object”，通常由需要修改密码、没有操作权限、缺失参数等情况造成，可以根据具体情况进行解决。如果出现错误提示“Fatal error Uncaught Error Call to undefined function curl_init()”，则是由于当前 PHP 缺失了 curl 的扩展，安装这个 PHP 扩展即可恢复正常使用。

十、常见问题及解决办法

1. 安装过程中错误提示解读。

在安装禅道的过程中，可能会遇到各种错误提示。以下是一些常见错误提示的解读及解决方法：

错误提示：安装包所在路径包含中文等特殊符号时启动禅道出现错误提示

• 原因：禅道在处理包含中文等特殊符号的路径时可能会出现兼容性问题。

• 解决方法：修改路径，将安装包解压到不包含中文、下划线等特殊符号的分区根目录，如 E:\xampp 或 D:\xampp，然后重新启动禅道。

错误提示：启动禅道时提示安装 VC++环境

• 原因：系统缺少 VC++运行环境。

• 解决方法：按照提示安装 VC++运行环境即可。可以从微软官方网站下载相应的 VC++安装包进行安装。

2. 无法启动服务的排查方法。

如果禅道服务无法启动，可以按照以下步骤进行排查：

• 检查 MySQL 服务状态：禅道的运行依赖 MySQL 数据库服务。可以通过以下命令检查 MySQL 服务的状态：

  sudo systemctl status mysql

  。如果 MySQL 服务未运行，可以使用以下命令启动它：

  sudo systemctl start mysql

  。

• 检查配置文件：确认禅道的配置文件是否正确。例如，在 Linux 系统中，检查禅道安装目录下的配置文件，确保数据库连接信息、端口设置等参数正确。

• 检查端口占用情况：如果禅道默认使用的端口（如 80 和 3306）被其他服务占用，禅道将无法启动。可以使用以下命令检查端口占用情况：

  netstat -ano | findstr :端口号

  。如果发现有其他服务使用了该端口，可以考虑更改禅道的默认端口或停止冲突的服务。

• 检查数据目录权限：确保禅道服务有权限访问数据目录。在 Linux 系统中，可以使用以下命令检查和修改数据目录权限：

  sudo chown -R 禅道服务用户:禅道服务用户组 /数据目录

  。

3. 版本升级问题处理。

禅道的版本升级可能会遇到一些问题，以下是常见问题及解决方法：

问题：升级过程中报错，显示“SQLSTATE[23000]: Integrity constraint violation:1062 Duplicate entry 'system-common--CRExecution' for key 'unique'”

• 解决方法：假设原 xampp 文件夹备份两份（防止再次出错）。解决步骤如下：首先找到报错的 SQL 语句，即

  UPDATE zt_config SET key = 'CRExecution' WHERE module = 'common' AND key = 'CRProject'

  。然后根据具体情况进行数据库表的调整或修复，确保升级过程中数据的完整性。

问题：升级后 BI 功能数据访问不到了

• 原因：可能是升级过程中数据库结构变化导致 BI 板块的数据丢失或无法正常访问。

• 解决方法：首先需要确定禅道开源版 18.1 升级到 18.10 后 BI 板块的数据不见了的具体原因。如果是后台关联的 MySQL 表出现问题，可以检查 MySQL 数据库中的相关表结构和数据。同时，可以按照禅道的升级文档进行排查，确保升级过程中的每一个步骤都正确执行。如果问题仍然存在，可以寻求禅道官方社区的帮助，或者联系禅道技术支持人员进行解决。

问题：升级后任务列表显示不出来，部分数据丢失

• 原因：可能是升级过程中数据迁移不完整或出现错误。

• 解决方法：对于开源版 18.2 源码包升级至 18.10 后出现的任务列表显示不出来和执行阶段下拉列表不能正常显示、加载数据的问题，可以尝试重新执行升级步骤，确保数据的完整性。同时，可以检查数据库中的相关表结构和数据，看是否存在异常。如果问题仍然存在，可以参考禅道的升级文档或在禅道官方社区中寻求帮助。

十一、总结与展望

1. 禅道安装部署的要点回顾。

禅道作为一款功能强大的项目管理软件，提供了多种安装方式，包括禅道智能应用平台安装、官网下载安装（Windows 和 Linux 系统）以及 Docker 方式部署。每种安装方式都有其特定的步骤和注意事项。

在禅道智能应用平台安装中，需准备符合要求的 Linux 机器，下载安装命令行工具，并进行参数配置和验证安装结果。官网下载安装 Windows 版本时，要注意安装包路径不能包含特殊符号，设置功能丰富，还涉及 Apache 服务相关操作和用户访问验证。Linux 版本的官网下载安装则需选择合适版本的安装包，按照详细步骤进行安装、配置和优化，如端口修改、数据库配置和远程连接设置等。Docker 方式部署具有隔离性强、可移植性好和操作简便等优势，具体部署步骤包括安装 Docker、下载禅道镜像、创建持久化目录和启动禅道容器，同时还涉及升级与维护配置的方法。

代码安装步骤演示中，Windows 系统要满足环境要求，下载安装包并解压，修改配置文件，解决安装过程中的常见问题。Linux 系统则需进行系统准备及依赖安装，下载与解压安装包，进行数据库配置和服务启动，以及故障排除与优化。安装后的配置与优化包括个性化设置、性能优化策略和安全设置等方面。

2. 未来禅道发展及应用前景。

随着科技的不断发展，禅道在未来有着广阔的发展及应用前景。一方面，禅道将持续集成先进的技术，如人工智能技术在测试管理中的应用将更加深入。像目前已经有禅道版本推出了基于 AI 技术的功能，如缺陷预测分析、智能分配任务和自动生成测试用例等。未来，AI 技术将进一步提升禅道的自动化程度和智能化水平，帮助项目团队更高效地进行项目管理和质量控制。

另一方面，禅道将不断优化性能和用户体验。在性能优化方面，将继续改进项目集列表及产品列表的加载性能、优化离线本地化使用禅道的性能以及地盘仪表盘的加载性能等。同时，随着移动端应用的普及，禅道的移动端版本也将不断升级，以更好地满足用户在移动办公场景下的需求。

在应用领域方面，禅道将不仅仅局限于软件研发项目管理，还可能拓展到更多的行业和领域。例如，在制造业、服务业等行业中，禅道可以帮助企业进行项目进度管理、质量控制和团队协作，提高企业的运营效率和竞争力。

此外，禅道的开源性质将吸引更多的开发者参与到软件的改进和创新中来。社区的不断壮大将为禅道的发展提供持续的动力，推动禅道成为全球领先的项目管理软件。

总之，禅道在未来将继续发挥其强大的功能和优势，为企业的项目管理和团队协作提供更加高效、智能的解决方案。