Base de conocimientos
Los errores con los que la gente se encuentra realmente al usar la CLI de Zinnector® y la solución para cada uno: spawn EINVAL en Windows, la advertencia EBADENGINE de npm, node-gyp solicitando Visual Studio en Node 26, EPERM durante la instalación, un entorno de ejecución que no arranca y un puerto en uso.
Los errores que los usuarios realmente encuentran con la CLI de Zinnector®, qué significa cada uno y la solución. Cada entrada indica el texto exacto que usted verá, para que pueda buscarlo en esta página. Si el suyo no aparece aquí, ejecute el comando que falla con ZINNECTOR_DEBUG=1 y abra una incidencia en github.com/Zinn-Digital/zinnector/issues incluyendo la salida generada, su versión de node --version y su sistema operativo.
Un error en Zinnector® 0.1.0 y 0.1.1. En Windows, el instalador del entorno de ejecución ejecutaba npm.cmd por su nombre, y Node rechaza generar un subproceso para un archivo .cmd sin un shell desde su corrección para CVE-2024-27980; por lo tanto, la instalación fallaba un segundo después de que usted respondía Y. Corregido en 0.1.2: npm ahora se ejecuta como node npm-cli.js, lo cual es idéntico en todas las plataformas y no requiere shell. Ejecute npm install -g zinnector@latest y, a continuación, zinnector dev de nuevo.
Su versión de Node es anterior a la 24. npm muestra la advertencia porque el paquete declara engines: >=24.18.1; la instalación se completa de todos modos, pero zinnector luego se niega a iniciar (código de salida 78) en lugar de fallar más adelante de manera confusa. Instale la versión LTS actual desde nodejs.org —winget install OpenJS.NodeJS.LTS en Windows, brew install node@24 en macOS—, confirme que node --version muestre v24 o superior e instale Zinnector® nuevamente.
El entorno de ejecución de WordPress cuenta con un módulo nativo cuyos binarios precompilados solo existen para Node 24 y 25. En una versión más reciente de Node (26 en adelante, a partir de septiembre de 2026), su instalador recurre a compilar desde el código fuente, lo que en un equipo Windows estándar deriva en una solicitud para instalar Visual Studio. Corregido en 0.1.2: Zinnector® detecta esto antes de descargar nada y obtiene una versión de Node 24 exclusivamente para el entorno de ejecución —alrededor de 30 MB, verificados con las sumas de comprobación de nodejs.org—, por lo que nunca se compila nada. Si continúa viendo este error tras actualizar, ejecute zinnector dev --reset-runtime para descartar primero la instalación incompleta anterior.
Casi siempre se trata de un análisis del antivirus o de un indexador de búsqueda que mantiene un archivo abierto dentro del directorio node_modules del entorno de ejecución mientras npm intenta eliminarlo. La instalación se reintenta desde un directorio limpio en la siguiente ejecución de zinnector dev; si continúa ocurriendo, zinnector dev --reset-runtime elimina primero todo el directorio del entorno de ejecución y realiza la instalación de nuevo.
El mensaje incluye las últimas líneas generadas por el propio npm y el comando exacto que ejecutó Zinnector®, lo que le permite ejecutarlo usted mismo para revisar la salida completa. Las causas habituales son un problema de red o de proxy —el entorno de ejecución se descarga mediante su propia instalación de npm, por lo que aplican npm config set proxy … y cualquier réplica de registro que use— o bien una instalación anterior que quedó a medias, la cual se descarta con --reset-runtime.
Ejecute zinnector dev --verbose para ver la salida generada por el propio entorno de ejecución. El caso más común es un puerto que ya se encuentra en uso: utilice zinnector dev --port 9401 o configure la propiedad port en zinnector.json. Si un entorno de ejecución se instaló pero no arranca: zinnector dev --reset-runtime. El primer arranque también descarga WordPress, así que en una conexión lenta concédale unos minutos; la CLI espera hasta cinco minutos antes de reportar un tiempo de espera agotado en lugar de quedarse bloqueada.
Los despliegues se gestionan desde un repositorio, por lo que zinnector push necesita uno con un origen remoto accesible por la plataforma. Ejecute git init && git add -A && git commit -m initial, añada su remoto de GitHub o GitLab y, a continuación, ejecute zinnector link para conectarlo al sitio.
Ejecute zinnector check. En nueve de cada diez casos se trata de una discrepancia entre versiones de PHP —usted compiló en una versión de PHP más reciente que la que ejecuta el entorno— y el informe detalla a qué versión cambiar el espacio con zinnector php <version>, o con cuál desarrollar mediante zinnector dev --php <version>. El comando zinnector logs --error muestra el error crítico directamente.
Lo que hemos estado escribiendo sobre alojamiento, SEO y gestión de sitios a gran escala.
Cómo el alojamiento web influye en la indexación y la autoridad de enlaces en 2026: mantener las páginas indexadas, examinar dominios antiguos antes de desarrollarlos, crear enlaces sin dejar rastro de búsqueda y una perspectiva honesta sobre lo que la infraestructura puede y no puede hacer por el SEO.
Leer la publicación →Una lista de verificación práctica para un WordPress rápido y seguro: almacenamiento en caché a nivel de servidor, una caché de objetos por sitio, el puñado de plugins que vale la pena usar, mantener el paquete de software actualizado y las páginas de WooCommerce que nunca debe almacenar en caché.
Leer la publicación →Qué diferencia realmente a un buen alojamiento administrado de una caja barata con panel de control —migraciones, copias de seguridad, aislamiento, almacenamiento en caché real y escalabilidad honesta— y cómo juzgarlo antes de comprometerse.
Leer la publicación →El soporte técnico está incluido en todos los planes, el servicio de atención está disponible 24 horas al día y puede escribirnos en cualquiera de nuestros 58 idiomas; le responderemos en el suyo.
Contactar con soporte técnico → Todos los artículos →