CloakHQ/CloakBrowser

CloakBrowser – Playwright / Puppeteer 用的隱身 Chromium

是什麼

• 一個在 C++ 原始碼層級應用了 87 個補丁的自訂建構 Chromium 二進位檔。目標是讓瀏覽器在反機器人服務眼中看起來完全像一個普通的非無頭 Chrome。
• 二進位檔被封裝在 Python、JavaScript/Node 和 .NET 的輕量級函式庫中，公開與 Playwright（及 Puppeteer）相同的 API。你可以直接使用 import { launch } from 'cloakbrowser'（或 from cloakbrowser import launch），無需修改現有的自動化程式碼。

對 AI 代理 / 自動化的重要性

• 許多現代 AI 代理（LangChain、Crawl4AI 等）依賴瀏覽器取得動態頁面。這些代理經常被 reCAPTCHA、Cloudflare Turnstile、FingerprintJS 等服務攔截。CloakBrowser 透過防止挑戰出現，消除了對獨立 CAPTCHA 解決服務的需求。
• 由於隱身功能已內建於二進位檔中，它能抵禦 Chrome 更新；你無需反覆應用基於 JavaScript 的「隱身外掛」。

主要功能（如 README 所述）

功能	詳細
原始碼層級隱身	87 個 C++ 补丁，涵蓋 canvas、WebGL、音訊、字型、GPU、螢幕尺寸、WebRTC、網路延遲、自動化標誌、CDP 輸入行為等
人性化模式	humanize=True 使滑鼠移動、輸入和捲動遵循現實的貝茲曲線與時間間隔
高 reCAPTCHA v3 分數	最新版本報告為 0.9（人類水準）
通過 Cloudflare Turnstile、FingerprintJS、BrowserScan 檢測	在 30 多個檢測網站上測試通過
自動下載正確二進位檔	pip install cloakbrowser / npm install cloakbrowser 會拉取合適的 Chromium 建構（免費或 Pro）並本地快取
代理與地理 IP 支援	支援 HTTP 或 SOCKS5 代理；geoip=True 可同步時區/區域設定，並偽造 WebRTC ICE 候選者以匹配代理出口 IP
跨語言封裝	Python、Node（Playwright 與 Puppeteer）、.NET（NuGet 套件）
Docker 就緒	docker run --rm cloakhq/cloakbrowser cloaktest 可執行快速自檢；二進位檔在容器中可無頭運行
持久化設定檔與擴充	launch_persistent_context() 可保持 cookies/localStorage；extension_paths 支援載入 Chrome 擴充
CloakBrowser Manager（GUI）	獨立開源 GUI（MIT 許可證），可建立無限數量的隔離設定檔，每個設定檔擁有獨立指紋、代理與 CDP 端點

典型用法（Python）

from cloakbrowser import launch

browser = launch(
    proxy="http://user:pass@residential-proxy:8080",
    geoip=True,
    headless=False,
    humanize=True,
)
page = browser.new_page()
page.goto("https://example.com")
print(page.title())
browser.close()

典型用法（Node – Playwright）

import { launch } from 'cloakbrowser';

const browser = await launch({
  proxy: 'http://user:pass@residential-proxy:8080',
  geoip: true,
  headless: false,
  humanize: true,
});
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

安裝

• Python: pip install cloakbrowser
• Node: npm install cloakbrowser playwright-core（Puppeteer 用為 ... puppeteer-core）
• .NET: dotnet add package CloakBrowser
• 首次執行時會自動下載合適的 Chromium 二進位檔（約 200 MiB）並使用 Ed25519 簽名驗證。

授權與定價

• 倉儲採用 MIT 授權；二進位檔採用獨立授權分發。
• 免費金鑰（GitHub 登入）提供一個並行會話，使用最新建構版本。
• CloakBrowser Pro 提供無限並行會話、優先更新與官方支援。金鑰可透過 CLOAKBROWSER_LICENSE_KEY 環境變數或 license_key 參數設定。

內部運作原理

1. 二進位檔建構 – 團隊 fork Chromium，應用 87 個補丁，為每個平台建構二進位檔，對歸檔檔案簽名並托管。
2. 封裝層 – Python/JS/.NET 套件是輕量代理，下載二進位檔，透過 Playwright/Puppeteer 啟動，並注入少量啟動參數（如 --fingerprint-webrtc-ip=auto）。
3. 驗證機制 – 下載內容透過公開的 Ed25519 校驗和比對，防止篡改。

可能需要它的情況

• 抓取對無頭瀏覽器進行嚴格檢測的網站。
• 運行需要瀏覽但無需人工干預且必須隱蔽的 AI 代理。
• QA 或監控流程，必須像真實使用者一樣渲染頁面。
• 當前依賴脆弱「隱身外掛」解決方案的任何自動化任務。

限制

• CloakBrowser 無法解決已出現的 CAPTCHA；其目標是防止它們出現。
• 為獲得最高成功率，仍需自行提供住宅代理。
• 免費版僅限單一並行會話；大規模使用需 Pro 授權。

---

以上所有資訊均直接來自專案 README；未推斷任何額外功能。