Una página de error personalizada reemplaza la página predeterminada del servidor con su propio HTML con marca, manteniendo el estado de error real para que los motores de búsqueda sigan viendo un 404 verdadero. Esta guía explica cómo añadir una página para cada código admitido, qué se elimina por seguridad y cómo funciona el distintivo de verificación.
Dónde Viven las Páginas de Error en KPanel
- Inicie sesión en KPanel.
- Haga clic en Sitios web en la barra lateral izquierda y luego haga clic en el sitio.
- En el menú izquierdo del sitio, abra Configuración y luego Páginas de error.
La dirección directa es /websites/<site-id>/error-pages.
Por Qué Vale la Pena
Una página de error predeterminada del servidor es un callejón sin salida. No tiene marca, ni navegación, ni explicación, así que un visitante que llega a una de ellas normalmente se marcha.
Una página personalizada convierte eso en un camino de regreso al sitio: su logotipo, su tipografía, una frase con su propio tono y un enlace al inicio o a un cuadro de búsqueda. En un sitio grande, las URL mal escritas u obsoletas son un goteo constante de tráfico, y una página 404 es la recuperación más barata que jamás construirá.
Los Códigos Admitidos
Puede configurar una página personalizada para ocho códigos, una página por código:
| Código | Significado | Causa típica |
|---|---|---|
| 400 | Solicitud incorrecta | Una solicitud mal formada |
| 401 | No autorizado | Autenticación requerida o fallida |
| 403 | Prohibido | Una regla de acceso bloqueó la solicitud |
| 404 | No encontrado | No existe nada en esa URL |
| 500 | Error interno del servidor | Su aplicación falló |
| 502 | Puerta de enlace incorrecta | La aplicación no respondió correctamente |
| 503 | Servicio no disponible | La aplicación está caída o sobrecargada |
| 504 | Tiempo de espera de la puerta de enlace | La aplicación tardó demasiado |
Comience por el 404. Es, con diferencia, el más común, y es el único al que un visitante llega mediante la navegación normal y no por un fallo.
Vale la pena continuar con la familia 5xx, porque son las páginas que la gente ve en su peor día. Una página personalizada y serena que indique que algo salió mal y proporcione una dirección de correo electrónico es mucho mejor que un error de servidor en blanco.
Añadir una Página
- Haga clic en Añadir página de error.
- Elija un código de error en el menú desplegable. Los códigos ya en uso no se muestran.
- Reemplace el HTML de ejemplo en el campo Cuerpo HTML por el suyo propio.
- Haga clic en Añadir página de error.
El editor comienza con un documento 404 funcional que puede editar y recortar, lo cual es un punto de partida razonable si solo quiere algo aseado rápidamente.
Redactar el HTML
Proporcione un documento HTML completo, comenzando con un doctype. Se sirve tal cual, así que debe funcionar por sí solo.
Parte del HTML se elimina antes de que la página se guarde siquiera, por seguridad:
- etiquetas
<script> - controladores de eventos en línea como
onclick - iframes
- hojas de estilo remotas
Si se eliminó algo, una advertencia se lo indicará después de guardar.
Dado que las hojas de estilo remotas se eliminan, una página de error no puede incorporar el archivo CSS principal de su sitio. Dele estilo con CSS en línea o con un bloque <style> en el encabezado del documento. Esto es deliberado: una página de error debe mostrarse cuando el resto del sitio está averiado, y una página que depende de obtener recursos de un servidor que está fallando se mostrará como texto sin estilo justo en el peor momento.
Orientación práctica:
- Manténgala pequeña y autónoma. Incorpore todo en línea. Evite las imágenes externas. La lista de páginas muestra el tamaño de cada página en KB.
- Diga lo que ocurrió con palabras sencillas. "No pudimos encontrar esa página" es mejor que "404 Not Found".
- Ofrezca una vía a seguir. Un enlace al inicio, un enlace a sus secciones principales o un cuadro de búsqueda.
- Incluya una vía de contacto en las páginas 5xx, ya que el visitante no puede usar el sitio para comunicarse con usted.
- No la use para redirigir. Si una URL se ha movido, redirija correctamente en su lugar. Consulte Redirecciones del sitio.
El Código de Estado se Conserva
Su página personalizada se sirve con el estado de error real, no con 200. Un 404 sigue siendo un 404 hasta llegar al cliente.
Esto importa más de lo que parece. Una página con marca devuelta como 200 es un 404 blando: los motores de búsqueda la indexan como una página real, sus analíticas la cuentan como una visita exitosa y ninguna herramienta marcará los enlaces rotos. Dado que KapsuleHost conserva el estado real, todo eso sigue funcionando correctamente.
Interpretar el Distintivo de Estado
La columna Status informa de lo que realmente se pudo verificar, y es deliberadamente honesta sobre las limitaciones.
| Distintivo | Significado |
|---|---|
| Verificado: página personalizada servida (404 verdadero) | Forzamos un 404 desde fuera y obtuvimos su página con el estado correcto |
| Configurado (no verificado externamente) | La página está aplicada. Ese código no se puede provocar desde fuera a voluntad |
| Aún no verificado | La comprobación aún no se ha ejecutado |
| Aplicado, prueba en vivo no concluyente | La prueba obtuvo algo distinto a un 404 limpio, a menudo porque una redirección lo interceptó |
| Se obtuvo un 404 pero no se sirvió la página personalizada | La regla está en vigor pero su página no apareció. Intente guardar de nuevo |
Solo el 404 se puede forzar externamente. Solicitar una URL que no existe produce de forma fiable un 404, pero no hay manera de hacer que un servidor sano produzca un 500 genuino a voluntad sin romperlo. Por eso los demás códigos indican Configurado en lugar de afirmar una verificación que nunca ocurrió. Aun así, se sirven cuando el error se produce de verdad.
También puede ver una advertencia de que otra configuración del servidor reclama el mismo dominio. Hasta que eso se resuelva, es posible que la página de error no se aplique. Póngase en contacto con soporte si la ve.
Solucionar Problemas en un Sitio que Realmente Está Dando Errores
Si está aquí porque su sitio está generando errores y no porque quiera páginas más bonitas, la página tiene un atajo: el botón Troubleshoot with Kora en el banner superior.
Este le pide a Kora, el asistente dentro de KPanel, que lea los registros de errores y los fallos recientes de este sitio y le indique la causa probable y cómo solucionarla. Es un primer paso mucho más rápido que leer registros en bruto.
Para la imagen de rendimiento subyacente, consulte Rendimiento del sitio y APM, y para la tasa de errores a lo largo del tiempo, consulte Analítica de tráfico del sitio.
Editar y Eliminar
Cada fila tiene un botón de edición, que abre el mismo editor con el código fijado y el HTML cargado, y un botón de eliminación.
Al eliminar se pide confirmación y se explica el resultado: las solicitudes que correspondan a ese código volverán a la página predeterminada del servidor.
Solución de Problemas
Mi página no se muestra. Confirme que está provocando el código correcto. Una ruta que redirige nunca llega a un 404. Pruebe con una URL que realmente no exista, en una ventana privada para que no intervenga ninguna caché.
La página se muestra pero parece no tener estilo. Su hoja de estilos se eliminó por ser un recurso remoto. Incorpore el CSS en línea.
Falta mi script de seguimiento. Los scripts se eliminan de forma intencionada. No hay manera de ejecutar JavaScript desde una página de error personalizada aquí.
Todos los códigos ya tienen una página. Los ocho están en uso. Edite una página existente en lugar de añadir otra.
El distintivo indica que la página personalizada no se sirvió. Guarde la página de nuevo. Si persiste, y no apareció ninguna advertencia de conflicto de dominio, abra un ticket.
Páginas Relacionadas
- Redirecciones del sitio para evitar que el 404 ocurra en primer lugar.
- Analítica de tráfico del sitio para ver cuántas respuestas 4xx y 5xx está sirviendo realmente.
- Proteger un sitio con contraseña, que genera respuestas 401 por diseño.