Cuando un recurso del servidor de origen cambia de ubicación, los puntos de presencia (POP) de Dynamic Content Delivery Network (DCDN) reescriben las URL de solicitud obsoletas y las redirigen a la nueva ruta. Esto reduce las solicitudes de retorno al origen y mejora el rendimiento de acceso.
Nota: Cuando esta función hace referencia a condiciones de regla del Rules Engine, el orden de ejecución sigue la prioridad de las condiciones configuradas en dicho motor, no la prioridad de la configuración propia de esta función.
Contexto
El código de estado HTTP 302 (Found) indica que el recurso solicitado se reubicó temporalmente. Al configurar una regla de reescritura de URI, los POP de DCDN agregan el nuevo URI al encabezado Location de la respuesta HTTP 302. Después, el cliente envía una nueva solicitud al URI actualizado.
Además del código de estado predeterminado 302, los POP también admiten los códigos 303 y 307. Si desea cambiar el código de estado de redirección, envíe un ticket.
|
Código de estado HTTP |
Descripción |
Método de manejo |
Escenario |
|
302 |
Found |
Las solicitudes GET permanecen sin cambios. Las solicitudes con otros métodos pueden convertirse en solicitudes GET. |
Una página web es inaccesible temporalmente por motivos desconocidos. Los motores de búsqueda no actualizan la URL de la página. |
|
303 |
See Other |
Las solicitudes GET permanecen sin cambios. Las solicitudes con otros métodos se convierten en solicitudes GET. Se descarta el cuerpo del mensaje. |
Este código se usa para redirigir solicitudes PUT y POST, con el fin de evitar redirecciones repetidas causadas por actualizaciones de página. |
|
307 |
Temporary Redirect |
Tanto el método de solicitud como el cuerpo del mensaje permanecen sin cambios. |
Una página web es inaccesible temporalmente por motivos desconocidos. Los motores de búsqueda no actualizan la URL de la página. Si el sitio web admite métodos de solicitud distintos de GET, se devuelve el código 307 en lugar del 302. |
Puede crear hasta 50 reglas de reescritura para un nombre de dominio. Si configura varias reglas, estas se aplican en orden descendente según aparecen en la consola de DCDN.
Escenarios
Si un recurso del servidor de origen se mueve a otro directorio, la URL almacenada en caché en los POP se actualiza automáticamente. Cuando un cliente envía una solicitud a la URL original, DCDN la reescribe y la redirige a la nueva URL. Por ejemplo, un archivo de imagen se traslada del directorio /download/ al directorio /image/.
Procedimiento
Inicie sesión en la consola de DCDN.
En el panel de navegación izquierdo, haga clic en Domain Names.
En la página Domain Names, busque el nombre de dominio de destino y haga clic en Configure.
En el árbol de navegación izquierdo del nombre de dominio, haga clic en Caching.
Haga clic en la pestaña URL Rewrite.
-
Haga clic en Add y configure la regla de reescritura según sus necesidades de negocio.
Parámetro
Descripción
URI to Be Rewritten
La ruta debe comenzar con una barra diagonal (
/) y excluir el protocolo y el nombre de dominio.Se admiten expresiones regulares compatibles con Perl (PCRE). Ejemplo:
^/hello$.
Target URI
Si establece Flag en Break dentro de una regla de reescritura, la ruta debe comenzar con una barra diagonal (
/) y excluir el protocolo y el nombre de dominio.Si establece Flag en Redirect dentro de una regla de reescritura, la ruta puede incluir el protocolo y el nombre de dominio. Se admiten PCRE. Por ejemplo,
$1y$2sirven para hacer referencia a las cadenas capturadas entre paréntesis en la ruta que desea reescribir.
Flag
Valores válidos: Redirect y Break.
Redirect: si el URI de una solicitud coincide con una regla, el POP devuelve el código de estado 302 y redirige la solicitud al URI especificado en el encabezado Location. Los parámetros del URI original no se modifican. Una vez ejecutada la regla actual, la solicitud se compara con las demás reglas.
Break: si el URI de una solicitud coincide con una regla, el POP redirige la solicitud al URI de destino. Los parámetros del URI original no se modifican. Tras ejecutar la regla actual, se omiten las reglas restantes.
-
Haga clic en OK.
Después de crear la función de reescritura, puede usar Modify o Delete para gestionar la regla en la pestaña URL Rewrite.
Ejemplos de configuración
Ejemplo 1
Cuando un cliente solicita http://example.aliyundoc.com/hello, la ruta de la solicitud es /hello. El POP incluye la nueva URL http://example.aliyundoc.com/index.html en el encabezado Location de la respuesta 302 y la devuelve al cliente. Luego, el cliente envía una solicitud a http://example.aliyundoc.com/index.html.
Para esta regla, Path to Rewrite se establece en ^/hello$, Destination Path en /index.html y Execution Rule en redirect.
Durante una redirección 302, si el encabezado Location no incluye el protocolo ni el nombre de dominio, el cliente utiliza de forma predeterminada los valores de la solicitud original.
Ejemplo 2
Cuando un cliente solicita http://example.aliyundoc.com/hello, la ruta de solicitud /hello coincide con la expresión regular ^/hello$. El POP devuelve una respuesta 302 al cliente. La respuesta incluye la URL de destino https://test.aliyundoc.com/index.html en el encabezado Location. Al recibir la respuesta, el cliente envía una solicitud a https://test.aliyundoc.com/index.html.
Regla de configuración: establezca Path to Rewrite en ^/hello$, Destination Path en https://test.aliyundoc.com/index.html y Execution Rule en redirect.
Ejemplo 3
Cuando un cliente solicita http://www.example.com/cdn/url/http://image.example.com/image/cat.jpg, la ruta contiene /cdn/url/http://, lo cual coincide con la expresión regular ^/cdn/url/http://(.*). El POP devuelve una respuesta 302 al cliente. Esta respuesta incluye la URL de destino http://image.example.com/image/cat.jpg en el encabezado Location. Al recibir la respuesta, el cliente envía una solicitud a http://image.example.com/image/cat.jpg.
Para la regla de configuración, establezca Destination Path en http://$1 y Execution Rule en redirect.
Ejemplo 4
Cuando un cliente solicita http://example.aliyundoc.com/stories/index.html#/voice/318, la parte #/voice/318 de la URL es un identificador de fragmento del lado del cliente. El navegador no envía esta parte al servidor. La ruta real que recibe el POP es /stories/index.html. Por lo tanto, al configurar la regla de reescritura, establezca Path to Rewrite en ^/stories/index\.html$ para que coincida con la ruta anterior al símbolo #. Luego, defina Destination Path con la URL de destino y Execution Rule en Redirect.
Si necesita redirigir varias URL de origen con fragmentos # distintos hacia diferentes URL de destino, configure una regla de reescritura independiente para cada ruta de origen. Esto se debe a que un servidor no distingue URL según el contenido posterior al símbolo #.
Ejemplo 5
Configurar la página principal de un subdirectorio: devolver el archivo de página principal predeterminado cuando un cliente accede al nombre de un subdirectorio es un requisito común en sitios web. Mediante la reescritura de URL de acceso, puede implementar esta capacidad en DCDN sin modificar el servidor de origen. Por ejemplo, si el archivo de la página principal es https://www.example.com/cdn/index.html, una vez aplicada la configuración, cualquier solicitud del cliente a https://www.example.com/cdn o https://www.example.com/cdn/ devolverá dicho archivo.
Antes de configurar las reglas, compruebe que el archivo de la página principal del subdirectorio sea accesible en el servidor de origen. Por ejemplo, verifique que https://www.example.com/cdn/index.html se devuelva correctamente.
La ruta de solicitud del cliente puede terminar o no con una barra diagonal (/). Por ello, debe configurar las dos reglas siguientes para cubrir ambos casos:
Regla 1: establezca Path to Rewrite en
^/(.+)/$, Destination Path en/$1/index.htmly Execution Rule en Break.Regla 2: establezca Path to Rewrite en
^/([^.?#]+)$, Destination Path en/$1/index.htmly Execution Rule en Break.
Una vez aplicada la configuración, acceda directamente a un subdirectorio, como https://www.example.com/cdn. Si el archivo de la página principal del subdirectorio se devuelve correctamente, la configuración fue exitosa.