Expresiones Regulares Comunes en Nginx

Enrutamiento con Directivas location

Las directivas location en Nginx definen cómo el servidor debe manejar las solicitudes entrantes basándose en la URI. Se clasifican en tres tipos fundamentales.

Tipos de Coincidencia

• Coincidencia exacta (=): La URI debe coincidir exactamente con el patrón. location = /recurso {}
• Coincidencia de prefijo: Busca que la URI comience con el patrón. Es el método por defecto. location /prefijo/ {}
• Coincidencia regular (~ o ~\*): Utiliza expresiones regulares para la coincidencia. ~ distingue mayúsculas, ~\* no.

Operadores y Jerarquía de Prioridad

El motor de Nginx evalúa las directivas location en un orden de prioridad específico:

1. Coincidencia exacta (=): Tiene la prioridad más alta. Si se encuentra, se usa inmediatamente.
2. Coincidencia de prefijo con ^~: Si coincide, se detiene la búsqueda de expresiones regulares.
3. Expresiones regulares (~ y ~\*): Se evalúan en el orden en que aparecen en el archivo de configuración. La primera coincidencia gana.
4. Coincidencia de prefijo sin modificador: Se evalúan todas las coincidencias de prefijo. La más larga es seleccionada.

Ejemplos de Configuración Práctica

A continuación se presentan patrones comunes para la configuración de location en servidores web reales.

Regla para la Página Principal

location = / {
    proxy_pass http://backend_app_server/;
}

Regla para Contenido Estático

location ^~ /recursos/ {
    alias /ruta/absoluta/recursos/;
}

location ~* \.(ico|png|jpg|jpeg|gif|css|js|woff2?)$ {
    root /var/www/estatico/;
}

Regla General (Proxy a Aplicación)

location / {
    proxy_pass http://backend_app_server;
    include proxy_params;
}

Reescritura de URLs con rewrite

La directiva rewrite permite modificar la URI de la solicitud, redirigir a otra ubicación o responder con un código de estado específico. Sintaxis básica: rewrite <patrón_regex> <reemplazo> [marca];

Orden de Ejecución

1. Se ejecutan las directivas rewrite dentro del bloque server.
2. Se realiza la coincidencia de location.
3. Se ejecutan las directivas rewrite dentro del bloque location seleccionado.

Marcas (Flags) de Reescritura

• last: Detiene el procesamiento actual de directivas rewrite y busca un nuevo location con la URI resultante.
• break: Detiene el procesamiento de directivas rewrite en el bloque actual.
• redirect: Devuelve una redirección temporal (302).
• permanent: Devuelve una redirección permanente (301).

Ejemplos de Configuración con rewrite

Redirección por Nombre de Dominio

Redirigir todo el tráfico de un dominio obsoleto a uno nuevo, preservando la ruta.

server {
    listen 80;
    server_name antiguo.ejemplo.com;
    return 301 $scheme://nuevo.ejemplo.com$request_uri;
}

Redirección por Dirección IP

Mostrar una página de mantenimiento a todos los visitantes excepto a una IP de administración.

server {
    listen 80;
    server_name www.ejemplo.com;
    set $redireccion_mant true;

    if ($remote_addr = "203.0.113.10") {
        set $redireccion_mant false;
    }

    if ($redireccion_mant = true) {
        rewrite ^(.*)$ /mantenimiento.html break;
    }

    location /mantenimiento.html {
        root /var/www/html;
        internal;
    }

    location / {
        root /var/www/www.ejemplo.com;
    }
}

Redirección con Cambio de Dominio y Ruta

Redirigir solicitudes de un subdominio a una ruta específica en el dominio principal.

server {
    listen 80;
    server_name foro.ejemplo.com;

    location /discusion {
        rewrite ^/discusion(.*)$ http://www.ejemplo.com/comunidad$1 permanent;
    }

    location / {
        return 404;
    }
}

Redirección Basada en Parámetros de Consulta

Redirigir solicitudes que coincidan con un patrón específico en los parámetros.

server {
    listen 80;
    server_name api.ejemplo.com;

    if ($args ~ "version=1&accion=obtener") {
        rewrite ^/$ http://api.ejemplo.com/v2/obtener? permanent;
    }

    location / {
        proxy_pass http://api_backend;
    }
}

Redirección para Extensiones de Archivo Específicas

Rediriigr solicitudes de archivos PHP en un directorio determinado a la página principal.

server {
    listen 80;
    server_name www.ejemplo.com;

    location ~* /scripts/.*\.php$ {
        rewrite ^(.*)$ / permanent;
    }

    location / {
        root /var/www/www.ejemplo.com;
        index index.html;
    }
}

Redirección para una URL Específica

Redirigir una URL concreta a la página principal del sitio.

server {
    listen 80;
    server_name www.ejemplo.com;

    location = /recursos/legado/pagina-especial.html {
        rewrite ^(.*)$ / permanent;
    }

    location / {
        root /var/www/www.ejemplo.com;
    }
}