Repository navigation
feat(strategies): 新增 Linux 平台的实验性支持(基于 v5.1.0 重新提交) - #37
Closed
yuanphoenix wants to merge 2 commits into
Closed
yuanphoenix wants to merge 2 commits into
yuanphoenix wants to merge 2 commits into
Conversation
微信 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。
8 of 15 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
与 #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 撞死。改动类型
改动清单
新增
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_DEPENDENTREADME.md— 平台表与 Linux 说明技术要点
为什么不用 ptrace。 微信内置 Chromium crashpad,崩溃采样时会自己
scoped_ptrace_attach。一个进程只能有一个 tracer,外部 tracer 抢先附加后 crashpad 附加失败直接abort():这不是权限问题(
kernel.yama.ptrace_scope=0也一样),也不是断点打歪——只 attach 不打断点时进程能活,一旦保持被 trace 就死。改为把断点打在微信进程内,全程没有 ptrace。实现过程中修掉的三个硬 bug(都由 minidump 定位):
bp+1)。现在真正导出sigaction/__libc_sigaction/__sigaction,并加 50ms 看门狗复核:被顶掉就重装,复核三次仍装不回来就主动拆断点——绝不留下没人接的 INT3。snprintf会碰 malloc/locale 锁;野指针memcpy直接打死进程。改成手写十六进制 +process_vm_readv安全读取(纯 syscall,读不了返回错误而不是崩)。注入方式:不需要 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 条,上一次提交只有手工实测,没有自动化闸门):STRATEGY_REGISTRY且计入_PROCESS_DEPENDENT;非 Linux 不得注册;模块在任何平台都能 import;非 x86-64 直接跳过attrib=linux_hook;错误 passphrase 0 命中且不污染key_mapHookNotFoundError(不许崩);本机有微信时真实二进制必须算得出偏移cc/gcc时现场编译wxhook.c成功,并校验sigaction/__libc_sigaction/__sigaction真导出macos_lldb策略同源本机结果(UOS/Deepin,Python 3.12):
真机端到端(UOS/Deepin,微信 4.1.13.23,构建 4067695895,
python run.py keys extract):0x87ac370,shim 经systemctl --user set-environment注入——/proc/<pid>/maps里能看到wxhook.so,证明注入链路通sns.db、message_0..4、biz_message_0、contact.db),attrib 全部记为linux_hook,单次约 19sLD_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末尾一条重复说明合并已知限制
find_hook_offset()自动重算,失败明确报错,不静默 0 命中)cc/gcc)现场构建 shimSIGABRT,策略优先走dde-am com.tencent.wechat检查项
CONTRIBUTING.md的提交与文档约定hashlib)