Hermes Agent 配了 ntfy 但手机收不到通知,先查 topic URL、网关是否运行、任务是否真的触发了 send_message。v0.15.0 把 ntfy 加为消息平台,优点是不用注册账号、用一个 topic 就能推送,但也正因为简单,topic 写错或网关没起来时很容易看不出问题。
先确认是不是 Hermes 发出了消息
不要一开始就怀疑 ntfy 服务坏了。先看 Hermes gateway 日志,确认 cron、Kanban 完成事件或对话里的 send_message 是否被调用。如果 Hermes 根本没有发消息,问题在任务触发;如果已经发出但 ntfy 没收到,再查 topic、网络和服务端。
最短排查路径
- 在浏览器或命令行直接访问你的 ntfy topic,确认 topic 存在且客户端订阅的是同一个。
- 确认
hermes gateway正在运行,尤其是服务器重启后服务是否自动拉起。 - 检查配置里 ntfy 的 server URL、topic 名称有没有多余空格或错别字。
- 如果是自托管 ntfy,检查反向代理、HTTPS 证书和防火墙。
很多收不到通知的情况,都是“手机订阅了 A topic,Hermes 发到 B topic”。topic 没有账号体系帮你兜底,名字必须完全一致。团队使用时最好约定命名规则,不要每个人临时建一个看起来差不多的 topic。
适合什么场景
ntfy 很适合个人服务器、家用自动化、Kanban 任务完成提醒和 cron 结果通知;不太适合作为强审计、强权限的企业消息系统。它解决的是“尽快把结果推到我手机上”,不是替代 Slack、企业微信或完整工单系统。