PyWxDump命令大全：常用操作速查表

PyWxDump命令大全：常用操作速查表

【免费下载链接】PyWxDump 获取微信账号信息(昵称/账号/手机/邮箱/数据库密钥/wxid)；PC微信数据库读取、解密脚本；聊天记录查看工具；聊天记录导出为html(包含语音图片)。支持多账户信息获取，支持所有微信版本。 项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump

一、命令概览

PyWxDump是一款功能强大的微信数据处理工具，支持获取账号信息、解密数据库、查看聊天内容等核心操作。本文整理了其全部10+命令的参数说明与实战示例，帮助用户快速掌握各类场景下的操作技巧。

1.1 命令矩阵表

命令	功能描述	核心参数	适用场景	状态
info	获取微信账号信息	-vlp(偏移文件)、-s(保存路径)	密钥提取、账号信息获取	稳定
decrypt	解密微信数据库	-k(密钥)、-i(源路径)、-o(输出)	聊天内容解析前置步骤	稳定
dbshow	可视化查看聊天内容	-merge(合并库路径)、--online	本地/局域网聊天内容浏览	推荐
ui	启动图形界面	-p(端口)、--noOpenBrowser	新手友好型操作	推荐
api	启动API服务	-p(端口)、--debug	二次开发集成	稳定
bias	获取基址偏移	--mobile、--name、--account	版本适配与调试	高级用户
wx_path	获取微信文件夹路径	-r(数据库类型)、-id(wxid)	多账户数据定位	辅助功能
merge	合并数据库文件	-i(源文件列表)、-o(输出路径)	多设备数据整合	测试功能
export	导出聊天内容(HTML)	[已废弃]	建议使用dbshow替代	已废弃
all	一站式处理流程	[已废弃]	建议分步执行	已废弃

二、核心命令详解

2.1 信息获取命令 (info)

功能说明

提取当前登录微信的账号信息（昵称、手机号、数据库密钥等），支持保存为JSON文件。

参数解析

参数	类型	必须	描述	默认值
-vlp	字符串	否	微信版本偏移文件路径	内置WX_OFFS.json
-s	字符串	否	结果保存路径（JSON文件）	不保存

实战示例

# 基础用法：获取信息并打印
pywxdump info

# 高级用法：指定偏移文件并保存结果
pywxdump info -vlp ./custom_offsets.json -s ./wx_account_info.json

输出样例

{
  "wxid": "wxid_xxxxxx",
  "nickname": "测试账号",
  "mobile": "138****5678",
  "db_key": "A1B2C3D4E5F6A7B8",
  "db_path": "C:/Users/xxx/Documents/WeChat Files/wxid_xxxxxx"
}

2.2 数据库解密命令 (decrypt)

功能说明

使用获取的数据库密钥解密微信加密数据库文件（支持单个文件或目录批量处理）。

参数解析

参数	类型	必须	描述	默认值
-k	字符串	是	数据库解密密钥（16字节十六进制）	-
-i	字符串	是	加密数据库路径（文件或目录）	-
-o	字符串	否	解密后文件输出目录	./decrypted

实战示例

# 解密单个数据库
pywxdump decrypt -k A1B2C3D4E5F6A7B8 -i Msg.db -o ./decrypted_db

# 批量解密目录下所有数据库
pywxdump decrypt -k A1B2C3D4E5F6A7B8 -i ./encrypted_dbs -o ./all_decrypted

注意事项

• 密钥必须为16字节（32字符）的十六进制字符串
• 输出目录不存在时会自动创建
• 支持解密的数据库类型：MSG.db、MediaMSG.db、MicroMsg.db等

2.3 聊天内容查看命令 (dbshow)

功能说明

启动本地Web服务，通过浏览器可视化查看解密后的聊天内容（支持文字、图片、语音等多媒体内容）。

参数解析

参数	类型	必须	描述	默认值
-merge	字符串	是	合并后的数据库文件路径	-
-wid	字符串	否	微信文件夹路径（用于加载图片）	自动检测
--online	标志	否	允许局域网访问	仅本地访问
--myid	字符串	否	本人微信ID（用于消息区分）	自动提取

实战示例

# 基础用法：本地查看合并数据库
pywxdump dbshow -merge ./merged_db/merge_all.db

# 高级用法：指定微信路径并允许局域网访问
pywxdump dbshow -merge ./merge_all.db -wid "C:/WeChat Files/wxid_xxx" --online

使用流程

2.4 图形界面命令 (ui)

功能说明

启动可视化操作界面，适合新手用户完成数据库解密、内容查看等一站式操作。

参数解析

参数	类型	必须	描述	默认值
-p	整数	否	Web服务端口号	5000
--online	标志	否	允许局域网访问	仅本地访问
--debug	标志	否	开启调试模式	关闭
--noOpenBrowser	标志	否	禁止自动打开浏览器	自动打开

实战示例

# 默认启动
pywxdump ui

# 指定端口并禁止自动打开浏览器
pywxdump ui -p 8080 --noOpenBrowser

界面功能区

三、高级操作指南

3.1 多账户数据处理流程

3.2 命令组合示例

完整数据提取流程

# 1. 获取微信信息（含密钥）
pywxdump info -s account_info.json

# 2. 提取密钥（假设JSON中密钥字段为db_key）
KEY=$(jq -r '.db_key' account_info.json)

# 3. 解密数据库
pywxdump decrypt -k $KEY -i "$(jq -r '.db_path' account_info.json)/Msg.db" -o ./decrypted

# 4. 合并数据库
pywxdump merge -i ./decrypted/Msg.db,./decrypted/MediaMSG.db -o ./merged.db

# 5. 查看聊天内容
pywxdump dbshow -merge ./merged.db

3.3 常见问题解决方案

问题现象	可能原因	解决方法
解密失败："密钥错误"	密钥与数据库不匹配	重新获取微信信息，确保使用正确账户的密钥
dbshow无法加载图片	微信路径未正确设置	使用-wid参数指定正确的"WeChat Files"路径
命令无响应	微信未运行	启动微信并登录目标账号
merge命令提示"数据库损坏"	源数据库版本不兼容	确保所有合并文件来自相同微信版本

四、命令速查卡片

4.1 基础命令卡片

📌 信息获取
pywxdump info [-vlp 偏移文件] [-s 保存路径]

🔑 数据库解密
pywxdump decrypt -k 密钥 -i 源路径 [-o 输出路径]

👁️ 内容查看
pywxdump dbshow -merge 合并库路径 [--online]

🖥️ 图形界面
pywxdump ui [-p 端口] [--noOpenBrowser]

4.2 高级命令卡片

🔧 基址偏移获取
pywxdump bias --mobile 手机号 --name 昵称 --account 微信号

📂 数据库合并
pywxdump merge -i "db1.db,db2.db" -o 输出路径

🌐 API服务
pywxdump api -p 端口 [--online] [--debug]

五、使用注意事项

1. 运行环境

   • 需安装Python 3.8+
   • Windows系统推荐使用管理员权限运行
   • 微信需保持登录状态

2. 数据安全

   • 解密后的数据库包含个人信息，建议加密存储
   • 请勿将密钥或数据库文件分享给他人

3. 版本兼容性

   • 定期更新偏移文件(WX_OFFS.json)以支持最新微信版本
   • 重大版本更新后建议重新获取基址偏移

4. 性能优化

   • 合并大型数据库时建议关闭其他应用
   • 远程访问时确保网络带宽充足（特别是多媒体内容）

六、学习资源

1. 官方文档：项目内置帮助命令 pywxdump -h
2. 常见问题：doc/FAQ.md
3. 版本更新：doc/CHANGELOG.md
4. 二次开发：通过api命令集成自定义功能

---

收藏本文档，关注项目更新，获取更多微信数据处理技巧！ 下期预告：《PyWxDump数据库结构深度解析》

【免费下载链接】PyWxDump 获取微信账号信息(昵称/账号/手机/邮箱/数据库密钥/wxid)；PC微信数据库读取、解密脚本；聊天记录查看工具；聊天记录导出为html(包含语音图片)。支持多账户信息获取，支持所有微信版本。 项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump