Todos los productos
Search
Centro de documentos

CDN:Configure páginas de error personalizadas

Última actualización: Sep 02, 2026

Puede configurar Alibaba Cloud CDN para que devuelva una página de error personalizada cuando un cliente solicita contenido inexistente o se produce un error. En lugar de mostrar un mensaje de error predeterminado, el punto de presencia (POP) de la red CDN entrega la página que usted especifique, lo cual ofrece una experiencia de usuario útil y alineada con su marca.

Información de contexto

Alibaba Cloud CDN le permite redirigir a los usuarios a una página de error personalizada cuando se devuelve un código de estado HTTP específico.

Cuando un cliente solicita un recurso inexistente en su servicio web, el servidor de origen suele devolver una página de error 404 predeterminada. Para mejorar la experiencia del usuario, configure una página de error personalizada; para ello, especifique la URL a la que se redirige a los usuarios cuando se devuelve un código de estado de respuesta HTTP o HTTPS específico.

Nota

Si su página de error personalizada utiliza recursos acelerados por Alibaba Cloud CDN, se aplican los cargos estándar por entrega de contenido.

Códigos de estado compatibles

Solo puede configurar páginas de error personalizadas para los siguientes códigos de estado: 400, 403, 404, 405, 414, 416, 500, 501, 502, 503 y 504.

Código de estado

Descripción

400

La solicitud contiene un error de sintaxis.

403

El servidor entendió la solicitud, pero rechaza autorizarla.

404

El servidor no encontró el recurso solicitado.

405

El servidor reconoce el método de solicitud, pero no es compatible con el recurso de destino.

414

La URL de la solicitud es demasiado larga para que el servidor la procese.

416

El servidor no puede entregar el rango solicitado.

500

El servidor encontró una condición inesperada que le impidió completar la solicitud.

501

El servidor no admite la funcionalidad necesaria para completar la solicitud.

502

El servidor, al actuar como puerta de enlace o proxy, recibió una respuesta no válida de un servidor ascendente.

503

El servidor no puede procesar temporalmente la solicitud, a menudo debido a mantenimiento o sobrecarga.

504

El servidor, al actuar como puerta de enlace o proxy, no recibió una respuesta oportuna de un servidor ascendente.

Procedimiento

  1. Inicie sesión en la consola de CDN.

  2. En el panel de navegación izquierdo, haga clic en Domain Names.

  3. En la página Domain Names, busque el nombre de dominio de destino y haga clic en Manage en la columna Actions.

  4. En el panel de navegación del dominio, haga clic en Cache.

  5. Haga clic en la pestaña Custom Pages.

  6. Haga clic en Customize para configurar el código de estado y la URL de la página de error personalizada.

    Por ejemplo, seleccione 404 en Error Code. El campo Description se completa automáticamente. En el campo Redirect Link, introduzca la URL de su página de error personalizada, como http://example.aliyundoc.com/error404.html, y luego haga clic en OK.

  7. Haga clic en OK para guardar la configuración.

    Una vez configurada correctamente la página de error personalizada, encontrará la entrada en la lista Custom Pages y podrá hacer clic en Modify o Delete para gestionarla.

Ejemplo de configuración

Para mostrar una página personalizada ante errores 404, suponga que tiene una página llamada error404.html en el directorio raíz de su servidor de origen. Esta página es accesible mediante el nombre de dominio acelerado example.aliyundoc.com. Configure una página de error personalizada para el código de estado 404 con los siguientes ajustes.

  • Código de error: 404

  • Vínculo de redireccionamiento: La URL de su página personalizada. Por ejemplo: http://example.aliyundoc.com/error404.html.

  • Resultado: Cuando una solicitud de cliente desencadena un error 404, se redirige al usuario a http://example.aliyundoc.com/error404.html.

Referencia de API

Puede llamar a BatchSetCdnDomainConfig para configurar una página de error personalizada. Establezca functionName como error_page.