Pläne und Limits
Was eine Lizenz pro Tag herunterladen und abrufen darf, was über einem Limit passiert und wie Sie darunter bleiben. Preise und was jeder Tarif enthält, finden Sie unter Preise.
Kurz gesagt
- Downloads des lizenzierten Builds: 20 pro Minute und 30 pro 24 Stunden für denselben Build. Starts, die den Build in ihrem Cache finden, zählen nie.
- Verschiedene Personas pro Tag: 750 im kostenlosen Tarif, 1,000,000 in bezahlten Tarifen. Einen Seed, den Sie heute schon genutzt haben, erneut zu starten, kostet nichts.
- Über einem Limit erhalten Sie HTTP 429. Halten Sie den Browser-Cache auf einem Volume und nutzen Sie einen festen Pool von Seeds.
Download-Limits
Downloads des lizenzierten Builds sind pro Lizenz begrenzt, damit ein Setup, das bei jedem Start das ganze Archiv lädt, nicht ausufern kann. Ein Start, der den Build im Cache findet, lädt nichts herunter und zählt nie — nur echte Downloads zählen.
| Limit | Gilt für | Was zählt |
|---|---|---|
| 20 Downloads pro Minute und 30 pro 24 Stunden | Jede Lizenz, pro Build (Version + Betriebssystem) | Archiv-Downloads desselben Builds. Ein neues Release beginnt mit einem frischen Kontingent. |
| 10 verschiedene Builds pro 24 Stunden | Kostenlose Lizenzen | Verschiedene geladene Builds. Ein Build, den Sie heute schon geladen haben, kostet nichts mehr. |
| 60 Prüfungen pro Minute | Pro IP-Adresse | Die Build-Prüfung, die jeder Start bei /api/v1/download/pro macht, mit oder ohne Cache. |
Über einem Limit erhält das SDK HTTP 429 mit einem JSON-Body — code ist DOWNLOAD_RATE_LIMITED (Kontingent pro Build) oder DOWNLOAD_LIMIT_EXCEEDED (kostenloser Plan) — und einem Retry-After-Header: die Sekunden, bis das Limit zurückgesetzt wird. Starts, deren Build schon im Cache liegt, funktionieren weiter. Ab SDK 0.62.0 startet ein Start, der einen neuen Build nicht herunterladen kann, statt mit einem Fehler den neuesten Build derselben Chromium-Version aus seinem Cache und wartet Retry-After ab, bevor er diesen Download erneut versucht. Ein Start, der auf eine exakte Revision (r50) festgelegt ist, bekommt weiterhin genau diesen Build oder einen Fehler.
Diese Limits erreichen Sie, wenn viele frische Maschinen oder Container gleichzeitig starten, jeder mit leerem Cache. Laden Sie jeden Build einmal pro Maschine statt einmal pro Start — so starten sie auch schneller, ohne einen Download von etwa 460 MB:
- Halten Sie den Cache auf einem Volume. Richten Sie
CLEARCOTE_CACHEauf ein Verzeichnis, das Neustarts übersteht. Starts, die es teilen, warten auf den ersten Download und nutzen ihn. - Backen Sie den Browser in Ihr Image. Führen Sie
clearcote installbeim Build aus, damit jeder Container mit dem Build startet. Bauen Sie das Image beim Upgrade neu.
# 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 installNeed a higher limit? Tell us how you run Clearcote and we'll raise it for your licence.
Chat with usPersona-Limits
Jeder Start holt seine Persona (den Fingerprint, den Seed und Optionen beschreiben) vom Persona-Dienst. Jede Lizenz kann pro Tag eine feste Anzahl verschiedener Personas abrufen. Eine Persona, die Sie heute schon genutzt haben, erneut abzurufen, kostet nichts; ein fester Satz von Profilen kann also beliebig oft neu starten.
| Tarif | Verschiedene Personas pro Tag |
|---|---|
| Kostenlos | 750 |
| Pro und andere bezahlte Tarife | 1,000,000 |
Eine Persona ist ein Seed mit einem Satz von Fingerprint-Optionen (Marke, Plattform usw.); derselbe Seed als Chrome und als Edge zählt also doppelt. Der Zähler wird um 00:00 UTC zurückgesetzt. Über dem Limit schlägt der Start mit HTTP 429 vom Persona-Dienst fehl (daily persona quota reached), bis zum Zurücksetzen.
Das passiert, wenn jeder Start einen brandneuen zufälligen Seed verwendet. Nutzen Sie stattdessen einen festen Pool von Seeds, etwa eine Liste von einigen hundert Namen, die Sie reihum verwenden: Jeder behält bei jedem Start denselben Fingerprint, und ein erneuter Start zählt nie noch einmal.