Uptime Kuma 对接群晖 Chat Webhook 配置教程：一键接收监控告警

平时用 Uptime Kuma 监控网站、服务运行状态，想要第一时间收到故障通知？把 Uptime Kuma 对接群晖 Synology Chat，就能在群晖聊天工具里实时接收上下线提醒、故障告警，不用时刻盯着后台，运维更省心。本篇教程手把手教你完成 Webhook 配置，避开报错坑，轻松实现监控消息推送，适用于新手及运维从业者，全程无复杂代码，跟着操作就能搞定。

前期准备

开始配置前，先确认这两项准备工作已完成，避免后续配置受阻，减少无效操作：

1. 正常运行的 Uptime Kuma：已部署完成（Docker、本地、云服务器均可），且已添加监控项目（网站、服务器、端口等），状态检测正常。
2. 群晖 Chat 已部署：NAS 已安装并启用 Synology Chat，可正常登录，且已创建用于接收告警的频道。

群晖 Chat 获取传入 Webhook 链接（核心步骤）

首先在群晖 Chat 中创建传入 Webhook，拿到专属推送链接，这是 Uptime Kuma 推送消息的关键入口。

1. 登录群晖 NAS 后台，打开 Synology Chat；
2. 点击右上角头像 → 整合；
3. 切换到 传入 Webhook 标签 → 点击 添加；
4. 设置名称（如：Uptime Kuma 监控告警），选择接收频道，保存；
5. 复制生成的 Webhook URL，必须对双引号做 URL 转义，否则推送失败。

原生未转义链接示例：

https://你的群晖IP:5001/webapi/entry.cgi?api=SYNO.Chat.External&method=incoming&version=2&token="你的token"

转义后可直接使用的链接（必改）：

https://你的群晖IP:5001/webapi/entry.cgi?api=SYNO.Chat.External&method=incoming&version=2&token=%22你的token%22

说明：把 " 替换为 %22，群晖 IP 和 token 保持不变。

Uptime Kuma Webhook 基础配置

1. 打开 Uptime Kuma 后台 → 左侧 通知 → 添加通知；
2. 通知类型选择 Webhook，友好名称填写：群晖 Chat 监控告警；
3. Post URL 粘贴转义后的群晖 Webhook 链接；
4. HTTP 方法选择：POST；
5. 内容类型必须选择：application/x-www-form-urlencoded（选错必报错）。

自定义请求体模板（无报错美化版）

以下模板无三元表达式、无复杂语法，彻底解决 TokenizationError 报错，直接复制粘贴即可。

模板一：简约清晰版（推荐新手）

payload={"text": "📊【Uptime Kuma 监控通知】\n================================\n📌 服务名称：{{monitorJSON.name}}\n📈 状态信息：{{msg}}\n🌐 访问地址：<{{monitorJSON.url}}|点击打开>\n⏰ 触发时间：{{heartbeatJSON.time}}\n================================\n💡 提示：点击链接可快速检查服务状态"}

模板二：醒目告警版（适合运维）

payload={"text": "🚨【Uptime Kuma 服务告警】\n========================================\n【服务】：{{monitorJSON.name}}\n【状态】：{{msg}}\n【地址】：<{{monitorJSON.url}}|立即排查>\n【时间】：{{heartbeatJSON.time}}\n【错误详情】：{{heartbeatJSON.msg}}\n========================================\n⚠️ 请及时处理，保障服务稳定运行"}

模板三：极简高效版

payload={"text": "🔔【Uptime Kuma 状态提醒】\n• 服务：{{monitorJSON.name}}\n• 状态：{{msg}}\n• 链接：<{{monitorJSON.url}}>\n• 时间：{{heartbeatJSON.time}}"}

保存并测试推送

1. 将模板完整粘贴到 自定义 HTTP 请求体；
2. 拉到页面底部，点击 保存；
3. 在通知列表点击 测试，群晖 Chat 应立即收到消息；
4. 编辑监控项目，在 通知 中勾选本条通道，保存即可自动告警。

常见报错与解决方法

1. TokenizationError 报错（最常见）

原因：使用了 JS 三元表达式、复杂判断语法。

解决：直接使用本文提供的纯变量模板，不要手写复杂语法。

2. 收不到任何通知

原因：双引号未转义、内容类型错误、端口未放行、未绑定监控项目。

解决：检查链接转义、确认格式为 application/x-www-form-urlencoded、放行 5000/5001 端口、检查监控通知绑定。

3. 消息乱码 / 排版错乱

原因：JSON 格式错误、手动修改了引号或换行。

解决：完整复制本文模板，不做任何修改直接粘贴。

配置小结

Uptime Kuma 对接群晖 Chat Webhook 只需三步：
① 群晖获取 Webhook 并转义双引号 → ② Uptime Kuma 设置 POST + 指定内容格式 → ③ 粘贴无报错模板。

全程无需代码基础，新手也能快速实现监控告警实时推送，大幅提升运维效率。后续可在不破坏 JSON 结构的前提下，自由修改文字、表情，适配自己的使用习惯。