CentOS7でカスタムエラーページを使用するようにNginxを構成する方法

投稿日: 2019-11-08 2022-10-17
タグ: CentOS, nginx

序章

Nginxは、柔軟性とパワーを備えたコンテンツを提供できる高性能Webサーバーです。 Webページをデザインするときは、ユーザーに表示されるすべてのコンテンツをカスタマイズすると役立つことがよくあります。これには、利用できないコンテンツを要求した場合のエラーページが含まれます。このガイドでは、CentOS7でカスタムエラーページを使用するようにNginxを構成する方法を示します。

前提条件

このガイドを開始するには、root以外のユーザーが必要です。 sudo 特権。このタイプのユーザーをセットアップするには、CentOS7の初期セットアップガイドに従ってください。また、システムにNginxをインストールする必要があります。このガイドに従って、これを設定する方法を学びます。

カスタムエラーページの作成

デモンストレーション用にいくつかのカスタムエラーページを作成しますが、カスタムページは明らかに異なります。

カスタムエラーページを /usr/share/nginx/html CentOSのNginxがデフォルトのドキュメントルートを設定するディレクトリ。 404エラーのページを作成します custom_404.html 1つは一般的な500レベルのエラー用です。 custom_50x.html. テストするだけの場合は、次の行を使用できます。それ以外の場合は、次の場所に独自のコンテンツを配置します。

echo "<h1 style='color:red'>Error 404: Not found :-(</h1>" | sudo tee /usr/share/nginx/html/custom_404.html
echo "<p>I have no idea where that file is, sorry.  Are you sure you typed in the correct URL?</p>" | sudo tee -a /usr/share/nginx/html/custom_404.html
echo "<h1>Oops! Something went wrong...</h1>" | sudo tee /usr/share/nginx/html/custom_50x.html
echo "<p>We seem to be having some technical difficulties. Hang tight.</p>" | sudo tee -a /usr/share/nginx/html/custom_50x.html

これで、クライアントの要求によって異なるエラーが発生した場合に提供できる2つのカスタムエラーページができました。

エラーページを使用するようにNginxを構成する

ここで、正しいエラー状態が発生するたびにこれらのページを利用する必要があることをNginxに通知する必要があります。サーバーブロックを調整する必要があります。 CentOS 7では、プライマリサーバーブロックは /etc/nginx/nginx.conf ファイル。このサーバーブロックを構成しますが、構成した他のサーバーブロックを調整する必要があります。

sudo nano /etc/nginx/nginx.conf

ファイル内で、サーバーコンテキストを定義するブロックを見つけます。これで、Nginxでカスタムエラーページを指定できます。

404エラーをカスタム404ページに転送する

CentOS Nginx構成ファイルは、 error_page 指令。これを変更して、404エラーが発生したとき（要求されたファイルが見つからないとき）に、作成したカスタムページが提供されるようにする必要があります。ファイルに関連付けられたロケーションブロックを調整して、ルートがファイルシステムのロケーションと一致し、ファイルが内部Nginxリダイレクトを介してのみアクセス可能であることを確認できるようにします（クライアントから直接要求することはできません）。

/etc/nginx/nginx.conf

http {

    . . .

    server {

        . . .

        error_page 404 /custom_404.html;
        location = /custom_404.html {
            root /usr/share/nginx/html;
            internal;
        }

        . . .
    }
}

通常、設定する必要はありません root サーバーブロックのルートと一致するため、新しいロケーションブロックにあります。ただし、通常のWebコンテンツと関連するドキュメントルートを別の場所に移動してもエラーページが表示されるように、ここでは明示しています。

500レベルのエラーをカスタム50xページに送信

次に、ディレクティブを追加して、Nginxで500レベルのエラー（サーバー関連の問題）が発生したときに、作成した他のカスタムページを確実に提供できるようにします。これは、前のセクションで使用したのとまったく同じ式に従います。今回は、すべてが使用するように複数の500レベルのエラーを設定しました custom_50x.html ページ：

/etc/nginx/nginx.conf

http {

    . . .

    server {

        . . .

        error_page 404 /custom_404.html;
        location = /custom_404.html {
            root /usr/share/nginx/html;
            internal;
        }

        error_page  500 502 503 504 /custom_50x.html;
        location = /custom_50x.html {
            root /usr/share/nginx/html;
            internal;
        }

        location /testing {
            fastcgi_pass unix:/does/not/exist;
        }
    }
}

下部に、500レベルのエラーページをテストできるように、ダミーのFastCGIパスも追加しました。バックエンドが存在しないため、これは正しく機能しません。ここでページをリクエストすると、500レベルのエラーがカスタムページに役立つことをテストできます。

終了したら、ファイルを保存して閉じます。

Nginxを再起動してページをテストする

次のように入力して、構成ファイルの構文をテストします。

sudo nginx -t

エラーが報告された場合は、続行する前にエラーを修正してください。構文エラーが返されない場合は、次のように入力してNginxを再起動します。

sudo systemctl restart nginx

これで、サーバーのドメインまたはIPアドレスに移動して存在しないファイルを要求すると、次の404ページが表示されます。

http://server_domain_or_IP/thiswillerror

FastCGIパス用に設定した場所に移動すると、カスタム500レベルページで502BadGatewayエラーが発生します。

http://server_domain_or_IP/testing

これで、戻ってNginx構成から偽のFastCGIパスの場所を削除できます。

結論

これで、サイトのカスタムエラーページが表示されます。これは、ユーザーが問題を抱えている場合でも、ユーザーエクスペリエンスをパーソナライズする簡単な方法です。これらのページの1つの提案は、ヘルプや詳細情報を入手するために行くことができる場所へのリンクを含めることです。これを行う場合は、関連するエラーが発生している場合でも、リンク先にアクセスできることを確認してください。

getdocs

13036