跳转到内容

推送密钥 ​

推送密钥(Push Key)决定一条通知可以发送给什么设备。发送程序只需要持有密钥,就能通过 MeowPush API 向对应的接收目标发送通知,无需登录你的账号。

密钥可以对应单台设备、一个设备组,或一个应用。设备和设备组用于组织接收目标;应用 用于为不同的推送来源分配独立授权,且可以随时调整接收目标甚至是停止推送,是接入 Agent、第三方软件和自己的服务时更推荐的方式。

设备密钥 ​

设备密钥以 mpdv 开头,只向对应单台设备发送通知。它适合只需要在一台设备上接收消息的场景,例如让一个临时脚本向你的手机发送提醒。

你可以在 App 的「使用指南」复制「此设备」密钥,也可以进入「我的」→「推送密钥」集中管理密钥。

管理设备和设备组密钥

设备组密钥 ​

设备组将多台设备组织成一个接收目标,使用以 mpgp 开头的密钥发送通知。它适合需要在指定的手机、平板或电脑上同时收到消息的场景。

设备组接收范围适用场景
所有设备账号下当前和新增的所有设备设备较少,且希望每台设备都收到通知
自定义设备组手动指定的设备工作通知发给工作设备,私人消息发个人设备等

在「推送密钥」页面新建设备组,选择成员并命名,例如 Personal 或 Work,并勾选加入该组的设备:使用该密钥发送的通知会投递给设备组内的所有设备。你可以随时调整其设备列表。

使用自定义设备组组织需要一起接收通知的设备

应用推送密钥 ​

应用是更灵活的通知管理单位。例如,你可以为 Home Server、Build Agent 和 Daily Summary 分别建立应用,再为它们选择设备或设备组作为接收目标。它可以有效隔离和帮助区分不同来源的通知,并减少设备或设备组密钥的泄漏风险。

每个应用有独立的应用推送密钥,以 mpap 开头。发送端使用这个密钥即可向应用当前授权的目标发送通知,而不需要取得底层设备或设备组密钥。你可以随时调整某个应用的推送设备。

接入 Agent、第三方软件或长期运行的脚本时,建议优先使用应用推送密钥。可在 App 或 MeowPush 账户管理 创建和管理应用。更多操作指南见 应用。

请妥善保管推送密钥

推送密钥是持有即可使用的发送凭证(bearer capability)。不要把真实密钥提交到公开仓库、写进公开日志或分享在截图中。发现泄漏时,请立即重置对应密钥,并更新使用此密钥的发送程序或服务。