接入指南
从一台设备到一条 curl,五分钟接通。也可以先下载 Bark 手机客户端,在手机上查看状态。
它是什么
Bark 中枢是一个自托管的 Web 通知与监控服务:脚本往一个地址 POST,消息就会按你的路由推到 iPhone(Bark)、飞书群机器人或 ntfy。适合开发者、NAS/自建服务和自动化用户做统一接入、可靠通知、可追踪和降噪。
1. 添加设备
- Bark(iPhone):App 里复制的那串设备地址,形如
https://api.day.app/xxxxxx。 - ntfy(Android/桌面):自建或公共 ntfy 的 topic 地址,形如
https://ntfy.example.com/mytopic,可带?auth=tk_xxx访问令牌。 - 飞书群机器人:群设置里添加「自定义机器人」,复制 webhook,可选带
?secret=签名密钥。
保存后会自动试发一条,手机弹出通知就说明接通了。
2. 创建来源
来源是一对一的推送入口,形如 https://你的域名/<长随机key>,兼容 Bark 协议——任何 Bark 客户端/SDK 指到这个地址即可直接使用。可以绑定只推部分设备,不绑就是全部设备。
# 最简
curl https://你的域名/<key> -d "服务器炸了"
# Bark 风格路径
curl -X POST https://你的域名/<key>/标题/正文
# JSON(Server酱 的 desp 字段也认)
curl -X POST https://你的域名/<key> \
-H 'Content-Type: application/json' \
-d '{"title":"备份完成","body":"耗时 3 分钟","group":"nas","level":"timeSensitive"}'
支持的可选参数:title subtitle body group level sound url badge copy isArchive。
3. 监控 / 价格 / 提醒(可选)
- 网页监控:整页变化 / 关键词出现 / JSON 字段,三种模式。说明两点能力边界:靠抓取公开页面,反爬强或需要登录的站点不适用;推送是 at-least-once——第三方渠道没有回执,全失败会自动重试,不承诺 100% 送达。
- 价格盯梢:用正则或 JSON 路径从页面取价格数字,到目标价或创新低时提醒。适合有稳定 API 或结构简单页面的场景,不承诺任意电商都可用。
- 日历提醒:日子/日程/价格三类条目,按北京时间(UTC+8)计算,调度精度为 5 分钟一轮。
4. 历史与排查
每条消息都有记录:状态(已提交 / 部分提交 / 失败)、渠道、每个设备的投递结果。注意「已提交」指渠道服务器已受理——手机是否弹出还取决于它的通知设置与网络,第三方渠道不提供终端回执。
配额与付费
免费档:5 台设备、5 个来源、5 个监控、20 条提醒,入站每来源 60 条/小时。Pro(卡密兑换):各 20 个、入站 240 条/小时。基础安全与隔离能力(加密存储、限流、SSRF 防线、审计)对所有用户一致,不按付费区分。