Trình duyệt antidetect chỉ với một lệnh docker run
Pull image chính thức về là bạn có một trình duyệt Clearcote lắng nghe trên một cổng CDP. Trỏ Playwright, Puppeteer, browser-use, Crawl4AI hay Stagehand vào đó, code của bạn giữ nguyên. Image khởi chạy binary trực tiếp, không có switch automation, và navigator.webdriver vẫn là false.
Image chạy bản build mở mà không cần khóa. Thêm khóa GitHub miễn phí để dùng bản build mới nhất.
Chạy lên, rồi kết nối vào
# CDP on http://localhost:9222, published to this host only
docker run -d --rm -p 127.0.0.1:9222:9222 --shm-size=1g teamflatearth/clearcoteĐiểm nổi bật
Binary đã xác minh, đóng gói sẵn
Image chứa sẵn bản build mở cho Linux đã được xác minh SHA-256, cùng các bản font tương thích metric với những font Windows phổ biến, nên văn bản Latin có kích thước đo được giống font của persona. Bộ font của bản build mở không có font CJK; bộ font của bản build có giấy phép thì có.
Cấu hình bằng biến môi trường
Seed, platform, brand, ngôn ngữ, múi giờ và TLS profile đều là biến môi trường CC_*. Không có code nào bên trong container mà bạn phải bảo trì.
Bản build mới nhất khi cần
Đặt CLEARCOTE_LICENSE_KEY và container sẽ tự lấy bản build có giấy phép mới nhất, hoặc với gói Pro, một bản được ghim bằng CC_VERSION.
serve() và CLI
Không dùng Docker? serve() trong Python, Node hay .NET, hoặc lệnh clearcote serve từ shell, đều khởi chạy trực tiếp theo cùng cách đó và cho bạn một CDP URL.
Mọi CDP client
connectOverCDP của Playwright, puppeteer.connect, browser-use, Crawl4AI, Stagehand, hoặc DevTools Protocol thô trên cổng đó.
Dockerfile ai cũng kiểm tra được
Dockerfile và entrypoint của nó nằm trong repository công khai, nên bạn có thể đọc chính xác image cài đặt và chạy những gì, và tự build nó. Điều đó áp dụng cho image và bản build mở được đóng gói sẵn bên trong; với khóa giấy phép, container sẽ tải engine có giấy phép về khi khởi động.
Container được thiết lập như thế nào
Container khởi động Clearcote trực tiếp chứ không qua test driver, và mở Chrome DevTools Protocol trên cổng 9222. Khởi chạy trực tiếp chính là mấu chốt: các framework automation thêm những launch switch tự để lộ chính chúng, còn một endpoint thường trực do image khởi động thì không bao giờ truyền các switch đó.
Persona mặc định là một danh tính Linux gốc nhất quán, và mặc định đó là có chủ đích. Một phần những gì trang đọc được đến từ hệ điều hành bên dưới trình duyệt: trong container Linux, văn bản được FreeType dàn chữ (shaping) và font đến từ fontconfig, bất kể user agent nói gì. Khi đo trên image này với persona Windows, mỗi bước tăng cỡ chữ 0.01 px làm thay đổi độ rộng văn bản ở 66% số bước, so với 99% trên Chrome Windows thật. Để có danh tính Windows, hãy chạy bản build Windows, hoặc dùng trình duyệt hosted, vốn chạy trên máy Windows.
Container có giấy phép sẽ tải engine về ở lần khởi động đầu tiên và nhận một lease giới hạn số phiên đồng thời, nên cần truy cập ra ngoài tới licence API. Hãy mount volume cache để engine chỉ tải về một lần, thay vì container mới nào cũng tải lại.
Những gì kết nối được qua CDP
| Client | Cách kết nối |
|---|---|
| Playwright | chromium.connect_over_cdp(url) / connectOverCDP(url) |
| Puppeteer | puppeteer.connect({ browserURL: url, defaultViewport: null }) |
| browser-use · Crawl4AI · Stagehand | Trỏ tùy chọn CDP endpoint của chúng tới URL này |
| Bất cứ thứ gì khác nói được CDP | DevTools Protocol thô trên cổng đã publish |
Mọi người dùng nó để làm gì
Scraper trong Compose hoặc Kubernetes
Một dịch vụ trình duyệt chạy cạnh các worker của bạn, cấu hình hoàn toàn bằng biến môi trường.
Framework agent
Đưa cho browser-use, Crawl4AI hay Stagehand một CDP URL thay vì một Chrome chạy local.
CI tái lập được
Một image tag được ghim cho mọi lần chạy pipeline cùng một bản build mở; khi dùng khóa giấy phép, chỉ CC_VERSION của gói Pro mới ghim được bản build có giấy phép.
Mọi ngôn ngữ
Bất cứ thứ gì có CDP client, từ Python, Node đến Go hay Rust, đều điều khiển được endpoint này.
Clearcote được xây dựng cho quyền riêng tư, kiểm thử, nghiên cứu và tự động hóa hợp pháp. Bạn chịu trách nhiệm về cách mình sử dụng nó và về việc tuân thủ điều khoản của các trang web bạn truy cập.
Gói nào có tính năng này
Docker image, serve() và CDP endpoint có ở mọi gói. Mặc định image chạy bản build mở; truyền vào một khóa giấy phép (miễn phí với GitHub cho một trình duyệt tại một thời điểm) để chạy bản build mới nhất. Giới hạn một trình duyệt của khóa miễn phí được tính chung trên tất cả container của bạn.
Câu hỏi thường gặp
Đó là Docker image nào?
teamflatearth/clearcote trên Docker Hub, được build từ Dockerfile trong repository công khai clearcote-browser. Chạy docker pull teamflatearth/clearcote để cập nhật một bản cũ.
Publish cổng 9222 có an toàn không?
Chỉ khi ở trong mạng mà bạn tin cậy. Có CDP endpoint là có toàn quyền điều khiển trình duyệt. Hãy chỉ publish nó trên máy host với -p 127.0.0.1:9222:9222, hoặc giữ nó trong mạng riêng, và tuyệt đối không mở nó ra một interface công khai.
Container có thể thể hiện danh tính Windows không?
Bạn có thể đặt CC_PLATFORM=windows, nhưng font metric và font hệ thống trong container Linux vẫn đến từ Linux, và bài kiểm tra fingerprint sẽ nhận ra. Persona Linux mặc định thì nhất quán. Để có danh tính Windows, hãy chạy bản build Windows trên Windows, hoặc dùng trình duyệt hosted.
Làm sao để chạy bản build có giấy phép trong Docker?
Đặt CLEARCOTE_LICENSE_KEY và mount một volume tại /opt/xdg-cache để engine chỉ phải tải về một lần. Cần image được build từ SDK 0.26.1 trở lên, và 0.30.0 trở lên nếu dùng khóa GitHub miễn phí. Log khởi động cho biết bạn nhận được engine nào và đã lấy được lease giấy phép hay chưa.
Vì sao navigator.webdriver vẫn là false?
Engine không còn đặt giá trị này dựa trên --enable-automation, switch mà automation thông thường sử dụng, và dù sao thì image cũng khởi động trình duyệt mà không có switch đó. Việc kết nối client qua CDP sau đó không làm thay đổi giá trị này.
Tìm hiểu sâu hơn trong tài liệu
Tính năng liên quan
Khởi chạy trình duyệt Clearcote trên cloud bằng một lệnh gọi API rồi kết nối Playwright hoặc Puppeteer qua CDP. Đã kèm IP dân cư, tính phí theo GB lưu lượng.
Cho browser-use, Stagehand, Crawl4AI hoặc agent của riêng bạn một Chromium có danh tính thiết lập ở cấp engine, hoặc chạy agent trong trình duyệt của Clearcote (bật khi cần) với model của riêng bạn.
Cho Claude Desktop, Cursor hoặc Cline một trình duyệt Clearcote qua Model Context Protocol: hai mươi tool, bên dưới là một danh tính nhất quán.
Chromium thay thế trực tiếp cho Playwright và Puppeteer: chỉ đổi một dòng import trong Python, Node hay .NET, trình duyệt được tự động tải về và xác minh SHA-256 cho bạn.
Bài đọc liên quan
Dùng thử Clearcote
Thay thế drop-in cho Playwright & Puppeteer, nhất quán đến tận TLS handshake, với một bản build mã nguồn mở để bắt đầu.
Miễn phí cho một trình duyệt với GitHub. Không cần thẻ.