制限とクォータ
Miseru の制限値と、失効がどこまで保証されるかの一覧です。値はすべて実装上の実値です。
| 項目 | 値 |
|---|---|
| 形式 | PNG / JPEG / WebP |
| サイズ | 5MB 未満(GitHub Camo の制限) |
名前(name) | 1〜200文字 |
| コミット SHA | 16進 7〜40 桁 |
| viewport | 幅x高さ 形式(各 1〜5 桁。例 1280x800)、任意 |
| 項目 | 値 |
|---|---|
| アップロード | プロジェクトあたり 120 回/分 |
| 超過時 | HTTP 429 + Retry-After: 60 |
失効ポリシーの値域
Section titled “失効ポリシーの値域”| 項目 | 値 |
|---|---|
| 選べるポリシー | pr_close(PR クローズで失効) / retain_days(N 日保持) / forever(無期限) |
retain_days の保持日数 | 1〜365 日の整数 |
URL・セッションの有効期限
Section titled “URL・セッションの有効期限”| 項目 | 値 |
|---|---|
配信 URL の署名有効期限(exp) | アップロードから 365日 |
| ダッシュボードのサムネイル URL | 30分(画面表示用の短命署名) |
| ダッシュボードのログインセッション | 7日 |
配信 URL の exp は「保持期間全体をカバーする上限」であり、実際の公開停止は失効ポリシーによる削除が優先されます。詳細は配信とセキュリティの仕組みを参照してください。
自動スイープ
Section titled “自動スイープ”retain_days の期限切れ画像と、失効処理が一時的に失敗した画像は、毎時実行される自動スイープ(1回あたり最大500件)が失効を完了させます。期限を過ぎてから実際に削除されるまで、最大1時間程度のずれが生じることがあります。
失効の保証範囲
Section titled “失効の保証範囲”| 項目 | 保証 |
|---|---|
| オリジン(R2)からの削除 | ✅ ポリシー通りに削除 |
| 配信 URL の無効化 | ✅ 削除後は 404 |
| GitHub Camo キャッシュ | ⚠️ 即時消去は保証されない(Cache-Control に従い自然失効)。pr_close は配信の max-age が最大300秒のため最大5分程度、retain_days は保持期限までにキャッシュも切れる。forever の手動失効はキャッシュ保持期間中残ることがある |
秘匿性の限界(重要)
Section titled “秘匿性の限界(重要)”配信 URL は推測不能な署名付きですが、URL を知る者は誰でも閲覧できます。PR に表示するために閲覧時の認可は行いません(GitHub Camo の制約)。機密情報を含む画像はアップロードしないでください。
どこまでが守られ、どこから先は守られないかの詳細は配信とセキュリティの仕組みで解説しています。