Solución a errores comunes al subir archivos a cPanel

Solución a errores comunes al subir archivos a cPanel

Subir tu página web a un servidor puede parecer una tarea complicada, especialmente si es la primera vez que lo haces. Cuando utilizas cPanel, el panel de control más popular del mundo, normalmente tienes varias vías para hacerlo: el File Manager (Administrador de Archivos), un cliente FTP como FileZilla o incluso el asistente de subida de WordPress. Sin embargo, a lo largo de este proceso, es muy habitual toparse con errores que cortan la subida o que hacen que la web no se vea correctamente una vez subida.

No te preocupes. En esta guía extensa y detallada, vamos a desglosar los errores subir archivos cpanel más frecuentes, explicando por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. Tanto si estás usando el file manager cpanel como si prefieres un cliente FTP, aquí encontrarás la solución que necesitas.

---

1. Error "Permiso denegado" o "No se puede mover el archivo"

Este es, sin duda, uno de los errores subir archivos cpanel más comunes. Sucede cuando intentas subir un archivo a una carpeta que no tiene los permisos adecuados. El sistema operativo del servidor (normalmente Linux) protege los archivos y solo permite escribir en ellos si el usuario tiene los permisos correctos.

¿Por qué ocurre?

Generalmente, esto pasa cuando intentas subir archivos directamente a la raíz del dominio (la carpeta public_html o www) y el cliente FTP que usas no está configurado con las credenciales correctas, o cuando los permisos de la carpeta de destino están establecidos como de solo lectura (por ejemplo, 555 en lugar de 755).

Solución paso a paso

Para solucionar este problema, debes ajustar los permisos archivos cpanel. Sigue estos pasos:

1. Accede a tu panel de cPanel.
2. Busca la sección Archivos y haz clic en Administrador de Archivos (File Manager).
3. Navega hasta la carpeta donde estás intentando subir el archivo (normalmente public_html).
4. Haz clic derecho sobre la carpeta en cuestión y selecciona Permisos (o "Change Permissions").
5. En la ventana emergente, asegúrate de que los permisos estén configurados como 755 para carpetas y 644 para archivos individuales. Esto le da al propietario (tu usuario) permisos de lectura y escritura, y a los demás solo de lectura y ejecución (en el caso de carpetas).
6. Marca la casilla de "Cambiar recursivamente" si necesitas aplicar el cambio a todas las subcarpetas y archivos dentro de la carpeta.
7. Haz clic en Cambiar permisos.

[TIP] Si estás usando FTP y te da error, verifica que estás conectado con el usuario principal de cPanel. A veces se crean usuarios FTP secundarios que no tienen permisos de escritura sobre ciertas carpetas.

---

2. El archivo se sube, pero la web muestra un error 500 o "Internal Server Error"

Has subido tu web correctamente, pero al abrir el navegador te encuentras con un molesto error 500. Esto no significa que el archivo no se haya subido, sino que el servidor no puede ejecutarlo o leerlo correctamente.

¿Cuál es la causa principal?

La causa más común es que el archivo .htaccess (un archivo de configuración oculto) tenga directivas incompatibles con la configuración del servidor, o que los permisos de los archivos PHP sean demasiado restrictivos (por ejemplo, 644 en lugar de 755 para un script que necesita ejecutarse).

Solución práctica

Para resolver este error tras subir tu web, sigue estos pasos:

1. Ve al file manager cpanel y asegúrate de activar la opción Mostrar archivos ocultos (dotfiles) en la esquina superior derecha.
2. Localiza el archivo .htaccess en la raíz de tu dominio.
3. Haz clic derecho sobre él y selecciona Editar.
4. Revisa si hay líneas que parezcan sospechosas o que estén relacionadas con módulos que tu hosting no tiene (como mod_rewrite mal escrito). Si no estás seguro, puedes renombrarlo temporalmente a .htaccess.bak para ver si la web carga. Si carga, el problema es ese archivo.
5. Si el problema no es .htaccess, revisa los permisos archivos cpanel de todos los archivos .php. Deben ser 644 como regla general, y las carpetas 755.

[WARNING] No pongas nunca permisos 777 (lectura, escritura y ejecución para todos). Aunque soluciona el error de forma temporal, deja tu web expuesta a ataques de seguridad.

---

3. La subida se interrumpe a mitad de camino o se queda congelada

Este es un clásico cuando se intenta subir un archivo muy grande (como un backup de la web o un vídeo) a través del file manager cpanel. El navegador tiene límites de tiempo de espera y de tamaño de archivo.

Diagnóstico del problema

El problema suele estar en la configuración de upload_max_filesize y max_execution_time en el PHP del servidor. cPanel tiene límites predeterminados que a veces son demasiado bajos para archivos pesados.

Cómo solucionarlo

1. Usa un cliente FTP: La forma más fiable de subir archivos grandes es usando un cliente FTP como FileZilla. Este software no tiene límite de tiempo de espera del navegador y reanuda las subidas si se cortan.
2. Sube el archivo en partes: Si no tienes acceso FTP, tendrás que comprimir el archivo en varias partes (usando WinRAR o 7-Zip) y subirlas por separado desde el file manager cpanel. Luego, las descomprimes en el servidor.
3. Aumenta los límites de PHP (si tu plan lo permite): En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP o MultiPHP INI Editor. Ahí podrás aumentar el valor de upload_max_filesize a, por ejemplo, 512M, y el de max_execution_time a 300.

---

4. Error de conexión FTP: "No se pudo establecer conexión con el servidor"

Este error es frustrante porque ocurre antes de siquiera empezar a subir archivos. Te conectas con FileZilla o cualquier otro cliente y te sale el famoso "ECONNREFUSED" o "Connection timed out".

Motivos y soluciones

Este es un fallo típico de ftp cpanel errores. Las causas suelen ser tres:

1. Datos incorrectos: Verifica que el usuario FTP y la contraseña son correctos. Recuerda que el usuario FTP suele tener el formato usuario@tudominio.com.
2. Puerto equivocado: El puerto estándar para FTP es el 21. Asegúrate de que tu cliente FTP está usando ese puerto. Si usas SFTP (FTP sobre SSH), el puerto suele ser el 22, pero debes verificar que tu hosting lo tenga habilitado.
3. IP bloqueada por el Firewall: A veces, el servidor bloquea tu IP pública tras varios intentos fallidos. Espera unos minutos o contacta con el soporte técnico para que desbloqueen tu IP.

[INFO] Si tu hosting utiliza un panel alternativo como Syspanel (anteriormente conocido como HestiaCP), el acceso a la gestión de archivos se realiza a través del puerto 2106. En este caso, el FTP también puede tener una configuración específica que debes consultar en la documentación de tu proveedor.

---

5. Error "No hay espacio disponible en el disco" al subir archivos

Subes un archivo y el sistema te responde que no hay espacio. Esto es más común de lo que crees, y no siempre significa que hayas llenado tu cuota de hosting.

Cómo solucionarlo

1. Libera espacio: Entra en el file manager cpanel y revisa las carpetas más grandes, como logs, tmp o backups. Elimina los archivos de copia de seguridad antiguos que ya no necesites.
2. Revisa la caché: Si usas WordPress, la caché de tu plugin (como WP Rocket o W3 Total Cache) puede acumular cientos de MB. Limpia la caché.
3. Comprime archivos: Si el archivo que intentas subir es demasiado grande, comprímelo en un .zip y luego descomprímelo en el servidor. Esto reduce el peso temporal durante la transferencia.

---

6. Los archivos se suben, pero la web se ve en blanco o con errores de estilo

Has subido todos los archivos, pero al ver tu web en el navegador, esta se ve sin CSS (sin colores ni estilos) o completamente en blanco. Este es un problema de rutas y de estructura de carpetas.

La solución más efectiva

1. Revisa la carpeta de destino: Asegúrate de haber subido los archivos a la carpeta correcta. Si tu dominio es www.midominio.com, los archivos deben estar dentro de public_html. Si los has subido a una subcarpeta como public_html/miweb, tendrás que acceder a través de www.midominio.com/miweb.
2. Problemas con la base de datos: Si tu web usa una base de datos (como WordPress), es posible que los datos no se hayan importado correctamente. Revisa el archivo wp-config.php y verifica que el nombre de la base de datos, el usuario y la contraseña son correctos.
3. Caché del navegador: A veces el navegador guarda una versión antigua de la web. Haz una recarga forzada con Ctrl + F5 (Windows) o Cmd + Shift + R (Mac).

---

7. No puedo ver la carpeta public_html en el File Manager

Este es un problema de configuración de la cuenta. A veces, al entrar al file manager cpanel, te lleva a la raíz de tu cuenta (home) y no ves la carpeta public_html porque está oculta o porque tienes una cuenta con un "document root" diferente.

Pasos para solucionarlo

1. En la parte superior del file manager cpanel, en el selector de "Directorio raíz", asegúrate de que está seleccionado Solo public_html o Cuenta de usuario.
2. Si no la ves, haz clic en Configuración (icono de engranaje) y marca la casilla Mostrar archivos ocultos (dotfiles).
3. Si aún así no aparece, es posible que tu dominio principal esté configurado para usar otra carpeta (por ejemplo, htdocs). Verifica esto en la sección Dominios de cPanel.

---

8. Error al descomprimir un archivo ZIP en cPanel

Subes un archivo .zip y al intentar descomprimirlo en el file manager cpanel, te da un error de "Extract failed" o "Archive is corrupt".

Solución paso a paso

1. Verifica el archivo localmente: Asegúrate de que el archivo .zip no está dañado. Intenta abrirlo en tu ordenador con WinRAR o 7-Zip.
2. Sube el archivo de nuevo: A veces la subida se corrompe. Bórralo del servidor y vuelve a subirlo, preferiblemente usando un cliente FTP para evitar cortes.
3. Usa la opción "Extraer" correctamente: En el file manager cpanel, selecciona el archivo .zip, haz clic en Extraer y asegúrate de que la ruta de destino es la correcta (normalmente la carpeta donde está el ZIP).

---

9. Problemas con acentos, ñ o caracteres especiales en los nombres de archivo

Es muy común que al subir archivos con nombres en español (como página.html o sección_ñ.txt), el servidor los muestre con caracteres raros (á, ñ) o directamente no los encuentre.

Cómo evitarlo

1. Renombra los archivos antes de subir: Lo mejor es evitar estos caracteres. Usa solo letras minúsculas, números y guiones bajos (_) o guiones medios (-). Por ejemplo, pagina.html o seccion_n.txt.
2. Codificación UTF-8: Si es imprescindible usar acentos, asegúrate de que los archivos estén guardados en codificación UTF-8 (sin BOM). Esto se configura en la mayoría de los editores de código como Visual Studio Code o Sublime Text.

---

10. Error "No se puede conectar a la base de datos" después de subir la web

Este error es típico al migrar una web. Los archivos están bien, pero la conexión con la base de datos falla.

Solución

1. Crea la base de datos: En cPanel, ve a Bases de datos MySQL y crea una nueva base de datos y un usuario con todos los privilegios.
2. Importa los datos: Usa phpMyAdmin para importar el archivo .sql que tengas de tu web anterior.
3. Actualiza el archivo de configuración: Busca el archivo wp-config.php (en WordPress) o configuration.php (en Joomla) y actualiza el nombre de la base de datos, el usuario y la contraseña con los nuevos datos que acabas de crear.

---

Preguntas Frecuentes (FAQ)

¿Cuál es la mejor manera de subir archivos a cPanel?

La mejor manera es usar un cliente FTP como FileZilla, ya que es más rápido y no tiene límites de tiempo de espera. El file manager cpanel es perfecto para archivos pequeños o para gestionar permisos.

¿Qué permisos deben tener los archivos en cPanel?

Los archivos deben tener 644 y las carpetas 755. Evita los permisos 777 por seguridad.

¿Puedo subir archivos grandes a través del File Manager?

Sí, pero es arriesgado. Si el archivo supera los 100MB, es mejor usar FTP o comprimirlo en partes.

Mi hosting usa Syspanel, ¿cambio algo?

Sí. Si tu proveedor usa Syspanel (HestiaCP), el acceso al panel de control se hace por el puerto 2106. Las funciones son similares a cPanel, pero la interfaz cambia. Para subir archivos, también encontrarás un gestor de archivos y podrás usar FTP con las mismas credenciales de tu cuenta.

¿Qué hago si olvidé mi contraseña de FTP?

Puedes cambiarla desde cPanel en la sección Cuentas FTP. Si usas Syspanel, deberás hacerlo desde la sección de usuarios de tu panel de control en el puerto 2106.

---

Conclusión

Subir archivos a tu hosting no tiene por qué ser una pesadilla. La mayoría de los errores subir archivos cpanel se deben a problemas de permisos, de tamaño de archivo o de configuración de FTP. Con esta guía, ya tienes las herramientas para diagnosticar y solucionar los fallos más comunes.

Recuerda siempre verificar los permisos archivos cpanel, usar un cliente FTP para archivos pesados y tener cuidado con los nombres de los archivos. Si tu proveedor usa Syspanel, no olvides que el acceso al panel es a través del puerto 2106. Con un poco de paciencia y estos trucos, tu web estará online en un abrir y cerrar de ojos.