线报酷线报酷
文档首页 / 用户中心设置 / ntfy 推送教程

ntfy 推送教程

2026-10-13 …

ntfy 是一个极简的开源推送服务:手机装 App 订阅一个「主题名」,任何程序向 https://ntfy.sh/主题名 POST 一段文本,手机就收到通知。它既可以用官方公共服务器 ntfy.sh,也可以自建。

适用人群

  • 想要一个「极简、跨平台」通知通道的用户(iOS / Android / 桌面端都有 App);
  • 已自建 ntfy 实例的用户;
  • 不想再装一个专用推送 App 的用户。

第一步:手机装 App 并订阅主题

  1. 手机应用商店搜索 ntfy 安装(iOS App Store / Google Play / F-Droid 均有,界面支持中文);
  2. 打开 App → 「+」订阅新主题 → 想一个别人猜不到的主题名,例如 xianbaoku-a1b2c3;
  3. 订阅完成后,这个主题就能收到消息了。
⚠️ 公共服务器 ntfy.sh 上,任何人知道主题名就能收到消息、也能往该主题发消息。请务必使用足够随机、不可猜测的主题名(不要用 xianbaoku 这类明显词汇)。

第二步(可选):自建 ntfy

如果你在意隐私,可以自建:

docker run -d --name ntfy -p 2586:80 binwiederhier/ntfy serve

自建实例地址形如 http://192.168.1.10:2586;若开启了访问控制,还需要在设置里生成访问 Token(tk_ 开头)。

第三步:本站填写

  1. 推送渠道 → 「新增推送渠道」→ 类型选「ntfy(自建/官方)」;
  2. 服务地址填 https://ntfy.sh 或你自建实例的地址;
  3. 主题名填第一步订阅的那个;
  4. 保存 → 到「推送工作台」点【测试】→ 手机收到通知即成功。
字段必填说明
服务地址✅https://ntfy.sh 或 http://192.168.1.10:2586
主题名✅App 里订阅的那个主题(注意保密)
访问 Token—实例开了访问控制才填,格式 tk_xxx

推送方式

本渠道按「🖥️ 浏览器挂机」模式直发,因为要照顾自建内网实例的场景(本站服务器访问不到你的内网)。

  • 填 https://ntfy.sh(官方):挂机与云端效果相同,走挂机还能省额度;
  • 填自建内网地址:服务器够不着,只能挂机——这正是本渠道固定挂机的原因。

挂机需要保持「推送工作台」页面开着;不占云端额度、不计费。

常见问题

官方 ntfy.sh 国内访问不稳定?

确实如此。若你在国内且对稳定性有要求,建议自建实例;或改用 PushMe、Bark 等国内友好的推送。

提示 403 / 主题受保护?

该主题(或整个服务)开启了访问控制,需要在「访问 Token」里填入 tk_ 开头的 Token。

标题显示乱码?

中文标题已按 RFC 2047 编码下发,客户端会自动还原;若你的客户端较旧可能显示原文编码串,建议更新 App。

主题名填错了会怎样?

消息会发到一个没人订阅的主题上,静默丢失(不会报错),请仔细核对。

最近更新

  • 2026-10:新增 ntfy 渠道(挂机型,支持官方与自建实例)。