go-wxpush：轻量微信推送服务

go-wxpush是一款基于Golang开发的微信模板消息推送服务，无需复杂配置，上手即用。该工具专为需要实时接收服务器告警、自动化任务通知的打工人和开发者设计，利用微信作为消息推送的最佳载体。

## 一、核心特性

1. **完全免费无套路**：下载即可使用，没有隐藏收费项，个人开发者和小团队完全够用
2. **超轻量易部署**：Docker镜像仅2MB，占用资源极少，支持一键部署，新手也能快速上手
3. **额度充足不限制**：每天10万次推送额度，不管是个人日常提醒还是小型项目通知，都能满足需求
4. **原生体验超贴心**：微信原生弹窗+声音提醒，消息不遗漏，比第三方通知更靠谱
5. **多用户+高灵活**：支持多用户接收消息，自带消息详情页面，还能无限换皮肤（搭配wxpushSkin项目）
6. **公网服务免部署**：提供免费公共服务https://push.hzz.cool
，无需自建服务器也能直接使用（温馨提示：请勿滥用哦）

## 二、快速上手步骤

### 1. 准备必要参数

首先需要获取几个关键参数：
- 登录微信公众平台接口测试账号，无需注册公众号，微信扫码即可登录
- 在测试号管理页面获取appID和appsecret
- 用微信扫描测试号二维码关注，获取个人userid（微信号）
- 新增测试模板，模板内容格式为`内容: {{content.DATA}}`，获取template_id（模板ID）

### 2. 部署方式

**方式1：Docker一键部署（最简便）**
```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 "测试标题" \
-content "测试内容" \
-appid "你的appid" \
-secret "你的secret" \
-userid "你的userid" \
-template_id "你的模板ID" \
-tz "Asia/Shanghai"
```

**方式2：直接下载编译文件启动**
```bash
./go-wxpush_windows_amd64.exe -port "5566" -title "测试标题" -content "测试内容" -appid "你的appid" -secret "你的secret" -userid "你的userid" -template_id "你的模板ID" -base_url "https://push.hzz.cool"
```

**方式3：自行编译（跨平台支持）**
支持Windows、Mac、Linux等多系统，编译命令：
```bash
gox -osarch="windows/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
```

### 3. 发送消息

**GET请求方式**
直接构造URL即可推送：
```
http://127.0.0.1:5566/wxsend?appid=你的appid&secret=你的secret&userid=你的userid&template_id=你的模板ID&content=保持微笑，代码无bug！
```

**POST请求方式（适合Webhook集成）**
请求头：Content-Type: application/json
请求体：
```json
{
  "title": "Webhook通知",
  "content": "这是一个通过POST请求发送的自动化消息"
}
```

cURL示例：
```bash
curl --location --request POST 'http://127.0.0.1:5566/wxsend' \
--data-raw '{
  "title": "来自cURL的消息",
  "content": "自动化任务已完成。"
}'
```

## 三、适用场景

- 服务器监控告警：CPU、内存、磁盘使用率超标实时通知
- 自动化任务提醒：脚本执行结果、数据同步完成通知
- 个人日程提醒：重要事项、待办任务定时推送
- 项目协作通知：代码提交、部署完成、Bug反馈提醒
- 爬虫任务通知：数据抓取完成、异常中断告警

## 四、项目地址

GitHub：https://github.com/hezhizheng/go-wxpush

这款工具真正实现了"极简实用"的理念，无需复杂的开发流程，就能快速实现微信消息推送功能。无论是开发者、运维人员，还是需要高效提醒工具的普通用户，都值得尝试使用。

go-wxpush：轻量微信推送服务

评论已关闭

本文目录

分类

最新文章