ウェブサイト
カスタムエラーページ
A custom error page replaces the plain server default with your own branded HTML, while keeping the true error status so search engines still see a real 404. This guide covers adding a page for each…
カスタムエラーページは、プレーンなサーバーデフォルトをあなた自身のブランド化されたHTMLに置き換える一方で、真のエラーステータスを保持するため、検索エンジンは依然として実際の404を認識します。このガイドでは、サポートされている各コードのページを追加する方法、安全性のためにストリップされる内容、および検証バッジがどのように機能するかについて説明します。
KPanel内でのエラーページの場所
- KPanel にサインインします。
- 左サイドバーで Websites をクリックしてから、サイトをクリックします。
- サイトのタブストリップで Advanced を開いてから、Error pages を開きます。
直接アドレスは /websites/<site-id>/error-pages です。

必要な理由
デフォルトのサーバーエラーページは、行き止まりです。ブランディングがなく、ナビゲーションもなく、説明もないため、そのようなページに到達した訪問者は通常、去ってしまいます。
カスタムページはそれをサイトへの戻るルートに変えます。あなたのロゴ、あなたのタイポグラフィ、あなた自身の声による1文、およびホームへのリンクまたは検索ボックスへのリンク。大規模なサイトでは、タイプミスと古いURLは継続的なトラフィックの流れであり、404ページはあなたが構築することができる最も安価なリカバリーです。
サポートされているコード
8つのコードのカスタムページを設定できます。コードごとに1つのページです:
| コード | 意味 | 典型的な原因 |
|---|---|---|
| 400 | Bad Request | 不正な形式のリクエスト |
| 401 | Unauthorized | 認証が必須またはエラー |
| 403 | Forbidden | アクセスルールがリクエストをブロック |
| 404 | Not Found | そのURLに何も存在しない |
| 500 | Internal Server Error | アプリケーションが失敗 |
| 502 | Bad Gateway | アプリケーションが正しく応答しない |
| 503 | Service Unavailable | アプリケーションが停止またはオーバーロード |
| 504 | Gateway Timeout | アプリケーションが応答に時間がかかった |
404から始めます。これは圧倒的に最も一般的であり、また訪問者が障害ではなく通常のブラウジングを通じて到達する唯一のものです。
5xxファミリーは次にやる価値があります。これらはあなたの最悪の日に人々が見るページであるためです。何か問題が発生したと述べメールアドレスを提供するカーム化されたブランド化されたページは、ブランク化されたサーバーエラーより遠かに優れています。
ページを追加する
- Add error page をクリックします。
- ドロップダウンからエラーコードを選択します。既に使用中のコードはリストされていません。
- HTML body フィールドのサンプルHTMLをあなた自身のものに置き換えます。
- Add error page をクリックします。
エディターは編集可能な404ドキュメントで開始されます。これは、迅速に何かきちんとしたものが必要な場合の合理的な出発点です。
HTMLを記述する
doctype から始まる完全なHTMLドキュメントを指定します。これはそのまま提供されるため、独立して成り立つ必要があります。
安全性のため、ページが保存される前にいくつかのHTMLがストリップされます:
<script>タグonclickなどのインラインイベントハンドラー- iframe
- リモートスタイルシート
何か削除されていた場合、保存後に警告がお知らせします。
リモートスタイルシートはストリップされるため、エラーページはサイトのメインCSSファイルを取得することはできません。インラインCSSまたはドキュメントheadの <style> ブロックでスタイルを設定します。これは意図的です。エラーページは、サイトの残りが破損している場合でもレンダリングする必要があり、失敗しているサーバーからアセットの取得に依存するページは、正確に間違ったタイミングでスタイルなしのテキストとしてレンダリングされます。
実践的なガイダンス:
- 小さく、自己完結させてください。 すべてをインラインにします。外部画像は避けます。ページリストはKB単位で各ページのサイズを表示します。
- 平易な言葉で何が起こったのかを述べてください。 "We could not find that page" は "404 Not Found" より優れています。
- 先へ進む方法を提供してください。 ホームへのリンク、メインセクションへのリンク、または検索ボックス。
- 5xxページには連絡先ルートを含めてください。 訪問者はサイトを使用してあなたに到達することはできないためです。
- リダイレクトに使用しないでください。 URLが移動している場合は、代わりに正しくリダイレクトします。Site Redirects を参照してください。
ステータスコードは保持されます
カスタムページは、200ではなく実際のエラーステータスで提供されます。404は クライアントまでずっと404のままです。
これは音よりも重要です。200として返されたブランド化されたページは、ソフト404です。検索エンジンはそれを実際のページとしてインデックスし、分析ではそれを成功したビューとしてカウントし、壊れたリンクはツールで明らかにされません。Kapsule が真のステータスを保持するため、これらすべてが引き続き正しく機能します。
ステータスバッジを読む
Status 列は、実際に検証されたものを報告し、制限について意図的に正直です。
| バッジ | 意味 |
|---|---|
| Verified: branded page served (true 404) | 外部から404を強制し、正しいステータスであなたのページを取得しました |
| Configured (not externally tested) | ページが適用されています。そのコードは外部からオンデマンドでトリガーできません |
| Not yet verified | チェックはまだ実行されていません |
| Applied, live test inconclusive | プローブはクリーンな404以外を取得しました。多くの場合、リダイレクトがそれをキャッチしたためです |
| Got a 404 but the branded page was not served | ルールが適用されていますが、ページが返されませんでした。再保存してください |
外部から強制できるのは404だけです。存在しないURLをリクエストすると確実に404が発生しますが、健全なサーバーに壊すことなく本当の500を発生させる方法はありません。そのため、他のコードは決して起こらない検証を主張するのではなく Configured を報告します。エラーが実際に発生した場合は依然として機能します。
サーバー上の別の構成が同じドメインを主張しているという警告が表示される場合もあります。それが解決されるまで、エラーページは適用されないかもしれません。それが表示されたかどうかはサポートに連絡してください。
実際にエラーをスローしているサイトのトラブルシューティング
より良いページが必要な場合ではなく、サイトがエラーをスロー しているためにここにいる場合、ページにはショートカットがあります。バナーの上部にある Troubleshoot with Kora ボタンです。
これはKPanel内のアシスタントであるKoraに、このサイトのエラーログと最近のエラーを読み、可能性のある原因と修正方法を伝えるよう要求します。これは生ログを読むより遠かに高速な最初の手順です。
基本的なパフォーマンスピクチャーについては、Site Performance and APM を参照し、時間経過に伴うエラー率については、Site Traffic Analytics を参照してください。
編集と削除
各行に編集ボタンがあり、コードが固定され HTMLが読み込まれた同じエディターを開き、削除ボタンがあります。
削除するには確認を求め、結果を説明します。そのコードに到達するリクエストはサーバーのデフォルトページにフォールバックします。
トラブルシューティング
ページが表示されません。 正しいコードをトリガーしていることを確認します。リダイレクトするパスは決して404に到達しません。キャッシュが関係ないようにプライベートウィンドウで、本当に存在しないURLでテストしてください。
ページは表示されていますがスタイルが設定されていないように見えます。 スタイルシートはリモートアセットとしてストリップされました。CSSをインラインにしてください。
トラッキングスクリプトがありません。 スクリプトは設計上ストリップされます。ここからカスタムエラーページでJavaScriptを実行する方法はありません。
すべてのコードには既にページがあります。 8つすべてが使用中です。別の追加ページを追加する代わりに、既存のページを編集します。
バッジは、ブランド化されたページが提供されなかったと言っています。 ページを再保存してください。それが続き、ドメイン競合警告が表示されない場合は、チケットを開いてください。
関連ページ
- Site Redirects は404が最初に発生するのを停止するため。
- Site Traffic Analytics は、実際にいくつの4xxおよび5xx応答を提供しているかを確認するため。
- Password-Protecting a Site は、これにより設計上401応答を生成します。