禪道的安裝記錄

# 禪道的安裝記錄

## 前言

禪道（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字
適用場景：技術文檔/運維手冊/開源軟件部署指南