nicholastzw/wxchat

wxchat 微信转发代理

镜像概述

wxchat 是一个轻量级的微信消息转发代理 Docker 镜像。它主要用于搭建企业微信小程序的消息接收与转发服务，能够作为中间件将企业微信的消息路由至下游应用（如 Nastool 等），实现消息推送与指令交互。

核心功能与特性

• 多架构支持：完美兼容 AMD64 和 ARM64 架构，适用于各类云服务器、NAS 及树莓派等设备。
• 轻量级部署：基于 Docker 容器化技术，一键启动，资源占用极低。
• 消息代理转发：提供标准化的 API 接口，接收企业微信回调消息并转发至指定后端服务。
• 高可用性：支持容器自动重启策略，保障消息通道的持续稳定运行。

使用场景

• Nastool 消息通知：作为 Nastool（影视自动化工具）的企业微信消息推送与交互通道。
• 自建应用消息路由：为各类需要接入企业微信 API 的自建应用提供稳定的消息回调接收服务。
• 自动化消息推送：将各类自动化脚本、智能家居系统的运行状态通过企业微信推送到个人手机。

快速开始

1. 环境准备

确保您的服务器（ARM 或 AMD 架构）已安装 Docker。如未安装，可通过以下命令一键安装：

国外网络环境：

bash
curl -sSL https://get.docker.com/ | sh

国内网络环境：

bash
curl -sSL https://get.daocloud.io/docker | sh

2. 运行容器

使用以下命令启动 wxchat 容器。请将 8080 替换为您实际需要映射的宿主机端口。

bash
docker run -d \
  --name wxchat \
  --restart=always \
  -p 8080:80 \
  nicholastzw/wxchat:latest

3. 验证服务状态

在浏览器中访问 http://<您的服务器IP>:<映射端口>。如果页面正常显示提示信息，则说明服务已成功启动并正常运行。

4. 配置可信 IP

登录企业微信管理后台，进入应用设置，将您的 VPS（服务器）公网 IP 地址添加到“企业可信IP”白名单中，以确保 API 调用的安全性。

企业微信小程序配置指南

若需将 wxchat 与下游应用（如 Nastool）对接，需在企业微信后台完成以下配置：

1. 创建自建应用

登录企业微信管理后台 -> 应用管理 -> 自建 -> 创建应用。填写应用名称、描述等基本信息并完成创建。

2. 获取核心参数

在创建的应用详情页中，记录以下关键信息：

• AgentId（应用ID）
• Secret（应用密钥）

3. 获取企业 ID

在企业微信管理后台首页，依次点击 我的企业 -> 企业信息，在页面底部找到并复制 企业ID。

4. 配置 API 接收消息

在应用详情页找到“接收消息”模块，点击“设置API接收”：

• 系统会自动生成 Token 和 EncodingAESKey。
• 注意：此时先不要点击保存（因为下游服务尚未配置），请先复制并记录这两个参数。

5. 配置下游应用（以 Nastool 为例）

将上述获取的 企业ID、AgentId、Secret、Token 和 EncodingAESKey 填入下游应用（如 Nastool）的微信消息通道配置中。保存配置并重启下游应用。

6. 完成企业微信回调验证

下游应用配置完成并启动后，返回企业微信后台的“API接收”设置页面，点击保存。系统会向您的 wxchat 服务发送验证请求，验证通过后即可完成整个消息通道的搭建。