kyeooeyk/abnotify-server

Abnotify

Abnotify是一款极简、纯净、安全的跨平台即时通知推送工具，兼容Bark协议，支持iOS（APNs）和Android（WebSocket）双平台推送，采用创新保活机制确保Android系统下稳定运行。

致谢

本项目基于以下优秀开源项目开发：

• **https://github.com/trah01/Accnotify**%EF%BC%9AFork%E8%87%AA%E8%AF%A5%E9%A1%B9%E7%9B%AE%EF%BC%8C%E4%BF%9D%E7%95%99Android%E5%AE%A2%E6%88%B7%E7%AB%AF%E3%80%81WebSocket%E6%8E%A8%E9%80%81%E5%8F%8A%E7%AB%AF%E5%88%B0%E7%AB%AF%E5%8A%A0%E5%AF%86%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E3%80%82
• **https://github.com/finb/bark**%EF%BC%9AiOS%E6%8E%A8%E9%80%81%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%9C%AC%E9%A1%B9%E7%9B%AEiOS%E6%8E%A8%E9%80%81%E5%8A%9F%E8%83%BD%E5%9F%BA%E4%BA%8E%E5%85%B6%E5%8D%8F%E8%AE%AE%E5%AE%9E%E7%8E%B0%E3%80%82
• **https://github.com/sylingd/bark-worker-server**%EF%BC%9A%E8%BE%B9%E7%BC%98%E5%87%BD%E6%95%B0%E7%89%88Bark%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E6%9C%AC%E9%A1%B9%E7%9B%AE%E6%9C%8D%E5%8A%A1%E7%AB%AFAPNs%E5%AE%9E%E7%8E%B0%E5%8F%82%E8%80%83%E8%AF%A5%E9%A1%B9%E7%9B%AE%E3%80%82 感谢所有开发者的开源贡献！

核心特性

• 双平台支持：iOS通过APNs推送，Android通过WebSocket推送。
• Bark兼容：支持标准Bark推送接口，可直接使用现有推送脚本。
• 加密传输：Android端采用RSA+AES加密，保护推送内容隐私。
• 超强保活：利用Android辅助功能作为保活锚点，配合独立进程守护。
• Webhook支持：兼容GitHub、GitLab、Docker Hub、Gitea等Webhook通知。
• 离线存储：支持推送历史记录，方便查阅。

快速开始

1. 部署服务器

Docker部署

bash
cd server
docker-compose up -d

手动构建

bash
cd server
go mod download
go build -o abnotify-server
./abnotify-server

2. 安装客户端

Android：

1. 下载并安装Abnotify APK；
2. 打开应用输入服务器地址；
3. 开启保活设置中的辅助功能和自启动权限；
4. 复制推送地址即可使用。

iOS：

1. 在App Store下载Bark客户端；
2. 将服务器地址填入Bark设置；
3. 使用Bark推送到服务器。

推送示例

基本推送

bash
curl -X POST "http://your-server:8080/push/your-device-key" \
     -H "Content-Type: application/json" \
     -d '{"title":"Hello","body":"这是一条来自Abnotify的消息"}'

Bark兼容格式

bash
# GET请求
curl "http://your-server:8080/DEVICE_KEY/标题/内容"

# 带图片
curl "http://your-server:8080/DEVICE_KEY/标题/内容?image=https://example.com/image.jpg"

# 带角标
curl "http://your-server:8080/DEVICE_KEY/标题/内容?badge=1"

环境变量配置

保活说明

为确保Android客户端后台稳定运行，请完成以下设置：

1. 开启Abnotify辅助功能服务；
2. 将Abnotify加入电池优化白名单；
3. 允许Abnotify开机自启动（部分ROM需设置）；
4. 允许Abnotify后台活动（如MIUI/HyperOS）；
5. 授予Abnotify通知权限。

项目结构

Abnotify/
├── app/                  # Android客户端
│   ├── src/main/
│   │   ├── java/        # Kotlin源码
│   │   └── res/         # 资源文件
│   └── build.gradle.kts
└── server/              # Go服务器
    ├── handler/         # 请求处理器
    ├── apns/           # APNs客户端
    ├── model/          # 数据模型
    ├── storage/        # 数据库存储
    └── main.go         # 服务器入口

相关链接

• GitHub仓库：https://github.com/kyeo-hub/Abnotify
• 问题反馈：https://github.com/kyeo-hub/Abnotify/issues

许可证

本项目继承原项目开源许可证。