# IIS 10 con iis2dkl Si sus sitios en Windows se publican con **Internet Information Services (IIS) 10**, Devkron 2.0 se conecta a él mediante **iis2dkl**, un puente de Induxsoft. `iis2dkl` viene en la distribución de Windows, en la carpeta `tools\iis2dkl\` ([Descargas](/es/devkron/2.0/instalacion/descargas.md)). Esta página explica por qué hace falta, cómo se arma y los pasos de instalación. Si no está obligado a usar IIS, es más sencillo [dklwebsvr](/es/devkron/2.0/instalacion/dklwebsvr.md), el servidor web que viene con Devkron, o nginx para Windows ([nginx con FastCGI](/es/devkron/2.0/instalacion/nginx.md)). ## Por qué hace falta un puente IIS no se conecta a un proceso FastCGI externo por TCP, como nginx: **lanza él mismo** el programa FastCGI y le habla por un *named pipe*. Además manda otras variables que nginx (por ejemplo, no envía `REQUEST_URI`). Si Devkron recibiera las variables de IIS tal cual, `@http_context` cambiaría y las aplicaciones dejarían de funcionar. `iis2dkl` es el programa que IIS lanza: traduce las variables al mismo conjunto que arma nginx, con un mapeo configurable, y reenvía cada petición por TCP al servidor FastCGI de Devkron de siempre: ```text Navegador ─► IIS 10 ──named pipe──► iis2dkl ──TCP──► dkl -fastcgi fastcgi.json ``` Así, una aplicación da el mismo resultado detrás de IIS que detrás de nginx. - `iis2dkl` **no administra** el proceso de Devkron: si el servidor FastCGI no está levantado, responde con error. Levántelo como se indica en [Servicio en Windows](/es/devkron/2.0/instalacion/servicio-windows.md). - El mapeo **no puede reescribir** `HTTP_HOST` ni `SERVER_NAME`: con ellos Devkron valida los hosts de la licencia. ## Requisitos - Windows Server 2016 o posterior, o Windows 10/11, con IIS 10. - La característica **CGI** de IIS, que instala el módulo FastCGI. No se necesita ASP.NET. - Devkron 2.0 instalado ([Instalar en Windows](/es/devkron/2.0/instalacion/windows.md)); en los ejemplos, en `C:\devkron`. - El servidor FastCGI de Devkron levantado por su cuenta: `iis2dkl` no lo arranca. En los ejemplos se usan el sitio de IIS `misitio`, con raíz física `C:\sitios\misitio`, y el grupo de aplicaciones (App Pool) `devkron`. ## Instalación 1. **Active CGI en IIS.** En PowerShell como administrador: ```powershell Install-WindowsFeature Web-CGI # Windows Server Enable-WindowsOptionalFeature -Online -FeatureName IIS-CGI # Windows 10/11 ``` 2. **Levante el servidor FastCGI de Devkron en TCP local.** En `C:\devkron\fastcgi.json`: ```json { "controller": "fastcgi/http.dkl", "address": "127.0.0.1", "port": 9090, "max_concurrent_requests": 128, "culture": "es-MX" } ``` Déjelo como tarea al iniciar el sistema ([Servicio en Windows](/es/devkron/2.0/instalacion/servicio-windows.md)) y compruebe que escucha: ```powershell Get-NetTCPConnection -LocalPort 9090 -State Listen ``` 3. **Revise la configuración de iis2dkl.** En `C:\devkron\tools\iis2dkl\` están `iis2dkl.exe`, `iis2dkl.conn.json.example` y `web.config.example`. La conexión con el servidor FastCGI se lee de `iis2dkl.conn.json`, **junto al ejecutable**; si no existe, se usa `127.0.0.1:9090`. Para usar el ejemplo, cópielo sin la extensión y cree la carpeta de bitácoras: ```powershell cd C:\devkron\tools\iis2dkl Copy-Item iis2dkl.conn.json.example iis2dkl.conn.json New-Item -ItemType Directory -Force logs ``` El ejemplo contiene: ```json { "address": "127.0.0.1:9090", "connect_timeout_ms": 3000, "response_timeout_ms": 120000, "log_file": "logs\\iis2dkl.log", "log_params": false } ``` | Campo | Por omisión | Descripción | |---|---|---| | `address` | `127.0.0.1:9090` | IP y puerto del servidor FastCGI (los de `fastcgi.json`) | | `connect_timeout_ms` | `3000` | tiempo máximo para conectar; si se agota, 502 | | `response_timeout_ms` | `120000` | tiempo máximo sin recibir datos del servidor FastCGI; si se agota, 504 | | `log_file` | `iis2dkl.log` | bitácora, relativa a la carpeta del ejecutable | | `log_params` | `false` | `true` registra las variables de cada petición; solo para diagnóstico | Un campo con nombre desconocido es error. Las rutas relativas se resuelven contra la carpeta del ejecutable, no contra el directorio de trabajo (bajo IIS suele ser `C:\Windows\System32\inetsrv`). 4. **Cree el App Pool y dé permisos.** `iis2dkl` no usa .NET: el App Pool va "Sin código administrado". Su identidad necesita leer y ejecutar la carpeta de Devkron y escribir en la de bitácoras: ```bat %windir%\system32\inetsrv\appcmd add apppool /name:devkron /managedRuntimeVersion:"" %windir%\system32\inetsrv\appcmd set app "misitio/" /applicationPool:devkron icacls C:\devkron /grant "IIS AppPool\devkron":(OI)(CI)RX icacls C:\devkron\tools\iis2dkl\logs /grant "IIS AppPool\devkron":(OI)(CI)M ``` 5. **Registre iis2dkl como aplicación FastCGI de IIS:** ```bat %windir%\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /+"[fullPath='C:\devkron\tools\iis2dkl\iis2dkl.exe',arguments='',maxInstances='3',instanceMaxRequests='10000',activityTimeout='150',requestTimeout='150',idleTimeout='300']" /commit:apphost ``` | Atributo | Valor recomendado | Por qué | |---|---|---| | `maxInstances` | igual a las conexiones de la licencia (3 sin licencia) | cada copia de `iis2dkl` atiende una petición a la vez; más copias que conexiones solo genera espera | | `activityTimeout`, `requestTimeout` | mayor o igual que `response_timeout_ms` (en segundos) | si IIS corta antes, el usuario ve un error de IIS en lugar del 504 de `iis2dkl` | 6. **Configure el sitio.** Copie `web.config.example` como `web.config` en la raíz del sitio (`C:\sitios\misitio\web.config`) y ajuste la ruta de `scriptProcessor`: ```xml ``` - `` y `path="*"` mandan **todas** las peticiones a Devkron, como `location /` en nginx; Devkron sirve también los archivos estáticos. - `scriptProcessor` debe coincidir **exactamente** con `fullPath` del paso 5 (si registró argumentos, van después de `|`, por ejemplo `C:\devkron\tools\iis2dkl\iis2dkl.exe|-c=misitio.conn.json`). - `existingResponse="PassThrough"` hace que IIS entregue tal cual las páginas de error de Devkron (404, 500, JSON de API). - El ejemplo de la distribución agrega `` para admitir subidas de hasta 100 MB (IIS permite unos 28.6 MB por omisión). - Si IIS responde **500.19** al cargar el sitio, la sección `handlers` está bloqueada: `%windir%\system32\inetsrv\appcmd unlock config -section:system.webServer/handlers`. 7. **Pruebe** desde el navegador con un host que la licencia admita (sin licencia, `127.0.0.1` o `*.localhost`) y revise la bitácora de `iis2dkl`: al arrancar registra su versión, el mapeo y la dirección del servidor FastCGI. ### Mapeo de variables `iis2dkl` trae incluido el mapeo que convierte las variables de IIS en las de nginx; no hace falta configurarlo. Si necesita agregar o quitar variables, `iis2dkl -dump-map` imprime el mapeo en uso: guárdelo como `iis2dkl.map.json` junto al ejecutable (o indíquelo con `-m=archivo`) y edítelo. El formato es el mismo que el de [dklwebsvr](/es/devkron/2.0/instalacion/dklwebsvr.md). `HTTP_HOST` y `SERVER_NAME` no se pueden reescribir. ### Varios sitios o varias configuraciones `iis2dkl` busca sus archivos con el nombre del ejecutable: si copia `iis2dkl.exe` como `sitio2.exe`, usará `sitio2.conn.json` y `sitio2.map.json`. También puede registrar el mismo ejecutable con `arguments='-c=sitio2.conn.json'` (y el mismo argumento en el `scriptProcessor` del `web.config`, después de `|`). ## Dónde quedan los sitios Igual que con nginx: los programas y archivos se buscan en `C:\devkron\web\\` (o `C:\devkron\web\` para el sitio predeterminado), no en la carpeta física del sitio de IIS. La carpeta del sitio en IIS solo necesita el `web.config`. Vea [Servidor FastCGI](/es/devkron/2.0/instalacion/fastcgi.md). ## Compatibilidad | | Devkron 1.x en Windows | Devkron 2.0 | |---|---|---| | Integración con IIS | controlador propio de IIS instalado con IWA | `iis2dkl` hacia el servidor FastCGI por TCP | | Versión de IIS | 8 o superior | 10 | | `@http_context` | el del controlador de IIS | el mismo que con nginx | | Requiere .NET Framework o ASP.NET | sí | no | Al migrar un sitio de IIS de 1.x a 2.0, quite el controlador de IWA del sitio y configure iis2dkl en su lugar. Vea [Migrar de 1.x a 2.0](/es/devkron/2.0/migracion/). ## Errores típicos | Síntoma | Causa | Solución | |---|---|---| | error de iis2dkl al abrir cualquier página | el servidor FastCGI de Devkron no está corriendo o escucha en otro puerto | levántelo y revise `iis2dkl.conn.json` | | error 500.0 de IIS que menciona FastCGI | el módulo CGI no está instalado o `web.config` apunta a otra ruta de `iis2dkl.exe` | instale CGI y revise la ruta | | 503 "Host no admitido por el servidor, se requiere una licencia." | el host del sitio no está en la licencia | [Licencia](/es/devkron/2.0/instalacion/licencia.md) | | 404 de Devkron | no hay carpeta `web\\` para ese host | cree la carpeta o use un alias de host |