Rocky Linux 10: tutorial / Configurar un sitio Nginx con SELinux y firewalld

Para configurar un sitio Nginx en Rocky Linux 10, debe separar la configuración del sitio y los directorios de documentos, y verificar la configuración de Nginx, los permisos de archivos, el contexto de SELinux y el firewall en orden. En este tutorial, mantendremos el sitio predeterminado existente en el puerto 80 mientras agregamos un sitio estático en el puerto 18025, y compararemos las respuestas localmente y desde otras computadoras.

Ámbito de práctica y verificación de sitios existentes

Nginx es un servidor web que recibe solicitudes y entrega archivos o realiza proxy de solicitudes a otros programas. Aquí, solo manejamos sitios estáticos que sirven archivos directamente. Ejecutar PHP, proxy inverso y certificados HTTPS requiere configuración separada.

Realice el ejercicio en una máquina virtual (VM) separada de Rocky Linux 10 con un usuario que tenga privilegios de sudo y acceso a la consola preparado. El entorno de laboratorio original era Rocky Linux 10.2, Nginx 1.26.3-6.el10_2.7, SELinux Enforcing. En este entorno, Apache estaba detenido y no había un oyente de puerto web existente. Si hay servicios actualmente en funcionamiento, debe verificar los puertos y configuraciones antes de instalar y comenzar.

cat /etc/rocky-release
sudo ss -lntp
systemctl is-active nginx httpd
sudo firewall-cmd --get-active-zones
getenforce
sudo dnf install nginx policycoreutils-python-utils
rpm -q nginx
sudo nginx -t

Si algún servicio no fue instalado o se detuvo en is-active, el código de salida puede no ser 0. Lea los resultados de la verificación de estado para hacer un juicio. Si Apache ya está usando el puerto 80, entrará en conflicto con la configuración predeterminada de Nginx, por lo que no lo inicie tal como está.

En el paquete Rocky /etc/nginx/nginx.conf, include /etc/nginx/conf.d/*.conf; fue incluido dentro de la sección http. No asuma la estructura sites-available de Debian o Ubuntu; verifique la configuración real del paquete. sudo nginx -T muestra toda la configuración que se aplicará, pero no comparta ningún valor secreto externamente.

sudo bash <<'BASH'
set -eu
test ! -e /root/lf-course25-before
install -d -m 0700 /root/lf-course25-before
cp -a /etc/nginx /root/lf-course25-before/nginx
BASH
sudo nginx -t && sudo systemctl start nginx
curl -sS -o /tmp/lf25-default-before.html -w 'HTTP %{http_code}\n' http://127.0.0.1/

Si la primera verificación muestra que ya existe un directorio de respaldo, deténgase y verifique el estado del ejercicio anterior. El comando anterior se basa en un nuevo entorno de ejercicio con puertos vacíos. El sitio predeterminado en este entorno devolvió HTTP 200. En lugar de reemplazar completamente el archivo de configuración predeterminado, agregaremos un archivo separado.

Cree el directorio de documentos y la configuración del sitio

El nombre a usar en este ejercicio es course25.test, y el directorio de documentos es /srv/lf-web25. .test es un nombre de prueba, y escribir este nombre en server_name no crea un registro DNS que vincule el nombre de dominio con una dirección IP. Primero, pruebe especificando el nombre del sitio usando el encabezado Host de curl.

sudo bash <<'BASH'
set -eu
test ! -e /srv/lf-web25
test ! -e /etc/nginx/conf.d/lf-course25.conf
LISTENERS=$(ss -H -lnt 'sport = :18025')
test -z "$LISTENERS"
install -d -m 0755 /srv/lf-web25
printf 'LF25 nginx site works\n' > /srv/lf-web25/index.html
chmod 0644 /srv/lf-web25/index.html
cat > /etc/nginx/conf.d/lf-course25.conf <<'EOF' 
server {
    listen 18025;
    server_name course25.test;
    root /srv/lf-web25;
    index index.html;
    access_log /var/log/nginx/lf-course25-access.log;
    error_log /var/log/nginx/lf-course25-error.log;
    location / {
        try_files $uri $uri/ =404;
    }
}
EOF
BASH

Si existe una ruta, o el puerto 18025 está siendo usado por otro programa, no sobrescriba este ejemplo tal como está. El directorio 0755 concede permiso para recorrer la ruta y leer el listado del directorio, mientras que el archivo 0644 permite leer el contenido. No es necesario cambiar el propietario de los archivos estáticos que Nginx solo lee a la cuenta del servidor web ni abrirlos con 0777. Las rutas de nivel superior también deben tener permisos de recorrido.

Configuraciones Roles y puntos a verificar
listen 18025 Este es el puerto TCP que recibe las solicitudes. Dado que no se especificó una dirección IPv4, este ejercicio recibe solicitudes de interfaces externas también. El rango público externo está limitado por el firewall y la red de la VM.
server_name Esta es la condición para seleccionar el bloque de servidor que coincida con el nombre de las solicitudes que llegan a la misma dirección y puerto. No es una función de registro DNS ni de autenticación de acceso.
root y index Establece la ruta raíz de archivos y el documento predeterminado para solicitudes de directorio. Aquí, las solicitudes / se manejan como index.html.
try_files Encuentra el archivo o directorio correspondiente al URI de la solicitud y devuelve 404 si no se encuentra. $uri es una variable de Nginx, no una variable de shell, por lo que se almacena tal cual en un heredoc con comillas.
Registros específicos del sitio Separa los archivos de registro de acceso y error para evitar mezclar solicitudes de diferentes sitios.

La guía introductoria oficial de Nginx explica los bloques de configuración y cómo servir archivos estáticos. La documentación de la directiva try_files explica la búsqueda de archivos y la última acción de procesamiento.

Contextos de ruta y permisos de puerto de SELinux

Incluso si los permisos generales de los archivos son correctos, SELinux debe permitir el acceso. SELinux compara los contextos de seguridad adjuntos a los procesos y archivos con sus políticas. El proceso de Nginx en este entorno se ejecutó en el dominio httpd_t, y el nuevo documento /srv fue inicialmente var_t.

ls -Zd /srv/lf-web25 /srv/lf-web25/index.html
sudo semanage fcontext -l -C
sudo semanage port -l | grep http_port_t
sudo semanage fcontext -a -t httpd_sys_content_t '/srv/lf-web25(/.*)?'
sudo restorecon -Rv /srv/lf-web25
sudo semanage port -a -t http_port_t -p tcp 18025
sudo nginx -t && sudo systemctl reload nginx
sudo ss -lntp 'sport = :18025'

semanage fcontext registra reglas permanentes que se aplicarán a rutas, y restorecon aplica esas reglas a archivos reales. Simplemente registrar las reglas no cambia inmediatamente el contexto de los archivos existentes. httpd_sys_content_t se usa para documentos que se leerán en este sitio estático, distinguiéndolos de las rutas que requieren permisos de escritura para acciones como cargas. Para principios detallados, consulte la documentación de SELinux de Rocky Linux .

El puerto 18025 fue registrado recientemente porque no estaba incluido en los puertos HTTP permitidos al inicio de la práctica. Si el puerto ya está registrado para otro tipo, no lo cambie automáticamente a -m después de recibir un error. Primero, verifique los servicios existentes, luego elija un puerto disponible o revise el alcance de la política necesaria. La autorización de puertos de SELinux es independiente de permitir paquetes de red en firewalld.

En la comparación del laboratorio original, cuando solo se permitió primero el puerto y el documento era var_t, ocurrió un HTTP 403, y el registro de auditoría registró una denegación AVC (Access Vector Cache) donde httpd_t no pudo acceder al archivo var_t. Después de aplicar las reglas de ruta y restorecon, cambió a 200. SELinux no se apagó, ni se configuró todo el servicio en modo permisivo.

Comparación de la respuesta local con la respuesta de otro ordenador

curl -sS -H 'Host: course25.test' -w 'HTTP %{http_code}\n' http://127.0.0.1:18025/
curl -sS -o /dev/null -H 'Host: course25.test' -w 'HTTP %{http_code}\n' http://127.0.0.1:18025/missing

Para la primera solicitud, se esperan LF25 nginx site works y 200, y se espera que una ruta inexistente devuelva 404. No se limite a mirar el número 200; verifique también si es el contenido del sitio esperado. El éxito local es evidencia de que Nginx y el acceso al documento son posibles, pero no significa que la ruta de red externa haya tenido éxito.

Verifique la zona a la que pertenece la interfaz externa y permita únicamente los puertos de práctica para esa zona. El public a continuación es el valor comprobado en esta VM, así que cámbielo por el valor real en otros entornos. No modifique las reglas de permiso de SSH existentes.

sudo firewall-cmd --get-active-zones
sudo firewall-cmd --zone=public --add-port=18025/tcp
sudo firewall-cmd --zone=public --query-port=18025/tcp

En otra computadora en la misma red, realice la solicitud utilizando la dirección IPv4 real del servidor. La siguiente IP es un ejemplo, así que no la use tal cual. En Windows, puede usar curl.exe para distinguirlo de los alias de PowerShell.

curl --max-time 5 -sS -H 'Host: course25.test' http://192.0.2.10:18025/

El entorno NAT (Network Address Translation) de VirtualBox no permite el acceso directo a la dirección del invitado desde el host. Al agregar una regla práctica en la configuración de la VM: Red → Adaptador 1 → Avanzado → Reenvío de puertos con TCP, IP del host 127.0.0.1, Puerto del host 18025, y Puerto del invitado 18025, puede verificar http://127.0.0.1:18025/ desde el host. Si deja vacío el IP del host, el rango de exposición puede aumentar, por lo que se especifica para la práctica local. Aún se requiere el permiso del firewall del invitado.

En la práctica de origen, se realizaron solicitudes a la VM a través del reenvío NAT de localhost desde curl en Windows. Antes de permitir el firewall, se agotó el tiempo sin respuesta durante 4 segundos, y después de permitir el puerto de tiempo de ejecución, se confirmó el mismo contenido y 200. Esto no prueba el acceso público a Internet ni el éxito real de la consulta DNS.

sudo firewall-cmd --permanent --zone=public --add-port=18025/tcp
sudo firewall-cmd --permanent --zone=public --query-port=18025/tcp
sudo firewall-cmd --zone=public --query-port=18025/tcp

Ambas consultas deben ser yes para reflejar la configuración actual y la guardada. No es necesario recargar todo el firewall para agregar por separado la autorización actual y la autorización permanente. En esta etapa, no se realizó la prueba de persistencia del reinicio. La distinción entre las dos configuraciones también se explica en la documentación oficial de firewalld sobre apertura de puertos . La definición de servicio http de HTTP estándar generalmente significa el puerto 80, así que no lo confunda con esta autorización de puerto no estándar.

Diagnosticar distinguiendo entre errores 403, 404 y de configuración

Si la conexión es rechazada o caduca, primero verifique el listener, la dirección y la red de la VM, así como la zona real. Si llega una respuesta HTTP, verifique el sitio que manejó esa solicitud y los registros. No concluya que se trata de un problema de SELinux basándose únicamente en un 403.

sudo nginx -t
sudo systemctl status nginx --no-pager
sudo journalctl -u nginx -b -n 30 --no-pager
sudo tail -n 20 /var/log/nginx/lf-course25-access.log
sudo tail -n 20 /var/log/nginx/lf-course25-error.log
namei -l /srv/lf-web25/index.html
ls -Z /srv/lf-web25/index.html
sudo ausearch --input-logs -m AVC -c nginx -ts recent -i

En la práctica, incluso si se mantiene el contexto correcto de SELinux, cambiar el archivo a propietario root con permisos 0600 resultó en un 403, y revertirlo a 0644 devolvió un 200. El Permission denied en el registro de errores puede aparecer tanto por permisos regulares como por SELinux, por lo que se deben correlacionar los eventos AVC en el momento de la solicitud fallida con los permisos de la ruta. No determine una causa específica basándose únicamente en el hecho de que no hay registro. Un 404 para una ruta inexistente es el resultado previsto de este try_files.

Después de modificar la configuración, vincule la verificación satisfactoria y la aplicación como en sudo nginx -t && sudo systemctl reload nginx. En la práctica, cuando se añadió una directiva inexistente a un archivo, la verificación de configuración falló con el código de salida 1, pero el proceso existente de Nginx que aún no la había aplicado continuó devolviendo 200 con el mismo PID. Inmediatamente se revirtió el archivo incorrecto a su contenido original y se volvió a verificar. No juzgue la configuración almacenada como normal solo porque devuelva la respuesta anterior.

Además, para esta instancia 18025, solo había un bloque de servidor, por lo que incluso al solicitar a través de Host: another.test, el mismo sitio devolvía 200. Esto se debe a que si no hay un nombre coincidente, se puede seleccionar el servidor predeterminado para esa dirección y puerto. server_name no es un dispositivo de restricción de acceso, y si desea rechazar nombres desconocidos, necesita diseñar un servidor predeterminado separado y una política de respuesta explícita. Para obtener reglas detalladas sobre la selección de nombres, consulte el documento de Nginx sobre nombres de servidor.

Verifique el sitio existente y elimine la configuración del laboratorio

Después de configurar el nuevo sitio, también verifique el sitio predeterminado original del puerto 80. Al compararlo con la respuesta guardada inicialmente, el cuerpo debe ser el mismo para concluir que la página predeterminada estática actual no ha sido modificada. Dado que las respuestas dinámicas de los sitios en operación real pueden variar con el tiempo, las funciones principales, el estado y el contenido deben compararse por separado.

curl -sS -o /tmp/lf25-default-after.html -w 'HTTP %{http_code}\n' http://127.0.0.1/
cmp /tmp/lf25-default-before.html /tmp/lf25-default-after.html
sudo diff -u /root/lf-course25-before/nginx/nginx.conf /etc/nginx/nginx.conf

En las tres comparaciones registradas del laboratorio original, el sitio predeterminado devolvió 200 en todos los casos y los cuerpos de la respuesta eran los mismos. Se conservaron los archivos de configuración existentes, incluido nginx.conf. Si este servidor continuará en uso, mantenga únicamente los sitios necesarios, y cuando se requiera el inicio automático después del reinicio, seleccione sudo systemctl enable nginx y luego verifique el reinicio por separado.

Al quitar la práctica, primero mueva los archivos del sitio que agregó a una ubicación de respaldo, luego verifique y recargue. Los siguientes comandos se aplican únicamente a los archivos y reglas creados recientemente en este curso. No elimine ninguna regla de ruta o puerto existente que haya reutilizado.

sudo mv /etc/nginx/conf.d/lf-course25.conf /root/lf-course25-before/site.conf
sudo nginx -t && sudo systemctl reload nginx
sudo firewall-cmd --zone=public --remove-port=18025/tcp
sudo firewall-cmd --permanent --zone=public --remove-port=18025/tcp
sudo semanage fcontext -d '/srv/lf-web25(/.*)?'
sudo semanage port -d -p tcp 18025
sudo rm -- /srv/lf-web25/index.html
sudo rmdir /srv/lf-web25

Después de aplicar la configuración, verifique que el listener 18025 haya desaparecido y elimine las reglas de reenvío de puerto agregadas a la VM. Haga una copia de seguridad de los registros de la práctica si es necesario. En la VM de origen, se almacenaron nuevos registros y se limpiaron los archivos del sitio, documentos, políticas, reglas de firewall y NAT antes de detener Nginx. La configuración existente y el firewall se compararon con el estado original, mientras que SSH, el estado activo de firewalld y SELinux en modo Enforcing se mantuvieron. El paquete de Nginx se dejó para prácticas posteriores.