禅道官方提供了一键安装包，禅道Windows下双击就能跑起来，下载这是安装最省事的路径。如果你非要自己配Apache+PHP+MySQL，教程后面会有无数权限和端口冲突等着你。禅道我见过太多人卡在“无法连接数据库”这一步，下载折腾一下午，安装最后发现是教程MySQL的root密码里有个特殊字符没转义。

先明确你要装哪个版本。禅道禅道开源版免费，下载功能对中小团队够用。安装专业版和企业版要付费，教程区别主要在甘特图、禅道LDAP对接这些。下载官网zentao.net的安装下载页面藏得不算深，首页导航栏“下载”点进去，选“开源版”。注意别下成“禅道项目管理软件”的旧版本，那个已经停止维护了。

Windows一键安装包：最不折腾的选择

下载下来是个.zip文件，大概200MB左右。解压到D盘根目录，路径里千万别带中文和空格。我试过放在“D:\我的软件\禅道”下面，启动时Apache直接报错，日志里写“DocumentRoot not found”。改成D:\zentao后一切正常。

解压完找到start.exe，右键“以管理员身份运行”。会弹出一个黑色命令行窗口，别关它。等十几秒，窗口里出现“Apache started”和“MySQL started”字样，就说明服务起来了。浏览器访问 http://localhost 或者 http://127.0.0.1，能看到禅道登录页。

默认账号是admin，密码123456。第一次登录会强制你改密码，建议改成字母+数字+符号的组合，但别用“@”和“#”，后面配置邮件通知时容易出问题。改完密码会提示你设置公司名称和时区，时区选“Asia/Shanghai”，不然任务截止时间会差8小时。

Linux下用Docker装：干净但需要点基础

如果你有Linux服务器，Docker方式更清爽。先确认Docker和Docker Compose都装好了。禅道官方在Docker Hub上有镜像，名字是easysoft/zentao。拉最新版：

docker pull easysoft/zentao:latest

然后建个目录放数据，比如 /data/zentao。启动命令别照抄网上那些老教程，它们用的端口映射是80:80，但很多服务器80端口被Nginx占了。改成8080:80，访问时用 http://你的IP:8080。

docker run -d --name zentao -p 8080:80 -v /data/zentao:/www/zentaopms -e MYSQL_ROOT_PASSWORD=你的密码 easysoft/zentao:latest

等容器状态变成healthy，大概需要30秒。docker logs -f zentao 能看到安装进度。如果卡在“Waiting for MySQL”，大概率是密码里带了特殊字符导致环境变量没传进去。换成纯字母数字再试。

安装完先干这三件事

进后台“组织”->“用户”，把默认的guest账号禁用掉。我遇到过有人没管这个，结果外部人员通过guest看到了所有项目列表。然后去“后台”->“通知”里配SMTP，用QQ邮箱的话授权码不是登录密码，得去QQ邮箱设置里单独生成。最后建一个测试项目，随便加两个任务，拖动一下看板。如果拖拽没反应，检查浏览器是不是禁用了JavaScript。

禅道的数据默认存在 /www/zentaopms/tmp 下，Docker方式就是挂载出来的那个目录。定期备份这个文件夹比什么都强。别依赖禅道自带的备份功能，它导出的.sql文件在跨版本恢复时经常报错。

装完如果访问慢，多半是PHP的opcache没开。Windows一键包默认关了，去 xampp/php/php.ini 里把 opcache.enable=1 前面的分号去掉，重启Apache。速度能快一倍。

(责任编辑：娱乐)