CentOS7上如何快速搭建禅道项目管理系统？

禅道是一款优秀的国产开源项目管理软件,它集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体，覆盖了项目管理的核心流程，对于使用CentOS系统的开发团队而言，搭建一套稳定、高效的禅道环境至关重要，本文将详细介绍在CentOS系统上通过一键安装包部署禅道的完整流程，并提供后续维护与常见问题的解决方案，帮助您快速构建起专业的项目管理平台。

准备工作

在开始安装之前,请确保您的服务器环境满足以下基本要求，这将有效避免安装过程中可能出现的问题。

系统要求

• 操作系统：推荐使用CentOS 7.x或CentOS 8.x的64位版本，系统应保持纯净，最小化安装为佳，以减少潜在的端口冲突和软件依赖问题。
• 硬件配置：根据团队规模和使用频率，建议至少配备2核CPU、4GB内存和20GB的可用磁盘空间，生产环境建议配置更高。
• 用户权限：需要拥有root权限或sudo权限，以便执行系统级的安装和配置命令。

获取禅道安装包
禅道官方为Linux系统提供了一键安装包，该版本内置了Apache、MySQL、PHP等运行所需的环境，无需用户单独编译安装，极大地简化了部署流程。

• 访问禅道官方网站（www.zentao.net）的下载页面。
• 在“Linux一键安装包”区域，选择适合您系统的开源版或专业版，通常文件名格式为 ZenTaoPMS.<版本号>.php<PHP版本>.mysql<MySQL版本>.linux.x86_64.tar.gz。
• 复制下载链接,准备在服务器上进行下载。

详细安装步骤

准备工作就绪后,我们便可以正式开始禅道的安装，以下步骤均以CentOS 7.x为例，命令同样适用于CentOS 8.x。

第一步：下载并上传安装包
您可以直接在服务器上使用wget命令下载安装包，也可以在本地下载后通过SCP、SFTP等工具上传至服务器，推荐直接在服务器下载，更为便捷。

# 创建一个用于存放安装包的目录（可选）
mkdir /home/zentao_setup
cd /home/zentao_setup
# 使用wget下载安装包（请将链接替换为官网最新版本的链接）
wget https://www.zentao.net/dl/zentao/18.8/ZenTaoPMS.18.8.php8.1.mysql8.0.linux.x86_64.tar.gz

第二步：解压安装包
禅道一键安装包默认会解压到/opt目录下，请确保该目录有足够的空间。

# 解压tar.gz包
tar -zxvf ZenTaoPMS.18.8.php8.1.mysql8.0.linux.x86_64.tar.gz
# 解压后，会在/opt目录下生成一个zbox目录，包含了所有运行环境
ls /opt/
# 您应该能看到 zbox 目录

第三步：启动禅道服务
zbox目录中包含了禅道所有服务的控制脚本，执行启动命令即可一键运行Apache和MySQL数据库。

# 切换到zbox目录
cd /opt/zbox
# 启动所有服务
./zbox start

启动成功后,终端会显示Apache和MySQL的启动状态，并提示访问地址和默认数据库端口。

Start Apache success
Start Mysql success
Zentao has been started. Please visit http://your_ip_address to setup.

第四步：配置防火墙
为了能够从外部访问禅道Web界面，需要在CentOS的防火墙中放行Apache默认的80端口（如果您修改了端口，请放行相应端口）。

# 检查防火墙状态
systemctl status firewalld
# 如果防火墙未开启，先开启它
systemctl start firewalld
systemctl enable firewalld
# 永久开放80端口
firewall-cmd --permanent --add-port=80/tcp
# 重新加载防火墙规则使配置生效
firewall-cmd --reload
# 查看已开放的端口，确认80端口已添加
firewall-cmd --list-ports

第五步：访问并初始化禅道
您可以通过浏览器访问禅道了，在浏览器地址栏输入 http://<您的服务器IP地址>。

首次访问会进入禅道安装向导页面,按照页面提示进行操作：

1. 同意许可协议。
2. 系统检查：安装包内置环境，通常所有检查项都会自动通过。
3. 配置数据库：默认情况下，安装包已配置好MySQL，数据库用户名为root，密码为123456，您可以直接使用此配置，点击“保存”。
4. 创建管理员账号：设置您的管理员账号和密码，这是您登录禅道的凭证。

完成以上步骤后,即可使用创建的管理员账号登录禅道，开始您的项目管理工作。

服务管理与维护

为了方便日常管理,禅道提供了简单易用的命令行工具。

常用管理命令
下表列出了/opt/zbox/zbox脚本的一些常用命令：

命令	功能描述
./zbox start	启动Apache和MySQL服务
./zbox stop	停止Apache和MySQL服务
./zbox restart	重启Apache和MySQL服务
./zbox status	查看服务运行状态

设置开机自启
为了确保服务器重启后禅道能自动运行，建议将其配置为系统服务。

1. 创建一个systemd服务文件：

   

   vim /etc/systemd/system/zentao.service

2. 在文件中填入以下内容：

   [Unit]
   Description=ZenTao
   After=network.target

[Service]
Type=forking
User=root
ExecStart=/opt/zbox/zbox start
ExecStop=/opt/zbox/zbox stop
ExecReload=/opt/zbox/zbox restart
KillMode=process
Restart=on-failure
RestartSec=42s

[Install]
WantedBy=multi-user.target

3. 重新加载`systemd`并启用服务：
```bash
systemctl daemon-reload
systemctl enable zentao.service

配置完成后,zentao服务就会在每次系统启动时自动运行。

---

相关问答FAQs

问题1：如果忘记了禅道管理员密码，该如何重置？
解答：可以通过命令行工具轻松重置，进入禅道脚本目录：
cd /opt/zbox/app/zentao/bin/
执行以下命令进行重置（将new_password替换为您想设置的新密码）：
sudo -u www php zt.php admin resetPassword new_password
执行成功后，即可使用新密码登录。

问题2：如何修改禅道默认的80端口？
解答：修改端口需要同时调整Apache的监听端口和禅道的配置文件。

1. 修改Apache端口：编辑/opt/zbox/etc/apache/httpd.conf文件，找到Listen 80和ServerName localhost:80这两行，将80修改为您想要的端口号，例如8080。
2. 修改禅道配置：编辑/opt/zbox/app/zentao/config/my.php文件，找到$config->webRoot = '/';这一行，如果您的端口不是80，需要在此处配置端口信息，例如$config->webRoot = ':8080/';。
3. 重启服务：执行/opt/zbox/zbox restart使配置生效。
4. 更新防火墙：不要忘记在防火墙中开放新的端口号（如8080），并关闭旧的80端口。