# dklwebsvr: servidor web propio de Devkron `dklwebsvr` es un servidor web **HTTP/HTTPS autónomo** para Devkron: recibe las peticiones del navegador y las entrega al servidor FastCGI de Devkron (`dkl -fastcgi fastcgi.json`) con **el mismo conjunto de parámetros que arma nginx**. Con él puede publicar sus sitios sin instalar nginx ni IIS. Es un solo ejecutable, sin dependencias, para Linux y Windows, y viene en la carpeta `tools/dklwebsvr/` de la distribución ([Descargas](/es/devkron/2.0/instalacion/descargas.md)). ```text Navegador ──HTTP/1.1, HTTP/2, TLS──► dklwebsvr ──FastCGI (TCP o socket Unix)──► dkl -fastcgi ``` - **Mismo resultado que con nginx**: las aplicaciones reciben las mismas variables y el mismo `@http_context`. - **HTTPS** con TLS 1.2 y 1.3 y HTTP/2. Elige el certificado por el nombre que pide el navegador (SNI, con comodines), instala y renueva certificados **sin reiniciar** copiándolos a una carpeta, y lee directamente la estructura de Let's Encrypt. - **Redirección a HTTPS**, HSTS, límite del tamaño del cuerpo, bitácora de accesos y apagado ordenado. - Conexión al servidor FastCGI por **TCP o socket Unix**, con conexiones persistentes opcionales y varios servidores FastCGI según el host. ## ¿dklwebsvr, nginx o IIS? | Use | Cuando | |---|---| | **dklwebsvr** | El servidor solo publica sitios de Devkron y quiere una instalación mínima, con HTTPS y certificados sin configurar otro programa | | **nginx** | Ya usa nginx, o el mismo servidor publica también otras aplicaciones (PHP, archivos estáticos con caché, proxies) — vea [nginx con FastCGI](/es/devkron/2.0/instalacion/nginx.md) | | **IIS 10** | Está obligado a publicar con IIS en Windows — vea [IIS 10 con iis2dkl](/es/devkron/2.0/instalacion/iis.md) | Los tres hablan con el mismo servidor FastCGI de Devkron; puede cambiar de uno a otro sin tocar sus aplicaciones. ## Relación con el servidor FastCGI `dklwebsvr` **no arranca ni vigila** el servidor FastCGI: este se levanta por su cuenta, como servicio ([Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md) o [Servicio en Windows](/es/devkron/2.0/instalacion/servicio-windows.md)). Si el servidor FastCGI no responde, `dklwebsvr` contesta 502 y vuelve a funcionar en cuanto el servidor FastCGI se levanta, sin reiniciarlo. - **En la misma máquina**, el servidor FastCGI debe escuchar solo localmente: `"address": "127.0.0.1"` en `fastcgi.json` o, en Linux, un socket Unix (`"unix_socket": "/run/devkron/devkron.sock"`), que es lo recomendado. Vea [Servidor FastCGI](/es/devkron/2.0/instalacion/fastcgi.md). - **Licencia.** `dklwebsvr` cumple el mismo papel que nginx: no cambia los hosts ni los límites de la licencia, y entrega `HTTP_HOST` y `SERVER_NAME` intactos, que son con los que Devkron valida los hosts. Sin licencia, Devkron atiende 3 conexiones y solo los hosts `*.localhost` y `127.0.0.1`. Vea [Licencia](/es/devkron/2.0/instalacion/licencia.md). - **Código de estado.** Como nginx: si el programa fija el código, se usa ese; si no lo fija y manda `Location`, la respuesta es 302; si no hay ninguno de los dos, es 200 (desde la versión 1.1.1, que viene en Devkron 2.0.5.1; antes una respuesta con `Location` y sin código salía como 200). - **Sitios.** Como con nginx, los programas de cada host se buscan en la carpeta `web//` de la instalación de Devkron. ## Inicio rápido Con el servidor FastCGI de Devkron escuchando en `127.0.0.1:9090` (su valor por omisión), sin archivo de configuración `dklwebsvr` escucha en el puerto 80 de todas las interfaces y entrega las peticiones a `127.0.0.1:9090`: ```bash cd /opt/devkron/tools/dklwebsvr sudo ./dklwebsvr ``` En Windows: ```powershell cd C:\devkron\tools\dklwebsvr .\dklwebsvr.exe ``` Abra `http://misitio.localhost/` (o el host de su licencia). Para usar la configuración de ejemplo que trae la distribución (HTTP que redirige a HTTPS, certificados en `certs/`, bitácoras en `logs/`), cópiela sin la extensión `.example`, compruebe que exista la carpeta `logs` (la distribución ya la trae vacía desde la versión 2.0.1; si la borró o instaló la herramienta en otra carpeta, créela: dklwebsvr no arranca si falta). Ponga sus certificados en `certs/` y revise todo antes de arrancar: ```bash cd /opt/devkron/tools/dklwebsvr sudo cp dklwebsvr.conn.json.example dklwebsvr.conn.json sudo mkdir -p logs certs sudo ./dklwebsvr -test sudo ./dklwebsvr ``` ```powershell cd C:\devkron\tools\dklwebsvr Copy-Item dklwebsvr.conn.json.example dklwebsvr.conn.json New-Item -ItemType Directory -Force logs, certs .\dklwebsvr.exe -test .\dklwebsvr.exe ``` Mientras `certs/` esté vacía, `-test` termina con «resultado: con errores» porque no hay certificados: el HTTP funciona y el HTTPS se rechaza hasta que instale uno. ## Línea de comandos ```text dklwebsvr [-c=archivo_conexion] [-m=archivo_mapa] [-test] [-dump-map] [-self-signed=host1,host2] [-version] ``` | Opción | Qué hace | |---|---| | `-c` | Archivo de configuración. Si no se indica, se usa `dklwebsvr.conn.json` junto al ejecutable; si no existe, los valores por omisión | | `-m` | Archivo de mapeo de parámetros. Si no se indica, se usa `dklwebsvr.map.json` junto al ejecutable; si no existe, el mapeo incluido (el de nginx) | | `-test` | Revisa configuración, mapeo y certificados, los muestra y termina (código 0 si todo es correcto), como `nginx -t` | | `-dump-map` | Imprime el mapeo en uso (JSON) y termina | | `-self-signed` | Genera un certificado autofirmado para los nombres o IP indicados en la carpeta de certificados y termina. **Solo para pruebas** | | `-version` | Imprime la versión | Las rutas relativas, en las opciones y dentro de los archivos, se resuelven contra la **carpeta del ejecutable**, no contra el directorio de trabajo. El nombre de los archivos que busca es el del ejecutable sin extensión: si copia `dklwebsvr` como `sitio2`, buscará `sitio2.conn.json`. Así puede tener varias configuraciones. ## Configuración (`dklwebsvr.conn.json`) Los campos que no escriba toman su valor por omisión; un campo con nombre desconocido es error, para que una errata no pase desapercibida. La distribución trae `dklwebsvr.conn.json.example`, pensado para producción (80 redirige a 443, certificados en una carpeta, HSTS, conexiones persistentes y bitácoras): ```json { "address": "127.0.0.1:9090", "connect_timeout_ms": 3000, "response_timeout_ms": 300000, "log_file": "logs/dklwebsvr.log", "keepalive": 2, "keepalive_idle_ms": 5000, "listen": [ { "address": "0.0.0.0:80" }, { "address": "0.0.0.0:443", "tls": true } ], "tls": { "certs_dir": "certs", "min_version": "1.2", "reload_interval_s": 60 }, "redirect_http_to_https": true, "hsts": "max-age=31536000", "max_body_size": 52428800, "access_log": "logs/access.log" } ``` ### Conexión con el servidor FastCGI | Campo | Por omisión | Descripción | |---|---|---| | `address` | `127.0.0.1:9090` | Servidor FastCGI de Devkron: `ip:puerto` o `unix:/ruta/al/socket` | | `connect_timeout_ms` | `3000` | Tiempo máximo para conectar con el servidor FastCGI (si se agota: 502) | | `response_timeout_ms` | `120000` | Tiempo máximo sin recibir datos del servidor FastCGI, contado desde que se terminó de enviar la petición (si se agota: 504). Equivale a `fastcgi_read_timeout` de nginx | | `keepalive` | `0` | Conexiones inactivas que se conservan hacia cada servidor FastCGI (vea más abajo) | | `keepalive_idle_ms` | `5000` | Cuánto vive una conexión inactiva; debe ser **menor** que `connection_timeout` de `fastcgi.json` | | `sites` | `[]` | Hosts que van a **otro** servidor FastCGI o con otro `server_name`/`document_root` | ### Escucha y HTTP | Campo | Por omisión | Descripción | |---|---|---| | `listen` | `[{"address":"0.0.0.0:80"}]` | Direcciones de escucha: `{"address":"ip:puerto", "tls":true\|false}`. `[::]:443` escucha en IPv4 e IPv6 | | `redirect_http_to_https` | `false` | Las direcciones sin TLS responden 301 hacia HTTPS (salvo `/.well-known/acme-challenge/`). Requiere una dirección con TLS y otra sin TLS | | `hsts` | — | Valor de `Strict-Transport-Security` en las respuestas HTTPS, por ejemplo `max-age=31536000` | | `server_name` | — | Valor de `SERVER_NAME`; vacío: el host de la petición sin puerto | | `document_root` | — | Valor de `DOCUMENT_ROOT` | | `max_body_size` | `0` (sin límite) | Bytes máximos del cuerpo de la petición; por encima responde **413**. Equivale a `client_max_body_size` | | `max_header_bytes` | `65536` | Tamaño máximo de los encabezados de la petición | | `read_header_timeout_ms` | `10000` | Tiempo para recibir los encabezados (protege de conexiones lentas) | | `idle_timeout_ms` | `75000` | Conexiones *keep-alive* inactivas del navegador | | `shutdown_timeout_ms` | `30000` | Al detenerlo, cuánto espera a las peticiones en curso | | `temp_dir` | temporal del sistema | Dónde se juntan los cuerpos *chunked* de más de 1 MiB | ### HTTPS | Campo | Por omisión | Descripción | |---|---|---| | `tls.certificates` | `[]` | Pares `{"cert_file": "…", "key_file": "…"}` en PEM. El primero es el predeterminado | | `tls.certs_dir` | — | Carpeta de certificados que se revisa sin reiniciar (vea «Certificados y HTTPS») | | `tls.min_version` | `1.2` | `1.2` o `1.3` | | `tls.reload_interval_s` | `60` | Cada cuántos segundos se revisa si cambiaron los certificados | ### Bitácoras | Campo | Por omisión | Descripción | |---|---|---| | `log_file` | `dklwebsvr.log` | Eventos y errores: arranque, certificados cargados y su vencimiento, fallas de conexión, tiempos agotados y errores TLS | | `access_log` | — (desactivada) | Bitácora de accesos en el formato combinado de nginx, más host y segundos | | `log_params` | `false` | Registra los parámetros de cada petición. Solo para diagnóstico | ### Varios servidores FastCGI Con `sites`, un mismo `dklwebsvr` en el puerto 443 reparte los hosts entre varias instalaciones o instancias de Devkron: ```json "sites": [ { "hosts": ["app.midominio.com", "*.clientes.midominio.com"], "address": "unix:/run/devkron-app/devkron.sock" }, { "hosts": ["docs.midominio.com"], "address": "127.0.0.1:9091" } ] ``` `hosts` acepta nombres exactos y comodines de un nivel (`*.dominio`, que no incluye a `dominio`), sin distinguir mayúsculas ni tomar en cuenta el puerto. Un host que no esté en `sites` va al `address` general. ### Conexiones persistentes (`keepalive`) Por omisión se abre una conexión al servidor FastCGI por petición. Con `"keepalive": N` se conservan hasta N conexiones inactivas, lo que acerca el rendimiento al de nginx. Cada conexión inactiva ocupa un lugar de las conexiones simultáneas del servidor FastCGI (limitadas por la licencia), así que: - `keepalive` debe ser **menor** que las conexiones de la licencia (con 3 conexiones, 1 o 2); - `keepalive_idle_ms` debe ser **menor** que `connection_timeout` de `fastcgi.json`. ## Certificados y HTTPS Una dirección de `listen` con `"tls": true` toma su certificado de los indicados en `tls.certificates` y en `tls.certs_dir`. Para cada conexión se elige por el nombre que pide el navegador: primero coincidencia exacta, luego comodín (`*.dominio`) y si no, el predeterminado. Así, un mismo puerto 443 sirve a varios dominios. ### Instalar o renovar un certificado Con `tls.certs_dir` configurado, **instalar o renovar un certificado es copiar sus archivos** a la carpeta. `dklwebsvr` los toma en la siguiente revisión (`reload_interval_s`) o de inmediato al recibir `SIGHUP` en Linux (`systemctl reload dklwebsvr`), sin reiniciar ni cortar conexiones. En la carpeta y en sus subcarpetas de primer nivel reconoce: | Archivos | Origen típico | |---|---| | `.crt` (o `.pem`, `.cer`) y `.key` | Certificado comprado o de una autoridad interna. El `.crt` puede traer la cadena completa | | `/fullchain.pem` y `/privkey.pem` | Let's Encrypt (certbot): basta `"certs_dir": "/etc/letsencrypt/live"` | La bitácora registra cada certificado cargado con sus nombres y su vencimiento, y avisa si está vencido o vence en menos de 15 días. Un archivo dañado se omite; si ningún certificado carga, se conservan los anteriores. Sin ningún certificado, `dklwebsvr` arranca de todos modos: el HTTP funciona y las conexiones HTTPS se rechazan hasta que se instale uno. ### Let's Encrypt con certbot El reto HTTP lo sirve Devkron desde la carpeta del sitio (`dklwebsvr` nunca redirige `/.well-known/acme-challenge/`): ```bash sudo certbot certonly --webroot -w /opt/devkron/web/midominio.com -d midominio.com -d www.midominio.com \ --deploy-hook "systemctl reload dklwebsvr" ``` Y en la configuración, `"tls": {"certs_dir": "/etc/letsencrypt/live"}`. El usuario del servicio debe poder leer `privkey.pem` (por omisión solo lo lee `root`): dé lectura al grupo del servicio sobre `/etc/letsencrypt/live` y `/etc/letsencrypt/archive`, o copie los archivos a una carpeta propia desde el *deploy-hook*. En Windows no hay `SIGHUP`: los certificados se toman en la revisión periódica. ### Certificado de prueba ```bash ./dklwebsvr -self-signed=misitio.localhost ``` Genera un certificado autofirmado en la carpeta de certificados. El navegador lo marcará como no confiable: úselo solo en su equipo. ## Mapeo de parámetros El mapeo decide qué parámetros FastCGI recibe Devkron. El incluido entrega los mismos que nginx (`QUERY_STRING`, `REQUEST_METHOD`, `CONTENT_TYPE`, `CONTENT_LENGTH`, `SCRIPT_NAME`, `REQUEST_URI`, `DOCUMENT_URI`, `DOCUMENT_ROOT`, `SERVER_PROTOCOL`, `REQUEST_SCHEME`, `HTTPS`, `REMOTE_ADDR`, `SERVER_NAME`, `HTTP_*`…) y no hace falta cambiarlo; la única diferencia con nginx es `SERVER_SOFTWARE` (`dklwebsvr/`). Un archivo `dklwebsvr.map.json` propio solo sirve para agregar, renombrar o quitar variables. Parta de la salida de `dklwebsvr -dump-map` y agregue sus reglas: ```json { "version": 1, "http_headers": "pass", "unlisted": "drop", "rules": [ { "name": "QUERY_STRING", "from": ["QUERY_STRING"], "keep_empty": true }, { "name": "SSL_PROTOCOL", "from": ["SSL_PROTOCOL"] }, { "name": "APP_ENTORNO", "value": "produccion" } ] } ``` | Campo | Descripción | |---|---| | `version` | Obligatorio: `1` | | `http_headers` | `pass` (por omisión) reenvía los encabezados de la petición como `HTTP_*`; `drop` no | | `unlisted` | Qué hacer con los demás parámetros que no tienen regla: `drop` (por omisión) o `keep` | | `remove` | Lista de parámetros que se quitan siempre | | `rules` | Parámetros que se generan, en orden. Cada regla tiene `name` y una fuente: `from` (el primer parámetro no vacío de la lista), `value` (constante), `template` (`"{DOCUMENT_URI}{?QUERY_STRING}"`) o `switch` (valor según otro parámetro). Opcionales: `keep_empty`, `omit_values` y `transform` (`trim_trailing_slash`, `lower`, `upper`) | Con TLS, además de lo de nginx están disponibles `SSL_PROTOCOL`, `SSL_CIPHER` y `SSL_SERVER_NAME`; el mapeo incluido no los envía. `HTTP_HOST` y `SERVER_NAME` están protegidas: un mapeo que intente cambiarlas es inválido y `dklwebsvr` responde 502 a cada petición. Es el mismo formato de mapeo de `iis2dkl`. Como nginx, `dklwebsvr` descarta los encabezados cuyo nombre lleva `_` u otros caracteres fuera de letras, números y guiones: nadie puede fabricar así una variable `HTTP_*`. ## Dejarlo como servicio ### Linux (systemd) La unidad de systemd no viene en la distribución. Cree un usuario para el servicio (o use el de Devkron), dele escritura sobre la carpeta de bitácoras y guarde `/etc/systemd/system/dklwebsvr.service`: ```ini [Unit] Description=dklwebsvr - servidor web de Devkron After=network-online.target devkron.service Wants=network-online.target [Service] Type=simple User=devkron Group=devkron WorkingDirectory=/opt/devkron/tools/dklwebsvr ExecStart=/opt/devkron/tools/dklwebsvr/dklwebsvr -c=/opt/devkron/tools/dklwebsvr/dklwebsvr.conn.json ExecReload=/bin/kill -HUP $MAINPID TimeoutStopSec=40 Restart=always RestartSec=2 AmbientCapabilities=CAP_NET_BIND_SERVICE CapabilityBoundingSet=CAP_NET_BIND_SERVICE NoNewPrivileges=true LimitNOFILE=65536 [Install] WantedBy=multi-user.target ``` `CAP_NET_BIND_SERVICE` le permite usar los puertos 80 y 443 sin ser `root`; `ExecReload` recarga los certificados. El servidor FastCGI de Devkron sigue en su propia unidad (`devkron.service`). ```bash sudo mkdir -p /opt/devkron/tools/dklwebsvr/logs sudo chown devkron:devkron /opt/devkron/tools/dklwebsvr/logs sudo systemctl daemon-reload sudo systemctl enable --now dklwebsvr sudo systemctl reload dklwebsvr # recarga certificados journalctl -u dklwebsvr ``` ### Windows `dklwebsvr.exe` funciona igual, pero todavía no se registra por sí mismo como servicio de Windows. Para que arranque con el equipo, regístrelo con una tarea programada "al iniciar el sistema", igual que el servidor FastCGI ([Servicio en Windows](/es/devkron/2.0/instalacion/servicio-windows.md)), o con una herramienta como NSSM. Abra los puertos 80 y 443 en el Firewall de Windows. ### Detenerlo Al recibir `SIGTERM` (o `Ctrl+C`), `dklwebsvr` deja de aceptar conexiones y espera hasta `shutdown_timeout_ms` a que terminen las peticiones en curso. ## Respuestas ante fallas | Situación | Respuesta | |---|---| | El servidor FastCGI no acepta la conexión | `502` "Devkron no disponible" | | Sin respuesta antes de `response_timeout_ms` | `504` "Devkron no respondió a tiempo" | | Respuesta inválida del servidor FastCGI | `502` "Respuesta inválida de Devkron" | | El servidor FastCGI corta a media respuesta | se corta la conexión con el navegador (nunca entrega una respuesta incompleta como si fuera completa) | | Mapeo inválido | `502` "Configuración de dklwebsvr inválida" en cada petición | | Cuerpo mayor que `max_body_size` | `413` | Un error en el archivo de configuración impide arrancar: revíselo con `-test`. ## Errores típicos | Síntoma | Causa | Solución | |---|---|---| | 502 "Devkron no disponible" en todas las páginas | el servidor FastCGI no está corriendo o escucha en otra dirección | levántelo y compare `address` de los dos archivos | | 503 "Host no admitido por el servidor, se requiere una licencia." | el host no está en la licencia (sin licencia, solo `*.localhost` y `127.0.0.1`) | [Licencia](/es/devkron/2.0/instalacion/licencia.md) | | no arranca y la bitácora o la consola mencionan `logs/` | la carpeta de bitácoras no existe o el usuario no puede escribir en ella | créela junto al ejecutable y dele permisos | | `bind: permission denied` al arrancar en Linux | los puertos 80 y 443 requieren privilegios | use la unidad de systemd con `CAP_NET_BIND_SERVICE` | | el navegador rechaza el HTTPS | no hay certificado para ese nombre o venció | revise la bitácora y `dklwebsvr -test` | | las páginas se vuelven lentas con pocos usuarios | `keepalive` igual o mayor que las conexiones de la licencia | baje `keepalive` | | 413 al subir archivos | el archivo rebasa `max_body_size` | aumente el límite |