
在自动化测试、数据采集或安全研究中,Cloudflare 的 Turnstile 验证常常成为难以逾越的障碍。传统的无头浏览器极易被其反爬机制识别并拦截。Cloudflare Bypass Tool 2026 正是为解决这一痛点而生。它利用 SeleniumBase 的 UC (Undetected Chrome) 模式,通过操作系统级的鼠标和键盘事件模拟,实现业界领先的绕过成功率。
重要提示:本工具仅供学习与研究使用,请务必遵守相关法律法规及目标网站的服务条款。
核心功能特点
- SeleniumBase UC Mode:采用底层操作系统级事件模拟,最大程度规避 Cloudflare 的机器人检测,提供最高绕过率。
- 灵活的运行模式:
- 单浏览器模式 (
bypass.py):简单可靠,资源占用低,适合大多数常规场景。 - 并行模式 (
simple_bypass.py):支持多浏览器实例同时运行,显著提升大规模任务的处理效率。
- 单浏览器模式 (
- 强大的代理支持:
- 代理轮换:可从
proxy.txt文件批量加载代理列表,并按需进行轮换。 - HTTPS 隧道检测:自动验证代理是否支持 HTTPS 隧道,确保连接可靠性。
- 代理轮换:可从
- 跨平台兼容:完美支持 macOS、Windows 和 Linux 系统。
- 便捷的 Cookie 管理:成功绕过后,自动将关键的
cf_clearanceCookie 和User-Agent以 JSON 和 Netscape 两种格式保存至output/cookies/目录,方便后续在脚本或curl命令中直接复用。
安装与部署
通用依赖安装
pip install seleniumbase
macOS / Windows
git clone https://github.com/1837620622/cloudflare-bypass-2026.git
cd cloudflare-bypass-2026
pip install -r requirements.txt
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
# 安装 Chrome 浏览器
wget -q https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt-get install -f -y
# 安装 Python 依赖
pip install seleniumbase pyvirtualdisplay
详细使用方法
1. 简单模式 (bypass.py) - 推荐用于日常使用
此模式启动单个浏览器实例,操作简单,稳定性高。
# 直连目标网站
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 60
参数说明
| 参数 | 说明 | 默认值 |
|---|---|---|
url | 目标 URL | 必填 |
-p, --proxy | 代理地址 | 无 |
-t, --timeout | 超时时间(秒) | 60 |
--no-save | 不保存获取到的 Cookie | 否 |
2. 完整模式 (simple_bypass.py) - 适用于高级和批量任务
此模式支持并行处理、代理轮换及代理存活检测,功能强大。
# 基础直连
python simple_bypass.py https://example.com
# 指定单一代理
python simple_bypass.py https://example.com -p http://127.0.0.1:7890
# 代理轮换模式(顺序尝试 proxy.txt 中的代理)
python simple_bypass.py https://example.com -r -f proxy.txt
# 并行模式(启动3个浏览器实例)
python simple_bypass.py https://example.com -P -b 3 -t 60
# 高级组合:并行 + 代理检测 + 限制最大重试批次
python simple_bypass.py https://example.com -P -c -b 3 -t 15 -n 30 -f proxy.txt
参数说明
| 参数 | 说明 | 默认值 |
|---|---|---|
url | 目标 URL | 必填 |
-p, --proxy | 指定代理地址 | 无 |
-f, --proxy-file | 代理文件路径 | proxy.txt |
-r, --rotate | 启用顺序代理轮换模式 | 否 |
-P, --parallel | 启用并行模式 | 否 |
-b, --batch | 并行浏览器数量 | 3 |
-t, --timeout | 超时时间(秒) | 60 |
-n, --retries | 最大批次/重试次数 | 3 |
-c, --check-proxy | 预检测代理存活状态 | 否 |
--no-save | 不保存获取到的 Cookie | 否 |
3. Python API 集成
工具同样提供了简洁的 Python API,方便集成到您的项目中。
# 简单模式
from bypass import bypass_cloudflare
result = bypass_cloudflare("https://example.com")
if result["success"]:
print(f"cf_clearance: {result['cf_clearance']}")
print(f"User-Agent: {result['user_agent']}")
# 完整模式
from simple_bypass import bypass_cloudflare, bypass_parallel
# 单次绕过
result = bypass_cloudflare("https://example.com", proxy="http://127.0.0.1:7890")
# 并行绕过
result = bypass_parallel(
url="https://example.com",
proxy_file="proxy.txt",
batch_size=3,
timeout=15.0,
max_batches=30
)
代理文件格式
proxy.txt 文件每行定义一个代理,支持多种格式:
127.0.0.1:7890
http://127.0.0.1:7890
socks5://127.0.0.1:1080
http://user:pass@host:port
输出文件说明
成功绕过后的 Cookie 会保存在 output/cookies/ 目录下:
| 文件 | 格式 | 用途 |
|---|---|---|
cookies_*.json | JSON | 便于在 Python 或其他编程语言中解析使用 |
cookies_*.txt | Netscape | 可直接用于 curl -b cookies.txt 命令 |
JSON 文件示例
{
"url": "https://example.com",
"cookies": {
"cf_clearance": "xxx..."
},
"user_agent": "Mozilla/5.0...",
"timestamp": "20260122_103000"
}
项目结构概览
cloudflare-bypass-2026/
├── bypass.py # 简单版(推荐)
├── simple_bypass.py # 完整版(并行+代理轮换)
├── bypass_seleniumbase.py # 详细版(供参考)
├── install_linux.sh # Linux 一键安装脚本
├── requirements.txt # Python 依赖列表
├── proxy.txt # 代理列表示例文件
├── output/ # Cookie 输出目录
└── README.md
常见问题解答 (FAQ)
Q: 为什么不用无头(Headless)模式?
A: Cloudflare 的检测算法能够精准识别无头浏览器的特征。本工具强制使用可视化模式,以模拟真实用户环境,从而获得最高的绕过成功率。
Q: cf_clearance Cookie 的有效期是多久?
A: 通常有效期为 30分钟到数小时不等。建议在 Cookie 过期前重新调用工具获取新的有效凭证。
Q: 在 Linux 上运行报错 "X11 display failed" 怎么办?
A: 这是因为缺少虚拟显示依赖。请运行项目提供的 sudo bash install_linux.sh 脚本,它会自动安装 Xvfb 等必要组件。
Q: 为什么我的代理无法工作?
A: 大部分免费或公共代理不支持 HTTPS 隧道,导致连接失败。建议优先使用直连模式,或购买高质量的住宅代理服务。
Q: 为什么 Chrome 会启动多个进程?
A: 这是 Chrome 浏览器的正常架构(包含主进程、渲染进程、GPU 进程等),并非代码问题,请放心使用。
数据统计
相关导航


AI工具系统提示词库

enableAppleAI

Picture Me

红墨 - 小红书AI图文生成器

EasyVideoTrans

WAN 2.2 - BRKN AI Prompt Generator






