SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor

Configuración de proxy inverso nginx, línea por línea

Configura nginx como proxy inverso en Ubuntu 24.04: usa proxy_pass, cuatro cabeceras, WebSocket y revisa las barras finales y las subidas.

Qué hace una configuración de proxy inverso de nginx

Un proxy inverso de nginx recibe las peticiones que llegan por los puertos 80 y 443 y entrega cada una a una aplicación que ya escucha en un puerto local. Después devuelve al navegador la respuesta de esa aplicación. La configuración es un único bloque server y el bloque es corto. Casi toda la dificultad se concentra en cinco o seis líneas que indican a la aplicación quién era el cliente real y qué protocolo utilizó ese cliente.

Todo lo que sigue se construye desde cero en Ubuntu 24.04, con el paquete nginx de la distribución. El punto de partida es una aplicación que ya responde en 127.0.0.1:3000. Si todavía no ha elegido un proxy, la comparación entre nginx, Caddy y Traefik es lo primero que debe leer. A continuación se muestra la configuración de nginx, línea por línea.

Ejecute estas configuraciones en su propio servidor. Pruebe cada cambio con sudo nginx -t antes de recargar nginx y revise lo que muestra.

Dónde guarda nginx su configuración en Ubuntu

sudo apt update
sudo apt install -y nginx
ls -l /etc/nginx/sites-enabled/

El archivo principal es /etc/nginx/nginx.conf. Define las opciones globales dentro de un bloque http { } y después incluye dos directorios: /etc/nginx/conf.d/*.conf y /etc/nginx/sites-enabled/*. En Ubuntu y Debian se crea un archivo por sitio en /etc/nginx/sites-available/ y se habilita mediante un enlace simbólico en /etc/nginx/sites-enabled/. Al eliminar el enlace simbólico se deshabilita el sitio, pero se conserva el archivo.

Dos directivas que se usan más adelante sólo funcionan en el contexto http, nunca dentro de un bloque server: map y upstream. Colóquelas en un archivo independiente bajo /etc/nginx/conf.d/, porque ese directorio se incluye en el nivel http.

El paquete incluye un sitio habilitado llamado default. Está marcado como default_server, lo que significa que responde a cualquier solicitud cuyo encabezado Host no coincida con ningún server_name de la configuración. Mientras siga habilitado, una solicitud que no coincida con sus nombres llegará a ese sitio en lugar de a su aplicación. Elimine el enlace simbólico cuando su propio sitio funcione.

sudo rm /etc/nginx/sites-enabled/default
sudo nginx -t
sudo systemctl reload nginx

El bloque de servidor mínimo que redirige las peticiones de una aplicación

server {
    listen 80;
    listen [::]:80;
    server_name app.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
    }
}

Guárdelo como /etc/nginx/sites-available/app.example.com, habilítelo y cárguelo.

sudo ln -s /etc/nginx/sites-available/app.example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
curl -sI -H 'Host: app.example.com' http://127.0.0.1/

listen 80; enlaza IPv4 y listen [::]:80; enlaza IPv6. Si omite la segunda línea, se rechaza toda conexión IPv6 al servidor. Un navegador con pila dual cuya consulta DNS (sistema de nombres de dominio) devuelve un registro AAAA normalmente vuelve a intentar con IPv4 y oculta el problema, pero un visitante que sólo usa IPv6, o un cliente que prueba únicamente la primera dirección que recibe, ve un rechazo de conexión mientras todos los usuarios de IPv4 ven el sitio funcionando. El informe de error que recibe dice: «a mí me funciona».

server_name se compara con la cabecera Host que envía el navegador. Puede indicar varios nombres, separados por espacios. Si ningún bloque coincide, nginx usa el bloque que sea default_server. Por eso había que retirar el sitio incluido en el paquete.

location / es una coincidencia por prefijo sobre la ruta de la petición, y / coincide con cualquier ruta. proxy_pass es la dirección a la que nginx abre una conexión. Mantenga la aplicación enlazada a 127.0.0.1 para que la única vía de acceso pase por nginx. Si la aplicación se ejecuta en un contenedor, publíquela como 127.0.0.1:3000:3000 y no como 3000:3000, porque Docker escribe sus propias reglas y publica los puertos directamente, sin pasar por ufw, de modo que un puerto publicado sin restricciones es accesible desde Internet independientemente de lo que indique ufw. Docker documenta su cadena DOCKER-USER como el lugar donde se filtra ese tráfico, pero enlazar con 127.0.0.1 es una solución más sencilla.

La línea curl envía la cabecera Host correcta desde el propio servidor, de modo que puede probar el bloque antes de que DNS apunte a ningún sitio.

Qué envía nginx al backend cuando no se configura nada más

proxy_pass por sí solo oculta cuatro aspectos a la aplicación.

El paquete nginx 1.24.0 que Ubuntu 24.04 distribuye usa HTTP/1.0 con el backend de forma predeterminada y envía Connection: close. Por tanto, cada solicitud abre una conexión nueva con el backend y no es posible actualizar el protocolo. nginx 1.29.7, publicado en March 2026, cambió estos valores predeterminados: desde esa versión, nginx usa HTTP/1.1 con el backend, no envía la cabecera Connection y reutiliza las conexiones agrupadas en lugar de abrir una nueva para cada solicitud. Incluso en esa versión, una actualización a WebSocket sigue necesitando las cabeceras que se muestran más abajo.

La cabecera Host se reescribe con el valor de proxy_pass, que es 127.0.0.1:3000. Una aplicación que genera enlaces absolutos a partir de Host produce ahora enlaces que nadie fuera del servidor puede abrir.

La conexión que llega a la aplicación procede de nginx, por lo que la aplicación ve como dirección del cliente 127.0.0.1. Todas las líneas del registro y todos los límites de tasa dentro de la aplicación registran entonces el proxy en lugar del visitante.

La aplicación no puede saber que el navegador usó HTTPS, porque la conexión que recibió es HTTP sin cifrar en una dirección de loopback.

Cuatro líneas corrigen todo esto.

Los cuatro encabezados que debe establecer y lo que cada uno permite ver al backend

location / {
    proxy_pass http://127.0.0.1:3000;

    proxy_set_header Host              $host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Host lleva el nombre que escribió el visitante. $host es el nombre de la solicitud, sin el puerto y con las letras en minúsculas. Establézcalo para que la aplicación genere URL absolutas correctas, como la redirección después de iniciar sesión o el enlace de un correo de restablecimiento de contraseña. Si lo omite, la aplicación toma 127.0.0.1:3000 como su propio nombre. El valor predeterminado de nginx, proxy_redirect, reescribe un encabezado Location o Refresh que apunta a la dirección proxy_pass. Por eso, una redirección simple después de iniciar sesión suele llegar al destino correcto. Sin embargo, las URL absolutas que la aplicación inserta en sus páginas y correos, como el enlace de restablecimiento de contraseña, apuntan a 127.0.0.1:3000, una dirección que el navegador del visitante no puede abrir. Si la aplicación también necesita el puerto porque se sirve en 8080, use $http_host, que contiene el encabezado exactamente como lo envió el cliente.

X-Real-IP lleva un valor: $remote_addr, la dirección desde la que nginx aceptó la conexión. Las aplicaciones lo leen para sus propios registros de acceso y para aplicar sus propios límites de tasa.

X-Forwarded-For lleva una lista. $proxy_add_x_forwarded_for añade $remote_addr a lo que el cliente ya puso en ese encabezado, por lo que el valor queda separado por comas y la entrada añadida por nginx es la última. Este detalle determina si el encabezado es confiable: un cliente puede enviar cualquier X-Forwarded-For que quiera, de modo que una aplicación que lea la primera entrada puede recibir cualquier dirección. Cuando nginx es el servidor perimetral, escriba $remote_addr en su lugar y descarte la versión del cliente. Cuando hay una CDN u otro proxy delante, use set_real_ip_from y real_ip_header del módulo realip, para que $remote_addr se convierta en la dirección real del cliente.

X-Forwarded-Proto lleva http o https. Los frameworks lo leen para decidir si deben marcar las cookies como Secure y si deben forzar una redirección a HTTPS. Si lo omite en un sitio TLS y la aplicación está configurada para forzar HTTPS, ve http, responde con una redirección a la dirección HTTPS, recibe la siguiente solicitud a través de nginx, sigue viendo http y vuelve a redirigir. El navegador abandona el intento y muestra ERR_TOO_MANY_REDIRECTS.

Repetir esas cuatro líneas en cada location hace que se desvíen entre sí. Póngalas en un solo archivo e inclúyalo.

# /etc/nginx/snippets/proxy-headers.conf
proxy_set_header Host              $host;
proxy_set_header X-Real-IP         $remote_addr;
proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
location / {
    include snippets/proxy-headers.conf;
    proxy_pass http://127.0.0.1:3000;
}

La herencia tiene una particularidad importante. Una location hereda las directivas proxy_set_header de su bloque server sólo mientras no defina ninguna propia. Si añade un proxy_set_header dentro de la location, se eliminan todos los encabezados definidos en el nivel server para esa location. Manténgalos todos en un mismo nivel o include el fragmento en cada location que actúe como proxy.

¿Por qué mi aplicación WebSocket se conecta y después se desconecta?

Porque los valores predeterminados impiden la actualización y el tiempo de espera de lectura predeterminado cierra un túnel inactivo después de 60 segundos. Un WebSocket comienza como una solicitud HTTP que contiene Upgrade: websocket y Connection: Upgrade. Son cabeceras salto a salto, lo que significa que se espera que un proxy las consuma en lugar de reenviarlas. Además, en nginx 1.24.0 de Ubuntu 24.04, el protocolo ascendente predeterminado es HTTP/1.0, que no tiene ningún mecanismo de actualización. Ambos aspectos deben restablecerse manualmente.

El map debe estar en el contexto http, en su propio archivo.

# /etc/nginx/conf.d/websocket.conf
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

Después, configure el location.

location / {
    include snippets/proxy-headers.conf;
    proxy_pass http://127.0.0.1:3000;

    proxy_http_version 1.1;
    proxy_set_header Upgrade    $http_upgrade;
    proxy_set_header Connection $connection_upgrade;

    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
}

El map permite que un mismo location atienda ambos tipos de tráfico. En una solicitud normal, $http_upgrade está vacío, por lo que $connection_upgrade se convierte en close. En una solicitud de actualización, contiene websocket, por lo que la cabecera enviada al upstream es Connection: upgrade. Definir proxy_set_header Connection "upgrade"; de forma fija envía esa cabecera también en todas las solicitudes de páginas normales, y algunos backends responden a ellas con un error 400.

proxy_http_version 1.1; es el valor predeterminado a partir de nginx 1.29.7, por lo que en esas versiones la línea no cambia nada y no causa problemas. En el paquete 1.24.0 es obligatoria. Las líneas Upgrade y Connection son obligatorias en todas las versiones, porque nginx nunca reenvía esas dos cabeceras por sí solo.

proxy_read_timeout es la causa de los informes que indican que la aplicación «carga y después deja de actualizarse». Su valor predeterminado es 60 segundos y mide el intervalo entre dos lecturas del backend, no la duración de la conexión. nginx cierra un WebSocket que permanece inactivo durante 60 segundos, y la consola del navegador muestra que el socket se cerró con el código 1006. Las aplicaciones que envían su propio heartbeat con una frecuencia superior a una vez por minuto no lo detectan. Las aplicaciones que no lo hacen fallan al cumplirse el minuto. Este problema aparece primero en editores en tiempo real y dashboards. Una instancia de n8n autohospedada detrás de HTTPS es un ejemplo habitual.

¿Por qué una barra final en proxy_pass cambia mis URL?

La regla se resume en una frase. Si proxy_pass termina con una URI (identificador uniforme de recursos), incluso con una / independiente, nginx elimina la parte de la ruta de la petición que coincide con el prefijo location y coloca esa URI en su lugar. Si proxy_pass termina en el host y el puerto, la ruta de la petición se reenvía sin cambios.

location /app/ {
    proxy_pass http://127.0.0.1:3000/;
}

Una petición a /app/status llega al backend como /status.

location /app/ {
    proxy_pass http://127.0.0.1:3000;
}

Una petición a /app/status llega al backend como /app/status.

La forma adecuada depende de la aplicación. Una aplicación con una configuración de ruta base o subdirectorio necesita la segunda forma, y esa configuración debe conocer /app. Una aplicación que no admite prefijos necesita la primera. La primera forma tiene un problema inmediato: el HTML que devuelve la aplicación todavía contiene rutas absolutas como /static/main.css, el navegador las solicita en la raíz del sitio, ninguna ubicación coincide y la página se muestra sin estilos. La pestaña de red del navegador muestra que esas peticiones de recursos devuelven 404. La solución es configurar la ruta base propia de la aplicación o añadir un segundo location /static/ que apunte al mismo backend.

Una ubicación con expresión regular no puede incluir una URI en proxy_pass. sudo nginx -t rechaza la configuración e indica el motivo: "proxy_pass" cannot have URI part in location given by regular expression, or inside named location, or inside "if" statement, or inside "limit_except" block.

Esta clase de problemas desaparece cuando cada aplicación tiene su propio nombre, app.example.com, y se configura el proxy desde location /. Las subrutas sólo compensan cuando no se pueden añadir registros DNS.

¿Cómo coloco varios backends detrás de un mismo nombre?

Con un bloque upstream. Pertenece al contexto http, por lo que debe escribirse encima del bloque server en el mismo archivo o en /etc/nginx/conf.d/.

upstream app_backend {
    least_conn;
    server 127.0.0.1:3000 max_fails=3 fail_timeout=30s;
    server 127.0.0.1:3001 max_fails=3 fail_timeout=30s;
    keepalive 32;
}

A continuación, la directiva location le asigna ese nombre: proxy_pass http://app_backend;.

El método predeterminado es round robin. least_conn envía cada petición al backend que tiene menos conexiones activas, lo que resulta adecuado para peticiones de duración desigual. ip_hash fija la dirección de un cliente a un backend. Necesita ip_hash cuando la aplicación mantiene las sesiones en su propia memoria, porque el round robin entre dos backends de ese tipo cierra las sesiones de los usuarios al azar cuando sus peticiones llegan a la instancia que nunca las recibió. La mejor solución es trasladar las sesiones a un almacenamiento compartido.

max_fails=3 fail_timeout=30s significa que tres intentos fallidos en 30 segundos retiran ese servidor durante 30 segundos. Cuando todos los servidores del bloque se encuentran en ese estado, los clientes reciben 502 y el registro de errores muestra no live upstreams while connecting to upstream.

keepalive 32 mantiene abiertas hasta 32 conexiones inactivas con los backends por cada proceso worker, lo que elimina el handshake TCP de la mayoría de las peticiones. En Ubuntu 24.04 con 1.24.0, esta línea activa la caché. Desde nginx 1.29.7, la caché está activa de forma predeterminada, pero el valor documentado por defecto es keepalive 32 local;, y el parámetro local impide que las conexiones almacenadas en caché se compartan entre distintas ubicaciones. Por tanto, en 1.29.7 y versiones posteriores, un keepalive 32; sin parámetros no se limita a repetir el valor predeterminado: al omitir local, permite que cualquier ubicación que haga proxy al mismo servidor upstream reutilice una conexión agrupada, lo que cambia el comportamiento predeterminado. En esas versiones, omita la línea o escriba keepalive 32 local; para conservar el valor predeterminado. Escríbalo sin parámetros sólo si quiere habilitar ese uso compartido. El parámetro local es nuevo en 1.29.7, por lo que el paquete 1.24.0 no lo acepta. Para backends HTTP, la configuración que nginx recomienda para el pool consiste en establecer proxy_http_version en 1.1 (o 2, en nginx 1.29.4 y versiones posteriores) y borrar la cabecera Connection antes de enviarla al upstream. nginx también documenta las conexiones persistentes HTTP/1.0, que se crean enviando Connection: Keep-Alive a un backend compatible, pero indica que no se recomienda ese método. Desde 1.29.7, las dos partes de la configuración recomendada son los valores predeterminados. En 1.24.0, añada proxy_http_version 1.1; y proxy_set_header Connection ""; a la ubicación manualmente. De lo contrario, nginx seguirá enviando HTTP/1.0 con Connection: close y el pool nunca se reutilizará. Si la misma ubicación también usa el mapa de WebSocket, cambie el caso vacío de close a una cadena vacía, para que las peticiones normales no incluyan ninguna cabecera Connection y la conexión agrupada se reutilice.

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      '';
}

Los nombres dentro de un bloque upstream se resuelven cuando nginx se inicia. Si el backend es un contenedor que recibe una dirección nueva al reiniciarse, nginx seguirá usando la dirección antigua hasta que lo recargue. nginx 1.27.3 y versiones posteriores pueden seguir esos cambios sin una recarga mediante un resolver, un zone en el bloque upstream y el parámetro resolve en cada línea server, pero el paquete 1.24.0 es anterior a esa función. Dentro de una red Docker, puede trasladar la resolución al momento de la petición mediante el resolver integrado.

resolver 127.0.0.11 valid=10s;
set $backend http://app:3000;
proxy_pass $backend;

Cuando los contenedores aparecen y desaparecen con tanta frecuencia que debe editar nginx continuamente para adaptarse, es mejor usar un proxy que lea las etiquetas de los contenedores. Traefik delante de varias aplicaciones de Docker Compose crea sus rutas a partir de los propios contenedores.

¿Por qué fallan las cargas con 413 Request Entity Too Large?

client_max_body_size está establecido en 1 megabyte de forma predeterminada. nginx rechaza con un 413 los cuerpos de petición más grandes y registra client intended to send too large body en el registro de errores. Auméntelo en el bloque server o en la ubicación donde se realizan las cargas.

client_max_body_size 512m;

Un valor de 0 desactiva por completo la comprobación. Con 512m, nginx sigue rechazando los cuerpos de petición que superen ese límite. Por tanto, un 413 que persista después de este cambio no identifica al backend como origen. Compruebe el valor efectivo de client_max_body_size en la ubicación que gestiona la carga y el registro de errores de nginx antes de revisar el límite de carga de la propia aplicación.

De forma predeterminada, nginx lee todo el cuerpo de la petición antes de abrir la conexión con el upstream y escribe primero los datos grandes en un archivo temporal del disco. Esto protege la aplicación frente a clientes lentos, porque el backend recibe la carga a la velocidad completa de la red local. Para cargas muy grandes, puede transmitir los datos directamente.

proxy_request_buffering off;

Para cargas fragmentadas de HTTP/1.1 en el paquete 1.24.0, establezca también proxy_http_version 1.1; en esa ubicación. De lo contrario, nginx seguirá almacenando el cuerpo en búfer. El backend recibe entonces el cuerpo a medida que llega y debe poder procesarlo de esa forma. Cuando nginx empieza a enviar el cuerpo al upstream, ya no puede reintentar la petición contra otro upstream.

client_body_timeout, que está establecido en 60 segundos de forma predeterminada, se aplica entre dos lecturas consecutivas del cuerpo, no a la carga completa. Una carga lenta pero constante puede continuar. Una carga detenida se descarta.

Búferes de respuesta y el ajuste que interrumpe la salida en tiempo real

proxy_buffering está habilitado de forma predeterminada y normalmente es lo que necesita. nginx lee la respuesta de su aplicación tan rápido como la aplicación puede escribirla, la almacena y la entrega a un cliente lento al ritmo de ese cliente. El worker de la aplicación termina antes en lugar de permanecer ocupado durante toda la descarga lenta.

Esto interrumpe las respuestas en streaming. Los eventos enviados por el servidor y la salida de registros en tiempo real no muestran nada al lector hasta que se llena un búfer. Deshabilite el almacenamiento en búfer sólo en esa ubicación.

proxy_buffering off;

Si controla la aplicación, la mejor opción es enviar la cabecera X-Accel-Buffering: no únicamente en las respuestas en streaming. nginx lee esa cabecera en cada respuesta y deshabilita el almacenamiento en búfer sólo para ella. Así, las páginas normales mantienen sus ventajas.

Cuando el registro de errores muestra upstream sent too big header while reading response header from upstream, las cabeceras de respuesta no cabían en un solo búfer. proxy_buffer_size tiene como valor predeterminado una sola página de memoria, de 4 u 8 kilobytes según la plataforma, y las cookies largas o las cabeceras de autenticación grandes pueden desbordarla. Aumente ambos valores.

proxy_buffer_size 16k;
proxy_buffers 8 16k;

¿Dónde debe configurarse TLS?

En Nginx, delante de todo lo anterior. TLS (seguridad de la capa de transporte) termina en el proxy, y la conexión de Nginx con la aplicación sigue siendo HTTP sin cifrar a través de la dirección de loopback, donde ningún otro sistema de la red puede leerla. La aplicación sabe que el visitante usó HTTPS mediante X-Forwarded-Proto, el cuarto de los cuatro encabezados.

No escriba manualmente las rutas de los certificados. Apunte el registro DNS al servidor, abra el firewall y deje que Certbot edite este mismo bloque de servidor: añadirá la línea listen 443 ssl con las rutas ssl_certificate, además de una redirección desde el puerto 80. Emitir un certificado de Let's Encrypt para Nginx con Certbot explica la emisión y el temporizador de renovación.

sudo ufw allow 'Nginx Full'
sudo ufw status

Nginx Full es un perfil de aplicación que instala el paquete de Nginx y que abre conjuntamente los puertos 80 y 443. El puerto 80 debe permanecer abierto para el desafío de renovación HTTP-01, incluso después de redirigir a HTTPS a todos los visitantes.

Pruebe la configuración y después recárguela

sudo nginx -t
sudo systemctl reload nginx

nginx -t analiza todos los archivos incluidos e informa si la prueba se ha realizado correctamente o muestra el archivo y la línea donde se detuvo. Lea esa salida antes de recargar. Una recarga con una configuración incorrecta no se aplica: nginx sigue sirviendo la configuración anterior, por lo que el sitio permanece disponible mientras el cambio no tiene ningún efecto. systemctl restart funciona de otra forma y es más arriesgado, porque un reinicio detiene primero el servidor en ejecución. Si la configuración contiene un error, nginx queda detenido. Use la recarga de forma predeterminada y reserve el reinicio para los cambios que realmente lo requieran.

sudo tail -f /var/log/nginx/error.log
sudo ss -lntp | grep -E ':(80|443|3000)'

La línea ss muestra qué proceso mantiene cada puerto, por lo que puede confirmar que la aplicación realmente está escuchando donde indica proxy_pass.

Los fallos que realmente encontrará

502 Bad Gateway, con connect() failed (111: Connection refused) while connecting to upstream en el registro de errores. No hay ningún proceso escuchando en la dirección indicada en proxy_pass. La aplicación está detenida, escucha en otro puerto o está vinculada a una dirección interna del contenedor que el host no puede alcanzar.

502 con no live upstreams while connecting to upstream. Todos los servidores del bloque upstream están marcados como fallidos por max_fails. Repare los backends. nginx volverá a intentarlo cuando expire fail_timeout.

504 Gateway Time-out, con upstream timed out (110: Connection timed out) while reading response header from upstream. El backend aceptó la conexión y después no envió nada durante proxy_read_timeout segundos. Aumentar el tiempo de espera es correcto para un informe que realmente tarda en generarse, pero no para una aplicación bloqueada.

Todas las rutas devuelven 404 desde la aplicación. La regla de la barra final reescribió la ruta. Compare la ruta que registra la aplicación con la ruta solicitada.

Responde otro sitio. server_name no coincide con la cabecera Host, por lo que la solicitud terminó en el bloque default_server.

La página carga, pero la interfaz se bloquea al cabo de aproximadamente un minuto. Es el caso de WebSocket: falta la configuración de Upgrade o proxy_read_timeout sigue establecido en 60 segundos.

FAQ

¿Por qué nginx devuelve 502 Bad Gateway después de añadir proxy_pass?

nginx no pudo abrir una conexión con la dirección indicada en proxy_pass. El registro de errores en /var/log/nginx/error.log muestra la causa: connect() failed (111: Connection refused) while connecting to upstream significa que no hay ningún proceso escuchando allí, y no live upstreams significa que todos los servidores de un bloque upstream se han marcado como fallidos. Ejecute sudo ss -lntp | grep 3000 para ver qué proceso usa el puerto y en qué dirección está enlazado. Una aplicación enlazada a una dirección interna del contenedor, o a un puerto distinto del indicado, produce este error siempre.

¿Por qué mi aplicación se desconecta aproximadamente un minuto después de ponerla detrás de nginx?

La conexión es un WebSocket y proxy_read_timeout sigue teniendo el valor predeterminado de 60 segundos, que mide el intervalo entre dos lecturas del backend. nginx cierra un socket inactivo y la consola del navegador informa del código de cierre 1006. Establezca proxy_http_version 1.1 (el valor predeterminado desde nginx 1.29.7, pero no en el paquete 1.24.0 que distribuye Ubuntu 24.04), reenvíe Upgrade y Connection mediante un map en $http_upgrade y aumente proxy_read_timeout a un valor como 3600s. Sin la cabecera Upgrade la actualización nunca se realiza, por lo que la aplicación vuelve al sondeo o no muestra actualizaciones en tiempo real.

¿Importa la barra final de proxy_pass?

Sí, y cambia la ruta que recibe el backend. Con location /app/ y proxy_pass http://127.0.0.1:3000/, una petición a /app/status llega al backend como /status, porque cualquier URI situada después del host y el puerto sustituye el prefijo de la ubicación coincidente. Quite esa barra final y la misma petición llega como /app/status. Quitar el prefijo suele romper los enlaces a los recursos de la propia aplicación. Estos enlaces siguen siendo absolutos y después devuelven 404 en la raíz del sitio. Por eso, si la aplicación tiene una configuración de ruta base, es preferible la forma que conserva la ruta.

¿Por qué mi aplicación registra 127.0.0.1 como la dirección IP de todos los visitantes?

Porque la conexión que recibe la aplicación procede realmente de nginx en la dirección de loopback. La dirección del visitante sólo llega a la aplicación mediante una cabecera que se configura: proxy_set_header X-Real-IP $remote_addr; para un único valor y proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; para la cadena concatenada. Después, la aplicación debe configurarse para confiar en esas cabeceras. Recuerde que un cliente puede enviar su propio X-Forwarded-For. Por eso, cuando nginx es el servidor perimetral, sobrescríbalo con $remote_addr en lugar de añadirlo.

¿Necesito TLS en la conexión entre nginx y mi aplicación?

No, si la aplicación se ejecuta en el mismo servidor y está enlazada a 127.0.0.1, porque ese tráfico no sale de la máquina. Termine TLS en nginx, mantenga proxy_pass sobre HTTP sin cifrar mediante loopback y envíe X-Forwarded-Proto $scheme para que la aplicación sepa que el visitante utilizó HTTPS. Si el backend está en otro host a través de una red que no controla, ese salto necesita su propia protección: HTTPS hacia el backend o un túnel privado entre las dos máquinas.

¿Te resultó útil este artículo?