
Outil de contournement de Cloudflare Turnstile | Cloudflare Bypass Tool based on SeleniumBase UC Mode | Supporte Mac/Windows/Linux
Un ensemble d'outils multi-stratégies pour la recherche et les tests autorisés des flux Cloudflare Turnstile / Challenge sur macOS, Windows et Linux.
Ce projet est destiné uniquement à la recherche pédagogique et aux tests d'automatisation autorisés. Vous devez vous conformer aux lois applicables et aux conditions d'utilisation de tout site cible.
Les défenses de Cloudflare en 2025–2026 sont multicouches : réputation réseau, empreintes TLS/HTTP, défis JavaScript, interaction Turnstile et signaux de protocole d'automatisation. Un simple client HTTP ne suffit pas pour Turnstile.
Ce dépôt fournit cinq stratégies exécutables plus un wrapper orienté classe, afin que vous puissiez choisir la bonne voie pour la recherche en session unique, les tâches par lots, le contrôle CDP pur ou la réutilisation au niveau TLS d'une session déjà résolue.
Base de référence recommandée (voie open source) :
Headed real Chrome
+ optional residential / high-quality egress IP
+ UC reconnect or pure CDP
+ OS-level captcha click when interaction is required
Non recommandé comme voie principale pour Turnstile :
True headless hard-target Managed Turnstile
Pure curl_cffi / tls-client against Turnstile
playwright-stealth alone as a “one-click” solution
| # | Script | Stratégie | Turnstile | Idéal pour |
|---|---|---|---|---|
| 1 | bypass.py | SeleniumBase UC Mode | Oui | Chemin par défaut pour session unique |
| 2 | simple_bypass.py | UC + parallélisation / rotation de proxies | Oui | Tâches par lots ; contention possible des clics GUI |
| 3 | bypass_nodriver.py | nodriver CDP pur | Oui | CDP sans chromedriver ; nécessite OpenCV ; AGPL-3.0 |
| 4 | bypass_curl_cffi.py | Empreinte TLS / réutilisation de cookies | Non | Uniquement défi JS hérité ou réutilisation de cookies après résolution |
| 5 | bypass_cdp.py | SeleniumBase CDP Mode | Oui | Successeur de l'UC simple en 2026 |
| — | bypass_seleniumbase.py | Wrapper de classe UC | Oui | API intégrable pour le développement secondaire |
| Priorité | Choix | Remarques |
|---|---|---|
| 1 | bypass.py ou bypass_cdp.py | Entrée de recherche principale |
| 2 | bypass_nodriver.py | Alternative CDP solide ; vérifier l'AGPL |
| 3 | simple_bypass.py | Débit / rotation ; sérialiser les clics GUI si nécessaire |
| 4 | Résolution navigateur puis réutilisation avec curl_cffi | Conserver le même UA et la même IP de sortie |
| À éviter | HTTP pur contre Turnstile | N'exécute pas le JS / n'interagit pas |
| Limitation | Détail |
|---|---|
| Pas d'exécution JS | Ne peut pas terminer le PoW de Turnstile / des défis modernes |
| Pas de DOM / d'API Web | Signaux navigator, WebGL, canvas manquants |
| Pas d'interaction | Le mode géré exige un véritable clic sur la case à cocher |
| TLS n'est qu'un signal | La correspondance JA3/JA4 ne suffit pas à elle seule |
| Fonctionnalité | Description |
|---|---|
| SeleniumBase UC Mode | Déconnexion-reconnexion du driver + clic captcha au niveau de l'OS |
| SeleniumBase CDP Mode | Voie CDP pure avec signaux d'attachement WebDriver réduits |
| nodriver CDP | Sans chromedriver ; clic par gabarit verify_cf() (OpenCV) |
| Parallélisation / rotation de proxies | Workers par lots et rotation du fichier de proxies dans simple_bypass.py |
| Contrôle du délai | Délai de bout en bout sur les flux principaux |
| Export de cookies | Formats JSON et Netscape le cas échéant |
| Multiplateforme | macOS, Windows, Linux (Linux nécessite Xvfb sur hôte sans affichage) |
| Élément | Exigence |
|---|---|
| Python | 3.9+ |
| Navigateur | Google Chrome (ou Chromium sur Linux non-amd64) |
| Affichage | Interface graphique fenêtrée de préférence ; serveurs Linux : Xvfb / affichage virtuel |
| OS | macOS, Windows, Linux |
| Proxy optionnel | HTTP / HTTPS / SOCKS5 avec HTTPS CONNECT fonctionnel |
Les paquets Python sont listés dans requirements.txt (SeleniumBase, nodriver, curl_cffi, OpenCV headless, pyvirtualdisplay, etc.).
git clone https://github.com/1837620622/cloudflare-bypass-2026.git
cd cloudflare-bypass-2026
pip install -r requirements.txt
Installez Google Chrome avant d'exécuter les scripts basés sur navigateur.
git clone https://github.com/1837620622/cloudflare-bypass-2026.git
cd cloudflare-bypass-2026
sudo bash install_linux.sh
Alternative manuelle :
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
Remarques
.deb officiels de Chrome sont principalement amd64. Sur les hôtes ARM, préparez vous-même une build Chromium/Chrome de l'architecture correspondante.# 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
Remplacez https://example.com par une cible que vous êtes autorisé à tester.
bypass.py (par défaut)Session Chrome unique via le mode UC de SeleniumBase : 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