ntfy 推送通知服务快速上手3 个落地场景与完整接入指南【免费下载链接】ntfySend push notifications to your phone or desktop using PUT/POST项目地址: https://gitcode.com/GitHub_Trending/nt/ntfy凌晨三点的备份任务挂了但你正在熟睡日志文件躺在服务器上一动不动——这就是 ntfy 要解决的痛点一个基于 HTTP 的轻量级推送通知服务让你用一条curl就能把服务器的消息直接推到手机或桌面。无需注册、无需 API Key主题名就是密码5 分钟内就能跑通第一条通知。项目速览一句话讲清它是什么ntfy 是一个开源的 HTTP 发布/订阅pub-sub通知服务核心就一件事从任意机器向手机、桌面、浏览器推送消息。它和你熟悉的服务总线、短信网关差别很大理解它只需要记住三条规则主题即通道mytopic就是一个虚拟频道任何设备只要知道名字就能订阅消息发出来秒级推送到所有在线订阅者无需预先创建。HTTP 即协议发布通知就是PUT/POST https://host/主题名消息体放请求 bodyTitle、Priority、Tags等元信息放 header所以curl、requests、fetch、PowerShell 全能发。零登录 可自建官方实例 ntfy.sh 免注册直接用代码完全开源Apache 2.0 / GPLv2 双许可想数据不出内网可以一行docker run起一个私有实例。和同类方案比它的差异化在于门槛极低无账号无 SDK 全平台客户端Android/iOS/Web/CLI 可深度自建支持缓存、附件、SMTP 收发、Web Push、Firebase 推送、访问控制。适合运维、SRE、自动化脚本重度用户以及需要事件 → 手机最短链路的所有人。快速上手5 分钟打通第一条通知方式 A直接用官方 ntfy.sh零安装手机上装 ntfy Android 应用iOS 也有对应应用打开 App 输入一个主题名比如my-backups点 Subscribe 完成订阅。之后在任意一台能联网的机器上发一条curl -d 备份成功完成 ntfy.sh/my-backups手机立刻弹出通知。这就是完整链路没有中间件、没有 webhook 配置。方式 B自建私有实例数据不出内网拉取镜像指定缓存目录把 80 端口暴露出去docker run -p 8080:80 \ -v /var/cache/ntfy:/var/cache/ntfy \ -it binwiederhier/ntfy \ serve --cache-file /var/cache/ntfy/cache.db启动后把客户端里的ntfy.sh换成http://你的IP:8080即可。配置项全部写在/etc/ntfy/server.yml包括监听端口、HTTPS 证书、PostgreSQL 数据源、访问控制等官方模板文件 server/server.yml 里每一项都有注释直接拷过来改就行。场景驱动深讲3 个最常见的落地姿势场景一备份 / 定时任务完成提醒什么时候用cron 里跑的备份、rsync、清理脚本跑完或跑挂了没人知道。怎么用把curl直接串在命令后成功和失败各发一条用Priority区分轻重用Tags加图标rsync -a ./ /backup/ \ curl -H Priority: low -d 备份成功 ntfy.sh/my-backups \ || curl -H Priority: high -H Tags: warning -d 备份失败 ntfy.sh/my-backups效果手机通知栏一条黄色感叹号 备份失败长振动提醒比翻日志快 10 倍。场景二服务器安全告警SSH 登录 / 磁盘 / 入侵什么时候用任何发生了就得立刻知道的事件安全审计尤其吃这个。怎么用ntfy 内置了X-Click跳转点击通知直达运维面板配合Priority: 5最高档Tags: rotating_light触发手机长振动。以 SSH 登录为例挂一个 PAM 钩子就能实时收到谁从哪台机器登进来# /usr/bin/ntfy-ssh-login.sh curl -H Priority: high -H Tags: warning \ -d SSH 登录到 $(hostname)${PAM_USER} 来自 ${PAM_RHOST} \ ntfy.sh/alerts参考实现仓库里就带了一个examples/ssh-login-alert/。效果长这样长振动 弹出横幅比邮件快、比短信便宜场景三CI/CD 与 GitHub 事件订阅什么时候用想让 CI 构建状态、GitHub 星数/PR/Issue 动态实时上手机不用打开网页刷新。怎么用GitHub 的 Webhook 原生就能 POST 到 ntfy 主题把 Payload URL 填成https://ntfy.sh/我的主题?templategithubntfy 内置github模板会自动把 JSON 渲染成人类可读的标题和正文不用自己写解析逻辑。类似的Jenkins、Ansible、Grafana、Uptime Kuma、Watchtower、Home Assistant、Node-RED、UptimeRobot、Sonarr 这些工具都能以一行 Webhook 或一行配置的代价接入仓库 examples/ 目录下按语言/工具整理了可直接抄的片段Go / PHP / Python / Bash。避坑与最佳实践主题名就是密码不要起mytopic、test、alert这种名字。官方建议至少 10 位随机字符字母数字下划线或者用发布页面自带的主题名生成器。ntfy.sh 有 fail2ban但自建实例的限流得你自己配。消息体 4KB 会自动变成附件ntfy 默认单条消息上限 4096 字节超长会自动降级为附件3 小时后过期。想发大图/文件用Attach: url或ntfy pub --file 本地文件别硬塞 body。优先级不是重要程度而是打扰程度Priority: 5手机长振动 弹出横幅滥用会让用户关掉通知。日常脚本完成用low不响不震关键告警才用high/max。UTF-8 头在部分语言里会挂Title/Tags用中文没问题但个别 HTTP 库老版本会把非 ASCII 转成?。真出问题就按 RFC 2047 base64 编码一下 header文档里有现成例子。自建实例记得配cache-file不写这个的话服务重启消息全丢客户端重连会拉不到历史。挂个持久卷就行。小结ntfy 的定位很清晰一个用 HTTP 就能驱动的手机/桌面推送通道门槛低、可自建、客户端全、模板丰富特别适合服务器事件 → 我手机这条链路。下一步可以去看官方文档 docs/publish.md 里Attach、Actions按钮、Icon、Email这些进阶字段或者把 server/server.yml 通读一遍把自建实例的访问控制开起来——这两步做完基本就够用到日常运维的绝大多数场景了。主要模块速查服务端入口server/server.go发布 API 实现server/server.go 中的topic相关 handler客户端 CLIcmd/publish/subscribe/serve子命令附件存储attachment/消息缓存message/Web 前端web/src/【免费下载链接】ntfySend push notifications to your phone or desktop using PUT/POST项目地址: https://gitcode.com/GitHub_Trending/nt/ntfy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
