如何把 Uptime Kuma 的监控告警接入 ntfy 并测试通知【免费下载链接】ntfySend push notifications to your phone or desktop using PUT/POST项目地址: https://gitcode.com/GitHub_Trending/nt/ntfy如果你用 Uptime Kuma 做站点或服务可用性监控希望监控状态变化宕机、恢复、测试通知直接推送到手机或桌面ntfy 文档提供了一个现成的对接路径在 Uptime Kuma 的 Notifications 里添加 ntfy 通知类型填入 ntfy topic 和服务器地址然后用测试通知确认链路通了再把该通知绑定到具体监控项。完成后的结果是Uptime Kuma 每次触发告警时ntfy 的订阅端Web 应用、CLI 或手机会收到一条消息。前提是你已经有一个可用的 ntfy 服务公共实例 ntfy.sh 或自托管服务器和正在运行的 Uptime Kuma并已选好监控项。在 Uptime Kuma 中配置 ntfy 通知类型按 Uptime Kuma 示例 中的说明操作步骤全部在 Uptime Kuma 的 Web 界面里完成打开 Uptime Kuma 的Settings Notifications点击Setup Notification选择 ntfy 通知类型填写以下四个字段字段填什么title通知标题例如Uptime Kumantfy topic你选定的 ntfy topic 名称。这个名称必须和你后续订阅用的 topic 完全一致Server URL你的 ntfy 服务器地址例如公共实例ntfy.sh的地址或自托管服务器地址priority (1-5)消息优先级取值 1 到 5含义见下文topic 是整个链路中唯一的“汇合点”Uptime Kuma 往这个 topic 发消息你在任何客户端订阅同一个 topic 就能收到。自托管 ntfy 服务器时Server URL 应指向你自己的服务器而不是公共实例。测试通知并验证接收配置保存后文档给出的下一步是测试通知test the notifications然后再把该通知应用到监控项apply them to monitors。在点击测试之前先在订阅端打开同一个 topic方便立刻确认消息是否到达。方式一Web 应用订阅。打开 ntfy Web 应用公共实例为ntfy.sh/app输入 topic 名称并点击Subscribe。订阅成功后发到该 topic 的消息会显示在页面中并弹出通知。注意如果没有开启后台通知在 Settings 页可选项需要保持 ntfy 标签页处于打开状态才能收到通知。方式二ntfy CLI 订阅。如果机器上装了 ntfy 客户端可以直接订阅 topic它会把每条消息以 JSON 逐行打印出来ntfy subscribe uptime-kuma把uptime-kuma替换成你在 Uptime Kuma 里配置的那个 topic 名。文档示例输出如下文档示例你的消息内容会不同{id:nZ8PjH5oox,time:1639971913,event:message,topic:mytopic,message:hi there} {id:sekSLWTujn,time:1639972063,event:message,topic:mytopic,priority:5,message:Oh no!}注意ntfy subscribe会一直保持连接除非传--poll测试完按 CtrlC 退出即可。方式三curl 订阅 JSON 流。不装 CLI 时可以直接对topic/json端点发起 GET 请求效果与上面相同curl -s ntfy.sh/uptime-kuma/json文档示例输出文档示例{id:SLiKI64DOt,time:1635528757,event:open,topic:mytopic} {id:hwQ2YpKdmg,time:1635528741,event:message,topic:mytopic,message:Disk full} {id:DGUDShMCsc,time:1635528787,event:keepalive,topic:mytopic}把域名换成你的服务器地址。看到event: message的行就说明 Uptime Kuma 的测试通知已成功进入 ntfy。应用通知到监控项并确认告警测试通知确认后把这个 ntfy 通知绑定到具体的监控项上。文档示例配了手机端截图展示监控项状态变为 down 和恢复 up 时手机收到的告警通知uptimekuma-ios-down.jpg、uptimekuma-ios-up.jpg。此后监控项每次宕机或恢复Uptime Kuma 都会按你配置的 priority 往该 topic 推送一条消息。priority 参数与通知行为Uptime Kuma 里填的 1–5 对应 ntfy 的消息优先级发布文档中的定义如下优先级ID名称行为Max priority5max/urgent超长震动默认提示音加悬浮通知High priority4high长震动默认提示音加悬浮通知Default priority3default默认震动和提示音Low priority2low无震动和声音下拉通知栏才可见Min priority1min无震动和声音折叠在“其他通知”里优先级通过X-Priority头别名Priority、prio、p传递Uptime Kuma 的 ntfy 通知类型就是在内部替你完成这一步。限制与注意事项examples 文档开头说明其中很多示例由社区用户贡献作者不保证所有示例都经过亲自验证。如果按上述步骤测试通知没有到达先确认 topic 名称两端一致、Server URL 可访问。ntfy subscribe不带--poll时连接不会自动关闭属于预期行为。Web 应用的后台通知依赖浏览器支持浏览器未运行时仅 SafarimacOS 13 Ventura Safari 16.1、Android 上的 Chrome/Firefox 支持弹出通知其余情况需要保持标签页打开详见 Web 订阅文档。如果需要长期在服务器上接收告警可以用ntfy subscribe或 systemd 服务常驻订阅参见 CLI 订阅文档 中的ntfy-client服务说明但本文的验证场景只需临时订阅即可。【免费下载链接】ntfySend push notifications to your phone or desktop using PUT/POST项目地址: https://gitcode.com/GitHub_Trending/nt/ntfy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考