Object Storage Service:OSS オブジェクトのブラウザプレビュー動作の設定方法

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

このシナリオは、応答ヘッダーに x-oss-force-download: true が含まれる場合に発生します。

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

  ポリシーの詳細については、このトピックの最後にある「付録：OSS 強制ダウンロードルールのクイックリファレンス」をご参照ください。

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

• 手順：

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

  2. CNAME レコードを設定する：Alibaba Cloud 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 が不適切なため、ブラウザがオブジェクトをプレビューできない

このシナリオは、応答ヘッダーは正常であるにもかかわらず、ブラウザがオブジェクトをダウンロードする場合に発生します。

• 原因：オブジェクトの 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 キャッシュの確認

Alibaba Cloud Content Delivery Network (CDN) を使用して OSS へのアクセスを高速化している場合、Content-Type や Content-Disposition などのオブジェクトメタデータへの変更がすぐに反映されないことがあります。これは、CDN の POP (Points of Presence) が、古い設定のキャッシュされたバージョンを提供し続けている可能性があるためです。

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

オブジェクトをプレビューせずに強制的にダウンロードさせる方法

ユーザーがオブジェクトにアクセスした際に常に強制的にダウンロードさせたい場合は、以下のいずれかの方法を使用できます。

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

• 方法 2：CDN での設定。CDN を使用している場合は、CDN コンソールで Content-Disposition: attachment ヘッダーを追加できます。これは、[キャッシュ設定] で送信レスポンスヘッダーとして設定できます。この方法は OSS のソースオブジェクトを変更する必要がなく、特定のパスやファイルタイプに基づいた柔軟な一括設定に役立ちます。

ブラウザがプレビュー用のファイル形式をサポートしていない

主要なブラウザは、.psd、.ai、.sketch などの一部の専門的なファイル形式のオンラインプレビューをサポートしていません。この場合、OSS と CDN の設定が正しくても、ブラウザはファイルをダウンロードします。

解決策：ファイル形式のプレビューをサポートするブラウザプラグインをインストールするか、WebOffice オンラインプレビューなどの専門的なドキュメントプレビューサービスを使用できます。

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

アクセラレーションエンドポイント