Skip to content

S3 互換チャンネルの追加

S3 チャンネルは、S3 API に対応したオブジェクトストレージを ImgBed の保存先として利用します。

Cloudflare R2、Backblaze B2、MinIO、AWS S3、自前の S3 互換サービスなどに対応できます。

事前に用意するもの

必要なもの用途
S3 Endpointオブジェクトストレージの API URL
Bucket 名ファイルを保存するバケット
Regionストレージのリージョン。Cloudflare R2 は通常 auto
Access Key IDS3 アクセスキー
Secret Access KeyS3 シークレットキー
CDN ドメイン任意。独自の配信ドメインを使う場合

Cloudflare R2 の S3 API 例:

text
Endpoint: https://あなたのAccountID.r2.cloudflarestorage.com
Bucket: R2バケット名
Region: auto

設定場所

  1. システム設定を開きます。
  2. アップロード設定を開きます。
  3. 「チャンネル追加」をクリックします。
  4. S3 を選択します。

入力項目

項目説明
チャンネル名例:R2-S3MinIO
Endpointhttps:// を含む S3 API URL
カスタム CDN ドメイン任意。設定時はリンク生成に優先利用します
Bucket 名保存先バケット
RegionR2 は auto、他はサービス仕様に合わせます
Access Key IDS3 アクセスキー
Secret Access KeyS3 シークレットキー
Path-style accessMinIO や一部互換サービスで必要な場合だけオン
容量制限必要に応じてオン

R2 で S3 キーを作る

Cloudflare Dashboard で R2 Object Storage を開き、API Token 管理へ進みます。

![R2 API Token 入口](../../image/upload/s3/r2 api token入口.png)

対象バケットへアクセスできる R2 API Token を作成します。

API Token 作成

生成された Access Key IDSecret Access Key をコピーします。

Token 値コピー

ImgBed へ入力する

  1. EndpointBucketRegion を入力します。
  2. Access Key ID と Secret Access Key を入力します。
  3. CDN を使う場合だけカスタム CDN ドメインを入力します。
  4. Path-style access は必要な場合のみオンにします。
  5. 保存します。

S3 設定

確認方法

確認項目正常な状態
チャンネルカード保存後に表示される
テストアップロード対象 Bucket にオブジェクトが作成される
リンクImgBed が返した URL を開ける
容量表示容量制限を使う場合、使用量が表示される

容量表示

S3 の容量統計は、保存先 API を毎回リアルタイムに走査するのではなく、ImgBed の D1 ファイル記録から再計算されます。

よくある原因

  • Endpoint に https:// がない。
  • Bucket 名または Region が違う。
  • Access Key に書き込み権限がない。
  • サービス側が Path-style access を必要としている。
  • CDN ドメインが Bucket と正しく接続されていない。

Released as user documentation for CloudFlare ImgBed.