微信视频号下载器技术原理:MITM 注入 + WASM 解密全链路拆解

这个项目(ltaoo/wx_channels_download)看上去只是”给视频号加个下载按钮”,拆开其实是一条完整的工程链路:在微信 PC 端的视频号页面和服务器中间插一层代理,从被解密的 HTTPS 流量里挖出播放地址与解密密钥,再用浏览器同款的 WASM 算法把加密的视频头解掉,最后流式边下边解落盘。

下面按数据真实流向讲:页面请求 → 代理拦截 → HTML/JS 注入 → 拿到 feed 与 key → 解密 → 下载落盘。每层都给出”怎么判断这层通了”的判据。

依据说明:本文以仓库 main 分支源码与 docs/ 为准(2026 年 11 月)。微信客户端每个月都在改,具体 JS 文件名、字段名、函数签名都会漂移,但方法学不变。标”推断”的地方是基于代码行为的合理还原,未经上游确认。

一、先看清对手:视频号到底是什么

很多人第一反应是”抓包拿 cookie 调接口”。这个思路在这里不成立,原因很简单:

Windows 上的视频号不是微信主进程画的界面,而是 WeChatAppEx.exe(微信内嵌的 Chromium 容器,小程序、公众号、视频号共用的渲染进程)加载的一个网页,域名是 channels.weixin.qq.com。你看到的列表、详情、播放器,全是这个 Chromium 页面自己发出的 HTTPS 请求。

由此带来两个直接后果:

  • 好消息:它就是个浏览器。浏览器能被中间人代理、能被注入脚本、能被读 DOM。不需要逆协议、不算签名、不导出登录态。
  • 坏消息:数据全在 TLS 里。不解 TLS,一个 URL 都看不到;不注入脚本,”下载”按钮没地方放。

所以整套东西的底座只有两个字:MITM(中间人)。其余全是在 MITM 之上做的活。

二、全局架构:两个端口,两条链路

微信 WeChatAppEx.exe(内嵌 Chromium 容器) channels.weixin.qq.com|HTML 响应被注入 <script> → 下载按钮 / 进度条 / 日志 res.wx.qq.com|承载 finder 逻辑的 JS chunk 被正则改写 → 主动 emit feed 数据 finder.video.qq.com|mp4 视频(头部 128KB 加密,需 ISAAC64 密钥流异或) ① HTTPS(进程级代理 / 系统代理 / TUN) ② 直连 CDN 127.0.0.1:2023 代理服务 TLS 解密 · 响应改写 · 证书签发 后台下载任务 HTTP + Range 分片 · 进度回推 127.0.0.1:2022 API / WebSocket 任务创建 · 事件推送 · 管理页 任务队列(maxRunning 并发控制) DecryptReader 流式解密(只解前 128KB)→ 落盘 .mp4
端口 2023 承载代理与注入,端口 2022 承载 API 与事件通道;解密与落盘全程流式,不产生中间文件。

两个端口分工极清楚,这是排查问题的第一把钥匙:

端口 角色 谁连它 坏了会怎样
2023 HTTP 代理 + 响应改写 微信进程 没有下载按钮;页面空白或转圈
2022 REST API + WebSocket + 管理页 注入的页面脚本、终端 按钮在,点了没反应,提示连不上服务

“根本没有按钮”和”有按钮但点报错”,是两个完全不同层的故障。想清这点,能省掉大半瞎试。

源码里的目录分工(都是我实际翻过的路径):

路径 职责
internal/interceptor/proxy/echo.go 纯 Go 的 MITM 实现,默认构建(//go:build !sunnynet)
internal/interceptor/proxy/sunny.go Windows 下基于 SunnyNet 驱动的进程级代理(//go:build sunnynet)
internal/interceptor/server.go 拦截服务编排、插件注册
pkg/certificate/ 根证书与私钥、安装到系统信任库
pkg/scraper/wxchannels/interceptor.go 视频号专用拦截规则与响应改写
pkg/scraper/wxchannels/inject/*.js 注入脚本:按钮、事件总线、取 feed
pkg/scraper/wxchannels/decryptor.go ISAAC64 密钥流生成
pkg/scraper/wxchannels/decrypt.go、reader.go 解密器与支持 Range 的流式解密 Reader
pkg/scraper/wxchannels/types.go feed / media / spec 的 JSON 结构定义

三、代理层:只让一个进程走代理

这是最”技术”也最容易被忽略的一层。粗暴地把系统代理指到 2023,会有三个副作用:全系统流量都进你的进程(浏览器、微信主进程、系统更新全被拦);自己的请求可能绕回自己形成回环;和 Clash / Surge / VPN 抢系统代理互相覆盖。

3.1 Windows:驱动级进程代理

sunny.go 的思路是让 SunnyNet 打开驱动(OpenDrive(0)),然后只把 WeChatAppEx.exe 这个进程的流量挂上去(ProcessAddName("WeChatAppEx.exe"))。流量在 TCP 层就被重定向进代理,不经过系统代理设置,所以既不影响其他程序,也不会被 Clash 的系统代理开关顶掉。代价是要驱动权限,且只在 Windows 可用。

3.2 默认构建:纯 Go 的 echo

echo.go 是默认实现的 MITM,靠一张路由表和两个开关收敛拦截范围:

opts := &echo.Options{
    EnableBuiltinBypass:  false,  // 不做内置绕过,全按规则走
    InterceptOnlyMatched: true,   // 只解密命中白名单的域名,其余透传
    UpstreamProxy:        upstreamProxy, // 上游代理,与 Clash 共存的关键
}

// TUN 模式的路由表,按顺序匹配
Rules: []tun.RuleConfig{
    {ProcessName: selfProcessNames(), Outbound: "direct"},  // 自己 → 直连,防回环
    {ProcessName: []string{"WeChat","WeChatAppEx","WeChatAppEx.exe","Weixin.exe"},
     Outbound: "proxy"},
    {DomainSuffix: []string{"qq.com"}, Outbound: "proxy"},
},
Final: "direct",

三条规则值得逐字读:

  1. 自己直连:代理进程自己发起的请求(拉取上游、上报日志)必须 direct,否则请求进代理、代理再请求、无限套娃。
  2. 按进程名圈定:只把微信相关进程抬进 proxy,其他进程按进程名/域名兜底走 direct。这就是”局部 MITM”的实现方式。
  3. 按域名兜底:qq.com 后缀全走 proxy。因为视频号的 CDN、JS 都在 *.qq.com 下,按域名兜一层比逐个枚举进程稳。

注意 InterceptOnlyMatched: true 这个开关的重要性:它意味着不在白名单的域名直接隧道透传,不做中间人。既省 CPU,又避免把微信其他流量(登录、支付)搅坏——这也是这类工具”能长期可用”的关键设计。

3.3 证书:MITM 的准入门槛

要解密 HTTPS,代理必须给每个域名现场签一张证书,而这张证书得由系统信任的根 CA 签发,否则 Chromium 会直接断开。

项目自带一对自签 CA(SunnyNet.cer + 私钥 private.key,打包在 pkg/certificate/certs),启动时按平台装进信任库:

平台 安装位置 要点
Windows certutil -addstore 到”受信任的根证书颁发机构” 当前用户装即可,若提示无权限用管理员
macOS 钥匙串”系统”→ 双击证书 → 始终信任 同时信任”安全套接字层(SSL)”
Linux /usr/local/share/ca-certificates/ + update-ca-certificates 多数桌面场景用系统代理

判据:证书没装好,症状一定是”页面打不开 / 提示连接不是私密连接 / 一直转圈”,而不是”没有按钮”。这两个症状别搞混。

四、注入层:在页面里装一个”后门”

代理通了、证书信任了,接下来要解决”怎么拿到数据”和”怎么放按钮”。

4.1 改 HTML:把脚本塞进去

拦截规则命中 channels.weixin.qq.com 的 HTML 响应(Content-Type 是 text/html),在 <head> 之后插入若干 <script> 标签,指向本机 127.0.0.1:2022 暴露的脚本。

原理极朴素:页面加载时会执行这些脚本,脚本就获得了同源权限——能读 DOM、能发 XHR、能拿到页面内部的全局对象。不需要浏览器扩展,不需要改客户端。

4.2 改 JS chunk:为什么要动 res.wx.qq.com

这是整套方案里最巧的一步,也是最容易被版本更新打碎的一步。

视频号的 feed 数据(标题、播放地址、decodeKey、清晰度列表)都在页面内部的 finder 接口里。你当然可以自己去重放这些接口,但签名参数、时间戳、加密 eid 会把你拦死在门口。

项目的做法是:不重放,搭便车。它拦截 res.wx.qq.com 下承载 finder 逻辑的那段 JS chunk(文件名形如 virtual_svg-icons-register.publish.*.js),在响应体里做字符串替换,把关键函数包一层:

// 改写前
async finderPcFlow(e, t, n) { ... 原始逻辑 ... }

// 改写后(示意)
async finderPcFlow(...a) {
  const r = await __wx_orig_finderPcFlow.apply(this, a);
  WXU.emit("channels:pcFlow", r);   // 顺手把返回值广播出去
  return r;
}

维护的是一张「函数签名 → 事件名」映射表(推断自 inject/ 下脚本与拦截器的配合方式)。所以它拿到的是页面自己请求回来的、已经签名验证过的真实响应,一个参数都不用自己造。

这也是”微信升级就失效”的根因:chunk 一旦改名、函数签名一变(比如 finderPcFlow 改成 finderPcFlowV2,或从 async 改成返回 Promise 的普通函数),正则匹配不上,注入就静默失败。日志里典型表现是”没有找到操作栏”或压根没有拦截记录。

4.3 事件总线 → WebSocket

注入脚本之间用一套挂在 window 上的 WXU 命名空间通信:WXU.emit("channels:xxx", data) 广播,下载按钮、进度条、配置读取各自订阅。随后 channels.events.js 把事件通过 WebSocket 连到 2022。

为什么必须是 WebSocket 而不是普通 HTTP:

  • 双向。页面提交下载任务,后端要实时回推进度、日志、错误;HTTP 轮询做不出”原地刷新的进度条”。
  • 有个细节能印证:前端日志结构里带 replace: 1 字段——表示”这一行覆盖上一行”,典型的就是进度百分比在同一行反复刷新。这种交互只有长连接顺手。

五、数据面:一条播放地址里都有什么

types.go 里 ChannelsMediaItem 就是”一个媒体项”的完整描述,字段不多但每个都关键:

字段 含义 为什么重要
url CDN 播放地址(finder.video.qq.com) 带 encfilekey、token 等时效参数
decodeKey 解密密钥,base64url 编码的 uint64 整套解密的种子,缺它只能拿到花屏
fileSize 文件字节数 多线程分片与进度条依据
spec[] 清晰度列表(fileFormat/width/height/videoBitrate/levelOrder) 切换清晰度靠它;加密前缀长度也藏在 spec 里(firstLoadBytes)
videoPlayLen 时长(秒) 校验下载是否完整
coverUrl/thumbUrl 封面 命名、留档
contact.username 作者 按作者分目录存

切清晰度的做法很”腾讯”:在 URL 尾巴上追加 &X-snsvideoflag=<spec.fileFormat>(原始画质就是 original),CDN 按这个参数决定给你哪一档。另一条路是把 URL 拆开重建,只保留 encfilekey + token,主动丢掉一堆无用参数——两种做法在 channels.utils.js 里都有。

六、解密:ISAAC64 流密码,只加密了头部

这是全项目最硬的部分。先给三个”事实”,它们决定了实现成本:

  1. 只加密文件头,不是整文件。 加密长度来自媒体元数据(spec 里的 firstLoadBytes),官方 wasm 一次生成 128KB(131072 字节)密钥流,正好覆盖这个前缀。
  2. 算法是 XOR 流密码。 明文 XOR 密钥流,对称、可随机访问——正因为如此才能做 Range 分段下载。
  3. 密钥流由 ISAAC64 生成,种子就是 decodeKey。 算法本身是公开的(Bob Jenkins 的 ISAAC64),难点从来不是密码学,而是”字节序怎么对齐”。

6.1 官方实现:把 WASM 当参考机

window.VTS_WASM_URL =
  "https://res.wx.qq.com/t/wx_fed/cdn_libs/res/decrypt-video-core/1.3.0/wasm_video_decode.wasm";

decryptor = new Module.WxIsaac64(seed);   // seed 是"十进制字符串"
decryptor.generate(131072);               // 131072 字节密流写进 wasm heap

// 把 heap 里的结果拷出来(注意这里有一次整段 reverse)
decryptor_array.set(new Uint8Array(Module.HEAPU8.buffer, t, 131072).reverse());

拿到 decryptor_array 之后就是逐字节异或:

for (var n = 0; n < t.byteLength; n++) r[n] ^= decryptor_array[n];

注意两个坑,都是新手第一次必踩的:

  • seed 传的是十进制字符串,不是原始 base64。因为 JS 的 Number 只有 53 位精度,装不下 uint64,必须走 BigInt。所以脚本里有个 decodeBase64ToUint64String():base64url 解码 → 不足 8 字节在前面补零 → BigInt 累加 → .toString(10)。
  • 那句 .reverse() 说明 wasm 往 heap 的写入顺序与消费顺序相反。照抄代码当然没问题,但你如果自己实现,就一定要处理这个字节序问题。

6.2 用 Go 复刻:核心只有三步

初始化部分逐字照抄 Bob Jenkins 的 isaac64.c 里的 randinit(64 位版,别抄成 32 位的 isaac.c,混合常数完全不同)。唯一改动是种子:把 decodeKey 塞进第 0 个种子字,其余置 0。

// 生成 128KB 密钥流:每个 uint64 按"大端"展开成 8 字节
func Generate(key uint64, size int) []byte {
    r := NewISAAC64(key)      // 内部:aa[0] = key,其余种子字 = 0,a..h 初值 = 0x9E3779B97F4A7C15
    out := make([]byte, 0, size)
    var buf [8]byte
    for len(out) < size {
        binary.BigEndian.PutUint64(buf[:], r.Next())   // ← 这里是唯一的选择题
        out = append(out, buf[:]...)
    }
    return out[:size]
}

// 只解前缀,后面的字节原样保留
func Decrypt(key uint64, data []byte) []byte {
    ks := Generate(key, 131072)
    out := make([]byte, len(data))
    copy(out, data)
    n := len(data)
    if n > len(ks) { n = len(ks) }
    for i := 0; i < n; i++ {
        out[i] ^= ks[i]
    }
    return out
}

关于字节序,给一个不用猜的办法:

先用官方 wasm 生成一份 keystream 存成 ks_wasm.bin,再用你的 Go 生成 ks_go.bin,两者逐字节 diff。
· 完全一致 → 恭喜,可以直接用。
· 只有每个 8 字节组内部顺序相反 → 把 BigEndian 换成 LittleEndian。
· 整段 128KB 呈”首尾颠倒”对应 → 你少做了一次 reverse。
· 一个字节都对不上 → 密钥流种子错了,先回去查 base64url 解码是否补零在低位。

这种”拿参考实现做字节对照”的习惯,比读十遍论文有用。

七、流式解密:4K 视频不能先落盘再解

一个 4K 视频动辄几个 GB,全下完再解要两倍磁盘和两倍内存。所以 DecryptReader 实现了 io.Reader,边读边解、直接写文件。

因为 XOR 可随机访问,实现异常简单——密钥流按绝对文件偏移索引:

func (d *DecryptReader) Read(p []byte) (int, error) {
    n, err := d.src.Read(p)
    for i := 0; i < n; i++ {
        abs := d.off + int64(i)
        if abs < d.ksLen {           // 超出加密前缀就不动
            p[i] ^= d.ks[abs]
        }
    }
    d.off += int64(n)
    return n, err
}

真正需要小心的是 HTTP Range 的 8 字节对齐。分片下载时请求的 start 不一定是 8 的倍数,而密钥流的自然单位是 8 字节。稳妥做法:

  • 请求时把 start 向下取整到 8 的倍数(start & ^7);
  • 拿到数据后丢弃前 start & 7 字节,再按绝对偏移异或。

不做这个对齐,文件能下完、头也能播,但中间随机位置会一帧花屏——非常难查,因为它只在大文件分段下载时出现。

还有个很实用的优化:Range start ≥ 131072 的分片根本不需要解密,直接透传。也就是说 2GB 的文件只有前 128KB 要过一遍算法,CPU 几乎为零。

八、下载与落盘:一个任务的生命周期

页面上的按钮默认不自己下载。它调用 WXU.downloader.create(),把 feed + 规格发到 2022 建任务,随后 WXU.downloader.show() 打开任务面板。真正的下载在后台跑:

  1. 任务队列按 download.maxRunning(默认 3)限并发;
  2. 用 filenameTemplate(默认 {{filename}}_{{spec}})拼文件名,含 / 时会自动建子目录(仅后台模式生效);
  3. HTTP 客户端直连 CDN,按 fileSize 分片 + 进度回调;
  4. 数据流过 DecryptReader,写盘;
  5. 完成后可选播放音效(download.playDoneAudio)。

配置里有两个开关能说明设计取向:

  • channels.download.frontend: true:改在页面内解密下载,不依赖后台。文档明确提醒”长视频可能失败、下载目录配置失效、文件名不支持子目录”——因为它受浏览器内存与沙箱限制,只是兜底方案。
  • download.remoteServer:可以把任务发给局域网里另一台机器跑,说明 API 与执行是解耦的。

另外两类内容走的是别的分支:图片集是前端用 JSZip 打包成 zip;转 mp3 是解密后走音频转码;直播是 joinLive 拿到 HLS 地址后按 m3u8 处理,不是 mp4 那一套。

九、自己动手:最小可验证路径

不看完整仓库也能复现,按这六步走,每一步都有明确判据。

  1. 拿到一条播放地址与 key。 最省事的方式不是抓包,而是”网络面板 + 搜索”:让视频号页面播放,抓 finder.video.qq.com 的 m4s/mp4 请求,复制 URL;同时在返回 feed 的接口响应里搜 decodeKey。
    判据:URL 能直接 curl 下载到文件(不是 403),文件大小与 fileSize 一致。
  2. 确认它真的加密了。 用 ffprobe 或任意播放器打开。
    判据:报 “moov atom not found” 或直接花屏,就是加密的;能正常播,说明这条没加密,换一条。
  3. base64url 转 uint64。 先把 - 和 _ 换回 + 和 /、补齐 padding,再 base64 解码。不足 8 字节时在高位补零,然后按大端拼成 uint64。
    判据:输出是一个 19~20 位的十进制数,落在 uint64 范围内。
  4. 生成 128KB 密钥流。 照 6.2 的 Go 代码,或用官方 wasm 直接生成。
    判据:wc -c 正好输出 131072。
  5. 只异或前缀。 不要对整文件做 XOR。
    判据:解完 ffprobe 能列出 stream 信息,时长与 videoPlayLen 对得上。
  6. 抽帧比对。 ffmpeg -i out.mp4 -ss 00:00:05 -frames:v 1 check.png,看画面是否正常。
    判据:能出清晰画面。若整段彩色噪点,多半是整文件都解了,或字节序反了。

十、八个高频坑(按踩到的顺序)

症状 真正原因 怎么修
页面打不开 / 一直转圈 根证书没装或装错位置 重装当前实例的 CA,别用网上旧 issue 里的证书文件
视频能播,但没有按钮 流量压根没走代理 查 ProxyOverride 是否排除了 *.qq.com;查 AutoConfigURL 有没有 PAC 抢走
日志有”没有找到操作栏” 脚本注入成功,但页面结构变了 换入口重开(侧边栏 / 详情页 / 分享打开,DOM 不一样);升级版本
按钮在,点了一点反应都没有 2022 的 API 没连上 浏览器开 127.0.0.1:2022 看管理页;看 /api/status 里 proxy/api 的状态
下载完是花屏 密钥错 / 字节序错 / 把整文件都 XOR 了 按 6.2 的 diff 流程排查;只解前 128KB
只有中间某段花屏 Range 起点没对齐 8 字节 start & ^7 向下取整,跳过前导字节
key 转成数字后对不上 base64url 没还原成标准 base64 就解码 替换字符 + 补 padding,补零在高位
微信一升级就全废 chunk 改名 / 函数签名变 更新映射表;开 --debug 看有没有拦截记录

排查顺序建议固定成一条链:端口在不在 → 证书通不通 → 有没有拦截记录 → 有没有注入记录 → API 连得上 → 解密对不对。从前往后走,每一步都有独立判据,不要跳步。

十一、合规与边界

技术上拆解不等于可以随意用。几句必须说的话:

  • 只下载自己有权限看的内容,用于个人备份、离线观看、学习研究。付费、私密、仅粉丝可见的内容不在合理范围内。
  • 不要二次分发、不要搬运做号、不要去掉水印后商用——这既是平台协议问题,也是著作权问题。
  • 自己的账号、自己的设备、自己的流量,这是”中间人”能站得住的前提。给别人装、做灰产工具、提供代下服务,性质就变了。
  • 这类工具天然处在”平台改一次就失效”的状态,别把它当基础设施依赖。

十二、一张图收尾

把整条链路压缩成一句话:用进程级 MITM 解开视频号页面的 TLS,注入脚本改写好官方 JS 让它主动吐出 feed,从 feed 里取 url 和 decodeKey,用 ISAAC64 生成 128KB 密钥流、只解文件头,然后以流式 Reader 边下边解落盘。

真正有含金量的设计只有三处:只拦一个进程(不污染系统)、只改写一个 JS chunk(不重放接口)、只解 128KB 头部(支持 Range 且几乎不耗 CPU)。这三条想明白了,剩下的都是体力活。

参考

  • 项目主页:github.com/ltaoo/wx_channels_download
  • 文档 · 手动安装根证书:docs/guide/certificate.md
  • 文档 · 没有下载按钮(排查链路写得很细):docs/faq/button_inject_failed.md
  • 文档 · 下载配置:docs/config/download.md;前端下载:docs/config/channels/frontend.md
  • 相关 issue:#248(系统代理例外列表导致抓不到流量)、#576(流量未经过代理)、#587(微信升级后按钮消失)
  • 算法参考:Bob Jenkins, ISAAC64(isaac64.c)

源码会变,方法不会。下次微信再改,你按本文的六步链路逐段定位,通常半小时就能找到断点。

THE END
抢沙发

请登录后发表评论

    暂无评论内容