PushMe 使用指南

从下载安装到各项功能设置,带你完整了解 PushMe 的使用方法

快速上手 Push Key 消息设置 服务设置 APP 设置 权限设置 其他设置 发送消息 消息类型 数据小屏 搜索与操作 关于我们 常见问题

快速上手


1

下载安装 APP

前往 下载页面,下载 PushMe APK 文件并安装到安卓手机上。首次打开 APP 即可直接使用,无需登录注册。

2

获取 Push Key

点击左上角 设置图标 打开侧边栏,展开 "push_key" 区域,点击 "获取" 按钮。获取成功后,即可使用接口推送消息到手机。详见 Push Key。

3

发送第一条消息

通过 HTTP 请求向接口发送消息,即可在手机收到通知。你可以直接在 首页在线测试 发送,也可以用代码调用接口。

curl -d "push_key=你的push_key&title=你好&content=这是第一条消息" https://push.i-i.me
4

配置手机权限(重要)

为了保证消息能稳定送达,请务必在侧边栏 → 权限设置 中配置好自启动、电池优化、消息通知等权限。

💡 提示
PushMe 无需登录注册,安装即用。接口兼容企业微信 / 钉钉 / 飞书群机器人,如果你之前使用过这些机器人的 webhook,可以直接替换为 PushMe 接口。

Push Key


侧边栏 → push_key

获取 Push Key获取

push_key 是你接收消息的唯一标识,相当于你的「收件地址」。首次使用时,展开 push_key 区域点击 获取,确认后 APP 会自动向服务器申请一个专属 key。获取成功后,其他人即可通过接口向这个 key 推送消息,消息会实时到达你的手机。

提示:获取前请确保手机网络正常。一个 key 对应一个收件人,不能多台设备共用同一个 key。
更换 Push Key更换

已获取过 key 后,按钮会变为 更换。更换会申请一个全新的 key,旧的 key 随即失效。

注意:更换后,请记得同步修改所有推送接口里使用的 key,否则将收不到消息。

消息设置


侧边栏 → 消息设置,用于调整消息列表的显示与交互方式。

分组消息置顶开启 / 关闭

开启后,带分组的消息会统一置顶显示在列表最上方,方便优先查看重要来源的消息。默认关闭。

无分组消息合并开启 / 关闭

开启后,所有没有分组的消息会被归入一个虚拟分组中合并展示,让消息列表更整洁。默认关闭。

点击分组消息进入分组 / 对话 / 详情

设置点击一条分组消息时进入的页面:

  • 分组:进入该分组下的消息列表
  • 对话:以对话气泡样式查看该分组的历史消息
  • 详情:直接打开这条消息的详情(默认)
列表字体大小滑块 0.5 ~ 1.5

拖动滑块调整消息列表的字体缩放比例,默认 1.0。字体偏小或偏大的用户可以按需调整。

自动加载更多开启 / 关闭

开启后,消息列表滚动到底部时会自动加载更早的历史消息;关闭时需手动点击「加载更多」。默认关闭。

消息内链接打开方式系统 / PushMe

设置消息里链接的打开方式:系统 表示用系统浏览器打开(默认),PushMe 表示在 APP 内置页面中打开。

提示:仅 markdown、html 和 url 消息支持此设置。单条消息中也可通过链接参数单独控制打开方式。
HTML 消息 JS 支持开启 / 禁用

设置是否允许执行 HTML 消息中携带的 JavaScript 脚本。出于安全考虑,默认 禁用;只有在你完全信任消息来源时,才建议开启。

新消息默认状态已读 / 未读

设置新收到的消息默认标记为 未读(默认)还是 已读。默认未读,便于在列表中区分未查看的新消息。

服务设置


侧边栏 → 服务设置,管理消息的接收服务与扩展能力。

接口服务点击「设置」

开启后,手机在局域网内会启动一个本地 HTTP 接口服务,同一网络下的设备可直接把消息 POST 到手机,无需经过云端服务器,实现局域网消息直达。

  • 监听地址:默认 0.0.0.0,监听所有网卡
  • 监听端口:默认 3010
  • 验证 push_key:是否校验请求中的 push_key
  • 服务状态:开启 / 关闭接口服务
接口说明:GET / POST 请求 http://[地址]:[端口]/,参数 push_key、title、content、date、type;POST 请求体支持 JSON 或表单格式。
消息服务关闭 / PushMe / 自建

PushMe 的消息接收核心服务,决定消息从哪里接收:

  • PushMe:使用官方服务器接收消息(默认,开箱即用)
  • 自建:使用你自己搭建的服务器接收消息
  • 关闭:停止消息服务,不再接收任何消息
自建服务点击「设置」

当你选择「自建」消息服务时,在此配置自己的服务器。部署方式见 PushMeServer 文档。

  • 服务地址:服务器 IP 或域名,支持 IPv6,不要带 http / mqtt 等前缀
  • 端口号:默认 3100
  • 协议:TCP / WebSocket
  • 证书:无证书 / 公共证书 / 自签名证书(自签名需填写证书内容)
  • push_key:自建服务的推送密钥,可点击「获取」自动填充
提示:如连接不上,可尝试关闭 TLS(改用无证书)再试。
消息插件显示「已启用 / 总数」

插件可在消息到达时对其进行验签、解密、加工处理,基于 JavaScript 编写。点击「设置」进入插件管理页,可新增、编辑、启用 / 禁用插件。详见 插件开发文档。

消息转发显示「开启 / 关闭」

把收到的消息通过 HTTP POST 转发到指定 URL,可将消息同步到电脑或其他系统。点击「设置」进入转发配置页。详见 PushMeClient 文档。

前台服务开启 / 关闭

开启后,核心服务会以「前台服务」方式常驻运行,并在通知栏显示一条不可划掉的服务通知。它可以显著减少因后台被系统冻结而导致的 MQTT 频繁掉线,代价是略微增加耗电。默认关闭。

APP 设置


侧边栏 → APP 设置,个性化外观与通知行为。

APP 语言系统 / 中文 / 英文

设置 APP 界面语言,默认跟随系统。切换语言后需重启 APP 生效。

APP 主题系统 / 暗色 / 亮色

设置 APP 的明暗主题,默认跟随系统。

APP 颜色系统 / PushMe / 自定义
  • 系统:跟随系统动态取色(Material You)
  • PushMe:使用默认主题色(默认)
  • 自定义:点击「选择颜色」,通过取色器自定义主题色
系统最近任务显示 / 隐藏

设置是否在系统的最近任务列表中显示 PushMe。默认显示;选择「隐藏」后,APP 不出现在最近任务里,可减少被误清理的几率。

状态通知通知 / 限静 / 静音 / 限断 / 关闭

控制服务连接状态通知的显示与声音,默认「限断」:

  • 通知:始终显示状态通知
  • 限静:始终显示,但在指定时段内静音(可选静音起止时间)
  • 静音:始终显示,但始终静音
  • 限断:仅在服务断开连接时显示通知(默认)
  • 关闭:不显示状态通知
建议保持开启,方便随时确认服务是否在线。
语音通知标题 / 内容 / 标题+内容

设置收到消息时 TTS 语音播报的内容,默认播报「标题」。

提示:语音通知需在「权限设置 → 通知通道」中,为对应通道单独开启才会生效。若手机没有声音,请检查是否安装了 TTS 引擎(一般手机自带,也可安装「讯飞语记」等)。
重复通知间隔滑块 10 ~ 90 秒

设置重复提醒的时间间隔,默认 30 秒。开启后,未处理的消息会按此间隔反复提醒,避免漏看。

提示:重复通知同样需在「权限设置 → 通知通道」中为对应通道单独开启。
消息通知操作按钮显示 / 隐藏

设置消息通知上是否显示「已读」「删除」快捷操作按钮。默认显示,可在通知栏直接处理消息。

权限设置


侧边栏 → 权限设置。由于各安卓系统杀后台严重,为保证 PushMe 24 小时在线接收消息,请给予 APP 最大权限。

闹钟提醒Android 12+

授予闹钟(Alarm)权限,用于后台服务的定时重连,保证服务断开后能自动恢复。

自启动已设置 / 未设置

允许 APP 开机自动启动,确保手机重启后服务能自动恢复。进入系统设置后确认开启即可。

电池优化已设置 / 未设置

将 APP 加入电池优化白名单(忽略优化),防止系统因省电策略杀掉后台服务。

消息通知已设置 / 未设置

授予通知权限,允许 APP 显示推送通知(Android 13+ 需手动授予)。

通知通道点击「设置」

管理各通知通道的铃声、振动、语音等(Android 8+)。APP 默认包含以下通道:

  • 消息通知:接收消息时的通知
  • 状态通知:服务连接状态通知
  • 自定义通道:在消息标题中用 [~通道名] 语法创建的通道

每个通道可独立配置「语音通知」与「重复通知」开关。

提示:请开启锁屏通知,否则锁屏后可能没有声音。
应用锁定部分手机需要设置

部分手机需要在最近任务页面长按 PushMe 卡片进行「锁定」,防止被一键清理。

✅ 推荐做法
大部分手机开启以上权限后,就可以在多任务页面把 APP 划掉,只留后台服务运行。部分手机还需关闭「网络优化」,否则 APP 进入后台会被断网。

其他设置


侧边栏 → 其他设置。

文件管理点击「打开」

管理 APP 内保存的文件,可查看、上传、删除文件。

临时密钥 temp_key不支持自建服务

临时密钥用于临时推送场景,过期后会自动失效。需先获取 push_key 后,才能获取 temp_key。

数据小屏统计

显示当前数据消息的统计数量,点击可进入数据小屏页面。详见 数据小屏。

崩溃日志发送 / 不发送 / 关闭
  • 发送:崩溃时自动上报日志(默认,便于排查问题)
  • 不发送:仅在本地记录崩溃日志
  • 关闭:不记录崩溃日志

发送消息


侧边栏 → 发送消息,可在 APP 内直接发送测试消息:

  1. 填写 消息标题 和 消息内容(至少填写一项)
  2. 选择 消息类型(可点击「示例」快速填充)
  3. 点击发送按钮
如使用自建服务,需先填写自建服务的接口地址。

消息类型


通知消息

支持 text、markdown、html、url 等类型,满足各种文本推送需求;另有系统其它应用发出的 notify(json字符串)和定时任务发出的 task(文本)

数据小屏

支持 data、markdata、note、chart、echarts、svg 格式

消息主题

支持信息、成功、警告、失败四种主题,让消息一目了然

消息通道

支持自定义通道,为不同通道设置不同的声音、震动、通知方式

语音播报

支持消息标题和内容语音播报,支持消息循环重复通知

消息分组

支持分组头像和 emoji 头像,消息分类更清晰

通知胶囊

数据消息支持悬浮、贴边显示,支持常驻状态栏

消息插件

支持插件开发,对收到的消息进行验签、解密、加工处理

消息标题语法

消息标题支持特殊语法来提取元信息,可组合使用:

主题标记

通道标记

格式:[~通道名],例如 [~重点通知]服务器告警。不同通道可在系统通知设置中配置不同的声音、震动。

分组标记

组合使用

[s][~我的通道][#张三!https://xxx.jpg] 任务完成

数据小屏 & 悬浮窗


数据小屏(Dashboard)

点击主页右下角圆形按钮进入数据小屏页面,展示 data、markdata、note、chart、echarts、svg 类型的数据消息。

悬浮窗消息

数据类型消息(data、chart 等)可以以悬浮窗形式常驻显示在屏幕上:


点击主页右上角搜索图标,可搜索消息标题和内容:

关于我们


侧边栏 → 关于我们。

意见建议点击「填写」

跳转到反馈页面,可提交使用中遇到的问题或建议。

更新日志点击「查看」

查看 PushMe 的版本更新记录,对应官网 更新日志 页面。

APP 版本检查更新

显示当前 APP 版本号,点击可检查是否有新版本。

更多功能


常见问题


消息收不到怎么办?

  1. 检查 push_key 是否正确
  2. 检查手机通知权限是否开启
  3. 检查 APP 是否在后台被杀(参考上方权限设置)
  4. 查看状态通知,确认服务是否在线

push_key 是什么?

push_key 是你在 PushMe APP 上获取的唯一标识,用于接收消息。相当于你的收件地址,别人通过这个 key 就能给你推送消息。

如何兼容企业微信 / 钉钉 / 飞书?

PushMe 接口兼容企业微信 / 钉钉 / 飞书群机器人的 webhook 格式,直接替换 webhook 地址为 PushMe 接口即可,参数无需改动。

各品牌手机保活情况?

服务断开后无法重连?

APP 使用 AlarmManager 定时重连,间隔会逐渐增大(10~60 秒起步,每次增加 60 秒)。确保 APP 未被系统杀掉(开启自启动、忽略电池优化)。网络切换(WiFi / 移动数据)时会自动重连。

如何使用自建服务器?

  1. 部署 pushme-server:GitHub 仓库
  2. 在服务设置 → 消息服务中选择「自建」,再进入自建服务填写地址、端口
  3. 选择证书模式(无证书 / 公共证书 / 自签名证书)
  4. 开启状态即可

如何使用消息插件?

  1. 服务设置 → 消息插件 → 设置
  2. 添加新插件,填写名字和 JavaScript 代码
  3. 插件代码需返回处理后的 msg 对象
  4. 可使用 ENV 环境变量和 PMF 内置方法