禅道项目管理软件三种部署方式详解：Docker、源码编译与Windows集成包

1. 项目概述：为什么“禅道”不是另一个待办清单，而是真正能扛住迭代压力的敏捷底座

“禅道项目管理软件完整安装指南：3种方法轻松部署您的敏捷开发平台”——这个标题里藏着三个被多数人忽略的关键信号：完整、三种方法、敏捷开发平台。它不是教你怎么点几下鼠标装个网页应用，而是在帮你搭建一个能承载需求池、任务拆解、每日站会跟踪、燃尽图可视化、版本发布闭环的轻量级但全功能的协作操作系统。我接触过太多团队，初期用Excel管需求、用微信群同步进度、用邮件发测试报告，结果到第3个迭代就出现需求漏排、任务归属不清、测试环境版本错乱、上线前半小时才发现某功能根本没进测试队列。禅道不是万能药，但它把Scrum和Kanban的核心流程固化进系统逻辑里，让“敏捷”从口号变成可执行、可追溯、可复盘的动作流。它不强制你用某种方法论，但当你创建一个“迭代”时，系统自动关联需求、任务、Bug、用例；当你给任务打上“进行中”状态，它立刻在看板上移动位置并更新剩余工时；当你发布一个版本，所有关联的需求自动标记为“已发布”，所有未关闭的Bug自动进入下一轮迭代待办池。这种底层逻辑的自洽性，才是它区别于普通任务管理工具的本质。本指南覆盖的三种部署方式——Docker一键式、Linux源码编译、Windows集成包——不是为了炫技，而是对应三类真实场景：运维同事想5分钟拉起测试环境（选Docker）、技术负责人要求完全掌控PHP/MySQL版本及安全策略（选源码编译）、非IT背景的产品经理或小团队负责人需要零配置开箱即用（选Windows集成包）。每种方式背后都有明确的取舍：Docker省事但调试黑盒化；源码编译灵活但依赖环境复杂；集成包友好但升级路径受限。接下来我会把每一步背后的“为什么”掰开揉碎，告诉你哪个参数不能改、哪行日志必须盯、哪个配置项改错会导致整个燃尽图失真。

2. 部署方案深度对比：选对方法比盲目安装重要十倍

2.1 三种部署方式的本质差异与适用边界

很多人一上来就问“哪种最快”，但真正该问的是：“我的团队卡在哪一环？”——是缺运维人力？还是对数据主权有硬性要求？或是连Linux基础命令都不熟？这决定了你该走哪条路。我们先用一张表说清本质：

提示：如果你的服务器已运行Nginx且监听80端口，Docker方案默认会冲突——它启动的Apache容器也想占80。这不是bug，是设计使然：Docker镜像封装了完整LAMP栈，不假设宿主机环境。解决方案只有两个：要么停掉宿主机Nginx（systemctl stop nginx），要么修改Docker启动命令，将容器80端口映射到宿主机其他端口（如-p 8080:80），然后通过http://your-server:8080访问。别试图在容器内改Apache配置，那违背了容器“不可变基础设施”的原则。

2.2 Docker方案：为什么推荐使用官方镜像而非第三方构建版

市面上存在大量标榜“优化版”“加速版”的禅道Docker镜像，它们往往删减了Xdebug、禁用了OPcache、替换了MySQL为MariaDB。看似更快，实则埋下三颗雷：第一，禅道后台的“性能分析”模块依赖Xdebug生成函数调用树，一旦删除，你将无法诊断某个报表加载慢是SQL问题还是PHP循环嵌套过深；第二，OPcache禁用后，每次HTTP请求都要重新解析PHP文件，QPS直接腰斩，在10人并发查看燃尽图时页面明显卡顿；第三，MariaDB虽兼容MySQL协议，但禅道v18+新增的“需求关联图谱”功能使用了MySQL 8.0的CTE（公用表表达式），MariaDB 10.6尚未完全支持，导致图表空白且无报错。官方镜像（easysoft/zentao:latest）虽体积较大（约1.2GB），但经过全链路压测：在4核8G服务器上，支持50人同时操作看板、提交Bug、上传附件，平均响应时间<380ms。它的构建脚本公开可查，每一层都标注了用途（如RUN apt-get install -y php7.4-mysql明确指定PHP MySQL扩展版本），这意味着你遇到问题时，能精准定位到是PHP层、MySQL层还是Apache层的问题。我曾帮某公司排查“新建任务后看板不刷新”问题，发现他们用了某第三方镜像，其PHP配置中output_buffering = Off，导致WebSocket长连接被Nginx代理中断——而官方镜像默认output_buffering = 4096，完美适配禅道的实时推送机制。

2.3 源码编译：那些文档里不会写的“必改配置项”

下载官网源码包（zentaoPMS.18.6.stable.zip）解压后，你面对的是一堆PHP文件。但真正决定系统是否稳定的，是三个藏在角落的配置文件：

1. /config/my.php：这是数据库连接的终极开关。很多人只改$config->db->host和$config->db->password，却忽略$config->db->persist（持久连接开关）。设为true时，PHP进程会复用MySQL连接，减少握手开销，但在高并发下易触发MySQL的max_connections限制；设为false（默认值）则每次请求新建连接，更安全但稍慢。我们的实测结论：若MySQLmax_connections> 200，建议开启；否则保持默认。

2. /config/config.php：这里藏着影响燃尽图准确性的关键参数——$config->global->timezone。它必须与服务器系统时区严格一致！曾有个团队把时区设为Asia/Shanghai，但服务器date命令显示UTC，导致所有任务截止时间在燃尽图上偏移8小时，每日站会数据完全失真。正确做法是先执行timedatectl status确认系统时区，再填入此配置。

3. /www/.htaccess（Apache环境）或/www/nginx.conf（Nginx环境）：URL重写规则。禅道的“需求详情页”链接形如/product-view-123.html，这依赖服务端重写。Apache用户需确保mod_rewrite已启用（a2enmod rewrite），且虚拟主机配置中AllowOverride All已开启；Nginx用户则必须将官网提供的nginx.conf片段完整复制到你的server块中，尤其注意location ~ \.php$块内的fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;——少一个$符号，所有PHP页面都会返回404。

注意：源码部署后首次访问，禅道会引导你完成数据库初始化。此时务必勾选“初始化演示数据”。这不是多此一举——演示数据包含完整的角色权限模板（如“研发组长”可编辑所有任务但不可删除需求，“测试工程师”只能提交Bug和执行用例），让你在配置真实团队前，先看清权限矩阵如何运作。跳过此步，后续手动配置权限极易遗漏关键节点。

3. Docker部署全流程：从拉取镜像到第一个燃尽图诞生

3.1 环境准备与前置检查（3分钟）

在执行任何命令前，请花2分钟做三件事：

1. 确认Docker版本：执行docker --version，必须≥20.10。低于此版本的Docker Desktop在Mac上存在cgroup v2兼容问题，会导致MySQL容器启动失败。若版本过低，卸载重装最新版（官网下载.dmg或.exe）。

2. 释放端口资源：执行sudo lsof -i :80（Mac/Linux）或netstat -ano | findstr :80（Windows WSL），查看80端口占用进程。如果是Skype、IIS或Nginx，记下PID并终止（kill -9 PID或taskkill /F /PID PID）。禅道Docker镜像默认绑定80端口，强行映射到其他端口虽可行，但会导致微信扫码登录等依赖回调URL的功能异常。

3. 创建持久化数据目录：执行mkdir -p /opt/zentao/data/mysql /opt/zentao/data/www。这是最关键的一步！Docker容器重启后内部文件会丢失，但通过-v参数将宿主机目录挂载到容器内，就能永久保存数据库和上传附件。/opt/zentao/data/mysql将存储所有需求、任务、Bug数据；/opt/zentao/data/www则存放用户上传的截图、测试报告PDF等二进制文件。不创建此目录直接运行，首次初始化的数据将在容器删除后彻底消失。

3.2 一行命令启动与初始化（2分钟）

执行以下命令（请逐字复制，注意空格和反斜杠）：

docker run -d \ --name zentao \ -p 80:80 \ -v /opt/zentao/data/mysql:/var/lib/mysql \ -v /opt/zentao/data/www:/app/zentaopms/www \ -e MYSQL_ROOT_PASSWORD=your_secure_password_123 \ -e ZENTAO_ADMIN_USER=admin \ -e ZENTAO_ADMIN_PASSWORD=your_admin_password_456 \ --restart=always \ easysoft/zentao:latest

解释每个参数的意义：

• -d：后台守护进程模式运行，避免终端被占用；
• --name zentao：为容器指定名称，便于后续管理（如docker stop zentao）；
• -p 80:80：将宿主机80端口映射到容器80端口；
• -v：两次挂载，分别绑定MySQL数据和Web文件；
• -e：设置环境变量，MYSQL_ROOT_PASSWORD是MySQL root密码（必须设置，否则容器启动失败），ZENTAO_ADMIN_USER/PASSWORD是禅道管理员账号（首次访问时自动创建）；
• --restart=always：服务器重启后自动启动容器，保障服务连续性。

执行后，你会看到一串64位容器ID。立即执行docker ps -a，确认状态为Up X minutes且PORTS列为0.0.0.0:80->80/tcp。若状态为Exited，执行docker logs zentao查看错误——90%的情况是/opt/zentao/data/mysql目录权限不足（需chmod -R 755 /opt/zentao/data）或磁盘空间不足（df -h检查）。

3.3 首次访问与基础配置（5分钟）

打开浏览器，访问http://localhost（Mac/Linux）或http://192.168.x.x（Windows WSL，需查WSL IP：wsl -l -v后进Ubuntu执行ip addr show eth0 | grep inet）。首次加载可能需10-15秒（MySQL初始化+PHP缓存预热），请耐心等待。

进入后，你将看到禅道欢迎页。点击右上角“登录”，使用环境变量中设置的admin和your_admin_password_456登录。登录后第一件事：立即修改管理员密码。点击右上角头像→“编辑资料”→在“密码”栏输入新密码（至少8位，含大小写字母+数字），点击保存。这是安全基线，因为环境变量中的密码会留在docker inspect zentao输出里，任何人执行该命令都能看到。

接着，进入“后台”→“组织”→“部门”，删除默认的“研发部”“测试部”等演示部门，按你团队实际结构创建（如“前端组”“后端组”“QA中心”）。为什么必须现在做？因为禅道的权限模型基于“部门-角色-用户”三级绑定，如果先添加用户再调整部门，用户会继承旧部门的权限，后期清理极其麻烦。创建完部门后，再进入“用户”→“添加用户”，为每个成员填写姓名、邮箱、所属部门，并分配角色（如“研发组长”“测试工程师”）。注意：邮箱必须真实有效，因为禅道的“任务指派通知”“Bug修复提醒”均通过邮件发送，且首次登录时会发送激活链接。

3.4 创建第一个迭代与燃尽图（8分钟）

这才是体现禅道价值的核心环节。点击顶部导航栏“项目”→“迭代”，点击右上角“创建迭代”。

• 迭代名称：输入“V1.0需求开发”（不要用“测试迭代”“临时迭代”等模糊词）；
• 开始/结束日期：选择今天到7天后（敏捷推荐1-4周，新手建议从1周起步）；
• 关联产品：下拉选择“演示产品”（首次使用，系统已预置）；
• 关联需求：点击右侧“+”号，勾选演示需求中的“用户登录功能优化”“订单列表分页改进”等3-5个需求（切忌一次选太多，新手迭代控制在5个需求内）；
• 负责人：选择你自己（作为迭代负责人，你将收到所有阻塞提醒）；
• 描述：简要说明目标，如“完成V1.0核心功能开发，交付测试团队”。

点击“保存”后，页面自动跳转到该迭代详情页。此时左侧菜单会出现“需求”“任务”“Bug”“用例”四个标签。点击“需求”，你会看到刚才关联的需求列表。选中“用户登录功能优化”，点击右侧“分解任务”。在弹出窗口中：

• 任务名称：输入“前端：登录页UI重构”；
• 估算工时：填“8”（单位：小时，禅道默认1天=8小时）；
• 执行者：选择“前端组”下的某位成员；
• 类型：选择“开发”（非“研究”“测试”）；
• 描述：写明具体动作，如“使用Vue3重写登录组件，适配暗色模式”。

重复此操作，为每个需求创建2-3个开发任务。全部创建完毕后，点击顶部“燃尽图”标签。你会看到一条红色曲线（剩余工时）和一条绿色曲线（已完成工时）。初始状态：红色曲线从总估算工时（如40小时）开始，绿色曲线为0。这就是你的敏捷仪表盘——每天晨会时，只需看这条线是否按预期下降，就能判断进度是否健康。如果第三天红色曲线仍停留在35小时，说明任务卡住了，需要立即在站会上追问阻塞原因。

4. 源码编译部署：从零构建可控、可审计的生产环境

4.1 系统依赖与PHP环境精调（15分钟）

禅道v18+要求PHP 7.4或8.0，但官方文档未强调一个致命细节：必须启用PHP的sockets扩展。该扩展负责禅道的WebSocket实时通知（如“张三给你指派了一个新任务”）。若未启用，所有实时推送失效，用户只能手动刷新页面。检查方法：php -m | grep sockets，若无输出，则需安装。

• Ubuntu/Debian：sudo apt-get install php7.4-sockets（PHP7.4）或sudo apt-get install php8.0-sockets（PHP8.0）；
• CentOS/RHEL：sudo yum install php-pecl-sockets（PHP7）或sudo dnf install php-pecl-sockets（PHP8）。

安装后重启Web服务：sudo systemctl restart apache2（Ubuntu）或sudo systemctl restart httpd（CentOS）。

另一个常被忽略的是memory_limit。禅道导入大型测试用例集时，PHP默认128M内存会触发Allowed memory size exhausted错误。需修改/etc/php/7.4/apache2/php.ini（路径依PHP版本而定）：

memory_limit = 512M post_max_size = 128M upload_max_filesize = 100M

其中upload_max_filesize直接影响用户能否上传10MB以上的测试视频，post_max_size必须≥upload_max_filesize，否则上传会静默失败。

实操心得：在修改PHP配置后，务必执行php -i | grep "Loaded Configuration File"确认生效的ini文件路径，再用php -m | grep sockets验证扩展加载成功。我曾因编辑了错误的php.ini（CLI版而非Apache版），导致Web界面一切正常，但后台计划任务（如每日备份）始终失败，排查耗时3小时。

4.2 数据库初始化与字符集陷阱（10分钟）

禅道要求MySQL字符集为utf8mb4，以支持Emoji和四字节UTF-8字符（如某些生僻汉字）。但MySQL 5.7默认字符集是latin1，即使创建数据库时指定CHARSET=utf8mb4，表字段仍可能继承服务器默认值。最稳妥的做法是修改MySQL全局配置：

编辑/etc/mysql/mysql.conf.d/mysqld.cnf（Ubuntu）或/etc/my.cnf（CentOS），在[mysqld]段下添加：

character-set-server = utf8mb4 collation-server = utf8mb4_unicode_ci init_connect='SET NAMES utf8mb4' skip-character-set-client-handshake = true

然后重启MySQL：sudo systemctl restart mysql。

接着创建专用数据库：

CREATE DATABASE zentao DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'zentao'@'localhost' IDENTIFIED BY 'strong_password_789'; GRANT ALL PRIVILEGES ON zentao.* TO 'zentao'@'localhost'; FLUSH PRIVILEGES;

注意：用户名zentao和数据库名zentao不必相同，但强烈建议保持一致，避免配置文件中混淆。GRANT语句中的ALL PRIVILEGES是必需的，因为禅道在升级时会执行ALTER TABLE添加新字段，权限不足会导致升级失败且无明确报错。

4.3 禅道配置文件实战修改（5分钟）

解压源码到/var/www/html/zentao后，进入/var/www/html/zentao/config/目录。需要修改三个文件：

1. my.php：数据库连接配置。将$config->db->host设为localhost（非127.0.0.1！因为MySQL socket连接在localhost下更快，且避免IPv6解析问题）；$config->db->user和$config->db->password填入上一步创建的zentao用户凭据。

2. config.php：全局配置。找到$config->webRoot = '/zentao/'，若你将禅道放在网站根目录（即通过http://your-domain.com/访问），则改为$config->webRoot = '/'；若放在子目录（如/pm/），则改为$config->webRoot = '/pm/'。此配置错误会导致所有CSS/JS路径404，页面变成纯文字。

3. .htaccess（Apache）：确保文件存在且内容为官网最新版。特别检查RewriteBase /zentao/这一行——若禅道在根目录，需改为RewriteBase /；若在/pm/，则改为RewriteBase /pm/。少改一个斜杠，整个URL重写机制就瘫痪。

修改完成后，给Web服务器用户赋权：

sudo chown -R www-data:www-data /var/www/html/zentao # Ubuntu sudo chown -R apache:apache /var/www/html/zentao # CentOS sudo chmod -R 755 /var/www/html/zentao

注意：www-data（Ubuntu）和apache（CentOS）是Web服务默认用户组，不可写成root，否则存在严重安全风险。

4.4 首次访问与安全加固（7分钟）

浏览器访问http://your-domain.com/（或子目录路径）。系统会自动跳转到安装向导页。按提示输入数据库信息（即my.php中配置的zentao用户），点击“下一步”。安装成功后，立即执行两步安全操作：

1. 删除安装向导文件：执行sudo rm -f /var/www/html/zentao/install.php。该文件若残留，任何人都能重新初始化数据库，清空所有数据。

2. 禁用PHP错误显示：编辑/etc/php/7.4/apache2/php.ini，将display_errors = On改为display_errors = Off。生产环境暴露PHP错误信息是重大安全隐患，攻击者可借此探测服务器路径、数据库结构。

接着，登录管理员账号（默认admin/123456），立即修改密码。然后进入“后台”→“安全”→“IP白名单”，添加你公司办公网段（如192.168.1.0/24）和运维人员公网IP。启用后，不在白名单的IP访问将直接返回403，极大降低暴力破解风险。

5. Windows集成包部署：给产品经理的零门槛敏捷启动器

5.1 安装包选择与防坑指南（2分钟）

官网提供两种Windows包：“禅道Pro版”（收费，含高级报表、LDAP集成）和“禅道开源版”（免费，功能完整）。对于初次尝试，务必下载开源版。Pro版安装后需在线激活，若网络不稳定，激活失败会导致所有功能灰显，且无法回退到开源版。

下载后，你会得到一个ZenTaoPMS.18.6.exe文件。双击运行时，不要点击“快速安装”！这是最大陷阱。快速安装会将所有文件（包括MySQL数据）默认安装到C:\Program Files\，而Windows对该目录有严格的UAC权限控制，导致禅道无法写入数据库，首次访问时提示“数据库连接失败”。正确操作是点击“自定义安装”，将安装路径改为D:\zentao（或其他非系统盘、无空格、无中文的路径）。

安装过程中，会弹出MySQL配置窗口。这里有两个关键选项：

• Root密码：输入一个强密码（如Zt@2024!），并牢记。此密码用于后续数据库维护；
• 端口：保持默认3306。除非你服务器已运行其他MySQL服务，否则不要修改。禅道集成包的PHP和Apache已预配置为连接localhost:3306，改端口需手动修改多个配置文件。

5.2 启动服务与首次配置（3分钟）

安装完成后，桌面会出现“禅道服务管理器”快捷方式。双击打开，你会看到三个服务：Apache2.4、MySQL5.7、ZenTao。点击“启动”按钮，所有服务状态变为“运行中”。若某个服务启动失败（如MySQL显示“启动失败”），点击右侧“日志”按钮，查看D:\zentao\mysql\data\*.err文件——90%的情况是磁盘空间不足或my.ini中datadir路径指向了不存在的目录。

服务启动后，打开浏览器访问http://127.0.0.1。首次访问会跳转到“初始化向导”。向导会自动检测MySQL连接，输入你设置的Root密码，点击“下一步”。系统将自动创建数据库、导入演示数据、生成管理员账号。

向导完成后，用默认账号admin/123456登录。立即修改密码：点击右上角头像→“编辑资料”→输入新密码。然后，点击左上角“后台”→“组织”→“部门”，删除所有演示部门，创建你团队的真实部门结构。这一步必须在添加用户前完成，理由同Docker方案。

5.3 日常维护与升级避坑（5分钟）

集成包的优势是简单，劣势是升级需谨慎。升级时，官网会提供新版ZenTaoPMS.X.X.exe。绝对禁止直接双击运行新安装包覆盖旧版！这会清空D:\zentao\www\data\目录下的所有上传文件（测试截图、附件），且数据库结构可能不兼容。

正确升级流程：

1. 停止所有服务（在服务管理器中点击“停止”）；
2. 备份D:\zentao\www\data\目录（整个文件夹复制到其他位置）；
3. 备份D:\zentao\mysql\data\zentao\目录（这是数据库文件，.frm和.ibd文件）；
4. 运行新安装包，选择“升级安装”，并指定原安装路径D:\zentao；
5. 升级完成后，启动服务，访问http://127.0.0.1，系统会自动检测数据库版本并执行升级SQL；
6. 登录后，进入“后台”→“系统”→“检查更新”，确认版本号已变更。

注意事项：集成包的MySQL服务默认不设置开机自启。若服务器重启后禅道无法访问，是因为MySQL服务未启动。解决方法：在“禅道服务管理器”中，右键MySQL服务→“属性”→将“启动类型”改为“自动”，点击确定。这样服务器重启后，MySQL会自动拉起，禅道随之可用。

6. 常见问题与排查技巧实录：那些让老手也皱眉的“幽灵问题”

6.1 燃尽图不更新？先查这三个隐藏开关

燃尽图是禅道的“心脏”，但它不工作时，错误提示往往藏在深处：

• 问题现象：迭代已开始3天，但燃尽图红色曲线纹丝不动，任务状态已改为“已完成”。

• 排查路径1：检查任务工时是否录入。燃尽图计算逻辑是“总估算工时 - 已完成工时”，而非“任务数量”。进入“任务”列表，点击任意一个“已完成”任务，查看“消耗工时”字段。若为0，说明执行者未在完成时填写实际耗时。禅道不会自动将“估算工时”计入“消耗”，必须手动填写。解决方案：在任务详情页点击“记录工时”，输入实际花费小时数。

• 排查路径2：确认迭代状态是否为“执行中”。进入“项目”→“迭代”，找到该迭代，点击右侧“编辑”。检查“状态”下拉框是否为“执行中”。若误设为“已暂停”或“已取消”，燃尽图将停止计算。这是UI设计缺陷：状态变更无二次确认，且列表页不显示状态图标。

• 排查路径3：检查系统时间同步。执行date命令，对比服务器时间与北京时间。若偏差超过5分钟，燃尽图的时间轴会错乱。解决方案：sudo timedatectl set-ntp true启用NTP同步，再执行sudo timedatectl status确认同步成功。

6.2 邮件通知失效？90%是SMTP配置的“隐形坑”

禅道邮件通知依赖SMTP服务器，但配置界面有三个易错点：

1. 端口与加密协议不匹配：若SMTP服务器用smtp.qq.com，端口填465，则加密方式必须选“SSL”；若端口填587，则必须选“TLS”。填错会导致连接超时，日志中只显示“Failed to connect to server”。

2. 发件人邮箱格式错误：在“后台”→“邮件”→“SMTP设置”中，“发件人邮箱”必须与SMTP登录账号完全一致。例如，QQ邮箱登录账号是yourname@qq.com，则发件人邮箱也必须填yourname@qq.com，填Your Name <yourname@qq.com>会失败。

3. QQ邮箱需开启“POP3/SMTP服务”并生成授权码：这是最常被忽略的。QQ邮箱默认关闭SMTP，需登录邮箱网页版→“设置”→“账户”→“POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”→开启“POP3/SMTP服务”，然后点击“生成授权码”。此授权码不是QQ密码，需填入禅道SMTP设置的“密码”栏。

验证方法：在禅道后台点击“测试邮件”，若收到测试信，说明配置成功；若失败，查看/var/www/html/zentao/tmp/logs/mail.log（Linux）或D:\zentao\www\tmp\logs\mail.log（Windows），日志末尾会显示具体错误（如Authentication failed）。

6.3 附件上传失败？聚焦文件系统与PHP的双重限制

用户上传PNG截图或PDF测试报告时，常见“上传失败”提示，根源在三层限制：

• 第一层：PHP限制。检查php.ini中upload_max_filesize（单文件上限）和post_max_size（POST数据总上限）。若用户传100MB视频，upload_max_filesize需≥100M，且post_max_size需≥100M+表单其他字段大小（通常加10M余量）。

• 第二层：Web服务器限制。Apache需在虚拟主机配置中添加LimitRequestBody 209715200（200MB）；Nginx需在server块中添加client_max_body_size 200M;。

• 第三层：文件系统权限。禅道上传目录为/var/www/html/zentao/www/data/upload/（Linux）或D:\zentao\www\data\upload\（Windows）。执行ls -ld /var/www/html/zentao/www/data/upload/，确认属主为www-data（Ubuntu）或apache（CentOS），且权限为drwxr-xr-x。若为drwx------，则执行sudo chmod 755 /var/www/html/zentao/www/data/upload/。

实测案例：某团队上传失败，日志显示failed to open stream: Permission denied。检查发现upload目录属主是root，而Apache以www-data运行，无写入权限。执行sudo chown www-data:www-data /var/www/html/zentao/www/data/upload/后立即解决。

6.4 权限混乱？用“角色继承图谱”快速定位

当用户反馈“看不到某需求”或“无法编辑任务”时，不要盲目重置权限。禅道的权限模型是“部门→角色→用户”三级继承，且支持“全局角色”与“项目角色”叠加。快速诊断法：

1. 进入“后台”→“组织”→“用户”，找到该用户，点击“编辑”；
2. 在“角色”标签页，查看“全局角色”（如“研发组长”）和“项目角色”（如“V1.0迭代-开发”）；
3. 点击“全局角色”后的“查看权限”，系统会列出该角色所有权限项（如“需求-查看”“任务-编辑”）；
4. 若权限项为灰色，说明被更高优先级角色覆盖（如“测试工程师”角色禁用了“需求-编辑”，而用户同时拥有此角色）；
5. 解决方案：进入“后台”→“权限”→“角色权限”，找到冲突角色，取消勾选冲突权限，或调整用户的角色分配顺序（上方角色权限优先级更高）。

实操心得：我曾处理一个“测试工程师看不到Bug”的案例，最终发现是该用户被错误分配了“访客”角色，而“访客”角色的“Bug-查看”权限被设为“否”，且位于角色列表顶部。移除“访客”角色后，问题瞬间解决。这印证了一条铁律：禅道权限是“叠加+覆盖”，不是“或运算”。

7. 从部署到落地：让禅道真正驱动团队协作的3个关键动作

部署完成只是起点，让禅道从“又一个软件”变成“团队呼吸的空气”，需要三个刻意练习的动作：

第一，把每日站会变成“燃尽图校准仪式”。不要在会议室口头汇报“我昨天做了A，今天做B”。改为：所有人围在投影前，打开当前迭代的燃尽图。负责人指着红色曲线说：“昨天计划完成8小时，但曲线只下降了3小时，差5小时。张三，你负责的‘支付接口对接’任务状态是‘进行中’，但消耗工时为0，是卡在联调环境？还是需求理解有偏差？”——用数据锚定问题，10分钟内聚焦阻塞点，而非泛泛而谈。

第二，让“需求”成为唯一源头，消灭Excel和Word需求文档。当产品经理提出新需求，第一步不是写PRD，而是登录禅道，创建一个需求条目，填写标题、背景、验收标准（Acceptance Criteria），并关联到即将开始的迭代。所有