Versiones compatibles de Windows
zqagent para Windows tiene tres formas: CLI de archivo único, app de escritorio e instalación por npm. Los requisitos difieren; la siguiente tabla es la matriz completa de compatibilidad.
Matriz de compatibilidad
| Versión de Windows | CLI de archivo único | App de escritorio | Instalación npm |
|---|---|---|---|
| Windows 11 | ✅ | ✅ | ✅ |
| Windows 10 1709 o superior | ✅ | ✅ | ✅ |
| Windows 10 Enterprise LTSC 2019 / 2021 | ✅ | ✅ | ✅ |
| Windows 10 Enterprise LTSC 2015 / 2016 | ✅ | ✅ | ✅ |
| Windows 10 1507 – 1703 (edición normal) | ✅ | ❌ | ✅ |
| Windows 8.1 / Server 2012 R2 | ❌ sin garantía | ❌ | ⚠️ sin verificar |
| Windows 8 / Server 2012 | ❌ | ❌ | ❌ |
| Windows 7 / Server 2008 R2 | ❌ | ❌ | ❌ |
| Windows Server 2016 / 2019 / 2022 | ✅ | ⚠️ requiere Experiencia de escritorio | ✅ |
| Windows de 32 bits (x86) | ❌ sin artefactos | ❌ | ⚠️ sin verificar |
Solo hay artefactos de 64 bits (x64) y ARM64. Para Windows de 32 bits, usa otra máquina.
El umbral de la versión de escritorio en Windows 10 es 1709
Lo que decide si se puede instalar la versión de escritorio no es el número de versión de Windows, sino el runtime WebView2: admite Windows 10 SAC 1709 o superior y Enterprise LTSC 2015 / 2016 / 2019 / 2021. Por eso LTSC 2015 (base 1507) y LTSC 2016 (base 1607), aunque su número sea anterior a 1709, sí pueden instalar la versión de escritorio; las ediciones normales con esos mismos números (1511 / 1607 / 1703) no. El UA del navegador no distingue LTSC de la edición normal, así que el sitio no recomienda la versión de escritorio para esas dos versiones; decide con esta tabla.
Windows 10 finalizó su soporte el 2025-10-14
Windows 10 (Home / Pro) deja de recibir actualizaciones de seguridad de Microsoft desde esa fecha; 22H2 es la última versión. El funcionamiento técnico no se ve afectado, pero si se manejan datos sensibles conviene actualizar a Windows 11. Las versiones Enterprise / IoT LTSC siguen recibiendo actualizaciones según su ciclo de servicio a largo plazo.
Por qué Windows 7 / 8 / 8.1 no funcionan
No es un problema de «falta un runtime en el instalador», sino de API del sistema operativo ausentes:
- El CLI de archivo único incluye el runtime de Node.js 22, que importa estáticamente
GetSystemTimePreciseAsFileTime(desde Windows 8) y busca primitivas de sincronización comoWaitOnAddress, también de Win8. En Windows 7, el cargador del sistema rechaza el programa antes de ejecutarse: «No se encuentra el punto de entrada del procedimiento». - El ripgrep integrado depende de
api-ms-win-core-synch-l1-2-0.dll, también disponible desde Windows 8. - La app de escritorio necesita, además del runtime de Node, el runtime WebView2, y WebView2 (que sigue a Microsoft Edge) dejó de admitir Windows 7 / 8 / 8.1 y Server 2008 R2 / 2012 / 2012 R2 desde Edge 109 (2023-01).
Por tanto, instalar el runtime de Visual C++ (UCRT / VC++ Redistributable) no lo resuelve: los binarios oficiales de Node enlazan estáticamente el runtime de C y no cargan UCRT; lo que falta son funciones del kernel32, que ningún runtime puede suplir.
Si tienes una máquina antigua
Instala zqagent en otro equipo (o servidor) que cumpla los requisitos y accede a su consola desde el navegador de la máquina antigua:
http://<IP del nuevo host>:8787Así la máquina antigua solo hace de navegador y no necesita ejecutar ningún componente de zqagent.
Requisitos adicionales de la app de escritorio
| Dependencia | Requisito |
|---|---|
| Runtime WebView2 | Windows 10 1709+ / Windows Server 2016+; Win11 lo incluye |
| Runtime de Node | Incluido en la versión de escritorio; no hay que instalarlo aparte |
| Arquitectura | x64 o ARM64 |
En Windows Server hay que instalar la función Experiencia de escritorio desde el «Administrador del servidor» para tener la interfaz gráfica completa.