# nginx con FastCGI nginx es el servidor web recomendado para Devkron, en Linux y en Windows: recibe las peticiones HTTP o HTTPS del navegador, entrega lo que usted decida directamente y le pasa lo demás al servidor FastCGI de Devkron. Esta página explica cómo instalarlo, cómo conectarlo por socket Unix o por TCP, los ajustes de tamaño, tiempo y conexiones, y cómo resolver los errores más comunes. Devkron también funciona detrás de cualquier servidor que hable FastCGI (Apache, por ejemplo); para IIS vea [IIS 10 con iis2dkl](/es/devkron/2.0/instalacion/iis.md). ## Instalar nginx | Sistema | Instalación | Configuración | |---|---|---| | Debian, Ubuntu | `sudo apt install nginx` | `/etc/nginx/` (sitios en `/etc/nginx/conf.d/` o `sites-available/`) | | RHEL, Rocky, Alma | `sudo dnf install nginx` (o `yum install nginx`) | `/etc/nginx/` | | Windows | descargue el zip de [nginx.org](https://nginx.org/en/docs/windows.html) y descomprímalo | carpeta `conf` dentro de la instalación | Arranque y recarga en Linux: ```bash sudo systemctl enable --now nginx sudo nginx -t && sudo systemctl reload nginx ``` ## Con socket Unix (recomendado en Linux) Con el servicio de [Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md) (`unix_socket` en `/run/devkron/devkron.sock`), cree `/etc/nginx/conf.d/erp.conf`: ```nginx upstream devkron { server unix:/run/devkron/devkron.sock; keepalive 8; } server { listen 80; server_name erp.ejemplo.com; client_max_body_size 50m; # igual o menor que max_body_size de fastcgi.json location / { include fastcgi_params; fastcgi_keep_conn on; # necesario para aprovechar keepalive fastcgi_read_timeout 300s; # reportes largos fastcgi_pass devkron; } } ``` El socket Unix no abre ningún puerto y sus permisos deciden quién se conecta: es la opción más segura y la más rápida en la misma máquina. ## Con TCP En Windows, o si nginx corre en otro contenedor, el servidor FastCGI escucha en un puerto. En `fastcgi.json`, siempre en `127.0.0.1` (nunca `0.0.0.0` si la máquina es accesible desde fuera): ```json { "controller": "fastcgi/http.dkl", "address": "127.0.0.1", "port": 9090, "max_concurrent_requests": 128 } ``` ```nginx upstream devkron { server 127.0.0.1:9090; } server { listen 80; server_name erp.ejemplo.com; location / { include fastcgi_params; fastcgi_pass devkron; } } ``` ## Archivo `nginx.conf` completo (Windows o una instalación mínima) ```nginx worker_processes 1; events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; keepalive_timeout 65; server { listen 80; server_name localhost; location / { include fastcgi_params; fastcgi_pass 127.0.0.1:9090; } error_page 502 503 504 /50x.html; location = /50x.html { root html; } } } ``` No intercepte el 500 de Devkron con `error_page 500` si quiere ver el mensaje de error de su aplicación: vea [Errores HTTP 500](/es/devkron/2.0/migracion/errores-http.md). ## El archivo `fastcgi_params` nginx pasa a Devkron los datos de la petición mediante los parámetros de `fastcgi_params`, y el controlador los recibe en `@http_context<"request/headers/…">`. El archivo que trae nginx sirve tal cual: ```nginx fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length; fastcgi_param SCRIPT_NAME $fastcgi_script_name; fastcgi_param REQUEST_URI $request_uri; fastcgi_param DOCUMENT_URI $document_uri; fastcgi_param DOCUMENT_ROOT $document_root; fastcgi_param SERVER_PROTOCOL $server_protocol; fastcgi_param REQUEST_SCHEME $scheme; fastcgi_param HTTPS $https if_not_empty; fastcgi_param GATEWAY_INTERFACE CGI/1.1; fastcgi_param SERVER_SOFTWARE nginx/$nginx_version; fastcgi_param REMOTE_ADDR $remote_addr; fastcgi_param REMOTE_PORT $remote_port; fastcgi_param SERVER_ADDR $server_addr; fastcgi_param SERVER_PORT $server_port; fastcgi_param SERVER_NAME $server_name; fastcgi_param REDIRECT_STATUS 200; ``` Además, nginx envía cada encabezado del navegador como `HTTP_*` (`HTTP_HOST`, `HTTP_COOKIE`, `HTTP_USER_AGENT`…). **Ya no hace falta** la línea `fastcgi_param HTTP_COOKIE $http_cookie;` que se agregaba con Devkron 1.x: el servidor anterior perdía el último parámetro de cada petición y esa línea lo compensaba. Dejarla no afecta. ## Varios sitios Cada sitio es un bloque `server` con su `server_name`; todos pueden apuntar al mismo `upstream`. Devkron elige la carpeta `web//` por el encabezado `Host`, así que no hay que configurar nada más en Devkron: ```nginx server { listen 80; server_name erp.ejemplo.com; location / { include fastcgi_params; fastcgi_pass devkron; } } server { listen 80; server_name tienda.ejemplo.com; location / { include fastcgi_params; fastcgi_pass devkron; } } ``` Cada host atendido cuenta para el límite de hosts de la licencia ([Ediciones](/es/devkron/2.0/introduccion/ediciones.md)). No reescriba el encabezado `Host` ni `SERVER_NAME` hacia Devkron: con ellos se valida la licencia. ## HTTPS Configure el certificado en nginx (Devkron no maneja TLS); la conexión entre nginx y Devkron queda en la misma máquina: ```nginx server { listen 443 ssl; server_name erp.ejemplo.com; ssl_certificate /etc/ssl/ejemplo/fullchain.pem; ssl_certificate_key /etc/ssl/ejemplo/privkey.pem; client_max_body_size 50m; location / { include fastcgi_params; fastcgi_keep_conn on; fastcgi_read_timeout 300s; fastcgi_pass devkron; } } server { listen 80; server_name erp.ejemplo.com; return 301 https://$host$request_uri; } ``` Con `fastcgi_params`, el programa sabe que la petición llegó por HTTPS por `REQUEST_SCHEME` (`https`) y `HTTPS` (`on`). ## Ajustes que importan | Ajuste de nginx | Relación con Devkron | |---|---| | `client_max_body_size` | tamaño máximo de una subida; debe ser **igual o menor** que `max_body_size` de `fastcgi.json`. Si lo rebasa, responde nginx con 413 | | `fastcgi_read_timeout` | cuánto espera nginx la respuesta (60 s por omisión). Devkron no limita el tiempo de ejecución de un programa; súbalo para reportes largos | | `keepalive` del `upstream` + `fastcgi_keep_conn on` | reutiliza conexiones con Devkron. `keepalive` × procesos *worker* de nginx debe ser **menor** que las conexiones de la licencia (`max_concurrent_requests`; sin licencia, 3); si no, las peticiones nuevas esperan a que se libere una conexión inactiva | | `fastcgi_intercept_errors on` + `error_page 500` | nginx sustituye la página de error de Devkron por la suya | ## SELinux (RHEL, Rocky, Alma) Con SELinux activo, nginx no tiene permiso de conectarse a otros procesos por red. Si ve 502 con `Permission denied` y los permisos del socket están bien, permítalo: ```bash sudo setsebool -P httpd_can_network_connect 1 ``` ## Errores típicos | Síntoma (navegador / `error.log` de nginx) | Causa | Solución | |---|---|---| | 502 / `connect() … failed (111: Connection refused)` | Devkron no escucha en ese puerto | arranque el servicio; revise `address`/`port` | | 502 / `connect() to unix:… failed (2: No such file or directory)` | el socket no existe | el servicio no corre, o la ruta no coincide con `unix_socket` | | 502 / `connect() to unix:… failed (13: Permission denied)` | nginx no puede abrir el socket | grupo del socket ([Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md)) o SELinux | | 504 / `upstream timed out` | el programa tardó más que `fastcgi_read_timeout` | optimice la consulta o suba el tiempo | | 413 de nginx | subida mayor que `client_max_body_size` | súbalo (y `max_body_size` de Devkron) | | 503 "Host no admitido por el servidor, se requiere una licencia." | el host no está en la licencia, o no hay licencia | [Licencia](/es/devkron/2.0/instalacion/licencia.md) | | 404 de Devkron en todo el sitio | la carpeta `web//` no coincide con `server_name`/`Host` | renombre la carpeta o use alias de host (`fastcgi/alias.dkl`) |