DS-Free-API 如何破解 DeepSeek 的 PoW 门槛?DeepSeekHashV1 与 WASM 动态加载全解析
DS-Free-API 如何破解 DeepSeek 的 PoW 门槛?DeepSeekHashV1 与 WASM 动态加载全解析
ds-free-api 是一款 DeepSeek 网页端 API 代理工具,将网页端能力封装为 OpenAI / Anthropic 兼容接口。要打通这条链路,绕不过去的一道关卡就是 DeepSeek 的 PoW(Proof of Work,工作量证明)反爬机制:每次发起对话前,客户端必须先领到一串 challenge,再用 DeepSeek 官方的 WASM 文件算出答案,否则请求会被直接拒绝。本文带你完整看懂 DeepSeekHashV1 算法的调用方式、wasm_solve 的逆向细节,以及 ds-free-api 用"动态符号探测"实现的 WASM 动态加载方案。
什么是 PoW 工作量证明?为什么 DeepSeek 要用它
PoW(Proof of Work,工作量证明)最早出现在加密货币领域,核心思想是:让发起方付出一定计算成本,来证明"你是认真在调用,而不是脚本在刷"。
DeepSeek 把这套思路用在了网页端 API 上。当你通过 chat.deepseek.com 的接口发起一次对话(/chat/completion)或上传文件(/file/upload_file)时,服务端会先校验请求头里的一个字段:
X-Ds-Pow-Response:一段 base64 编码的 PoW 答案
缺失或无效,请求直接失败。它的目的是抬高批量脚本的调用成本——每个账号每次请求都要"做一道计算题"。
对 ds-free-api 这样的代理来说,问题就来了:这道题的答案不是简单公式能算出来的,DeepSeek 把求解算法封在一个约 26KB 的 WASM 文件里(文件名 sha3_wasm_bg.<hash>.wasm,从 fe-static.deepseek.com 下发,无需鉴权即可下载)。ds-free-api 的思路是:不重实现算法,直接运行官方 WASM,由它算出答案。
各端点对应的
target_path(PoW 要保护的目标接口)见 raw-api-reference.md:completion 对应/api/v0/chat/completion,上传文件对应/api/v0/file/upload_file。
PoW 完整流程:从领取 Challenge 到回传答案
整个 PoW 链路在 accounts.rs 的 compute_pow_for_target 中串起来,共四步:
- 领取挑战:调用
POST /chat/create_pow_challenge,带上target_path,服务端返回一个ChallengeData结构; - WASM 求解:把 challenge 交给
PowSolver(pow.rs),在 WASM 沙箱里跑出答案; - 编码答案:
PowResult::to_header()将结果打包成 JSON 再做 base64; - 回传请求:答案放进
X-Ds-Pow-Response请求头,与Authorization一起随 completion 请求发出(见 client.rs)。
服务端下发的 challenge 长这样(字段定义见 ChallengeData):
| 字段 | 含义 |
|---|---|
algorithm |
固定为 DeepSeekHashV1 |
challenge |
64 位十六进制哈希输入前缀 |
salt |
盐值,参与拼接 |
signature |
挑战签名 |
difficulty |
难度阈值(实测约 144000) |
expire_at / expire_after |
过期时间戳;有效期 5 分钟 |
target_path |
本答案要使用的目标接口 |
两个值得注意的细节:
- challenge 有时效性,5 分钟过期,所以每次请求都要现领现算,不能缓存复用;
- 每个账号独立领取:多账号场景下,账号池(pool.rs)在健康检查、重新登录、发起对话时都会按账号走一遍完整流程,账号池里任何一次"推理体检"都包含一次真实 PoW 计算。
DeepSeekHashV1:逆向出来的 WASM 求解器
真正的算法藏在 WASM 里。ds-free-api 用 wasmtime(Rust 的高性能 WASM 运行时)把它跑起来,核心代码全部在 pow.rs(约 280 行),PowSolver::solve 的调用序列非常直白:
- 构造前缀:
prefix = "{salt}_{expire_at}_",即盐值拼过期时间戳; - 准备返回槽位:调用导出函数
__wbindgen_add_to_stack_pointer(-16),在 WASM 内存里划出 16 字节结果区(前 4 字节存状态、后 8 字节存答案); - 写入字符串:通过 wasm-bindgen 的内存分配器(
__wbindgen_malloc)把challenge和prefix两块字符串写进 WASM 线性内存; - 调用求解:执行
wasm_solve(retptr, ptr_challenge, len_challenge, ptr_prefix, len_prefix, difficulty)——签名是 5 个i32+ 1 个f64,无返回值; - 读回结果:从返回槽位读出 4 字节整型状态和 8 字节双精度浮点答案;状态为 0 表示未找到解(
NoSolution),否则将浮点答案截断为整数,连同原 challenge 字段一起封装成PowResult。
算法名虽然叫 "DeepSeekHashV1",但从 WASM 文件名 sha3_wasm_bg 和求解过程可以判断,它内部大概率是 SHA3/Keccak 系列哈希 + 按难度前缀搜索——即不断改变计数因子直到哈希值落在目标阈值内。ds-free-api 不需要关心内部细节,"黑盒运行官方 WASM" 就是最稳的兼容策略:DeepSeek 改了算法,只要 WASM 导出签名不变,代理就能继续工作。
最后的答案会按如下结构序列化(见 PowResult::to_header):
{ "algorithm", "challenge", "salt", "answer", "signature", "target_path" }
→ JSON → base64 → X-Ds-Pow-Response 请求头
WASM 动态加载:为什么不能硬编码符号名
如果你直接打开 pow.rs 的 PowSolver::new,会发现它启动时并不调用任何"固定名字"的函数,而是做了一套基于函数签名的动态探测。这是整个项目最有设计感的一段代码。
WASM 文件是编译产物。当 DeepSeek 用 wasm-bindgen 重新编译前端 WASM 时,导出符号名会跟着构建工具走——比如内存分配器可能从 __wbindgen_malloc 变成 __wbindgen_export_0、__wbindgen_export_3 这类无意义编号。早期版本硬编码了 __wbindgen_export_0,结果 DeepSeek 一更新 WASM,代理直接起不来。
修复后的探测逻辑分三级(find_export_by_names / find_export_by_prefix / matches_sig):
| 目标 | 首选名称 | 兜底策略 |
|---|---|---|
| 栈指针调整 | __wbindgen_add_to_stack_pointer |
签名 (i32) -> i32 精确匹配 |
| 内存分配器 | __wbindgen_malloc |
前缀 __wbindgen_export_ + 签名 (i32,i32) -> i32 |
| 求解入口 | wasm_solve |
全模块唯一符合 (i32,i32,i32,i32,i32,f64) -> () 签名的导出 |
第三行是关键:即使 DeepSeek 把 wasm_solve 改名成任何奇怪的名字,只要它"5 个 i32 + 1 个 f64、无返回值"的签名在模块里是唯一的,探测就能命中。这就是 CHANGELOG 里说的"WASM 动态探测,降低 DeepSeek 更新 WASM 后启动失败的风险"。
运行时层面还有两层保障:
- 预实例化:
Linker::instantiate_pre在启动时预编译好模块,每次求解只需轻量地实例化一次,多账号并发调用互不干扰; - 热重载:管理后台修改
wasm_url后,Accounts::reload_config(accounts.rs)会重新下载 WASM、重建PowSolver并原子替换,无需重启服务。
配置与故障排查:WASM 加载失败怎么办
WASM 文件的 URL 带版本 hash(如 sha3_wasm_bg.7b9ca65ddd.wasm),DeepSeek 每次发版都可能更换。相关配置项:
# config.toml
[ds_core]
api_base = "https://chat.deepseek.com/api/v0"
wasm_url = "https://fe-static.deepseek.com/chat/static/sha3_wasm_bg.<新hash>.wasm"
wasm_url 也可以在 Web 管理后台的设置页直接修改(SettingsPage.tsx),保存后立即触发上面提到的热重载。
常见故障对照:
| 症状 | 原因 | 处理 |
|---|---|---|
启动报 WASM init failed / 找不到导出 |
WASM 更新后连兜底签名都对不上 | 更新 wasm_url 指向新文件 |
求解报 no solution |
challenge 过期或难度变化 | 重新领 challenge,确认系统时间准确 |
| 所有请求 4xx / 被拒 | X-Ds-Pow-Response 缺失或过期 |
检查 PoW 链路日志,确认每次请求前都在现算 |
官方给出的排障思路写得很清楚(raw-api-reference.md "WASM 故障处理" 一节):先靠动态探测自动适配大部分变更;仍失败则更新 wasm_url;再不行就去 pow.rs 对照新的导出签名补探测规则。日志侧可关注 ds_core::accounts 模块的 INFO/WARN 记录,PoW 失败会以 PowError 形式沿 ClientError → PoolError → CoreError 错误链(见 ds_core/README.md)逐层上抛。
总结
ds-free-api 对 PoW 的处理可以概括为一句话:领题 → 黑盒求解 → 回传答案。它的工程价值在于两点:
- 不重实现、只运行官方 WASM——
DeepSeekHashV1的内部算法始终由 DeepSeek 自己的sha3_wasm_bg保证正确性,规避了逆向算法的脆弱性; - 基于签名的动态符号探测 + 运行时热重载——把"DeepSeek 更新 WASM 导致代理崩溃"这类问题降级为"改一行配置",这正是它作为长期可用代理的核心竞争力。
理解这套机制后,再看 ds_core 的账号池、HIF 风控令牌(x-hif-leim)与客户端拟态,就能拼出 DeepSeek 网页端完整的风控画像——而 PoW 只是其中最"硬核"的一环。


