Go-WXPush：开源、轻量微信消息推送方案，Docker部署，API接入

luler · 2025-12-26T17:40:23+00:00

一、简介 Go-WXPush 是一个基于 golang 开发的微信测试公众号模板消息推送服务，极简且免费测试公众号每天有10万次额度，消息都是微信公众号原生消息弹窗提示支持Docker一键部署，基于Go语言的优势内存占用仅几MB 提供消息发送API，所有参数都可以通过接口传入，便于集成到第三方服务该工具...

luler

一、简介

Go-WXPush 是一个基于 golang 开发的微信测试公众号模板消息推送服务，极简且免费
测试公众号每天有10万次额度，消息都是微信公众号原生消息弹窗提示
支持Docker一键部署，基于Go语言的优势内存占用仅几MB
提供消息发送API，所有参数都可以通过接口传入，便于集成到第三方服务
该工具的开源地址：https://github.com/hezhizheng/go-wxpush
该工具的工作原理可参考下图

二、安装与使用

1. 第一步：注册并配置一个测试微信公众号

微信扫码即可完成注册，获得一个测试公众号的appid、appsecret配置，地址：https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
扫描测试号二维码，成为测试公众号的用户，获得用户userid
新增通知消息的模板，获得模板ID，标题可以自定义，模板内容只用到content参数，建议设为：: ）{{content.DATA}}

2. Docker安装 Go-WXPush 服务

建议在Docker中部署，提前准备好Docker、docker-compose软件环境

新建docker-compose.yml配置文件，配置内容如下：

services:
  go-wxpush:
    image: hezhizheng/go-wxpush:v3
    restart: unless-stopped
    ports:
      - "5566:5566"
    command:
      - "-port"
      - "5566"
      - "-appid"
      - "wxxxx"           # 关键参数1：替换为实际值
      - "-secret"
      - "20xxxx"          # 关键参数2：替换为实际值
      - "-tz"
      - "Asia/Shanghai"
      - "-base_url"
      - "http://server_ip:5566" #可选参数：填写部署机器的域名或ip+端口，点击微信公众号消息会跳转到这个地址，可以注释不传base_url，默认是公共服务地址：https://push.hzz.cool

配置完成执行如下命令一键启动

docker-compose up -d

3. 调用API发送微信公众号消息

接口：http://server_ip:5566/wxsend
请求方式：GET

请求参数

参数名	类型	是否必填	描述
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	否	时区(默认东八区)

使用示例，在postman调用接口发送成功截图如下
微信公众号通知相关示例截图
toast弹窗

公众号内消息

点击公众号消息跳转链接查看详情页面

三、总结

Go-WXPush 可以让你轻松实现微信通知的功能，提供消息的触达能力（基本每个人都有且都用微信）
该工具是利用微信公众号测试版功能来实现通知发送的，额度很充足，但可能不那么优雅，只能满足功能性需求，不适合企业或者广泛应用
可使用Docker快速部署，基于golang程序运行高效且轻量，提供的API也易于集成和应用