# Pages d'erreur personnalisées

Source: https://support.kapsulehost.com/fr-fr/site-error-pages

Une page d'erreur personnalisée remplace la page par défaut du serveur par votre propre HTML à votre image, tout en conservant le véritable statut d'erreur afin que les moteurs de recherche voient toujours un vrai 404. Ce guide explique comment ajouter une page pour chaque code pris en charge, ce qui est retiré par sécurité, et comment fonctionne le badge de vérification.

## Où se trouvent les pages d'erreur dans KPanel

1. Connectez-vous à [KPanel](https://kpanel.kapsulehost.com).
2. Cliquez sur **Sites web** dans la barre latérale gauche, puis cliquez sur le site.
3. Dans le menu de gauche du site, ouvrez **Paramètres**, puis **Pages d'erreur**.

L'adresse directe est `/websites/<site-id>/error-pages`.

![Pages d'erreur personnalisées pour un site dans KPanel](https://support.kapsulehost.com/help/screenshots/site-error-pages.89c17e2d.webp)

## Pourquoi s'en soucier

Une page d'erreur par défaut du serveur est une impasse. Elle n'a ni identité visuelle, ni navigation, ni explication, si bien qu'un visiteur qui y atterrit repart en général aussitôt.

Une page personnalisée transforme cela en chemin de retour vers le site : votre logo, votre typographie, une phrase dans votre propre ton, et un lien vers l'accueil ou vers un champ de recherche. Sur un site volumineux, les URL mal saisies ou obsolètes représentent un flux constant de trafic, et une page 404 est le moyen de récupération le moins coûteux que vous puissiez mettre en place.

## Les codes pris en charge

Vous pouvez définir une page personnalisée pour huit codes, une page par code :

| Code | Signification | Cause typique |
|---|---|---|
| 400 | Mauvaise requête | Une requête mal formée |
| 401 | Non autorisé | Authentification requise ou échouée |
| 403 | Interdit | Une règle d'accès a bloqué la requête |
| 404 | Non trouvé | Rien n'existe à cette URL |
| 500 | Erreur interne du serveur | Votre application a échoué |
| 502 | Mauvaise passerelle | L'application n'a pas répondu correctement |
| 503 | Service indisponible | L'application est hors service ou surchargée |
| 504 | Délai d'expiration de la passerelle | L'application a mis trop de temps à répondre |

Commencez par le 404. C'est de loin le plus courant, et c'est le seul qu'un visiteur rencontre dans une navigation ordinaire plutôt qu'à la suite d'un dysfonctionnement.

La famille des 5xx mérite d'être traitée ensuite, car ce sont les pages que les gens voient lors de votre pire journée. Une page personnalisée et posée, qui indique qu'un problème est survenu et fournit une adresse e-mail, est bien préférable à une erreur serveur vierge.

## Ajouter une page

1. Cliquez sur **Ajouter une page d'erreur**.
2. Choisissez un code d'erreur dans la liste déroulante. Les codes déjà utilisés n'apparaissent pas.
3. Remplacez le HTML d'exemple dans le champ **Corps HTML** par le vôtre.
4. Cliquez sur **Ajouter une page d'erreur**.

L'éditeur démarre avec un document 404 fonctionnel que vous pouvez modifier à votre guise, ce qui constitue un bon point de départ si vous voulez simplement quelque chose de propre, rapidement.

## Rédiger le HTML

Fournissez un document HTML complet, en commençant par un doctype. Il est servi tel quel, il doit donc être autonome.

Certains éléments HTML sont retirés avant même l'enregistrement de la page, par sécurité :

- les balises `<script>`
- les gestionnaires d'événements en ligne tels que `onclick`
- les iframes
- les feuilles de style distantes

Si quelque chose a été retiré, un avertissement vous le signale après l'enregistrement.

> **Warning:** Les feuilles de style distantes étant retirées, une page d'erreur ne peut pas récupérer le fichier CSS principal de votre site. Mettez-la en forme avec du CSS en ligne ou un bloc `<style>` dans l'en-tête du document. C'est voulu : une page d'erreur doit pouvoir s'afficher même quand le reste du site est en panne, et une page qui dépend de la récupération de ressources depuis un serveur défaillant s'affichera comme du texte brut sans mise en forme, au pire moment possible.

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 Ko.
- **Dites simplement ce qui s'est passé.** « Nous n'avons pas trouvé cette page » vaut mieux que « 404 Not Found ».
- **Proposez une solution.** Un lien vers l'accueil, un lien vers vos rubriques principales, ou un champ de recherche.
- **Incluez un moyen 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 été déplacée, redirigez-la correctement à la place. Voir [Redirections de site](https://support.kapsulehost.com/fr-fr/site-redirects).

## Le code de statut est préservé

Votre page personnalisée est servie avec le véritable statut d'erreur, et non 200. Un 404 reste un 404 jusqu'au client.

Ceci est plus important qu'il n'y paraît. Une page personnalisée renvoyée avec un statut 200 est un « soft 404 » : les moteurs de recherche l'indexent comme une vraie page, vos statistiques la comptent comme une visite réussie, et les liens cassés ne sont jamais signalés par aucun outil. Comme KapsuleHost conserve le véritable statut, tout cela continue de fonctionner correctement.

## Lire le badge de statut

La colonne **Statut** indique ce qui a pu réellement être vérifié, et elle est délibérément honnête sur les limites de cette vérification.

| Badge | Signification |
|---|---|
| Vérifié : page personnalisée servie (vrai 404) | Nous avons forcé un 404 depuis l'extérieur et obtenu votre page avec le statut correct |
| Configuré (non testé de l'extérieur) | La page est appliquée. Ce code ne peut pas être déclenché à la demande depuis l'extérieur |
| Pas encore vérifié | La vérification n'a pas encore été exécutée |
| Appliqué, test en direct non concluant | La sonde a obtenu autre chose qu'un 404 net, souvent parce qu'une redirection l'a intercepté |
| 404 obtenu mais la page personnalisée n'a pas été servie | La règle est en place mais votre page n'est pas revenue. Essayez de l'enregistrer à nouveau |

Seul le 404 peut être forcé depuis l'extérieur. Demander une URL qui n'existe pas produit systématiquement un 404, mais il n'existe aucun moyen de faire produire à la demande un véritable 500 par un serveur sain sans le casser. Les autres codes affichent donc **Configuré** plutôt que de prétendre à une vérification qui n'a jamais eu lieu. Ils continuent néanmoins d'être servis lorsque l'erreur se produit réellement.

Il se peut également que vous voyiez 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 voyez ce message.

## Dépanner un site qui est réellement en erreur

Si vous consultez cette page parce que votre site génère des erreurs plutôt que parce que vous souhaitez de plus belles pages, celle-ci propose un raccourci : le bouton **Troubleshoot with Kora** dans la bannière en haut de page.

Il demande à Kora, l'assistant intégré à KPanel, de lire les journaux d'erreurs et les échecs récents de ce site, et d'indiquer la cause probable ainsi que la façon de la corriger. C'est une bien meilleure première étape que la lecture des journaux bruts.

Pour la vision globale des performances, voir [Performance du site et APM](https://support.kapsulehost.com/fr-fr/site-performance), et pour l'évolution du taux d'erreurs dans le temps, voir [Analyse du trafic du site](https://support.kapsulehost.com/fr-fr/site-analytics).

## Modifier et supprimer

Chaque ligne dispose d'un bouton de modification, qui ouvre le même éditeur avec le code figé et le HTML chargé, ainsi que d'un bouton de suppression.

La suppression demande une confirmation et explique le résultat : les requêtes touchant ce code reviendront à la page par défaut du serveur.

## Dépannage

**Ma page ne s'affiche pas.** Vérifiez que vous déclenchez le bon code. Un chemin qui redirige n'atteint jamais un 404. Testez avec une URL qui n'existe réellement pas, dans une fenêtre privée afin qu'aucun cache ne soit en cause.

**La page s'affiche mais semble sans mise en forme.** Votre feuille de style a été retirée en tant que ressource distante. Intégrez le CSS en ligne.

**Mon script de suivi est manquant.** Les scripts sont retirés volontairement. Il n'existe aucun moyen d'exécuter du JavaScript depuis une page d'erreur personnalisée ici.

**Tous les codes ont déjà une page.** Les huit sont déjà utilisés. Modifiez une page existante plutôt que d'en ajouter une nouvelle.

**Le badge indique que la page personnalisée n'a pas été servie.** Enregistrez à nouveau la page. Si le problème persiste, et qu'aucun avertissement de conflit de domaine n'est apparu, ouvrez un ticket.

## Pages associées

- [Redirections de site](https://support.kapsulehost.com/fr-fr/site-redirects) pour éviter que le 404 ne se produise dès le départ.
- [Analyse du trafic du site](https://support.kapsulehost.com/fr-fr/site-analytics) pour voir combien de réponses 4xx et 5xx vous servez réellement.
- [Protéger un site par mot de passe](https://support.kapsulehost.com/fr-fr/site-password-protect), qui produit des réponses 401 par conception.