当前位置：网站首页 >平台公告 > 在nginx安装禅道

在nginx安装禅道

2026-05-15 平台公告 1164

Nginx环境下部署禅道：新手也能轻松上手的项目管理系统搭建指南

在团队协作开发中，一款高效的项目管理工具能大幅提升工作效率。禅道作为国产开源的项目管理系统，集需求管理、任务跟踪、缺陷管理于一体，支持多语言和个性化配置，适合中小团队快速上手。而将禅道部署在Nginx服务器上，既能利用Nginx的高性能特性，又能借助其灵活的配置能力实现稳定运行。本文将手把手教你完成从环境搭建到系统上线的全过程。

一、准备工作：核心环境安装

1. 安装Nginx与PHP环境

首先确保服务器已安装Nginx和PHP（禅道依赖PHP运行）。以Ubuntu/Debian系统为例：

# 安装Nginx
sudo apt update && sudo apt install nginx -y

# 安装PHP及必要扩展（以PHP 8.1为例，需确认系统PHP版本）
sudo apt install php8.1-fpm php8.1-mysql php8.1-mbstring php8.1-xml php8.1-curl -y

安装完成后启动PHP-FPM并设置开机自启：

sudo systemctl start php8.1-fpm && sudo systemctl enable php8.1-fpm

2. 安装数据库

禅道需MySQL/MariaDB存储数据，安装并启动数据库：

sudo apt install mariadb-server -y
sudo systemctl start mariadb && sudo systemctl enable mariadb
# 初始化数据库（设置root密码并创建禅道专用用户）
sudo mysql_secure_installation
# 进入MariaDB创建数据库和用户
sudo mysql -u root -p
CREATE DATABASE zentao CHARACTER SET utf8mb4;
CREATE USER 'zentao'@'localhost' IDENTIFIED BY '你的密码';
GRANT ALL PRIVILEGES ON zentao.* TO 'zentao'@'localhost';
FLUSH PRIVILEGES;
EXIT;

二、部署禅道：安装与目录配置

1. 下载并解压禅道

访问禅道官网（https://www.zentao.net/）下载最新稳定版（推荐Linux版），通过SSH工具上传到服务器，或直接在服务器中下载：

wget https://www.zentao.net/dl/zentao/19.1/ZenTaoPMS.19.1.stable.zbox_64.tar.gz
tar -zxvf ZenTaoPMS.19.1.stable.zbox_64.tar.gz && cd zentao

将解压后的文件移动到Nginx站点目录：

sudo mv zentao /usr/share/nginx/html/zentao

2. 配置目录权限

Nginx默认以www-data用户运行，需确保禅道目录权限正确：

sudo chown -R www-data:www-data /usr/share/nginx/html/zentao
sudo chmod -R 755 /usr/share/nginx/html/zentao

三、Nginx配置：让禅道跑起来

1. 新建Nginx站点配置

在nginx安装禅道

创建禅道专用配置文件：

sudo nano /etc/nginx/sites-available/zentao

添加以下内容（注意替换server_name为你的域名或服务器IP）：

server {
    listen 80;
    server_name your_domain.com;  # 替换为实际域名或IP
    root /usr/share/nginx/html/zentao;
    index index.php index.html;

    # 处理伪静态（禅道必需）
    location / {
        try_files $uri $uri/ /index.php?$args;
        if (!-e $request_filename) {
            rewrite ^/(.*)$ /index.php last;
        }
    }

    # PHP解析配置
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;  # 与PHP版本对应
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # 禁止访问敏感目录
    location ~* /(install|config|data|vendor) {
        deny all;
    }
}

保存后启用站点：

sudo ln -s /etc/nginx/sites-available/zentao /etc/nginx/sites-enabled/
sudo nginx -t  # 检查配置语法
sudo systemctl restart nginx

四、数据库初始化与安装

1. 访问安装界面

打开浏览器，输入服务器IP或域名（如http://your_domain.com/zentao），进入禅道安装向导。按提示填写信息：

数据库主机：localhost
数据库名：zentao
用户名：zentao
密码：之前设置的数据库密码
管理员账号：admin（初始密码123456，安装后务必修改）

2. 常见问题解决

数据库连接失败：检查MariaDB服务是否启动（sudo systemctl status mariadb），或用户名密码是否正确。
PHP扩展缺失：运行php -m | grep mysqli确认MySQL扩展已启用，缺失则重新安装php8.1-mysql。
伪静态失效：检查Nginx配置中的try_files和rewrite规则，确保配置文件已启用并重启Nginx。

五、安全与优化建议

删除安装目录：安装完成后删除/usr/share/nginx/html/zentao/install目录，防止二次安装。
修改默认密码：登录后立即修改管理员密码，建议使用强密码。
定期备份：通过mysqldump -u zentao -p zentao > backup.sql定期导出数据库。
HTTPS升级：若需加密访问，可通过Certbot配置Let’s Encrypt证书（sudo apt install certbot python3-certbot-nginx）。

禅道的安装看似复杂，实则通过标准化步骤可快速完成。从需求管理到团队协作，禅道能满足中小团队的核心项目管理需求。按照上述步骤操作，即使是新手也能在1小时内完成部署，开启高效项目管理之旅。遇到问题可参考禅道官方文档或社区论坛，那里有更多实战经验分享。

标签: