每次配置变更实时推送:Traefik Manager Webhook通知接入Discord、Slack与ntfy
每次配置变更实时推送:Traefik Manager Webhook通知接入Discord、Slack与ntfy
Traefik Manager 是一款面向 Traefik 反向代理的自托管 Web 管理面板,它的 Webhook 通知功能可以把每一次配置变更(路由保存、中间件删除、备份恢复、登录事件等)实时推送到 Discord、Slack、ntfy 或任意 JSON 接口——改完配置不用刷页面,手机上直接收到消息。本文是一份面向新手的完整接入指南,带你 5 分钟搞定 Traefik 通知推送。
为什么需要 Webhook 通知
日常运维 Traefik 时,你可能经常遇到这些场景:
- 📱 人在外面,同事改了一条路由,服务突然 502——完全不知道谁改了什么
- 💾 备份恢复操作成功了,但没人盯着屏幕,错过确认信息
- 🔐 有人频繁登录管理面板,没有登录事件提醒
Webhook 通知就是解决这个问题的:任何关键事件发生时,Traefik Manager 会向指定地址发起一次 HTTP POST,把事件类型和时间戳推送到你的 IM 或通知渠道,实现配置变更实时推送。
一键配置:5分钟接入 Webhook
整个配置过程不需要写一行代码,全程在界面里完成:
- 打开 Settings(设置)→ Notifications(通知) 面板
- 在 Type 下拉框选择目标平台:Discord / Slack / ntfy / Generic JSON
- 粘贴对应的 Webhook URL
- 如果是自托管 ntfy 或需要 Basic Auth 的通用接口,填入 Username / Password(不需要则留空)
- 点击 Test 按钮立即发送一条测试消息,确认链路通畅
- 收工——设置会在失焦时自动保存,无需手动提交
设置面板的前后端实现分别位于 templates/modals/settings_modal.html 和 static/js/settings-modal.js,其中 Test 按钮会调用 /api/settings/webhook-test 接口做一次真实投递测试。
💡 小提示:Webhook URL 会经过 SSRF 防护校验,内网保留地址等非法目标会被直接拒绝,测试失败时界面会显示具体错误原因。
三大平台的推送效果
不同平台收到的消息格式是针对性优化的,由 core/notifications.py 中的投递逻辑统一处理:
Discord:彩色卡片消息
Discord 消息以 Embed 卡片形式展示,颜色随事件类型变化:
| 事件级别 | 颜色 | 典型场景 |
|---|---|---|
success |
🟢 绿色 | 路由保存、备份创建 |
warning |
🟡 黄色 | 路由删除、备份恢复 |
error |
🔴 红色 | 保存失败、恢复失败 |
info |
🔵 蓝色 | 登录事件、版本更新 |
卡片底部带有 Traefik Manager - 时间戳 的页脚,一眼即可区分来源。
Slack:带状态图标的文本消息
Slack 消息简洁直白,每条消息开头附带对应状态的 emoji 图标(✅ 成功、⚠️ 警告、❌ 错误、ℹ️ 信息),后接事件描述,例如:
:white_check_mark: *Traefik Manager* - Route my-app saved
ntfy:手机推送直达
ntfy 既可以用官方托管服务,也可以指向自托管实例。此时 Traefik Manager 会额外发送三个请求头,让手机通知栏显示得更规范:
| 请求头 | 值 |
|---|---|
X-Title |
Traefik Manager |
X-Priority |
警告/错误为 4,信息/成功为 3 |
X-Tags |
warning、rotating_light、white_check_mark 等表情标签 |
如果你的 ntfy 实例启用了鉴权,在设置面板填入用户名和密码即可(对应 manager.yml 中的 webhook_username / webhook_password,密码加密存储)。
哪些事件会触发通知
通知覆盖面远超"改路由",主要事件包括:
- ✅ 配置变更:路由保存/更新/删除、中间件增删、TLS 配置保存、静态配置保存
- 💾 备份操作:备份创建、备份恢复、Git 备份推送成功或失败
- 🔐 安全事件:用户登录(含 OIDC 登录)、CrowdSec IP 解封
- ⚙️ 系统事件:Traefik 重启、GeoIP 数据库更新、版本更新提醒
- 🌐 监控事件:Ping 监控失败
同时这些事件也会记录在面板内的通知日志中(最多保留 200 条,持久化到本地文件),Webhook 投递在后台线程异步执行、超时 5 秒即放弃,绝不会阻塞你的操作界面。
用 Generic JSON 对接你自己的系统
不想用现成平台?选择 Generic JSON 类型,Traefik Manager 会把如下标准 JSON 投递到任意 HTTP 端点,方便接入 Zabbix、企业微信机器人、自建网关等:
{
"event": "route_saved",
"message": "Route my-app saved",
"timestamp": "2026-05-18 12:00:00"
}
也可以完全走配置文件方式:在 manager.yml 中设置以下四个参数(配置项详解见 docs/manager-yml.md):
# -- Notification Webhooks ----------------------------------------------------
webhook_url: "https://discord.com/api/webhooks/xxxx"
webhook_type: "discord" # discord | slack | ntfy | generic
webhook_username: ""
webhook_password: ""
修改后保存即可,与界面操作完全等价。
常见问题速答
Q:通知失败会影响 Traefik Manager 正常使用吗? 不会。Webhook 在独立后台线程中发送,失败只会在服务端日志中记录一条 warning,不影响任何面板操作。
Q:Webhook 密码安全吗?
安全。webhook_password 在写入 manager.yml 前经过加密处理,API 返回设置时该字段也会被自动剔除,不会明文暴露。
Q:能同时推送到多个平台吗? 当前版本为单 URL 配置。如果需要多目标,可以把 Generic JSON 指向一个转发服务(如自建网关),再分发给多个渠道。
Q:官方文档在哪看? 完整 Webhook 文档见 docs/webhooks.md,功能总览见 docs/guide.md。
总结
Traefik Manager 的 Webhook 通知让每一次配置变更实时推送到 Discord、Slack 或手机(ntfy),全程零代码、5 分钟配置完成。对于多团队协作或远程运维 Traefik 反向代理的场景,它能显著降低"配置被改了却毫不知情"的运维风险。配合备份恢复提醒与登录事件推送,自托管环境的安全感和掌控感都会明显提升。


