--- title: "Solución de problemas" description: "Solución de problemas de Éclair CMS: contraseña olvidada, instalación bloqueada, errores 404 y 500, imágenes sin convertir, correos que no llegan y proxy." url: "https://eclaircms.org/es/documentacion/solucion-de-problemas" lang: "es" author: "Thierry Gustin" published: "2026-10-30" updated: "2026-10-31" --- # Solución de problemas > **Lo esencial** — Esta guía de solución de problemas de Éclair CMS ofrece la respuesta a los problemas más frecuentes: contraseña olvidada o móvil de la 2FA perdido (archivo data/reset.php), instalación bloqueada tras 2 horas, error 404 por un .htaccess ausente, error 500, imágenes sin convertir a WebP, correos del formulario que no llegan, modo de depuración y dirección IP falseada por un proxy. Esta guía de solución de problemas de Éclair CMS reúne los problemas más frecuentes y su solución, desde la contraseña olvidada hasta el error 404. Cada sección corresponde a un mensaje o a un síntoma concreto: usa el índice para ir directo al tuyo. La mayoría se arreglan en dos minutos, con tu programa FTP o con el gestor de archivos de tu hosting. ## ¿Has olvidado tu contraseña o perdido el móvil de la verificación en dos pasos? Empieza por las soluciones más sencillas: - **Existe otro administrador**: en Usuarios, puede hacer clic en **Restablecer la contraseña** (se crea una contraseña provisional) o en **Desactivar la 2FA** de tu cuenta. - **Has perdido el móvil, pero no tus códigos**: inicia sesión con uno de tus 8 códigos de recuperación en lugar del código de 6 cifras. Si eres el único administrador, usa el rescate por FTP. Crea un archivo `data/reset.php` que contenga exactamente estas tres líneas: ```text tu-direccion@ejemplo.es TuNuevaClave2026 ``` En las 24 horas siguientes, **inicia sesión con ese correo y esa nueva contraseña**. La contraseña se sustituye, la verificación en dos pasos de esa cuenta se desactiva, tus demás sesiones se cierran y el archivo se borra automáticamente. > **Por qué es seguro** — Nadie más puede activar este rescate: hace falta acceso por FTP para dejar el archivo y conocer su contenido para usarlo. Un archivo sin la primera línea se rechaza y se borra. La nueva contraseña debe cumplir las reglas habituales: 10 caracteres como mínimo, ninguna contraseña demasiado común. ## «Instalación bloqueada»: ¿qué hacer? Por seguridad, la instalación debe hacerse en las **2 horas** siguientes a la primera visita: si no, cualquiera podría apropiarse de un sitio subido y olvidado. Pasado ese plazo, borra el archivo `data/install-window.php` por FTP y recarga la página: se abre una nueva ventana de 2 horas. ## ¿Qué significa «Dirección del sitio sin verificar» en la página Seguridad? Tu servidor no consigue llamarse a sí mismo en la dirección del sitio: cortafuegos del proveedor, DNS aún sin propagar, dominio en proceso de transferencia… El sitio funciona con normalidad, pero sin redirección a la dirección oficial (con o sin www, de http a https). Haz clic en **Verificar la dirección del sitio** cuando el dominio esté listo. ## ¿Por qué hay un error 404 en todas las páginas salvo la de inicio? El archivo `.htaccess` no se ha subido, porque es un archivo oculto, o la reescritura de URL está desactivada. Activa «Mostrar archivos ocultos» en tu programa FTP y vuelve a subirlo a la raíz del sitio. Si tu proveedor lo exige, quita el comentario de la línea `RewriteBase /` del `.htaccess`. > **El diagnóstico del instalador** — Durante la instalación, la línea «URL limpias (reescritura de URL)» ya indica si el `.htaccess` funciona. En Nginx, que ignora ese archivo, copia la configuración de la guía [Para desarrolladores](https://eclaircms.org/es/documentacion/desarrolladores). ## ¿Qué hacer ante un error 500 justo después de subir los archivos? Tu proveedor rechaza una directiva del `.htaccess`. Es muy raro: solo se usan directivas admitidas en los hostings compartidos. Elimina el bloque en cuestión o contacta con tu proveedor. Si aparece la página «Oups, un court-circuit.» (en francés, «Vaya, un cortocircuito») con una referencia, el detalle del error está en **Seguridad › Últimos errores técnicos**. ## ¿Por qué no se convierten las imágenes a WebP? En tu hosting falta la extensión PHP GD, o su compatibilidad con WebP. Actívala en el panel PHP de tu proveedor. Mientras tanto, tus imágenes se quedan en JPG o PNG: el sitio funciona, solo es un poco menos ligero. ## ¿Por qué no recibo los correos del formulario? No te preocupes: los mensajes también se guardan en la administración, en el menú **Mensajes**. Revisa después la dirección de recepción, en el campo **Recibir los mensajes en** de **Ajustes › Contacto**; por defecto, es el correo del primer administrador. Algunos proveedores exigen que el remitente pertenezca al dominio del sitio: crea una dirección de correo en tu dominio si hace falta. ## ¿Cómo activar el modo de depuración? Crea un archivo `eclair-config.php` en la raíz del sitio, junto a `index.php`, siguiendo el modelo de `eclair-config.exemple.php`: ```php **Solo si es necesario** — Deja «No (recomendado)» si tu sitio no está detrás de un proxy: de lo contrario, un visitante podría proporcionar una dirección IP falsa. Éclair solo lee la última dirección de la cabecera, la que añade el proxy. ## ¿Éclair dice que necesita PHP 8.1 o superior? Si la página muestra «Éclair a besoin de PHP 8.1 ou plus récent» (en francés, «Éclair necesita PHP 8.1 o superior»), tu hosting usa una versión de PHP demasiado antigua. Cámbiala en el área de cliente de tu proveedor, a menudo con un clic, y recarga la página. Éclair funciona de PHP 8.1 a 8.5; elige 8.3 o superior si puedes. La guía [Instalar Éclair en o2switch](https://eclaircms.org/es/instalacion/o2switch) muestra dónde está este ajuste en cPanel. ## ¿El asistente IA no responde? Clave rechazada, crédito agotado, presupuesto del mes alcanzado, conexiones salientes bloqueadas: cada mensaje tiene su solución en la guía del [asistente IA](https://eclaircms.org/es/documentacion/asistente-ia#if-the-assistant-does-not-respond). ## ¿Tu problema no está en esta guía de solución de problemas de Éclair CMS? Anota el mensaje de error exacto, tu proveedor de hosting y tu versión de PHP, y escríbeme a través de la página de [Contacto](https://eclaircms.org/es/contacto). También puedes comunicar un problema en [GitHub](https://github.com/Jacckisback/eclair-cms/issues): su resolución servirá para mejorar esta guía de solución de problemas de Éclair CMS para todos los usuarios. ## Preguntas sobre la solución de problemas ### ¿Funciona el archivo data/reset.php si he activado la verificación en dos pasos? Sí. Iniciar sesión con el correo y la nueva contraseña del archivo desactiva la verificación en dos pasos de esa cuenta. Vuelve a activarla después en Mi perfil. ### ¿Dónde encuentro los archivos ocultos como .htaccess? En tu programa FTP, activa la opción «Mostrar archivos ocultos». En el Administrador de archivos de cPanel, está en Configuración › «Mostrar archivos ocultos (dotfiles)». ### ¿Cómo sé qué error se ha producido? Abre Seguridad › Últimos errores técnicos, o activa temporalmente el modo de depuración con un archivo eclair-config.php. Acuérdate de borrarlo después. ### Mi sitio muestra una página en blanco: ¿por dónde empiezo? Comprueba la versión de PHP (8.1 como mínimo) y activa después el modo de depuración para que se muestre el error. En la mayoría de los casos, falta un archivo o una extensión de PHP.