Skip to content

feat(strategies): 新增 Linux 平台的实验性支持(基于 v5.1.0 重新提交) - #37

Closed
yuanphoenix wants to merge 2 commits into
ImUpXuu:mainfrom
yuanphoenix:feat/linux-on-v5.1
Closed

yuanphoenix wants to merge 2 commits into
ImUpXuu:mainfrom
yuanphoenix:feat/linux-on-v5.1

Conversation

@yuanphoenix

@yuanphoenix yuanphoenix commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

与 #35 的关系

上一版 #35 因上游 main 被 git filter-repo 重写、强推而自动关闭(@Wong0728 已说明)。本 PR 是同一份改动的重新提交:基于 v5.1.0(d7843f8) 重放,保留了原提交的完整说明,并修掉了上一版自查发现的三处文档与代码不一致(见下)。旧分支 feat/linux-key-extraction 可删除。

这个 PR 做了什么

给 Linux 补上"从运行中的微信进程取 WCDB passphrase"的策略(linux_hook)。Linux 侧此前只有 keystore_source / mmkv 两条离线读文件的路子,而 Linux 微信的 db_storage/MMKV/ 里没有 Windows 那种 f<hex>tinfo.mmkv,实测命中 0;外部 ptrace tracer 在 4.1.2x 上会被微信内置 crashpad 撞死。

改动类型

  • 🐛 Bug 修复
  • ✨ 新功能
  • 📝 文档
  • ♻ 重构(不改变外部行为)
  • ⚡ 性能优化
  • 🔧 构建 / CI / 发布流程
  • 🖥 平台支持(新增 Linux;模版此项只写了 Windows / macOS)

改动清单

新增

  • siwx/linux_hook/elfhook.py — 在 .rodata 找 com.Tencent.WCDB.Config.Cipher 锚点,顺 RIP 相对 lea 交叉引用定位 cipher-config 消费函数偏移(算法与 boujuan/extract-wechat-messages-linux 同源,MIT,已在模块注释注明出处)
  • siwx/linux_hook/wxhook.c — 进程内 shim 源码,运行时由策略用系统 cc 编译(不新增 Python 依赖)
  • siwx/strategies/linux_hook.py — 策略入口:定位二进制 → 算偏移 → 构建 shim → 注入 → dde-am 拉起微信 → 收候选 → PBKDF2-SHA512(256000) 派生 → page-1 HMAC 校验 → finally 精确还原
  • LINUX_SUPPORT.md — 方案说明、前置条件、已知限制
  • tests/test_linux_hook.py — 17 条回归用例(见下)

修改(打通 Linux 入口,只有策略还不够)

  • siwx/cli.py — 平台闸门放行 Linux(否则 run.py 直接打印"仅支持 Windows 和 macOS")
  • siwx/discover.py — 补 Linux 数据根(~/Documents/xwechat_files,含 XDG 文档目录本地化的读取)与进程名(wechat/weixin/wechat-bin)
  • siwx/extract.py — 密钥库保存提示按平台区分(非 Windows 是明文 JSON 0600,原来一律报"DPAPI 加密密钥库")
  • siwx/strategies/__init__.py — 平台条件注册,并计入 _PROCESS_DEPENDENT
  • README.md — 平台表与 Linux 说明

技术要点

为什么不用 ptrace。 微信内置 Chromium crashpad,崩溃采样时会自己 scoped_ptrace_attach。一个进程只能有一个 tracer,外部 tracer 抢先附加后 crashpad 附加失败直接 abort():

[ERROR:scoped_ptrace_attach.cc(27)] ptrace: Operation not permitted (1)

这不是权限问题(kernel.yama.ptrace_scope=0 也一样),也不是断点打歪——只 attach 不打断点时进程能活,一旦保持被 trace 就死。改为把断点打在微信进程内,全程没有 ptrace。

实现过程中修掉的三个硬 bug(都由 minidump 定位):

  1. SIGTRAP 处理器被顶掉 —— 微信 crashpad 一安装自己的处理器就把我们的覆盖掉,INT3 落到对方手里被当成致命信号(minidump 实测 4/4,RIP 精确等于 bp+1)。现在真正导出 sigaction / __libc_sigaction / __sigaction,并加 50ms 看门狗复核:被顶掉就重装,复核三次仍装不回来就主动拆断点——绝不留下没人接的 INT3。
  2. 信号处理器里的非异步信号安全调用 —— snprintf 会碰 malloc/locale 锁;野指针 memcpy 直接打死进程。改成手写十六进制 + process_vm_readv 安全读取(纯 syscall,读不了返回错误而不是崩)。
  3. 单步重布点的竞态 —— 早期"复原字节 → 置 TF 单步 → 下一个 SIGTRAP 里重新布点"这段窗口里其它线程会执行同一地址,实测捕获后必崩。改成一次性布点:命中、记录、复原字节、RIP 拨回断点让原指令照常执行,随即拆断点不再重布。

注入方式:不需要 root。 桌面环境(DDE / UOS / GNOME)经 systemd 用户管理器拉起微信,父进程是 systemd,直接给子进程设 LD_PRELOAD 会被丢掉。改用 systemctl --user set-environment 写用户管理器环境,结束后精确还原(原有值恢复、无则删除);无 systemd 用户会话时退化为带环境变量直接执行二进制。全程不碰 /etc,不需要 root。

候选不猜布局。 命中后按 hit-raw / hit-flat0 / hit-flat8 三种入参布局各读 32 字节入日志,由 Python 侧逐个走 PBKDF2 + page-1 HMAC 校验,校验不通过就不入库——不靠"猜对某个固定偏移",换构建也不会静默 0 命中。

测试

新增 tests/test_linux_hook.py(17 条,上一次提交只有手工实测,没有自动化闸门):

  • 注册与闸门:Linux 上必须进 STRATEGY_REGISTRY 且计入 _PROCESS_DEPENDENT;非 Linux 不得注册;模块在任何平台都能 import;非 x86-64 直接跳过
  • 候选解析:三种布局的 32 字节候选都要抓到,短数据与杂行必须忽略
  • 派生校验:用真实 SQLCipher page-1 HMAC 口径造夹具,正确 passphrase 派生全部密钥并标 attrib=linux_hook;错误 passphrase 0 命中且不污染 key_map
  • ELF 定位:非 ELF、无锚点二进制抛 HookNotFoundError(不许崩);本机有微信时真实二进制必须算得出偏移
  • shim 构建:有系统 cc/gcc 时现场编译 wxhook.c 成功,并校验 sigaction / __libc_sigaction / __sigaction 真导出
  • KDF 参数钉死 256000 / sha512 / 32,且与 macos_lldb 策略同源

本机结果(UOS/Deepin,Python 3.12):

tests/ 全量:733 passed, 11 skipped
tests/test_linux_hook.py:16 passed, 1 skipped(非 Linux 用例按平台 skip)

真机端到端(UOS/Deepin,微信 4.1.13.23,构建 4067695895,python run.py keys extract):

  • hook 偏移 0x87ac370,shim 经 systemctl --user set-environment 注入——/proc/<pid>/maps 里能看到 wxhook.so,证明注入链路通
  • 当前登录账号捕获 passphrase 后 25/25 个库 page-1 HMAC 校验通过(含 sns.db、message_0..4、biz_message_0、contact.db),attrib 全部记为 linux_hook,单次约 19s
  • 重新提取出的密钥与已有密钥库 50/50 条目完全一致(同 salt、同密钥值),说明不是偶然命中
  • 结束后 systemd 用户环境已还原(无 LD_PRELOAD / WXS_HOOK_LOG 残留),临时 shim 与日志已清理
  • 再用新提取的密钥跑 decrypt:25/25 成功,抽查 contact 6827 行、session 525 行、sns 829 行,message_0 前 200 个会话表共 10 万余条消息可读

相对 #35 的修正(文档自查)

  • README.md 曾写"注入走 /etc/ld.so.preload、需要一次性 root"——与实现(systemctl --user set-environment,不需要 root)和 LINUX_SUPPORT.md 都矛盾,已改为与代码一致
  • LINUX_SUPPORT.md / 策略 docstring 里的"置 TF 单步后重新布点"是早期实现,已按最终的一次性布点重写
  • LINUX_SUPPORT.md 末尾一条重复说明合并

已知限制

  • 仅 x86-64;hook 偏移与微信构建绑定(升级后 find_hook_offset() 自动重算,失败明确报错,不静默 0 命中)
  • 需要系统编译器(cc/gcc)现场构建 shim
  • 注入需要重启微信,且需扫码登录一次
  • 官方 deb 布局下直启二进制会 SIGABRT,策略优先走 dde-am com.tencent.wechat
  • 一次登录只覆盖当前账号:桌面上有三个账号目录时,当前登录账号 25/25 命中,另外两个(各 16 库)0/16——它们不在登录态,没有可抓的 passphrase。换账号登录后重跑即可,已写进文档
  • 本 PR 不含 Linux 安装包/发布产物,只有源码运行路径

检查项

  • 遵循 CONTRIBUTING.md 的提交与文档约定
  • 新增功能附带测试,全量测试通过
  • 未引入新的 Python 依赖(shim 用系统编译器,KDF 用标准库 hashlib)
  • 隐私红线:测试夹具与文档示例均为合成数据,不含真实账号/uin

微信 4.1.2x 在 Linux 上无法用外部 ptrace tracer 抓 passphrase:内置 Chromium
crashpad 会自己 scoped_ptrace_attach 写 minidump,一个进程只能有一个 tracer,
外部 tracer 抢先附加后 crashpad 附加失败直接 abort():

    [ERROR:scoped_ptrace_attach.cc(27)] ptrace: Operation not permitted (1)

这不是权限问题(kernel.yama.ptrace_scope=0 也一样),也不是断点打歪——只
attach 不打断点时进程能活,一旦保持被 trace 就死。改为把断点打在微信进程内,
全程没有 ptrace。

## 新增

* `siwx/linux_hook/elfhook.py` —— 在 .rodata 里定位
  com.Tencent.WCDB.Config.Cipher 锚点,顺 RIP 相对 lea 交叉引用找到
  cipher-config 消费函数偏移(与 wxextract 的算法同源,MIT,已在模块注释注明)
* `siwx/linux_hook/wxhook.c` —— 进程内 shim 源码,运行时由策略用系统 cc 编译
* `siwx/strategies/linux_hook.py` —— 策略入口:定位二进制 → 算偏移 → 构建
  shim → 注入 → dde-am 拉起微信 → 收候选 → PBKDF2-SHA512(256000) 派生 +
  page-1 HMAC 校验 → finally 精确还原环境
* `LINUX_SUPPORT.md` —— 方案说明与前置条件

## 打通 Linux 入口

只有策略还不够,CLI 与数据发现此前都对 Linux 关门:

* `siwx/cli.py` —— 平台闸门放行 Linux(否则 run.py 直接 "仅支持 Windows 和 macOS")
* `siwx/discover.py` —— 补 Linux 数据根(~/Documents/xwechat_files,含 XDG 文档
  目录本地化的读取)与进程名(wechat/weixin/wechat-bin)
* `siwx/strategies/__init__.py` —— 平台条件注册,并计入 _PROCESS_DEPENDENT

## 注入方式:不需要 root

桌面环境经 systemd 用户管理器拉起微信,父进程是 systemd,直接给子进程设
LD_PRELOAD 会被丢掉。改用 `systemctl --user set-environment` 写用户管理器
环境,结束后精确还原(原有值恢复、无则删除)。无 systemd 用户会话时退化为
带环境变量直接执行二进制。全程不碰 /etc、不需要 root。

## 实现过程中修掉的三个硬 bug(都由 minidump 定位)

1. **SIGTRAP 处理器被顶掉**:shim 里包 sigaction 的那层原本是 `static` 函数,
   符号从未导出,等于没有保护。微信的 crashpad 一安装自己的 SIGTRAP 处理器
   就把我们的覆盖掉,INT3 落到对方手里被当成致命信号,进程每次都在 `bp+1`
   处以 SIGTRAP 死亡(minidump 实测 4/4,RIP 精确等于 bp+1)。
   现在真正导出 `sigaction`、`__libc_sigaction`、`__sigaction`,并加 50ms
   看门狗复核:被顶掉就重装,复核三次仍装不回来就主动拆断点——绝不留下没人
   接的 INT3。
2. **信号处理器里的非异步信号安全调用**:原来用 `snprintf` 拼日志、用范围判断
   后直接 `memcpy` 读目标结构体。printf 族会碰 malloc/locale 锁,中断到持锁
   线程就污染堆;野指针 memcpy 直接打死进程。改成手写十六进制 +
   `process_vm_readv` 安全读取(纯 syscall,读不了返回错误而不是崩溃)。
3. **单步重布点的竞态**:早期在命中后"复原原字节 → 置 TF 单步 → 下一个
   SIGTRAP 里重新布点"。这段窗口里其它线程会执行同一地址,实测捕获后必崩
   (SIGSEGV @ exe+0x87B20C4,两次不同构建同一偏移)。改成**一次性布点**:
   命中、记录、复原字节、把 RIP 拨回断点让原指令照常执行,随即拆断点不再重布。
   一次命中就够(实测同一函数被调用多次,值完全相同)。改后连续观测 4 分钟
   微信无崩溃、minidump 计数不再增长。

## 约束与安全

* 仅 Linux x86-64;非 Linux 平台不注册该策略,Windows/macOS 路径零改动
* shim 构造函数第一件事校验 /proc/self/exe,非目标微信进程直接返回
* 不新增 Python 依赖;shim 现场编译,失败时明确报错而非静默 0 命中
* 校验不过的 passphrase 一律不入库

## 实测

UOS/Deepin + 微信 4.1.13.23(4067695895),25 个数据库,用真实入口
`run.py keys extract`(空密钥库,非手工脚本):

    已通过 systemctl --user 注入 shim
    已通过 dde-am 拉起微信
    捕获 1 个候选,开始校验
    候选 <32 字节>… 命中,派生 25 个密钥
    已还原 systemd 用户环境
    密钥 25/25 已验证 (14533 ms)

* 25/25 page-1 HMAC 通过(含 sns.db、message_0..4、biz_message_0、contact.db)
* 无 root、无 ptrace;捕获后连续运行 4 分钟无崩溃
* 解密产物 247 MB,正文可正常读取

## 重新提交到 v5.1.0 基线

上一版 PR #35 因上游 `main` 被 git filter-repo 重写而自动关闭,本提交基于
v5.1.0(d7843f8)重放,`README.md` 的平台表与徽章冲突已按新基线合并。

顺带修掉上一版的三处文档与代码不一致(自查发现,不影响功能):

* `README.md` 声称注入走 `/etc/ld.so.preload` 且「需要一次性 root」——实际代码
  走 `systemctl --user set-environment`,全程不需要 root。文档改为与实现一致。
* `LINUX_SUPPORT.md` / 策略 docstring 里的「置 TF 单步后重新布点」是早期实现,
  最终代码是**一次性布点**(命中即复原字节、RIP 拨回、拆断点);单步重布实测
  与其它线程执行同一地址竞态必崩。文档按最终实现重写。
* `LINUX_SUPPORT.md` 末尾一条重复说明合并。
上一版 PR 只有手工实测,没有自动化闸门。新增 tests/test_linux_hook.py:

* 注册与闸门:Linux 上必须进 STRATEGY_REGISTRY 且计入 _PROCESS_DEPENDENT;
  非 Linux 不得注册;模块在任何平台都能 import;非 x86-64 直接跳过。
* 候选解析:shim 的 hit-raw / hit-flat0 / hit-flat8 三种布局都要抓到 32 字节
  候选,短数据与杂行必须忽略。
* 派生校验:用真实 SQLCipher page-1 HMAC 口径造夹具,正确 passphrase 派生全部
  密钥并标 attrib=linux_hook;错误 passphrase 0 命中且不污染 key_map。
* ELF 定位:非 ELF、无锚点二进制抛 HookNotFoundError(不许崩);本机有微信时
  真实二进制必须算得出偏移(偏移与构建绑定,不写死数值)。
* shim 构建:有系统 cc/gcc 时现场编译 wxhook.c 成功,并校验 sigaction /
  __libc_sigaction / __sigaction 真导出(漏导出 = crashpad 一装处理器断点变
  致命信号)。
* KDF 参数钉死 256000 / sha512 / 32,且与 macos_lldb 策略同源,防止两条链路
  各写一份不同的值。

本机(UOS/Deepin + 微信 4.1.13.23)实测:17 条全过(1 条非 Linux 用例按平台 skip),
全量 733 passed / 11 skipped。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant