写了一个极简的微信消息推送服务,有需要的可以试试~
Go-WXPush - 微信消息推送服务 (基于 golang)
这是一个基于 golang 开发的微信测试公众号模板消息推送服务。它提供了一个简单的 API 接口,让您可以轻松地通过 HTTP 请求将消息推送到指定的微信用户。 github 地址 https://github.com/hezhizheng/go-wxpush
✨ 特性
✅ 完全免费,下载即使用
✅ 支持 Docker 一键部署(镜像容器大小仅 2MB)
✅ 每天 10 万次额度,个人用不完
✅ 真正的微信原生弹窗 + 声音提醒
✅ 支持多用户
✅ 提供免费服务 https://push.hzz.cool (请勿滥用)
✅ 跳转稳定,自带消息详情页面 (默认使用 https://push.hzz.cool/detail , 可自己部署后使用参数替换)
⚠️ 部署条件 (具体可查看 github )
🚀 部署指南
下载编译好的文件启动
- 启动参数
- 命令行启动参数(可不加,启动之后直接在 url 上拼接参数也可)
./go-wxpush_windows_amd64.exe -port "5566" -title "测试标题" -content "测试内容" -appid "xxx" -secret "xxx" -userid "xxx-k08" -template_id "xxx-Ks_PwGm--GSzllU" -base_url "https://push.hzz.cool" - url 请求参数(get)
与命令行参数名称一致/wxsend?appid=xxx&secret=xxx&userid=xxx-k08&template_id=xxx-Ks_PwGm--GSzllU&base_url=https://push.hzz.cool&content=保持微笑,代码无 bug!
- 命令行启动参数(可不加,启动之后直接在 url 上拼接参数也可)
自行编译可执行文件(跨平台)
# 用法参考 https://github.com/mitchellh/gox
# 生成文件可直接执行
gox -osarch="windows/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
gox -osarch="darwin/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
gox -osarch="linux/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
gox -osarch="linux/arm64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
🐳 Docker 启动
- 将编译好的文件放在与 Dockerfile 同目录
- 构建镜像
docker build -t go-wxpush:v2 .
- 启动镜像,参数与命令行保持一致
docker run -d -p 5566:5566 --name go-wxpush0 go-wxpush:v2 \
-port "5566" \
-title "测试标题" \
-content "测试内容" \
-appid "xxx" \
-secret "xxx" \
-userid "xxx-k08" \
-template_id "xxx-Ks_PwGm--GSzllU"
🐳 Docker 一键部署
# 重新部署请先拉一遍最新的镜像
docker pull hezhizheng/go-wxpush:v4
# 参数格式与终端启动保持一致, 替换成实际值即可
docker run -it -d -p 5566:5566 --init --name go-wxpush4 hezhizheng/go-wxpush:v4 \
-port "5566" \
-title "测试标题 5566" \
-content "测试内容 5566" \
-appid "xxx" \
-secret "xxx" \
-userid "xxx-k08" \
-template_id "xxx-Ks_PwGm--GSzllU" \
-tz "Asia/Shanghai"
⚙️ API 使用方法
服务部署成功后,您可以通过构造 URL 发起 GET 请求来推送消息。
请求地址
http://127.0.0.1:5566/wxsend
请求参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
port | String | 否 | 指定启动端口(仅针对命令行) |
title | String | 是 | 消息的标题。 |
content | String | 是 | 消息的具体内容。 |
appid | String | 是 | 临时覆盖默认的微信 AppID。 |
secret | String | 是 | 临时覆盖默认的微信 AppSecret。 |
userid | String | 是 | 临时覆盖默认的接收用户 OpenID。 |
template_id | String | 是 | 临时覆盖默认的模板消息 ID。 |
base_url | String | 否 | 临时覆盖默认的跳转 URL。 |
tz | String | 否 | 时区(默认东八区) |
使用示例
基础推送
向默认配置的所有用户推送一条消息:
http://127.0.0.1:5566/wxsend?title=服务器通知&content=服务已于北京时间 %2022:00%20 重启
临时覆盖用户
向一个临时指定的用户推送消息:
http://127.0.0.1:5566/wxsend?title=私人提醒&content=记得带钥匙&userid=temporary_openid_here
Webhook / POST 请求
除了 GET 请求,服务也支持 POST 方法,更适合用于自动化的 Webhook 集成。
请求地址
http://127.0.0.1:5566/wxsend
请求方法
POST
请求头 (Headers)
{ "Content-Type": "application/json" }
请求体 (Body)
请求体需要是一个 JSON 对象,包含与 GET 请求相同的参数。
{ "title": "Webhook 通知", "content": "这是一个通过 POST 请求发送的 Webhook 消息。" }
使用示例 (cURL)
curl --location --request POST 'http://127.0.0.1:5566/wxsend' \ --data-raw '{ "title": "来自 cURL 的消息", "content": "自动化任务已完成。" }'
成功响应
如果消息成功发送给至少一个用户,服务会返回 "errcode": 0 状态码。
失败响应
如果发生错误(如 token 错误、缺少参数、微信接口调用失败等),服务会返回相应的状态码和错误信息。



我想静静