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