这个项目(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 之上做的活。
二、全局架构:两个端口,两条链路
两个端口分工极清楚,这是排查问题的第一把钥匙:
| 端口 | 角色 | 谁连它 | 坏了会怎样 |
|---|---|---|---|
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",
三条规则值得逐字读:
- 自己直连:代理进程自己发起的请求(拉取上游、上报日志)必须 direct,否则请求进代理、代理再请求、无限套娃。
- 按进程名圈定:只把微信相关进程抬进 proxy,其他进程按进程名/域名兜底走 direct。这就是”局部 MITM”的实现方式。
- 按域名兜底:
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 流密码,只加密了头部
这是全项目最硬的部分。先给三个”事实”,它们决定了实现成本:
- 只加密文件头,不是整文件。 加密长度来自媒体元数据(spec 里的
firstLoadBytes),官方 wasm 一次生成 128KB(131072字节)密钥流,正好覆盖这个前缀。 - 算法是 XOR 流密码。 明文 XOR 密钥流,对称、可随机访问——正因为如此才能做 Range 分段下载。
- 密钥流由 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() 打开任务面板。真正的下载在后台跑:
- 任务队列按
download.maxRunning(默认 3)限并发; - 用
filenameTemplate(默认{{filename}}_{{spec}})拼文件名,含/时会自动建子目录(仅后台模式生效); - HTTP 客户端直连 CDN,按
fileSize分片 + 进度回调; - 数据流过
DecryptReader,写盘; - 完成后可选播放音效(
download.playDoneAudio)。
配置里有两个开关能说明设计取向:
channels.download.frontend: true:改在页面内解密下载,不依赖后台。文档明确提醒”长视频可能失败、下载目录配置失效、文件名不支持子目录”——因为它受浏览器内存与沙箱限制,只是兜底方案。download.remoteServer:可以把任务发给局域网里另一台机器跑,说明 API 与执行是解耦的。
另外两类内容走的是别的分支:图片集是前端用 JSZip 打包成 zip;转 mp3 是解密后走音频转码;直播是 joinLive 拿到 HLS 地址后按 m3u8 处理,不是 mp4 那一套。
九、自己动手:最小可验证路径
不看完整仓库也能复现,按这六步走,每一步都有明确判据。
- 拿到一条播放地址与 key。 最省事的方式不是抓包,而是”网络面板 + 搜索”:让视频号页面播放,抓
finder.video.qq.com的 m4s/mp4 请求,复制 URL;同时在返回 feed 的接口响应里搜decodeKey。
判据:URL 能直接curl下载到文件(不是 403),文件大小与fileSize一致。 - 确认它真的加密了。 用
ffprobe或任意播放器打开。
判据:报 “moov atom not found” 或直接花屏,就是加密的;能正常播,说明这条没加密,换一条。 - base64url 转 uint64。 先把
-和_换回+和/、补齐 padding,再 base64 解码。不足 8 字节时在高位补零,然后按大端拼成 uint64。
判据:输出是一个 19~20 位的十进制数,落在 uint64 范围内。 - 生成 128KB 密钥流。 照 6.2 的 Go 代码,或用官方 wasm 直接生成。
判据:wc -c正好输出 131072。 - 只异或前缀。 不要对整文件做 XOR。
判据:解完ffprobe能列出 stream 信息,时长与videoPlayLen对得上。 - 抽帧比对。
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)
源码会变,方法不会。下次微信再改,你按本文的六步链路逐段定位,通常半小时就能找到断点。






















暂无评论内容