PushDeer PushKey 推送

PushDeer 使用 PushKey 标识接收账户，可通过官方服务或自建实例发送。本文依据 PushDeer 官方资料整理，核验日期为 2026-09-08；未使用真实 PushKey 执行推送，服务地址应以当前实例为准。

准备条件

已安装并登录 PushDeer 客户端，或已部署自建服务。
已在客户端添加设备并取得 PushKey。
已确认所用服务的 API 基础地址。

配置步骤

在 PushDeer 客户端登录并绑定接收设备。
创建或复制 PushKey。
将官方服务或自建服务地址与 PushKey 分开保存。
先发送纯文本，再测试 Markdown 或图片类型。

凭据说明

字段	必需	说明
`PUSHDEER_BASE_URL`	是	官方或自建服务 API 地址
`PUSH_KEY`	是	接收账户的推送密钥
`type`	否	消息类型，按当前服务版本支持填写

最小请求

JavaScript 示例需要 Node.js 20 或更新版本；Python 示例需要安装 requests。

以下示例使用官方资料中的公共服务地址；自建时替换基础地址：

curl -X POST 'https://api2.pushdeer.com/message/push' \
  --data-urlencode 'pushkey=PUSH_KEY' \
  --data-urlencode 'text=通知渠道连通性测试' \
  --data-urlencode 'type=text'

const body = new URLSearchParams({
  pushkey: process.env.PUSH_KEY,
  text: '通知渠道连通性测试',
  type: 'text',
});
const response = await fetch('https://api2.pushdeer.com/message/push', {
  method: 'POST',
  body,
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

import os
import requests

response = requests.post(
    "https://api2.pushdeer.com/message/push",
    data={"pushkey": os.environ["PUSH_KEY"], "text": "通知渠道连通性测试", "type": "text"},
    timeout=15,
)
response.raise_for_status()
print(response.json())

验证结果

检查响应业务状态，并确认 PushKey 关联的设备收到消息。自建环境还需检查服务端、厂商推送或客户端长连接状态。

安全建议

PushKey 只放在服务器端，不在公开 URL 或日志中记录。
自建实例使用 HTTPS、访问控制和受限管理后台。
区分官方服务与自建地址，避免把生产消息误发到错误实例。

常见问题

请求成功但设备无消息：检查设备绑定、客户端通知权限和系统推送设置。

自建地址返回 404：确认当前版本的 API 前缀和反向代理路径。

Markdown 未渲染：检查 type 与服务版本支持情况，先验证纯文本。