首页
/
工具
/
自托管 Web Push Cloudflare Worker,支持 iOS
自托管 Web Push Cloudflare Worker,支持 iOS
摘要
Kukuroo 是一个用于 Cloudflare 的自托管 Web Push Worker,通过单个 Worker 和 KV 命名空间即可实现 iOS 推送通知,无需服务器或原生应用。本文介绍了设置、集成和前置条件。
暂无内容
查看缓存全文
缓存时间:
2026/08/14 15:29
# Kukuroo:面向 iOS 的自托管 Web Push Worker
来源:https://kukuroo.cc/
一个归你所有的推送端点,装在一个 Cloudflare Worker 里。
- 需要你处理的提醒,不该被埋在 Telegram 频道、Discord 服务器或电子邮件里。
- 另一种登上锁屏的方式,是发布一个原生应用,而它的唯一任务就是那一行字。
**无需维持服务器。**
一个 Worker 加一个 KV 命名空间。没有什么需要托管、续期或在凌晨 3 点重启的东西。
**中间没有公司。**
你的密钥留在自己的 Worker 中,载荷面向设备加密。没有任何厂商后台能看到你的提醒。
**无需开发应用。**
iOS 自 18.4 起就已原生支持这些通知。没有 App Store,也不必为了锁屏上的几个字每年付 99 美元。
## 几秒内发送一条推送通知
从你留在后台运行的程序那里,在它完成或停下来提问的那一刻触发。从 cron、CI、Raspberry Pi、你的后端、一个 shell 别名都可以。**任何能发起 HTTP 调用的东西,都能让你的手机响起来。**
```bash
$ curl -X POST https://push.example.com/push/send \
-H "authorization: Bearer $KUKUROO_SEND_TOKEN" \
-d '{"notification":{"title":"Task W13 finished",
"body":"W14 is unblocked and ready to start",
"navigate":"https://push.example.com/"}}'
{"delivered":1,"removed":0,"failures":[]}
```
## 一键集成
设置过程不到一分钟。一条命令即可写入 Worker、生成全部密钥、安装配置、准备存储并完成部署。
```bash
$ npx kukuroo init my-push
```
就这样。你现在拥有一台属于自己的推送服务器。在 iPhone 的 Safari 中打开打印出的 URL,添加到主屏幕,再从图标打开。这是苹果的规定,每台设备只需一次。
## 已经有一个 Worker 在运行你的网站?
那 Kukuroo 会挂载到你已有的路由中,而不是再要一个独立的 Worker。设备在你的域名上完成注册,而点击通知时也应该落到这里。
分步挂载指南 → (https://github.com/saiday/kukuroo#mounting-it-in-a-worker-you-already-run)
## 前提条件
Kukuroo 只支持一个很短的清单,这是有意为之:
- **Cloudflare Workers。** 这是它唯一的运行环境。没有 Docker 镜像,没有二进制文件,也没有其他托管平台。
- **Safari。** 声明式 Web Push 目前还未在任何其他浏览器中推出。其他浏览器会在注册页面就被拒之门外,而不是留下半残的功能。
- **iOS 18.4 或更高版本**,并且页面要添加到主屏幕、从图标打开。单放在 Safari 标签页里不行,这是苹果的规定,不是我们的。macOS Safari 18.5 也能接收推送,如果你能想到想要它的理由的话。
- **一个 Cloudflare
相似文章
Hacker News Top
ntfy 是一个开源服务,允许开发者通过简单的 PUT/POST HTTP 请求向手机或桌面设备发送推送通知,并提供自托管和付费方案。
X AI KOLs Timeline
Yohei Nakajima 介绍了 Remoko,一个移动端智能体中继,可让长期运行的智能体通过 MCP 发送 iOS 推送通知,用于提问、审批和签到,并提供 TestFlight 测试版。
X AI KOLs Timeline
介绍 ntfy:一个极简的开源 HTTP 消息推送工具,通过一行 curl 命令即可向手机/桌面发送通知,支持全平台、免注册、自托管。
Lobsters Hottest
一个自托管的AI新闻聚合器,使用Cloudflare Workers、Vectorize、D1和Nostr抓取Hacker News、Lobsters和Reddit等来源,生成AI嵌入向量,并根据点赞历史提供个性化信息流。
Lobsters Hottest
celld is a self-hosted, distributed server that runs Cloudflare Workers and Durable Objects code unchanged, using your own S3 bucket for storage and coordination. It claims significantly lower costs and sub-millisecond warm latencies at scale, with data stored in SQLite/LTX format.