在阿里云轻量应用服务器上安装和配置禅道(ZenTao),最推荐且最简单的方式是使用官方提供的“一键安装包”或 Docker 镜像。由于轻量应用服务器通常预装了 Linux 系统(如 CentOS、Ubuntu 等),直接使用官方的一键部署脚本可以大幅减少环境配置错误。
以下是详细的操作步骤,分为 Docker 方式(推荐) 和 传统源码/二进制包方式 两种方法。
✅ 推荐方案:使用 Docker 安装禅道(简单、易维护)
前提条件
- 你的阿里云轻量应用服务器已运行 Linux 系统(建议 CentOS 7+/Ubuntu 20.04+)。
- 已安装 Docker 和 Docker Compose。
- 已开放相关端口(80, 443, 3306 等)或在安全组中放行。
步骤 1:安装 Docker 和 Docker Compose
Ubuntu/Debian:
sudo apt update
sudo apt install -y docker.io docker-compose
sudo systemctl enable --now docker
CentOS/RHEL:
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo systemctl enable --now docker
验证安装:
docker --version
docker compose version
步骤 2:创建禅道项目目录并下载 docker-compose.yml
mkdir ~/zentao && cd ~/zentao
创建 docker-compose.yml 文件:
version: '3'
services:
zentao:
image: easzheng/zentao:latest
container_name: zentao
ports:
- "80:80"
- "443:443"
volumes:
- ./data/mysql:/var/lib/mysql
- ./data/zentao:/opt/zbox/app/zentao
environment:
- MYSQL_ROOT_PASSWORD=your_root_password # 请修改为强密码
- ZENTAO_ADMIN_PASSWORD=admin123 # 请修改为管理员密码
restart: always
⚠️ 注意:
MYSQL_ROOT_PASSWORD:MySQL 根密码,务必设置复杂密码。ZENTAO_ADMIN_PASSWORD:禅道管理员初始密码。- 数据持久化通过
volumes挂载到本地目录,防止容器删除后数据丢失。
步骤 3:启动禅道服务
docker compose up -d
查看日志确认启动成功:
docker logs -f zentao
当看到类似 Apache is running 或 MySQL is running 的提示时,表示启动成功。
步骤 4:访问禅道 Web 界面
在浏览器中输入:
http://<你的服务器公网IP>
默认登录账号:
- 用户名:
admin - 密码:你在
docker-compose.yml中设置的ZENTAO_ADMIN_PASSWORD
步骤 5:配置 HTTPS(可选但推荐)
为了安全性,建议配置 SSL 证书。你可以使用 Let’s Encrypt 免费证书 + Nginx 反向X_X。
1. 安装 Certbot 获取证书
sudo apt install certbot python3-certbot-nginx # Ubuntu
# 或
sudo yum install certbot python3-certbot-nginx # CentOS
2. 申请证书
sudo certbot certonly --webroot -w /var/www/html -d your_domain.com
3. 配置 Nginx 反向X_X(需额外安装 Nginx)
创建 /etc/nginx/sites-available/zentao.conf:
server {
listen 443 ssl;
server_name your_domain.com;
ssl_certificate /etc/letsencrypt/live/your_domain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/your_domain.com/privkey.pem;
location / {
proxy_pass http://localhost:80;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
启用站点并重启 Nginx:
sudo ln -s /etc/nginx/sites-available/zentao.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
🔄 备选方案:使用阿里云市场镜像(最省事)
如果你不想手动配置,可以直接在阿里云控制台操作:
- 登录 阿里云控制台。
- 进入 轻量应用服务器 → 应用镜像。
- 搜索 “禅道”。
- 选择官方或第三方提供的禅道镜像(如“禅道开源版 18.x”)。
- 点击 购买/更换镜像(注意:更换镜像会清空原有数据,请先备份)。
- 服务器重启后,直接通过 IP 访问即可。
✅ 优点:无需任何命令操作,开箱即用。
❌ 缺点:灵活性较低,难以自定义配置。
🛠 传统方式:使用官方二进制包安装(不推荐新手)
如果因特殊原因不能使用 Docker,可参考以下步骤:
- 下载禅道最新稳定版:
wget https://www.zentao.net/download/18.1.0-zentao.1.html - 解压并运行安装脚本:
tar zxvf ZenTaoPMS.18.1.stable.zbox_64.tar.gz -C /opt/ /opt/zbox/zbox start - 访问
http://<IP>:8080进行初始化配置。
⚠️ 此方式需要手动配置 Apache、PHP、MySQL 等依赖,容易出错,仅适用于高级用户。
🔒 安全建议
- 修改默认端口:避免使用 80/443 对外暴露,或使用防火墙限制 IP。
- 定期备份:
docker exec zentao mysqldump -u root -p<password> zentao > backup.sql - 更新系统:定期执行
yum update或apt upgrade。 - 启用防火墙:只开放必要端口(如 80, 443, SSH 22)。
✅ 总结
| 方法 | 难度 | 推荐度 | 适用场景 |
|---|---|---|---|
| Docker 部署 | ⭐⭐ | ★★★★★ | 大多数用户,灵活、易维护 |
| 阿里云镜像 | ⭐ | ★★★★☆ | 新手、快速上线 |
| 二进制包 | ⭐⭐⭐⭐ | ★★☆☆☆ | 高级用户、特殊需求 |
强烈建议使用 Docker 方式,既保证了环境隔离,又便于后续升级和维护。
云服务器