# 开源免费的微信消息推送服务、10万次额度+2MB镜像，开发者福音



## 微信消息推送

作为一名开发者，你一定遇到过这样的场景：

- 服务器半夜报警，需要第一时间通知
- 自动化脚本跑完任务，想知道结果
- 个人博客有新评论，想及时收到提醒
- NAS、路由器、树莓派这些设备需要状态监控

最直接的方案当然是——发微信。但问题来了：怎么发？



企业微信认证太麻烦，第三方服务收费不菲，自己写又要搞懂微信的整套 API、Token 刷新、模板消息规则……光是看文档就能劝退不少人。

最近发现一个开源项目 `go-wxpush`，用 Go 语言写的，完美解决了这个问题：**极简部署、完全免费、每天10万次额度**，而且 Docker 镜像才 2MB。

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/2c371afacd837e2eaebf7310773faa97.png)

今天就带你拆解这个工具，5 分钟上手。

## 核心特性

先上结论，这个工具的几个杀手锏：

| 特性           | 说明                  | 对开发者的价值       |
| -------------- | --------------------- | -------------------- |
| **完全免费**   | 基于微信测试公众号    | 个人和小团队零成本   |
| **部署极简**   | Docker 镜像仅 2MB     | 秒启动，资源占用极低 |
| **超高额度**   | 每天 10 万次推送      | 个人项目根本用不完   |
| **原生体验**   | 微信原生弹窗+声音提醒 | 和普通消息无差别     |
| **多用户支持** | 可配置多个接收人      | 团队协作友好         |
| **自带详情页** | 消息点击可查看详情    | 适合展示完整日志     |



## 三步搞定微信测试账号

正式部署前，需要先搞定微信这边的配置。别担心，5 分钟就能搞定。

### 第一步：申请测试公众号

打开这个链接：https://mp.weixin.qq.com/debug/cgi-bin/sandbox

扫码登录后会看到一个测试号管理界面，这里有两个关键信息：

```
- appID：类似 `wx1234567890abcdef` 的字符串
- appsecret：一串加密字符串
```

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/5c44b436e539cdfa3cb0d107444d2539.png)

### 第二步：获取你的 UserID

在测试号页面下方有个"用户列表"区域，用你的微信扫描页面上的二维码，扫码后你的微信号就会出现在列表中，格式通常类似 `oXXXXXX-xxxx`。

这个 UserID 就是消息接收者的唯一标识。

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/da21a44f813509662c181f19892f7db8.png)

### 第三步：创建消息模板

在测试号页面的"新增测试模板"处，创建一个模板。**关键点来了**：

模板内容必须按这个格式填写：

```plaintext
内容: {{content.DATA}}
```

注意！**不要**只填 `{{content.DATA}}`，前面必须加个"内容:"或者其他文字，否则推送会不显示内容！

创建成功后会得到一个 **template_id**，记下来，后面要用。

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/8410ca8c48405ebe86feb83d090c7196.png)

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/48f61f0bbe7c081a7a2e2375882f5ecd.png)

这样你就获得了

appid

secret

userid

template_id

把值复制出来备用。



## 部署方式

准备好上述参数后，就可以部署服务了。项目提供了三种方式：

### 方式一：Docker 一键部署（推荐）

这是最推荐的方式，镜像只有 2MB，秒启动。

```bash
# 重新部署请先拉一遍最新的镜像
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"
```

星哥实测：

```
[root@xxxx ~]# curl http://127.0.0.1:5566/wxsend?title=服务器通知&content=服务已于北京时间%2026:00%20重启
[1] 15196
[root@xxxx ~]# {"errcode":0,"errmsg":"ok"}
```

效果：

![img](https://developer.qcloudimg.com/http-save/yehe-8492898/69cad65b46fdabbe7ef9ad65a8690c07.png)



### 方式二：直接下载编译好的文件（最简单）

项目在 [Releases](https://github.com/hezhizheng/go-wxpush/releases) 页面提供了编译好的可执行文件，支持 Windows、macOS、Linux 多平台。

下载后直接运行：

```bash
./go-wxpush_windows_amd64.exe -port "5566" \
  -title "测试标题" \
  -content "测试内容" \
  -appid "你的appID" \
  -secret "你的appsecret" \
  -userid "你的UserID" \
  -template_id "你的template_id" \
  -base_url "https://push.hzz.cool"
```



### 方式三：自行编译（完全控制）

如果你需要自定义或者想学习源码，可以直接编译：

```bash
# 安装 gox 工具
go install github.com/mitchellh/gox@latest

# 生成各平台可执行文件
gox -osarch="windows/amd64" -ldflags "-s -w"
gox -osarch="linux/amd64" -ldflags "-s -w"
gox -osarch="darwin/amd64" -ldflags "-s -w"
```



## API 使用：GET 和 POST 都支持

服务启动后，默认监听 `5566` 端口，推送接口非常简单。

### GET 请求（适合快速测试）

```bash
http://127.0.0.1:5566/wxsend?title=服务器通知&content=服务已于北京时间%2022:00%20重启
```

参数说明：

| 参数        | 必填 | 说明                 |
| ----------- | ---- | -------------------- |
| title       | 是   | 消息标题             |
| content     | 是   | 消息内容             |
| appid       | 是   | 微信测试号 appID     |
| secret      | 是   | 微信测试号 appsecret |
| userid      | 是   | 接收者 UserID        |
| template_id | 是   | 消息模板 ID          |
| base_url    | 否   | 消息详情页跳转地址   |
| tz          | 否   | 时区（默认东八区）   |

### POST 请求（适合 Webhook 集成）

更适合自动化场景，比如 GitHub Actions、CI/CD、服务器监控等。

```bash
curl --location --request POST 'http://127.0.0.1:5566/wxsend' \
--header 'Content-Type: application/json' \
--data-raw '{
  "title": "Webhook 通知",
  "content": "自动化任务已完成。",
  "appid": "你的appID",
  "secret": "你的appsecret",
  "userid": "你的UserID",
  "template_id": "你的template_id"
}'
```



### 响应结果

成功时返回：

```json
{
  "errcode": 0,
  "errmsg": "ok"
}
```

失败时会返回对应的错误码和错误信息。



## 实战场景

理论说完了，来点实际应用场景：

### 场景一：服务器监控报警

写个简单的监控脚本，CPU 超过 80% 时触发推送：



```bash
#!/bin/bash
CPU_USAGE=$(top -bn1 | grep "Cpu(s)" | sed "s/.*, *$[0-9.]*$%* id.*/\1/" | awk '{print 100 - $1}')

if (( $(echo "$CPU_USAGE > 80" | bc -l) )); then
  curl "http://127.0.0.1:5566/wxsend?title=⚠️服务器报警&content=CPU使用率:${CPU_USAGE}%"
fi
```



### 场景二：CI/CD 通知

在 GitHub Actions 中添加推送步骤，构建完成自动通知：

```yaml
- name: 发送微信通知
  run: |
    curl -X POST http://your-server:5566/wxsend \
      -H "Content-Type: application/json" \
      -d '{
        "title": "✅ 构建成功",
        "content": "项目 ${{ github.repository }} 分支 ${{ github.ref }} 构建完成"
      }'
```



### 场景三：自动化脚本结果

每天定时跑的数据分析脚本，跑完推送结果：

```python
import requests

def send_notification(title, content):
    url = "http://127.0.0.1:5566/wxsend"
    params = {
        "title": title,
        "content": content
    }
    requests.get(url, params=params)

send_notification("📊 数据分析完成", "今日新增用户: 123, 活跃用户: 456")
```





## 友情提醒

1. **测试号限制**：使用的是微信测试公众号，扫描人数限制在 100 人，但个人和小团队完全够用
2. **模板格式**：再次强调，模板内容一定要加前缀，比如"内容: {{content.DATA}}"
3. **不要滥用公共服务**：虽然作者提供了免费服务，但建议自行部署，避免给别人带来压力
4. **时区问题**：默认使用东八区，如果需要其他时区，可以通过 `tz` 参数设置

## 总结

写文不易，如果你都看到了这里，请点个赞和在看，分享给更多的朋友；也别忘了关注星哥玩云！这里有满满的干货分享，还有轻松有趣的技术交流～点个赞、分享给身边的小伙伴，一起成长，一起玩转技术世界吧！ 😊

`go-wxpush` 这个项目虽然小，但解决了开发者的真实痛点：**简单、免费、可靠**。

如果你正在为微信消息推送发愁，不妨试试这个方案。5 分钟就能搭建起来，从此告别监控盲区。


企业微信认证太麻烦，第三方服务收费不菲，自己写又要搞懂微信的整套 API、Token 刷新、模板消息规则……光是看文档就能劝退不少人。

开源免费的微信消息推送服务、10万次额度+2MB镜像，开发者福音

运维经理

开发工具

后端

开源免费微信消息推送服务go-wxpush，Go语言开发，Docker镜像仅2MB，每日10万次推送额度。支持服务器监控、CI/CD通知、自动化脚本提醒，原生微信弹窗体验，5分钟完成部署。

数据分析

代码解释

服务器

路由器

Windows

路由

Linux

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

开源免费的微信消息推送服务、10万次额度+2MB镜像，开发者福音-腾讯云开发者社区-腾讯云

开源免费的微信消息推送服务、10万次额度+2MB镜像，开发者福音

开源免费的微信消息推送服务、10万次额度+2MB镜像，开发者福音

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐