Chuyển đến nội dung

Gói dịch vụ và giới hạn

Một giấy phép được tải xuống và lấy về bao nhiêu mỗi ngày, điều gì xảy ra khi vượt giới hạn và cách để luôn nằm dưới giới hạn. Giá và nội dung của từng gói có tại trang Bảng giá.

Tóm tắt

  • Lượt tải bản dựng có giấy phép: 20 mỗi phút và 30 mỗi 24 giờ cho cùng một bản dựng. Các lần khởi chạy tìm thấy bản dựng trong cache không bao giờ bị tính.
  • Số persona khác nhau mỗi ngày: 750 với gói Miễn phí, 1,000,000 với các gói trả phí. Khởi chạy lại một seed bạn đã dùng hôm nay không tốn gì.
  • Khi vượt giới hạn, bạn nhận HTTP 429. Hãy giữ cache của trình duyệt trên một volume và dùng lại một nhóm seed cố định.

Giới hạn tải xuống

Lượt tải bản dựng có giấy phép bị giới hạn theo từng giấy phép, để một cấu hình tải lại toàn bộ gói mỗi lần khởi động không vượt tầm kiểm soát. Lần khởi chạy tìm thấy bản dựng trong cache sẽ không tải gì và không bao giờ bị tính — chỉ lượt tải thật mới được tính.

Giới hạnÁp dụng choTính gì
20 lượt tải mỗi phút và 30 mỗi 24 giờMọi giấy phép, theo từng bản dựng (phiên bản + hệ điều hành)Lượt tải gói của cùng một bản dựng. Bản phát hành mới bắt đầu với hạn mức mới.
10 bản dựng khác nhau mỗi 24 giờGiấy phép miễn phíSố bản dựng khác nhau đã tải. Bản dựng bạn đã tải hôm nay không bị tính lại.
60 lượt kiểm tra mỗi phútTheo địa chỉ IPLượt kiểm tra bản dựng mà mỗi lần khởi chạy gửi tới /api/v1/download/pro, dù có cache hay không.

Khi vượt giới hạn, SDK nhận HTTP 429 kèm nội dung JSON — code là DOWNLOAD_RATE_LIMITED (hạn mức theo bản dựng) hoặc DOWNLOAD_LIMIT_EXCEEDED (gói miễn phí) — và header Retry-After: số giây cho đến khi giới hạn được đặt lại. Các lần khởi chạy có bản dựng đã nằm trong cache vẫn chạy bình thường. Từ SDK 0.62.0, một lần khởi chạy không tải được bản dựng mới sẽ mở bản dựng mới nhất cùng phiên bản Chromium đã có trong cache thay vì báo lỗi, và chờ hết Retry-After rồi mới thử tải lại. Một lần khởi chạy được ghim vào một revision cụ thể (r50) vẫn nhận đúng bản dựng đó hoặc một lỗi.

Bạn gặp các giới hạn này khi nhiều máy hoặc container mới khởi động cùng lúc, mỗi cái với cache trống. Hãy tải mỗi bản dựng một lần cho mỗi máy thay vì mỗi lần khởi động — khởi động cũng nhanh hơn, không phải tải khoảng 460 MB:

  • Đặt cache trên một volume. Trỏ CLEARCOTE_CACHE tới một thư mục còn lại sau khi khởi động lại. Các lần khởi động dùng chung sẽ chờ lượt tải đầu tiên rồi dùng lại nó.
  • Đưa trình duyệt vào image. Chạy clearcote install lúc build, để mọi container khởi động với bản dựng có sẵn. Build lại image khi nâng cấp.
bash
# 1. a shared, persistent cache
docker run -v clearcote-cache:/clearcote-cache -e CLEARCOTE_CACHE=/clearcote-cache …

# 2. or in your Dockerfile: download once while the image is built (the key stays out of the layers)
ENV CLEARCOTE_CACHE=/opt/clearcote-cache
RUN --mount=type=secret,id=clearcote_key \
    CLEARCOTE_LICENSE_KEY="$(cat /run/secrets/clearcote_key)" clearcote install

Need a higher limit? Tell us how you run Clearcote and we'll raise it for your licence.

Chat with us

Giới hạn persona

Mỗi lần khởi chạy lấy persona của nó (fingerprint mà seed và các tùy chọn mô tả) từ persona service. Mỗi giấy phép có thể lấy một số lượng persona khác nhau nhất định mỗi ngày. Lấy lại một persona bạn đã dùng trong ngày không tốn gì, nên một bộ profile cố định có thể khởi chạy lại bao nhiêu lần tùy ý.

GóiSố persona khác nhau mỗi ngày
Miễn phí750
Pro và các gói trả phí khác1,000,000

Một persona là một seed với một bộ tùy chọn fingerprint (thương hiệu, nền tảng, v.v.), nên cùng một seed dưới dạng Chrome và dưới dạng Edge được tính hai lần. Số đếm được đặt lại lúc 00:00 UTC. Khi vượt giới hạn, lần khởi chạy thất bại với HTTP 429 từ persona service (daily persona quota reached) cho đến lúc đặt lại.

Bạn gặp giới hạn này khi mỗi lần khởi chạy dùng một seed ngẫu nhiên hoàn toàn mới. Thay vào đó, hãy dùng lại một nhóm seed cố định, ví dụ một danh sách vài trăm cái tên mà bạn xoay vòng: mỗi seed giữ cùng một fingerprint mỗi lần khởi động, và khởi chạy lại nó không bao giờ bị tính thêm.

Cập nhật 22 thg 11, 2026 · SDK 0.70.4 · trình duyệt r63

Trang này có hữu ích không?