Cloudflare 우회 도구 2026

macOS, Windows, Linux에서 Cloudflare Turnstile / Challenge 흐름을 연구·테스트하기 위한 다중 전략 도구 키트입니다.

Cloudflare Turnstile / Challenge 대상의 다중 전략 연구·승인 테스트 도구 모음으로, Mac / Windows / Linux를 지원합니다.

---

목차

English	中文
면책 조항	면책 조항
프로젝트 개요	프로젝트 개요
방법 비교	방법 비교
주요 기능	주요 기능
환경 요구 사항	환경 요구 사항
설치	설치
빠른 시작	빠른 시작
사용 방법	사용 방법
Python API	Python API
프록시 형식	프록시 형식
출력	출력
프로젝트 구조	프로젝트 구조
FAQ	FAQ
참고 자료	참고 자료
비즈니스	비즈니스
라이선스	라이선스

---

면책 조항

English

이 프로젝트는 교육 목적의 연구 및 승인된 자동화 테스트용으로만 제공됩니다. 관련 법률과 대상 웹사이트의 서비스 이용약관을 반드시 준수해야 합니다.

• 특정 사이트나 환경에 대한 적합성을 보증하지 않습니다.
• 성공률은 IP 평판, 브라우저 환경, 대상 정책, 시점에 따라 달라집니다.
• 데이터센터 IP, 진짜 헤드리스 모드, 디스플레이가 없는 컨테이너는 일반적으로 성공률을 크게 낮춥니다.

中文

이 프로젝트는 학습·연구 및 사전 승인된 자동화 테스트 용도로만 제공됩니다. 사용 시 현지 법률·규정과 대상 사이트의 서비스 약관을 준수해야 합니다.

• 어떤 사이트·환경에 대해서도 통과율을 보장하지 않습니다.
• 실제 결과는 IP 평판, 브라우저 환경, 대상 정책, 시점의 영향을 받습니다.
• 데이터센터 IP, 진짜 헤드리스 모드, GUI가 없는 컨테이너 환경은 성공률을 크게 낮추는 경우가 많습니다.

---

프로젝트 개요

English

2025~2026년 Cloudflare 방어 체계는 다층적입니다. 네트워크 평판, TLS/HTTP 핑거프린팅, JavaScript Challenge, Turnstile 상호작용, 자동화 프로토콜 신호가 결합되어 있습니다. 단일 HTTP 클라이언트만으로는 Turnstile을 해결할 수 없습니다.

이 저장소는 5가지 실행 가능한 전략과 1개의 클래스 기반 래퍼를 제공하므로, 단일 세션 연구, 배치 작업, 순수 CDP 제어, 이미 해결된 세션의 TLS 계층 재사용 등 상황에 맞는 경로를 선택할 수 있습니다.

권장 기준 구성(오픈소스 기반):

Headed real Chrome
  + optional residential / high-quality egress IP
  + UC reconnect or pure CDP
  + OS-level captcha click when interaction is required

Turnstile 주 경로로는 권장하지 않는 구성:

True headless hard-target Managed Turnstile
Pure curl_cffi / tls-client against Turnstile
playwright-stealth alone as a “one-click” solution

中文

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 作为“一键方案”

---

방법 비교

#	Script	전략	Turnstile	적합한 용도
1	bypass.py	SeleniumBase UC Mode	Yes	기본 단일 세션 경로
2	simple_bypass.py	UC + 병렬 / 프록시 순환	Yes	배치 작업; 병렬 실행 시 시스템 마우스 경합 가능
3	bypass_nodriver.py	nodriver 순수 CDP	Yes	chromedriver 불필요 CDP; OpenCV 필요; AGPL-3.0 유의
4	bypass_curl_cffi.py	TLS 핑거프린트 / 쿠키 재사용	No	구형 JS Challenge 또는 해결 후 쿠키 재사용 전용
5	bypass_cdp.py	SeleniumBase CDP Mode	Yes	일반 UC의 2026년 후속 경로
—	bypass_seleniumbase.py	UC 클래스 래퍼	Yes	2차 개발용 임베드 가능 API

우선순위 안내

우선순위	선택	비고
1	bypass.py 또는 bypass_cdp.py	기본 연구 진입점
2	bypass_nodriver.py	강력한 CDP 대안; 라이선스 확인 필요
3	simple_bypass.py	처리량·순환; GUI 클릭은 필요한 경우 직렬화
4	브라우저 해결 후 curl_cffi 재사용	UA와 출발 IP를 동일하게 유지해야 함
지양	Turnstile 대상 순수 HTTP	JS 실행·상호작용 불가

curl_cffi가 Turnstile을 통과하지 못하는 이유

제한 사항	설명
JS 런타임 없음	Turnstile / 최신 Challenge PoW를 완료할 수 없음
DOM / Web API 없음	navigator, WebGL, canvas 신호가 없음
상호작용 없음	Managed 모드는 실제 체크박스 클릭이 필요
TLS는 신호 중 하나일 뿐	JA3/JA4 매칭만으로는 충분하지 않음

---

주요 기능

기능	설명
SeleniumBase UC Mode	드라이버 연결 해제·재연결 + OS 수준 캡차 클릭
SeleniumBase CDP Mode	WebDriver 부착 신호를 줄인 순수 CDP 경로
nodriver CDP	chromedriver 불필요; verify_cf() 템플릿 클릭 (OpenCV)
병렬 / 프록시 순환	simple_bypass.py의 배치 워커 및 프록시 파일 순환
제한 시간 제어	주요 흐름에 대한 종단 간 타임아웃
쿠키 내보내기	해당 시 JSON 및 Netscape 형식
크로스 플랫폼	macOS, Windows, Linux (헤드리스 호스트의 Linux는 Xvfb 필요)

---

환경 요구 사항

항목	요구 사항
Python	3.9+
브라우저	Google Chrome (amd64가 아닌 Linux에서는 Chromium)
디스플레이	유헤드 GUI 권장; Linux 서버: Xvfb / 가상 디스플레이
OS	macOS, Windows, Linux
선택 프록시	HTTPS CONNECT가 동작하는 HTTP / HTTPS / SOCKS5

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

인자	설명	기본값
url	대상 URL	필수
-p, --proxy	프록시 URL	없음
-t, --timeout	전체 타임아웃(초)	60
-r, --reconnect	재연결 전 연결 해제 시간(초)	5
--incognito	시크릿 모드	off
--no-save	쿠키 저장 안 함	off

---

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