linux.do

【开源自荐】微信推送服务

开源微信推送服务

使用Spring Boot 4.0 和 GraalVM Native

通过企业微信（WeCom），将系统消息稳定、合规地推送到用户的微信中接收。

整体消息流转路径如下：

flowchart LR
  A[业务系统 / 服务] -->|HTTP请求| B[push-server]
  B -->|企业微信 API| C[企业微信服务端]
    C --> D[微信 App]

最终效果是：用户在微信中收到消息，但技术通道使用的是企业微信。

为什么选择企业微信？
相比微信公众号，企业微信具备天然的系统通知优势：

✅️ 无缝触达：消息最终可到达微信 App（需关注插件）。
✅️ 主动推送：支持无限制的主动消息推送，适合通知。
✅️ 稳定合规：官方允许的系统消息通道，不涉及内容风控。
✅️ 简单易用：无需复杂的模板消息申请，开发接口清晰。

有什么需要的或者想法可以提，交流一下

项目地址

教程

1. 注册企业微信

谁都可以注册企业微信，无需认证,按说明注册并使用微信扫二维码完成管理员绑定

2.微信插件

选择我的企业，点击微信插件，使用手机扫码关注

3. 添加应用

添加logo 和应用名称以及可见范围，选择一个部门或者自己都行，创建应用

4. 配置应用

4.1 查看Secret

创建完成后会进入当前页面，点击查看可以看Secret

点击发送，可前往企业微信查看消息

点击查看，保存好，不要泄露，至关重要

4.2 配置可信IP

在配置可信IP之前，我们需要先设置可信域名

可信域名需要校验域名，点击申请校验域名获得认证信息

下载文件放置到一个网站的根目录下，我这里放置到了自己在cloudflare的Workers 和 Pages 博客上 https://mazepeng.com/

当文件可以访问到的时候就可以设置可信域名了

----------------------

现在推送消息的服务必须有可信IP，如何获得自己的IP呢

访问https://ifconfig.me/ 或者直接百度IP 就可以看到自己的公网 IP了

点击应用管理，点击应用，拉倒最下面，配置可信IP

5. 运行push-server

支持docker部署和本地应用部署，这里我就介绍一下docker部署

5.1 docker命令部署

  docker run -d \
  --name push-server \
  -p 8000:8000 \
  -e PUSH_AUTH_KEY="替换为自己的key" \
  -e PUSH_WECOM_APP_KEY="你的应用AppKey" \
  -e PUSH_WECOM_APP_SECRET="你的应用AppSecret" \
  -e PUSH_WECOM_AGENT_ID="1000001" \
  qingzhoudev/push-server:latest

  #  安全设置，默认值为下方值，需要修改添加环境变量修改
  docker run -d \
  --name push-server \
  -p 8000:8000 \
  -e PUSH_AUTH_KEY="替换为自己的key" \
  -e PUSH_WECOM_APP_KEY="你的应用AppKey" \
  -e PUSH_WECOM_APP_SECRET="你的应用AppSecret" \
  -e PUSH_WECOM_AGENT_ID="1000001" \
  -e PUSH_SECURITY_BLOCK_MINUTES="30" \
  -e PUSH_SECURITY_FAIL_WINDOW_MINUTES="5" \
  -e PUSH_SECURITY_MAX_FAILS="5" \
  -e PUSH_SECURITY_RATE_LIMIT_CAPACITY="10" \
  -e PUSH_SECURITY_RATE_LIMIT_QPS="1" \
  qingzhoudev/push-server:latest

● PUSH_AUTH_KEY 请求头密钥，需要自己设置一个复杂的即可
● PUSH_WECOM_APP_KEY 就是企业ID
● PUSH_WECOM_APP_SECRET 就是保存的Secret
● PUSH_WECOM_AGENT_ID 应用ID

替换后直接docker启动

5.2 使用 Docker Compose

services:
  push-server:
    image: qingzhoudev/push-server:latest
    container_name: push-server
    ports:
      - "8000:8000"
    volumes:
      - ./application-prod.yml:/app/config/application-prod.yml:ro
    restart: unless-stopped

application-prod.yml文件

push:
  auth:
    key: "CHANGE_ME"
  security:
    block-minutes: 30
    fail-window-minutes: 5
    max-fails: 5
    rate-limit-capacity: 10
    rate-limit-qps: 1
  wecom:
    app-key: "CHANGE_ME"
    app-secret: "CHANGE_ME"
    agent-id: 1000001
    webhook-url:
server:
  port: 8000

5.3 企业ID

5.4 应用ID

6 推送消息

和正常接收微信消息一样，没有什么区别

curl -X POST http://localhost:8000/api/v1/push \
  -H "X-API-Key: 替换为自己的key" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "ZhangSan|LiSi",
    "type": "TEXT",
    "content": "系统通知：您的任务已构建完成。"
  }'
  curl -X POST http://localhost:8000/api/v1/push \
  -H "X-API-Key: 替换为自己的key" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "MaZePeng",
    "type": "TEXT_CARD",
    "title": "测试Push Server",
    "content": "我是 Push Server，这是我作为服务端的第一条消息",
    "url": "https://www.mazepeng.com"
  }'
curl -X POST http://localhost:8000/api/v1/push \
  -H "X-API-Key: 替换为自己的key" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "MaZePeng",
  "type": "NEWS",
  "articles": [
    {
      "title": "测试 Article",
      "description": "我是描述",
      "url": "https://www.mazepeng.com",
      "picUrl": "https://mazepeng.com/img/bg/a_larger_image_of_the_homepage.jpg"
    }
  ]
}'

类型有：

● TEXT
● MARKDOWN（微信不支持）
● TEXT_CARD
● NEWS

57 posts - 38 participants

Read full topic

via LINUX DO - 热门话题 (author: 轻舟)

Invalid media:
image
image
image
image
image
image
image
image
image
image
image
image
image
image
image

9 views04:20