Centro de Conocimiento DevOps
Centro de Conocimiento DevOps

Hosts Virtuales de Nginx: Alojando Múltiples Sitios Web en un Servidor

Desbloquea el poder de los hosts virtuales (bloques de servidor) de Nginx para alojar eficientemente múltiples sitios web o subdominios en un solo servidor. Esta guía proporciona un tutorial completo paso a paso, que cubre la configuración de directorios, la creación de archivos de configuración, la habilitación de bloques de servidor y las pruebas de Nginx. Aprende las mejores prácticas para subdominios, bloques de servidor predeterminados, integración HTTPS y registro dedicado. Ejemplos prácticos y consejos esenciales de solución de problemas te ayudarán a dominar el alojamiento multi-sitio de Nginx, optimizando el uso de recursos y simplificando la gestión del servidor web.

41 vistas

Nginx Virtual Hosts: Alojar Múltiples Sitios Web en un Solo Servidor

La infraestructura web moderna a menudo requiere la capacidad de servir múltiples sitios web o aplicaciones web desde una única instancia de servidor. Esto no solo optimiza la utilización de recursos, sino que también simplifica la gestión y reduce los costos operativos. Nginx, conocido por su alto rendimiento, estabilidad, rico conjunto de características y bajo consumo de recursos, logra esto a través de lo que llama bloques de servidor, a menudo denominados hosts virtuales en el mundo de Apache.

Esta guía completa te llevará a través del proceso de configuración de hosts virtuales de Nginx para administrar y servir de manera efectiva múltiples nombres de dominio o subdominios distintos desde un solo servidor Nginx. Ya sea que estés alojando example.com y anothersite.org, o un sitio principal con subdominios como blog.example.com y shop.example.com, dominar los bloques de servidor de Nginx es una habilidad fundamental para cualquier administrador de sistemas o desarrollador. Al final de este artículo, tendrás una comprensión clara y ejemplos prácticos para configurar tu servidor Nginx para alojamiento de múltiples sitios.

Comprendiendo los Bloques de Servidor de Nginx (Hosts Virtuales)

En su núcleo, un bloque de servidor de Nginx es una directiva de configuración definida dentro del archivo de configuración de Nginx (nginx.conf o archivos incluidos). Cada bloque server define la configuración para un host virtual específico, dictando cómo Nginx debe responder a las solicitudes para un dominio o conjunto de dominios en particular. Nginx utiliza la directiva listen para especificar la dirección IP y el puerto en los que debe escuchar, y la directiva server_name para identificar a qué nombres de dominio o nombres de host debe responder este bloque de servidor.

Cuando llega una solicitud, Nginx examina la cabecera Host de la solicitud HTTP y la compara con las directivas server_name de sus bloques de servidor configurados. Luego, sirve el contenido definido en el bloque de servidor coincidente. Si no hay coincidencia con server_name, Nginx generalmente recurre al bloque de servidor predeterminado (el primer bloque server o uno explícitamente marcado como default_server).

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

  1. Nginx Instalado: Nginx debe estar instalado y funcionando en tu servidor. Si no es así, generalmente puedes instalarlo a través del gestor de paquetes de tu sistema (por ejemplo, sudo apt update && sudo apt install nginx en Ubuntu/Debian, sudo yum install nginx en CentOS/RHEL).
  2. Nombres de Dominio: Necesitas al menos dos nombres de dominio (por ejemplo, example1.com y example2.com) o subdominios (por ejemplo, blog.example.com y app.example.com) que desees alojar. Los registros DNS A/AAAA de estos dominios deben apuntar a la dirección IP pública de tu servidor.
  3. Estructura de Directorios Básica: Un plan para dónde residirán los archivos de tu sitio web. Una práctica común es /var/www/tudominio.com/html.
  4. Privilegios de Sudo: Necesitarás acceso sudo para modificar los archivos de configuración de Nginx.

Guía de Configuración Paso a Paso

Vamos a configurar dos hosts virtuales: example1.com y example2.com.

Paso 1: Crear la Estructura de Directorios para los Sitios Web

Primero, crea directorios raíz para cada uno de tus sitios web. Aquí es donde se almacenarán sus archivos HTML, CSS, JavaScript y otros archivos estáticos. Una ubicación común es /var/www/.

sudo mkdir -p /var/www/example1.com/html
sudo mkdir -p /var/www/example2.com/html

# Establecer la propiedad a tu usuario (reemplaza $USER con tu nombre de usuario) para permitir la edición
sudo chown -R $USER:$USER /var/www/example1.com/html
sudo chown -R $USER:$USER /var/www/example2.com/html

# Establecer permisos de lectura para el servidor web
sudo chmod -R 755 /var/www

A continuación, crea un archivo index.html simple en cada directorio para probar la configuración:

Para /var/www/example1.com/html/index.html:

<!-- /var/www/example1.com/html/index.html -->
<!DOCTYPE html>
<html>
<head>
    <title>¡Bienvenido a Example1.com!</title>
</head>
<body>
    <h1>¡Éxito! Esto es Example1.com.</h1>
    <p>Este host virtual está funcionando correctamente.</p>
</body>
</html>

Para /var/www/example2.com/html/index.html:

<!-- /var/www/example2.com/html/index.html -->
<!DOCTYPE html>
<html>
<head>
    <title>¡Bienvenido a Example2.com!</title>
</head>
<body>
    <h1>¡Éxito! Esto es Example2.com.</h1>
    <p>¡Este host virtual también está funcionando!</p>
</body>
</html>

Paso 2: Crear Archivos de Configuración de Bloques de Servidor de Nginx

Nginx generalmente carga las configuraciones de los bloques de servidor desde archivos en el directorio /etc/nginx/sites-enabled/. Estos archivos suelen ser enlaces simbólicos a configuraciones almacenadas en /etc/nginx/sites-available/. Esta separación te permite almacenar configuraciones que aún no están activas o habilitar/deshabilitar sitios fácilmente.

Crea un nuevo archivo de configuración para example1.com:

sudo nano /etc/nginx/sites-available/example1.com.conf

Agrega el siguiente contenido:

# /etc/nginx/sites-available/example1.com.conf
server {
    listen 80;
    listen [::]:80;

    root /var/www/example1.com/html;
    index index.html index.htm index.nginx-debian.html;

    server_name example1.com www.example1.com;

    location / {
        try_files $uri $uri/ =404;
    }

    access_log /var/log/nginx/example1.com_access.log;
    error_log /var/log/nginx/example1.com_error.log;
}

Explicación de las Directivas:

  • listen 80;: Nginx escucha en el puerto 80 (HTTP estándar). listen [::]:80; es para IPv6.
  • root /var/www/example1.com/html;: Especifica la raíz del documento para este bloque de servidor. Nginx buscará archivos dentro de este directorio.
  • index index.html ...;: Define el archivo predeterminado que Nginx debe servir cuando se solicita un directorio (por ejemplo, cuando alguien visita example1.com/).
  • server_name example1.com www.example1.com;: Esto es crucial. Le dice a Nginx que responda a las solicitudes de example1.com o www.example1.com utilizando la configuración de este bloque de servidor.
  • location / { ... }: Un bloque que define cómo manejar las solicitudes de URIs específicas. try_files intenta servir un archivo directamente ($uri), luego un directorio ($uri/), y finalmente devuelve un error 404 Not Found.
  • access_log y error_log: Especifica archivos de registro separados para este sitio específico, lo cual es una buena práctica para facilitar la depuración y el análisis.

Ahora, crea un archivo de configuración similar para example2.com:

sudo nano /etc/nginx/sites-available/example2.com.conf

Agrega el siguiente contenido:

# /etc/nginx/sites-available/example2.com.conf
server {
    listen 80;
    listen [::]:80;

    root /var/www/example2.com/html;
    index index.html index.htm index.nginx-debian.html;

    server_name example2.com www.example2.com;

    location / {
        try_files $uri $uri/ =404;
    }

    access_log /var/log/nginx/example2.com_access.log;
    error_log /var/log/nginx/example2.com_error.log;
}

Paso 3: Habilitar Bloques de Servidor

Para habilitar estas configuraciones, crea enlaces simbólicos desde el directorio sites-available al directorio sites-enabled. Esto le indica a Nginx que incluya estos archivos cuando se inicie.

sudo ln -s /etc/nginx/sites-available/example1.com.conf /etc/nginx/sites-enabled/
sudo ln -s /etc/nginx/sites-available/example2.com.conf /etc/nginx/sites-enabled/

Paso 4: Probar la Configuración de Nginx

Es crucial probar la configuración de Nginx en busca de errores de sintaxis antes de recargar. Esto evita que Nginx falle al reiniciarse debido a un error tipográfico.

sudo nginx -t

Deberías ver una salida similar a esta, indicando éxito:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Si ves algún error, corrígelos en los archivos de configuración correspondientes y vuelve a ejecutar sudo nginx -t hasta que pase.

Paso 5: Reiniciar Nginx

Aplica la nueva configuración reiniciando o recargando Nginx. reload generalmente se prefiere ya que permite a Nginx cargar nuevas configuraciones sin interrumpir las conexiones activas.

sudo systemctl reload nginx
# O, si reload no funciona o para instalaciones nuevas:
sudo systemctl restart nginx

Paso 6: Actualizar Registros DNS

Asegúrate de que los registros A de DNS para example1.com, www.example1.com, example2.com y www.example2.com apunten a la dirección IP de tu servidor Nginx. Sin entradas DNS correctas, tu navegador no sabrá dónde encontrar tus sitios web.

Una vez que la propagación DNS se complete (lo que puede llevar desde unos pocos minutos hasta varias horas), deberías poder visitar http://example1.com y http://example2.com en tu navegador web y ver las páginas index.html correspondientes.

Escenarios Avanzados y Mejores Prácticas

Alojar Subdominios

Alojar subdominios (por ejemplo, blog.example.com, shop.example.com) funciona exactamente igual que alojar dominios separados. Simplemente defines un nuevo bloque de servidor con el subdominio como server_name.

Ejemplo para blog.example.com:

# /etc/nginx/sites-available/blog.example.com.conf
server {
    listen 80;
    listen [::]:80;

    root /var/www/blog.example.com/html;
    index index.html;

    server_name blog.example.com;

    location / {
        try_files $uri $uri/ =404;
    }
}

Recuerda crear el directorio (/var/www/blog.example.com/html), crear un index.html, crear el enlace simbólico y recargar Nginx.

El Bloque de Servidor Predeterminado

Es una buena práctica tener un bloque de servidor predeterminado que capture las solicitudes de nombres de dominio que no coinciden con ninguna otra directiva server_name en tu servidor. Esto evita que las solicitudes desconocidas sean atendidas por el primer host virtual que Nginx encuentra, o te permite servir una página genérica de "sitio no encontrado".

Típicamente, el primer bloque server en tu nginx.conf o sites-enabled es implícitamente el predeterminado. Puedes establecer uno explícitamente usando default_server:

server {
    listen 80 default_server;
    listen [::]:80 default_server;

    server_name _;
    # El guion bajo `_` es un nombre de dominio inexistente que nunca coincidirá con una solicitud real.
    # También puedes usar localhost.

    root /var/www/default_site/html;
    index index.html;

    location / {
        return 444; # Devuelve un error 444 específico de Nginx (sin respuesta) para hosts desconocidos
        # O, sirve una página de destino genérica:
        # try_files $uri $uri/ =404;
    }
}

Advertencia: Si defines un bloque default_server, asegúrate de que solo un bloque server en un puerto listen dado tenga el indicador default_server, de lo contrario, Nginx registrará una advertencia.

Proteger Hosts Virtuales con HTTPS (SSL/TLS)

Para sitios web de producción, habilitar HTTPS es esencial. Esto implica obtener un certificado SSL/TLS (por ejemplo, a través de Let's Encrypt usando Certbot) y configurar Nginx para escuchar en el puerto 443 con el certificado.

Un bloque de servidor HTTPS típico se ve así (después de obtener los certificados):

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    server_name example1.com www.example1.com;

    root /var/www/example1.com/html;
    index index.html;

    ssl_certificate /etc/letsencrypt/live/example1.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example1.com/privkey.pem;

    # Incluir otras configuraciones SSL (ciphers, protocols, etc.)
    include /etc/nginx/snippets/ssl-params.conf;
    include /etc/nginx/snippets/force-ssl.conf; # Opcional: redirige HTTP a HTTPS

    location / {
        try_files $uri $uri/ =404;
    }
}

# Opcional: redirección de HTTP a HTTPS para este dominio
server {
    listen 80;
    listen [::]:80;
    server_name example1.com www.example1.com;
    return 301 https://$host$request_uri;
}

Es común tener un bloque de servidor HTTP separado cuyo único propósito es redirigir todo el tráfico a su contraparte HTTPS.

Registro para Cada Sitio

Como se muestra en los ejemplos, dedicar archivos access_log y error_log separados para cada host virtual es una mejor práctica. Esto facilita significativamente la depuración de problemas y el análisis del tráfico de sitios web individuales sin tener que revisar registros combinados.

Estructura de Archivos de Configuración

Para implementaciones más grandes, considera organizar tus archivos de configuración de Nginx de la siguiente manera:

  • nginx.conf: Configuración principal, incluye conf.d/*.conf y sites-enabled/*.
  • conf.d/: Configuraciones generales a nivel de servidor (por ejemplo, Gzip, caché).
  • snippets/: Fragmentos de configuración reutilizables de Nginx (por ejemplo, parámetros SSL, bloques location comunes).
  • sites-available/: Bloques server individuales para cada sitio web.
  • sites-enabled/: Enlaces simbólicos a configuraciones activas en sites-available/.

Solución de Problemas Comunes

  • Error 403 Forbidden: Esto generalmente significa que Nginx no tiene permisos de lectura para los archivos o directorios de tu sitio web. Verifica los permisos de archivos y directorios (por ejemplo, sudo chmod -R 755 /var/www/tudominio.com/html y asegúrate de que el usuario de Nginx, típicamente www-data o nginx, pueda leerlos).
  • Error 404 Not Found: Verifica que la directiva root en tu bloque de servidor apunte al directorio correcto y que tu archivo index.html exista en esa ubicación. Asegúrate también de que try_files esté configurado correctamente.
  • Se Carga el Sitio Incorrecto: Esto a menudo indica un problema con la directiva server_name. Asegúrate de que server_name coincida exactamente con el nombre de dominio al que intentas acceder (incluyendo www. o subdominios). También verifica tus registros DNS.
  • Nginx Falla al Iniciar/Recargar: Siempre usa sudo nginx -t para probar tu configuración antes de intentar recargar o reiniciar Nginx. Los mensajes de error señalarán la línea y el archivo donde ocurrió el error de sintaxis.
  • Problemas de DNS: Si puedes acceder a tu sitio por dirección IP pero no por nombre de dominio, es casi seguro un problema de DNS. Usa dig o nslookup para verificar que los registros A de tu dominio apunten a la IP del servidor correcta.

Conclusión

Los hosts virtuales de Nginx (bloques de servidor) proporcionan una forma potente y flexible de alojar múltiples sitios web en un solo servidor. Al configurar correctamente los bloques server con las directivas listen, server_name, root y location apropiadas, puedes administrar eficientemente diversas propiedades web. Este enfoque no solo conserva recursos, sino que también centraliza la administración del servidor.

Con el conocimiento fundamental y los pasos prácticos descritos en esta guía, ahora estás equipado para configurar y administrar múltiples dominios en tu servidor Nginx. Recuerda siempre probar tus configuraciones, proteger tus sitios con HTTPS y seguir las mejores prácticas para el registro y la estructura de directorios para un entorno web robusto y mantenible. A partir de aquí, puedes explorar más las capacidades de Nginx como proxy inverso, balanceo de carga y caché para mejorar el rendimiento y la confiabilidad de tu servidor web.