{"canonical_url":"https://engineer.company/es/glossary/nginx/","content_markdown":"# nginx\n\n## Qué es\n\nnginx es un programa de código abierto que acepta conexiones HTTP y, para cada\npetición, responde con archivos del disco o la entrega a otro servidor y\ntransmite su respuesta. El nombre se pronuncia «engine x», y las propias páginas\ndel proyecto también lo escriben NGINX. Lo creó Igor Sysoev, y la primera\nversión pública, la 0.1.0, apareció el 4 de octubre de 2004. Se puede usar\ngratuitamente bajo una licencia BSD de 2 cláusulas, y F5, Inc. vende\ndistribuciones empresariales, soporte y formación.\n\nEl proyecto enumera seis funciones: servidor HTTP, proxy inverso, caché de\ncontenido, balanceador de carga, proxy TCP y UDP y proxy de correo. En un\nservidor web suele realizar una o ambas de estas tareas: servir archivos\nestáticos del disco y situarse delante de un servidor de aplicaciones, donde\ntermina TLS y reenvía cada petición hacia el interior.\n\nAl iniciarse, nginx ejecuta un único proceso maestro y varios procesos de\ntrabajo. El maestro lee y comprueba la configuración y supervisa los procesos de\ntrabajo. Estos se ejecutan con un usuario sin privilegios y se encargan de todas\nlas peticiones. Cada uno utiliza un bucle basado en eventos, apoyado en epoll en\nLinux y kqueue en FreeBSD, de modo que unos pocos procesos pueden mantener miles\nde conexiones abiertas a la vez. La directiva worker_processes establece cuántos\nhay, mediante un número fijo o con auto para tener uno por núcleo de CPU, y la\nlista de características del proyecto cifra el consumo de 10.000 conexiones\nkeep-alive inactivas en unos 2,5 MB de memoria.\n\nLa configuración es un archivo de texto con directivas. Una directiva simple\nconsta de un nombre y sus parámetros y termina en punto y coma. Una directiva de\nbloque encierra otras directivas entre llaves, y un bloque que puede contener\ndirectivas se denomina contexto. Los contextos events y http están en el nivel\nsuperior. Dentro de http, cada bloque server describe un servidor virtual, que\nse elige por la dirección y el puerto en los que escucha y después por el nombre\nde host que pidió el cliente. Dentro de un bloque server, cada bloque location\nindica qué hacer con un conjunto de rutas de petición.\n\n## Por qué importa\n\nEl servidor web es el programa por el que pasa cada visitante, así que su\ncomportamiento bajo carga y sus valores predeterminados afectan a todos. Dos\npropiedades explican el interés de nginx.\n\nLa primera es el bajo coste con el que mantiene conexiones lentas. El\nalmacenamiento en búfer de las respuestas de un servidor situado detrás del\nproxy está activado de forma predeterminada: nginx recibe la respuesta del backend tan\nrápido como este puede producirla, la vuelca a un archivo temporal cuando supera\nla capacidad de la memoria y después la entrega al cliente al ritmo que este\npueda recibirla. El servidor de aplicaciones queda libre para la siguiente\npetición mientras un teléfono con poca cobertura aún descarga la respuesta anterior.\n\nLa segunda es que los cambios de configuración se aplican sin cortar peticiones.\nLas modificaciones solo entran en vigor al recargar o reiniciar. Al recargar, el\nmaestro comprueba la nueva configuración e intenta aplicarla. Si lo consigue,\narranca nuevos procesos de trabajo con ella, mientras los antiguos dejan de\naceptar conexiones, completan las peticiones en curso y terminan su ejecución. Si falla, el\nmaestro revierte el cambio y sigue sirviendo con la configuración que ya tenía.\nEl proyecto también contempla actualizar el propio binario sin interrumpir a los\nclientes.\n\nEl coste se paga en el lenguaje de configuración, cuyas reglas de precedencia y\nherencia concentran la mayoría de las sorpresas. Para una ruta de petición,\nnginx busca primero el bloque location cuyo prefijo coincidente sea más largo y\nlo recuerda; después prueba los bloques location de expresiones regulares en el\norden en que aparecen en el archivo y elige el primero que coincide. El prefijo\nrecordado se usa cuando ninguna expresión regular coincide. Un bloque location\nmarcado con `=` coincide exactamente con la ruta y termina la búsqueda de\ninmediato, y `^~` en el prefijo más largo indica a nginx que omita las\nexpresiones regulares. Algunas directivas, entre ellas add_header y\nproxy_set_header, solo se heredan del nivel contenedor si el nivel actual no\ndefine ninguna propia.\n\nDurante mucho tiempo, los certificados procedían de un cliente ACME que se\nejecutaba junto a nginx. Ahora el proyecto también ofrece ngx_http_acme_module,\ndistribuido por separado de la compilación del núcleo.\n\n## Cómo se aplica en la práctica\n\nDos trabajos de alojamiento realizados en puestos anteriores de la fundadora\nincluyeron nginx, y en ambos compartía servidores con Apache en lugar de\nsustituirlo.\n\nEl primero abarcaba [cuarenta sitios web de clientes que debían ser rápidos y estar siempre accesibles](/es/portfolio/administered-40-websites-on-apache-and-nginx/), que funcionaban en servidores Ubuntu Linux con Apache y\nnginx. El trabajo consistía en escribir su configuración, ajustarlos para\nmejorar la velocidad y mantenerlos mientras recibían visitantes reales, y los\ncuarenta mantuvieron una alta disponibilidad. Dos servidores web en una misma\nflota implican expresar cada regla en dos dialectos: un servidor virtual de Apache\nequivale a un bloque server de nginx, y una corrección encontrada para uno debe\ntraducirse al otro.\n\nEl segundo se desarrolló de 2015 a 2022. [Un flujo ACME se encargó de los certificados de cien aplicaciones Docker](/es/portfolio/automated-ssl-tls-certs-for-100-docker-apps/): emitía cada uno, lo renovaba antes\nde su caducidad y lo instalaba en los servidores Ubuntu sin intervención humana;\nApache y nginx volvían a coexistir en esos servidores. En nginx, renovar un\narchivo del disco es solo la mitad del cambio. Un certificado indicado mediante\nuna ruta simple se lee cuando nginx carga su configuración, y la documentación\nseñala que solo un nombre de archivo construido con variables hace que el\ncertificado se vuelva a cargar en cada negociación TLS. Por tanto, una\nrenovación que escribe archivos nuevos solo llega a los visitantes tras una\nrecarga, así que cualquier renovación automatizada para nginx debe terminar con\nuna.\n\n## Dónde surgen los problemas\n\n**Una cabecera configurada para todo el sitio desaparece en una ruta.** Un\nbloque location que tenga alguna directiva add_header propia no hereda ninguna\ndel nivel server o http, de modo que añadir una sola cabecera de caché a un\nbloque location elimina silenciosamente todas las cabeceras de seguridad del\nnivel superior. proxy_set_header sigue la misma regla. Además, add_header solo\nse aplica a códigos de éxito y redirección como 200, 301 y 304, salvo que se\nindique `always`, por lo que las páginas de error salen sin esas cabeceras. Mantenga\nlas cabeceras compartidas en un archivo incorporado con include en cada nivel\nque defina las suyas, o, desde la versión 1.29.3, establezca `add_header_inherit merge;`; añada `always`\ndonde las respuestas de error las necesiten y compruebe cada ruta con `curl -sI`.\n\n**Otro sitio responde a las peticiones del sitio esperado.** nginx compara\nprimero la dirección y el puerto y después la cabecera Host con server_name.\nCuando ningún bloque server de ese puerto reconoce el nombre, la petición llega\nal servidor predeterminado, que es el primero de la lista salvo que otro esté\nmarcado como default_server. Una errata en server_name de un sitio nuevo sirve\nsilenciosamente las páginas de un vecino antiguo. Declare un servidor\npredeterminado explícito que responda a nombres desconocidos con `return 444`, que cierra\nla conexión, para que el error se manifieste como tal en vez de mostrar el sitio\nequivocado.\n\n**Las subidas fallan con 413 Request Entity Too Large.** client_max_body_size\ntiene un valor predeterminado de 1 MB, y nginx rechaza un cuerpo de petición\nmayor antes de que la aplicación lo vea. Aumente el límite en el bloque location\nque acepte subidas, en lugar de hacerlo para todo el servidor, y manténgalo\nalineado con el límite de la propia aplicación.\n\n**El backend construye enlaces al host equivocado o recibe una ruta\nincorrecta.** Salvo que se indique lo contrario, nginx envía al servidor situado\ndetrás del proxy una cabecera Host basada en la dirección de proxy_pass, como\n`127.0.0.1:8080`, por lo que la aplicación genera redirecciones y enlaces absolutos hacia esa\ndirección. Establezca `proxy_set_header Host $host;` en el bloque location que actúa como proxy. Las rutas\ncambian según la forma de proxy_pass: si se escribe con una URI, aunque solo sea\n`/`, sustituye la parte de la ruta que coincidió con el bloque location; sin\nURI, transmite la ruta sin cambios. Por eso, pruebe una ruta anidada después de\ncualquier cambio.\n\n**Los clientes siguen recibiendo la configuración o el certificado antiguos.**\nEditar un archivo o renovar un certificado durante la noche no afecta a un nginx\nen ejecución hasta que se recarga, y recargar una configuración incorrecta deja\nla anterior en uso. Pruebe antes de cada recarga; después lea el registro de\nerrores y compruebe lo que reciben realmente los clientes:\n\n```sh\nnginx -t \u0026\u0026 nginx -s reload\nopenssl s_client -connect example.com:443 \\\n  -servername example.com \u003c/dev/null |\n  openssl x509 -noout -enddate\n```\n\n## Lecturas adicionales\n\n- [Documentación de nginx](https://nginx.org/en/docs/)\n  — índice del proyecto con guías y referencias de directivas por módulo.\n- [Guía para principiantes](https://nginx.org/en/docs/beginners_guide.html)\n  — procesos maestro y de trabajo, recarga y estructura de la configuración.\n- [Cómo procesa nginx una petición](https://nginx.org/en/docs/http/request_processing.html)\n  — elección de un bloque server por dirección, puerto y cabecera Host.\n- [Módulo ngx_http_core_module](https://nginx.org/en/docs/http/ngx_http_core_module.html)\n  — orden de coincidencia de location, server_name y client_max_body_size.\n- [Módulo ngx_http_proxy_module](https://nginx.org/en/docs/http/ngx_http_proxy_module.html)\n  — proxy_pass, valores predeterminados de cabeceras, tiempos de espera y\n  almacenamiento de respuestas en búfer.\n- [Módulo ngx_http_headers_module](https://nginx.org/en/docs/http/ngx_http_headers_module.html)\n  — add_header, sus códigos de respuesta y su regla de herencia.\n\n\u003chttps://engineer.company/es/glossary/nginx/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Cómo elige nginx el servidor y la ruta de cada petición, cómo recarga sin interrumpir peticiones y qué valores predeterminados causan sorpresas.","formats":{"gemtext":"https://engineer.company/es/glossary/nginx/index.gmi","gopher":"https://engineer.company/es/glossary/nginx/gophermap","html":"https://engineer.company/es/glossary/nginx/","json":"https://engineer.company/es/glossary/nginx/index.json","markdown":"https://engineer.company/es/glossary/nginx/index.md","pdf":"https://engineer.company/es/glossary/nginx/index.pdf"},"kind":"page","language":"es","title":"¿Qué es nginx?","url":"https://engineer.company/es/glossary/nginx/","version":1}