ntfy 推送通知工具指南

一、工具简介

ntfy 是一款开源的 HTTP 推送通知服务，使用 Go 编写，单二进制发布，采用 Apache-2.0 协议。

核心目标： 解决脚本、训练、爬虫等长时间任务完成后，无法及时获知结果的问题。

核心特点：

• 一行 curl 命令即可发送通知
• 公共服务器 ntfy.sh 免费使用，无需注册、无需 API Key
• 手机端 App（Android / iOS，均开源）订阅同一 Topic 即可接收
• Topic 名称即权限凭证，务必使用足够复杂、难以猜测的名称

---

二、基础用法示例

发送简单文本通知

curl -d "备份完成了" ntfy.sh/mytopic-secret123

带标题、优先级、标签的通知

curl -H "Title: 构建失败" \
     -H "Priority: urgent" \
     -H "Tags: warning,skull" \
     -d "第 3 步测试挂了" \
     ntfy.sh/mytopic-secret123

推送文件（如日志、截图）

curl -T error.log \
     -H "Filename: error.log" \
     ntfy.sh/mytopic-secret123

---

三、适用人群与注意事项

推荐使用

• 经常写脚本做自动化任务的开发者
• 需要轻量级运维报警的运维人员
• 自托管玩家，希望自建私有推送通道

谨慎使用

• 仅需简单 IM 转发的轻度用户（微信群发可能更顺手）
• 介意数据经过第三方服务器、又不愿自建服务的用户

重要提醒

• iOS 用户注意： 使用公共服务器时，后台推送可能存在延迟；如需稳定推送，建议自建服务并配置推送证书（比 Android 复杂）。
• Android 用户体验更顺畅，推荐优先使用。

---

四、快速上手步骤

方式一：零安装体验（5 分钟）

1. 构思一个复杂难猜的 Topic 名称

2. 终端执行：

   curl -d "hello from terminal" ntfy.sh/你的topic名

3. 手机安装 ntfy App 并订阅相同 Topic

方式二：完整体验（20–30 分钟）

1. Android： Google Play / F-Droid 搜索 ntfy
2. iOS： App Store 搜索 ntfy
3. 打开 App → 订阅 → 输入 Topic 名称

方式三：自托管（可选）

适合对数据隐私有要求的用户：

docker run -p 80:80 -it binwiederhier/ntfy serve

详细文档：https://docs.ntfy.sh/install/

---

五、项目信息

项目字段	内容
项目名称	ntfy
GitHub	https://github.com/binwiederhier/ntfy
官网	https://ntfy.sh
Star 数	~3.2 万（截至 2026-07-14）
开源协议	Apache-2.0

---

六、一句话评价

ntfy 将「被通知」从 IM 中解耦，封装成可编程的 HTTP 接口，是自动化工具链中极其轻量、实用的一块拼图。