Skip to content

feat(strategies): Linux 进程内 INT3 钩子密钥提取(基于 v5.1.0) - #38

Merged
Wong0728 merged 5 commits into
ImUpXuu:mainfrom
yuanphoenix:feat/linux-on-v5.1
Oct 25, 2026
Merged

Wong0728 merged 5 commits into
ImUpXuu:mainfrom
yuanphoenix:feat/linux-on-v5.1

Conversation

@yuanphoenix

Copy link
Copy Markdown
Contributor

这个 PR 做什么

Linux 平台的密钥提取:全程无 ptrace、不需要 root,在微信进程内打一次性 INT3 断点抓 WCDB passphrase,再用 PBKDF2-SHA512(256000) 派生每库密钥,并逐库做 page-1 HMAC 校验后才入库。

为什么不用 ptrace

微信 4.1.2x 内置 Chromium crashpad 自己会 scoped_ptrace_attach;一个进程只能有一个 tracer,外部抢先附加后 crashpad 附加失败直接 abort()(SIGABRT)。把 kernel.yama.ptrace_scope 设成 0 也一样;也不是断点打歪——只 attach 不打断点时进程能活,一旦保持被 trace 就死。

实现要点

  1. ELF 定位(siwx/linux_hook/elfhook.py):.rodata 里找 com.Tencent.WCDB.Config.Cipher 锚点,顺 RIP 相对 lea 交叉引用定位 cipher-config 消费函数,得到相对镜像基址的偏移(本机微信 4.1.13.23 为 0x87ac370)。定位失败抛 HookNotFoundError,不会静默 0 命中。
  2. 注入(siwx/linux_hook/wxhook.c,现场用系统 cc 编译,不新增 Python 依赖):构造函数用 dl_iterate_phdr 取 PIE 基址,把 base+偏移 的首字节改成 INT3,注册自己的 SIGTRAP 处理器,并导出/拦截 sigaction 与 __libc_sigaction(否则 crashpad 一旦装自己的 SIGTRAP 处理器就会把我们顶掉,INT3 落到对方手里,进程按致命信号被杀)。
  3. 命中处理:从 ucontext 取 REG_RSI / REG_RDX,按三种入参布局各读 32 字节写入日志当候选;复原原字节、把 RIP 拨回断点让原指令照常执行,随即拆点。一次性布点,避免早期"置 TF 单步后重布"与其它线程执行同一地址的竞态。
  4. 注入通道:桌面环境由 systemd 用户管理器拉起微信,直接给子进程设 LD_PRELOAD 会被丢掉,所以走 systemctl --user set-environment;保存原值、结束时精确还原。没有用户 systemd 会话时退化为带环境变量直接执行,且优先经 dde-am 启动器(官方 deb 布局下直启二进制会 SIGABRT)。
  5. 编排(siwx/strategies/linux_hook.py):只在 platform.system() == "Linux" 时注册进 STRATEGY_REGISTRY 并计入 _PROCESS_DEPENDENT;非 Linux 不 import。

相对已关闭的 #35 / #37

#35、#37 已关闭。本分支基于 main 的 v5.1.0(d7843f8)重新整理,并新增两处修复:

  • 多账号不再重复重启微信:一次 extract 里"停微信 + 注入"最多一次。已注入过之后再遇到没有登录态的账号(判据:有没有进程打开该账号的 db_storage),直接打印"该账号当前未登录…跳过",不再关一次微信、也不再空等 300 秒超时。
  • 微信中途退出立刻收工:等待期间探活(启动宽限 20 秒),出现过又消失就结束等待并走 finally 还原 systemd 用户环境,不再把 LD_PRELOAD 挂到超时之后。

实测(UOS/Deepin,微信 4.1.13.23,x86-64)

  • 干净状态起跑:密钥库与已解密产物都先移空,走完注入与扫码,不是缓存命中
  • 提取:捕获 1 个候选 → 派生 25 个密钥 → 已验证 25/25(逐库 page-1 HMAC)
  • 解密:25 个库全部解出,约 248 MB;抽样 contact.db 6827 联系人、session.db 525 会话、sns.db 829 条朋友圈、message_0.db 405 张表
  • 副作用还原:systemd 用户环境无 LD_PRELOAD / WXS_HOOK_LOG 残留,临时 shim 目录已删,断点已拆

测试

  • tests/test_linux_hook.py:19 passed, 1 skipped(skip 为"非 Linux 不注册")
  • 全量:736 passed, 11 skipped, 38 subtests passed
  • 跨平台:依赖 extract() 的两条用例带 skipUnless(Linux);CI 的 test job 覆盖 windows-latest(3.10/3.11/3.12) 与 macos-latest,已用"import 前 patch platform.system 为 Darwin"验证——2 条 skip、0 失败

影响面

  • Windows / macOS:不 import、不注册该模块;extract() 的平台闸门在该策略之前。功能零变化,测试多两条 skip。
  • 未改动解密链路、导出、Web 前端、Windows/macOS 策略。

已知边界(已写入 LINUX_SUPPORT.md)

  • 仅支持 x86-64;需要系统 cc/gcc;偏移随微信构建变化,升级后重算
  • 一次登录只覆盖当前账号,其余账号显示 0/N,换账号登录后重跑
  • 注入期间微信会被关闭并重新拉起,通常自动恢复登录,也可能需要扫码一次

微信 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。
真机三账号实测:当前登录账号 25/25 命中;另外两个账号目录(各 16 库)0/16,
因为它们不在登录态、没有对应的 WCDB passphrase 可抓。这条边界写进文档,
避免被当成 bug 提 issue。
多账号机器上 extract 会按账号目录逐个跑策略:第一个账号命中 25/25 之后,
对没有登录态的第二个账号又完整走了一遍"停微信 → 注入 → 拉起 → 等 300 秒"。
结果是用户正在用的微信被第二次杀掉,而那个账号本来就不可能抓到,只能空等
到超时;期间 systemd 用户环境的 LD_PRELOAD 也一直挂着不还原。

改动:
- 新增 _account_is_live():扫 /proc/*/fd,看有没有进程打开该账号 db_storage
  下的文件,作为"该账号此刻是否登录"的判据。
- 新增模块级 _ATTEMPTED:一次 extract 里"停微信 + 注入"最多一次。已注入过
  之后再遇到未登录账号,直接打印"该账号当前未登录…跳过",不解析二进制、
  不碰微信。
- _wait_for_candidates() 增加 alive 探针:启动宽限 20 秒(dde-am → 瞬态单元
  有延迟),一旦微信出现过又消失就立刻结束等待,让 finally 马上还原
  systemd 用户环境,不再拖到超时之后。

测试:tests/test_linux_hook.py 新增 3 条闸门(未登录账号不得调用
_stop_wechat/_launch_wechat;第一个账号仍要引导拉起;微信消失时等待须
提前返回)。全量 736 passed, 11 skipped。
CI 的 test job 覆盖 windows-latest(3.10/3.11/3.12) 与 macos-latest。
`extract()` 在非 Linux 上第一步就 return 0,所以断言 _stop_wechat /
_launch_wechat 被调用的用例会在那两个平台必红。按文件既有约定加
skipUnless(platform.system() == "Linux");纯逻辑的等待提前返回用例
仍全平台跑。
@Wong0728
Wong0728 merged commit be2c4ab into ImUpXuu:main Oct 25, 2026
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.

2 participants