アップロード用のS3互換オブジェクトストレージプロバイダーの設定

Discourse · 2020 年 4 月 22 日午後 10:37

このトピックでは、一般的な S3 互換オブジェクトストレージプロバイダー（S3 のクローン）の設定方法について説明します。Amazon AWS S3 の設定の詳細については、Discourse が公式にサポートしており、ホスティングサービス内部でも使用されている以下のページを参照してください：Set up file and image uploads to S3

プロバイダー	サービス名	Discourse と互換性あり？
Amazon AWS	S3	はい
Digital Ocean	Spaces	はい
Linode	Object Storage	はい
Google Cloud	Storage	はい
Scaleway	Object Storage	はい
Vultr	Object Storage	はい
BackBlaze	Cloud Storage	はい*
セルフホスト	MinIO	はい
Azure Blob Storage	Flexify.IO	はい
Oracle Cloud	Object Storage	いいえ ^[1]
Wasabi	Object Storage	不明
Cloudflare	R2	はい
Contabo	Object Storage	いいえ

他のサービスが動作することを確認した場合は、このウィキに追加してください。

設定

Discourse の静的アセットをオブジェクトストレージに保存するには、app.yml の hooks セクションに以下の設定を追加してください。

  after_assets_precompile:
    - exec:
        cd: $home
        cmd:
          - sudo -E -u discourse bundle exec rake s3:upload_assets
          - sudo -E -u discourse bundle exec rake s3:expire_missing_assets

オブジェクトストレージを使用する場合は、バケットに保存されたコンテンツを提供するための CDN も必要です。テストでは StackPath CDN を使用しましたが、設定で Dynamic Caching By Header: Accept-Encoding を設定する必要がある以外は問題なく動作します。

DISCOURSE_CDN_URL は、Discourse のホスト名を指し、リクエストをキャッシュする CDN です。主に CSS やその他のテーマアセットなど、プル可能なアセットに使用されます。

DISCOURSE_S3_CDN_URL は、オブジェクトストレージバケットを指し、リクエストをキャッシュする CDN です。主に JS、画像、ユーザーアップロードなど、プッシュ可能なアセットに使用されます。

これらは異なる値に設定し、両方を管理者が設定することを推奨します。

CDN を使用しない場合（またはバケットの URL を CDN の URL として入力した場合）は、問題が発生する可能性が高く、サポートされていません。

以下の例では、https://falcoland-files-cdn.falco.dev はバケット内のファイルを提供するように設定された CDN です。バケット名は例では falcoland-files に設定されています。

これらの設定を app.yml の環境変数として設定することをお勧めします。CDCK のインフラストラクチャでもこの方法が採用されており、十分にテストされているためです。また、アセットのアップロードタスクはアセットのコンパイル後（リビルド時）に実行されます。最初からオブジェクトストレージと正しく連携する Discourse を起動したい場合は、サイトが起動する前にアセットがアップロードされるように環境変数を設定する必要があります。

以下のリストからプロバイダーを選択し、app.yml ファイルの env セクションにこれらの設定を追加して、値を適宜調整してください。

AWS S3

公式にサポートしており、内部でも使用しているサービスです。Cloudfront という CDN オファーもバケットファイルのフロントとして機能します。権限の正しい設定方法については、Set up file and image uploads to S3 を参照してください。

  DISCOURSE_USE_S3: true
  DISCOURSE_S3_REGION: us-west-1
  DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey
  DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey
  DISCOURSE_S3_CDN_URL: https://falcoland-files-cdn.falco.dev
  DISCOURSE_S3_BUCKET: falcoland-files
  DISCOURSE_S3_BACKUP_BUCKET: falcoland-files/backups
  DISCOURSE_BACKUP_LOCATION: s3

Digital Ocean Spaces

DO のオファーは良好で、すぐに動作します。「ファイルの一覧表示を制限する」を有効にしても問題ありません。唯一の問題は、CDN オファーがひどく壊れているため、ファイルには別の CDN を使用する必要があることです。また、CORS ルールをインストールする必要はありません。リビルドのたびに再インストールされてしまうためです。

設定例：

  DISCOURSE_USE_S3: true
  DISCOURSE_S3_REGION: whatever
  DISCOURSE_S3_ENDPOINT: https://nyc3.digitaloceanspaces.com
  DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey
  DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey
  DISCOURSE_S3_CDN_URL: https://falcoland-files-cdn.falco.dev
  DISCOURSE_S3_BUCKET: falcoland-files
  DISCOURSE_S3_BACKUP_BUCKET: falcoland-files/backups
  DISCOURSE_BACKUP_LOCATION: s3
  DISCOURSE_S3_INSTALL_CORS_RULE: false

Linode Object Storage

Linode では、HTTP_CONTINUE_TIMEOUT という追加の設定パラメータが必要です。

設定例：

  DISCOURSE_USE_S3: true
  DISCOURSE_S3_REGION: us-east-1
  DISCOURSE_S3_HTTP_CONTINUE_TIMEOUT: 0
  DISCOURSE_S3_ENDPOINT: https://us-east-1.linodeobjects.com
  DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey
  DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey
  DISCOURSE_S3_CDN_URL: https://falcoland-files-cdn.falco.dev
  DISCOURSE_S3_BUCKET: falcoland-files
  DISCOURSE_S3_BACKUP_BUCKET: falcoland-files/backup
  DISCOURSE_BACKUP_LOCATION: s3

Google Cloud Platform Storage

ファイルの一覧表示が壊れているため、アセットが機能するようにその機能をスキップする追加の ENV が必要です。また、CORS もスキップして手動で設定してください。

ファイルの一覧表示ができないため、バックアップの一覧表示もできず、自動バックアップは失敗します。そのため、バックアップには使用しないことを推奨します。ただし、ロールを「Storage Legacy Object Owner」から「Storage Legacy Bucket Owner」に変更すると、バックアップが正しく動作するという報告もあります。Google Cloud 固有の議論については、このトピックを参照してください。

統合を改善するサードパーティ製プラグインが Discourse GCS Helper にあります。

設定例：

  DISCOURSE_USE_S3: true
  DISCOURSE_S3_REGION: us-east1
  DISCOURSE_S3_INSTALL_CORS_RULE: false
  FORCE_S3_UPLOADS: 1
  DISCOURSE_S3_ENDPOINT: https://storage.googleapis.com
  DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey
  DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey
  DISCOURSE_S3_CDN_URL: https://falcoland-files-cdn.falco.dev
  DISCOURSE_S3_BUCKET: falcoland-files
  #DISCOURSE_S3_BACKUP_BUCKET: falcoland-files/backup
  #DISCOURSE_BACKUP_LOCATION: s3

Scaleway Object Storage

Scaleway のオファーも非常に優れており、ほとんどの場合問題なく動作します。

Scaleway のマルチパートアップロードは、最大 1,000 パーツしかサポートしていません。これは、最大 10,000 パーツをサポートする Amazon S3 とは異なります。大規模なインスタンスの場合、これにより Discourse のバックアップが失敗し、不完全なアップロードは、さらに試行する前に手動で削除する必要がある場合があります。小規模なインスタンスの場合は問題ありません。Scaleway はフィードバックに非常にオープンなため、この制限を変更したい場合は連絡してください。

DISCOURSE_S3_ENDPOINT パラメータについては、Discourse は地域全体のエンドポイントを使用します：https://s3.{region}.scw.cloud。Scaleway ダッシュボードに表示される「バケットエンドポイント」は https://{bucketName}.s3.{region}.scw.cloud という形式です。接続エラーを防ぐために、バケット名のサブドメインを省略してください。

設定例：

  DISCOURSE_USE_S3: true
  DISCOURSE_S3_REGION: fr-par
  DISCOURSE_S3_ENDPOINT: https://s3.fr-par.scw.cloud
  DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey
  DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey
  DISCOURSE_S3_CDN_URL: https://falcoland-files-cdn.falco.dev
  DISCOURSE_S3_BUCKET: falcoland-files
  DISCOURSE_S3_BACKUP_BUCKET: falcoland-files/backups
  DISCOURSE_BACKUP_LOCATION: s3

Vultr Object Storage

Vultr では、HTTP_CONTINUE_TIMEOUT という追加の設定パラメータが必要です。

設定例：

  DISCOURSE_USE_S3: true
  DISCOURSE_S3_REGION: whatever
  DISCOURSE_S3_HTTP_CONTINUE_TIMEOUT: 0
  DISCOURSE_S3_ENDPOINT: https://ewr1.vultrobjects.com
  DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey
  DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey
  DISCOURSE_S3_CDN_URL: https://falcoland-files-cdn.falco.dev
  DISCOURSE_S3_BUCKET: falcoland-files
  DISCOURSE_S3_BACKUP_BUCKET: falcoland-files/backup
  DISCOURSE_BACKUP_LOCATION: s3

Backblaze B2 Cloud Storage

CORS をスキップして手動で設定する必要があります。

BackBlaze では「孤児アップロードのクリーンアップ」が正しく機能しないという報告があります。孤児のクリーンアップを機能させるには、バケットのライフサイクルルールを変更する必要があります。

設定例：

  DISCOURSE_USE_S3: true
  DISCOURSE_S3_REGION: "us-west-002"
  DISCOURSE_S3_INSTALL_CORS_RULE: false
  DISCOURSE_S3_CONFIGURE_TOMBSTONE_POLICY: false
  DISCOURSE_S3_ENDPOINT: https://s3.us-west-002.backblazeb2.com
  DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey
  DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey
  DISCOURSE_S3_CDN_URL: https://falcoland-files-cdn.falco.dev
  DISCOURSE_S3_BUCKET: falcoland-files
  DISCOURSE_S3_BACKUP_BUCKET: falcoland-files/backup
  DISCOURSE_BACKUP_LOCATION: s3

注：B2 への初期移行中、1 日あたりの無料クラス C トランザクション制限 2500 に達する可能性があります。制限を解除するには、支払い方法を追加する必要があります。

MinIO Storage Server

MinIO ストレージサーバーを S3 の代替として使用するには、いくつかの注意点と要件を満たす必要があります。

完全に設定された MinIO サーバーインスタンスを持っていること
MinIO 設定でドメインサポートが有効になっていること（ドメイン駆動型のバケット URL のため）。これは MinIO と Discourse の必須セットアップ要件です。MinIO はまだ Discourse でサポートされなくなったレガシーな S3「パス」スタイルをサポートしているためです。
MinIO の DNS 設定が正しく行われており、バケットのサブドメインが MinIO サーバーに正しく解決され、MinIO サーバーが基本ドメイン（この場合は minio.example.com）で設定されていること
MinIO サーバーに discourse-data というバケットが存在し、「public」ポリシーが設定されていること
前述の通り、S3 CDN URL がバケットを指し、リクエストをキャッシュするように正しく設定された CDN を指していること
CDN が、データを取得する際にコア S3 URL の「Host」ヘッダー（例：discourse-data.minio.example.com）を実際に使用するよう設定されていること。そうしないと、CORB の問題が発生する可能性があります。

上記の注意点と前提条件が満たされていると仮定すると、設定例は以下のようになります。

  DISCOURSE_USE_S3: true
  DISCOURSE_S3_REGION: anything
  DISCOURSE_S3_ENDPOINT: https://minio.example.com
  DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey
  DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey
  DISCOURSE_S3_CDN_URL: https://discourse-data-cdn.example.com
  DISCOURSE_S3_BUCKET: discourse-data
  DISCOURSE_S3_BACKUP_BUCKET: discourse-backups
  DISCOURSE_BACKUP_LOCATION: s3
  DISCOURSE_S3_INSTALL_CORS_RULE: false

CORS は、アプリのリビルダーによってルールがインストールされていなくても MinIO で有効になっています。デフォルトでは、MinIO ではすべての HTTP 動詞で CORS が有効になっているようです。その結果、MinIO は BucketCORS（S3 API）をサポートしていません。

Azure Blob Storage with Flexify.IO

Azure Blob Storage は S3 互換サービスではないため、Discourse では使用できません。プラグインはありますが、壊れています。

Azure Blob Storage に S3 互換インターフェースを公開する最も簡単な方法は、Azure ストレージプロトコルを S3 に変換する Flexify.IO サーバーを追加することです。

執筆時点では、このサービスは Azure で無料で、非常に基本的（安価）な VM タIER で起動できます。ただし、セットアップには少し手間がかかります。

Azure ポータルで、Flexify.IO - Amazon S3 API for Azure Blob Storage という新しいリソースを作成します。
軽度の使用の場合は、最小 VM 設定で問題なく動作するようです。ほとんどのデフォルト設定を受け入れます。VM を作成する際に PEM キーファイルを保存することを忘れないでください。
Flexify.IO の VM リンクにアクセスしてシステムに入り、指示に従って Azure Blob Storage データプロバイダーと生成された S3 エンドポイントをセットアップします。エンドポイント設定 Public read access to all objects in virtual buckets が true になっていることを確認してください。S3 エンドポイント URL とキーをコピーします。
New Virtual Bucket を押し、仮想バケットを作成します。Azure Blob Storage コンテナと同じ名前でも、異なる名前でも構いません。この仮想バケットにマージするコンテナをリンクします。この仮想バケットは、S3 経由で公開読み取り可能なバケットを公開するために使用されます。
デフォルトでは、Flexify.IO は自己署名 SSL 証明書をインストールしますが、S3 エンドポイントには HTTPS が必要です。キーファイルを使用して VM に SSH で接続します（ユーザー名はデフォルトで azureuser です）。以下のファイルを正しいファイルに置き換えます。

/etc/flexify/ssl/cert.pem - 証明書ファイル（PEM エンコーディング）に置き換えます
/etc/flexify/ssl/key.pem - 秘密鍵ファイル（PKCS#8 PEM エンコーディング、BEGIN PRIVATE KEY で始まり BEGIN RSA PRIVATE KEY で始まる PKCS#1 ではないもの）に置き換えます

これらのファイルはルート権限が必要なため、置き換えるには sudo が必要です。置換ファイルが元のファイルと同じ所有者と権限（root:root および 600 権限）を持っていることを確認するのが最善です。
6. デフォルトでは、Flexify.IO は複数のバケットを持つルートレベルの S3 サービスを作成します。Discourse はバケットの サブドメイン サポートを必要とします。<your Flexify.IO VM IP>/flexify-io/manage/admin/engines/configs/1 にアクセスすると、非表示 の設定ページが開きます。
7. Endpoint hostname フィールドに S3 の基本ドメイン（例：s3.mydomain.com）を指定します。デフォルトでは空白になっています。Save を押して設定を保存します。
8. Azure ポータルで Flexify.IO VM を再起動します。
9. DNS で、s3.mydomain.com と *.s3.mydomain.com を Flexify.IO VM の IP にマップします。
10. Discourse の管理者ページで以下を設定します（設定を app.yml に含める必要はありません）。

use s3: true
s3 region: anything
s3 endpoint: https://s3.mydomain.com
s3 access key: myaccesskey
s3 secret assess key: mysecret key
s3 cdn url: https://<azure-blob-account>.blob.core.windows.net/<container>
s3 bucket: <virtual bucket>
s3 backup bucket: <backup bucket>  (公開読み取りアクセスが不要なため、どのコンテナでも構いません。Flexify.IO が自動的に公開します)
backup location: s3

本番環境とステージング環境で同じバケットを使用することは推奨されません。そうする場合は、ステージングサイトが本番環境のアセットを削除しないように対策を講じてください（最低でも s3 disable cleanup を設定し、本番環境のバックアップが削除されていないか注意してください）。

Wasabi

@pfaffman はバックアップに Wasabi を試しましたが、断続的かつ静かに失敗し、バックアップがハードドライブに残り、最終的にディスクがいっぱいになるように見えました。Wasabi も meta も手がかりがなく、推奨しませんが、状況によって異なる場合があります。 @pfaffman は現在、この問題がバックアップと自動再起動が何らかの理由で同時にスケジュールされていたことによるものだと確信しています。バックアップ専用でしたが、問題なく動作しているように見えました。誰かが試してここに報告してくれれば、少なくともバックアップについては動作するはずです。

Oracle Cloud

Oracle Cloud は、バケットへの仮想ホストスタイルアクセスをサポートしておらず lacks support for virtual-host style access to buckets、動作しません will not work

Cloudflare R2

Cloudflare R2 を設定するには、Cloudflare ダッシュボードの R2 オブジェクトストレージで関連設定を構成する必要があります。

要件（アップロード、バックアップ、またはその両方）に応じて、app.yml ファイルまたは「Admin - 全てのサイト設定」で S3 を検索して以下の設定を追加します。

  DISCOURSE_ENABLE_S3_UPLOADS: true
  DISCOURSE_S3_REGION: auto
  DISCOURSE_S3_ENDPOINT: https://<your-account-id>.r2.cloudflarestorage.com
  DISCOURSE_S3_ACCESS_KEY_ID: "xxx"
  DISCOURSE_S3_SECRET_ACCESS_KEY: "xxx"
  DISCOURSE_S3_UPLOAD_BUCKET: your-upload-bucket-name
  DISCOURSE_S3_CDN_URL: https://uploads.yourdomain.com
# DISCOURSE_S3_USE_CDN_URL_FOR_ALL_UPLOADS: true

  DISCOURSE_ENABLE_DIRECT_S3_UPLOADS: true
  DISCOURSE_S3_USE_ACLS: false
  
  DISCOURSE_BACKUP_LOCATION: s3
  DISCOURSE_S3_BACKUP_BUCKET: your-backup-bucket-name

app.yml を編集したくない場合は、管理 UI で以下のように設定できます。

「Admin → 全てのサイト設定」（S3 を検索）：

S3 アップロードを有効にする = true
直接 S3 アップロードを有効にする = true
S3 アクセスキー ID = "xxx"
S3 秘密アクセスキー = "xxx"
S3 リージョン = any
S3 アップロードバケット = your upload bucket name
S3 エンドポイント = https://<your-account-id>.r2.cloudflarestorage.com
S3 CDN URL = https://uploads.yourdomain.com
S3 ACL を使用する = false（これを無効にしてください！）
S3 バックアップバケット = your backup bucket name
バックアップ場所 = S3

注記：

API トークンの権限：Discourse には 1 組の認証情報フィールドしかないため、Cloudflare で生成する API トークンには、アップロードバケットとバックアップバケットの両方にアクセスする権限が必要です。トークンを作成する際は、「すべてのバケットに適用」を選択するか、「特定のバケットに適用」を選択して両方にチェックが入っていることを確認してください。また、API キーを作成する際に Object Read & Write にチェックを入れることを忘れないでください（デフォルトは Object Read only のみです）。
Cloudflare からエンドポイント URL をコピーする際、URL の末尾にバケット名が付加されることがあります。.yml ファイルに貼り付けた場合は、末尾のバケット名を削除してください。
R2 アップロードバケットを PDF や ZIP ファイルを含むすべてのアップロードに使用したい場合は、# DISCOURSE_S3_USE_CDN_URL_FOR_ALL_UPLOADS: true のコメントアウトを外してください。（これにより、アップロードされたすべてのファイルが直接リンクを介して公開可能になります）
DISCOURSE_ENABLE_DIRECT_S3_UPLOADS（true）を有効にする場合は、DISCOURSE_S3_USE_ACLS（false）を無効にしてください。Cloudflare R2 はバケットレベルの権限を使用するため、アップロードバケットは公開、バックアップバケットは非公開にする必要があります。Cloudflare R2 アップロードの場合、CORS ルールの rake タスクを設定したり、IAM json を記述したりする必要はありません。バケット権限を設定する際に Cloudflare ダッシュボードで設定するためです。Cloudflare の「Object Read & Write」トークンは自動的にマルチパートアップロードの権限を付与し、以下の CORS ルールを Cloudflare ダッシュボードの R2 アップロードバケット設定の CORS Policy に直接貼り付けることで、rake タスクの必要性がなくなります。

[
  {
    "AllowedOrigins": [
      "https://forum.yourdomain.com"
    ],
    "AllowedMethods": [
      "GET",
      "PUT",
      "POST",
      "DELETE",
      "HEAD"
    ],
    "AllowedHeaders": [
      "*"
    ],
    "ExposeHeaders": [
      "ETag"
    ],
    "MaxAgeSeconds": 3000
  }
]

Contabo

@tuxed は Contabo オブジェクトストレージを S3 互換アップロードで動作させようと試みました。アップロード時に URL にリポジトリ名がプレフィックスとして付加され、動作させることができなかったようです。

セキュアアップロード

セキュアアップロードは AWS S3 のみでサポートされています。rake uploads:migrate_to_s3 が失敗した場合、これらがセキュアである必要がないことが分かっている場合、これらのコマンドを入力してまずカウントし、その後セキュアではないとしてマークしてください。その場合、AWS S3 を使用する必要があります。

./launcher enter app
rails c
Upload.where(secure: true).count
Upload.where(secure: true).update_all(secure:false)

Oracle Cloud は、バケットへの仮想ホストスタイルアクセスをサポートしておらず lacks support for virtual-host style access to buckets、動作しません will not work ↩︎

トピック		返信	表示
Issues with AWS CDN and S3 Self-hosting cdn , s3	23	433	2026 年 1 月 29 日
Set up file and image uploads to S3 Self-Hosting configuring , how-to	35	120269	2025 年 10 月 25 日
Cloudflare R2: Navigating Setup and Handling Configuration Errors Self-hosting s3	55	2210	2025 年 10 月 30 日
Set up BackBlaze S3 with BunnyCDN Sysadmins how-to	34	6749	2025 年 4 月 17 日
Unable to setup S3 bucket Self-hosting uploads , s3	11	344	2025 年 1 月 12 日

アップロード用のS3互換オブジェクトストレージプロバイダーの設定

設定

AWS S3

Digital Ocean Spaces

Linode Object Storage

Google Cloud Platform Storage

Scaleway Object Storage

Vultr Object Storage

Backblaze B2 Cloud Storage

MinIO Storage Server

Azure Blob Storage with Flexify.IO

Wasabi

Oracle Cloud

Cloudflare R2

注記：

Contabo

セキュアアップロード

関連トピック