# Servidor FastCGI El servidor FastCGI de Devkron atiende las peticiones web que le pasa nginx (o IIS mediante `iis2dkl`) y ejecuta los programas DKL de sus sitios. Esta página explica cómo arrancarlo, todas las llaves de `fastcgi.json`, dónde van los sitios y cómo comprobar que responde. Para dejarlo como servicio vea [Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md) o [Servicio en Windows](/es/devkron/2.0/instalacion/servicio-windows.md). ## Arrancar el servidor Siempre desde la carpeta de la instalación, porque el controlador, la carpeta `web/`, `connections.xml` y la licencia se buscan en el directorio de trabajo: ```bash cd /opt/devkron ./dkl -fastcgi # con fastcgi.json del directorio de trabajo ./dkl -fastcgi /etc/devkron/fastcgi.json # con un archivo de configuración en otra ubicación ``` ```powershell cd C:\devkron .\dkl.exe -fastcgi fastcgi.json ``` Si el archivo indicado no existe, se usa `fastcgi.json` del directorio de trabajo, y si tampoco existe, los valores por omisión. `Ctrl+C` (o `SIGTERM` en Linux) deja de aceptar conexiones, termina ordenadamente y borra el socket Unix. Al arrancar, el servidor hace un **calentamiento**: ejecuta una vez el controlador con una petición sintética para que la primera petición real sea rápida. Lo puede apagar con `"warmup": false`. ## `fastcgi.json` El que trae la distribución: ```json { "controller":"fastcgi/http.dkl", "address":"0.0.0.0", "port":9090, "max_concurrent_requests":128, "connection_timeout":10000, "max_header_size":16384 } ``` **Cambie `address` a `127.0.0.1`** (o use `unix_socket`) antes de poner el servidor en operación: con `0.0.0.0` cualquier equipo que llegue al puerto puede mandarle peticiones directamente, sin pasar por nginx. Configuración recomendada para producción en Linux, con socket Unix (la explica [Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md)): ```json { "controller": "fastcgi/http.dkl", "unix_socket": "/run/devkron/devkron.sock", "unix_socket_mode": "660", "max_concurrent_requests": 128, "connection_timeout": 10000, "max_header_size": 16384, "max_body_size": 52428800, "culture": "es-MX", "native_cache_dir": "/var/cache/devkron/native", "native_key_file": "/var/lib/devkron/native.key" } ``` Y con TCP (Windows, o nginx en otro contenedor): ```json { "controller": "fastcgi/http.dkl", "address": "127.0.0.1", "port": 9090, "max_concurrent_requests": 128, "culture": "es-MX" } ``` ### Todas las llaves Todas son opcionales. Las de 1.x conservan su significado. | Llave | Omisión | Desde | Uso | |---|---|---|---| | `controller` | `http.dkl` (la distribución trae `fastcgi/http.dkl`) | 1.x | programa DKL que atiende cada petición, relativo al directorio de trabajo | | `address` | `0.0.0.0` | 1.x | dirección TCP de escucha: `127.0.0.1` (solo local, recomendado), `0.0.0.0` (todas las IPv4), `::` (IPv6 e IPv4) | | `port` | `9090` | 1.x | puerto TCP. Con `unix_socket` y sin `port` no se abre TCP | | `max_concurrent_requests` | `256` | 1.x | conexiones FastCGI simultáneas; se recorta a las conexiones de la licencia (sin licencia: 3) | | `connection_timeout` | `10000` | 1.x | milisegundos máximos mientras llega una petición y en cada escritura (en 2.0 es real) | | `max_header_size` | `16384` | 1.x | bytes de parámetros FastCGI (encabezados); por encima responde **431** | | `devkron_args` | `-ninja` | 1.x | opciones del motor para cada petición, separadas por espacios, en su forma con `:` (por ejemplo `-culture:es-MX -tree-output`) | | `unix_socket` | — | 2.0 | ruta de un socket Unix (Linux y Windows 10 o posterior); la ruta completa no debe pasar de 108 caracteres | | `unix_socket_mode` | según `umask` | 2.0 | permisos del socket en octal, por ejemplo `"660"` | | `keepalive_timeout` | `75000` | 2.0 | milisegundos de inactividad entre peticiones de una conexión que nginx mantiene abierta (`fastcgi_keep_conn on`) | | `max_body_size` | `0` (sin límite) | 2.0 | bytes máximos del cuerpo de la petición; por encima responde **413** | | `body_memory_threshold` | `1048576` | 2.0 | por encima de este tamaño el cuerpo se guarda en un archivo temporal en vez de en memoria | | `listen_backlog` | `max_concurrent_requests` × 5 (TCP); al menos 512 (Unix) | 2.0 | cola de conexiones pendientes del sistema operativo | | `culture` | — (manda `DEVKRON_CULTURE` o la del sistema) | 2.0 | cultura de **presentación** de todas las peticiones, por ejemplo `"es-MX"`; `"invariant"` o `""` = invariante. Vea [Cultura](/es/devkron/2.0/migracion/cultura.md) | | `tree_cache` | `true` | 2.0 | caché del árbol analizado en memoria; `false` la apaga | | `tree_cache_mb` | `512` | 2.0.3 | tope de memoria de la caché del árbol en MB; `0` = sin tope (equivale a `DEVKRON_TREE_CACHE_MB`) | | `direct_output` | `true` | 2.0 | `false` = salida como árbol (solo para diagnóstico) | | `native_compile` | `false` | 2.0 | `true` enciende la compilación nativa en segundo plano; conviene solo con cálculo intensivo y poca base de datos. Vea [Compilación de programas DKL](/es/devkron/2.0/instalacion/compilacion.md) | | `native_cache_dir` | junto a `dkl` si se puede escribir; si no, en la caché del usuario | 2.0 | carpeta de la caché de compilados | | `native_key_file` | `~/.config/devkron/native.key` (Linux), `%LOCALAPPDATA%\Devkron\native.key` (Windows) | 2.0 | archivo de la llave de integridad de la caché de compilados | | `native_max_contexts` | `512` | 2.0 | programas compilados cargados a la vez; `0` = sin tope | | `native_max_assembly_kb` | `4096` | 2.0 | KB de código por programa al compilar; lo que no cabe se interpreta; `0` = sin tope | | `native_max_program_mb` | `64` | 2.0 | MB de huella estimada de un programa compilado; al pasarlo se interpreta; `0` = sin tope | | `warmup` | `true` | 2.0 | `false` = sin calentamiento al arrancar | - Los valores booleanos aceptan `true`/`false`, `"on"`/`"off"`, `"yes"`/`"no"` y `1`/`0`. - `-ninja` en `devkron_args` no tiene efecto visible: el servidor no muestra la bitácora de todos modos. - Varias llaves tienen equivalente en variables de entorno (por ejemplo `DEVKRON_TREE_CACHE=0`, `DEVKRON_FASTCGI_WARMUP=0`); la llave de `fastcgi.json` gana. Vea [Variables de entorno](/es/devkron/2.0/instalacion/variables-de-entorno.md). - Para cambiar `fastcgi.json` hay que **reiniciar** el servidor. ### Conexiones, licencia y nginx `max_concurrent_requests` se recorta a las conexiones de la licencia: sin licencia el servidor atiende **3** conexiones a la vez. Si nginx mantiene conexiones abiertas (`keepalive` en el `upstream`), `keepalive` × procesos *worker* de nginx debe ser **menor** que ese número; si no, las conexiones nuevas esperan a que nginx cierre una inactiva. Vea [nginx con FastCGI](/es/devkron/2.0/instalacion/nginx.md). ## Ubicación de los sitios Los sitios van en la carpeta `web/` de la instalación. El controlador elige la carpeta por el **nombre de host** de la petición: ```text /opt/devkron/web/ ├── index.dkl sitio predeterminado: cualquier host sin carpeta propia ├── figura.png └── host1.midominio.com/ sitio de host1.midominio.com ├── index.dkl └── figura.png ``` - `cualquierotrohost.com/figura.png` devuelve `web/figura.png`. - `host1.midominio.com/figura.png` devuelve `web/host1.midominio.com/figura.png`. Dentro del sitio: - Los archivos `.dkl` son **programas** y se ejecutan; los demás se entregan como contenido estático con el tipo MIME de `fastcgi/mime.dkl` (texto: `.txt`, `.htm`, `.html`, `.css`, `.js`; binario: `.jpg`, `.jpeg`, `.png`, `.pdf`). Una extensión que no está en `mime.dkl` se entrega como `application/octet-stream`: agregue ahí las que use su sitio (`.svg`, `.json`, `.woff2`…). - No dependa de la extensión para ocultar un archivo: lo que no deba pedirse por URL (módulos `.dk`, bibliotecas `.dkh`, configuraciones, datos) guárdelo **fuera de `web/`** e inclúyalo o léalo desde ahí. - Si la URL es una carpeta, se busca el documento predeterminado en este orden: `index.dkl`, `index.html`, `index.htm`, `index.txt`, `default.dkl`, `default.html`, `default.htm`, `default.txt`, `readme.md`. - Si nada coincide, responde la página `fastcgi/404.dkl` con estado 404. ## El controlador y sus archivos | Archivo en `fastcgi/` | Para qué | |---|---| | `http.dkl` | controlador principal: elige sitio y archivo, entrega estáticos, ejecuta los `.dkl` y maneja errores | | `alias.dkl` | alias de nombres de host (por ejemplo, que `www.ejemplo.com` use la carpeta de `ejemplo.com`) | | `routing.dkl` | enrutamiento por host y mapas `routes.map`, `ext.map`, `paths.map` del sitio | | `auth.dkl` | restricción de la carpeta protegida y programa de autorización `auth.dk` del sitio | | `mime.dkl` | tipos MIME por extensión: cuáles se envían como texto y cuáles como binario | | `render.dkl` | posprocesado de la salida (`render.dk` del sitio) | | `404.dkl`, `500.dkl` | páginas de recurso no encontrado y de error no manejado | Cómo se usan al programar (alias, mapas de rutas, `auth.dk`, `render.dk`, respuestas) está en [Servidor web](/es/devkron/2.0/marcos/servidor-web/). Aquí, lo que conviene **configurar en un servidor de producción**, en `fastcgi/http.dkl`: | Variable | Valor de la distribución | Recomendación | |---|---|---| | `do errordet(@true)` | muestra archivo y línea en la página de error 500 | `@false` en producción: el usuario ve el mensaje sin rutas ni números de línea | | `@http_restrict_protected_dir` | `@false` | `@true`: impide pedir por URL los archivos de la carpeta `_protected` (mapas de rutas, programas internos) | Si modifica el controlador, guarde una copia: una actualización de Devkron trae los archivos originales. ## Comprobar que responde Sin nginx, con `curl` no se puede hablar FastCGI directamente; lo más simple es probar a través de nginx con un host `*.localhost` (vea [Primer sitio web](/es/devkron/2.0/introduccion/primer-sitio.md)). Para ver que el proceso escucha: ```bash ss -ltnp | grep 9090 # TCP ls -l /run/devkron/devkron.sock # socket Unix ``` Cada respuesta del servidor lleva los encabezados `Server: Devkron FastCGI` y `X-Powered-By: Devkron`, útiles para saber si la respuesta vino de Devkron o de nginx. ## Errores típicos | Síntoma | Causa | Solución | |---|---|---| | `The path '…' is of an invalid length for use with domain sockets` al arrancar | la ruta de `unix_socket` pasa de 108 caracteres | use una ruta corta, como `/run/devkron/devkron.sock` | | `Address already in use` | otro proceso (otra instancia, o Devkron 1.x) usa el puerto o el socket | cambie `port`/`unix_socket` o detenga el otro proceso | | **503** "Host no admitido por el servidor, se requiere una licencia." | sin licencia válida para 2.0 solo se atienden `*.localhost` y `127.0.0.1` | instale la [licencia](/es/devkron/2.0/instalacion/licencia.md) y reinicie el servidor | | **413** en subidas de archivos | el cuerpo supera `max_body_size` (o `client_max_body_size` de nginx, que responde antes) | suba ambos límites; el de nginx debe ser igual o menor que `max_body_size` | | **431** | encabezados demasiado grandes (cookies enormes) | suba `max_header_size` | | las páginas tardan y luego responden | se alcanzó `max_concurrent_requests` (o el límite de la licencia) y las peticiones se encolan | revise la edición de la licencia y el `keepalive` de nginx | | un cambio a `fastcgi.json` o una DLL nueva no se nota | se leen al arrancar | reinicie el servidor; los cambios a `.dkl`, `.dk` y `.dkh` no requieren reinicio |