Object Storage Service:OSS でのオブジェクトプレビュー動作の設定

シナリオ 1：セキュリティポリシーによる強制ダウンロード

このシナリオは、レスポンスヘッダーに x-oss-force-download: true が含まれる場合に適用されます。

• 原因：HTML などの特定の種類のファイルがブラウザで直接実行されることによる潜在的なセキュリティリスクを防ぐため、OSS は x-oss-force-download: true および Content-Disposition: attachment レスポンスヘッダーを追加してファイルのダウンロードを強制します。この動作は、OSS のデフォルトドメイン名または転送アクセラレーションドメイン名を使用して、特定の時点以降に作成されたバケットにアクセスする際に、一部のリージョンの一部のファイルタイプに適用されます。

  ポリシーの詳細については、「付録：OSS の強制ダウンロードルール」をご参照ください。

• 解決策：カスタムドメイン名を使用して OSS リソースにアクセスする。

• 手順：

  1. バケットにカスタムドメイン名をバインドする：OSS コンソールにログインします。対象バケットの [ドメイン名] ページで、有効な ICP 登録があるカスタムドメイン名をバケットにバインドします。

  2. CNAME レコードを設定する：Alibaba Cloud DNS などの DNS プロバイダーに移動し、カスタムドメイン名を OSS が提供する CNAME アドレスにマッピングする CNAME レコードを追加します。

  3. 新しいドメイン名を使用してオブジェクトにアクセスする：設定が完了したら、カスタムドメイン名の URL を使用してオブジェクトにアクセスします。これにより、オブジェクトはブラウザでプレビューされます。

シナリオ 2：オブジェクトメタデータによる強制ダウンロード

このシナリオは、レスポンスヘッダーに Content-Disposition: attachment が含まれるが、x-oss-force-download フィールドが含まれない場合に適用されます。

• 原因：オブジェクトのメタデータ内の Content-Disposition フィールドが明示的に attachment に設定されています。この設定は、ブラウザに対してオブジェクトをインラインで表示するのではなく、添付ファイルとしてダウンロードするように指示します。この設定は、一時的なダウンロードリンクを生成するためによく使用されます。削除されない場合、後続のすべてのアクセス試行でダウンロードがトリガーされます。

• 解決策：オブジェクトの Content-Disposition メタデータを inline に変更する。

  • コンソールでの変更

    1. OSS コンソールにログインし、対象バケットの [オブジェクト] > [オブジェクト一覧] ページに移動します。

    2. 対象のオブジェクトを見つけます。[操作] 列で、┇ > [オブジェクトメタデータの設定] を選択します。

    3. 表示されたダイアログボックスで、Content-Disposition フィールドを見つけ、その値を inline に変更します。

    4. [OK] をクリックして設定を保存します。

  • ossutil を使用した一括更新

    # 指定されたオブジェクトの Content-Disposition を inline に設定します。
    ossutil set-props oss://your-bucket/your-object.pdf --content-disposition inline --metadata-directive update

シナリオ 3：不正な Content-Type によるプレビューの失敗

このシナリオでは、HTTP レスポンスヘッダーは正常ですが、ブラウザは依然としてオブジェクトをダウンロードします。

• 原因：オブジェクトのメタデータ内の Content-Type (MIME タイプとも呼ばれる) が正しくないか、欠落しています。たとえば、JPG イメージの Content-Type が application/octet-stream の場合、ブラウザはコンテンツタイプを認識できないため、オブジェクトをダウンロードします。

• 解決策：オブジェクトに正しい Content-Type を設定する。

  • コンソールでの変更

    1. OSS コンソールにログインし、対象バケットの [オブジェクト] > [オブジェクト一覧] ページに移動します。

    2. 対象のオブジェクトを見つけます。[操作] 列で、┇ > [オブジェクトメタデータの設定] を選択します。

    3. 表示されたダイアログボックスで、Content-Type フィールドを見つけ、その値を正しいものに変更します。

    4. [OK] をクリックして設定を保存します。

    一般的なオブジェクトタイプに対する正しい Content-Type 値の例：

    • イメージ：image/jpeg、image/png、image/gif、image/webp

    • ビデオ：video/mp4

    • PDF ドキュメント：application/pdf

    • HTML ファイル：text/html

    • プレーンテキスト：text/plain

  • ossutil を使用した一括更新

    # 指定されたオブジェクトの Content-Type を image/jpeg に設定します。
    ossutil set-props oss://your-bucket/your-object.jpg --content-type image/jpeg --metadata-directive update

メタデータの変更が反映されない：CDN キャッシュの確認

Content Delivery Network (CDN) を使用して OSS へのアクセスを高速化している場合、Content-Type や Content-Disposition などのオブジェクトメタデータへの変更がすぐに反映されないことがあります。これは、CDN ノードが古いヘッダーを持つキャッシュされたコンテンツを提供し続けているためです。

解決策：CDN コンソールにログインし、変更されたオブジェクトの URL をパージして CDN キャッシュをクリアします。詳細な手順については、「リソースのパージとプリフェッチ」をご参照ください。

オブジェクトの強制ダウンロード

オブジェクトをプレビューせずに強制的にダウンロードさせるには、次のいずれかの方法を使用します。

• 方法 1 (推奨)：OSS 側での設定。シナリオ 2で説明したように、オブジェクトの Content-Disposition メタデータを attachment に設定します。この方法は、個々のオブジェクトに永続的なダウンロード設定を適用するのに最適です。

• 方法 2: CDN 側の構成。CDN を使用する場合、[キャッシュ設定] で HTTP レスポンスヘッダーを構成することにより、CDN コンソールに Content-Disposition: attachment ヘッダーを追加できます。この方法では、OSS オリジン内のオブジェクトを変更する必要はなく、特定のパスまたはファイルタイプに対してバッチおよび柔軟なルール構成が可能です。

ブラウザプレビューでサポートされていないフォーマット

主要なブラウザは、.psd、.ai、.sketch などの一部の特殊なオブジェクトフォーマットのプレビューをネイティブにサポートしていません。これらの場合、OSS と CDN の設定が正しくても、ブラウザはオブジェクトをダウンロードします。

解決策：特定のオブジェクトフォーマットのプレビューをサポートするブラウザ拡張機能またはプラグインをインストールします。あるいは、WebOffice オンラインプレビューなどの専門的なドキュメントプレビューサービスを使用することもできます。

OSS のデフォルトドメイン名

転送アクセラレーションドメイン名