
Инструмент обхода Cloudflare Turnstile | Cloudflare Bypass Tool based on SeleniumBase UC Mode | Поддерживает Mac/Windows/Linux
Мультистратегический набор инструментов для исследования и тестирования прохождения Cloudflare Turnstile / Challenge на macOS, Windows и Linux.
Проект предназначен только для исследовательских целей и авторизованного автоматизированного тестирования. Вы обязаны соблюдать действующее законодательство и условия использования целевых сайтов.
Защита Cloudflare в 2025–2026 годах многоуровневая: репутация сети, TLS/HTTP-отпечатки, JavaScript-челленджи, взаимодействие с Turnstile и признаки протоколов автоматизации. Одного HTTP-клиента для Turnstile недостаточно.
В этом репозитории представлены пять исполняемых стратегий и одна обёртка на основе класса, чтобы вы могли выбрать подходящий путь: одиночный сеанс исследования, пакетные задания, чистое CDP-управление или переиспользование уже решённой сессии на уровне TLS.
Рекомендуемый базовый уровень (открытый стек):
Обычный Chrome с графическим интерфейсом
+ опционально резидентный / качественный исходящий IP
+ UC reconnect или чистый CDP
+ клик по капче на уровне ОС при необходимости взаимодействия
Не рекомендуется как основной путь для Turnstile:
Настоящий headless против Managed Turnstile
Чистый curl_cffi / tls-client против Turnstile
playwright-stealth в одиночку как «решение в один клик»
| # | Скрипт | Стратегия | Turnstile | Лучшее применение |
|---|---|---|---|---|
| 1 | bypass.py | SeleniumBase UC Mode | Да | Основной путь для одиночного сеанса |
| 2 | simple_bypass.py | UC + параллельность / ротация прокси | Да | Пакетные задания; возможна конкуренция за клики GUI |
| 3 | bypass_nodriver.py | Чистый CDP на nodriver | Да | CDP без chromedriver; нужен OpenCV; AGPL-3.0 |
| 4 | bypass_curl_cffi.py | TLS-отпечаток / переиспользование cookie | Нет | Только устаревшие JS-челленджи или переиспользование cookie после решения |
| 5 | bypass_cdp.py | SeleniumBase CDP Mode | Да | Преемник обычного UC в 2026 |
| — | bypass_seleniumbase.py | Обёртка класса UC | Да | Импортируемый API для встраивания и доработки |
| Приоритет | Выбор | Примечания |
|---|---|---|
| 1 | bypass.py или bypass_cdp.py | Основная точка входа |
| 2 | bypass_nodriver.py | Надёжная CDP-альтернатива; проверьте AGPL |
| 3 | simple_bypass.py | Пропускная способность / ротация; клики GUI при необходимости выполнять последовательно |
| 4 | Решение в браузере, затем переиспользование через curl_cffi | Сохраняйте тот же UA и исходящий IP |
| Избегать | Чистый HTTP против Turnstile | Не выполняет JS и не взаимодействует |
| Ограничение | Подробности |
|---|---|
| Нет JS-рантайма | Не может выполнить Turnstile / PoW современных челленджей |
| Нет DOM / Web API | Отсутствуют сигналы navigator, WebGL, canvas |
| Нет взаимодействия | Managed-режим требует реального клика по чекбоксу |
| TLS — лишь один сигнал | Одного совпадения JA3/JA4 недостаточно |
| Возможность | Описание |
|---|---|
| SeleniumBase UC Mode | Отключение-переподключение драйвера + клик по капче на уровне ОС |
| SeleniumBase CDP Mode | Чистый CDP-путь со сниженными сигналами привязки WebDriver |
| nodriver CDP | Без chromedriver; шаблонный клик verify_cf() (OpenCV) |
| Параллельность / ротация прокси | Пакетные воркеры и ротация файла прокси в simple_bypass.py |
| Контроль таймаута | Сквозной таймаут в основных сценариях |
| Экспорт cookie | Форматы JSON и Netscape, где применимо |
| Кроссплатформенность | macOS, Windows, Linux (на Linux без графического интерфейса нужен Xvfb) |
| Компонент | Требование |
|---|---|
| Python | 3.9+ |
| Браузер | Google Chrome (или Chromium на Linux с архитектурой, отличной от amd64) |
| Дисплей | Предпочтителен обычный графический интерфейс; серверы Linux: Xvfb / виртуальный дисплей |
| ОС | macOS, Windows, Linux |
| Прокси (опционально) | HTTP / HTTPS / SOCKS5 с работающим HTTPS CONNECT |
Пакеты Python перечислены в requirements.txt (SeleniumBase, nodriver, curl_cffi, OpenCV headless, pyvirtualdisplay и др.).
git clone https://github.com/1837620622/cloudflare-bypass-2026.git
cd cloudflare-bypass-2026
pip install -r requirements.txt
Перед запуском скриптов на основе браузера установите Google Chrome.
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
Примечания
.deb-пакеты Chrome предназначены в основном для amd64. На ARM-хостах установите подходящую сборку Chromium/Chrome самостоятельно.# 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
Замените https://example.com на сайт, который вам разрешено тестировать.
bypass.py (по умолчанию)Один сеанс Chrome через SeleniumBase UC Mode: uc_open_with_reconnect + uc_gui_click_captcha / uc_gui_handle_captcha.
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