--- title: "Solução de problemas" description: "Solução de problemas do Éclair CMS: senha esquecida, instalação bloqueada, erro 404 ou 500, imagens não convertidas, e-mails ausentes, depuração e proxy." url: "https://eclaircms.org/pt/documentacao/solucao-de-problemas" lang: "pt" author: "Thierry Gustin" published: "2026-10-30" updated: "2026-10-31" --- # Solução de problemas > **O essencial** — Este guia de solução de problemas do Éclair CMS traz a solução para os problemas mais frequentes: senha esquecida ou celular da 2FA perdido (arquivo data/reset.php), instalação bloqueada depois de 2 horas, erro 404 por falta do .htaccess, erro 500, imagens não convertidas para WebP, e-mails do formulário não recebidos, modo de depuração e endereço IP distorcido por um proxy. Este guia de solução de problemas do Éclair CMS reúne os problemas mais frequentes e as respectivas soluções, da senha esquecida ao erro 404. Cada seção corresponde a uma mensagem ou a um sintoma preciso: use o índice para ir direto ao seu. A maioria se resolve em dois minutos, com o seu programa de FTP ou o gerenciador de arquivos da hospedagem. ## Esqueceu a senha ou perdeu o celular da autenticação de dois fatores? Comece pelas soluções mais simples: - **Existe outro administrador**: em Usuários, ele pode clicar em **Redefinir senha** (uma senha temporária é criada) ou em **Desativar 2FA** na sua conta. - **Você perdeu o celular, mas não os códigos**: entre com um dos seus 8 códigos de recuperação no lugar do código de 6 dígitos. Se você é o único administrador, use a recuperação por FTP. Crie um arquivo `data/reset.php` com exatamente estas três linhas: ```text seu-endereco@email.com.br SuaNovaSenha2026 ``` Em até 24 horas, **faça login com esse e-mail e essa nova senha**. A senha é substituída, a autenticação de dois fatores dessa conta é desativada, suas outras sessões são encerradas e o arquivo é apagado automaticamente. > **Por que é seguro** — Ninguém mais consegue acionar essa recuperação: é preciso ter acesso por FTP para colocar o arquivo e conhecer o conteúdo dele para usá-lo. Um arquivo sem a primeira linha é recusado e apagado. A nova senha precisa respeitar as regras de sempre: no mínimo 10 caracteres, nada de senha comum demais. ## “Instalação bloqueada”: o que fazer? Por segurança, a instalação precisa ser feita nas **2 horas** seguintes à primeira visita: caso contrário, qualquer pessoa poderia assumir o controle de um site enviado e esquecido. Passado esse prazo, apague o arquivo `data/install-window.php` por FTP e recarregue a página: uma nova janela de 2 horas se abre. ## O que significa “Endereço do site não verificado” na página Segurança? Seu servidor não consegue chamar a si mesmo no endereço do site: firewall da hospedagem, DNS ainda não propagado, domínio em transferência… O site funciona normalmente, mas sem redirecionamento para o endereço oficial (com ou sem www, http para https). Clique em **Verificar endereço do site** quando o domínio estiver pronto. ## Por que um erro 404 em todas as páginas, menos a inicial? O arquivo `.htaccess` não foi enviado, por ser um arquivo oculto, ou a reescrita de URL está desativada. Ative “Mostrar arquivos ocultos” no seu programa de FTP e envie-o de novo para a raiz do site. Se a sua hospedagem exigir, tire o comentário da linha `RewriteBase /` do `.htaccess`. > **O diagnóstico do instalador** — Durante a instalação, a linha “URLs amigáveis (reescrita de URL)” já indica se o `.htaccess` funciona. No Nginx, que ignora esse arquivo, copie a configuração do guia [Para desenvolvedores](https://eclaircms.org/pt/documentacao/desenvolvedores). ## O que fazer diante de um erro 500 logo depois do envio? Sua hospedagem recusa uma diretiva do `.htaccess`. É muito raro: só são usadas diretivas aceitas em hospedagens compartilhadas. Remova o bloco em questão ou fale com a sua hospedagem. Se aparecer a página “Oups, un court-circuit.” (em francês, “Ops, um curto-circuito”) com uma referência, os detalhes do erro estão em **Segurança › Últimos erros técnicos**. ## Por que as imagens não são convertidas para WebP? A extensão GD do PHP, ou o suporte dela ao WebP, não existe na sua hospedagem. Ative-a no painel de PHP da sua hospedagem. Enquanto isso, suas imagens continuam em JPG ou PNG: o site funciona, só fica um pouco menos leve. ## Por que não recebo os e-mails do formulário? Sem pânico: as mensagens também ficam salvas na administração, no menu **Mensagens**. Depois confira o endereço de recebimento em **Configurações › Contato** (campo **Receber as mensagens no endereço**); por padrão, é o e-mail do primeiro administrador. Algumas hospedagens exigem que o remetente pertença ao domínio do site: crie um endereço de e-mail no seu domínio, se for preciso. ## Como ativar o modo de depuração? Crie um arquivo `eclair-config.php` na raiz do site, ao lado do `index.php`, seguindo o modelo de `eclair-config.exemple.php`: ```php **Somente se for necessário** — Deixe “Não (recomendado)” se o seu site não está atrás de um proxy: caso contrário, um visitante poderia informar um endereço IP falso. O Éclair lê apenas o último endereço do cabeçalho, o que foi acrescentado pelo proxy. ## O Éclair diz que precisa do PHP 8.1 ou superior? Se a página mostrar “Éclair a besoin de PHP 8.1 ou plus récent” (em francês, “o Éclair precisa do PHP 8.1 ou superior”), sua hospedagem usa uma versão do PHP antiga demais. Troque-a na área do cliente da sua hospedagem, muitas vezes com um clique, e recarregue a página. O Éclair funciona do PHP 8.1 ao 8.5; escolha o 8.3 ou superior, se possível. O guia [Instalar o Éclair na o2switch](https://eclaircms.org/pt/instalacao/o2switch) mostra onde fica essa configuração no cPanel. ## O assistente de IA não responde? Chave recusada, crédito esgotado, orçamento do mês atingido, conexões de saída bloqueadas: cada mensagem tem a sua solução no guia do [assistente de IA](https://eclaircms.org/pt/documentacao/assistente-ia#if-the-assistant-does-not-respond). ## Seu problema não está neste guia de solução de problemas do Éclair CMS? Anote a mensagem de erro exata, a sua hospedagem e a sua versão do PHP e depois escreva para mim pela página [Contato](https://eclaircms.org/pt/contato). Você também pode relatar um problema no [GitHub](https://github.com/Jacckisback/eclair-cms/issues): a solução dele vai enriquecer este guia de solução de problemas do Éclair CMS para todos os usuários. ## Perguntas de solução de problemas ### O arquivo data/reset.php funciona se eu ativei a autenticação de dois fatores? Sim. O login com o e-mail e a nova senha do arquivo desativa a autenticação de dois fatores dessa conta. Ative-a de novo depois, em Meu perfil. ### Onde encontro arquivos ocultos como o .htaccess? No seu programa de FTP, ative a opção “Mostrar arquivos ocultos”. No File Manager do cPanel (*Gestionnaire de fichiers*), fica em Settings (*Paramètres*) › “Show Hidden Files (dotfiles)” (*Afficher les fichiers masqués*). ### Como saber qual erro ocorreu? Abra Segurança › Últimos erros técnicos ou ative temporariamente o modo de depuração com um arquivo eclair-config.php. Lembre-se de apagá-lo depois. ### Meu site mostra uma página em branco: por onde começar? Confira a versão do PHP (mínimo 8.1) e depois ative o modo de depuração para exibir o erro. Na maioria dos casos, falta um arquivo ou uma extensão do PHP.