套餐与限制
一个许可证每天可以下载和获取多少、超出限制会怎样,以及如何保持在限制以内。价格和各套餐包含的内容见价格页面。
要点
- 授权版构建下载:同一构建每分钟 20 次、每 24 小时 30 次。在缓存中找到构建的启动从不计数。
- 每天不同身份画像的数量:免费套餐 750,付费套餐 1,000,000。用今天已用过的种子再次启动不计数。
- 超出限制会返回 HTTP 429。请把浏览器缓存放在卷上,并复用一组固定的种子。
下载限制
授权版构建的下载按许可证限速,避免每次启动都下载完整压缩包的配置失控。在缓存中找到构建的启动不会下载任何 内容,也从不计数——只有真正的下载才计数。
| 限制 | 适用于 | 计数内容 |
|---|---|---|
| 20 次下载 / 分钟,以及 30 次 / 24 小时 | 每个许可证,按构建计算(版本 + 操作系统) | 同一构建的压缩包下载。新版本发布后额度重新计算。 |
| 10 个不同构建 / 24 小时 | 免费许可证 | 下载的不同构建数量。今天已下载过的构建不再计数。 |
| 60 次检查 / 分钟 | 每个 IP 地址 | 每次启动向 /api/v1/download/pro 发出的构建检查,无论是否有缓存。 |
超出限制时,SDK 会收到带 JSON 正文的 HTTP 429——code 为 DOWNLOAD_RATE_LIMITED(按构建的额度)或 DOWNLOAD_LIMIT_EXCEEDED(免费套餐)——以及 Retry-After 头,表示距离限额重置还有多少秒。构建已在缓存中的启动不受影响。从 SDK 0.62.0 起,无法下载新构建的启动不会失败,而是启动缓存中同一 Chromium 版本的最新构建,并等到Retry-After 之后才重试该下载。固定到某个确切修订版(r50)的启动仍只会得到该构建或报错。
当许多全新的机器或容器同时启动、且各自缓存为空时,就会触及这些限制。每台机器只下载一次每个构建,而不是每次 启动都下载——这样启动也更快,省去约 460 MB 的下载:
- 把缓存放在卷上。将
CLEARCOTE_CACHE指向重启后仍保留的目录。共享它的启动会 等待第一次下载完成并复用它。 - 把浏览器打包进镜像。在构建镜像时运行
clearcote install,让每个容器启动时 构建已就位。升级时重新构建镜像。
# 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 us身份画像限制
每次启动都会从身份画像服务获取它的身份画像(即种子和选项所描述的指纹)。每个许可证每天可以获取一定数量的不同身份画像。获取今天已经用过的身份画像不计数,因此一组固定的配置文件可以随意重复启动。
| 套餐 | 每天不同身份画像数 |
|---|---|
| 免费 | 750 |
| Pro 及其他付费套餐 | 1,000,000 |
一个身份画像就是一个种子加一组指纹选项(品牌、平台等),因此同一个种子分别作为 Chrome 和 Edge 会计为两个。计数在 UTC 00:00 重置。超出限制后,启动会失败,身份画像服务返回 HTTP 429(daily persona quota reached),直到重置为止。
如果每次启动都使用一个全新的随机种子,就会碰到这个限制。请改为复用一组固定的种子,例如轮流使用一份几百个名字的列表:每个种子每次启动都保持同一个指纹,重复启动也不会再次计数。