CapSkip 入门
一份完整的分步指南,帮你完成配置并开始识别验证码。
设置 CapSkip 验证码识别工具简单直接。
首先,从以下链接下载 Windows 应用程序: 下载 CapSkip
安装 CapSkip 并启动应用程序。系统会提示你输入用户名和密码。如果你尚未订阅我们的任何套餐,可以在此处购买授权: 立即获取你的授权
订阅后,你的 CapSkip 授权凭据会立即发送到你的邮箱。使用收到的用户名和密码登录。
应用概览
CapSkip 由两个主要标签页组成:Monitor(监控)和 Settings(设置)。
在 Monitor(监控) 标签页中,你可以实时查看验证码识别活动。这包括传入的任务、当前处理状态、识别结果和性能统计。
在 Settings(设置) 标签页中,你可以:
选择服务模拟器
加载用于验证码识别的模型
配置代理
启用或禁用 API key 验证
自定义应用行为
在本教程中,我们将详细讲解每一个配置选项,让你充分理解 CapSkip 的工作原理,并能立即高效地开始使用它。
图片验证码识别
此部分允许你测试图片验证码,并在应用内即时查看识别结果。

你可以手动上传图片、从屏幕捕获验证码区域,或批量处理文件夹中的多张图片。处理完成后会显示识别结果、置信度分数、识别时间和检测到的验证码类型。
上传图片
上传单个图片文件以手动测试验证码识别。
屏幕识别
选择并捕获屏幕上的特定区域以即时识别验证码。
文件夹识别
在批处理模式下批量处理选定文件夹中的多张图片。
开放 API
打开 API 接口面板,您可以在此查看当前 API URL、Web 服务器状态、CapSkip 正在模拟的服务、可用端点,以及支持的请求和响应方式。
本节面向希望将 CapSkip 集成到自有应用程序或自动化系统中的开发者。
Google reCAPTCHA 识别
本节提供 CapSkip 处理 Google reCAPTCHA 任务的实时监控与统计数据。

它会显示性能指标、活动线程、队列状态和详细的任务日志,让您可以跟踪运行情况和系统效率。
Cloudflare Turnstile 识别
本节提供 CapSkip 处理 Cloudflare Turnstile 任务的实时监控与统计数据。

它会显示性能指标、活动线程、队列状态和详细的任务日志,让您可以监控运行情况和整体系统性能。
极验识别
本节提供 CapSkip 处理的极验任务的实时监控与统计信息。

它会显示性能指标、活动线程、队列状态和详细的任务日志,让您可以监控运行情况和整体系统性能。
连接设置
配置验证码服务模拟器,以及用于与 CapSkip 进行 API 通信的 IP 地址和端口。

服务模拟器
服务模拟器让 CapSkip 能够复现主流验证码识别服务的 API 结构。这样即可将 CapSkip 接入第三方软件,而无需修改该软件。
选择受支持的模拟器后,CapSkip 会监听按该特定服务格式发送的传入请求。任何发送到该服务的请求都会被拦截,并由 CapSkip 在本地处理,而不会发送到外部提供商。
如果你使用的软件已经支持 2Captcha 之类的服务,只需在 CapSkip 中选择相应的模拟器,并像往常一样配置你的软件即可,其余的交给 CapSkip 处理。
为实现无缝重定向,您可以使用“设置”选项卡中的“添加到 Hosts 文件”选项。这可确保原本发往外部服务的请求被自动路由到您本地的 CapSkip 实例。
服务模拟器是让 CapSkip 完全替代付费验证码服务、同时保持与现有自动化工具兼容的关键组件。
端口与模式配置
端口和模式设置决定了 CapSkip 如何接收来自第三方软件的 API 请求。
- 本地
CapSkip 仅通过以下地址在您当前设备上进行监听127.0.0.1.
当软件和 CapSkip 在同一台机器上运行时推荐使用。 - 服务器
CapSkip 在您的网络或公网 IP 地址上监听,允许远程设备或软件进行连接。
推荐用于 VPS 或独立服务器部署。建议使用静态公网 IP 以获得稳定的远程访问。
端口字段用于指定 CapSkip 接收请求所使用的端口。请确保所选端口尚未被占用。
添加到 Hosts 文件
加载的 添加到 Hosts 文件 按钮会将所选模拟验证码服务的官方域名重定向到您本地的 CapSkip 实例。
激活后,任何发送到原始服务 URL 的请求都会自动路由到 CapSkip,而不再发往外部提供商。这样您就可以保持第三方软件配置不变,同时用 CapSkip 完全替代原有服务。
此方法是集成 CapSkip 最简单的方式,因为无需在您的自动化软件内部修改任何 API 端点。
修改系统 hosts 文件可能需要管理员权限。
从 Hosts 文件中移除
加载的 从 Hosts 文件中移除 按钮可恢复系统的原始网络配置。
它会移除先前添加到 hosts 文件中的重定向条目,使请求重新发送到真正的外部服务。
如果您想停止通过 CapSkip 路由流量,或恢复使用原来的验证码提供商,请使用此选项。
处理设置
配置 CapSkip 处理验证码任务的方式,包括模型选择、算术识别和界面性能选项。

选择模型
点击 选择模型 以选择将加载哪些 AI 模型用于验证码识别。您可以根据需求和可用系统资源启用或禁用特定模型。仅加载所需模型可以提升性能并降低内存占用。
自动算术计算
启用此选项可自动识别基于算术的图片验证码。激活后,CapSkip 会检测受支持验证码图片中的数学表达式,并自动计算出正确结果。
为 API 请求禁用界面更新
启用此选项可在处理 API 请求时减少界面更新。在处理大量传入任务时,这可以提升性能,尤其是在无需实时可视化监控的 VPS 或服务器环境中。
reCAPTCHA 识别设置
配置识别 Google reCAPTCHA 挑战的性能与行为选项,包括线程上限、超时、重试和代理配置。

为 reCAPTCHA 禁用界面更新
启用此选项可在识别 reCAPTCHA 任务时停止实时界面更新。这可以降低 UI 开销,并在处理大量请求时提升性能,尤其是在 VPS 或服务器环境中。
最大线程数
定义 reCAPTCHA 并发识别线程的最大数量。提高此值可以提升吞吐量,但会消耗更多 CPU、内存和代理资源。请根据您的系统承载能力进行调整。
等待超时
定义 CapSkip 在超时前等待可用线程槽位的时长。如果所有线程当前都在忙碌,CapSkip 会在此指定时间内等待空闲槽位,超时后取消该请求。
单条超时
定义单个验证码允许的最长识别时间。如果识别过程超过此上限,任务将被停止并标记为失败。
重试次数(0-3)
定义 CapSkip 对失败的 reCAPTCHA 尝试进行重试的次数。较高的重试次数可以提高成功率,但会略微增加整体识别时间。
配置代理
打开代理配置面板。识别 reCAPTCHA 需要使用代理。请确保您的代理稳定并已正确配置,以获得最佳性能。 点击此处查看代理设置
高级:显示参数无效的任务
打开后,每一个传入请求都会被列出,无论其参数有多不正确,并附带失败原因。这正是你在搭建集成时需要的效果:一个任务只留下一个错误码就消失,比看到一行明确的失败记录更难排查。代价是列表会更嘈杂,因为循环发送错误请求的客户端现在会把表格填满。
高级:为 reCAPTCHA v2 使用 Chromium 浏览器
默认情况下,CapSkip 会使用其内置的自定义浏览器来识别 reCAPTCHA v2。该浏览器针对高性能进行了优化,可支持数百个并发识别任务,同时占用的 CPU 和内存远低于 Chromium。
仅在自定义浏览器因 Google reCAPTCHA 更新而暂时不可用时才启用此选项。
高级:为 reCAPTCHA v3 使用 Chromium 浏览器
默认情况下,CapSkip 会使用 Chromium 处理 reCAPTCHA v3,以获得尽可能高的分数。
禁用此选项可改用 CapSkip 内置的自定义浏览器。自定义浏览器速度明显更快,占用的 CPU 和内存也少得多,但产生的 reCAPTCHA v3 分数较低。仅在速度比分数质量更重要时推荐使用。
高级:reCAPTCHA v3 高分模式
在运行于私有 Windows 桌面的真实 Google Chrome 窗口中识别 reCAPTCHA v3,而不是使用无头浏览器,这在严格的站点密钥上能显著提升分数。
默认关闭,因为它只在评分严格的站点上才有回报,而且比常规路径消耗更多内存和 CPU。如果你的 v3 token 已经被正常接受,就不要开启它。当某个站点拒绝了 CapSkip 已成功生成的 token 时再启用它,这通常意味着分数太低,而不是识别本身失败。
有两个前提条件。第一,必须安装原版 Google Chrome,CapSkip 内置的浏览器在这里无法替代;如果没有安装 Chrome,开关下方的提示会说明这一点,v3 会继续在标准路径上正常识别。第二,reCAPTCHA v3 必须设置为使用 Chromium 浏览器,也就是这个开关正上方的那个选项。如果 v3 切换成了自定义浏览器,高分模式就没有可作用的对象,会显示为灰色不可用。
如果识别时任一条件不满足,CapSkip 会回退到常规的无头浏览器池,并记录一次日志,因此启用此设置永远不会导致识别失败。
Cloudflare Turnstile 设置
配置识别 Cloudflare Turnstile 挑战的性能与处理选项,包括线程上限、超时、重试和代理配置。

为 Cloudflare Turnstile 禁用界面更新
启用此选项可在识别 Turnstile 任务时停止实时界面更新。这可以降低 UI 开销,并在处理大量请求时提升性能,尤其是在 VPS 或服务器环境中。
最大线程数
定义 Turnstile 并发识别线程的最大数量。提高此值可以提升吞吐量,但需要更多 CPU、内存和代理资源。请根据您的系统承载能力和代理质量进行调整。
等待超时
指定当所有线程都在忙碌时,CapSkip 等待可用处理槽位的时长。如果在规定时间内没有空闲槽位,该请求将超时。
单条超时
定义单个 Turnstile 挑战允许的最长识别时间。如果超过此时间,任务将被停止并标记为失败。
重试次数(0-3)
决定 CapSkip 对失败的 Turnstile 尝试进行重试的次数。较高的重试值可以提高成功率,但会略微增加总识别时间。
配置代理
打开代理配置面板。识别 Cloudflare Turnstile 需要使用代理。请确保您的代理稳定、纯净并已正确配置,以获得最佳性能。 点击此处查看代理设置
高级:调试模式
记录 Cloudflare Turnstile 任务失败的原因,让你能看清问题所在,而不必从状态列去猜测。
默认关闭。打开它,重现问题,然后双击列表中失败的任务以打开详情:包括识别器放弃时无头浏览器所显示内容的截图、当时所处的阶段、运行了多久,以及关于为何停止的简明说明。
成功的任务不会被记录任何内容。相关工作只在任务已经失败之后才会进行,因此保持开启不会拖慢正常识别,不过每次失败都会产生一张截图。截图保存在 %AppData%\CapSkip\Debug\cloudflare 文件夹最多保留最新的 120 张,更早的会自动删除。
极验设置
配置识别极验挑战的性能与处理选项,包括线程数量限制、超时时间、重试次数和代理配置。

关闭极验任务的界面实时刷新
启用此选项可在识别极验任务时停止实时界面更新。这能降低界面开销,在处理大量请求时提升性能,在 VPS 或服务器环境中尤其明显。
最大线程数
定义极验识别的最大并发线程数。提高该值可以提升吞吐量,但需要更多 CPU、内存和代理资源。请根据你的系统性能和代理质量进行调整。
等待超时
指定当所有线程都在忙碌时,CapSkip 等待可用处理槽位的时长。如果在规定时间内没有空闲槽位,该请求将超时。
单条超时
定义单个极验挑战允许的最长识别时间。超过该时间,任务将被停止并标记为失败。
重试次数(0-3)
决定 CapSkip 对失败的极验尝试重试的次数。更高的重试次数能提高成功率,但会略微增加总识别时间。
配置代理
打开代理配置面板。识别极验需要使用代理。请确保你的代理稳定、干净,并配置得当,以获得最佳性能。 点击此处查看代理设置
API 密钥校验
API 密钥验证让您可以控制哪些 API 密钥被允许向您的 CapSkip 实例发送请求。

启用后,只有包含有效配置密钥的请求才会被处理。任何密钥无效或缺失的请求都将被拒绝。
禁用此选项后,CapSkip 会接受任意密钥值的请求。在此模式下,API 格式仍要求提供 key 参数,但任何字符串都会被接受。
在 VPS 或可供多个用户或外部工具访问的服务器上运行 CapSkip 时,此功能尤其有用。
高级:远程密钥管理
让你可以从另一台机器通过 HTTP 添加、列出和删除识别器 API 密钥,而不必对运行 CapSkip 的那台机器打开远程桌面会话。这是上方表格在 Server 模式下的对应功能:管理的是同一批密钥,只是可以从你管理该机器的任何地方进行操作。
默认关闭,并且在你既打开开关又生成 token 之前一直处于无效状态。关闭期间,管理路径只会返回普通的 404,因此扫描甚至无法察觉这个功能的存在。
Generate 会生成一个 256 位的随机 token,并在一个可选中复制的文本框中连同 Copy 按钮显示一次。请立刻复制:CapSkip 只保存加盐哈希,之后无法再次显示该 token。此后这一行会显示为 “Token set, generated <date>”。生成新 token 会替换旧的,因此仍在使用旧 token 的客户端会开始收到 401 响应。
撤销 会清除已保存的 token。相关端点仍然保持可访问,但在你生成新 token 之前会拒绝一切请求。
如果你想看这些端点实际使用的完整演练,请参阅 如何为你的客户开通验证码 API 密钥。它完整覆盖了整个流程:启用 Remote Key Management 并生成 token,通过 /admin/keys/add 在订阅 webhook 中签发密钥,通过 /admin/keys/delete 在取消时撤销密钥,以及通过 /admin/keys/list 将当前密钥列表与你的计费记录进行核对。
置信度过滤器
置信度过滤器让您可以控制 CapSkip 如何处理低置信度的识别结果。

每个识别出的验证码都会被模型赋予一个置信度分数。如果置信度分数低于设定的百分比阈值,CapSkip 会自动用自定义响应替换结果,例如 ERROR_CAPTCHA_UNSOLVABLE
软件更新
软件更新部分让您能够让 CapSkip 保持最新,获得最新的改进、性能增强和安全更新。

如果有可用更新,建议尽快安装,以享受最新的修复和增强功能。
深色模式
深色模式让您可以即时将应用程序界面切换为更暗的主题。

选择最适合您工作流程和使用环境的外观。
实时图表
控制图片验证码活动的实时监控。

启用后,CapSkip 会显示实时图表,展示传入的图片验证码请求和当前的处理队列。这有助于您直观地跟踪工作负载和性能。
禁用后,图表将关闭以降低 CPU 和内存占用,推荐用于需要最大性能的 VPS 或高负载环境。
日志记录与调试
配置日志记录和调试选项,以记录 API 请求并保存验证码图片,用于排查故障和分析。


API 请求日志
API 请求日志让您可以将传入的 API 请求记录到文件中,用于监控、调试或审计。启用后,CapSkip 会将请求详情保存到指定的日志文件路径。如果未提供自定义路径,则会自动使用默认日志目录。
此功能有助于排查集成问题或分析请求模式。如果不需要日志记录,请禁用它以减少磁盘占用。
图片调试
图片调试让您可以保存传入的验证码图片以供检查和测试。启用后,CapSkip 会将收到的图片验证码文件存储到指定文件夹中。如果路径留空,则会使用默认调试目录。
在测试新验证码类型、分析错误结果或为模型改进准备图片时,这尤其有用。
在正常运行期间请禁用图片调试,以避免不必要的磁盘占用。
故障排除
本节允许您生成诊断文件,以帮助识别和解决问题。

发送报告
发送一份关于你当前正在遇到的问题的诊断报告。
点击 Send Report 后,首先会弹出一个简短的 “Describe the Issue” 对话框。请告诉我们你当时想做什么、看到了什么错误信息、如何重现问题以及问题从何时开始出现。随后 CapSkip 会收集报告并在显示进度遮罩的同时上传。
自动发送崩溃报告
如果 CapSkip 因意外错误而关闭,会自动发送一份诊断报告。此选项默认开启,可以随时关闭。
启动
启动功能让 CapSkip 能够在您登录 Windows 时自动启动并为您登录。

启用后,每次您登录 Windows 时,CapSkip 都会自动启动并为您登录。这可确保应用程序始终运行、已通过身份验证,并随时准备识别验证码,无需手动启动或登录。
应用语言
应用程序语言设置让您可以选择首选的界面语言。

CapSkip 支持多种语言,为全球用户提供舒适的使用体验。请选择最适合您工作流程的语言。
重置设置
重置设置选项可将所有配置值恢复为默认状态。

点击 恢复默认设置 以还原所有自定义设置,包括处理选项、代理配置、UI 偏好设置和其他调整。
如果您想从头开始、解决配置冲突,或快速将 CapSkip 恢复到初始设置,请使用此选项。
代理配置
代理配置面板让您可以管理用于 reCAPTCHA 和 Cloudflare Turnstile 识别的代理。

reCAPTCHA 和 Turnstile 需要使用代理。图片验证码识别不需要代理。
根据您的部署选择代理类型:
无代理 使用您的本地 IP 地址。可临时使用,但重复请求很可能导致 IP 被封锁。
Tor (SOCKS5) 使用本地 Tor 服务。
SOCKS5 代理列表 适用于基于 SOCKS 的代理列表。
带 DNS 的 SOCKS5 (SOCKS5h) 通过代理进行 DNS 解析。
HTTP/HTTPS 代理列表 标准 HTTP 或 HTTPS 代理。
单个自定义代理 使用一个专用代理。
选择与您代理提供商相匹配的类型。
推荐:
为在识别 reCAPTCHA 和 Cloudflare Turnstile 时获得最佳性能,请使用高质量的私有代理。
私有 HTTP/HTTPS 代理
私有 SOCKS5/SOCKS5h 代理
住宅或 ISP 代理,以获得更高的成功率
避免使用公共或共享代理,因为它们往往会被限速、列入黑名单或不稳定。
数据中心代理或许可用,但某些网站会采用更严格的过滤。住宅或 ISP 代理通常能提供更好的稳定性和更低的封锁率。
代理列表格式
选择代理类型后会显示受支持的格式。
CapSkip 支持三种格式,每行一个代理。请使用您的代理提供商提供的格式:
host:port
如果您已在代理提供商的控制台中将自己的 IP 地址加入白名单,请使用此格式。username:password@host:port
如果您的代理需要使用用户名和密码进行身份验证,请使用此格式。host:port:username:password
如果您的代理提供商导出的认证代理将用户名和密码放在端口之后,请使用此格式。直接粘贴列表即可,无需转换。
请确保格式符合您代理服务的要求。
添加代理
您可以通过三种方式添加代理:
直接将代理粘贴到列表中
从 URL 加载代理
从文件加载代理
加载后,应用程序会显示当前已配置的代理总数。
为每个请求轮换代理
启用此选项可为每个新的验证码请求自动轮换代理。这可以提高成功率,并降低基于 IP 的速率限制风险。
