Server酱文档中心

Docker Hub + Server酱：镜像推送推送到微信

效果：Docker Hub 仓库有新镜像 push 时，自动在微信收到通知。

前置条件

  • 获取 Server酱 SendKey（30 秒获取教程）
  • 拥有 Docker Hub 账号及目标镜像仓库的管理权限

配置步骤

Docker Hub 的 Webhook 会向指定 URL POST 固定 JSON，而 Server酱 服务端会优先读取 URL query 中的 title 参数，因此可以直接将标题拼接到 URL 中实现直连。

  1. 复制以下 Webhook URL，将 你的SENDKEY 替换为你的真实 SendKey：
https://sctapi.ftqq.com/你的SENDKEY.send?title=DockerHub%E6%9C%89%E6%96%B0%E9%95%9C%E5%83%8F

如果你的 SendKey 以 sctp 开头（Server酱³），请将请求端点替换为 https://你的UID.push.ft07.com/send/你的SENDKEY.send（UID 取自 sctp 与 t 之间的数字）。

  1. 登录 Docker Hub，进入目标仓库的 Webhooks 设置页面（具体入口以应用内实际显示为准）。
  2. 点击新建 Webhook，将上一步拼接好的 URL 粘贴到 Webhook URL 输入框中并保存。

当该仓库有新镜像 push 时，Docker Hub 会触发请求，你将在微信收到标题为“DockerHub有新镜像”的通知。

进阶：推送包含 tag 和仓库名

如果需要把具体的仓库名或 tag 送进消息正文，直连方案无法解析 JSON body，需通过一层中转（如 Cloudflare Workers 或云函数）。中转服务接收 Docker Hub 的固定 JSON，解析出所需字段后，再将其作为 title 或 desp 参数转发给 Server酱 API。

常见问题

免费额度用完了怎么办？

Server酱免费版每天提供 5 条消息。订阅会员目前特价最低 3 元/月，一天最多可发 1000 条（价格详情）。

配置后没收到消息？

检查 Webhook URL 中的 SendKey 是否正确，确认 Docker Hub 仓库有新的 push 事件触发。如仍无法解决，参考常见问题与排查。

推送频率有限制吗？

Server酱 API 每分钟上限 50 次，会员每日 API 请求上限 1000 次。Docker Hub 连续 push 多个 tag 时请注意频率。

相关集成

懒人方案：把这段话复制给你的 AI 助手

把下面这段文字原样粘贴给 Claude Code、Cursor 或任何 AI 编程助手，它就会替你完成 Server酱 的接入：

请帮我把 Server酱 微信通知接入到我当前的项目/工具中：
1. API：POST https://sctapi.ftqq.com/{SendKey}.send，参数 title（必填，不能含换行）、desp（正文，支持 Markdown，可选）；成功时返回 JSON 的 code 为 0。
2. 如果我的 SendKey 以 sctp 开头，则改用 https://{uid}.push.ft07.com/send/{SendKey}.send，uid 是 SendKey 中 sctp 与 t 之间的数字。
3. SendKey 从环境变量 SERVERCHAN_SENDKEY 读取；如果没有，提醒我到 https://sct.ftqq.com 免费获取（每天 5 条额度）。
4. 安全要求：不要把 SendKey 硬编码进代码、不要打印到日志、不要提交到 git。
5. 频率约定：任务结束发 1 条结果摘要即可，批量任务合并成一条，不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。