推送密钥
推送密钥(Push Key)决定一条通知可以发送给什么设备。发送程序只需要持有密钥,就能通过 MeowPush API 向对应的接收目标发送通知,无需登录你的账号。
密钥可以对应单台设备、一个设备组,或一个应用。设备和设备组用于组织接收目标;应用 用于为不同的推送来源分配独立授权,且可以随时调整接收目标甚至是停止推送,是接入 Agent、第三方软件和自己的服务时更推荐的方式。
设备密钥
设备密钥以 mpdv 开头,只向对应单台设备发送通知。它适合只需要在一台设备上接收消息的场景,例如让一个临时脚本向你的手机发送提醒。
你可以在 App 的「使用指南」复制「此设备」密钥,也可以进入「我的」→「推送密钥」集中管理密钥。
设备组密钥
设备组将多台设备组织成一个接收目标,使用以 mpgp 开头的密钥发送通知。它适合需要在指定的手机、平板或电脑上同时收到消息的场景。
| 设备组 | 接收范围 | 适用场景 |
|---|---|---|
| 所有设备 | 账号下当前和新增的所有设备 | 设备较少,且希望每台设备都收到通知 |
| 自定义设备组 | 手动指定的设备 | 工作通知发给工作设备,私人消息发个人设备等 |
在「推送密钥」页面新建设备组,选择成员并命名,例如 Personal 或 Work,并勾选加入该组的设备:使用该密钥发送的通知会投递给设备组内的所有设备。你可以随时调整其设备列表。
应用推送密钥
应用是更灵活的通知管理单位。例如,你可以为 Home Server、Build Agent 和 Daily Summary 分别建立应用,再为它们选择设备或设备组作为接收目标。它可以有效隔离和帮助区分不同来源的通知,并减少设备或设备组密钥的泄漏风险。
每个应用有独立的应用推送密钥,以 mpap 开头。发送端使用这个密钥即可向应用当前授权的目标发送通知,而不需要取得底层设备或设备组密钥。你可以随时调整某个应用的推送设备。
接入 Agent、第三方软件或长期运行的脚本时,建议优先使用应用推送密钥。可在 App 或 MeowPush 账户管理 创建和管理应用。更多操作指南见 应用。
请妥善保管推送密钥
推送密钥是持有即可使用的发送凭证(bearer capability)。不要把真实密钥提交到公开仓库、写进公开日志或分享在截图中。发现泄漏时,请立即重置对应密钥,并更新使用此密钥的发送程序或服务。




