当前位置：首页 > Linux > 正文

Linux安装禅道教程，5步快速搞定（Ubuntu/CentOS）

admin
Linux
2025-06-10
2551

Linux安装禅道步骤：下载官方安装包，解压后移动至Web目录，赋予相关目录读写权限，启动内置Apache和MySQL服务，最后通过浏览器访问服务器IP完成初始化配置登录即可。

安装前准备

环境要求
- 操作系统：Ubuntu 18.04+ / CentOS 7+（推荐）
- 内存：≥ 2GB
- 磁盘空间：≥ 10GB
- 依赖组件：Apache/Nginx、PHP 7.1~8.0、MySQL 5.7+/MariaDB 10.3+

安装依赖环境

# Ubuntu/Debian
sudo apt update
sudo apt install apache2 mysql-server php php-mysql php-gd php-curl php-zip php-mbstring php-xml -y
# CentOS/RHEL
sudo yum install httpd mariadb-server mariadb php php-mysqlnd php-gd php-curl php-json php-mbstring php-xml -y

配置PHP（关键参数调整）
编辑 /etc/php.ini（路径可能不同，使用 php --ini 查找）：

memory_limit = 256M
upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300
date.timezone = Asia/Shanghai  # 根据时区修改

安装禅道

步骤1：下载并解压禅道

# 进入Web目录（以Apache为例）
cd /var/www/html
# 下载开源版（最新版请访问官网获取链接）
sudo wget https://www.zentao.net/dl/ZenTaoPMS.18.0.zbox_64.tar.gz
# 解压并重命名
sudo tar -zxvf ZenTaoPMS.*.tar.gz
sudo mv zbox zentao

步骤2：配置数据库

# 启动MySQL并设置root密码
sudo systemctl start mysql
sudo mysql_secure_installation  # 按提示设置密码
# 登录MySQL创建禅道专用数据库
mysql -u root -p
CREATE DATABASE zentao DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
GRANT ALL PRIVILEGES ON zentao.* TO 'zentao_user'@'localhost' IDENTIFIED BY 'YourStrongPassword!';
FLUSH PRIVILEGES;
EXIT;

步骤3：配置Web服务器

Apache 示例（创建虚拟主机）
编辑 /etc/apache2/sites-available/zentao.conf：

<VirtualHost *:80>
    ServerName your-domain.com  # 替换为实际域名或IP
    DocumentRoot /var/www/html/zentao
    <Directory /var/www/html/zentao>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

启用配置：

Linux安装禅道教程，5步快速搞定（Ubuntu/CentOS）第1张

sudo a2ensite zentao.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

Nginx 示例（/etc/nginx/conf.d/zentao.conf）

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/html/zentao;
    index index.php;
    location / {
        try_files $uri $uri/ /index.php?$args;
    }
    location ~ .php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php-fpm.sock;  # 根据实际路径调整
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

重启服务：

sudo systemctl restart nginx

启动禅道并初始化

通过浏览器完成安装
访问 http://your-server-ip 或 http://your-domain.com，按向导操作：
- 选择 “全新安装”
- 数据库配置：
  - 主机：localhost
  - 用户：zentao_user
  - 密码：YourStrongPassword!
  - 数据库名：zentao
- 设置管理员账号密码

命令行管理服务（可选）
禅道自带内置服务，可替代Apache/Nginx：

# 启动服务（默认端口80/3306）
sudo /var/www/html/zentao/zbox start
# 停止服务
sudo /var/www/html/zentao/zbox stop

安全加固与维护

防火墙放行端口

sudo ufw allow 80/tcp     # HTTP
sudo ufw allow 443/tcp    # HTTPS（若启用SSL）

定期备份

# 备份数据库 + 代码
sudo mysqldump -u root -p zentao > zentao_db_$(date +%F).sql
sudo tar -zcvf zentao_backup_$(date +%F).tar.gz /var/www/html/zentao

故障排查
- 访问空白页：检查目录权限 sudo chown -R www-data:www-data /var/www/html/zentao
- 数据库连接失败：确认MySQL用户权限及防火墙规则
- 500错误：查看Apache/Nginx日志 /var/log/apache2/error.log 或 /var/log/nginx/error.log