開(kāi)源免費(fèi)的微信消息推送服務(wù)、10萬(wàn)次額度+2MB鏡像，開(kāi)發(fā)者福音 微信消息推送

作為一名開(kāi)發(fā)者，你一定遇到過(guò)這樣的場(chǎng)景：

• ? 服務(wù)器半夜報(bào)警，需要第一時(shí)間通知

• ? 自動(dòng)化腳本跑完任務(wù)，想知道結(jié)果

• ? 個(gè)人博客有新評(píng)論，想及時(shí)收到提醒

• ? NAS、路由器、樹(shù)莓派這些設(shè)備需要狀態(tài)監(jiān)控

最直接的方案當(dāng)然是——發(fā)微信。但問(wèn)題來(lái)了：怎么發(fā)？

企業(yè)微信認(rèn)證太麻煩，第三方服務(wù)收費(fèi)不菲，自己寫又要搞懂微信的整套 API、Token 刷新、模板消息規(guī)則……光是看文檔就能勸退不少人。

最近發(fā)現(xiàn)一個(gè)開(kāi)源項(xiàng)目go-wxpush，用 Go 語(yǔ)言寫的，完美解決了這個(gè)問(wèn)題：極簡(jiǎn)部署、完全免費(fèi)、每天10萬(wàn)次額度，而且 Docker 鏡像才 2MB。

今天就帶你拆解這個(gè)工具，5 分鐘上手。

核心特性

先上結(jié)論，這個(gè)工具的幾個(gè)殺手锏：

特性

對(duì)開(kāi)發(fā)者的價(jià)值

完全免費(fèi)

基于微信測(cè)試公眾號(hào)

個(gè)人和小團(tuán)隊(duì)零成本

部署極簡(jiǎn)

Docker 鏡像僅 2MB

秒啟動(dòng)，資源占用極低

超高額度

每天 10 萬(wàn)次推送

個(gè)人項(xiàng)目根本用不完

原生體驗(yàn)

微信原生彈窗+聲音提醒

和普通消息無(wú)差別

多用戶支持

可配置多個(gè)接收人

團(tuán)隊(duì)協(xié)作友好

自帶詳情頁(yè)

消息點(diǎn)擊可查看詳情

適合展示完整日志

三步搞定微信測(cè)試賬號(hào)

正式部署前，需要先搞定微信這邊的配置。別擔(dān)心，5 分鐘就能搞定。

第一步：申請(qǐng)測(cè)試公眾號(hào)

打開(kāi)這個(gè)鏈接：mp.weixin.qq.com/debug/cgi-bin/sandbox

掃碼登錄后會(huì)看到一個(gè)測(cè)試號(hào)管理界面，這里有兩個(gè)關(guān)鍵信息：

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

第二步：獲取你的 UserID

在測(cè)試號(hào)頁(yè)面下方有個(gè)"用戶列表"區(qū)域，用你的微信掃描頁(yè)面上的二維碼，掃碼后你的微信號(hào)就會(huì)出現(xiàn)在列表中，格式通常類似oXXXXXX-xxxx。

這個(gè) UserID 就是消息接收者的唯一標(biāo)識(shí)。

第三步：創(chuàng)建消息模板

在測(cè)試號(hào)頁(yè)面的"新增測(cè)試模板"處，創(chuàng)建一個(gè)模板。關(guān)鍵點(diǎn)來(lái)了：

模板內(nèi)容必須按這個(gè)格式填寫：

內(nèi)容: {{content.DATA}}

注意！不要只填{{content.DATA}}，前面必須加個(gè)"內(nèi)容:"或者其他文字，否則推送會(huì)不顯示內(nèi)容！

創(chuàng)建成功后會(huì)得到一個(gè)template_id，記下來(lái)，后面要用。

這樣你就獲得了

appid

secret

userid

template_id

把值復(fù)制出來(lái)備用。

部署方式

準(zhǔn)備好上述參數(shù)后，就可以部署服務(wù)了。項(xiàng)目提供了三種方式：

方式一：Docker 一鍵部署（推薦）

這是最推薦的方式，鏡像只有 2MB，秒啟動(dòng)。

# 重新部署請(qǐng)先拉一遍最新的鏡像
docker pull hezhizheng/go-wxpush:v4

 # 參數(shù)格式與終端啟動(dòng)保持一致, 替換成實(shí)際值即可

 docker run -it -d -p 5566:5566 --init --name go-wxpush4 hezhizheng/go-wxpush:v4 \
-port "5566" \
-title "測(cè)試標(biāo)題5566" \
-content "測(cè)試內(nèi)容5566" \
-appid "xxx" \
-secret "xxx" \
-userid "xxx-k08" \
-template_id "xxx-Ks_PwGm--GSzllU" \
-tz "Asia/Shanghai"

星哥實(shí)測(cè)：

[root@xxxx ~]# curl http://127.0.0.1:5566/wxsend?title=服務(wù)器通知&content=服務(wù)已于北京時(shí)間%2026:00%20重啟
[1] 15196
[root@xxxx ~]# {"errcode":0,"errmsg":"ok"}

效果：

方式二：直接下載編譯好的文件（最簡(jiǎn)單）

項(xiàng)目在 Releases 頁(yè)面提供了編譯好的可執(zhí)行文件，支持 Windows、macOS、Linux 多平臺(tái)。

下載后直接運(yùn)行：

./go-wxpush_windows_amd64.exe -port "5566" \
  -title "測(cè)試標(biāo)題" \
  -content "測(cè)試內(nèi)容" \
  -appid "你的appID" \
  -secret "你的appsecret" \
  -userid "你的UserID" \
  -template_id "你的template_id" \
  -base_url "https://push.hzz.cool"

如果你需要自定義或者想學(xué)習(xí)源碼，可以直接編譯：

# 安裝 gox 工具
go install github.com/mitchellh/gox@latest


 # 生成各平臺(tái)可執(zhí)行文件
gox -osarch="windows/amd64" -ldflags "-s -w"
gox -osarch="linux/amd64" -ldflags "-s -w"
gox -osarch="darwin/amd64" -ldflags "-s -w"

服務(wù)啟動(dòng)后，默認(rèn)監(jiān)聽(tīng)5566端口，推送接口非常簡(jiǎn)單。

GET 請(qǐng)求（適合快速測(cè)試）

http://127.0.0.1:5566/wxsend?title=服務(wù)器通知&content=服務(wù)已于北京時(shí)間%2022:00%20重啟

參數(shù)說(shuō)明：

參數(shù)

必填

title

消息標(biāo)題

content

消息內(nèi)容

appid

微信測(cè)試號(hào) appID

secret

微信測(cè)試號(hào) appsecret

userid

接收者 UserID

template_id

消息模板 ID

base_url

消息詳情頁(yè)跳轉(zhuǎn)地址

tz

時(shí)區(qū)（默認(rèn)東八區(qū)）

POST 請(qǐng)求（適合 Webhook 集成）

更適合自動(dòng)化場(chǎng)景，比如 GitHub Actions、CI/CD、服務(wù)器監(jiān)控等。

curl --location --request POST 'http://127.0.0.1:5566/wxsend' \
--header 'Content-Type: application/json' \
--data-raw '{
  "title": "Webhook 通知",
  "content": "自動(dòng)化任務(wù)已完成。",
  "appid": "你的appID",
  "secret": "你的appsecret",
  "userid": "你的UserID",
  "template_id": "你的template_id"
}'

成功時(shí)返回：

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

失敗時(shí)會(huì)返回對(duì)應(yīng)的錯(cuò)誤碼和錯(cuò)誤信息。

實(shí)戰(zhàn)場(chǎng)景

理論說(shuō)完了，來(lái)點(diǎn)實(shí)際應(yīng)用場(chǎng)景：

場(chǎng)景一：服務(wù)器監(jiān)控報(bào)警

寫個(gè)簡(jiǎn)單的監(jiān)控腳本，CPU 超過(guò) 80% 時(shí)觸發(fā)推送：

#!/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=??服務(wù)器報(bào)警&content=CPU使用率:${CPU_USAGE}%"
fi

在 GitHub Actions 中添加推送步驟，構(gòu)建完成自動(dòng)通知：

- name: 發(fā)送微信通知
  run: |
    curl -X POST http://your-server:5566/wxsend \
      -H "Content-Type: application/json" \
      -d '{
        "title": "? 構(gòu)建成功",
        "content": "項(xiàng)目 ${{ github.repository }} 分支 ${{ github.ref }} 構(gòu)建完成"
      }'

每天定時(shí)跑的數(shù)據(jù)分析腳本，跑完推送結(jié)果：

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(" 數(shù)據(jù)分析完成", "今日新增用戶: 123, 活躍用戶: 456")

1. 1.測(cè)試號(hào)限制：使用的是微信測(cè)試公眾號(hào)，掃描人數(shù)限制在 100 人，但個(gè)人和小團(tuán)隊(duì)完全夠用

2. 2.模板格式：再次強(qiáng)調(diào)，模板內(nèi)容一定要加前綴，比如"內(nèi)容: {{content.DATA}}"

3. 3.不要濫用公共服務(wù)：雖然作者提供了免費(fèi)服務(wù)，但建議自行部署，避免給別人帶來(lái)壓力

4. 4.時(shí)區(qū)問(wèn)題：默認(rèn)使用東八區(qū)，如果需要其他時(shí)區(qū)，可以通過(guò)tz參數(shù)設(shè)置

寫文不易，如果你都看到了這里，請(qǐng)點(diǎn)個(gè)贊和在看，分享給更多的朋友；也別忘了關(guān)注星哥玩云！這里有滿滿的干貨分享，還有輕松有趣的技術(shù)交流～點(diǎn)個(gè)贊、分享給身邊的小伙伴，一起成長(zhǎng)，一起玩轉(zhuǎn)技術(shù)世界吧！

go-wxpush這個(gè)項(xiàng)目雖然小，但解決了開(kāi)發(fā)者的真實(shí)痛點(diǎn)：簡(jiǎn)單、免費(fèi)、可靠。

如果你正在為微信消息推送發(fā)愁，不妨試試這個(gè)方案。5 分鐘就能搭建起來(lái)，從此告別監(jiān)控盲區(qū)。

項(xiàng)目地址：https://github.com/hezhizheng/go-wxpush