Linux系统如何访问禅道？

在Linux系统中访问禅道，通常需要搭建对应的Web环境（如LAMP或LNMP），并完成禅道的安装与配置,以下是详细步骤：

环境准备

禅道是基于PHP开发的，因此需要安装Linux操作系统、Web服务器（Apache/Nginx）、数据库（MySQL/MariaDB）及PHP环境，以Ubuntu 20.04和CentOS 7为例,基础环境安装命令如下：

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

• Apache: sudo systemctl start apache2（Ubuntu）或 sudo systemctl start httpd（CentOS）
• MySQL/MariaDB: sudo systemctl start mysql或mariadb，并执行sudo mysql_secure_installation初始化配置

安装禅道

1. 下载禅道安装包
   访问禅道官网（https://www.zentao.net/download.html）下载最新版（如ZenTaoPMS.18.4.stable.zip），或通过命令行下载：

   

   wget https://www.zentao.net/downloads/zentao/18.4/ZenTaoPMS.18.4.stable.zip -O zentao.zip

2. 解压并部署
   创建Web目录（默认Apache为/var/www/html，Nginx为/usr/share/nginx/html），解压安装包：

   sudo mkdir -p /var/www/html/zentaopms  # 创建禅道目录
   sudo unzip zentao.zip -d /var/www/html/zentaopms  # 解压到目标目录
   sudo chown -R www-data:www-data /var/www/html/zentaopms  # 设置权限（Ubuntu为www-data，CentOS为apache）

数据库配置

1. 创建数据库及用户
   登录MySQL/MariaDB：

   sudo mysql -u root -p

   执行以下SQL（替换password为实际密码）：

   CREATE DATABASE zentao_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   CREATE USER 'zentao_user'@'localhost' IDENTIFIED BY 'your_password';
   GRANT ALL PRIVILEGES ON zentao_db.* TO 'zentao_user'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

Web服务器配置

Apache配置

• 启用mod_rewrite模块：sudo a2enmod rewrite
• 创建虚拟主机配置文件（如/etc/apache2/sites-available/zentao.conf）：

  <VirtualHost *:80>
      ServerName your_server_ip
      DocumentRoot /var/www/html/zentaopms
      <Directory /var/www/html/zentaopms>
          AllowOverride All
          Require all granted
      </Directory>
  </VirtualHost>

• 启用配置并重启Apache：

  sudo a2ensite zentao.conf
  sudo systemctl restart apache2

Nginx配置

• 创建配置文件（如/etc/nginx/conf.d/zentao.conf）：

  server {
      listen 80;
      server_name your_server_ip;
      root /var/www/html/zentaopms;
      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版本调整
          fastcgi_index index.php;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          include fastcgi_params;
      }
  }

• 重启Nginx：sudo systemctl restart nginx

访问禅道

完成上述配置后，在浏览器中输入http://服务器IP/zentaopms，进入禅道安装向导：

1. 选择“全新安装”，填写数据库信息（数据库名、用户名、密码）；
2. 设置管理员账号（用户名、密码、邮箱）；
3. 点击“开始安装”,安装完成后登录即可使用。

常见问题排查

• 权限问题：确保禅道目录权限正确（www-data:www-data或apache:apache）；
• 数据库连接失败：检查数据库用户权限、密码及防火墙设置（sudo ufw allow 3306）；
• 白屏/500错误：查看PHP错误日志（/var/log/apache2/error.log或/var/log/nginx/error.log）,确认PHP扩展是否安装齐全。

FAQs

访问禅道时提示“数据库连接失败”，如何解决？
答：首先检查MySQL/MariaDB服务是否运行（sudo systemctl status mysql）；其次确认数据库用户名、密码及数据库名是否正确；最后检查数据库用户是否有访问权限（登录MySQL执行SHOW GRANTS FOR 'zentao_user'@'localhost';查看权限），若仍失败，检查防火墙是否阻止3306端口（sudo ufw allow 3306）。

如何修改禅道的默认访问端口？
答：修改Web服务器配置文件（Apache的zentao.conf或Nginx的zentao.conf），将Listen 80改为其他端口（如Listen 8080），并重启服务，Apache配置中修改<VirtualHost *:8080>，Nginx中修改listen 8080;，修改后需在防火墙开放新端口（sudo ufw allow 8080），通过http://服务器IP:8080/zentaopms访问。