Base de conhecimento
Os erros que as pessoas realmente encontram com o CLI do Zinnector® e a solução para cada um: spawn EINVAL no Windows, aviso EBADENGINE do npm, node-gyp solicitando o Visual Studio no Node 26, EPERM durante a instalação, um runtime que não inicializa e uma porta em uso.
Os erros que as pessoas realmente encontram com a CLI do Zinnector®, o que cada um significa e a solução. Cada entrada indica o texto exato que você verá, para que possa pesquisar nesta página por ele. Se o seu erro não estiver aqui, execute o comando com falha com ZINNECTOR_DEBUG=1 e abra uma issue em github.com/Zinn-Digital/zinnector/issues com a saída, a sua versão do node --version e o seu sistema operacional.
Um bug no Zinnector® 0.1.0 e 0.1.1. No Windows, o instalador do runtime executava o npm.cmd pelo nome, e o Node se recusa a gerar um arquivo .cmd sem um shell desde a sua correção para o CVE-2024-27980 — portanto, a instalação falhava um segundo após você responder Y. Corrigido na versão 0.1.2: o npm agora é executado como node npm-cli.js, o que é idêntico em todas as plataformas e não precisa de shell. Execute npm install -g zinnector@latest e, em seguida, zinnector dev novamente.
A sua versão do Node é anterior à 24. O npm exibe o aviso porque o pacote declara engines: >=24.18.1; a instalação é concluída de qualquer forma, mas o zinnector se recusa a iniciar (código de saída 78) em vez de falhar de maneira confusa mais adiante. Instale a versão LTS atual a partir de nodejs.org — winget install OpenJS.NodeJS.LTS no Windows, brew install node@24 no macOS —, confirme se node --version exibe v24 ou superior e instale o Zinnector® novamente.
O runtime do WordPress possui um módulo nativo cujos binários pré-compilados existem apenas para o Node 24 e 25. Em uma versão mais recente do Node (26 ou superior, a partir de setembro de 2026), o seu instalador recorre à compilação a partir do código-fonte, o que em uma máquina Windows padrão resulta em uma solicitação do Visual Studio. Corrigido na versão 0.1.2: o Zinnector® detecta isso antes de baixar qualquer coisa e obtém um Node 24 exclusivamente para o runtime — cerca de 30 MB, verificado contra os checksums do nodejs.org —, de modo que nada precise ser compilado. Se ainda visualizar isso após a atualização, execute zinnector dev --reset-runtime para que a instalação incompleta anterior seja descartada primeiro.
Quase sempre é um antivírus ou um indexador de pesquisa mantendo um arquivo aberto sob o node_modules do runtime enquanto o npm tenta removê-lo. A instalação é tentada novamente a partir de um diretório limpo no próximo zinnector dev; se continuar ocorrendo, zinnector dev --reset-runtime remove primeiro todo o diretório do runtime e instala novamente.
A mensagem inclui as últimas linhas do próprio npm e o comando exato que o Zinnector® executou, para que você possa executá-lo manualmente e visualizar a saída completa. As causas comuns são problemas de rede ou de proxy — o runtime é obtido com o seu próprio npm, portanto, npm config set proxy … e um espelho de registro se aplicam — ou uma instalação anterior incompleta, a qual o --reset-runtime limpa.
Execute zinnector dev --verbose para visualizar a saída do próprio runtime. Uma porta já em uso é a causa comum: zinnector dev --port 9401, ou defina port em zinnector.json. Para um runtime que foi instalado mas não inicializa: zinnector dev --reset-runtime. A primeira inicialização também baixa o próprio WordPress; portanto, em uma conexão lenta, aguarde alguns minutos; a CLI espera até cinco minutos antes de relatar um tempo limite esgotado em vez de travar.
As implantações são realizadas a partir de um repositório, portanto, o zinnector push precisa de um com um remoto que a plataforma possa acessar. Execute git init && git add -A && git commit -m initial, adicione o seu remoto do GitHub ou GitLab e, em seguida, utilize zinnector link para conectá-lo ao site.
Execute zinnector check. Em nove de cada dez casos, trata-se de uma incompatibilidade de versão do PHP — o projeto foi compilado em uma versão do PHP mais recente do que a utilizada pelo slot —, e o relatório indica para qual versão alterar o slot com zinnector php <version>, ou com qual desenvolver utilizando zinnector dev --php <version>. O comando zinnector logs --error exibe o próprio erro fatal.
O que temos escrito sobre hospedagem, SEO e gerenciamento de sites em grande escala.
Como a hospedagem molda a indexação e o link equity em 2026: mantendo páginas indexadas, avaliando domínios antigos antes de utilizá-los, criando links sem deixar pegadas (footprint) e uma visão honesta sobre o que a infraestrutura pode e não pode fazer pelo SEO.
Ler o artigo →Um checklist prático para um WordPress rápido e seguro: cache no nível do servidor, cache de objetos por site, os poucos plugins que realmente valem a pena, manutenção do stack atualizado e as páginas do WooCommerce que você nunca deve armazenar em cache.
Ler o artigo →O que realmente separa uma boa hospedagem gerenciada de uma máquina barata com painel de controle — migrações, backups, isolamento, cache real e escalabilidade honesta — e como avaliar isso antes de assumir um compromisso.
Ler o artigo →O suporte está incluído em todos os planos, o atendimento funciona 24 horas por dia e você pode nos escrever em qualquer um dos nossos 58 idiomas — nós respondemos no seu.
Entrar em contato com o suporte → Todos os artigos →