linux中如何安装禅道

在Linux系统中安装禅道（ZenTao）需要先了解其环境依赖，禅道是基于PHP开发的项目管理工具，因此需要搭建PHP运行环境、数据库（如MySQL或MariaDB）以及Web服务器（如Nginx或Apache），以下是详细的安装步骤，涵盖环境准备、软件安装、配置及启动全过程，以常见的Ubuntu/Debian和CentOS/RHEL系统为例进行说明。

环境准备

禅道的运行依赖以下核心组件,需提前安装并确保版本兼容：

• PHP：版本≥7.4（推荐7.4-8.1），需开启pdo_mysql、curl、gd、mbstring、zip、fileinfo等扩展。
• 数据库：MySQL≥5.7或MariaDB≥10.2。
• Web服务器：Nginx≥1.18或Apache≥2.4。
• 其他工具：unzip（解压工具）、wget/curl（下载工具）。

不同Linux发行版的依赖安装命令

以下表格列出主流发行版的依赖安装步骤,需以root权限或sudo执行：

安装完成后,启动并设置开机自启：

# 启动服务（以Nginx+MySQL为例）
systemctl start nginx mysql php7.4-fpm  # Ubuntu/Debian
systemctl start nginx mysqld php74-fpm   # CentOS/RHEL
# 设置开机自启
systemctl enable nginx mysql php7.4-fpm php74-fpm

下载并解压禅道

1. 下载禅道安装包
   访问禅道官网（https://www.zentao.pm/）下载最新稳定版（以zentao16.9.zbox_64.tar.gz为例），或使用wget直接下载：

   wget https://www.zentao.net/static/zentao/16.9/zentao16.9.zbox_64.tar.gz

2. 解压并移动文件
   禅道安装包为zbox格式（已集成Nginx+PHP+MySQL），解压后会生成zbox目录，包含运行所需的所有组件：

   tar -zxvf zentao16.9.zbox_64.tar.gz
   mv zbox /opt/zentao  # 移动到/opt目录（自定义路径需确保权限正确）

3. 设置目录权限
   确保Web服务器用户（Nginx为www-data，Apache为apache）对禅道目录有读写权限：

   # Ubuntu/Debian
   chown -R www-data:www-data /opt/zentao
   # CentOS/RHEL
   chown -R nginx:nginx /opt/zentao

启动禅道内置服务

禅道zbox包已集成Nginx、PHP-FPM和MySQL，可直接通过内置脚本启动：

cd /opt/zentao
./zbox start  # 启动所有服务（Nginx+PHP+MySQL）

启动后,可通过以下命令检查服务状态：

./zbox status  # 查看服务运行状态
./zbox stop   # 停止服务

默认情况下,Nginx监听80端口，MySQL监听3306端口，若端口冲突需修改配置（见下文“常见问题处理”）。

访问安装向导

1. 打开浏览器访问
   在浏览器地址栏输入http://服务器IP，若看到禅道安装界面，说明环境正常；若无法访问，需检查防火墙和端口开放情况：

   # Ubuntu/Debian（UFW防火墙）
   ufw allow 80/tcp
   # CentOS/RHEL（firewalld）
   firewall-cmd --permanent --add-port=80/tcp
   firewall-cmd --reload

2. 运行安装向导
   在安装界面填写以下信息：

   • 数据库配置：数据库名（如zentao）、数据库用户名（默认root）、密码（安装MySQL时设置的root密码，若未设置需先初始化：mysql_secure_installation）。
   • 管理员账号：设置管理员用户名（如admin）和密码。
   • 路径配置：默认即可，确保tmp目录有写入权限。

   点击“开始安装”后，禅道会自动创建数据库表并导入初始数据，安装完成后自动跳转到登录界面。

配置Web服务器（可选：使用外部Nginx/Apache）

若需使用系统自带的Nginx或Apache（而非禅道内置的），需额外配置虚拟主机，以下是Nginx示例：

配置Nginx虚拟主机

创建配置文件/etc/nginx/sites-available/zentao：

server {
    listen 80;
    server_name your_domain.com;  # 替换为域名或IP
    root /opt/zentao/www;         # 禅道Web根目录
    index index.php index.html;
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ .php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;  # PHP-FPM socket路径（根据实际版本调整）
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

启用配置并重启Nginx：

ln -s /etc/nginx/sites-available/zentao /etc/nginx/sites-enabled/
nginx -t && systemctl restart nginx

配置Apache虚拟主机

创建配置文件/etc/apache2/sites-available/zentao.conf（Ubuntu）或/etc/httpd/conf.d/zentao.conf（CentOS）：

<VirtualHost *:80>
    ServerName your_domain.com
    DocumentRoot /opt/zentao/www
    <Directory /opt/zentao/www>
        AllowOverride All
        Require all granted
    </Directory>
    <FilesMatch .php$>
        SetHandler "proxy:fcgi://127.0.0.1:9000"
    </FilesMatch>
</VirtualHost>

启用配置并重启Apache：

# Ubuntu/Debian
a2ensite zentao
a2enmod rewrite
systemctl restart apache2
# CentOS/RHEL
systemctl restart httpd

常见问题处理

1. 端口冲突
   若80端口被占用，可修改禅道内置Nginx端口：编辑/opt/zentao/zentao/config/zentao.php，将'request_uri' => 'http://localhost:80'中的80改为其他端口（如8080），然后通过http://IP:8080访问。

2. PHP扩展缺失
   若安装时报错“PHP extension XXX not found”，需安装对应扩展并重启PHP-FPM：

   # Ubuntu/Debian
   apt install php7.4-xxx  # 替换xxx为扩展名（如gd、mbstring）
   # CentOS/RHEL
   yum install php74-xxx
   systemctl restart php7.4-fpm  # 或php74-fpm

相关问答FAQs

问题1：安装禅道后无法访问首页，显示“403 Forbidden”怎么办？
解答：

• 检查Web服务器用户对禅道目录的权限：确保/opt/zentao及子目录所有者为Web用户（如www-data或nginx），执行chown -R www-data:www-data /opt/zentao（Ubuntu）或chown -R nginx:nginx /opt/zentao（CentOS）。
• 检查Nginx/Apache配置文件中的root路径是否正确指向禅道Web目录（/opt/zentao/www）。
• 若使用Apache,确保启用了rewrite模块（Ubuntu执行a2enmod rewrite，CentOS检查httpd.conf中是否有LoadModule rewrite_module modules/mod_rewrite.so）。

问题2：如何升级禅道版本？
解答：

1. 备份数据：先导出数据库（mysqldump -u root -p zentao > zentao_backup.sql）和禅道目录（cp -r /opt/zentao /opt/zentao_backup）。
2. 停止服务：执行/opt/zentao/zbox stop。
3. 下载新版本：官网下载最新安装包，解压后覆盖旧目录（mv /opt/zentao /opt/zentao_old && tar -zxvf zentao_new.zbox_64.tar.gz && mv zbox /opt/zentao）。
4. 恢复配置：将旧目录中的config/zentao.php、data等关键文件复制到新目录。
5. 启动服务：执行/opt/zentao/zbox start，访问升级页面按提示完成数据库升级。