WXPush

WXPush 是一个基于 Cloudflare Workers 构建的轻量级微信公众号模板消息推送服务。它提供简单的 HTTP API，让你通过一行 URL 或一次 Webhook 调用，即可向微信用户发送带原生弹窗 + 声音提醒的通知。

核心优势：
✅ 完全免费（Cloudflare 免费套餐 + 微信模板消息免费）
✅ 每日 10 万次请求额度，个人用户“用不完”
✅ 无需服务器、无需维护、5 分钟部署上线

✨ 核心特性

• 微信原生体验：消息以模板卡片形式推送，支持声音与系统通知
• 多用户支持：默认配置可推送至多个 OpenID（用 | 分隔）
• 灵活覆盖：API 支持临时替换 AppID、用户、模板 ID 等参数
• 双协议支持：同时支持 GET（URL 调用）和 POST（Webhook）
• 皮肤扩展：配合 wxpushSkin 项目，可自定义消息 UI（需公众号支持）
• 跳转稳定：点击消息可跳转至指定网页（支持 base_url 覆盖）

🚀 部署指南（两种方式）

方法一：直接粘贴代码（推荐新手）

1. 登录 Cloudflare 仪表板
2. 进入 Workers 和 Pages → 创建应用程序 → 创建 Worker
3. 为 Worker 命名（如 my-wxpush），点击 部署
4. 部署后点击 编辑代码，清空默认内容，粘贴 项目 src/index.js 的全部代码
5. 点击 保存并部署

配置环境变量（关键！）

进入 Worker 的 设置 > 变量，添加以下 加密环境变量：

🔒 务必勾选“加密”，防止凭据泄露。

方法二：GitHub 自动部署（推荐开发者）

1. Fork 本项目 到你的 GitHub 账户
2. 在 Cloudflare 中选择 Workers 和 Pages → 连接到 Git
3. 选择你的 Fork 仓库，分支设为 main
4. 构建设置：框架选 None，构建命令和输出目录留空
5. 在 环境变量 中添加同上加密变量
6. 点击 保存并部署

此后每次 git push 都会自动更新服务。

⚙️ API 使用方法

1. GET 请求（URL 调用）

https://<your-worker>.<subdomain>.workers.dev/wxsend
?title=服务器告警
&content=CPU使用率超过90%
&token=your_secret_token

可选参数（用于临时覆盖默认配置）：

• appid、secret、userid、template_id、base_url

示例：临时推送给新用户
...&userid=new_openid_123

2. POST 请求（Webhook 集成）

curl -X POST \
  https://<your-worker>/wxsend \
  -H "Authorization: your_secret_token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "备份完成",
    "content": "数据库每日备份已成功执行"
  }'

请求头：

• Authorization: 你的 API_TOKEN
• Content-Type: application/json

请求体：JSON 对象，字段同 GET 参数。

✅ 响应说明

• 成功：HTTP 200 + 文本如
  Successfully sent messages to 2 user(s). First response: ok
• 失败：HTTP 4xx/5xx + 错误信息（如 token 无效、微信接口错误等）

📌 使用前提

1. 已认证的微信公众号（订阅号/服务号均可）
2. 已申请模板消息（在公众号后台 > 功能 > 模板消息）
3. 已获取用户 OpenID（通过网页授权或客服消息接口）

注意：模板消息需用户48 小时内互动过才能推送（服务号无此限制）。

适用场景

• 服务器监控告警（如宕机、高负载）
• CI/CD 流水线通知（构建成功/失败）
• 家庭自动化提醒（如门禁、水电异常）
• 个人任务提醒（日程、待办事项）
• 开源项目 Webhook 集成