禅道部署

------------------------------------------------------

查看服务器版本

   查询服务器版本信息：uname -a

 

上传安装包至服务器

 

通过winscp把下载的ZenTaoPMS.12.5.3.zbox_old.64.tar.gz 禅道安装包上传至服务器/data目录。

 

1. 安装部署

 

2.1解压并安装

 

解压：

 

tar -zxvf ZenTaoPMS.12.5.3.zbox_old.64.tar.gz -C /opt

 

启动禅道服务

 

 启动：/opt/zbox/zbox start

 

如图显示，证明禅道启动成功

 

 

 

  补充命令：

 

  停止禅道服务：/opt/zbox/zbox stop

 

  重启禅道服务：/opt/zbox/zbox restart

 

 

设置禅道自动启动

 

编辑rc.local文件，在文件末尾添加禅道重启命令，保存后退出

 

vim /etc/rc.local

 

在末尾增加一行：

 

touch /var/lock/subsys/local
/opt/zbox/zbox restart

 

rc.local文件添加执行权限

 

 默认情况下rc.local文件没有执行权限，需要给其添加权限

 

 chmod +777 /etc/rc.local

 

2.5重启禅道服务

 

/opt/zbox/zbox restart

 

------------------------------------------------------

 

禅道的配置文件

 

禅道（ZenTao）的配置文件主要集中在其安装目录的 config 文件夹中，包含数据库连接、系统参数、安全设置等核心配置。以下是禅道配置文件的详细说明：

一、禅道配置文件的位置

禅道的配置文件路径取决于安装方式：

1. 源码包 / 集成包安装（Linux 系统）

默认安装目录通常为 /opt/zentaopms 或 /var/www/zentaopms，配置文件位于：

plaintext

 

 

{安装目录}/config/

 

例如：/opt/zentaopms/config/

2. Docker 容器安装

配置文件通常挂载在容器内的 /app/zentaopms/config/ 目录，可通过宿主机挂载路径查看（如 -v /宿主机路径:/app/zentaopms/config）。

二、核心配置文件说明

1. 数据库配置：my.php

最关键的配置文件，存储数据库连接信息：

php

 

 

<?php
$config->db->host     = 'localhost';    // 数据库主机地址
$config->db->port     = '3306';         // 数据库端口
$config->db->name     = 'zentaopms';    // 数据库名
$config->db->user     = 'root';         // 数据库用户名
$config->db->password = 'password';     // 数据库密码
$config->db->prefix   = 'zt_';          // 表前缀（默认 zt_）
$config->db->charset  = 'utf8mb4';      // 字符集
?>

 

• 作用：禅道与数据库的连接依赖此文件，修改数据库信息后需重启 Web 服务（如 Nginx/Apache）。

2. 系统全局配置：config.php

包含系统基础参数配置：

php

 

 

<?php
$config->version      = '18.6';         // 禅道版本号
$config->timezone     = 'Asia/Shanghai';// 时区设置
$config->cookie->path = '/';            // Cookie 路径
$config->cookie->domain = '';           // Cookie 域名
$config->session->name = 'zentaosid';   // Session 名称
$config->debug        = false;          // 是否开启调试模式（生产环境建议关闭）
?>

 

• 调试模式：若开启 $config->debug = true，会显示错误详情，便于排查问题，但生产环境需关闭以避免信息泄露。

3. 安全配置：security.php

涉及 CSRF 防护、XSS 过滤等安全设置：

php

 

 

<?php
$config->security->csrfCheck = true;    // 开启 CSRF 防护（推荐开启）
$config->security->xssFilter = true;    // 开启 XSS 过滤
$config->security->domainWhiteList = array(); // 域名白名单（限制跨域请求）
?>

 

4. 邮件配置：mail.php

用于配置禅道的邮件通知功能（如任务提醒、Bug 通知）：

php

 

 

<?php
$config->mail->on      = true;          // 是否开启邮件功能
$config->mail->from    = 'zentao@example.com'; // 发件人邮箱
$config->mail->smtp->host = 'smtp.example.com'; // SMTP 服务器地址
$config->mail->smtp->port = 25;         // SMTP 端口（如 25、465、587）
$config->mail->smtp->auth = true;       // 是否需要 SMTP 认证
$config->mail->smtp->username = 'zentao@example.com'; // SMTP 用户名
$config->mail->smtp->password = 'mailpass'; // SMTP 密码/授权码
?>

 

5. 附件与存储配置：file.php

设置附件上传路径、大小限制等：

php

 

 

<?php
$config->file->savePath = '/opt/zentaopms/www/data/upload/'; // 附件存储路径
$config->file->maxSize  = 1024 * 1024 * 5; // 最大上传大小（默认 5MB）
$config->file->allowed  = 'jpg,jpeg,png,gif,doc,docx,xls,xlsx,pdf,zip'; // 允许的文件类型
?>

 

三、修改配置文件的注意事项

1. 权限问题：确保配置文件的所有者与 Web 服务用户一致（如 www-data 或 apache），避免因权限不足导致配置无法读取：
   bash

   sudo chown -R www-data:www-data /opt/zentaopms/config/
   

    
2. 生效方式：修改配置后，通常需重启 Web 服务使配置生效：
   bash

   # Nginx 示例
   sudo systemctl restart nginx
   
   # Apache 示例
   sudo systemctl restart apache2
   

    
3. 备份配置：修改前建议备份原配置文件，便于出错时恢复：
   bash

   cp /opt/zentaopms/config/my.php /opt/zentaopms/config/my.php.bak

------------------------------------------------------

 

 

------------------------------------------------------

------------------------------------------------------

------------------------------------------------------