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-meta oss://your-bucket/your-object.pdf Content-Disposition:inline

シナリオ 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-meta oss://your-bucket/your-object.jpg Content-Type:image/jpeg

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

Alibaba Cloud Content Delivery Network (CDN) を使用して OSS へのアクセスを高速化している場合、Content-Type や Content-Disposition などのファイルメタデータへの変更がすぐに反映されないことがあります。これは、CDN の POP (Point 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 のデフォルトドメイン名

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