以下是基于最新资料的 Gewechat 部署与使用教程，结合多个可靠来源整理而成：

---

一、Gewechat 简介

Gewechat 是基于 iPad 协议的微信机器人框架，用于替代早期易被封禁的 Itchat。其核心优势是支持 Docker 部署，并通过 API 提供微信消息收发、文件传输等功能，适合搭建自动化客服、智能助手等场景。

核心特性：
• 协议稳定：相比 Itchat，封号风险更低（需配合同省服务器使用）。
• API 支持：提供 RESTful 接口，方便与第三方系统（如 Dify、ChatGPT）集成。
• 功能扩展：支持消息监听、群管理、文件上传/下载等。

---

二、部署准备

1. 硬件与账号要求

• 服务器/电脑：推荐使用 Linux 服务器（如 Ubuntu 22.04）或长期开机的本地电脑。
• 微信账号：需实名认证的微信号（建议使用“小号”，避免主号被封）。
• 网络环境：服务器需与微信号归属地同省（如广东微信号需部署在广东服务器）。

2. 依赖安装

• Docker 环境：需提前安装 Docker 和 Docker Compose。

# 安装 Docker
curl -fsSL https://get.docker.com | bash -s docker
# 安装 Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/v2.25.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

---

三、Gewechat 部署步骤

1. 拉取镜像并启动服务

# 拉取 Gewechat 镜像
docker pull registry.cn-hangzhou.aliyuncs.com/gewe/gewe:latest
docker tag registry.cn-hangzhou.aliyuncs.com/gewe/gewe gewe

# 创建数据目录
mkdir -p /home/gewechat/data

# 编写 Docker Compose 文件（vim docker-compose.yml）
version: '3'
services:
  gewechat:
    image: gewe
    container_name: gewechat
    privileged: true
    ports:
      - "2531:2531"  # API 服务端口
      - "2532:2532"  # 文件传输端口
    volumes:
      - ./data:/root/temp  # 持久化数据目录
    restart: unless-stopped

# 启动容器
docker-compose up -d

2. 验证服务运行

# 查看容器日志
docker logs gewechat
# 成功日志示例：
# 2025-02-07 14:02:16,210 info success: nginx entered running state...

若日志显示服务正常启动，则可通过 http://服务器IP:2531 访问 API。

---

四、Gewechat 核心功能配置

1. 微信登录与授权

• 扫码登录：

1. 访问 http://服务器IP:2531/login，获取登录二维码。
2. 使用微信小号扫码并授权。
3. 登录成功后，Gewechat 会自动维护会话状态。

2. API 接口调用示例

• 发送消息（POST 请求）：

curl -X POST "http://IP:2531/api/send" \
-H "Content-Type: application/json" \
-d '{
  "to_user": "好友微信号/群ID",
  "content": "Hello from Gewechat!",
  "type": "text"
}'

• 接收消息：需配置 Webhook 监听端口，参考官方文档设置回调地址。

---

五、进阶：集成 Dify-on-Wechat (DOW)

Gewechat 可与 Dify-on-Wechat 结合，实现 AI 问答、工作流等高级功能：

1. 拉取 DOW 代码：

   git clone https://github.com/hanfangyuan4396/dify-on-wechat
   cd dify-on-wechat
   

2. 配置环境变量（编辑 config.json）：

   {
     "channel_type": "gewechat",
     "gewechat_base_url": "http://IP:2531/v2/api",
     "dify_api_key": "app-xxxxxx",
     "single_chat_prefix": [""]
   }
   

3. 启动 DOW：

   docker-compose up -d
   

---

六、注意事项

1. 账号安全：
   • 避免高频消息发送（如每分钟超过 20 条）。
   • 定期检查容器日志，处理异常登录提示。
2. 服务器维护：
   • 每月更新 Docker 镜像：docker-compose pull && docker-compose up -d。
3. 功能限制：
   • 文件传输需通过 2532 端口，确保防火墙放行。

---

如需进一步调试或获取完整代码，可参考 Gewechat 官方仓库或结合 Dify 平台扩展功能。