Bark 使用指南:如何自建 iOS 消息推送服务

文章首发于个人公号:「阿拉平平」

之前我写过一个脚本,校验 SSL 证书是否过期并定时将结果以邮件的形式告知。事实上,这些消息并不是那么重要,发送邮件未免有些「重」了,将结果直接推送到自己的手机上可能更加合适。于是我找到了这款开源的消息推送服务:Bark。

项目介绍

Bark[1] 是一款开源的消息推送服务,用于给 iPhone 发送自定义的内容,支持文字和链接。通过部署 Bark 服务端,我们可以安全地推送一些敏感信息。

下载安装

Bark 分为客户端和服务端。其中,客户端用于接收消息;服务端用于推送消息。

客户端

Bark 客户端仅支持 iOS 平台,可以到 App Store 搜索并下载。

第一次使用会要求「注册设备」,点击后会为设备随机生成一个 Key:

作者提供了服务端,运行以上链接就可以测试消息推送:

服务端

如果是隐私信息,最好还是通过自建 Bark 服务端[2]来推送。接下来,我们尝试部署下服务端。

服务端的部署支持 docker 和 docker-compose,不过本身并不复杂,所以这里我选用手动方式来安装:

# Bark 服务端支持多平台,根据系统下载二进制文件
wget https://github.com/Finb/bark-server/releases/download/v2.0.1/bark-server_linux_amd64

# 添加可执行权限
chmod +x bark-server_linux_amd64

# 创建数据目录
mkidr bark-data

# 运行服务
./bark-server_linux_amd64 -addr 0.0.0.0:8080 -data ./bark-data

至此,服务端部署完成,可以运行以下命令测试服务端是否正常:

curl http://0.0.0.0:8080/ping
{"code":200,"message":"pong","timestamp":1621936667}

使用说明

在上一章中,我们安装了客户端,也自建了服务端。但是别忘了,我们还没将两者关联起来。

添加服务器

回到 App,点击右上角的「+」进入添加私有服务器页面,填写服务器地址:

注意服务器的协议和端口,填好后点击右上角图标确认。如果服务器校验失败,则无法保存。

请求参数

之前我们只是简单地测试了客户端接受消息,现在我们发送些带参数的请求,来看看 Bark 还支持哪些功能。

  • 带有标题的消息

通过在 URL 路径上增加一个 title 来实现,形如:

/:key/:title/:body
  • 自动复制推送内容

自动复制功能适用于验证码推送的场景,参数如下:

  • automaticallyCopy:自动复制的开关,默认关闭。1:开启,其它值:关闭。
  • copy:指定自动复制的内容,不指定则复制所有 body 的内容。

比如发送以下请求会自动复制 9527,无需手动复制:

https://api.day.app/yourkey/验证码是9527?automaticallyCopy=1&copy=9527
  • URL 跳转

通过指定参数 url,点击推送将跳转到相应的网址,比如:

# 发送时,URL 参数需要编码
https://api.day.app/yourkey/百度网址?url=https://www.baidu.com
  • 保存历史记录

一些推送,我们可以阅后即焚,另一些则可以选择保存。保存与否通过 isArchive 来控制:

isArchive:1:保存,其他值:不保存。

要说明的是,如果不指定参数,是否保存则取决于 App 内的设置。相较于 App,参数具有更高的优先级,所以对于确认需要保存记录的消息,可以这样发送请求:

https://api.day.app/yourkey/需要保存的推送?isArchive=1

写在最后

Bark 作为一套开源的消息推送应用,通过自建服务端,可以提供非常及时、稳定可靠、隐私安全的推送服务。Bark 提供 http 接口,只需发送请求即可给自己的 iPhone 推送自定义的消息。

当然,Bark 的功能很简单,推送的消息也有一定的局限性,目前并不支持图片、表情等。结合 Bark 使用的场景,我猜测这可能和作者设计初衷有关,Bark 目的在于替换传统通知方式,保持简单实用就好。

References

[1] Bark: https://github.com/Finb/Bark
[2] Bark 服务端: https://github.com/Finb/bark-server

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,919评论 6 502
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,567评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,316评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,294评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,318评论 6 390
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,245评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,120评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,964评论 0 275
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,376评论 1 313
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,592评论 2 333
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,764评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,460评论 5 344
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,070评论 3 327
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,697评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,846评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,819评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,665评论 2 354

推荐阅读更多精彩内容