Cloudflare Bypass 工具 2026

面向 Cloudflare Turnstile / Challenge 的多方案研究与授权测试工具集，支持 Mac / Windows / Linux。

Table of Contents / 目录

English	中文
Disclaimer	免责声明
Overview	项目概述
Method Comparison	方案对比
Features	功能特性
Requirements	环境要求
Installation	安装
Quick Start	快速开始
Usage	使用说明
Python API	Python API
Proxy Format	代理格式
Output	输出
Project Layout	项目结构
FAQ	常见问题
References	参考资料
Business	商务合作
License	许可证

Disclaimer / 免责声明

本项目仅供学习研究与已授权的自动化测试使用。使用时须遵守当地法律法规及目标站点服务条款。

不对任何站点、任何环境提供通过率保证。
实际效果受 IP 信誉、浏览器环境、目标策略与时机影响。
机房 IP、真无头模式、无图形界面的容器环境通常会显著降低成功率。

Overview / 项目概述

2025–2026 年 Cloudflare 检测已分层：网络信誉、TLS/HTTP 指纹、JS Challenge、Turnstile 交互，以及自动化协议特征。单靠 HTTP 客户端无法完成 Turnstile。

本仓库提供 5 套可运行方案 与 1 个类封装入口，覆盖单会话研究、批量任务、纯 CDP 控制，以及浏览器解出后的 TLS 层会话复用。

开源场景下更稳妥的基线：

有头真实 Chrome
  + 可选住宅或高质量出口 IP
  + UC 断连重连 或 纯 CDP
  + 需要交互时使用操作系统级点击

不建议作为 Turnstile 主路径：

真无头模式硬刚 Managed Turnstile
纯 curl_cffi / tls-client 直打 Turnstile
单独依赖 playwright-stealth 作为“一键方案”

Method Comparison / 方案对比

#	脚本	策略	Turnstile	适用场景
1	`bypass.py`	SeleniumBase UC Mode	是	默认单会话主路径
2	`simple_bypass.py`	UC + 并行 / 代理轮换	是	批量任务；并行时可能争抢系统鼠标
3	`bypass_nodriver.py`	nodriver 纯 CDP	是	无 chromedriver；需 OpenCV；注意 AGPL
4	`bypass_curl_cffi.py`	TLS 指纹 / Cookie 复用	否	仅旧版 Challenge 或 Cookie 复用
5	`bypass_cdp.py`	SeleniumBase CDP Mode	是	UC 后继路径
—	`bypass_seleniumbase.py`	UC 类封装	是	可 import 的二次开发封装

Priority guide / 选择优先级

优先级	选择	说明
1	`bypass.py` 或 `bypass_cdp.py`	主入口
2	`bypass_nodriver.py`	强备选；注意许可证
3	`simple_bypass.py`	吞吐与轮换；GUI 点击宜串行
4	浏览器解出后复用 `curl_cffi`	须保持 UA 与出口 IP 一致
避免	纯 HTTP 直打 Turnstile	无法执行 JS / 交互

Why curl_cffi cannot pass Turnstile / 为何 curl_cffi 无法过 Turnstile

限制	说明
无 JS 运行时	无法完成 Turnstile / 新版 Challenge PoW
无 DOM / Web API	缺少 navigator、WebGL、canvas 信号
无交互能力	Managed 模式需要真实点击复选框
TLS 只是其中一个信号	仅匹配 JA3/JA4 并不足够

Features / 功能特性

功能	说明
SeleniumBase UC 模式	驱动断连重连 + 操作系统级验证码点击
SeleniumBase CDP 模式	纯 CDP 路径，减少 WebDriver 附加特征
nodriver CDP	无需 chromedriver；`verify_cf()` 模板点击（OpenCV）
并行 / 代理轮换	`simple_bypass.py` 中的批量任务与代理文件轮换
超时控制	主流程端到端超时
Cookie 导出	按需导出 JSON 与 Netscape 格式
跨平台	macOS、Windows、Linux（Linux 无头主机需 Xvfb）

Requirements / 环境要求

项目	要求
Python	3.9+
浏览器	Google Chrome（非 amd64 Linux 使用 Chromium）
显示环境	优先有头 GUI；Linux 服务器：Xvfb / 虚拟显示
操作系统	macOS、Windows、Linux
可选代理	支持 HTTPS CONNECT 的 HTTP / HTTPS / SOCKS5 代理

Python 依赖见 requirements.txt（含 SeleniumBase、nodriver、curl_cffi、OpenCV headless、pyvirtualdisplay 等）。

Installation / 安装

macOS / Windows

git clone https://github.com/1837620622/cloudflare-bypass-2026.git
cd cloudflare-bypass-2026
pip install -r requirements.txt

请先安装 Google Chrome，再运行浏览器方案。

Linux (Ubuntu / Debian)

git clone https://github.com/1837620622/cloudflare-bypass-2026.git
cd cloudflare-bypass-2026
sudo bash install_linux.sh

手动安装：

sudo apt-get update
sudo apt-get install -y xvfb libglib2.0-0 libnss3 libatk1.0-0 libatk-bridge2.0-0 \
  libcups2 libdrm2 libxkbcommon0 libgbm1 libasound2
python3 -m pip install -r requirements.txt

说明

官方 Chrome deb 主要为 amd64。ARM 环境请自行准备对应架构的 Chromium/Chrome。

Quick Start / 快速开始

# Install dependencies / 安装依赖
pip install -r requirements.txt

# Method 1 — UC Mode (recommended default) / 方案1 默认推荐
python bypass.py https://example.com
python bypass.py https://example.com -p http://127.0.0.1:7890 -t 90

# Method 5 — CDP Mode / 方案5 CDP
python bypass_cdp.py https://example.com

# Method 3 — nodriver / 方案3
python bypass_nodriver.py https://example.com

请将示例 URL 替换为你有权测试的目标地址。

Usage / 使用说明

1. UC 单浏览器 — `bypass.py`（默认）

单浏览器 UC 模式：断连打开页面，并在检测到挑战时进行系统级点击。

python bypass.py https://example.com
python bypass.py https://example.com -p http://127.0.0.1:7890
python bypass.py https://example.com -t 90 --incognito

参数	说明	默认
`url`	目标 URL	必填
`-p, --proxy`	代理地址	无
`-t, --timeout`	总超时秒数	60
`-r, --reconnect`	断连秒数	5
`--incognito`	无痕模式	关闭
`--no-save`	不保存 Cookie	关闭

2. 并行 / 轮换 — `simple_bypass.py`

适用于多代理或多浏览器批处理。操作系统级点击在同一桌面上不具备多窗口安全；并行时可能互相干扰。

python simple_bypass.py https://example.com
python simple_bypass.py https://example.com -r -f proxy.txt -c
python simple_bypass.py https://example.com -P -b 3 -t 30 -n 5 -c

参数	说明	默认
`-p, --proxy`	固定代理	无
`-f, --proxy-file`	代理列表文件	`proxy.txt`
`-r, --rotate`	顺序轮换	关闭
`-P, --parallel`	并行浏览器	关闭
`-b, --batch`	每批浏览器数	3
`-t, --timeout`	超时秒数	60
`-n, --retries`	批次数或代理尝试数	3
`-c, --check-proxy`	代理存活预检	关闭
`-w, --wait`	页面等待 / 重连等待	5
`--no-save`	不保存 Cookie	关闭

3. nodriver 纯 CDP — `bypass_nodriver.py`

无 chromedriver 的 CDP 控制。挑战点击使用 verify_cf()（OpenCV 模板匹配）。上游许可证为 AGPL-3.0。

pip install "nodriver>=0.50.0" opencv-python-headless
python bypass_nodriver.py https://example.com
python bypass_nodriver.py https://example.com -p http://127.0.0.1:7890

参数	说明	默认
`-p, --proxy`	代理	无
`-t, --timeout`	总超时	60
`--headless`	无头（不推荐）	关闭
`--no-save`	不保存 Cookie	关闭

闭源商用分发 AGPL 组件前请自行完成合规评估。

4. TLS 客户端 — `bypass_curl_cffi.py`（不适用于 Turnstile）

仅 HTTP/TLS 指纹仿冒。适用于低防护或旧版 Challenge，或在 UA 与出口 IP 一致 的前提下复用浏览器解出的 Cookie。

python bypass_curl_cffi.py https://example.com
python bypass_curl_cffi.py https://example.com -f chrome146
python bypass_curl_cffi.py https://example.com -p http://127.0.0.1:7890

参数	说明	默认
`-p, --proxy`	代理	无
`-f, --fingerprint`	指纹配置	`chrome136`
`-t, --timeout`	请求超时	30
`-n, --retries`	重试次数	3
`--no-save`	不保存 Cookie	关闭

常用指纹包括：chrome120、chrome124、chrome131、chrome136、chrome142、chrome146、firefox135、firefox144、safari17_0、safari18_0、edge101。

5. CDP 模式 — `bypass_cdp.py`

SeleniumBase CDP 模式：优先 solve_captcha()，失败时回退 gui_click_captcha()。2026 年与 UC 并列的升级路径。

python bypass_cdp.py https://example.com
python bypass_cdp.py https://example.com -p http://127.0.0.1:7890 -t 90

参数	说明	默认
`-p, --proxy`	代理	无
`-t, --timeout`	总超时预算	60
`--no-save`	不保存 Cookie	关闭

6. 类封装 — `bypass_seleniumbase.py`

面向对象的 UC 封装，便于嵌入更大工程。

python bypass_seleniumbase.py https://example.com -p http://127.0.0.1:7890

Python API

UC 模式（`bypass.py`）

from bypass import bypass_cloudflare

cloudflare-bypass-2026

最受欢迎