网络安全应用安全后端【免费下载链接】capFree, open-source and self-hosted CAPTCHA alternative to reCAPTCHA. Privacy-first and powered by proof-of-work and instrumentation challenges.项目地址https://gitcode.com/gh_mirrors/cap13/cap点击查看免费下载cap.js/solver是 Cap 开源 CAPTCHA 项目提供的一个独立服务端库用于在机器对机器M2M场景下直接求解 Cap 的工作量证明质询而无需经过浏览器验证组件。它零依赖、单文件、体积小巧求解速度与验证组件相当但只能在 Bun 运行时下使用。读完本文你将掌握该库的安装方式、两种质询输入形式基于种子与基于质询列表、全部可选参数workerCount、onProgress、c/s/d的语义并从源码层面理解其求解与验证背后的 SHA-256 工作量证明原理。什么是cap.js/solverM2M 场景的定位在 Cap 的常规流程中工作量证明质询由浏览器里的验证组件负责求解服务端签发质询客户端用 WASM 和 Web Worker 并行计算解再把解回传兑换令牌详见 Cap 是如何工作的。cap.js/solver把求解这一步搬到服务端执行服务于**机器对机器M2M**场景——例如你的后端服务需要自己先通过一次 Cap 质询才能继续调用受 CAPTCHA 保护的下游接口。与浏览器求解不同它没有 WASM 编译、Web Worker 调度、shadow DOM 等浏览器上下文依赖因此实现极度精简零依赖、单文件但求解吞吐与验证组件一样高效。需要明确的是这个包不会绕过任何实际的工作量证明。它按照与浏览器验证组件相同的算法老老实实计算 nonce所以服务端同样要付出对应的计算成本同时它不支持 instrumentation 质询instrumentation 是浏览器环境检测类质询需要真实浏览器环境才能通过服务端无法模拟详见下文边界与限制。安装该库只在 Bun 生态中分发使用 Bun 的包管理器安装即可bun add cap.js/solver安装后通过默认导出引入import solver from cap.js/solver;cap.js/solver与服务端签发/验证库是解耦的。如果你需要在自己后端签发质询可配合 Cap 的无状态服务端库capjs-core文档或开箱即用的 Cap Standalone 使用。用法一基于种子的质询seeded challenges最常用的形式是传入种子令牌challenge token与配置对象让求解器按种子生成并求解一组质询import solver from cap.js/solver; console.log( await solver(challenge token, { c: 50, // 质询数量 s: 32, // 盐的长度十六进制字符数 d: 4, // 难度目标前缀长度 }), );配置对象中的三个参数与验证组件/服务端库的生成参数一一对应cchallenge count要生成的质询数量。服务端默认签发50个质询因此通常传50。ssalt size每个质询的盐长度单位是十六进制字符数默认32。盐是工作量证明输入的一部分由种子确定性派生。ddifficulty难度即哈希结果需要匹配的目标前缀长度十六进制字符数默认4。d越大找到有效 nonce 的期望哈希次数越多。这三个参数与capjs-core中generateChallenge的challengeCount、challengeSize、challengeDifficulty默认值50、32、4完全对齐见 core/src/index.js 的参数校验逻辑。用法二基于质询列表challenge list第二种形式是直接传入质询列表列表中每个元素是[盐, 目标前缀]二元组。这种形式通常用于你已经从服务端拿到了具体的质询对只想针对它们逐一求解import solver from cap.js/solver; const challenges [ [a5b6fda4aaed97cf61d7dd9259f733b5, d455], [286bcc39249f9ee698314b600c32e40f, f0ff], [501350aa7c46573cb604284554045703, 4971], [a55c02f3b9b4cd088a5a7ee3d4941c14, eab7], [5f3362c12e2779f56f4ef75b4494f5e6, 999f], /* ... */ ]; console.log(await solver(challenges));列表形式下求解器不再自行生成质询而是对每个[salt, target]对直接暴力搜索有效 nonce因此不需要也不接受c/s/d这三个种子派生参数。输出示例[67302, 64511, 40440, 27959, 71259 /* ... */]输出的每个数字对应一个质询的有效 nonce顺序与输入质询列表或种子派生出的质询一一对应。拿到这些 nonce 后即可按验证组件同样的格式把它们作为solutions提交给服务端兑换令牌。第二个参数通用选项与种子专属选项第二个参数可选但任何时候都可以传入且始终是一个对象。它包含两类选项所有质询类型通用workerCount指定使用的 worker 数量默认值为 CPU 核心数。这与浏览器验证组件的并行策略一致——验证组件把质询分发给多个 Web Worker 并行计算见 widget/src/src/worker.js 中 worker 按workerIndex/workerCount分块递增 nonce 的逻辑。在服务端workerCount决定了求解器并行搜索的通道数调大可降低单次求解延迟但会占用更多 CPU 资源。onProgress进度更新回调。当求解器在处理大量质询时可通过该回调获取当前进度用于日志记录、进度条展示或任务管理。仅基于种子的质询专属c要生成的解质询数量s质询大小盐长度d难度。也就是说{ c, s, d }只对字符串种子形式的调用有效传入质询列表时这些键会被忽略。底层原理求解器在算什么要正确使用求解器有必要理解它计算的对象。Cap 的 SHA-256 工作量证明遵循如下流程详见 Cap 是如何工作的服务端基于种子令牌与质询索引确定性派生每个质询的盐salt与目标前缀target客户端将盐与递增的nonce拼接计算 SHA-256 哈希检查哈希是否以目标前缀开头若不是nonce 递增后重试。在浏览器端这一循环由 Rust 编写的 WASM 与 Web Worker 并行执行见 widget/src/src/worker.js 中的solveFallback与 WASMsolve_pow分支cap.js/solver在服务端执行的是同样的算法——所以它绝不绕过工作量证明只是把计算位置从浏览器挪到了 Bun 进程里。服务端验证侧的对应逻辑可在capjs-core源码中印证core/src/index.jsconst salt prngFromHash(saltSeed, size); const target prngFromHash(targetSeed, difficulty); const hash sha256Bytes(salt solutions[i]); if (!powMatchesPrefix(hash, parseHexPrefix(target))) { return fail(invalid_solution); }验证方会用同样的种子派生方式重建每个质询的盐和目标再对提交的 nonce 重算一次 SHA-256 并与前缀比对。这也解释了为什么基于列表形式要求[盐, 目标]与种子派生结果完全一致服务端校验的是提交的 nonce 是否满足该盐/目标对应的哈希前缀条件而非 nonce 的来源。边界与限制仅支持 Bun库依赖 Bun 运行时特性不能直接在 Node.js 或浏览器中运行。不支持 instrumentation 质询instrumentation 质询是需要在真实浏览器沙箱中执行并回报指纹的检测型质询配置方式见 capjs-core 的 instrumentation 选项 与 Standalone 选项。服务端求解器无法伪造浏览器环境因此cap.js/solver对此类质询无能为力——如果你面对的密钥/路由开启了 instrumentation请走正常的浏览器验证组件流程。不绕过 PoW求解依然要消耗真实算力难度d越高期望哈希次数越多。若要降低服务端求解成本应与服务端协商更低的难度或更少的质询数量。注意协议Cap 的默认质询协议是抗 GPU 的 HashWXStandalone 新建密钥的默认协议。HashWX 与经典 SHA-256 PoW 的求解接口不同使用求解器前请确认目标服务签发的质询属于 SHA-256 PoW 格式对 HashWX 格式质询的求解验证组件使用独立的 WASM 运行时hashwx.wasmcap.js/solver的经典[salt, target]接口并不适用。完整实战示例综合以上内容一个典型的 M2M 集成流程如下import solver from cap.js/solver; // 从受保护服务获取质询令牌此处为示意实际由你的后端路由返回 const token await fetchChallengeToken(); // 1) 基于种子求解 50 个难度 4 的质询开满全部 CPU 核心 const solutions await solver(token, { c: 50, s: 32, d: 4, workerCount: 8, onProgress: (p) console.log(progress: ${p}), }); // 2) 把 nonce 数组作为 solutions 回传兑换 const { success, token: redeemToken } await fetch(/cap/redeem, { method: POST, headers: { content-type: application/json }, body: JSON.stringify({ token, solutions }), }).then((r) r.json()); if (success) { // 3) 用兑换令牌继续访问受保护的业务接口 }在调度大量求解任务、需要在主流程之外异步处理时请把求解逻辑放入 worker 池或独立进程避免阻塞 Bun 的事件循环——这一点与浏览器端把求解卸载到 Web Worker 的思路widget/src/src/worker.js是相通的。赞分享网络安全应用安全后端【免费下载链接】capFree, open-source and self-hosted CAPTCHA alternative to reCAPTCHA. Privacy-first and powered by proof-of-work and instrumentation challenges.项目地址https://gitcode.com/gh_mirrors/cap13/cap点击查看免费下载相关推荐使用 cap.js/solver 在 Bun 服务端求解 Cap 的 Proof-of-Work ChallengeM2M 场景指南使用 cap.js/solver 在 Bun 服务端求解 Cap 的 Proof of Work ChallengeM2M 场景指南 cap.js/so网络安全应用安全后端在 Bun 服务端用 cap.js/solver 求解 Cap PoW 挑战M2M 机器对机器集成指南在 Bun 服务端用 cap.js/solver 求解 Cap PoW 挑战M2M 机器对机器集成指南 本篇指南以 docs/de/guide/solver网络安全应用安全后端Cap 服务端 M2M 集成指南用 cap.js/solver 在 Bun 中离线求解 Proof-of-Work 挑战Cap 服务端 M2M 集成指南用 cap.js/solver 在 Bun 中离线求解 Proof of Work 挑战 cap.js/solver 是网络安全应用安全后端上一篇BilibiliDown 多平台B站视频下载器使用指南下一篇嘿数学爱好者用Markdown-it-KaTeX让你的数学公式飞起来创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Cap 服务端工作量证明求解器：在 Bun 上使用 `@cap.js/solver` 完成 M2M 质询
网络安全应用安全后端【免费下载链接】capFree, open-source and self-hosted CAPTCHA alternative to reCAPTCHA. Privacy-first and powered by proof-of-work and instrumentation challenges.项目地址https://gitcode.com/gh_mirrors/cap13/cap点击查看免费下载cap.js/solver是 Cap 开源 CAPTCHA 项目提供的一个独立服务端库用于在机器对机器M2M场景下直接求解 Cap 的工作量证明质询而无需经过浏览器验证组件。它零依赖、单文件、体积小巧求解速度与验证组件相当但只能在 Bun 运行时下使用。读完本文你将掌握该库的安装方式、两种质询输入形式基于种子与基于质询列表、全部可选参数workerCount、onProgress、c/s/d的语义并从源码层面理解其求解与验证背后的 SHA-256 工作量证明原理。什么是cap.js/solverM2M 场景的定位在 Cap 的常规流程中工作量证明质询由浏览器里的验证组件负责求解服务端签发质询客户端用 WASM 和 Web Worker 并行计算解再把解回传兑换令牌详见 Cap 是如何工作的。cap.js/solver把求解这一步搬到服务端执行服务于**机器对机器M2M**场景——例如你的后端服务需要自己先通过一次 Cap 质询才能继续调用受 CAPTCHA 保护的下游接口。与浏览器求解不同它没有 WASM 编译、Web Worker 调度、shadow DOM 等浏览器上下文依赖因此实现极度精简零依赖、单文件但求解吞吐与验证组件一样高效。需要明确的是这个包不会绕过任何实际的工作量证明。它按照与浏览器验证组件相同的算法老老实实计算 nonce所以服务端同样要付出对应的计算成本同时它不支持 instrumentation 质询instrumentation 是浏览器环境检测类质询需要真实浏览器环境才能通过服务端无法模拟详见下文边界与限制。安装该库只在 Bun 生态中分发使用 Bun 的包管理器安装即可bun add cap.js/solver安装后通过默认导出引入import solver from cap.js/solver;cap.js/solver与服务端签发/验证库是解耦的。如果你需要在自己后端签发质询可配合 Cap 的无状态服务端库capjs-core文档或开箱即用的 Cap Standalone 使用。用法一基于种子的质询seeded challenges最常用的形式是传入种子令牌challenge token与配置对象让求解器按种子生成并求解一组质询import solver from cap.js/solver; console.log( await solver(challenge token, { c: 50, // 质询数量 s: 32, // 盐的长度十六进制字符数 d: 4, // 难度目标前缀长度 }), );配置对象中的三个参数与验证组件/服务端库的生成参数一一对应cchallenge count要生成的质询数量。服务端默认签发50个质询因此通常传50。ssalt size每个质询的盐长度单位是十六进制字符数默认32。盐是工作量证明输入的一部分由种子确定性派生。ddifficulty难度即哈希结果需要匹配的目标前缀长度十六进制字符数默认4。d越大找到有效 nonce 的期望哈希次数越多。这三个参数与capjs-core中generateChallenge的challengeCount、challengeSize、challengeDifficulty默认值50、32、4完全对齐见 core/src/index.js 的参数校验逻辑。用法二基于质询列表challenge list第二种形式是直接传入质询列表列表中每个元素是[盐, 目标前缀]二元组。这种形式通常用于你已经从服务端拿到了具体的质询对只想针对它们逐一求解import solver from cap.js/solver; const challenges [ [a5b6fda4aaed97cf61d7dd9259f733b5, d455], [286bcc39249f9ee698314b600c32e40f, f0ff], [501350aa7c46573cb604284554045703, 4971], [a55c02f3b9b4cd088a5a7ee3d4941c14, eab7], [5f3362c12e2779f56f4ef75b4494f5e6, 999f], /* ... */ ]; console.log(await solver(challenges));列表形式下求解器不再自行生成质询而是对每个[salt, target]对直接暴力搜索有效 nonce因此不需要也不接受c/s/d这三个种子派生参数。输出示例[67302, 64511, 40440, 27959, 71259 /* ... */]输出的每个数字对应一个质询的有效 nonce顺序与输入质询列表或种子派生出的质询一一对应。拿到这些 nonce 后即可按验证组件同样的格式把它们作为solutions提交给服务端兑换令牌。第二个参数通用选项与种子专属选项第二个参数可选但任何时候都可以传入且始终是一个对象。它包含两类选项所有质询类型通用workerCount指定使用的 worker 数量默认值为 CPU 核心数。这与浏览器验证组件的并行策略一致——验证组件把质询分发给多个 Web Worker 并行计算见 widget/src/src/worker.js 中 worker 按workerIndex/workerCount分块递增 nonce 的逻辑。在服务端workerCount决定了求解器并行搜索的通道数调大可降低单次求解延迟但会占用更多 CPU 资源。onProgress进度更新回调。当求解器在处理大量质询时可通过该回调获取当前进度用于日志记录、进度条展示或任务管理。仅基于种子的质询专属c要生成的解质询数量s质询大小盐长度d难度。也就是说{ c, s, d }只对字符串种子形式的调用有效传入质询列表时这些键会被忽略。底层原理求解器在算什么要正确使用求解器有必要理解它计算的对象。Cap 的 SHA-256 工作量证明遵循如下流程详见 Cap 是如何工作的服务端基于种子令牌与质询索引确定性派生每个质询的盐salt与目标前缀target客户端将盐与递增的nonce拼接计算 SHA-256 哈希检查哈希是否以目标前缀开头若不是nonce 递增后重试。在浏览器端这一循环由 Rust 编写的 WASM 与 Web Worker 并行执行见 widget/src/src/worker.js 中的solveFallback与 WASMsolve_pow分支cap.js/solver在服务端执行的是同样的算法——所以它绝不绕过工作量证明只是把计算位置从浏览器挪到了 Bun 进程里。服务端验证侧的对应逻辑可在capjs-core源码中印证core/src/index.jsconst salt prngFromHash(saltSeed, size); const target prngFromHash(targetSeed, difficulty); const hash sha256Bytes(salt solutions[i]); if (!powMatchesPrefix(hash, parseHexPrefix(target))) { return fail(invalid_solution); }验证方会用同样的种子派生方式重建每个质询的盐和目标再对提交的 nonce 重算一次 SHA-256 并与前缀比对。这也解释了为什么基于列表形式要求[盐, 目标]与种子派生结果完全一致服务端校验的是提交的 nonce 是否满足该盐/目标对应的哈希前缀条件而非 nonce 的来源。边界与限制仅支持 Bun库依赖 Bun 运行时特性不能直接在 Node.js 或浏览器中运行。不支持 instrumentation 质询instrumentation 质询是需要在真实浏览器沙箱中执行并回报指纹的检测型质询配置方式见 capjs-core 的 instrumentation 选项 与 Standalone 选项。服务端求解器无法伪造浏览器环境因此cap.js/solver对此类质询无能为力——如果你面对的密钥/路由开启了 instrumentation请走正常的浏览器验证组件流程。不绕过 PoW求解依然要消耗真实算力难度d越高期望哈希次数越多。若要降低服务端求解成本应与服务端协商更低的难度或更少的质询数量。注意协议Cap 的默认质询协议是抗 GPU 的 HashWXStandalone 新建密钥的默认协议。HashWX 与经典 SHA-256 PoW 的求解接口不同使用求解器前请确认目标服务签发的质询属于 SHA-256 PoW 格式对 HashWX 格式质询的求解验证组件使用独立的 WASM 运行时hashwx.wasmcap.js/solver的经典[salt, target]接口并不适用。完整实战示例综合以上内容一个典型的 M2M 集成流程如下import solver from cap.js/solver; // 从受保护服务获取质询令牌此处为示意实际由你的后端路由返回 const token await fetchChallengeToken(); // 1) 基于种子求解 50 个难度 4 的质询开满全部 CPU 核心 const solutions await solver(token, { c: 50, s: 32, d: 4, workerCount: 8, onProgress: (p) console.log(progress: ${p}), }); // 2) 把 nonce 数组作为 solutions 回传兑换 const { success, token: redeemToken } await fetch(/cap/redeem, { method: POST, headers: { content-type: application/json }, body: JSON.stringify({ token, solutions }), }).then((r) r.json()); if (success) { // 3) 用兑换令牌继续访问受保护的业务接口 }在调度大量求解任务、需要在主流程之外异步处理时请把求解逻辑放入 worker 池或独立进程避免阻塞 Bun 的事件循环——这一点与浏览器端把求解卸载到 Web Worker 的思路widget/src/src/worker.js是相通的。赞分享网络安全应用安全后端【免费下载链接】capFree, open-source and self-hosted CAPTCHA alternative to reCAPTCHA. Privacy-first and powered by proof-of-work and instrumentation challenges.项目地址https://gitcode.com/gh_mirrors/cap13/cap点击查看免费下载相关推荐使用 cap.js/solver 在 Bun 服务端求解 Cap 的 Proof-of-Work ChallengeM2M 场景指南使用 cap.js/solver 在 Bun 服务端求解 Cap 的 Proof of Work ChallengeM2M 场景指南 cap.js/so网络安全应用安全后端在 Bun 服务端用 cap.js/solver 求解 Cap PoW 挑战M2M 机器对机器集成指南在 Bun 服务端用 cap.js/solver 求解 Cap PoW 挑战M2M 机器对机器集成指南 本篇指南以 docs/de/guide/solver网络安全应用安全后端Cap 服务端 M2M 集成指南用 cap.js/solver 在 Bun 中离线求解 Proof-of-Work 挑战Cap 服务端 M2M 集成指南用 cap.js/solver 在 Bun 中离线求解 Proof of Work 挑战 cap.js/solver 是网络安全应用安全后端上一篇BilibiliDown 多平台B站视频下载器使用指南下一篇嘿数学爱好者用Markdown-it-KaTeX让你的数学公式飞起来创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
