PushMe - Android 消息通知客户端

简单 · 轻量 · 支持插件 · 可自部署

---

📱 项目简介

PushMe 是一款专为 Android 设计的轻量级消息通知客户端，帮助你及时接收各类推送消息。

✨ 核心特性

• 🔌 插件功能：支持消息插件，消息灵活二次处理
• 🏠 自部署服务：支持私有化部署，数据完全掌控
• ⚡ 轻量高效：资源占用低，后台运行稳定
• 📲 广泛兼容：支持 Android 7.0 及以上版本
• 🔔 状态监控：提供 StateChannel 通道，实时查看服务在线状态

---

🏗️ 系统架构

graph TB
    USER["👤 用户<br/>Web 请求"]

    subgraph 远程服务
        OFFICIAL["🌐 官方服务<br/>官方 API"]
        SELFHOST["🏠 自建服务<br/>自建 API"]
    end

    subgraph 局域网
        APP["📱 Android App<br/>内置 API · 转发服务"]
        WIN1["💻 Windows 客户端<br/>内置 API · 转发服务"]
        WIN2["💻 Windows 客户端<br/>内置 API · 转发服务"]
    end

    USER -->|"HTTP 请求"| OFFICIAL
    USER -->|"HTTP 请求"| SELFHOST
    USER -->|"局域网直接请求"| APP
    USER -->|"局域网直接请求"| WIN1

    APP -->|"转发消息"| WIN1
    WIN1 -->|"转发消息"| WIN2

    APP -.-|"TCP / WebSocket"| OFFICIAL
    APP -.-|"TCP / WebSocket"| SELFHOST
    WIN1 -.-|"WebSocket"| SELFHOST

    style USER fill:#e74c3c,stroke:#333,color:#fff
    style OFFICIAL fill:#4a90d9,stroke:#333,color:#fff
    style SELFHOST fill:#7b68ee,stroke:#333,color:#fff
    style APP fill:#50c878,stroke:#333,color:#fff
    style WIN1 fill:#ff8c00,stroke:#333,color:#fff
    style WIN2 fill:#ff8c00,stroke:#333,color:#fff

Loading

🔗 统一 API 接口：官方服务、自建服务、App API、Windows API 接口规范完全一致

📡 消息路径：

• 用户发起：用户通过 Web 请求官方 API、自建服务 API，或局域网直接请求 App/Win API
• 远程推送：消息通过 App 与官方服务/自建服务的 TCP/WebSocket 连接传输至手机
• 局域网直达：通过局域网 IP 直接调用 App API 或 Win API，消息直达设备
• 消息转发：手机可将消息转发至局域网内的 Windows 客户端
• 链式转发：Windows 客户端之间可互相转发消息
• 后台连接：App 与官方服务/自建服务保持 TCP/WebSocket 长连接；Windows 客户端可连接自建服务（WebSocket）

---

🖼️ 应用预览

---

📥 下载安装

系统要求

• Android 版本：7.0 及以上

下载渠道

平台	下载地址
GitHub	点击下载最新版本
Gitee（国内）	点击下载最新版本

---

🔧 接口文档

详细的 API 接口参数说明，请访问官方网站：

👉 https://push.i-i.me/

---

⚙️ 手机权限设置指南

⚠️ 重要提示：由于 Android 系统对后台应用的严格管理，为确保消息能及时送达，请按照以下步骤配置应用权限。

快速设置

在 PushMe 应用中，进入 权限设置 页面，可快速跳转至相关设置项。

详细配置步骤

1️⃣ 基础权限配置

• ✅ 自启动权限：允许应用开机自启
• ✅ 后台运行权限：允许应用在后台持续运行
• ✅ 通知权限：允许发送和显示通知
• ✅ 电池优化豁免：设置为"允许后台高耗电"（实际功耗很低）

2️⃣ 系统特定配置

Android 12 用户

• 🔔 必须开启 闹钟（Alarm）权限

多任务锁定（推荐）

• 📌 在多任务页面长按 PushMe，选择"锁定"或点击锁图标
• 锁定后可安全清理其他后台应用

网络优化设置

• 🌐 部分机型需关闭"后台网络优化"或"智能网络加速"
• 防止系统在息屏后切断网络连接

---

📱 各品牌系统适配说明

🟢 Vivo - OriginOS 3

问题：睡眠模式会导致后台被杀

解决方案：

设置 → 电池管理 → 更多设置 → 睡眠模式 → 关闭

注意事项：

• ⚠️ 关闭睡眠模式后，夜间其他应用（如微信、今日头条）可能会增加耗电
• 建议权衡消息及时性与电量消耗

---

🟢 Xiaomi - MIUI 14

解决方案：

1. 打开多任务页面
2. 长按 PushMe 应用卡片
3. 点击"锁定"按钮（锁图标）
4. 锁定后即可正常清理其他应用

---

🔴 Huawei - HarmonyOS 2

现状：经实测，HarmonyOS 2 无法保证应用稳定后台运行

建议：

• 尝试上述所有权限设置
• 如仍无法解决，可能需要考虑升级系统或使用其他设备

---

📋 其他系统

其他品牌系统暂未进行详细测试，欢迎反馈遇到的问题。

通用建议：

1. 给予应用最大权限（自启动、后台运行、通知）
2. 关闭电池优化
3. 在多任务页面锁定应用
4. 关闭后台网络优化

---

💡 使用技巧

保持服务在线的最佳实践

1. 完成上述权限设置

2. 开启 StateChannel 通知

   • 位置：PushMe 左上角设置菜单
   • 作用：实时监控服务连接状态
   • 如不需要可在设置中关闭

3. 清理后台时的正确操作

   • 完成权限设置和多任务锁定后
   • 可以安全地从多任务页面划掉 PushMe
   • 服务会继续在后台运行

---

📞 获取帮助

官方渠道

• 🌐 官方网站：https://push.i-i.me/
• 📢 Telegram 频道：https://t.me/pushme_channel
• 💬 问题反馈：GitHub Issues

常见问题

Q: 为什么收不到消息推送？
A: 请检查是否完成了所有权限设置，特别是电池优化和多任务锁定。

Q: 应用耗电严重吗？
A: 实际测试显示功耗很低，"允许后台高耗电"只是防止系统杀进程的设置，并非真的耗电。

Q: 可以自己部署服务端吗？
A: 可以，PushMe 支持私有化部署，具体方法请参考官网文档。

---

_{Made with ❤️ by yafoo}