简介

基于 HTTP 的消息推送接口，适用于通知提醒、日志回调等场景。支持 iOS 客户端接收通知。

服务器地址

https://v.mockchat.cn

URL 结构

/:key/:body
/:key/:title/:body
/:key/:title/:subtitle/:body
        

• key：设备唯一标识
• title：通知标题
• subtitle：副标题
• body：内容（支持 \n 换行）

示例

https://v.mockchat.cn/your_key/Hello/World

POST 推送

POST /your_key
Content-Type: application/json
{
  "title": "Hello",
  "body": "World"
}
        

---

功能参数

url（点击跳转）

?url=https://example.com

group（分组）

?group=test

icon（图标）

?icon=https://example.com/icon.png

sound（铃声）

?sound=alarm

call（持续提醒）

?call=1

ciphertext（加密内容）

?ciphertext=xxx

---

通知级别

?level=timeSensitive

• active 默认
• timeSensitive 时效通知
• passive 静默

?level=critical

重要通知会忽略静音模式。

---

Bark 服务端部署详解

Bark 是一个开源的 iOS 推送通知工具，支持通过 HTTP 接口向指定设备发送通知。

1. Docker 一键部署（最推荐）

docker run -dt \
  --name bark \
  --restart=always \
  -p 8080:8080 \
  -v $(pwd)/bark-data:/data \
  finab/bark-server
        

2. 使用 GHCR 镜像（更新更快）

docker run -dt \
  --name bark \
  --restart=always \
  -p 8080:8080 \
  -v $(pwd)/bark-data:/data \
  ghcr.io/finb/bark-server
        

3. docker-compose 部署

mkdir bark-server && cd bark-server
curl -sL https://raw.githubusercontent.com/Finb/bark-server/master/deploy/docker-compose.yaml > docker-compose.yaml
docker compose up -d
        

4. 二进制直接运行

chmod +x bark-server
./bark-server --addr 0.0.0.0:8080 --data ./bark-data
        

5. 使用 MySQL 数据库（高并发推荐）

./bark-server -dsn=user:pass@tcp(host:3306)/bark
        

使用 MySQL 可显著提升并发性能，适合设备数量较多或推送频繁的场景。

测试服务

curl http://localhost:8080/ping

返回 pong 表示服务运行正常。

部署注意事项

• 默认数据目录为 /data，请确保目录有读写权限
• 生产环境建议通过 Nginx 或 Caddy 配置反向代理并开启 HTTPS
• 推荐使用域名访问
• 定期备份 bark-data 目录

---

iOS 客户端配置

1. 打开 Bark 客户端
2. 复制设备 Key
3. 填写服务器地址：v.mockchat.cn
4. 保存后测试推送

---

开发者编译

Golang 1.18+
GO111MODULE=on
GOPROXY=https://goproxy.cn
        

task
task linux_amd64