禅道的安装记录

发布时间：2021-10-21 10:08:59 作者：柒染
来源：亿速云阅读：186

# 禅道的安装记录

## 前言

禅道（ZenTao）是一款开源的项目管理软件，集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体。本文将详细记录在Linux系统（Ubuntu 20.04 LTS）上安装禅道开源版（12.5.3版本）的全过程，包括环境准备、安装步骤、常见问题及解决方案。

---

## 一、环境准备

### 1.1 系统要求
- **操作系统**：Linux（本文以Ubuntu 20.04为例）
- **Web服务器**：Apache/Nginx（本文选择Apache）
- **数据库**：MySQL 5.7+/MariaDB
- **PHP版本**：7.2-7.4（禅道12.5.3不支持PHP 8.0+）
- **硬件配置**：最低2核CPU、4GB内存、50GB磁盘空间

### 1.2 安装依赖
```bash
# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装Apache、MySQL、PHP及扩展
sudo apt install apache2 mysql-server php7.4 php7.4-mysql php7.4-json php7.4-curl php7.4-gd php7.4-mbstring -y

二、安装禅道

2.1 下载禅道

从官网获取开源版安装包：

wget https://www.zentao.net/dl/ZenTaoPMS.12.5.3.zbox_64.tar.gz

2.2 解压安装包

sudo tar -zxvf ZenTaoPMS.12.5.3.zbox_64.tar.gz -C /opt

2.3 启动内置服务

禅道自带Apache和MySQL服务（端口分别为80和3306），需先停止系统原有服务：

sudo systemctl stop apache2
sudo systemctl stop mysql

启动禅道服务：

sudo /opt/zbox/zbox start

2.4 配置防火墙

开放80端口：

sudo ufw allow 80/tcp

三、初始化配置

3.1 访问禅道

浏览器输入服务器IP地址，进入安装向导：

http://your_server_ip

3.2 数据库配置

选择内置MySQL（默认账号：root，密码为空）

或使用外部MySQL，需提前创建数据库和用户：


CREATE DATABASE zentao DEFAULT CHARSET utf8mb4;
GRANT ALL ON zentao.* TO 'zentao_user'@'localhost' IDENTIFIED BY 'your_password';

3.3 管理员设置

填写管理员账号、密码及企业信息。

四、常见问题解决

4.1 端口冲突

若系统Apache或MySQL已占用端口，需修改禅道默认端口：

# 编辑配置文件
sudo vi /opt/zbox/etc/apache/httpd.conf
# 修改Listen 80为其他端口（如8080）

4.2 PHP版本不兼容

若报错PHP version must be 7.2-7.4，切换PHP版本：

sudo update-alternatives --config php

4.3 文件权限问题

确保/opt/zbox目录权限正确：

sudo chown -R www-data:www-data /opt/zbox

五、优化与维护

5.1 开机自启

添加启动脚本到/etc/rc.local：

/opt/zbox/zbox start

5.2 数据备份

禅道数据存储在/opt/zbox/app/zentao，建议定期备份：

# 备份数据库
/opt/zbox/bin/mysqldump -uroot -p zentao > zentao_backup.sql

# 备份附件
tar -czvf zentao_data.tar.gz /opt/zbox/app/zentao/data

结语

通过以上步骤，禅道已成功安装并运行。作为一款全生命周期的项目管理工具，禅道能显著提升团队协作效率。后续可通过插件市场扩展功能，或参考官方文档进行高级配置。

注意事项：生产环境建议使用Nginx反向代理并配置HTTPS证书，以提升安全性。 “`

字数统计：约1050字
适用场景：技术文档/运维手册/开源软件部署指南