企业微信提供了强大的消息推送功能,可以用于通知、提醒等场景。本文将介绍如何使用 farjar/weworkpush
Docker 镜像来快速搭建企业微信消息推送服务。
准备工作:
1、域名(可选)
2、固定公网IP的服务器,或者按照步骤1,注册华为云账号并购买云服务器
步骤1:注册华为云账号并购买云服务器
( 为啥需要固定公网IP和域名,是因为企业微信应用需要配置可信IP,微信服务器只接受这些IP发送的请求 )
- 之前没有购买过华为云服务器的,可以点击以下链接享受限时39元1年2c2g优惠:注册链接
- 购买完服务器后,安装Ubuntu 22.04 server 64bit系统,复制服务器的公网IP地址。
- 远程登录服务器,然后执行下述命令安装docker。
snap install docker
步骤2:创建企业微信应用
- 登录到企业微信管理后台:https://work.weixin.qq.com/
- 在管理后台中,选择 “我的企业”。复制企业ID,即 CorpID 。
- 在管理后台中,选择 “应用管理”。
- 然后在“自建”这一栏,点击 “创建应用”,填写应用名称、Logo 等基本信息,并点击 “确定”。
- 在应用详情页面,在 “AgentID” 一栏找到应用的 AgentID,复制该信息。
- 点击 “Secret” 的查看,将 Secret 发送到企业微信手机端,在手机上复制即可。
- 配置企业可信IP,将华为云服务的公网IP填入确认即可。
步骤3:获取Docker镜像
远程登录华为云服务器,在终端或命令行中执行以下命令:
docker pull farjar/weworkpush
步骤4:运行容器
环境变量 | 名称 | 默认值 |
---|---|---|
CORPID | 公司ID | 无 |
SECRET | 应用Secret | 无 |
AGENTID | 应用ID | 无 |
TOUSER | 接受用户 | @all |
TOKEN | 接口鉴权密钥 | 自定义,防止接口被滥用 |
docker run -d --restart always --name weworkpush -p 5000:5000 -e CORPID=ww -e SECRET=ez -e AGENTID=1000001 -e TOKEN=9a537 farjar/weworkpush:latest
这会在后台运行一个名为 weworkpush
的容器,并将容器的 5000 端口映射到宿主机的 5000 端口。
步骤5:防火墙放行
在华为云服务器安全组添加放行5000的规则
步骤6:测试发送消息
现在容器已经在运行了,你可以通过向容器的 /
路径发送 GET 请求来发送消息。直接在浏览器访问下面的网址,把 localhost 替换成服务器的公网IP
http://localhost:5000/?token=9a537&msg=推送消息内容
步骤7:结束
通过以上步骤,你已经成功搭建了企业微信消息推送服务,并且可以通过发送 HTTP 请求来推送消息到你的企业微信应用了。