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

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

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

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

🌟 成為贊助者可獲得

• ✅ 優先技術支援 - 獲得開發者直接回應

• ✅ 新功能優先體驗 - 提前體驗最新功能

• ✅ 客製化需求支援 - 您的需求將被優先考慮

• ✅ 企業級多帳號解決方案 - 適合商業用戶

• ✅ 高級API支援 - 更多高級介面調用能力

  
  

🚀 立即行動

💳 安全支付 · ⚡ 即時開通

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

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

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

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

編輯 .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

docker-compose up -d

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

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

# 查看服務狀態
docker-compose ps

# 查看日誌
docker-compose logs -f

# 停止服務
docker-compose down

# 重啟服務
docker-compose restart

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

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

1. 📚 仔細閱讀風控指南，了解帳號安全事項
2. 🐳 選擇部署方式：

• Docker快速部署（推薦：簡單快捷）
• 傳統部署（適合需要自定義配置的用戶）

3. 🔒 遵循登入注意事項進行首次登入
4. 🧪 參考測試指南進行功能測試

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

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

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

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

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

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

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

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

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

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

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

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

• 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 - 短信登录

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

🚀 最新版本系統包

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

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

1. 下載：根據您的操作系統和CPU架構，從上表中選擇對應的壓縮包下載
2. 解壓：將下載的壓縮包解壓到您選擇的目錄
3. 配置：

• 修改 config.json 檔案，設置必要的參數
• 配置 webhook_config.json 檔案，設置Webhook相關參數
• 設置環境變數（可選）

4. 運行：

• Windows: 雙擊 wechatpadpro.exe 或在命令行中運行
• Linux/macOS/BSD: 執行 ./wechatpadpro

🪟 Windows

🍎 macOS

🐧 Linux

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

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

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

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

📈 下載統計

🔄 開發活躍度

👥 社區活躍度

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

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

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

POST /api/login/verify/auto

功能特点：

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

POST /api/login/verify/manual

功能特点：

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

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

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

返回状态说明：

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

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

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

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

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

• 訊息推送機制優化

  • 實現全局訊息去重緩存，避免重複推送同一訊息
  • 新增訊息緩存過期機制，默認1小時過期
  • 優化歷史訊息同步策略，減少每次獲取的訊息數量（從50條減少到20條）
  • 增加同步間隔（從5秒增加到15秒），降低服務器負載

• 訊息處理效率提升

  • 新增訊息批量處理機制，單批次最多處理20條訊息
  • 實現訊息優先級排序，實時訊息優先於歷史訊息
  • 添加訊息處理鎖機制，確保訊息處理的原子性
  • 優化隊列處理邏輯，減少訊息處理延遲

• 配置管理接口

  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
  • 支持是否接收自己發送的訊息
  • 提供詳細的推送統計信息（成功數、失敗數、最後推送時間等）

• 安全性和可靠性

  • 支持設置密鑰進行訊息簽名
  • 實現指數退避重試機制
  • 提供訊息推送狀態實時反饋
  • 支持配置超時和重試參數

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

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

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

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

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

1. 下載：根據您的操作系統和CPU架構，從上表中選擇對應的壓縮包下載。
2. 解壓：將下載的壓縮包解壓到您選擇的目錄。
3. 配置：

• 修改 config.json 檔案，設置必要的參數
• 配置 webhook_config.json 檔案，設置Webhook相關參數
• 設置環境變數（可選）：

  # Linux/macOS
  export ADMIN_KEY="您的管理密鑰"
  
  # Windows
  $env:ADMIN_KEY="您的管理密鑰"
  

4. 運行：

• Windows: 雙擊 wechatpadpro.exe 或在命令行中運行
• Linux/macOS/BSD: 執行 ./wechatpadpro

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

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

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

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

1. 編輯 webhook_config.json 檔案：

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

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

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

3. Webhook測試客戶端： 我們提供了一個開源的Webhook測試客戶端，幫助您快速測試和接收Webhook訊息：

• 項目地址：wechatpad-webhook-client
• 主要功能：
  • 接收和處理微信發送的webhook訊息
  • 支持配置熱加載、簽名驗證、重試機制
  • 完整的日誌記錄系統
  • 支持多種訊息類型處理
• 使用方法：詳見項目README，包含完整的安裝和配置說明

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

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

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

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

• 📝 提交Issue
• 💬 加入討論群
• ⭐ 給我們Star

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

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

新帳號使用建議

• 建議新號穩定掛機3天後再使用高風險API操作
• 請仔細閱讀下方關於風控章節的重要說明

1. 異地登入處理

• 必須設置同城市的Socks5代理
• 代理格式: socks5://用戶名:密碼@代理IP:代理端口
• 代理優先級: 同城市IP > 同省IP
• 家庭內網穿透socks5代理IP穩定性最佳
• 需要搭建內網穿透socks5代理可聯繫我們協助

推薦工具: frp

2. 首次登入說明

• 可能出現立即掉線情況,重新掃碼登入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 5.7版本可通過修改配置解決:

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

適用於所有作業系統,下載地址: 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

1. 下載對應版本MSI安裝包:

• MySQL 5.6.51
• MySQL 5.5.60
• MySQL 5.7.44
• MySQL 8.0.39

注意:

• 以上均為32位版本,最大支援4GB記憶體
• 64位版本請使用綠色版手動安裝
• 安裝時選擇"自定義安裝",僅安裝MySQL-Server
• 請記住設置的root密碼

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

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

1. setting.json

• debug: 是否開啟debug日誌
• port: 服務端口號
• apiVersion: API版本(如/v849)
• ghWxid: 引流關注的公眾號wxid
• adminKey: 管理介面授權KEY
• redisConfig:
  • Port: Redis端口
  • Db: Redis資料庫號
  • Pass: Redis密碼
• mySqlConnectStr: MySQL連接字串

2. owner.json

   {
     "wxid_xxx": 1
   }

   設置管理員wxid後可通過檔案傳輸助手使用管理命令

1. 修改配置檔案

• 設置setting.json中的adminKey和資料庫連接資訊
• 在owner.json中新增管理員wxid

2. 初始化資料庫(MySQL 5.7+)

• Linux: ./01_InitMySQL -passwd="root密碼"
• Windows: 01_InitMySQL.exe -passwd="root密碼"

3. 啟動服務

• Linux: /opt/wechat/wechat_service >/opt/wechat/run.log 2>&1 &
• Windows: 雙擊wechat_service.exe

4. 獲取AuthKey 訪問: http://127.0.0.1:8848/login/GenAuthKey2?key=ADMIN_KEY&count=1&days=365

5. 登入操作

• 獲取二維碼(需配置本地代理)
• 監控二維碼狀態

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

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

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

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

• 登入與裝置管理

  • 固定IP、固定裝置
  • 新裝置登入後靜置24小時

• 操作行為管控

  • 控制好友新增數、拉群次數
  • 避免發送違規內容

• 內容合規與風險提示

  • 使用內容審查工具過濾文案
  • 禁用第三方外掛或工具模擬登入

• 提升帳號權重

  • 完成WeChat實名認證
  • 經常互動增加信任度

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

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