WeChatPadPro

🚀 基於 WeChat Pad 協議的高級管理工具v860

🌐 在線演示系統 - 默認密碼:adminkey = 28d21d0f9748172c970ba4c208af5564

⭐️ 歡迎 Star，獲取專案最新動態！⭐️

📋 專案介紹 • 📝 功能特性 • 📦 系統包下載 • 📅 更新日誌 • 🚀 Docker部署 • 📖 使用說明 • 🛡️ 風控指南 • 💰 贊助支持

📢 加入官方交流群

🌟 加入我們的官方交流群和論壇，獲取最新版本更新、技術支援和使用教程！

💬 Telegram 交流群	💼 微信付費專業群	🔔 釘釘交流群	🌐 Know Hub 在線論壇
📊 成員數量: 1400+ 位用戶 🔔 即時更新通知 💡 技術問題解答 💬 使用經驗分享	🔒 掃碼付費加入專業群 ⭐ VIP技術支持 🚀 專屬功能體驗 ⚡ 優先解決問題 🎯 高級使用技巧分享	💻 技術討論 ❓ 問題解答 💡 使用經驗分享	探索與交流 Know Hub 的無限可能 📚 WeChatPadPro交流群 💬 技術問題討論 📖 安裝使用指南 🆕 新需求反饋 📋 文檔中心

💰 贊助支持

您的支持是我們持續更新的動力

🌟 每一份贊助都是對我們最大的鼓勵 🌟

🌟 成為贊助者可獲得

✅ 優先技術支援 - 獲得開發者直接回應
✅ 新功能優先體驗 - 提前體驗最新功能
✅ 客製化需求支援 - 您的需求將被優先考慮
✅ 企業級多帳號解決方案 - 適合商業用戶
✅ 高級API支援 - 更多高級介面調用能力

🚀 立即行動

💳 安全支付 · ⚡ 即時開通

💡 提示: 完成贊助後，請保留交易號並聯繫我們獲取贊助者特權

WeChat API & iPad 協議使用說明與風控防範教程（2025 年更新）

本教程旨在協助開發者全面了解 WeChat API 平台與 iPad 協議的登入行為、介面使用限制、風控策略及預防措施，確保使用穩定、安全、高效。

🚀 快速部署 (Docker)

如果您想快速部署 WeChatPadPro，我們提供了 Docker 部署方案，只需幾個簡單步驟即可完成部署：

1. 克隆項目

git clone https://github.com/WeChatPadPro/WeChatPadPro.git
cd WeChatPadPro/deploy

2. 配置環境變數

編輯 .env 文件，根據您的需求修改配置：

# MySQL配置
MYSQL_ROOT_PASSWORD=root123456
MYSQL_DATABASE=weixin
MYSQL_USER=weixin
MYSQL_PASSWORD=123456
MYSQL_PORT=3306

# Redis配置
REDIS_PASSWORD=123456
REDIS_PORT=6379

# WeChat Pad Pro配置
WECHAT_PORT=8080
DB_HOST=wechatpadpro_mysql
DB_PORT=3306
DB_DATABASE=weixin
DB_USERNAME=weixin
DB_PASSWORD=123456
REDIS_HOST=wechatpadpro_redis
REDIS_DB=0

# 管理員密鑰（建議使用複雜的隨機字符串）
ADMIN_KEY=999222

3. 啟動服務

docker-compose up -d

4. 訪問服務

啟動成功後，您可以通過以下地址訪問服務：

http://您的伺服器IP:1238

5. 常用命令

# 查看服務狀態
docker-compose ps

# 查看日誌
docker-compose logs -f

# 停止服務
docker-compose down

# 重啟服務
docker-compose restart

📝 提示：Docker 部署是最簡單快捷的方式，適合大多數用戶。如果您需要更多自定義配置，請參考下方的完整環境配置。

📋 快速開始

在開始使用本專案之前，請務必：

📚 仔細閱讀風控指南，了解帳號安全事項
🐳 選擇部署方式：
- Docker快速部署（推薦：簡單快捷）
- 傳統部署（適合需要自定義配置的用戶）
🔒 遵循登入注意事項進行首次登入
🧪 參考測試指南進行功能測試

⚠️ 特別提醒：新帳號請務必遵循新帳號使用建議，避免觸發風控！

📋 專案介紹

WeChatPadPro 是一個功能強大的 WeChat 管理工具，基於 WeChat Pad 協議開發。本專案致力於提供穩定、高效的 WeChat 自動化解決方案，支援多帳號管理、訊息處理、自動化任務等功能。

🌟 主要特點

🛡️ 安全可靠: 採用最新的 WeChat Pad 協議，確保帳號安全
🔄 自動化處理: 支援訊息自動回覆、群管理等自動化操作
🎯 精準控制: 提供細粒度的功能控制和配置選項
🔌 擴展性強: 支援外掛系統，可自定義擴展功能
📊 資料同步: 支援多裝置資料同步，確保資訊統一

🎯 適用場景

👥 個人用戶：訊息管理、自動回覆、防撤回等
🏢 企業用戶：客戶管理、批量操作、資料分析等
🤖 開發者：二次開發、功能擴展、自動化整合等

📦 環境要求

MySQL 5.7+ (推薦)
Redis
穩定的網路環境
支援 Windows/Linux 系統

📝 功能特性

WeChatPadPro 是基於 WeChat Pad 協議的高級 WeChat 管理工具，支援以下功能：

🔐 微信登录验证码API功能 ⭐ 重点功能

1. 多种登录方式支持

✅ 二维码登录 - 支持获取登录二维码，绕过验证码流程
✅ 验证码登录 - 自动处理验证码提交，无需手动获取ticket
✅ 短信登录 - 支持短信验证码登录方式
✅ 设备登录 - 支持A16数据登录和设备ID登录

2. 自动验证码处理

✅ 自动获取ticket - 系统自动从Redis或状态缓存中获取ticket
✅ 自动生成data62 - 如果data62为空，系统会自动根据设备信息生成
✅ 多重数据源 - 从Redis、状态缓存、用户信息、连接管理器等多个来源获取ticket
✅ 智能参数验证 - 自动检查必要参数，提供友好错误提示

3. 实时状态检测

✅ 登录状态监控 - 实时检测扫码状态和登录进度
✅ 验证码状态跟踪 - 自动识别是否需要验证码
✅ 连接健康检查 - 实时监控连接状态，自动检测连接健康度
✅ 心跳监控 - 增加心跳时间记录，超过10秒无心跳认为连接不健康

4. RabbitMQ消息队列支持

✅ 智能重连机制 - 只在连接确实断开时才重连，避免频繁重连
✅ 连接健康检查 - 实时监控连接状态，自动检测连接健康度
✅ 并发安全 - 使用互斥锁确保重连过程的线程安全
✅ 消息持久化 - 确保消息在服务器重启后不丢失

5. 多账号管理

✅ 多账号并行 - 支持同时管理多个微信账号
✅ 账号隔离 - 每个账号独立运行，互不影响
✅ 统一管理 - 通过统一接口管理所有账号状态

6. 自动Token刷新

✅ 自动刷新 - 系统自动检测并刷新过期的Token
✅ 无缝切换 - Token刷新过程中不影响正常使用
✅ 状态同步 - 刷新后自动同步所有相关状态

🔄 API接口列表

登录相关接口

POST /api/login/qr/newx - 获取微信登录二维码（绕过验证码）
POST /api/login/AutoVerificationcode - 自动处理验证码提交
GET /api/login/CheckLoginStatus - 检测扫码登录状态
POST /api/login/verify/auto - 自动处理验证码（推荐）
POST /api/login/verify/manual - 手动处理验证码

状态检测接口

GET /api/login/GetLoginStatus - 获取在线状态
GET /api/login/GetInItStatus - 初始化状态
GET /api/login/CheckCanSetAlias - 检测微信登录环境

设备管理接口

POST /api/login/DeviceLogin - 设备登录
POST /api/login/A16Login - A16数据登录
POST /api/login/SmsLogin - 短信登录

🔹 基礎功能

💬 訊息收發

文字、圖片、名片、動圖、檔案

👥 好友管理

新增、刪除、清理殭屍粉

🔄 朋友圈互動

發布、點讚、評論

💲 WeChat 支付

轉帳、紅包

🔖 小程式和名片分享

📇 通訊錄好友新增

⭐ WeChat 收藏

🏷️ 標籤管理

🔹 增強功能

🔧 MCP 增強功能
- 多協議適配：自動識別並適配不同版本 WeChat 協議
- 自動化管理：通過配置實現請求自動通過、訊息同步
🤖 自動化功能
- 自動搶紅包、訊息防撤回
- 自動通過好友請求
- 多群訊息同步
👑 高級群管理
- 建群、拉人、踢人、邀請成員
- 群公告發布、修改群名稱

📦 系統包下載

🚀 最新版本系統包

支持多平台、多架構的系統包下載

🖥️ 支持平台

操作系統	支持的架構	檔案名
Windows	AMD64 (x86_64)	wechatpadpro_v860_20250704_windows-amd64.zip
Windows	ARM64	wechatpadpro_v860_20250704_windows-arm64.zip
macOS	AMD64 (Intel)	wechatpadpro_v860_20250704_macos-amd64.zip
macOS	ARM64 (M1/M2)	wechatpadpro_v860_20250704_macos-arm64.zip
Linux	AMD64 (x86_64)	wechatpadpro_v860_20250704_linux-amd64.zip
Linux	ARM64	wechatpadpro_v860_20250704_linux-arm64.zip
Linux	MIPS64	wechatpadpro_v860_20250704_linux-mips64.zip
Linux	MIPS64LE	wechatpadpro_v860_20250704_linux-mips64le.zip
Linux	PPC64	wechatpadpro_v860_20250704_linux-ppc64.zip
Linux	PPC64LE	wechatpadpro_v860_20250704_linux-ppc64le.zip
Linux	RISC-V 64	wechatpadpro_v860_20250704_linux-riscv64.zip
FreeBSD	AMD64	wechatpadpro_v860_20250704_freebsd-amd64.zip
FreeBSD	ARM64	wechatpadpro_v860_20250704_freebsd-arm64.zip
OpenBSD	AMD64	wechatpadpro_v860_20250704_openbsd-amd64.zip
OpenBSD	ARM64	wechatpadpro_v860_20250704_openbsd-arm64.zip

📋 安裝說明

系統要求

操作系統：Windows 7+、macOS 10.13+、Linux (內核 3.10+)、FreeBSD 12+、OpenBSD 6.8+
記憶體：至少 2GB RAM
儲存：至少 200MB 可用空間
網路：穩定的互聯網連接

安裝步驟

下載：根據您的操作系統和CPU架構，從上表中選擇對應的壓縮包下載
解壓：將下載的壓縮包解壓到您選擇的目錄
配置：
- 修改 config.json 檔案，設置必要的參數
- 配置 webhook_config.json 檔案，設置Webhook相關參數
- 設置環境變數（可選）
運行：
- Windows: 雙擊 wechatpadpro.exe 或在命令行中運行
- Linux/macOS/BSD: 執行 ./wechatpadpro

🔗 快速下載

🪟 Windows

🍎 macOS

🐧 Linux

📝 版本說明

v860 - 最新穩定版本，包含所有最新功能
v849 - 歷史版本，仍受支持
開發版 - 包含實驗性功能，僅供測試使用

🔄 更新日誌

詳細的更新日誌請查看：GitHub Releases

🛠️ 開發資源

🔧 開發工具和資源

📚 API文檔

資源	鏈接	說明
Swagger UI	在線API文檔	完整的API接口文檔
Postman集合	下載集合	可直接導入Postman
API測試工具	ApiPOST	推薦的API測試工具
在線論壇	Know Hub論壇	技術交流、問題討論、經驗分享

🎯 快速開始

教程	鏈接	難度
5分鐘快速上手	快速開始指南	⭐
Docker部署教程	Docker部署	⭐⭐
API使用示例	API示例代碼	⭐⭐
高級功能教程	高級功能指南	⭐⭐⭐

🔍 常見問題

❓ 常見問題

如何獲取授權碼？
登錄失敗怎麼辦？
如何配置代理？
風控問題如何解決？

🔧 故障排除

連接問題排查
驗證碼處理
性能優化
安全配置

📊 項目統計

📈 下載統計

🔄 開發活躍度

👥 社區活躍度

📅 更新日誌 (CHANGELOG)

v1.1.0 (2025-07-27)

1. 连接管理优化

RabbitMQ和登录验证码更新说明

🔄 RabbitMQ优化更新

1. 连接管理优化

✅ 智能重连机制：只在连接确实断开时才重连，避免频繁重连
✅ 连接健康检查：实时监控连接状态，自动检测连接健康度
✅ 心跳监控：增加心跳时间记录，超过10秒无心跳认为连接不健康
✅ 并发安全：使用互斥锁确保重连过程的线程安全

2. 错误处理改进

✅ 精确错误识别：只对包含"connection"或"channel"的错误进行重连
✅ 重试机制：连接失败后自动重试一次
✅ 详细日志：增加推送编号，便于追踪消息推送状态

3. 性能优化

✅ 跳过Redis操作：新增配置选项，可跳过Redis操作提高性能
✅ 队列声明优化：使用更安全的队列声明方式
✅ 消息持久化：确保消息在服务器重启后不丢失

🔐 登录验证码流程更新

1. 新增自动验证码处理API

`AutoLoginVerifyCodeApi` - 自动处理验证码

POST /api/login/verify/auto

功能特点：

✅ 自动获取ticket：用户无需提供ticket，系统自动从Redis获取
✅ 自动补全data62：如果data62为空，自动根据设备信息生成
✅ 多重ticket获取：优先从Redis获取，失败后从状态缓存获取
✅ 智能参数验证：自动检查必要参数，提供友好错误提示

`LoginVerifyCodeApi` - 手动验证码处理

POST /api/login/verify/manual

功能特点：

✅ 手动ticket支持：支持用户手动提供ticket
✅ 自动ticket补全：如果未提供ticket，自动从多个来源获取
✅ 多重数据源：从Redis、状态缓存、用户信息、连接管理器等多个来源获取ticket
✅ 完整参数验证：确保所有必要参数都已提供

2. 验证码处理流程

步骤1：扫码登录

# 获取登录二维码
POST /api/login/qr/new
{
  "proxy": "http://proxy:port",  // 可选：代理设置
  "deviceName": "iPhone",        // 可选：设备名称
  "deviceId": "device_id"        // 可选：设备ID
}

步骤2：检查登录状态

# 检查扫码状态
GET /api/login/status?key=your-uuid

返回状态说明：

code: 200 - 扫码成功，等待确认
code: -3 - 需要验证码，返回ticket
code: 300 - 二维码不存在或已过期

步骤3：提交验证码（自动模式）

# 自动处理验证码（推荐）
POST /api/login/verify/auto?key=your-uuid
{
  "uuid": "your-uuid",
  "code": "123456"  // 验证码
}

步骤4：提交验证码（手动模式）

# 手动处理验证码
POST /api/login/verify/manual?key=your-uuid
{
  "uuid": "your-uuid",
  "code": "123456",     // 验证码
  "ticket": "ticket",   // 可选：手动提供ticket
  "data62": "data62"    // 可选：手动提供data62
}

3. Ticket获取策略

优先级顺序：

Redis缓存：db.GetTicketForKey(uuid)
状态缓存：db.GetCheckStatusCache(uuid).Ticket
用户信息：userInfo.Ticket
连接管理器：从活跃连接中获取ticket

自动补全策略：

data62自动生成：根据设备IMEI自动生成data62
ticket自动获取：从多个数据源自动获取ticket
参数验证：确保所有必要参数都已提供

v1.1.0 (2025-07-06) - Webhook系統重大更新

🔥 重要更新 - Webhook系統全面優化

訊息推送機制優化
- 實現全局訊息去重緩存，避免重複推送同一訊息
- 新增訊息緩存過期機制，默認1小時過期
- 優化歷史訊息同步策略，減少每次獲取的訊息數量（從50條減少到20條）
- 增加同步間隔（從5秒增加到15秒），降低服務器負載
訊息處理效率提升
- 新增訊息批量處理機制，單批次最多處理20條訊息
- 實現訊息優先級排序，實時訊息優先於歷史訊息
- 添加訊息處理鎖機制，確保訊息處理的原子性
- 優化隊列處理邏輯，減少訊息處理延遲

✨ 新功能 - Webhook配置管理

配置管理接口

POST   /v1/webhook/Config        # 創建新的Webhook配置
PUT    /v1/webhook/Update        # 更新現有Webhook配置
GET    /v1/webhook/List          # 獲取所有Webhook配置列表
GET    /v1/webhook/Status        # 查看Webhook配置狀態
GET    /v1/webhook/Test          # 測試Webhook連通性

配置功能特性
- 支持自定義訊息類型過濾
- 支持自定義重試次數和超時時間
- 支持訊息簽名驗證機制（HMAC-SHA256）
- 支持啟用/禁用特定Webhook
- 支持是否接收自己發送的訊息
- 提供詳細的推送統計信息（成功數、失敗數、最後推送時間等）
安全性和可靠性
- 支持設置密鑰進行訊息簽名
- 實現指數退避重試機制
- 提供訊息推送狀態實時反饋
- 支持配置超時和重試參數

🚀 v860 版本更新

查看所有版本發布 - 獲取最新版本下載和更新說明

1. 新增功能

授權碼管理優化：改進了授權碼授權設備管理API接口
遠程Docker支持：新增對遠程Docker環境的支持
多平台構建優化：支持更多操作系統和CPU架構
資料庫連接增強：優化了資料庫連接池和錯誤處理
Webhook配置增強：支持更多Webhook觸發事件和自定義配置
檔案傳輸加速：優化了大檔案傳輸性能和穩定性
驗證碼識別：集成驗證碼自動識別功能，提高登入成功率

2. 性能優化

降低了CPU和記憶體佔用
優化了網路連接處理
提高了大規模訊息處理的效率
改進了錯誤處理和日誌記錄
加速了檔案傳輸和處理速度
提高了Webhook響應速度

3. 支持平台

WeChatPadPro v860 支持以下操作系統和CPU架構：

操作系統	支持的架構	檔案名
Windows	AMD64 (x86_64)	wechatpadpro_v860_20250704_windows-amd64.zip
Windows	ARM64	wechatpadpro_v860_20250704_windows-arm64.zip
macOS	AMD64 (Intel)	wechatpadpro_v860_20250704_macos-amd64.zip
macOS	ARM64 (M1/M2)	wechatpadpro_v860_20250704_macos-arm64.zip
Linux	AMD64 (x86_64)	wechatpadpro_v860_20250704_linux-amd64.zip
Linux	ARM64	wechatpadpro_v860_20250704_linux-arm64.zip
Linux	MIPS64	wechatpadpro_v860_20250704_linux-mips64.zip
Linux	MIPS64LE	wechatpadpro_v860_20250704_linux-mips64le.zip
Linux	PPC64	wechatpadpro_v860_20250704_linux-ppc64.zip
Linux	PPC64LE	wechatpadpro_v860_20250704_linux-ppc64le.zip
Linux	RISC-V 64	wechatpadpro_v860_20250704_linux-riscv64.zip
FreeBSD	AMD64	wechatpadpro_v860_20250704_freebsd-amd64.zip
FreeBSD	ARM64	wechatpadpro_v860_20250704_freebsd-arm64.zip
OpenBSD	AMD64	wechatpadpro_v860_20250704_openbsd-amd64.zip
OpenBSD	ARM64	wechatpadpro_v860_20250704_openbsd-arm64.zip

4. 安裝說明

系統要求

操作系統：Windows 7+、macOS 10.13+、Linux (內核 3.10+)、FreeBSD 12+、OpenBSD 6.8+
記憶體：至少 2GB RAM
儲存：至少 200MB 可用空間
網路：穩定的互聯網連接

安裝步驟

下載：根據您的操作系統和CPU架構，從上表中選擇對應的壓縮包下載。
解壓：將下載的壓縮包解壓到您選擇的目錄。
配置：
- 修改 config.json 檔案，設置必要的參數
- 配置 webhook_config.json 檔案，設置Webhook相關參數
- 設置環境變數（可選）：
```
# Linux/macOS
export ADMIN_KEY="您的管理密鑰"

# Windows
$env:ADMIN_KEY="您的管理密鑰"
```
運行：
- Windows: 雙擊 wechatpadpro.exe 或在命令行中運行
- Linux/macOS/BSD: 執行 ./wechatpadpro

5. 功能使用說明

檔案發送

WeChatPadPro 支持發送多種類型的檔案，包括圖片、視頻、文檔等。

POST /api/v1/message/sendFile
Content-Type: multipart/form-data

{
  "toUserName": "接收者微信ID",
  "filePath": "本地檔案路徑",  // 與fileData二選一
  "fileData": "base64編碼的檔案數據",  // 與filePath二選一
  "fileName": "檔案名稱",
  "fileType": "檔案類型"  // 可選值: image, video, file
}

Webhook配置

Webhook 可以將微信訊息即時推送到您指定的URL。配置方法：

編輯 webhook_config.json 檔案：

{
  "enabled": true,
  "url": "http://您的服務器地址/webhook/receiver",
  "events": ["message", "login", "logout", "friend_request"],
  "retry_count": 3,
  "retry_interval": 5,
  "secret_key": "您的密鑰"
}

接收Webhook訊息的服務器需要處理POST請求，訊息格式為：

{
  "event_type": "message",
  "timestamp": 1656789012,
  "data": {
    // 事件相關數據
  },
  "signature": "訊息簽名"
}

Webhook測試客戶端：我們提供了一個開源的Webhook測試客戶端，幫助您快速測試和接收Webhook訊息：
- 項目地址：wechatpad-webhook-client
- 主要功能：
  - 接收和處理微信發送的webhook訊息
  - 支持配置熱加載、簽名驗證、重試機制
  - 完整的日誌記錄系統
  - 支持多種訊息類型處理
- 使用方法：詳見項目README，包含完整的安裝和配置說明

📖 WeChat 功能使用說明

WeChatPadPro 提供了豐富的 WeChat 功能控制命令，包括：

自動搶紅包功能：控制搶紅包、設置延遲時間、過濾測試紅包等
訊息防撤回：查看被對方撤回的訊息內容
好友管理：自動通過驗證、新增好友後自動回覆
群管理命令：踢人、拉黑、移出黑名單等操作
朋友圈互動：自動點讚朋友圈功能

👉 查看完整的 WeChat 功能使用說明

🗺️ 開發路線圖

🚀 未來版本計劃

💡 社區反饋

我們重視每一位用戶的建議！如果您有功能需求或改進建議，請：

📞 聯繫我們

如有任何問題或建議，歡迎通過以下方式聯繫我們：

GitHub Issues：提交問題
Telegram 群組：加入討論
Know Hub論壇：在線交流
知識星球：深度交流

感謝您的支持和鼓勵！
WeChatPadPro 團隊

使用指南與注意事項

⚠️ 重要提醒

新帳號使用建議

建議新號穩定掛機3天後再使用高風險API操作

請仔細閱讀下方關於風控章節的重要說明

登入注意事項

異地登入處理
- 必須設置同城市的Socks5代理
- 代理格式: socks5://用戶名:密碼@代理IP:代理端口
- 代理優先級: 同城市IP > 同省IP
- 家庭內網穿透socks5代理IP穩定性最佳
- 需要搭建內網穿透socks5代理可聯繫我們協助
推薦工具: frp
首次登入說明
- 可能出現立即掉線情況,重新掃碼登入2次後即可穩定
- 24小時內可能會再次掉線(見下圖),使用原API key重新登入即可
- 重新登入後一般可穩定使用3個月
- 3天後基本穩定,7天後更穩定
⚠️ 注意: 一個授權碼key僅限一個 WeChat 號使用,多帳號需生成多個授權碼

🛠️ 環境配置

基礎環境要求

MySQL (推薦5.7及以上版本)
- 資料庫: wechat_mmtls
- 用戶名: wechat_mmtls
- 密碼: 12345678
Redis
- 密碼: 12345678

對於MySQL 5.7以下版本,需提前使用wechat_mmtls.sql建立資料庫表

MySQL配置說明

如遇到以下錯誤:

MySQL 5.7版本可通過修改配置解決:

[mysqld]
innodb_file_format = Barracuda
innodb_file_per_table = 1
innodb_large_prefix = 1

安裝指南

MySQL綠色版安裝

適用於所有作業系統,下載地址: https://downloads.mysql.com/archives/community/

MySQL 5.7及以上版本:

# 隨機生成root密碼初始化
mysqld --initialize --console

# 不設置root密碼初始化
mysqld --initialize-insecure

MySQL 5.6及以下版本:

# 1. 使用mysql_install_db初始化資料目錄
mysql_install_db --datadir="/path/to/your/mysql/data"
# 2. 啟動MySQL服務
mysqld --console
# 3. 設置root密碼
mysqladmin -u root password "你的root密碼"
# 4. 驗證登入
mysql -u root -p

如果bin目錄沒有mysql_install_db,需要使用Perl環境執行scripts/mysql_install_db.pl:

Linux/Mac自帶Perl

Windows需下載Strawberry Perl

Windows安裝

下載對應版本MSI安裝包:

注意:

以上均為32位版本,最大支援4GB記憶體

64位版本請使用綠色版手動安裝

安裝時選擇"自定義安裝",僅安裝MySQL-Server

請記住設置的root密碼

Linux安裝

推薦使用寶塔面板進行安裝:

按提示選擇合適的MySQL版本
配置較低的伺服器建議使用低版本MySQL
MySQL 5.7以下版本需提前導入wechat_mmtls.sql

⚙️ 軟體配置

配置檔案說明

setting.json
- debug: 是否開啟debug日誌
- port: 服務端口號
- apiVersion: API版本(如/v849)
- ghWxid: 引流關注的公眾號wxid
- adminKey: 管理介面授權KEY
- redisConfig:
  - Port: Redis端口
  - Db: Redis資料庫號
  - Pass: Redis密碼
- mySqlConnectStr: MySQL連接字串
owner.json
```
{
  "wxid_xxx": 1
}
```
設置管理員wxid後可通過檔案傳輸助手使用管理命令

🚀 啟動流程

修改配置檔案
- 設置setting.json中的adminKey和資料庫連接資訊
- 在owner.json中新增管理員wxid
初始化資料庫(MySQL 5.7+)
- Linux: ./01_InitMySQL -passwd="root密碼"
- Windows: 01_InitMySQL.exe -passwd="root密碼"
啟動服務
- Linux: /opt/wechat/wechat_service >/opt/wechat/run.log 2>&1 &
- Windows: 雙擊wechat_service.exe
獲取AuthKey 訪問: http://127.0.0.1:8848/login/GenAuthKey2?key=ADMIN_KEY&count=1&days=365
登入操作
- 獲取二維碼(需配置本地代理)
- 監控二維碼狀態

🔒 關於風控

一、登入掉線問題

1. 掉線情況說明

新用戶首次登入 API 平台或通過 iPad 協議登入 WeChat，24 小時內首次登入必定掉線一次。掉線後使用 fwcid 調用二維碼掃碼登入介面，即可實現 3 個月持續在線。

2. 掉線原因分析

登入地異常：登入地與歷史記錄差異過大
混用組件：本地組件/ttuid切換、代理變動頻繁
頻繁登入/登出：60 秒內重複掃碼或獲取fwcid
裝置重裝或更換：更換裝置登入
長期離線：裝置連續兩天不活躍
多裝置並行：多台裝置同時登入且頻繁切換

3. 建議對策

使用固定裝置與IP網路
登入後保持活躍1-2天再進行高頻操作
避免頻繁更換裝置或重裝應用

二、介面風控問題

1. 高風控敏感操作

功能介面	延遲啟用時間	限制來源
獲取群二維碼	3 天	官方限制
發起群聊	1 天	官方限制
建立群聊	3 天	平台限制
新增好友	7 天	平台限制
自動新增好友	7 天	平台限制

2. 安全環境判定

登入後48小時內為非安全期
使用fwcid登入並保持活躍超過24小時後視為安全環境

三、風控等級與申訴處理

等級	表現形式	封禁時長	可否申訴	成功率
1級	操作過於頻繁	1天	否	-
2級	功能封鎖	7天	是	約30%
3級	限制登入	30天	是	約15%
4級	永久封鎖	永久	極難	<10%

四、防範建議彙總

登入與裝置管理
- 固定IP、固定裝置
- 新裝置登入後靜置24小時
操作行為管控
- 控制好友新增數、拉群次數
- 避免發送違規內容
內容合規與風險提示
- 使用內容審查工具過濾文案
- 禁用第三方外掛或工具模擬登入
提升帳號權重
- 完成WeChat實名認證
- 經常互動增加信任度

五、技術支援

如遇以下情況請聯繫技術支援：

大量帳號觸發風控
介面無回應/無報錯但操作失敗
接入長期自動化專案需穩定API支援
合規審核與企業授權申請協助

Name		Name	Last commit message	Last commit date
Latest commit History 51 Commits
.github		.github
.idea		.idea
assets		assets
deploy		deploy
mysql		mysql
public/js		public/js
redis		redis
static		static
win数据库		win数据库
.env		.env
.env.example		.env.example
.mailmap		.mailmap
README.md		README.md
README_zh.md		README_zh.md
WEBHOOK_CONFIG_DETAILED.md		WEBHOOK_CONFIG_DETAILED.md
WEBHOOK_GUIDE.md		WEBHOOK_GUIDE.md
WEBHOOK_README.md		WEBHOOK_README.md
WEBHOOK_SECURITY.md		WEBHOOK_SECURITY.md
WEBHOOK_TROUBLESHOOTING.md		WEBHOOK_TROUBLESHOOTING.md
img.png		img.png
img_1.png		img_1.png
img_2.png		img_2.png
img_3.png		img_3.png
img_4.png		img_4.png
img_5.png		img_5.png
img_6.png		img_6.png
photo_2025-05-13_21-48-40.jpg		photo_2025-05-13_21-48-40.jpg
qrcode_1747080638386.jpg		qrcode_1747080638386.jpg
run.bat		run.bat
run.sh		run.sh
sensitive_patterns.txt		sensitive_patterns.txt
usage_guide_for_old_users.md		usage_guide_for_old_users.md
version.txt		version.txt
webhook-client.py		webhook-client.py
webhook_config.json		webhook_config.json
wechat_mmtls.sql		wechat_mmtls.sql
wechatpadpro-linux-amd64-vios18.61-861		wechatpadpro-linux-amd64-vios18.61-861
微信功能使用说明.md		微信功能使用说明.md
微信登录安全验证码解决流程.md		微信登录安全验证码解决流程.md
微信登录验证码API使用指南.md		微信登录验证码API使用指南.md

1914049892/WeChatPadPro

Folders and files

Latest commit

History

Repository files navigation

WeChatPadPro

🚀 基於 WeChat Pad 協議的高級管理工具v860

📢 加入官方交流群

🌟 加入我們的官方交流群和論壇，獲取最新版本更新、技術支援和使用教程！

💰 贊助支持

您的支持是我們持續更新的動力

🌟 成為贊助者可獲得

🚀 立即行動

WeChat API & iPad 協議使用說明與風控防範教程（2025 年更新）

🚀 快速部署 (Docker)

1. 克隆項目

2. 配置環境變數

3. 啟動服務

4. 訪問服務

5. 常用命令

📋 快速開始

📋 專案介紹

🌟 主要特點

🎯 適用場景

📦 環境要求

📝 功能特性

🔐 微信登录验证码API功能 ⭐ 重点功能

1. 多种登录方式支持

2. 自动验证码处理

3. 实时状态检测

4. RabbitMQ消息队列支持

5. 多账号管理

6. 自动Token刷新

🔄 API接口列表

登录相关接口

状态检测接口

设备管理接口

🔹 基礎功能

💬 訊息收發

👥 好友管理

🔄 朋友圈互動

💲 WeChat 支付

🔖 小程式和名片分享

📇 通訊錄好友新增

⭐ WeChat 收藏

🏷️ 標籤管理

🔹 增強功能

📦 系統包下載

🚀 最新版本系統包

🖥️ 支持平台

📋 安裝說明

系統要求

安裝步驟

🔗 快速下載

🪟 Windows

🍎 macOS

🐧 Linux

📝 版本說明

🔄 更新日誌

🛠️ 開發資源

🔧 開發工具和資源

📚 API文檔

🎯 快速開始

🔍 常見問題

❓ 常見問題

🔧 故障排除

📊 項目統計

📈 下載統計

🔄 開發活躍度

👥 社區活躍度

📅 更新日誌 (CHANGELOG)

v1.1.0 (2025-07-27)

1. 连接管理优化

RabbitMQ和登录验证码更新说明

🔄 RabbitMQ优化更新

1. 连接管理优化

2. 错误处理改进

3. 性能优化

🔐 登录验证码流程更新

1. 新增自动验证码处理API

`AutoLoginVerifyCodeApi` - 自动处理验证码

`LoginVerifyCodeApi` - 手动验证码处理

Packages