Sites web
Pages d'erreur personnalisées
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…
Une page d'erreur personnalisée remplace le message par défaut du serveur par votre propre HTML de marque, tout en conservant le véritable statut d'erreur afin que les moteurs de recherche voient toujours un vrai 404. Ce guide couvre l'ajout d'une page pour chaque code supporté, ce qui est supprimé pour des raisons de sécurité, et comment fonctionne le badge de vérification.
Où se trouvent les pages d'erreur dans KPanel
- Connectez-vous à KPanel.
- Cliquez sur Websites dans la barre latérale gauche, puis cliquez sur le site.
- Dans l'onglet du site, ouvrez Advanced, puis Error pages.
L'adresse directe est /websites/<site-id>/error-pages.
Pourquoi s'en soucier
Une page d'erreur par défaut du serveur est une impasse. Elle n'a pas de marque, pas de navigation, pas d'explication, donc un visiteur qui en voit une part généralement.
Une page personnalisée transforme cela en un chemin de retour vers le site : votre logo, votre typographie, une phrase avec votre propre ton, et un lien vers la page d'accueil ou une boîte de recherche. Sur un grand site, les URL mal tapées et obsolètes représentent un flux constant de trafic, et une page 404 est la récupération la moins chère que vous construirez jamais.
Les codes supportés
Vous pouvez définir une page personnalisée pour huit codes, une page par code :
| Code | Signification | Cause typique |
|---|---|---|
| 400 | Bad Request | Une requête mal formée |
| 401 | Unauthorized | Authentification requise ou échouée |
| 403 | Forbidden | Une règle d'accès a bloqué la requête |
| 404 | Not Found | Rien n'existe à cette URL |
| 500 | Internal Server Error | Votre application a échoué |
| 502 | Bad Gateway | L'application n'a pas répondu correctement |
| 503 | Service Unavailable | L'application est arrêtée ou surchargée |
| 504 | Gateway Timeout | L'application a mis trop longtemps |
Commencez par 404. C'est de loin la plus courante, et c'est la seule qu'un visiteur atteint par une navigation ordinaire plutôt que par une faute.
La famille 5xx vaut la peine d'être faite ensuite, car ce sont les pages que les gens voient dans vos pires moments. Une page calme de marque qui indique que quelque chose s'est mal passé et donne une adresse e-mail est bien meilleure qu'une erreur serveur vierge.
Ajouter une page
- Cliquez sur Add error page.
- Choisissez un code d'erreur dans la liste déroulante. Les codes déjà utilisés ne sont pas répertoriés.
- Remplacez le HTML d'exemple dans le champ HTML body par le vôtre.
- Cliquez sur Add error page.
L'éditeur commence avec un document 404 fonctionnel que vous pouvez modifier, ce qui est un bon point de départ si vous voulez juste quelque chose de bien rangé rapidement.
Écrire le HTML
Fournissez un document HTML complet, en commençant par une déclaration doctype. Il est servi tel quel, donc il doit être autonome.
Certains HTML sont supprimés avant que la page ne soit jamais stockée, pour des raisons de sécurité :
- balises
<script> - gestionnaires d'événements en ligne tels que
onclick - iframes
- feuilles de style distantes
Si quelque chose a été supprimé, un avertissement vous le dit après la sauvegarde.
Parce que les feuilles de style distantes sont supprimées, une page d'erreur ne peut pas récupérer le fichier CSS principal de votre site. Stylisez-la avec du CSS en ligne ou un bloc <style> dans l'en-tête du document. C'est intentionnel : une page d'erreur doit s'afficher quand le reste du site est cassé, et une page qui dépend de la récupération de ressources depuis un serveur défaillant s'affichera sous forme de texte non stylisé au moment le plus inopportun.
Conseils pratiques :
- Gardez-la petite et autonome. Intégrez tout en ligne. Évitez les images externes. La liste des pages affiche la taille de chaque page en KB.
- Dites ce qui s'est passé en termes simples. « Nous n'avons pas pu trouver cette page » vaut mieux que « 404 Not Found ».
- Donnez une voie à suivre. Un lien vers la page d'accueil, un lien vers vos sections principales, ou une boîte de recherche.
- Incluez une voie de contact sur les pages 5xx, puisque le visiteur ne peut pas utiliser le site pour vous joindre.
- Ne l'utilisez pas pour rediriger. Si une URL a changé, redirigez-la correctement à la place. Consultez Site Redirects.
Le code de statut est préservé
Votre page personnalisée est servie avec le véritable statut d'erreur, pas 200. Un 404 reste un 404 jusqu'au client.
C'est plus important que cela ne le paraît. Une page de marque renvoyée comme 200 est un soft 404 : les moteurs de recherche l'indexent comme une véritable page, votre analyse le compte comme une vue réussie, et les liens brisés ne sont jamais signalés par aucun outil. Parce que Kapsule conserve le véritable statut, tout cela continue de fonctionner correctement.
Lire le badge de statut
La colonne Status indique ce qui a pu être réellement vérifié, et elle est délibérément honnête sur les limites.
| Badge | Signification |
|---|---|
| Verified: branded page served (true 404) | Nous avons forcé un 404 de l'extérieur et obtenu votre page avec le statut correct |
| Configured (not externally tested) | La page est appliquée. Ce code ne peut pas être déclenché de l'extérieur à la demande |
| Not yet verified | La vérification n'a pas encore été exécutée |
| Applied, live test inconclusive | La sonde a obtenu quelque chose d'autre qu'un 404 net, souvent parce qu'une redirection l'a interceptée |
| Got a 404 but the branded page was not served | La règle est en place mais votre page n'est pas revenue. Essayez de resauvegarder |
Seul 404 peut être forcé en externe. Demander une URL qui n'existe pas produit de manière fiable un 404, mais il n'existe aucun moyen de faire produire à un serveur sain un vrai 500 à la demande sans le casser. Donc les autres codes signalent Configured plutôt que de prétendre à une vérification qui ne s'est jamais produite. Ils servent quand même quand l'erreur se produit vraiment.
Vous pouvez également voir un avertissement indiquant qu'une autre configuration sur le serveur revendique le même domaine. Tant que cela n'est pas résolu, la page d'erreur peut ne pas s'appliquer. Contactez le support si vous le voyez.
Dépannage d'un site qui génère réellement des erreurs
Si vous êtes ici parce que votre site génère des erreurs plutôt que parce que vous voulez des pages plus élégantes, la page a un raccourci : le bouton Troubleshoot with Kora dans la bannière en haut.
Il demande à Kora, l'assistant à l'intérieur de KPanel, de lire vos journaux d'erreurs et les défaillances récentes pour ce site et de vous dire la cause probable et comment corriger. C'est une première étape beaucoup plus rapide que de lire les journaux bruts.
Pour l'image de performance sous-jacente, consultez Site Performance and APM, et pour le taux d'erreur au fil du temps, consultez Site Traffic Analytics.
Édition et suppression
Chaque ligne a un bouton d'édition, qui ouvre le même éditeur avec le code fixé et le HTML chargé, et un bouton de suppression.
La suppression demande une confirmation et explique le résultat : les demandes qui atteignent ce code reviennent à la page par défaut du serveur.
Dépannage
Ma page ne s'affiche pas. Confirmez que vous déclenchez le bon code. Un chemin qui redirige n'atteint jamais un 404. Testez avec une URL qui n'existe vraiment pas, dans une fenêtre privée pour que le cache ne soit pas impliqué.
La page s'affiche mais paraît non stylisée. Votre feuille de style a été supprimée en tant que ressource distante. Intégrez le CSS en ligne.
Mon script de suivi est manquant. Les scripts sont supprimés par conception. Il n'y a aucun moyen d'exécuter JavaScript à partir d'une page d'erreur personnalisée ici.
Tous les codes ont déjà une page. Les huit sont en utilisation. Modifiez plutôt une page existante au lieu d'en ajouter une autre.
Le badge dit que la page de marque n'a pas été servie. Resauvegardez la page. Si cela persiste et qu'aucun avertissement de conflit de domaine n'a apparemment, ouvrez un ticket.
Pages connexes
- Site Redirects pour éviter que le 404 se produise en premier lieu.
- Site Traffic Analytics pour voir combien de réponses 4xx et 5xx vous servez réellement.
- Password-Protecting a Site, qui produit des réponses 401 par conception.