# 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 |