📋 專案介紹 • 📝 功能特性 • 📦 系統包下載 • 📅 更新日誌 • 🚀 Docker部署 • 📖 使用說明 • 🛡️ 風控指南 • 💰 贊助支持
🌟 每一份贊助都是對我們最大的鼓勵 🌟
💳 安全支付 · ⚡ 即時開通
💡 提示: 完成贊助後,請保留交易號並聯繫我們獲取贊助者特權
本教程旨在協助開發者全面了解 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 部署是最簡單快捷的方式,適合大多數用戶。如果您需要更多自定義配置,請參考下方的完整環境配置。
在開始使用本專案之前,請務必:
⚠️ 特別提醒:新帳號請務必遵循新帳號使用建議,避免觸發風控!
WeChatPadPro 是一個功能強大的 WeChat 管理工具,基於 WeChat Pad 協議開發。本專案致力於提供穩定、高效的 WeChat 自動化解決方案,支援多帳號管理、訊息處理、自動化任務等功能。
WeChatPadPro 是基於 WeChat Pad 協議的高級 WeChat 管理工具,支援以下功能:
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 - 短信登录
|
| 操作系統 | 支持的架構 | 檔案名 |
|---|---|---|
| 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 |
config.json 檔案,設置必要的參數webhook_config.json 檔案,設置Webhook相關參數wechatpadpro.exe 或在命令行中運行./wechatpadpro詳細的更新日誌請查看:GitHub Releases
| 資源 | 鏈接 | 說明 |
|---|---|---|
| Swagger UI | 在線API文檔 | 完整的API接口文檔 |
| Postman集合 | 下載集合 | 可直接導入Postman |
| API測試工具 | ApiPOST | 推薦的API測試工具 |
| 在線論壇 | Know Hub論壇 | 技術交流、問題討論、經驗分享 |
| 教程 | 鏈接 | 難度 |
|---|---|---|
| 5分鐘快速上手 | 快速開始指南 | ⭐ |
| Docker部署教程 | Docker部署 | ⭐⭐ |
| API使用示例 | API示例代碼 | ⭐⭐ |
| 高級功能教程 | 高級功能指南 | ⭐⭐⭐ |
POST /api/login/verify/auto
功能特点:
POST /api/login/verify/manual
功能特点:
# 获取登录二维码
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 - 需要验证码,返回ticketcode: 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
}
db.GetTicketForKey(uuid)db.GetCheckStatusCache(uuid).TicketuserInfo.Ticket訊息推送機制優化
訊息處理效率提升
配置管理接口
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連通性
配置功能特性
安全性和可靠性
查看所有版本發布 - 獲取最新版本下載和更新說明
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 |
config.json 檔案,設置必要的參數webhook_config.json 檔案,設置Webhook相關參數# Linux/macOS export ADMIN_KEY="您的管理密鑰" # Windows $env:ADMIN_KEY="您的管理密鑰"
wechatpadpro.exe 或在命令行中運行./wechatpadproWeChatPadPro 支持發送多種類型的檔案,包括圖片、視頻、文檔等。
POST /api/v1/message/sendFile Content-Type: multipart/form-data { "toUserName": "接收者微信ID", "filePath": "本地檔案路徑", // 與fileData二選一 "fileData": "base64編碼的檔案數據", // 與filePath二選一 "fileName": "檔案名稱", "fileType": "檔案類型" // 可選值: image, video, file }
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": "您的密鑰"
}
{
"event_type": "message",
"timestamp": 1656789012,
"data": {
// 事件相關數據
},
"signature": "訊息簽名"
}
WeChatPadPro 提供了豐富的 WeChat 功能控制命令,包括:
我們重視每一位用戶的建議!如果您有功能需求或改進建議,請:
如有任何問題或建議,歡迎通過以下方式聯繫我們:
感謝您的支持和鼓勵!
WeChatPadPro 團隊
新帳號使用建議
- 建議新號穩定掛機3天後再使用高風險API操作
- 請仔細閱讀下方關於風控章節的重要說明
異地登入處理
socks5://用戶名:密碼@代理IP:代理端口推薦工具: frp
首次登入說明
key重新登入即可⚠️ 注意: 一個授權碼
key僅限一個 WeChat 號使用,多帳號需生成多個授權碼

wechat_mmtlswechat_mmtls1234567812345678對於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
注意:
- 以上均為32位版本,最大支援4GB記憶體
- 64位版本請使用綠色版手動安裝
- 安裝時選擇"自定義安裝",僅安裝MySQL-Server
- 請記住設置的root密碼

推薦使用寶塔面板進行安裝:
setting.json
owner.json
{
"wxid_xxx": 1
}
設置管理員wxid後可通過檔案傳輸助手使用管理命令
修改配置檔案
初始化資料庫(MySQL 5.7+)
./01_InitMySQL -passwd="root密碼"01_InitMySQL.exe -passwd="root密碼"啟動服務
/opt/wechat/wechat_service >/opt/wechat/run.log 2>&1 &wechat_service.exe獲取AuthKey
訪問: http://127.0.0.1:8848/login/GenAuthKey2?key=ADMIN_KEY&count=1&days=365
登入操作
新用戶首次登入 API 平台或通過 iPad 協議登入 WeChat,24 小時內首次登入必定掉線一次。掉線後使用 fwcid 調用二維碼掃碼登入介面,即可實現 3 個月持續在線。
ttuid切換、代理變動頻繁fwcid| 功能介面 | 延遲啟用時間 | 限制來源 |
|---|---|---|
| 獲取群二維碼 | 3 天 | 官方限制 |
| 發起群聊 | 1 天 | 官方限制 |
| 建立群聊 | 3 天 | 平台限制 |
| 新增好友 | 7 天 | 平台限制 |
| 自動新增好友 | 7 天 | 平台限制 |
fwcid登入並保持活躍超過24小時後視為安全環境| 等級 | 表現形式 | 封禁時長 | 可否申訴 | 成功率 |
|---|---|---|---|---|
| 1級 | 操作過於頻繁 | 1天 | 否 | - |
| 2級 | 功能封鎖 | 7天 | 是 | 約30% |
| 3級 | 限制登入 | 30天 | 是 | 約15% |
| 4級 | 永久封鎖 | 永久 | 極難 | <10% |
登入與裝置管理
操作行為管控
內容合規與風險提示
提升帳號權重
如遇以下情況請聯繫技術支援: