CapSkip 入门

一份完整的分步指南,帮你完成配置并开始识别验证码。

  1. 1
    下载并安装

    下载 Windows 应用程序,安装 CapSkip 并启动它。

    下载 CapSkip
  2. 2
    登录

    点击 登录 并输入授权邮件中的用户名和密码。如果忘记密码,请点击 在此重置 链接。

    立即获取你的授权
  3. 3
    查看状态栏

    登录后,窗口底部的状态栏会显示你的授权类型、已用连接数与允许的连接数上限,以及 CapSkip 是否已连接。

监控 实时显示验证码识别活动,每种验证码类型都有自己的板块:图片验证码、Google reCAPTCHA、Cloudflare Turnstile、hCaptcha、AWS WAF、极验、ALTCHA、CaptchaFox、Capy、Friendly Captcha 和 DataDome。

监控标签页调整板块顺序 · 显示与隐藏 · 筛选 · 统计 · 任务列表

CapSkip Monitor tab showing several CAPTCHA sections

监控标签页用于查看验证码的识别过程。每种验证码类型都有自己的板块,显示实时统计;浏览器类和工作量证明类验证码还带有任务列表。

调整板块顺序

每个板块名称左侧都有一个点状拖动手柄。上下拖动板块,即可把最常用的验证码类型放在顶部。顺序会被保存,重启 CapSkip 后依然保留。

显示与隐藏

每个板块的右上角都有一个 隐藏 按钮,用于折叠该板块。在图片验证码板块中,它会隐藏图片、结果卡片和图表;在其他板块中,它会隐藏任务列表。板块隐藏时计数器仍会持续更新,而且在高负载下隐藏板块可以减少 CPU 占用。 显示 按钮可将其重新展开。

此功能取代了早期版本中的“禁用界面更新”选项。

筛选

带有任务列表的板块都有一个 筛选 菜单,可以显示“全部任务”,或只显示“等待中”“进行中”或“已完成”的任务。

统计

每个板块显示三个统计卡片: 成功,即已识别的任务数; 节省金额,即同样数量的识别在付费验证码服务上需要花费的金额;以及 耗时,即通常的识别耗时。

下方一行显示活动线程数与最大线程数,以及在队列中等待的任务数。reCAPTCHA、Cloudflare Turnstile、CaptchaFox 和 Capy 还会统计 无效密钥,即因 site key 无效而被拒绝的任务;reCAPTCHA 和 Turnstile 还会统计 IP 封禁,即被验证码提供商拦截的任务,这通常意味着你需要更换代理。

任务列表

每个任务都会显示其页面 URL、耗时、当前步骤、所用代理(未使用代理时显示“直接”)以及带颜色的状态标签。右键点击任务,可以在浏览器中打开其 URL 或查看任务详情。

任务详情

双击任意任务,或右键点击任务并选择 显示任务详情,即可准确查看发送给 CapSkip 的内容:页面 URL、参数和原始请求,每项都带有“复制”按钮。这是检查集成最快捷的方法。

对于失败的 Cloudflare Turnstile 任务,在开启 调试模式 的情况下,窗口还会显示识别器看到的内容:浏览器截图、结果以及停止的原因。

CapSkip task details window for a reCAPTCHA task

图片验证码上传图片 · 屏幕识别 · 文件夹识别 · 开放 API

Image CAPTCHA section on the CapSkip Monitor tab

此板块可用于测试图片验证码并立即查看结果。它还会统计通过 API 识别的每一个图片验证码。

图片处理完成后,旁边会显示其答案、置信度、识别耗时和检测到的类型。总请求数、已解决和失败统计所有处理过的图片验证码。当 实时图表 开启时,会有两张图表分别显示传入请求和队列。

上传图片

上传单个图片文件以手动测试验证码识别。

屏幕识别

选择并截取屏幕上的某个区域,即时识别验证码。

文件夹识别

批量处理一个文件夹中的所有图片。

开放 API

在浏览器中打开 CapSkip 的本地 API 页面。该页面会显示服务器是否正在运行、CapSkip 正在模拟的服务、API 端点以及是否开启了 API 密钥验证,并提供 API 文档、SDK 和浏览器扩展的链接。

那里显示的 API 端点就是你的软件或代码发送请求的地址。

Google reCAPTCHA此板块显示 Google reCAPTCHA 任务的实时统计和任务列表。

Google reCAPTCHA section on the CapSkip Monitor tab

此板块显示 Google reCAPTCHA 任务的实时统计和任务列表。

每个 URL 旁的徽标显示 reCAPTCHA 版本: v2, v2 inv 表示隐形 v2, v3,以及 ent 表示 Enterprise。“点击”列显示通过 v2 挑战时点击了多少个图片方块。

Cloudflare Turnstile此板块显示 Cloudflare Turnstile 任务的实时统计和任务列表。

Cloudflare Turnstile section on the CapSkip Monitor tab

此板块显示 Cloudflare Turnstile 任务的实时统计和任务列表。

每个 URL 旁的徽标显示任务类型: Turnstile 表示 Turnstile 小组件, Challenge 表示为获取令牌而求解的 Cloudflare 质询页面,或 Clearance 表示 cf_clearance Cookie 任务。

调试模式,开启后可双击失败的任务,查看浏览器截图及其停止原因。

hCaptcha此板块显示 hCaptcha 任务的实时统计和任务列表。

hCaptcha section on the CapSkip Monitor tab

此板块显示 hCaptcha 任务的实时统计和任务列表。

每个 URL 旁的徽标显示正在作答的挑战类型,例如 闭合环 或 拖放。在挑战类型确定之前,徽标显示 hCaptcha。

如果 hCaptcha 拒绝任务的 site key,该任务最终的状态为 站点密钥无效.

AWS WAF此板块显示 AWS WAF 验证码任务的实时统计和任务列表。

AWS WAF section on the CapSkip Monitor tab

此板块显示 AWS WAF 验证码任务的实时统计和任务列表。

每个 URL 旁的徽标显示拼图类型: 网格 表示图片网格, 玩具车 表示玩具车路径拼图;在拼图类型确定之前显示 WAF。

任务运行时,“任务”列会显示当前步骤,包括图片网格要求选择的物体,例如“选择椅子”。

极验此板块显示极验任务的实时统计和任务列表。

GeeTest section on the CapSkip Monitor tab

此板块显示极验任务的实时统计和任务列表。

ALTCHA此板块显示 ALTCHA 工作量证明挑战的实时统计和任务列表。

ALTCHA section on the CapSkip Monitor tab

此板块显示 ALTCHA 工作量证明挑战的实时统计和任务列表。

“数值”列显示 CapSkip 为解出该挑战而找到的数值,大致反映了该挑战所需的计算量。

CaptchaFox此板块显示 CaptchaFox 任务的实时统计和任务列表。

CaptchaFox section on the CapSkip Monitor tab

此板块显示 CaptchaFox 任务的实时统计和任务列表。

Capy此板块显示 Capy 拼图任务的实时统计和任务列表。

Capy section on the CapSkip Monitor tab

此板块显示 Capy 拼图任务的实时统计和任务列表。

“位置”列显示拼图块被放置的位置。

Friendly Captcha此板块显示 Friendly Captcha v1 和 v2 任务的实时统计和任务列表。

Friendly Captcha section on the CapSkip Monitor tab

此板块显示 Friendly Captcha v1 和 v2 任务的实时统计和任务列表。

“哈希数”列显示每次识别所需的工作量证明计算量。对于 Friendly Captcha v2,它还反映了该服务针对该地址设置的谜题难度。

DataDome此板块显示 DataDome 任务的实时统计和任务列表。

DataDome section on the CapSkip Monitor tab

此板块显示 DataDome 任务的实时统计和任务列表。

每个 URL 旁的徽标显示挑战类型: 滑块, 拼图 或 设备检查。在挑战类型确定之前,徽标显示 DataDome。

被 DataDome 拦截的任务最终的状态为 IP 被封禁,这通常意味着需要更换代理。

连接设置服务模拟 · 端口 · Hosts 文件

CapSkip Connection settings: service emulator, port and hosts file

连接板块用于设置 CapSkip 模拟哪个验证码服务,以及在哪里监听来自你软件的 API 请求。

服务模拟

服务模拟功能让 CapSkip 能够复刻主流验证码识别服务的 API,因此无需修改第三方软件,即可将其连接到 CapSkip。

支持的服务:2captcha.com、rucaptcha.com、Anti-Captcha、CapMonster Cloud、CapSolver、DeathByCaptcha、SolveCaptcha、NextCaptcha、EzCaptcha 和 Captchas.io。

选择某个服务后,CapSkip 会完全按照该服务的格式响应请求。例如,如果你的软件已经支持 2Captcha,只需在 CapSkip 中选择 2captcha.com,把软件指向 CapSkip 的地址,其余配置保持不变即可。

如果你的软件无法更改请求的发送地址,请使用下方的 Hosts 文件 选项,这样原本发往真实服务的请求会被自动转发到 CapSkip。

正是服务模拟功能让 CapSkip 能够完全取代付费验证码服务,同时与你现有的自动化工具保持兼容。

端口

端口设置决定 CapSkip 如何接收来自你软件的 API 请求。

  • 本地:CapSkip 仅在本机(127.0.0.1)上监听。当你的软件和 CapSkip 运行在同一台机器上时推荐使用。
  • 服务器:CapSkip 还会接受来自网络中其他设备的连接,或在 VPS 上接受来自互联网的连接。推荐用于 VPS 或独立服务器部署,静态公网 IP 可以提供最稳定的远程访问。服务器模式需要以管理员身份运行 CapSkip。

数字框用于设置 CapSkip 监听的端口,范围为 1024 到 65535。请确保没有其他应用占用该端口;如果已被占用,CapSkip 会发出提醒并推荐一个空闲端口。

Hosts 文件

添加 会把所选服务的官方地址指向你本地的 CapSkip,方法是在 Windows Hosts 文件中添加一条记录。

添加后,你的软件发往原服务的每个请求都将改由 CapSkip 响应。软件配置保持不变,因此在无法更改地址时,这是集成 CapSkip 最简单的方式。

移除 会删除该记录,并恢复对真实服务的正常访问。用它来停止通过 CapSkip 转发流量。

修改 Hosts 文件需要管理员权限。

验证码类型线程、超时、重试与代理

CapSkip Captcha types settings with all eleven CAPTCHA types

CapSkip 识别的每种验证码类型在“验证码类型”板块中都有自己的一行。每一行都会实时显示其当前设置的摘要,例如 线程 10 · 等待 250 秒 · 单行 60 秒 · 重试 1 · 无代理。点击某一行即可展开;展开一行时,其他行会自动收起。

线程、超时、重试与代理

reCAPTCHA、Cloudflare、hCaptcha、AWS WAF、极验、ALTCHA、CaptchaFox、Capy、Friendly Captcha 和 DataDome 这几行都以相同的五个控件开头:

  • 最大线程数:CapSkip 同时识别的此类任务数量。数值越高吞吐量越大,但会占用更多 CPU、RAM 和代理资源,请根据系统的承受能力来设置。
  • 等待超时:任务在队列中等待空闲线程的秒数,超时后放弃。
  • 单行超时:单次识别开始后最多可持续的秒数。超过该时间,任务会被停止并标记为失败。大多数类型默认为 60 秒,识别耗时较长的类型默认值更高:reCAPTCHA 为 250 秒,CaptchaFox 和 AWS WAF 为 150 秒,hCaptcha、Friendly Captcha 和 DataDome 为 120 秒。对于 CaptchaFox、AWS WAF、hCaptcha、Friendly Captcha 和 DataDome,该默认值也是可设置的最小值。
  • 重试次数 (0-3):CapSkip 重试失败尝试的次数,默认为 1。重试次数越多,成功率越高,但可能延长总识别时间。重试进行时,任务列表的“任务”列会显示“重试 1”“重试 2”等。
  • 配置代理:打开此验证码类型的代理设置。每种类型都有自己的代理列表;详见 代理配置.
图片验证码设置识别模型 · 自动算术计算 · 置信度过滤

CapSkip Image captcha settings

图片验证码这一行控制 CapSkip 如何识别图片验证码:加载哪些识别模型、算术求解以及置信度过滤。

识别模型

选择模型 按钮用于指定为图片验证码加载哪些 AI 模型。只加载需要的模型可以提升性能并减少内存占用。

在模型选择窗口中,你可以逐个勾选模型或加载预设,也可以只显示已启用的模型,然后点击 确定 应用你的选择。至少要保留一个已选模型。点击某个模型可以查看其属性和示例图片。

CapSkip Model Selection window

自动算术计算

当模型识别出“2 + 3 = ?”这类算式时,CapSkip 会返回计算结果而不是原文。如果你需要数学验证码的原始文本,请关闭此选项。

置信度过滤

置信度过滤控制 CapSkip 如何处理低置信度结果。默认关闭。

模型会为每个识别出的图片验证码给出置信度分数。开启过滤后,选择 10% 到 90% 之间的阈值,并输入要替代返回的文本。当结果的置信度低于阈值时,CapSkip 会返回你设置的文本,例如 ERROR_CAPTCHA_UNSOLVABLE,这样你的软件就能将其视为识别失败并请求新的验证码。

reCAPTCHA 设置线程、超时、重试与代理 · reCAPTCHA v2 快速解决 · reCAPTCHA v3 高分模式 · 显示数据无效的任务

CapSkip reCAPTCHA settings

配置 Google reCAPTCHA v2 和 v3 的识别:线程、超时、重试、代理以及下方的 reCAPTCHA 选项。

配置代理

要稳定识别 reCAPTCHA,必须使用代理。Google 会限制单个 IP 地址的识别量,因此稳定、干净的代理对成功率影响最大。 点击此处查看代理设置

reCAPTCHA v2 快速解决

可在 10 秒内识别 reCAPTCHA v2。默认开启,需要住宅代理或移动代理。

如果快速解决未成功,任务会自动转为标准的图片挑战识别,因此保持开启绝不会让你损失一次识别。如果你没有为 reCAPTCHA 使用住宅代理或移动代理,请关闭此选项,每个任务可节省几秒钟。

在检查更严格的网站上,快速解决需要本机已安装 Google Chrome。

reCAPTCHA v3 高分模式

提高严格 site key 上的 reCAPTCHA v3 分数。

默认关闭,因为它只对评分严苛的网站有帮助,而且每次识别会占用更多内存和 CPU。如果你的 v3 token 已经被接受,请保持关闭。当网站拒绝 CapSkip 成功交付的 token 时再开启它,这通常意味着分数太低,而不是识别失败。

必须安装 Google Chrome。如果未安装,开关下方的提示会说明这一点,v3 仍会正常识别。只要高分模式无法运行,CapSkip 也会回退到正常识别,因此开启它绝不会导致识别中断。

显示数据无效的任务

默认关闭。开启后,site key 或页面 URL 无效的任务也会显示在监控标签页上,并附带失败原因,而不是在到达时直接丢弃。这在你接入集成时很有帮助:一个只留下错误代码就消失的任务,比一条可见的失败记录更难调试。代价是,如果某个客户端不断发送格式错误的请求,列表会变得更杂乱。

Cloudflare 设置线程、超时、重试与代理 · 为 Cloudflare 使用自定义浏览器 · 返回 cf_clearance Cookie · 调试模式

CapSkip Cloudflare settings

配置 Cloudflare 求解:线程数、超时、重试次数、代理以及下面的选项。线程数、超时和重试次数同样适用于 Turnstile 任务和 cf_clearance 任务。

配置代理

要稳定地求解 Turnstile,必须使用代理。请确保代理稳定、干净且配置正确。cf_clearance 任务不使用此列表:每个任务都通过其 API 请求中发送的代理运行。 点击此处查看代理设置

为 Cloudflare 使用自定义浏览器

默认情况下,CapSkip 在 Chromium 中求解 Turnstile。开启此选项后会改用 CapSkip 自定义浏览器求解,速度更快、CPU 占用更少,但检查更严格的网站可能会拒绝它。此选项不影响 cf_clearance 任务。

返回 cf_clearance Cookie

允许 API 请求获取位于 Cloudflare 整页检查(即 “Just a moment...” 页面)之后的网站的 cf_clearance Cookie,而不是 Turnstile 令牌。之后您的工具即可用普通 HTTP 请求访问该网站。

此选项默认关闭,关闭期间这类请求会被拒绝。每个请求都必须包含代理,因为该 Cookie 只能在获取它的地址上使用。如果您的工具发送自己的 User-Agent,它必须是 Windows 版 Chrome,且版本与此电脑上安装的 Google Chrome 相同。否则请不要发送,改用 CapSkip 随 Cookie 一起返回的 User-Agent。 在 API 文档中查看请求格式

调试模式

记录 Cloudflare 任务(Turnstile 或 cf_clearance)失败的原因,让您看到问题所在,而不必根据状态列去猜测。

默认关闭。开启后复现问题,然后在监控标签页上双击失败的任务打开其详情:识别器放弃时浏览器显示内容的截图、当时到达的阶段、运行时长,以及一段通俗的停止原因说明。

成功的任务不会捕获任何内容。相关处理只在任务失败之后才进行,因此保持开启不会拖慢正常识别,不过每次失败会产生一张截图。截图保存在 %AppData%\CapSkip\Debug\cloudflare,只保留最新的 120 张。

hCaptcha 设置线程、超时、重试与代理 · hCaptcha 高分模式

CapSkip hCaptcha settings

为 hCaptcha 配置线程、超时、重试和代理,以及下方的高分模式选项。

配置代理

hCaptcha 在浏览器中识别,因此代理在这里很重要。它只使用你在这一行中添加的代理:列表为空时,hCaptcha 任务会直接通过你自己的 IP 地址识别。随任务发送的代理始终优先于列表使用。 点击此处查看代理设置

hCaptcha 高分模式

提高严格 site key 上的分数。默认开启,需要本机已安装 Google Chrome。

如果未安装 Google Chrome,该开关会被关闭并变为灰色,开关下方的提示也会说明这一点。无论哪种情况,hCaptcha 都会正常识别。

AWS WAF 设置线程、超时、重试与代理 · 快速解决

CapSkip AWS WAF settings

为 AWS WAF 验证码配置线程、超时、重试和代理,以及下方的“快速解决”选项。

配置代理

AWS WAF 只使用你在这一行中添加的代理:列表为空时,AWS WAF 任务会直接通过你自己的 IP 地址识别。随任务发送的代理始终优先于列表使用。 点击此处查看代理设置

快速解决

默认关闭。开启后,每个识别线程最多可同时打开 4 个代理连接,让通过代理的识别更快。

如果你的代理套餐限制了可同时打开的连接数或线程数,请保持关闭,因为此时每个线程会被计为多个。

极验设置线程、超时、重试与代理

CapSkip GeeTest settings

为极验挑战配置线程、超时、重试和代理。

配置代理

要稳定识别极验,必须使用代理。请确保代理稳定、干净且配置正确。 点击此处查看代理设置

ALTCHA 设置线程、超时、重试与代理

CapSkip ALTCHA settings

为 ALTCHA 工作量证明挑战配置线程、超时、重试和代理。

配置代理

ALTCHA 在你的 CPU 上本地识别。只有当任务发送挑战 URL、需要 CapSkip 去获取时,才会使用代理。自带挑战内容的任务无需任何网络请求即可识别,因此大多数配置在这里都不需要代理。

CaptchaFox 设置线程、超时、重试与代理

CapSkip CaptchaFox settings

为 CaptchaFox 配置线程、超时、重试和代理。

配置代理

CaptchaFox 在浏览器中识别,因此代理在这里很重要。它只使用你在这一行中添加的代理:列表为空时,CaptchaFox 任务会直接通过你自己的 IP 地址识别。

Capy 设置线程、超时、重试与代理

CapSkip Capy settings

为 Capy 拼图配置线程、超时、重试和代理。

配置代理

代理仅用于获取 Capy 的拼图图片,这也是 Capy 识别唯一会发出的请求。

Friendly Captcha 设置线程、超时、重试与代理

CapSkip Friendly Captcha settings

为 Friendly Captcha v1 和 v2 配置线程、超时、重试和代理。

配置代理

每个 Friendly Captcha 请求都会使用代理。对于 v2 尤其值得设置:它要求的工作量证明会随着某个地址的识别量增加而上升,因此把 v2 任务分散到多个代理上可以降低每次识别的计算量。

DataDome 设置线程、超时、重试与代理

CapSkip DataDome settings

为 DataDome 配置线程、超时、重试和代理。

配置代理

DataDome 返回的是一个 Cookie,而该 Cookie 只能在识别它的 IP 地址上使用。因此,除非你的软件会继续通过这些代理浏览,否则请让此列表保持为空。当 CapSkip 通过此列表中的代理识别时,结果会注明该代理以及与 Cookie 搭配使用的 User-Agent。

随任务发送的代理始终优先于此列表,而且这通常是更好的选择:请发送你的软件在后续访问中会使用的代理。当列表为空且任务未附带代理时,任务会通过你自己的 IP 地址识别。

代理配置推荐 · 代理列表格式 · 添加代理 · 检查代理 · 复用代理

CapSkip reCAPTCHA Proxy Configuration window

每种验证码类型都有自己的代理配置,可通过所在行的“配置代理”按钮打开。窗口标题会显示你正在编辑的是哪种类型。

图片验证码识别不使用代理。对于 reCAPTCHA、Cloudflare Turnstile、hCaptcha、AWS WAF、极验和 CaptchaFox,代理决定你的成功率。ALTCHA、Capy 和 Friendly Captcha 只在上文各自板块所述的请求中使用代理。DataDome 是特殊情况,详见 DataDome 设置.

根据您的部署选择代理类型:

  • 无代理:使用你自己的 IP 地址。短时间内可以工作,但重复请求很可能导致你的 IP 被封锁。
  • Tor(SOCKS5):使用本地 Tor 服务。请设置 Tor SOCKS 端口:Tor 守护进程或 Expert Bundle 使用 9050,Tor Browser 使用 9150。
  • SOCKS5 代理列表:用于 SOCKS5 代理列表。
  • SOCKS5(DNS 经代理)列表:DNS 解析也会经由代理进行。
  • HTTP/HTTPS 代理列表:标准 HTTP 或 HTTPS 代理。
  • 单个自定义代理:一个专用代理,需填写协议、主机、端口以及可选的用户名和密码。 测试连接 按钮可检查它是否正常工作。

选择与您代理提供商相匹配的类型。

推荐

决定成功率的是代理 IP 地址的信誉,而不是它的协议。reCAPTCHA 和 Cloudflare 会对每个访问它们的地址打分,而且它们知道哪些地址段属于托管服务商。

  • 住宅代理和移动代理 使用互联网服务商分配给家庭和手机的地址。它们的信誉最好:挑战更少也更简单,reCAPTCHA v3 分数更高,IP 封禁更少。reCAPTCHA v2 快速解决需要这类代理。
  • ISP 代理,也被称为静态住宅代理,它们运行在数据中心,但注册在面向消费者的互联网服务商名下。其可信度几乎与住宅地址相当,而且速度更快、更稳定。
  • 数据中心代理 价格便宜、速度快,但其地址已知属于托管服务商。reCAPTCHA 会对它们给出更多、更难的图片挑战和较低的 v3 分数,快速 v2 任务也会回退到较慢的图片挑战。Cloudflare Turnstile 通常更宽容,但住宅和 ISP 地址的失败率仍然更低。
  • 使用私有代理。 共享代理会同时被其他客户使用,他们的任何行为也会降低该代理对你而言的信誉。避免使用免费的公共代理列表:它们速度慢,大多已被列入黑名单,而且运营者可以看到经过的流量。
  • 整个识别过程保持同一个 IP。 一次识别会发出许多请求。如果你的服务商提供轮换网关,请使用持续几分钟的粘性会话,而不是每个请求都更换 IP,这样地址就不会在挑战进行到一半时改变。大多数服务商允许创建多个粘性会话;将每个会话单独添加为一行,CapSkip 就能把任务分散到它们上面。
  • 准备足够数量的代理。 Google 和 Cloudflare 会限制单个地址的识别量。代理数量至少应与最大线程数相同,这样同时运行的任务就不会共用一个地址;如果监控标签页开始统计到 IP 封禁,请再增加代理。
  • 协议任选。 HTTP、HTTPS、SOCKS5 和 SOCKS5h 都可以使用,协议不会改变网站看待该地址的方式,所以用你的服务商提供的任意一种即可。SOCKS5h 还会通过代理解析域名,当你自己的 DNS 被过滤时很有用。

加载列表后,点击 检查代理 即可在失效代理造成任务失败之前把它们找出来。

代理列表格式

CapSkip 支持三种格式,每行一个代理。请使用您的代理提供商提供的格式:

  • host:port
    如果你已在代理服务商的控制面板中将自己的 IP 地址加入白名单,请使用此格式。
  • username:password@host:port
    如果你的代理需要用户名和密码,请使用此格式。
  • host:port:username:password
    如果您的代理提供商导出的认证代理将用户名和密码放在端口之后,请使用此格式。直接粘贴列表即可,无需转换。

添加代理

您可以通过三种方式添加代理:

  • 直接粘贴到列表中
  • 从 URL 加载,并可选择每隔 5 分钟、30 分钟、1 小时或 1 天自动从该 URL 刷新列表
  • 从文件加载

加载完成后,窗口会显示已配置的代理数量。

检查代理

检查代理 按钮会测试列表中的每个代理。测试线程数决定同时测试多少个,范围为 1 到 100。结果会显示可用代理的数量、平均响应时间以及哪些代理失败。

复用代理

复用代理 按钮可复制其他验证码类型的代理设置,无需多次粘贴同一份列表。

每次请求轮换代理

启用此选项后,每个新的验证码请求都会使用不同的代理。这可以提高成功率,并降低遭遇基于 IP 的速率限制的风险。

随任务发送的代理

如果你的软件随任务本身发送了代理,例如通过 2Captcha 的 proxy 和 proxytype 参数,或使用非 Proxyless 的任务类型,CapSkip 会通过该代理而不是这里的列表来识别该任务,重试时也会继续使用该代理。

这对 Cloudflare 挑战页面尤为重要。Cloudflare 会将 clearance cookie 绑定到获得它的访问者和设备上,因此请发送你的软件后续浏览时会继续使用的代理,并将 CapSkip 返回的 clearance 与随附的 User-Agent 一起使用。

API 密钥验证管理密钥 · 额度 · 同一时间仅限一台设备 · 密钥状态页 · 远程密钥管理

CapSkip API access settings with API Key Validation on

API 密钥验证位于 API 访问板块中,用于控制哪些 API 密钥可以向你的 CapSkip 实例发送请求。

开启后,只有携带你的某个密钥的请求才会被处理。密钥无效或缺失的请求将被拒绝。

关闭后,CapSkip 接受任意密钥值的请求。API 格式仍然要求提供 key 参数,但任何字符串都会被接受。

当 CapSkip 运行在多个用户或外部工具都能访问的 VPS 或服务器上时,这一点尤其有用。

管理密钥

开启验证后,选择管理密钥的方式:

  • 直接输入:点击 添加密钥,为密钥命名,然后输入一个密钥或点击“生成”来创建。密钥会出现在列表中,你可以在那里复制或移除它们。
  • 从文件:点击 浏览 选择包含密钥的文本文件;编辑文件后,点击 刷新 即可重新加载。 添加密钥 和移除按钮在此模式下同样可用:它们会把更改直接写入文件本身,被移除的密钥会立即失效。在每行一个密钥的纯文本文件中,新密钥会作为没有名称的新行添加。

额度

每个密钥都有一个额度列。点击某个密钥,即可查看每种验证码类型的剩余额度、已用额度和失败次数,以及该密钥的上次使用时间。

设置上限 为密钥设置每种验证码类型的额度上限:图片转文字、reCAPTCHA、Turnstile、极验、ALTCHA、CaptchaFox、Capy、Friendly Captcha、AWS WAF、DataDome 和 hCaptcha。每个数字是该类型累计授予的总额度,而不是剩余额度。只有成功的识别才会消耗额度。将某个类型保留为“无限制”即可停止对其计数。

每分钟请求数,它位于同一窗口中,用于限制该密钥每分钟可发送的新任务数,所有验证码类型合计。超出限制的请求会被要求在几秒后重试。保留“无限制”即不设上限。设置后,密钥会显示其上限以及最近一分钟内发送的请求数。

你也可以在创建密钥时,在“添加密钥”窗口中设置这些上限。

更新 CapSkip 后,使用量会保留。

同一时间仅限一台设备

同一时间仅限一台设备 是每个密钥上的一个开关。开启后,该密钥同一时间只能从一个 IP 地址使用:第一个发送任务的地址会在其任务运行期间及之后一分钟内占用该密钥。来自其他任何地址的新任务会以 ERROR_IP_NOT_ALLOWED 被拒绝,而查询已发送任务的结果始终可用。

当你出售或共享密钥、并希望每个密钥只在一台机器上使用时,这很有用。密钥会显示其是否正在使用、来自哪个地址,以及有多少来自其他地址的尝试被拦截。

密钥状态页

开启 API 密钥验证后,CapSkip 还会在其 API 地址的 /key 路径上提供密钥状态页,也就是你的软件发送请求的同一地址。持有密钥的人可以把密钥粘贴到那里,查看其各验证码类型的额度、当前可识别的类型、近期使用情况以及“同一时间仅限一台设备”的状态。

密钥只发送一次,绝不会保存在浏览器或地址栏中,页面会话在 30 分钟后结束。API 起始页提供了指向它的链接,因此在服务器模式下,你的客户无需询问你即可自行查看他们的密钥。

CapSkip credit limits window for an API key

远程密钥管理

让你从另一台机器通过 HTTP 添加、列出和删除识别用的 API 密钥,无需远程桌面连接到运行 CapSkip 的电脑。它是上述密钥列表在服务器模式下的对应功能:同样的密钥,可以在你管理这台机器的任何地方进行管理。

默认关闭,只有在你同时开启它并生成 token 后才会生效。关闭期间,管理路由只会返回普通的 404,因此扫描甚至无法判断该功能是否存在。

生成 会生成一个 256-bit 随机 token 并仅显示一次,附带“复制”按钮。请立即复制:CapSkip 只存储加盐哈希,因此无法再次显示。之后该行会显示 token 的生成时间。生成新 token 会替换旧 token,因此仍在使用旧 token 的客户端都会开始收到 401 响应。

撤销 会清除已保存的 token。相关端点仍然保持可访问,但在你生成新 token 之前会拒绝一切请求。

要完整了解如何实际使用这些端点,请参阅 如何为你的客户开通验证码 API 密钥。文中涵盖了完整流程:开启远程密钥管理并生成 token、通过订阅 webhook 使用 /admin/keys/add 发放密钥、在取消订阅时使用 /admin/keys/delete 撤销密钥,以及使用 /admin/keys/list 将实时密钥列表与你的账单记录进行核对。

允许的管理 IP

允许的管理 IP 将远程密钥管理限制为你列出的地址:单个 IP 或 CIDR 范围,IPv4 或 IPv6 均可,用逗号或换行分隔。留空则允许任何 IP。

来自不在列表中的地址的请求,会收到与远程密钥管理关闭时相同的普通 404,因此对方无法判断该功能是否存在。

应用设置主题 · 界面语言 · 开机启动 · 安全显示模式 · 关闭到托盘

CapSkip App settings

应用板块包含 CapSkip 的常规偏好设置。

主题

主题 用于设置 CapSkip 的外观。 自动 跟随 Windows 的浅色或深色设置,而 浅色 和 深色 则固定使用对应主题。主题更改会立即生效。

界面语言

选择你偏好的界面语言。CapSkip 支持英语、阿拉伯语、简体中文、法语、德语、意大利语、日语、韩语、波斯语、葡萄牙语(巴西)、俄语和西班牙语。

开机启动

在你登录 Windows 时自动启动 CapSkip 并登录账号,使其始终保持运行、随时可以识别验证码,无需手动启动。

安全显示模式

不使用显卡绘制 CapSkip。如果 CapSkip 打开后显示为空白窗口(某些显卡驱动程序会出现这种情况),请使用此选项。重启 CapSkip 后生效。

当 CapSkip 发现其窗口未能显示时,会主动提示以安全显示模式重启。你可以在这里再次将其关闭。

关闭到托盘

默认开启。关闭窗口后,CapSkip 会继续在通知区域运行,API 服务器也会在后台继续识别。要退出,请右键点击托盘图标并选择 退出. 打开 CapSkip 位于同一菜单中,可重新显示窗口。

在 CapSkip 已运行时再次启动它,也会重新显示已打开的窗口,而不会启动第二个副本。

软件更新

显示 CapSkip 是否为最新版本以及上次检查的时间。 立即检查 按钮会查找新版本。

有可用更新时,请尽快安装,以获得最新的修复和改进。要了解每个版本的更改内容,请查看 更新日志.

帮助与诊断快速上手 · 诊断报告 · 自动发送崩溃报告 · 实时图表 · API 请求日志

CapSkip Help and diagnostics settings

帮助与诊断板块包含导览、故障排查工具,以及图表、日志和重置 CapSkip 的相关选项。

快速上手

开始导览 按钮会运行快速导览,介绍开始识别所需的设置。整个过程约两分钟,内容包括:

  • 选择你的软件或代码已经在使用的服务
  • CapSkip 在哪里监听,以及何时需要 Hosts 文件
  • 线程、超时与代理
  • 解读监控统计数据
  • 安装适用于 Chrome 或 Firefox 的 CapSkip 浏览器扩展
  • 在我们的演示页面上用真实验证码进行试用

安装后首次打开 CapSkip 时,会自动提示你开始导览。

诊断报告

针对你当前遇到的问题发送诊断报告。代理等敏感数据会被遮蔽。

发送报告 按钮会先打开一个简短的“描述问题”对话框。请告诉我们你当时想做什么、看到的错误信息、如何复现以及问题何时开始出现。随后 CapSkip 会收集报告并上传。如果当时无法连接到我们的服务器,报告会被保存,并在下次能够连接时自动发送。

自动发送崩溃报告

当 CapSkip 因意外错误关闭时,自动发送诊断报告。默认开启,可随时关闭。

实时图表

在监控标签页的图片验证码板块中,实时显示传入图片验证码请求和处理队列的图表。

关闭它可以节省 CPU 和 RAM,在 VPS 上或高负载时建议关闭。

API 请求日志

将每个传入的 API 请求写入日志文件,用于监控、调试或审计。开启后,你可以选择日志文件路径。如果留空,日志会保存到 %AppData%\CapSkip\Logs\api_requests_YYYYMMDD.txt。

不需要时请关闭,以节省磁盘空间。

图片调试

将每个传入的验证码图片保存到文件夹中,便于检查错误结果、测试新的验证码类型或为模型改进准备图片。如果文件夹留空,图片会保存到 %AppData%\CapSkip\Debug\images\。

正常运行时请保持关闭,以免占用不必要的磁盘空间。

重置设置

恢复默认 按钮会将所有设置恢复为默认值,包括处理选项、代理配置和界面偏好。可用于重新开始或解决配置问题。