Cloudflare Bypass Tool 2026

macOS、Windows、Linux 上で Cloudflare Turnstile / Challenge フローを調査・テストするためのマルチストラテジーツールキットです。

Cloudflare Turnstile / Challenge 向けの多方式による調査・許可済みテスト用ツールセット。Mac / Windows / Linux に対応。

目次

免責事項

英語

このプロジェクトは、教育目的の研究と許可を得た自動化テストのみを目的としています。適用される法令および対象ウェブサイトの利用規約を遵守する必要があります。

• 特定のサイトや環境への適合性は保証されません。
• 成功率は IP の評判、ブラウザ環境、対象サイトのポリシー、タイミングによって変動します。
• データセンター IP、真ヘッドレスモード、ディスプレイのないコンテナ環境では、通常成功率が低下します。

日本語

このプロジェクトは、学習研究と許可済みの自動化テストのみを目的としています。使用時は現地の法令および対象サイトの利用規約を遵守してください。

• いかなるサイト・環境に対しても通過率を保証するものではありません。
• 実際の効果は IP の評判、ブラウザ環境、対象のポリシーとタイミングに影響されます。
• データセンター IP、真ヘッドレスモード、GUI のないコンテナ環境では、通常成功率が大幅に低下します。

概要

英語

2025～2026 年の Cloudflare 防御は多層化しています。ネットワークの評判、TLS/HTTP フィンガープリント、JavaScript チャレンジ、Turnstile のインタラクション、自動化プロトコルのシグナルなどです。単一の HTTP クライアントでは Turnstile に対応できません。

このリポジトリは、5 つの実行可能な方式と 1 つのクラスベースラッパーを提供します。単一セッションの調査、バッチジョブ、ピュア CDP 制御、または解決済みセッションの TLS レベルでの再利用に適した経路を選択できます。

推奨ベースライン（オープンソースで実現する経路）:

有頭の本物の Chrome
  + 任意：住宅用 / 高品質の出口 IP
  + UC 再接続 または ピュア CDP
  + インタラクションが必要な場合は OS レベルのキャプチャクリック

Turnstile の主経路としては推奨しない構成:

真ヘッドレスモードで Managed Turnstile に正面から挑む
curl_cffi / tls-client のみで Turnstile に挑む
playwright-stealth を単独で「ワンクリック解決策」として使う

日本語

2025～2026 年の Cloudflare 検知は多層化しています。ネットワーク評判、TLS/HTTP フィンガープリント、JS Challenge、Turnstile のインタラクション、自動化プロトコルの特徴などです。HTTP クライアントだけでは Turnstile を完了できません。

本リポジトリは、5 つの実行可能な方式と 1 つのクラスカプセル化エントリを提供します。単一セッションの調査、バッチタスク、ピュア CDP 制御、ブラウザで解決後の TLS 層セッション再利用をカバーします。

オープンソース環境でのより安定したベースライン:

有頭の本物の Chrome
  + 任意：住宅用または高品質の出口 IP
  + UC の切断再接続 または ピュア CDP
  + インタラクションが必要な場合は OS レベルのクリック

Turnstile の主経路としては非推奨:

真ヘッドレスモードで Managed Turnstile に強行突破
curl_cffi / tls-client のみで Turnstile に直接挑む
playwright-stealth だけを「ワンクリック解決策」として使用

方式比較

選択優先度

なぜ curl_cffi は Turnstile を通過できないのか

機能

必要環境

Python パッケージは requirements.txt に記載されています（SeleniumBase、nodriver、curl_cffi、OpenCV headless、pyvirtualdisplay など）。

Python の依存関係は requirements.txt を参照してください（SeleniumBase、nodriver、curl_cffi、OpenCV headless、pyvirtualdisplay などを含む）。

インストール

macOS / Windows

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

ブラウザベースのスクリプトを実行する前に、Google Chrome をインストールしてください。

先に 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 ビルドを各自でインストールしてください。
• 公式 Chrome deb は主に 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 は、テストを許可された対象 URL に置き換えてください。

サンプル URL は、テスト権限のある対象アドレスに置き換えてください。

使用方法

1. UC 単一ブラウザ — bypass.py（デフォルト）

SeleniumBase UC Mode による単一 Chrome セッション: uc_open_with_reconnect + uc_gui_click_captcha / uc_gui_handle_captcha。

単一ブラウザの UC モード: 切断状態でページを開き、チャレンジを検出したら OS レベルでクリックします。

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

2. 並列 / ローテーション — simple_bypass.py

複数プロキシ / 複数ブラウザのバッチ処理向け。OS レベルの GUI クリックは、同一デスクトップ上ではマルチウィンドウに対して安全ではありません。並列ワーカーがマウスを奪い合う可能性があります。

複数プロキシ / 複数ブラウザのバッチ処理向け。OS レベルのクリックは、同一デスクトップ上でマルチウィンドウ安全性を備えていません。並列実行時は互いに干渉する可能性があります。

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

3. nodriver ピュア CDP — bypass_nodriver.py

chromedriver 不要の CDP 制御。チャレンジクリックには verify_cf()（OpenCV テンプレートマッチング）を使用します。アップストリームライセンスは AGPL-3.0 です。

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