すべてのプロダクト
Search

このプロダクト

    CDN:カスタムエラーページの設定

    ドキュメントセンター

    CDN:カスタムエラーページの設定

    最終更新日:Jun 23, 2026

    Alibaba Cloud CDN を設定することで、クライアントが存在しないコンテンツをリクエストした場合やエラーが発生した場合に、カスタムエラーページを返すことができます。デフォルトのエラーメッセージの代わりに、CDN のエッジノード (POP) が指定したページを提供し、ブランドイメージに沿った便利なユーザーエクスペリエンスを実現します。

    背景情報

    Alibaba Cloud CDN では、特定の HTTP ステータスコードが返されたときに、ユーザーをカスタムエラーページにリダイレクトできます。

    クライアントが存在しない Web サービスのリソースをリクエストすると、通常、オリジンサーバーはデフォルトの 404 エラーページを返します。より良いユーザーエクスペリエンスを提供するために、特定の HTTP または HTTPS 応答ステータスコードが返されたときにユーザーがリダイレクトされる URL を指定することで、カスタムエラーページを設定できます。

    説明

    カスタムエラーページが Alibaba Cloud CDN によって高速化されたリソースを使用する場合、標準のコンテンツ配信料金が適用されます。

    サポートされるステータスコード

    カスタムエラーページは、400、403、404、405、414、416、500、501、502、503、504 のステータスコードに対してのみ設定できます。

    ステータスコード

    説明

    400

    リクエストに構文エラーが含まれています。

    403

    サーバーはリクエストを理解しましたが、承認を拒否します。

    404

    サーバーは要求されたリソースを見つけることができませんでした。

    405

    サーバーはリクエストメソッドを認識しますが、ターゲットリソースではサポートしていません。

    414

    リクエスト URL が長すぎるため、サーバーは処理できません。

    416

    サーバーは要求された範囲を提供できません。

    500

    サーバーで予期しない条件が発生し、リクエストを完了できませんでした。

    501

    サーバーは、リクエストを完了するために必要な機能をサポートしていません。

    502

    サーバーがゲートウェイまたはプロキシとして機能している間に、アップストリームサーバーから無効な応答を受信しました。

    503

    サーバーは、メンテナンスや過負荷などが原因で、一時的にリクエストを処理できません。

    504

    サーバーがゲートウェイまたはプロキシとして機能している間に、アップストリームサーバーから時間内に応答を受信しませんでした。

    操作手順

    1. CDN コンソールにログインします。

    2. 左側のナビゲーションウィンドウで、ドメイン名 をクリックします。

    3. ドメイン名 ページで、対象のドメイン名を見つけ、操作 列の 管理 をクリックします。

    4. 対象ドメインのナビゲーションウィンドウで、キャッシュ設定 をクリックします。

    5. カスタムページ タブをクリックします。

    6. 追加 をクリックして、カスタムエラーページのステータスコードと URL を設定します。

      たとえば、[エラーコード] で 404 を選択します。[説明] は自動的に入力されます。[リダイレクトリンク] フィールドに、カスタムエラーページの URL (例: http://example.aliyundoc.com/error404.html) を入力し、[OK] をクリックします。

    7. OK をクリックして設定を保存します。

      カスタムエラーページの設定が正常に完了すると、カスタムページ リストにエントリが表示され、変更 または 削除 をクリックして管理できます。

    設定例

    404 エラーに対してカスタムページを表示するには、オリジンサーバーのルートディレクトリに error404.html という名前のページがあるとします。このページには、高速化ドメイン名 example.aliyundoc.com を介してアクセスできます。次の設定で、404 ステータスコードのカスタムエラーページを設定できます。

    • エラーコード： 404

    • リダイレクトリンク： カスタムページの URL。例： http://example.aliyundoc.com/error404.html

    • 結果： クライアントのリクエストが 404 エラーをトリガーすると、ユーザーは http://example.aliyundoc.com/error404.html にリダイレクトされます。

    よくある質問

    403 ページのリダイレクトループを回避する方法

    403 ステータスコードのカスタムエラーページを設定する際に、リダイレクト URL を指定するとリダイレクトループが発生する可能性があります。この問題を回避するには、次の方法を使用します。

    1. カスタムエラーページの設定でリダイレクト URL を設定する代わりに、CDN コンソールの アクセス URL の書き換え 機能を使用します。

    2. 書き換え元のパスを / に設定し、ターゲットパスを静的エラーページ (例: /error/403.html) に設定します。

    重要

    403 エラーページ自体が別の 403 リダイレクトをトリガーしないようにしてください。そうしないと、リダイレクトループが発生し、ユーザーはページにアクセスできなくなります。

    API リファレンス

    BatchSetCdnDomainConfig