プランと制限
ライセンスが 1 日にダウンロード・取得できる量、制限を超えたときに起きること、制限内に収める方法をまとめています。料金と各プランの内容は料金ページをご覧ください。
要点
- ライセンス版ビルドのダウンロード:同じビルドにつき 1 分あたり 20 回、24 時間あたり 30 回まで。キャッシュにビルドが見つかった起動は数えられません。
- 1 日あたりの異なるペルソナ数:無料プランは 750、有料プランは 1,000,000。今日すでに使ったシードでの再起動は数えられません。
- 制限を超えると HTTP 429 が返ります。ブラウザのキャッシュはボリュームに置き、決まったシードのプールを使い回してください。
ダウンロード制限
ライセンス版ビルドのダウンロードにはライセンスごとの回数制限があり、起動のたびにアーカイブ全体を取得する構成が 暴走しないようになっています。キャッシュにビルドがある起動は何もダウンロードせず、回数にも数えられません。 数えるのは実際のダウンロードだけです。
| 制限 | 対象 | 数えるもの |
|---|---|---|
| 20 回のダウンロード / 分、30 回 / 24 時間 | すべてのライセンス、ビルドごと(バージョン + OS) | 同じビルドのアーカイブのダウンロード。新しいリリースでは枠がリセットされます。 |
| 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ペルソナの上限
起動のたびに、ペルソナ(シードとオプションが表すフィンガープリント)をペルソナサービスから取得します。ライセンスごとに、1 日に取得できる異なるペルソナの数が決まっています。その日にすでに使ったペルソナの再取得はカウントされないため、決まったプロファイルの組み合わせなら何度でも再起動できます。
| プラン | 1 日あたりの異なるペルソナ数 |
|---|---|
| 無料 | 750 |
| Pro とその他の有料プラン | 1,000,000 |
ペルソナは、1 つのシードと 1 組のフィンガープリントオプション(ブランド、プラットフォームなど)の組み合わせです。そのため、同じシードでも Chrome と Edge では 2 つと数えます。カウントは 00:00 UTC にリセットされます。上限を超えると、リセットまでの間、起動はペルソナサービスからの HTTP 429(daily persona quota reached)で失敗します。
この上限に当たるのは、起動のたびにまったく新しいランダムなシードを使う場合です。代わりに、決まったシードのプールを再利用してください。たとえば数百個の名前のリストを順番に使います。どのシードも起動するたびに同じフィンガープリントを保ち、再起動してもカウントは増えません。