私有化部署项目管理系统3类消息通知配置

私有化部署项目管理系统把程序、数据和运维责任放在企业自己的服务器上，消息通知也随之从“厂商默认开启”变成一项要自己配置、自己验证的基础能力。SaaS 产品通常由厂商维护发信服务，私有化环境则要自己处理 SMTP、外网出口和账号绑定。以禅道项目管理软件为例，常用的消息通知可以分成三类：站内通知、邮件通知、Webhook 外部通知。三类通道的入口和依赖不同，混在一起调，容易出现“测试成功、业务通知不到”的情况。

三类消息通知的分工与前提

三类通道解决的不是同一个问题。站内通知留在系统内，不依赖外网；邮件适合正式留痕和跨部门触达；Webhook 把项目动态推到企业常用的协作工具里，适合需要快速响应的群组。

短信需要独立网关，不在本文三类主线内；如果企业已有网关，可在“后台-通知设置-短信”单独配置。

无论选哪几类，先确认三件事：管理员有通知设置权限；用户账号里有可用邮箱或已完成外部账号绑定；服务器能访问对应的 SMTP 服务或 Webhook 地址。私有化部署项目管理系统的通知问题，多数不是开关没开，而是链路中间某一环没有打通。

第一类：站内通知怎么配

站内通知由系统通知、浏览器通知和消息中心组成。禅道 11.6.2 起提供浏览器通知；12 系列在“后台-通知-浏览器”设置；18 系列及以上改为“后台-通知设置-系统通知”；20.4 及以上增加消息中心。版本不同，菜单名称有差异。

1. 管理员登录后台，进入“通知设置-系统通知”；旧版本按“通知-浏览器”进入。
2. 打开系统通知，设置轮询时间。官方默认 300 秒；调小会更及时，但会增加服务器负载。
3. 进入“通知设置-设置”勾选需要提醒的动作。列表可按模块或通知类型批量勾选。
4. 用户首次使用时允许浏览器推送；在消息中心查看未读和全部消息，按需设置保留天数。

验证时，用测试账号把任务指派给另一个账号，等待一个轮询周期，检查右下角提醒和消息中心。没有收到，按浏览器权限、系统通知开关、触发动作依次排查。

站内通知适合做兜底通道。 它不经过外部服务，私有化环境里更稳定，也更适合承载“知道即可”的项目动态。

第二类：邮件通知怎么配

邮件通知依赖 SMTP。私有化部署环境里，发信服务器可以是企业内网邮件网关，也可以是外部企业邮箱；关键是禅道服务器能连通 SMTP 地址和端口。

1. 进入“后台-通知设置-邮件”，填写发信邮箱，点击下一步。
2. 配置 SMTP 服务器、端口、加密方式、账号和密码或授权码，并填写禅道访问域名。域名用于邮件里的链接，不要填 localhost。
3. 保存后选择禅道内用户做“测试发信”。
4. 到组织或人员管理里维护用户邮箱，再回“通知设置-设置”勾选邮件列的动作。

测试发信成功只证明 SMTP 通了，不代表业务通知一定发出；禅道不会给当前操作者发信。 用操作账号测试时，容易误判。

如果企业有邮件网关，优先走内网中继；使用外部邮箱时，让网络管理员放行 SMTP 端口，并把发信域名加入白名单。不要把个人登录密码当 SMTP 密码，按服务商要求使用授权码。

业务邮件没有收到，按顺序查：触发动作是否勾选、收件人邮箱是否为空、邮件是否被网关拦截、定时任务是否正常。禅道官方手册提到可查看 tmp/log 下 sass 开头的日志，确认是否有发送记录。

第三类：Webhook 外部通知怎么配

Webhook 的本质是把项目操作以 JSON 发到第三方地址。禅道内置了钉钉群机器人、企业微信群机器人、企业微信应用消息等类型。群机器人面向群聊，配置简单，不需要绑定到个人；应用消息面向个人，需要企业 ID、应用 Secret、AgentId，并完成用户绑定。

1. 在协作工具里创建群机器人或企业应用，拿到 Webhook 地址、密钥或应用凭证。
2. 进入“后台-通知设置-Webhook”，添加 Webhook，选择类型，填名称、Hook 地址和密钥或凭证。
3. 选择发送方式。同步是操作后立即发送；异步需要到“后台-系统-定时”配置计划任务，18.2 后入口调整为“后台-系统设置-定时”。
4. 按需关联产品和执行。留空表示所有操作都发送，范围越大，噪声越高。
5. 群机器人直接保存；应用消息还要绑定用户。
6. 回“通知设置-设置”勾选 Webhook 列的动作。

钉钉群机器人目前只支持加签方式，官方手册标注每分钟最多发送 20 条消息。通知量大的团队要分开使用群机器人和应用消息，避免刷屏。

私有化环境下，服务器要能访问协作工具的 API 域名。外网出口受限时，让网络管理员按目标域名放行，或通过企业网关转发。Webhook 密钥不要写进代码仓库，人员变动后及时解绑或轮换。

日志显示成功但群里没有消息，先查触发动作、关联产品或执行、用户绑定、群机器人是否被移出群、成员是否屏蔽通知。企业微信应用消息绑定不到用户时，检查应用可见范围和域名解析。

一套可落地的配置顺序

不要一上来把三类通道全部打开。按下面顺序推进，改动可控，也容易定位问题。

1. 先定通知矩阵。把事件分成“必须知道、需要留痕、只在系统内看”三类。任务指派、Bug 解决、需求变更通常需要即时提醒；日报、周报更适合站内或邮件。
2. 补齐人员数据。邮箱、外部账号绑定、部门可见范围先维护好。
3. 逐类配置并测试。先站内，再邮件，最后 Webhook，每类都做一次端到端测试。
4. 勾选触发动作。只勾真正需要的动作，全选会制造噪声，也会放大邮件和群消息的发送压力。
5. 单项目试点。选一个规模化研发团队或一个项目集运行一周，观察漏报和噪声，再推广。

通知配置是管理规则的落地，不是把开关全部打开。 先回答“什么事件、通知谁、走哪条通道”。

上线前检查与常见故障

配置完成后，至少做一次端到端检查。下面几类现象在私有化环境里比较常见。

配置完成后保留一份记录：版本、菜单路径、SMTP 地址和端口、Webhook 类型、触发动作、测试时间。升级或换管理员时，这份记录比口头交接有用。

如果日志、定时任务和版本升级也需要长期做法，可以参考禅道图书馆的私有化部署项目管理系统运维指南。通知配置不是一次性的，版本升级、人员变动和网络策略调整都会影响它。

写在最后

三类消息通知不是互相替代的关系。站内通知保证系统内可见，邮件负责留痕和跨边界触达，Webhook 把关键动态推到团队已经在用的协作工具里。私有化部署项目管理系统把这三条链路的所有权交给企业，也把配置和验证的责任交给企业。

先把站内通知跑通，再补邮件，最后接 Webhook。 每类都留下测试记录和排查路径，这样配置出来的通知，才是团队真正会看的通知。

参考资料

• 禅道使用手册：邮件，https://www.zentao.net/book/zentaopms/995.html
• 禅道使用手册：Webhook，https://www.zentao.net/book/zentaopms/996.html
• 禅道使用手册：浏览器，https://www.zentao.net/book/zentaopms/998.html
• 禅道使用手册：通知设置，https://www.zentao.net/book/zentaopms/999.html
• 禅道使用手册：集成企业微信应用消息通知，https://www.zentao.net/book/zentaopms/367.html