穿云本地代理工具是一款将穿云 API 封装为标准 HTTP 代理协议的辅助程序。它能让不支持 API 调用（但支持设置代理）的第三方软件（如指纹浏览器、Selenium、网页插件等）无缝接入穿云的破盾能力。

以下是该工具的最新使用说明：

1. 工具下载与启动

• 下载地址：请前往 GitHub 官方仓库下载对应操作系统的版本：
  👉 点击进入下载页面
• 启动方式：下载后直接运行可执行文件。
  • 默认模式：双击启动，程序将自动开启一个本地监听端口（通常在控制台输出中会显示，如 127.0.0.1:8080）。
  • 命令行模式：支持通过参数预设 API Key 和代理信息，例如：
    ./cloudbypass-proxy --api-key "你的APIKEY" --proxy "你的海外代理地址"

2. 配置与使用逻辑

工具启动后，您的第三方软件仅需将代理设置为 127.0.0.1:端口号 即可实现“代理即 API”的效果：

• 身份验证：如果您在启动时未预设参数，则需要在第三方软件发起请求时，在 请求头（Header） 中携带 x-cb-apikey。
• IP 代理要求：
  • 核心逻辑：本地代理工具本质上是将您的请求转发至穿云服务端。因此，您传入工具的代理主机必须是穿云服务器可以访问到的（即公网可访问的海外代理）。
  • 本地局域网限制：工具本身并不支持将您本地的局域网 IP “穿透”给 API 使用。

3. 为什么使用该工具？

• 无感集成：无需修改原有爬虫框架的请求逻辑，只需修改 Proxy 配置。
• 自动处理 V2 指纹：工具内部已集成最新的 JA3/HTTP2 指纹模拟逻辑，能自动优化发往 Cloudflare 目标站的请求特征。
• 简化调试：通过控制台输出，您可以实时查看每一个请求的转发状态与返回结果。

技术提醒：
在配合本地代理工具使用时，若涉及 V2 异步任务（如处理 Turnstile 验证码），建议在工具启动参数中固定使用 粘性代理（Sticky Proxy），以确保验证过程中的会话一致性。