biubiubiu

开源 · 运行在 Cloudflare 上

从任何地方发出,直达你的手机。

biubiubiu 是一个运行在 Cloudflare Workers 与 D1 上的轻量自托管 Web Push 服务。脚本、定时任务、CI 或 AI 智能体只需发出一个 HTTP 请求,你的手机就会响起。无需维护服务器,也无需安装原生 App。

大约一分钟即可部署完成,免费套餐即可使用。

一行发送

只要能发 HTTP 请求,就能找到你。

简单提醒只需在 URL 中带上设备密钥。JSON API 还支持令牌、设备分组、Markdown、定时推送、端到端加密,以及支持按钮、文字回复和通行密钥确认的提问。Webhook 模板可直接接收 GitHub、Grafana 和 Alertmanager,紧急提醒会一直重复,直到你打开为止。

用设备密钥快速 GET
curl https://push.example.com/<deviceKey>/Backup%20done
用 API 令牌向所有设备发送 JSON
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Deploy","body":"v2.3.1 is live"}'
提出问题并等待回答
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Deploy?","choices":["Ship it","Hold"]}'
紧急:重复推送,直到有人打开
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Prod down","level":"critical","retry":120}'

功能

小巧的服务,该有的都有。

全平台通达

iOS 16.4+(主屏幕网页应用)、Android 以及主流桌面浏览器,无需应用商店。

设备独立密钥

每台设备拥有可吊销的独立密钥;为脚本提供限定权限的 API 令牌;主密钥统一管理。

灵活推送目标

可全员广播、按设备分组推送,或指定具体设备。

消息中心

所有推送均会归档,支持 Markdown 渲染、分类筛选、未读角标和 TTL 过期。

原地更新

复用同一个 id 即可更新已有通知,而不是堆叠新通知,非常适合展示构建进度。

定时推送

用 scheduledAt 将消息加入队列,每分钟运行的 cron 会按时送达。

端到端加密

兼容 Bark 的 AES-CBC 载荷在设备端解密,服务器只能看到密文。

可靠送达

自动重试、清理失效订阅、订阅自愈,以及按设备记录的推送日志。

Webhook 模板

加上 ?template=github,就能让 GitHub、Grafana 或 Alertmanager 直接推送到你的服务器。能发到 Slack、Discord 或 ntfy 的工具也能直接使用。

确认前反复提醒

给 critical 消息加上 retry,它会每隔几分钟再推送一次,直到有人打开。

为 AI 智能体打造

放心离开终端,智能体会叫你。

编程智能体常常在你离开时完成任务、出错或卡住。biubiubiu 让它们能联系到你,也让你能直接回复。

MCP 服务

/mcp 上的 Streamable HTTP 为任意 MCP 客户端提供 send_notification 工具,一条命令即可接入 Claude Code。

ask_human

智能体推送一个带回答按钮或回复框的问题。你一作答,工具调用立刻返回结果;高风险选项可要求先过 Face ID 或 Touch ID。

技能与钩子

Agent Skill 告诉智能体何时该通知你;Claude Code 钩子会在每次停止或请求权限时提醒你。

Claude Code
claude mcp add --transport http biubiubiu \
  https://push.example.com/mcp \
  --header "Authorization: Bearer $BIUBIUBIU_TOKEN"
Agent Skill
npx skills add chada/biubiubiu --skill biubiubiu-notify
配置你的智能体

账户模式

与家人或团队共享一台服务器。

开启账户模式后,每个人都有自己的登录账户,并拥有:

  • 邀请制,由你决定谁能加入
  • 各自的设备和收件箱
  • 供脚本使用的个人发送令牌
  • 通过推送或邮件重置密码

可选功能,默认关闭。需要 Workers 付费套餐;不开启时,biubiubiu 使用一个主密钥在免费套餐上运行。

了解账户模式

应用

放在主屏幕上的收件箱。

带“待你处理”、按天分组和分组筛选的收件箱
智能体的提问,点一下即可回答
Markdown 消息,可按 id 原地更新

开始使用

三步拥有自己的推送服务。

  1. 部署

    按钮会将仓库复制到你的 GitHub 或 GitLab,创建 D1 数据库、执行迁移并部署 Worker。

  2. 设置主密钥

    填写管理员密码 MASTER_KEY(例如 openssl rand -base64 32)。VAPID 密钥会自动生成。

  3. 在手机上打开

    将应用添加到主屏幕,允许通知并复制设备密钥,然后发出你的第一声 biu。

Deploy to Cloudflare

更喜欢命令行?请参阅手动部署。

常见问题

常见问题解答。

还有疑问?在 GitHub 上提问。

biubiubiu 是什么?

biubiubiu 是一个免费、开源的 Web Push 通知服务器,自托管在 Cloudflare Workers 和 D1 上。脚本、cron 任务、CI 流水线或 AI 智能体只需发送一个 HTTP 请求,它就会通过标准 Web Push 协议把通知推送到你的手机、平板或电脑。

需要花钱吗?

biubiubiu 本身免费。它运行在你自己的 Cloudflare 账号上,默认的主密钥模式在 Workers 免费套餐内即可运行。只有可选的账号模式需要 Workers Paid,因为密码哈希所需的 CPU 时间超出了免费套餐的限制。

不装 App 也能在 iPhone 上用吗?

可以。在 iOS 和 iPadOS 16.4 及以上版本,用 Safari 打开你的服务器,添加到主屏幕并允许通知即可。在 Android 和电脑上,Chrome、Edge、Firefox 和 Safari 可直接在浏览器中接收推送。

能替代 Bark 吗?Android 上也行吗?

可以。biubiubiu 沿用 Bark 的 URL 和 JSON API 风格,只需换成你的服务器地址和设备密钥,现有的 Bark 脚本和 iOS 快捷指令就能继续使用,而且同样的消息还能送达 Android 和电脑。少数 Bark 选项(如自定义铃声和重要警报的警报声)无法通过 Web Push 实现,但紧急消息可以反复提醒,直到你打开为止。

Claude Code 等 AI 智能体如何通知我?

把 /mcp 上的 MCP 服务器添加到任意 MCP 客户端(Claude Code 只需一条命令),智能体就能使用 send_notification 工具,以及 ask_human 工具:推送一个带回答按钮或回复框的问题,你一作答就立刻把答案返回给智能体;高风险选项可要求通行密钥(Face ID 或 Touch ID)确认。另附 Agent Skill(用 npx skills add chada/biubiubiu 安装)和 Claude Code 钩子。

和 ntfy、Gotify、Pushover 有什么不同?

Pushover 是付费的托管服务,自托管的 ntfy 或 Gotify 需要一台持续运行的服务器。biubiubiu 以无服务器方式运行在你自己的 Cloudflare 账号上,无需打补丁或保持在线;它通过标准 Web Push 送达,不需要原生 App,并内置面向 AI 智能体的 MCP 服务器。支持 ntfy 的工具把设备密钥作为主题即可直接发布,紧急消息也会像 Pushover 的紧急优先级一样反复提醒,直到被确认。

谁能看到我的通知?

只有你。消息保存在你自己 Cloudflare 账号的 D1 数据库中。开启端到端加密后,内容在发送前加密、在设备上解密,服务器只能看到密文。

开始使用

一个请求,直达你的手机。

大约一分钟部署属于你自己的推送服务。免费、开源,完全由你掌控。