Planos e limites
O que uma licença pode baixar e buscar por dia, o que acontece acima de um limite e como ficar abaixo dele. Os preços e o que cada plano inclui estão em Preços.
Em resumo
- Downloads da versão licenciada: 20 por minuto e 30 a cada 24 horas da mesma versão. Inícios que encontram a versão no cache nunca contam.
- Personas diferentes por dia: 750 no plano gratuito, 1,000,000 nos planos pagos. Reiniciar uma seed que você já usou hoje não custa nada.
- Acima de um limite, você recebe HTTP 429. Mantenha o cache do navegador em um volume e reutilize um conjunto fixo de seeds.
Limites de download
Os downloads da versão licenciada têm limite por licença, para que uma configuração que baixa o arquivo completo a cada início não saia do controle. Um início que encontra a versão no cache não baixa nada e nunca conta: só downloads reais contam.
| Limite | Vale para | O que conta |
|---|---|---|
| 20 downloads por minuto e 30 a cada 24 horas | Toda licença, por versão (número da versão + sistema operacional) | Downloads do arquivo da mesma versão. Uma nova versão começa com uma cota nova. |
| 10 versões diferentes a cada 24 horas | Licenças gratuitas | Versões diferentes baixadas. Uma versão que você já baixou hoje não conta de novo. |
| 60 verificações por minuto | Por endereço IP | A verificação de versão que todo início faz em /api/v1/download/pro, com cache ou sem. |
Acima de um limite, o SDK recebe HTTP 429 com um corpo JSON (code é DOWNLOAD_RATE_LIMITED (cota por versão) ou DOWNLOAD_LIMIT_EXCEEDED (plano gratuito)) e um cabeçalho Retry-After: os segundos até o limite ser reiniciado. Inícios cuja versão já está no cache continuam funcionando. A partir do SDK 0.62.0, um início que não consegue baixar uma versão nova abre, em vez de falhar, a versão mais recente da mesma versão do Chromium que já está no cache, e espera o Retry-After antes de tentar esse download de novo. Um início fixado em uma revisão exata (r50) continua recebendo essa versão ou um erro.
Você atinge esses limites quando muitas máquinas ou contêineres novos sobem ao mesmo tempo, cada um com o cache vazio. Baixe cada versão uma vez por máquina em vez de uma vez por início: os inícios também ficam mais rápidos, sem um download de cerca de 460 MB:
- Mantenha o cache em um volume. Aponte
CLEARCOTE_CACHEpara um diretório que sobreviva a reinícios. Inícios que o compartilham esperam o primeiro download e o reaproveitam. - Coloque o navegador na sua imagem. Rode
clearcote installno build, para que todo contêiner já comece com a versão no lugar. Refaça a imagem quando atualizar.
# 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 usLimites de personas
Cada inicialização busca a sua persona (o fingerprint que a seed e as opções descrevem) no serviço de personas. Cada licença pode buscar um número fixo de personas diferentes por dia. Buscar uma persona que você já usou hoje não custa nada, então um conjunto fixo de perfis pode ser reiniciado quantas vezes você quiser.
| Plano | Personas diferentes por dia |
|---|---|
| Grátis | 750 |
| Pro e outros planos pagos | 1,000,000 |
Uma persona é uma seed com um conjunto de opções de fingerprint (marca, plataforma etc.), então a mesma seed como Chrome e como Edge conta duas vezes. A contagem é reiniciada às 00:00 UTC. Acima do limite, a inicialização falha com HTTP 429 do serviço de personas (daily persona quota reached) até a reinicialização.
Isso acontece quando cada inicialização usa uma seed aleatória nova. Em vez disso, reutilize um conjunto fixo de seeds, por exemplo uma lista de algumas centenas de nomes que você vai alternando: cada um mantém o mesmo fingerprint toda vez que inicia, e reiniciá-lo nunca conta de novo.