Guia de Solução de Problemas do Ghost CMS: WSL, Docker e ActivityPub
Resolva erros comuns de instalação do Ghost CMS com
Guia de Solução de Problemas do Ghost CMS: WSL, Docker e ActivityPub
20 de março de 2026
Configurar o Ghost CMS (Sistema de Gerenciamento de Conteúdo) localmente é uma ótima maneira de desenvolver temas e testar novos recursos. No entanto, ao usar o Windows ou Docker, você pode encontrar erros que interrompem seu progresso. A depuração consome tempo valioso, desviando o foco do seu trabalho principal.
Este guia oferece as causas e soluções para três erros comuns do Ghost CMS:
- Erro 1: Falhas na instalação do SQLite no Windows.
- Erro 2: Contêineres Docker travando com o código 137 (limites de memória).
- Erro 3: Erros de "Carregamento Interrompido" na guia ActivityPub Network.
Ao final deste artigo, você terá uma configuração local do Ghost estável e funcional. Saberá como usar corretamente o WSL para aplicativos Node.js, gerenciar recursos do Docker e configurar com sucesso os novos recursos sociais do Ghost.
Erro 1: Falhas na Instalação do SQLite no Windows
O Sintoma
Ao executar o comando ghost install local em uma máquina Windows, a instalação falha, exibindo uma longa lista de texto vermelho no terminal, semelhante a:
plaintext Error: Cannot find module 'sqlite3' ... node-pre-gyp ERR! stack Error: Failed to execute... ... MSB4019: The imported project "C:\Microsoft.Cpp.Default.props" was not found.
O erro geralmente menciona "sqlite3" e indica que "falhou ao executar" ou está "ausente".
A Causa
O Ghost usa o SQLite para armazenar os dados do seu blog. O SQLite é um "módulo nativo", o que significa que precisa de um pequeno código compilado especificamente para o seu sistema.
Como o Ghost foi projetado para rodar em servidores Linux, ele espera encontrar ferramentas de compilação Linux para criar esses arquivos. O Windows usa ferramentas diferentes e uma organização de arquivos distinta. Quando o Ghost CLI tenta compilar os arquivos SQLite no Windows, não encontra as ferramentas necessárias, interrompendo a instalação. Usar o WSL fornece ao Ghost o ambiente Linux esperado.
Como Corrigir:
Você pode usar o Subsistema Windows para Linux (WSL) para criar uma configuração funcional.
- Abra seu terminal WSL (como Ubuntu).
- Verifique suas ferramentas executando
node --version,npm --versionepython3 --version. - Instale o Ghost CLI globalmente dentro do WSL:
plaintext npm install -g ghost-cli@latest
- Execute o comando de instalação local:
plaintext ghost install local
- Inicie o servidor:
plaintext ghost start
Como Verificar:
Abra seu navegador e acesse http://localhost:2368. A página de boas-vindas padrão do Ghost deve carregar sem erros.
Erro 2: Contêiner Docker Sair com Código 137
O Sintoma:
Ao executar o Ghost usando o Docker Compose, os contêineres travam. Os logs do terminal mostram Ghost admin container exiting with code 137 ou Admin service killed due to memory constraints.
A Causa:
O código de erro 137 indica que seu computador ficou sem memória (RAM) e interrompeu o contêiner. Isso geralmente ocorre ao tentar executar a configuração completa do Ghost (que inclui mais de 15 ferramentas adicionais) em um computador comum.
Como Corrigir:
Para corrigir este erro, altere a configuração complexa para uma configuração simples usando a imagem oficial do Docker do Ghost.
Primeiro, pare e remova os contêineres com falha:
plaintext docker-compose down -v docker system prune -a
Em seguida, crie um novo arquivo docker-compose.yml com apenas as ferramentas básicas (Ghost e um banco de dados):
plaintext services: ghost: image: ghost:latest restart: always ports: - "2368:2368" environment: database__client: mysql database__connection__host: mysql database__connection__user: root database__connection__password: yourpassword database__connection__database: ghost url: http://localhost:2368 volumes: - ghost_content:/var/lib/ghost/content
mysql: image: mysql:8.0 restart: always environment: MYSQL_ROOT_PASSWORD: yourpassword MYSQL_DATABASE: ghost volumes: - mysql_data:/var/lib/mysql
volumes: ghost_content: mysql_data:
Em seguida, inicie a configuração simples:
plaintext docker-compose up -d
Como Verificar:
Digite docker-compose ps no terminal. Você deve ver os contêineres ghost e mysql listados com o status "Up".
Erro 3: "Carregamento Interrompido" na Análise de Rede
O Sintoma:
Ao clicar na guia Análise → Rede no painel de administração local do Ghost, a página exibe um erro de "Carregamento Interrompido". Os logs do terminal mostram erros 404 e falhas de webhook:
plaintext INFO "GET /.ghost/activitypub/v1/feed/reader/" 404 52ms ERROR No webhook secret found - cannot initialise
A Causa:
A guia Rede atua como um leitor ActivityPub, não como um painel de análise normal. Esse erro ocorre porque o ActivityPub não está configurado para uso local. Ele precisa de ferramentas adicionais (Caddy, Redis) e de um endereço da web limpo sem números de porta para funcionar.
Como Corrigir:
Para corrigir este erro, execute o Ghost com suas ferramentas Docker necessárias e atualize seu arquivo de configuração local para ativar os recursos sociais da web.
Primeiro, inicie as ferramentas necessárias (Caddy, MySQL, Redis) da sua pasta Ghost:
plaintext SSH_AUTH_SOCK=/dev/null docker compose up -d caddy mysql redis
Em seguida, abra seu arquivo config.local.json. Defina a URL para um endereço localhost limpo (remova a porta :2368) e ative os recursos de desenvolvedor:
plaintext { "url": "http://localhost", "social_web_enabled": true, "enableDeveloperExperiments": true }
Pare seu processo Ghost atual:
plaintext pkill -f "yarn dev:ghost"
E reinicie o Ghost com as novas configurações:
plaintext yarn dev:ghost
Como Verificar:
Faça login novamente no painel de administração do Ghost e clique em Análise → Rede. A mensagem de erro desaparecerá e você verá o feed ActivityPub em vez dela.
Conclusão
Configurações locais podem ser desafiadoras, especialmente ao combinar Windows, Docker e novos recursos como ActivityPub.
Ao corrigir esses três erros, você fez mais do que apenas obter o Ghost funcionando. Você aprendeu como contornar as limitações do Windows usando o WSL, como gerenciar a memória do Docker e como o Ghost encaminha o tráfego da web social.
Agora você tem um espaço de trabalho do Ghost CMS estável, rápido e totalmente funcional, pronto para o seu conteúdo. Com a Toolzz LXP, você pode escalar o aprendizado e o desenvolvimento da sua equipe de forma eficiente e centralizada.
Quer ver como a Toolzz LXP pode impulsionar o conhecimento da sua equipe?
Solicitar demonstração da Toolzz LXP
Demonstração LXP
Experimente uma demonstração interativa da nossa plataforma LXP e descubra como podemos transformar o aprendizado na sua organização.
.webp){kind=small}
