禅道是一款开源的项目管理软件,支持敏捷开发、测试管理和DevOps流程,在Linux服务器上部署禅道,可充分发挥其稳定性和高性能优势,以下是经过验证的详细启动流程(基于官方文档和最佳实践):
环境准备(必需依赖)
-
系统要求
- 操作系统:CentOS 7+/Ubuntu 18.04+(推荐)
- 运行环境:PHP 7.2-8.0、MySQL 5.6+ 或 MariaDB 10.3+
- 其他依赖:Apache/Nginx、zlib、gd库
-
安装基础组件
# CentOS sudo yum install -y httpd mariadb-server php php-mysqlnd php-gd php-json # Ubuntu sudo apt install -y apache2 mariadb-server php php-mysql php-gd php-json
下载与解压禅道
-
获取安装包
访问禅道官网下载页获取最新版(推荐下载.zip
或.tar.gz
):wget https://dl.cnezsoft.com/zentao/18.5/ZenTaoPMS.18.5.zbox_64.tar.gz
-
解压到目标目录
sudo tar -zxvf ZenTaoPMS.*.tar.gz -C /opt
解压后生成
/opt/zbox
目录,包含Apache、MySQL和禅道应用。
启动禅道服务
-
启动内置服务器
cd /opt/zbox sudo ./zbox start # 默认启动Apache和MySQL
- 若需后台运行:
sudo ./zbox start -d
- 停止服务:
sudo ./zbox stop
- 若需后台运行:
-
验证服务状态
sudo ./zbox status
正常输出示例:
Apache is running
MySQL is running
访问与初始化配置
-
通过浏览器访问
- 默认地址:
http://服务器IP:80
(Apache) - 默认账号:
admin
,密码:123456
- 默认地址:
-
首次登录配置
- 修改管理员密码(安全必需)
- 进入【后台】→【系统】→【LDAP】关闭LDAP(若无需集成)
- 配置邮箱通知(可选)
常见问题解决
问题现象 | 解决方案 |
---|---|
端口冲突(80/3306占用) | 执行 sudo ./zbox -ap 8080 -mp 3307 修改端口 |
无法连接数据库 | 检查MySQL是否启动:./zbox status ,重启服务 |
页面显示500错误 | 检查PHP版本兼容性,确保安装gd库和zlib扩展 |
文件权限不足 | 运行:sudo chmod -R 777 /opt/zbox/app/tmp |
安全加固建议
- 修改默认端口
启动时指定端口:sudo ./zbox start -ap 8080 -mp 3307
- 防火墙配置
sudo firewall-cmd --permanent --add-port=8080/tcp # CentOS sudo ufw allow 8080/tcp # Ubuntu
- 定期备份
备份数据库:mysqldump -u root -p zentao > zentao_bak.sql
(密码默认为空)
进阶部署方案
-
Nginx反向代理(提升性能)
在/etc/nginx/conf.d/zentao.conf
中添加:server { listen 80; server_name yourdomain.com; location / { proxy_pass http://127.0.0.1:80; proxy_set_header Host $host; } }
-
设置开机自启
创建systemd服务文件:/etc/systemd/system/zentao.service
[Unit] Description=Zentao Service After=network.target [Service] ExecStart=/opt/zbox/zbox start ExecStop=/opt/zbox/zbox stop Restart=always User=root [Install] WantedBy=multi-user.target
通过以上步骤,您已成功在Linux系统部署禅道,关键要点:
- 确保环境依赖正确安装
- 通过
/opt/zbox/zbox
管理服务启停 - 首次登录后立即修改密码
- 生产环境务必配置防火墙和备份
引用说明:本文操作基于禅道官方文档(版本18.5),安全建议参考Linux服务器加固最佳实践,详细配置见禅道帮助文档。
原创文章,发布者:酷番叔,转转请注明出处:https://cloud.kd.cn/ask/5788.html