Bark通知推送工具
date
Sep 10, 2025 08:41 AM
slug
bark-server
summary
一款注重隐私、安全可控的自定义通知推送工具。
status
Published
type
Post
tags
Docker
Bark 一款注重隐私、安全可控的自定义通知推送工具。
- 免费、轻量！简单调用接口即可给自己的iPhone发送推送。
- 依赖苹果APNs，及时、稳定、可靠
- 不会消耗设备的电量， 基于系统推送服务与推送扩展，APP本体并不需要运行。
- 隐私安全，可以通过一些方式确保包含作者本人在内的所有人都无法窃取你的隐私。
一、项目源码
1.1 客户端源码
- Bark 是完整开源的 iOS APP，用来接收自定义推送。
1.2 服务端源码
- bark-server 是完整开源的 Bark 服务后端，用来接收用户的推送请求并转发给苹果APNS。
二、服务端部署
2.1 Docker方式部署
2.2 Docker-Compose方式部署
2.3 手动方式部署
2.3.1 根据平台下载可执行文件:
2.3.2 运行：
2.3.3 你可能需要：
请注意 bark-server 默认使用 /data 目录保存数据，请确保 bark-server 有权限读写 /data 目录，或者你可以使用
-data 选项指定一个目录2.4 Cloudflare Worker方式部署
三、使用教程
3.1 发送推送
3.1.1 打开APP，复制测试URL
修改内容，请求这个URL。可以发 GET 或者 POST 请求 ，请求成功会立即收到推送
3.2 URL格式
URL由推送key、参数 title、参数 subtitle、参数 body 组成。有下面三种组合方式
3.3 请求方式
3.3.1 GET 请求参数拼接在 URL 后面，例如：
手动拼接参数到URL上时，请注意URL编码问题，可以参考阅读常见问题：URL编码
3.3.2 POST 请求参数放在请求体中，例如：
3.3.3 POST 请求支持JSON，例如：
支持的参数列表，具体效果可在 APP 内预览。
参数 | 说明 | 参数 |
title | 推送标题 | /标题 |
body | 推送内容 | /内容 |
level | 推送中断级别。 active：默认值，系统会立即亮屏显示通知timeSensitive：时效性通知，可在专注状态下显示通知。passive：仅将通知添加到通知列表，不会亮屏提醒。 | ?level=passive |
badge | 推送角标，可以是任意数字 | ?badge=1 |
autoCopy | iOS14.5 以下自动复制推送内容，iOS14.5 以上需手动长按推送或下拉推送 | ㅤ |
copy | 复制推送时，指定复制的内容，不传此参数将复制整个推送内容。 | ?copy=test |
sound | 可以为推送设置不同的铃声 | ㅤ |
icon | 为推送设置自定义图标，设置的图标将替换默认 Bark 图标。图标会自动缓存在本机，相同的图标 URL 仅下载一次。 | ?icon=xxx.jpg |
group | 对消息进行分组，推送将按 group 分组显示在通知中心中。也可在历史消息列表中选择查看不同的群组。 | ?group=Server |
isArchive | 传 1 保存推送，传其他的不保存推送，不传按 APP 内设置来决定是否保存。 | ㅤ |
url | 点击推送时，跳转的 URL ，支持 URL Scheme 和 Universal Link | ?url=https:// |
直接推送内容
带标题 + 内容
设置铃声
自动保存消息
设置图标
设置群组