CloakHQ/CloakBrowser

<p align="center"> <img src="https://i.imgur.com/cqkp6fG.png" width="500" alt="CloakBrowser"> </p>

<br>

<h3 align="center">모든 봇 탐지 테스트를 통과하는 스텔스 Chromium.</h3>

<table><tr><td> 패치된 설정이 아닙니다. JS 주입이 아닙니다. C++ 소스 수준에서 지문이 수정된 실제 Chromium 바이너리입니다. 안티봇 시스템은 이를 일반 브라우저로 평가합니다. 실제로 일반 브라우저이기 때문입니다. </td></tr></table>

<br>

<p align="center"> <img src="https://i.imgur.com/IvB0It7.gif" width="600" alt="Cloudflare Turnstile — 3 Tests Passing"> <br><em>Cloudflare Turnstile — 3개의 라이브 테스트 통과 (헤드 모드, macOS)</em> </p>

<br>

<p align="center"> Python 및 JavaScript를 위한 드롭인 Playwright/Puppeteer 대체품입니다.<br> 동일한 API, 동일한 코드 — import만 변경하면 됩니다. <strong>3줄의 코드, 30초면 차단 해제.</strong> </p>

• 58개의 소스 수준 C++ 패치 — canvas, WebGL, 오디오, 폰트, GPU, 화면, WebRTC, 네트워크 타이밍, 자동화 신호, CDP 입력 동작
• humanize=True — 사람과 유사한 마우스 곡선, 키보드 타이밍 및 스크롤 패턴. 하나의 플래그로 행동 탐지 통과
• 0.9 reCAPTCHA v3 점수 — 사람 수준, 서버 측 확인
• Cloudflare Turnstile, FingerprintJS, BrowserScan 통과 — 30개 이상의 탐지 사이트에서 테스트됨
• 자동 업데이트 바이너리 — 백그라운드 업데이트 확인, 항상 최신 스텔스 빌드 유지
• pip install cloakbrowser 또는 npm install cloakbrowser — 바이너리 자동 다운로드, 설정 불필요
• 무료 및 오픈 소스 — 구독 없음, 사용 제한 없음

지금 바로 사용해보세요 — 설치 불필요:

docker run --rm cloakhq/cloakbrowser cloaktest

Python:

from cloakbrowser import launch

browser = launch()
page = browser.new_page()
page.goto("https://example.com")
browser.close()

JavaScript (Playwright):

import { launch } from 'cloakbrowser';

const browser = await launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

Puppeteer에서도 작동: import { launch } from 'cloakbrowser/puppeteer' (자세히)

안티봇 보호가 있는 사이트의 경우, 리지덴셜 프록시와 다음 플래그를 추가하세요:

browser = launch(
    proxy="http://user:pass@residential-proxy:port",  # 데이터센터가 아닌 리지덴셜 IP
    geoip=True,       # 프록시 IP에 맞게 시간대 + 로케일 일치
    headless=False,    # 일부 사이트는 C++ 패치에도 헤드리스 모드 탐지
    humanize=True,     # 사람과 유사한 마우스, 키보드, 스크롤
)

const browser = await launch({
    proxy: 'http://user:pass@residential-proxy:port',
    geoip: true,
    headless: false,
    humanize: true,
});

사이트별 문제(FingerprintJS, Kasada, reCAPTCHA)는 문제 해결을 참조하세요.

설치

Python:

pip install cloakbrowser

JavaScript / Node.js:

# Playwright 사용 시
npm install cloakbrowser playwright-core

# Puppeteer 사용 시
npm install cloakbrowser puppeteer-core

.NET / C#:

dotnet add package CloakBrowser

커뮤니티 유지 관리.NET 클라이언트로 Microsoft.Playwright 기반. 전체 API는 dotnet/README.md 참조.

첫 실행 시 스텔스 Chromium 바이너리가 자동으로 다운로드됩니다 (~200MB, 로컬에 캐시됨).

선택 사항: 프록시 IP에서 시간대/로케일 자동 감지:

pip install cloakbrowser[geoip]

Playwright에서 마이그레이션? 한 줄 변경:

- from playwright.sync_api import sync_playwright
- pw = sync_playwright().start()
- browser = pw.chromium.launch()
+ from cloakbrowser import launch
+ browser = launch()

page = browser.new_page()
page.goto("https://example.com")
#... 나머지 코드는 변경 없이 작동

⭐ Star를 눌러 지원을 표시하세요 — Watch releases를 통해 새 빌드 출시 알림을 받으세요.

최신: v0.4.4 — 버전 고정/롤백 (Chromium 148.0.7778.215.3)

• CloakBrowser Pro — 최신 바이너리(Chromium 148.0.7778.215.3, 59개 소스 수준 패치)는 Pro 구독자에게 제공되며, 이제 모든 플랫폼(macOS 포함, Apple Silicon + Intel)에서 사용 가능; v146은 영원히 무료로 유지됩니다. licensekey (licenseKey in JS) 또는 CLOAKBROWSERLICENSE_KEY 환경 변수를 설정하면 래퍼가 자동으로 최신 빌드를 가져옵니다. CloakBrowser Pro 참조
• .NET 8 / C# 클라이언트 — CloakBrowser가 이제 NuGet 패키지(CloakBrowser)로 제공되며, Python 및 JS 래퍼를 미러링합니다.
• 58개의 지문 패치 — Linux 및 Windows 전반의 렌더링 일관성 개선, 일반 Chrome 146 프로필과 일치하도록 GPU/디스플레이/그래픽 매개변수 수정
• Windows 네이티브 GPU 패스스루 — 실제 하드웨어 값이 스푸핑 대신 직접 전달되어 실제 브라우저 동작과 일치
• HTTP 프록시 인라인 자격 증명 — 인라인 인증이 있는 프록시를 위한 새로운 네트워크 계층 지원
• extension_paths — 모든 실행 함수에서 Chrome 확장 프로그램 로드
• Humanize 실행 가능성 — 사람화된 작업 전에 표시되고, 활성화되고, 안정적인 요소를 자동으로 대기
• 호출별 human_config — 개별 메서드 호출에서 humanize 설정 재정의
• 구성 가능한 JS 헬퍼 — 사용자 정의 Playwright 통합을 위한 buildLaunchOptions() 및 humanizeBrowser()
• 네이티브 SOCKS5 프록시 — proxy="socks5://user:pass@host:port"가 모든 실행 함수(Python + JS)에서 직접 작동. QUIC/HTTP3는 UDP ASSOCIATE를 통해 SOCKS5 터널링
• 프록시 신호 제거 — DNS/connect/SSL 타이밍 제로화, 프록시 캐시 헤더 제거, Proxy-Connection 헤더 누수 제거
• Chromium 146 업그레이드 — 모든 패치를 145.0.7632.x에서 146.0.7680.177로 리베이스
• WebRTC IP 스푸핑 — --fingerprint-webrtc-ip=auto는 프록시의 출구 IP를 확인하고 WebRTC ICE 후보를 스푸핑합니다. geoip=True 사용 시 자동 주입 (추가 네트워크 호출 없음)
• humanize=True — 하나의 플래그로 모든 마우스, 키보드 및 스크롤 상호작용이 실제 사용자처럼 동작합니다. 베지어 곡선, 문자별 타이핑, 현실적인 스크롤 패턴
• 플래그 없이 스텔스 — 바이너리가 시작 시 무작위 지문 시드를 자동 생성합니다. 구성 불필요
• 프록시 IP의 시간대 및 로케일 — launch(proxy="...", geoip=True)가 시간대와 로케일을 자동 감지
• 영구 프로필 — launchpersistentcontext()는 세션 간 쿠키와 localStorage를 유지하고, 시크릿 모드 탐지를 우회합니다.

전체 CHANGELOG.md에서 자세한 내용을 확인하세요.

왜 CloakBrowser인가?

• 설정 수준 패치는 깨집니다 — playwright-stealth, undetected-chromedriver, puppeteer-extra는 JavaScript를 주입하거나 플래그를 조정합니다. Chrome 업데이트마다 깨집니다. 안티봇 시스템은 패치 자체를 탐지합니다.
• CloakBrowser는 Chromium 소스 코드를 패치합니다 — 지문이 C++ 수준에서 수정되어 바이너리로 컴파일됩니다. 탐지 사이트는 실제 브라우저를 보게 됩니다. 실제 브라우저이기 때문입니다.
• 소스 수준 스텔스 — C++ 패치가 바이너리 수준에서 지문(GPU, 화면, UA, 하드웨어 보고)을 처리합니다. JavaScript 주입이나 설정 수준 해킹이 없습니다. 대부분의 스텔스 도구는 표면만 패치합니다.
• 모든 곳에서 동일한 동작 — 로컬, Docker, VPS에서 동일하게 작동합니다. 환경별 패치나 구성이 필요하지 않습니다.
• AI 에이전트 및 자동화 프레임워크와 함께 작동 — browser-use, Crawl4AI, Scrapling, Stagehand, LangChain, Selenium 등을 위한 드롭인 스텔스. 통합 참조.

CloakBrowser는 CAPTCHA를 해결하지 않습니다. CAPTCHA가 나타나는 것을 방지합니다. CAPTCHA 해결 서비스나 프록시 로테이션이 내장되어 있지 않습니다. 자체 프록시를 가져와서 이미 알고 있는 Playwright API를 사용하세요.

CloakBrowser Pro

래퍼(Python + JS)는 MIT 라이선스로 영원히 무료입니다. 바이너리는 지연된 무료 릴리스 모델을 사용합니다:

• 무료 (v146) — 이전 바이너리, GitHub Releases에서 제공. 탐지가 진화함에 따라 몇 주 내에 구식이 됩니다.
• Pro (최신, Chromium 148.0.7778.215.3) — 최신 패치 및 Chromium 업그레이드가 먼저 제공되므로 아래 결과가 안티봇 시스템이 변경됨에 따라 계속 유효합니다. Linux, Windows, macOS (Apple Silicon + Intel).

안티봇 탐지는 지속적으로 업데이트되며, 오래된 바이너리는 빠르게 성능이 저하됩니다. Pro는 적극적으로 유지 관리되는 빌드를 사용할 수 있게 해줍니다.

CloakBrowser가 프로덕션 스크래핑, QA, 모니터링 또는 자동화의 일부이고 오래된 브라우저 지문이 시간이나 차단된 실행을 초래하는 경우 Pro를 사용하세요.

라이선스 키(환경 변수, license_key= 매개변수 또는 ~/.cloakbrowser/license.key)로 활성화:

export CLOAKBROWSER_LICENSE_KEY=cb_xxxxxxxx

Pro 요금제 → cloakbrowser.dev

테스트 결과

모든 테스트는 라이브 탐지 서비스에 대해 검증되었습니다. 마지막 테스트: 2026년 6월 (Chromium 148).

증명

<p align="center"> <img src="https://i.imgur.com/hvIQyMv.png" width="600" alt="reCAPTCHA v3 — Score 0.9"> <br><em>reCAPTCHA v3 점수 0.9 — 서버 측 확인 (사람 수준)</em> </p>

<p align="center"> <img src="https://i.imgur.com/qMIRfhq.png" width="600" alt="Cloudflare Turnstile — Success"> <br><em>Cloudflare Turnstile 비대화형 챌린지 — 자동 해결</em> </p>

<p align="center"> <img src="https://i.imgur.com/PRsw6rT.png" width="600" alt="BrowserScan — Normal"> <br><em>BrowserScan 봇 탐지 — 정상 (4/4 검사 통과)</em> </p>

<p align="center"> <img src="https://i.imgur.com/9n2C7tu.png" width="600" alt="FingerprintJS — Passed"> <br><em>FingerprintJS 웹 스크래핑 데모 — 데이터 제공, 차단되지 않음</em> </p>

<p align="center"> <img src="https://i.imgur.com/srCcFtK.png" width="600" alt="deviceandbrowserinfo.com — You are human!"> <br><em>deviceandbrowserinfo.com 행동 봇 탐지 — "당신은 사람입니다!"</em> </p>