Sophomoresty/turnstile-bypass

解决的问题

提供一种绕过 Cloudflare 的 Turnstile 小部件和全页面「请稍等」等待室的方法，这些机制会阻止对网站的自动化访问。它专门针对需要用户证明自己是人类的挑战层，使脚本能够获取有效的会话令牌或 cf_clearance Cookie，从而访问真实的目标网站。

工作原理

该工具驱动一个带界面的 Google Chrome 或 Chromium 浏览器实例。它使用一个自定义的 Chrome 扩展（Manifest V3）来修补 MouseEvent.screenX/Y 坐标，防止 Cloudflare 基于 Chrome DevTools Protocol (CDP) 的点击方式检测浏览器为机器人。它可以通过不同的「车道」（执行路径）运行，包括 DrissionPage、agent-browser-cli（通过 Node）、或作为最后手段的 YesCaptcha。

适用人群

需要在不被挑战页面拦截的情况下，程序化访问受 Cloudflare 机器人检测系统保护的网站的开发者和自动化工程师。

特色亮点

• 多平台支持：支持 macOS、Windows 和 Linux（包括通过 xvfb 的无头 Linux）。
• 双层绕过：同时处理页面上的 Turnstile 小部件和全页面的拦截等待室。
• 自定义修补：内置扩展，用于修复 CDP 点击坐标，避免被检测为机器人。
• 客户端执行：在带界面的浏览器中运行，保持高成功率，避免无头 Chrome 的常见陷阱。
• 灵活车道：支持多种浏览器自动化框架来解决挑战。