ntfy

备份脚本半夜跑完、文件下载结束、定时任务报错，这些结果通常留在电脑的终端或日志里。 想在手机上收到提醒，可以给脚本加一条 ntfy 消息。 它通过 HTTP PUT 或 POST 接收文字，再把消息送到订阅同一主题的手机或桌面端，适合为已有自动化任务补上通知。

用主题把脚本和手机连起来

ntfy 的基本单位是主题，也就是一段用来区分消息频道的名称。 在 Android、iOS 应用或网页端订阅一个主题后，脚本向对应地址发送消息，订阅端就能接收。 官方入门文档提供了 curl、Python 和 JavaScript 等写法，只要现有工具能够发出 HTTP 请求，就有机会把结果接进来。

例如，可以把备份提醒与下载提醒分成不同主题，避免普通进度消息淹没故障通知。 任务是否成功仍由脚本的退出状态决定；ntfy 负责传递脚本已经生成的结果。

图片来自 ntfy 官方仓库，展示网页端通知与附件界面。

发出第一条提醒只需要一条请求

打开 ntfy 手机应用或网页端，订阅自己选择的主题。 下面是依据官方接口整理的命令示例，运行前需要把 YOUR_PRIVATE_RANDOM_TOPIC 替换成自己的随机主题名，并确认客户端订阅的是同一个名称。

curl --fail \
  -H "Title: Backup finished" \
  -H "Tags: white_check_mark" \
  -d "Backup completed. Check the log for details." \
  https://ntfy.sh/YOUR_PRIVATE_RANDOM_TOPIC

这条命令会向官方公共服务发送一条通知。 发送文档还介绍了优先级、标签、附件和点击链接等字段，可以让失败消息更醒目，也可以让通知直接指向相关页面。 把请求放在脚本的成功或失败分支里，通知文字就能对应实际运行结果。 通知请求本身也可能遇到断网或限流，重要任务需要保留原有日志，并处理 curl 的失败退出状态。

公共主题需要认真处理访问权限

官方入门文档明确提醒，公共服务上的主题名是公开的。 未保护的主题如果被他人知道，就存在消息被读取或被发送无关内容的风险。 试用时使用难以猜到的随机名称，并只发送不敏感的测试信息。 密码、访问令牌、客户资料和完整业务日志应留在受保护的系统中。

需要控制谁能读写时，可以查看服务套餐中的主题保留功能，或在自托管服务器上配置用户、访问令牌和主题权限。 官方访问控制说明给出了相关配置，私有实例可以采用默认拒绝访问的方式，为需要使用的账户单独授权。 随机主题名适合降低被碰巧发现的概率；业务消息的保护还需要明确的访问控制。

自托管要照顾数据和推送链路

ntfy 提供 Docker 等安装方式。 按照官方安装文档，容器可运行 binwiederhier/ntfy 镜像，服务通过 serve 启动。 长期使用需要配置消息缓存的持久化目录，并按需要挂载配置文件；向外提供服务时，还要安排 HTTPS、认证和备份。

手机平台也有配置差异。 官方配置文档说明，自托管实例要在 iOS 上获得即时推送，需要设置上游地址，让上游转发唤醒请求，手机应用随后向自己的服务器读取消息正文。 如果希望完全掌握消息流向，这条链路也应该纳入部署考虑。

桌面端则要检查浏览器通知权限与后台通知设置。 根据网页端说明，关闭后台通知时需要保持 ntfy 标签页打开；开启后仍会受浏览器和系统支持情况影响。 部署完成后，可以用一条普通提醒核对手机锁屏、浏览器后台等实际接收场景。

适合给已有自动化任务补上提醒

ntfy 的公共服务提供免费使用方式，也有付费套餐；免费使用受到服务限额约束，具体配额应查看当前账户方案。 项目提供 Apache-2.0 与 GPLv2 双许可证，自托管的服务器、网络与维护由自己承担。 官方仓库提供源码、客户端入口及套餐说明。

如果已经有 NAS 备份、定时脚本或下载任务，可以从一个低敏感度提醒开始接入。 确定消息内容、权限和接收设备都符合需要后，再扩展到其他任务。 对于需要完整流程编排的工作，ntfy 更适合作为其中的通知环节。

• 打开 ntfy 网页端
• 阅读发送消息文档
• 查看自托管安装方式