Solucionar problemas comunes del sitio

Esta guía reúne comprobaciones seguras para los problemas más frecuentes de un sitio alojado en DirectAdmin. Empieza por identificar el síntoma y cambia una sola cosa a la vez.

Antes de editar archivos, PHP, DNS o bases de datos, crea un respaldo. Anota cada cambio para poder revertirlo.

Comprobación rápida

1. Abre el sitio en una ventana privada.
2. Comprueba si falla una sola página o todo el dominio.
3. Revisa si el problema ocurre con HTTP, HTTPS o ambos.
4. Confirma el dominio seleccionado en DirectAdmin.
5. Piensa qué cambió justo antes del error: archivos, complemento, PHP, DNS o certificado.
6. Revisa el espacio en disco y el uso de recursos.

El sitio muestra contenido antiguo

Normalmente se debe a una caché. Prueba en este orden:

1. Abre la página en una ventana privada.
2. Fuerza la recarga del navegador.
3. Limpia la caché de la aplicación o de su complemento.
4. Si utilizas una CDN, limpia también su caché.
5. Si la aplicación no es compatible con LiteSpeed Cache, desactiva esa caché desde .htaccess como se explica más adelante.

No edites varias capas de caché al mismo tiempo. Así podrás identificar cuál causaba el problema.

Desactivar LiteSpeed Cache desde .htaccess

El Web Hosting de Teramont utiliza LiteSpeed. Algunas aplicaciones o páginas dinámicas no son compatibles con la caché de página de LiteSpeed. Los síntomas pueden incluir:

• Sesiones que se mezclan o se cierran.
• Carritos que muestran productos incorrectos.
• Paneles privados con información desactualizada.
• Formularios que repiten resultados anteriores.
• Cambios que no aparecen aunque se haya limpiado la caché del navegador.

Desactivar LiteSpeed Cache no desactiva LiteSpeed ni cambia el servidor web. Solamente impide que LSCache entregue una copia almacenada de las páginas indicadas.

Desactivar la caché para todo el sitio

1. Abre Información y archivos → Administrador de archivos.
2. Entra en domains/tudominio.com/public_html.
3. Activa la visualización de archivos ocultos si .htaccess no aparece.
4. Descarga una copia de .htaccess antes de editarlo.
5. Agrega estas líneas:

<IfModule LiteSpeed>
    CacheDisable public /
</IfModule>

6. Guarda el archivo.
7. Purga la caché de la aplicación o del complemento LiteSpeed Cache, si existe.
8. Prueba el sitio en una ventana privada.

La directiva CacheDisable public / desactiva la caché pública desde la raíz del sitio. LiteSpeed recomienda envolver sus directivas en <IfModule LiteSpeed> para evitar incompatibilidades con otros servidores. Consulta la documentación oficial de controles de LSCache.

Desactivar la caché solamente para una ruta

Si el resto del sitio funciona correctamente, limita el cambio a la sección incompatible. Por ejemplo, para no almacenar las páginas bajo /panel/:

<IfModule LiteSpeed>
    CacheDisable public /panel/
</IfModule>

Reemplaza /panel/ por la ruta real. Conserva las barras inicial y final para que el alcance sea claro.

Revertir el cambio

Elimina únicamente el bloque que agregaste y vuelve a purgar la caché. Si el sitio muestra un error 500 después de editar .htaccess, restaura inmediatamente la copia anterior.

Si utilizas WordPress con el complemento LiteSpeed Cache, revisa también sus exclusiones y la opción Force Cache URIs. Una regla generada por la aplicación puede cambiar el comportamiento esperado.

Error 500 o pantalla en blanco

Este error suele estar relacionado con PHP, .htaccess o una aplicación dañada.

1. Revierte el último cambio realizado.
2. Revisa Información y archivos → Site summary & logs.
3. Busca el registro de errores más reciente siguiendo la guía Revisar los registros del sitio.
4. Comprueba que la versión de PHP sea compatible con la aplicación.
5. Revisa la sintaxis de .htaccess si fue modificado.
6. Desactiva temporalmente el complemento o módulo que se actualizó antes del error.

No actives display_errors permanentemente en producción. Puede mostrar rutas, consultas y otros datos internos. Utiliza los registros de errores.

Error 403: acceso prohibido

Comprueba:

• Que las carpetas normalmente tengan permisos 755 y los archivos 644.
• Que exista un archivo inicial como index.html o index.php.
• Que el archivo pertenezca al usuario correcto del hosting.
• Que .htaccess no contenga una regla que bloquee la dirección o IP.
• Que la carpeta no esté protegida por contraseña.

Evita usar permisos 777 como solución. Puede ocultar el problema y debilitar la seguridad.

Error 404: página no encontrada

• Confirma que el archivo o ruta exista dentro de public_html.
• Revisa mayúsculas y minúsculas; Pagina.html y pagina.html pueden ser nombres distintos.
• Comprueba las reglas de reescritura de .htaccess.
• En WordPress, vuelve a guardar los enlaces permanentes para regenerar sus reglas.
• Si cambiaste una dirección, crea una redirección en lugar de dejar enlaces rotos.

El dominio no abre

1. Confirma que el dominio esté activo y no haya vencido.
2. Revisa sus nameservers o registros A y CNAME.
3. Espera si el DNS cambió recientemente.
4. Comprueba que el dominio esté agregado en DirectAdmin.
5. Verifica que los archivos estén en la carpeta public_html de ese dominio.

Consulta Administrar registros DNS y Agregar y administrar dominios.

HTTPS muestra una advertencia

• Confirma que el certificado incluya el dominio y www si lo utilizas.
• Espera a que el DNS apunte al hosting antes de solicitar el certificado.
• Revisa la fecha de vencimiento.
• Comprueba si la página carga imágenes o scripts mediante http://.
• Vuelve a solicitar el certificado solamente después de corregir el DNS.

Consulta Activar un certificado SSL.

La aplicación no conecta a la base de datos

Comprueba en su archivo de configuración:

• Host: normalmente localhost.
• Nombre completo de la base, incluido el prefijo de DirectAdmin.
• Usuario completo de la base.
• Contraseña sin espacios adicionales.
• Que el usuario esté asociado a la base correcta.

No publiques estas credenciales en un ticket o captura. Consulta Crear una base de datos.

Las subidas fallan o son demasiado grandes

En Configuración PHP, revisa:

• upload_max_filesize para el tamaño de cada archivo.
• post_max_size para el total de la petición.
• max_execution_time si la operación tarda demasiado.
• memory_limit si el proceso necesita más memoria.

post_max_size debe ser igual o mayor que upload_max_filesize. Aumenta los límites de forma moderada y consulta Cambiar la versión y configuración de PHP.

El sitio está lento

1. Revisa Información y archivos → Resource usage.
2. Comprueba espacio en disco, CPU, memoria y procesos.
3. Revisa consultas lentas y complementos pesados.
4. Optimiza imágenes antes de subirlas.
5. Confirma que las tareas Cron no se ejecuten con demasiada frecuencia.
6. Si desactivaste la caché para todo el sitio, considera excluir solamente las rutas incompatibles.

LiteSpeed Cache puede mejorar el rendimiento cuando la aplicación es compatible. No lo desactives como primera prueba si no hay señales de contenido almacenado incorrectamente.

Qué incluir en un ticket de soporte

Proporciona:

• Dominio afectado.
• Dirección exacta que falla.
• Hora aproximada del problema y zona horaria.
• Mensaje o código de error.
• Pasos para reproducirlo.
• Cambios realizados antes del fallo.
• Captura sin contraseñas ni información privada.

No envíes contraseñas, llaves privadas, archivos .env ni respaldos completos salvo que soporte indique un canal seguro.