Syspanel: errores comunes al subir archivos y cómo solucionarlos

Introducción: ¿Por qué falla la subida de archivos en Syspanel?

Si estás leyendo esto, probablemente te has topado con un mensaje de error frustrante al intentar subir un archivo a tu servidor a través de Syspanel. No te preocupes, es una de las consultas más frecuentes en soporte técnico. La buena noticia es que la mayoría de estos Syspanel errores tienen soluciones sencillas que puedes aplicar tú mismo, sin necesidad de ser un experto en Linux.

Syspanel (basado en HestiaCP, accesible por el puerto 2106) es una herramienta potente, pero a veces la configuración del servidor o los límites del sistema pueden bloquear tus archivos. En esta guía, vamos a desglosar los problemas más comunes al subir archivos problema y te daremos pasos claros para que vuelvas a trabajar en minutos.

## Error 1: "Archivo demasiado grande" o límite de tamaño excedido

Este es, con diferencia, el error más común. Syspanel, como muchos paneles de control, tiene límites predefinidos para el tamaño de los archivos que puedes subir a través del navegador. Si intentas subir un tema de WordPress pesado, un PDF grande o un backup, te encontrarás con este mensaje.

### ¿Por qué ocurre?

El problema suele estar en tres valores de configuración de PHP y del servidor web (Apache o Nginx):

upload_max_filesize: Tamaño máximo de archivo permitido en PHP.
post_max_size: Tamaño máximo de datos que PHP aceptará en una solicitud POST (debe ser igual o mayor al anterior).
max_execution_time: Tiempo máximo que PHP puede ejecutarse (si el archivo es grande, la subida puede agotar el tiempo).

### Solución paso a paso desde Syspanel

Accede a Syspanel: Abre tu navegador y ve a https://tudominio.com:2106. Inicia sesión con tus credenciales de administrador.
Ve a la configuración de PHP: Busca la sección "Servidor" o "Configuración". Dependiendo de la versión, puede estar en "Ajustes" > "PHP". Selecciona la versión de PHP que estés usando (por ejemplo, PHP 8.1).
Modifica los parámetros:
- Busca upload_max_filesize y cámbialo a 64M (o el valor que necesites, como 128M).
- Busca post_max_size y ponlo al mismo valor o superior (ej. 64M).
- Busca max_execution_time y cámbialo a 300 (segundos).
Guarda los cambios: Haz clic en "Guardar" o "Aplicar". Syspanel reiniciará automáticamente el servicio PHP.

[TIP] Si no ves estas opciones en Syspanel, puedes editarlas manualmente desde SSH. El archivo de configuración suele estar en /etc/php/versión/cli/php.ini o /etc/php/versión/apache2/php.ini. Después, reinicia Apache o Nginx con sudo systemctl restart apache2 o sudo systemctl restart nginx.

## Error 2: Permisos de carpeta denegados (error 403 o 500)

Otro clásico. Subes el archivo, pero al intentar acceder a él desde el navegador, recibes un error 403 (Prohibido) o 500 (Error interno del servidor). Esto suele deberse a que los permisos de la carpeta donde subiste el archivo no son correctos.

### ¿Por qué ocurre?

El servidor web (Apache/Nginx) necesita permisos específicos para leer y ejecutar archivos. Si los permisos son demasiado restrictivos (por ejemplo, 600 para una carpeta), el servidor no podrá acceder. Si son demasiado permisivos (777), puede ser un riesgo de seguridad.

### Solución desde el Administrador de Archivos de Syspanel

Inicia sesión en Syspanel (puerto 2106).
Navega a la carpeta problemática: Ve a "Archivos" o "Administrador de Archivos" y localiza la carpeta donde subiste el archivo (normalmente en web/tudominio/public_html).
Ajusta los permisos:
- Carpetas: Deben tener permisos 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupo y otros).
- Archivos: Deben tener permisos 644 (lectura y escritura para el propietario; solo lectura para grupo y otros).
- Archivos ejecutables (como scripts PHP): 755.
Aplica recursivamente: Si tienes muchas subcarpetas, puedes aplicar permisos de forma recursiva. En Syspanel, busca la opción "Permisos recursivos" o hazlo vía SSH con:
```
sudo find /home/usuario/web/tudominio/public_html -type d -exec chmod 755 {} \;
sudo find /home/usuario/web/tudominio/public_html -type f -exec chmod 644 {} \;
```

[WARNING] No uses permisos 777 en producción. Aunque soluciona el error temporalmente, expone tu sitio a ataques. Siempre usa 755 para carpetas y 644 para archivos.

## Error 3: El archivo se sube pero no se ve (archivos ocultos o corrupción)

A veces, el archivo parece subir correctamente (sin errores), pero luego no aparece en el administrador de archivos o, si aparece, está dañado. Esto puede deberse a problemas de conexión, tiempo de espera o archivos ocultos.

### ¿Por qué ocurre?

Archivos ocultos: Los archivos que comienzan con un punto (.) se consideran ocultos en Linux. Syspanel por defecto no los muestra.
Corrupción por timeout: Si tu conexión es lenta o el archivo es muy grande, la subida puede interrumpirse y generar un archivo incompleto.
Espacio en disco insuficiente: El servidor puede no tener suficiente espacio para almacenar el archivo.

### Soluciones prácticas

Habilitar archivos ocultos: En el Administrador de Archivos de Syspanel, busca una opción como "Mostrar archivos ocultos" o "Ver archivos .dot". Actívala.
Verificar espacio en disco:
- Desde Syspanel: Ve a "Estadísticas" o "Server Status". Busca el uso del disco.
- Desde SSH: Ejecuta df -h para ver el espacio disponible.
Usa FTP/SFTP como alternativa: Si el problema persiste, sube el archivo mediante un cliente FTP (como FileZilla). Syspanel soporta SFTP. Conéctate a tu servidor con las credenciales de tu usuario (no las de Syspanel) y sube el archivo directamente a la carpeta public_html. Esto evita los límites de PHP.

[INFO] El cliente FTP es más fiable para archivos grandes (>100MB). Configura FileZilla con SFTP (puerto 22) y usa tu usuario del sistema (no el de Syspanel).

## Error 4: "No se pudo mover el archivo" o error temporal

Este error suele aparecer cuando Syspanel intenta mover el archivo subido desde la carpeta temporal a la ubicación final, pero falla. Es común en entornos con poca memoria o configuraciones de seguridad estrictas.

### ¿Por qué ocurre?

Carpeta temporal llena: PHP usa una carpeta temporal (/tmp) para almacenar archivos durante la subida. Si está llena, falla.
open_basedir: Una configuración de seguridad que restringe los directorios a los que PHP puede acceder. Si la carpeta de destino no está en la lista, falla.
Problemas de SELinux: En distribuciones como CentOS o RHEL, SELinux puede bloquear el movimiento de archivos.

### Soluciones

Limpia la carpeta temporal:
- Desde SSH: sudo rm -rf /tmp/* (ten cuidado, esto borrará archivos temporales de todos los usuarios).
- O mejor, reinicia el servidor: sudo reboot. Esto limpia /tmp automáticamente.
Verifica open_basedir en Syspanel:
- Ve a "Configuración" > "PHP" y busca open_basedir.
- Asegúrate de que incluya la ruta de tu sitio, por ejemplo: /home/usuario/web/tudominio/public_html:/tmp.
Desactiva SELinux temporalmente (solo para pruebas):
```
sudo setenforce 0
```
Si el error desaparece, tendrás que ajustar las políticas de SELinux de forma permanente. No recomiendo dejarlo desactivado.

## Error 5: Subida interrumpida por el firewall o mod_security

A veces, el error no es de PHP ni de permisos, sino que el propio servidor bloquea la subida porque detecta el archivo como "sospechoso". Esto es común con archivos PHP, JSON o scripts.

### ¿Por qué ocurre?

ModSecurity: Un módulo de Apache que analiza las solicitudes en busca de patrones maliciosos. Puede bloquear subidas de archivos que contengan código PHP o SQL.
Firewall del sistema (UFW/iptables): Puede tener reglas que limiten el tráfico entrante.

### Soluciones

Desactiva ModSecurity para tu dominio:
- En Syspanel, ve a "Web" > "Dominios" y selecciona tu dominio.
- Busca la opción "ModSecurity" y cámbiala a "Desactivado" o "Modo detección" (log only).
- Guarda los cambios.
Comprueba el firewall:
- Desde SSH: sudo ufw status (en Ubuntu) o sudo iptables -L.
- Asegúrate de que los puertos 80, 443 y 2106 estén abiertos.
Renombra el archivo: A veces, cambiar la extensión (ej. de .php a .txt) y luego renombrarlo en el servidor puede evitar el bloqueo.

[TIP] Si trabajas con plugins de WordPress, es común que ModSecurity los bloquee. En ese caso, desactivarlo es la solución más rápida.

## Preguntas Frecuentes (FAQ) sobre Syspanel errores al subir archivos

### ¿Cuál es el tamaño máximo de archivo por defecto en Syspanel?

Por defecto, suele ser 2MB (upload_max_filesize) y 8MB (post_max_size). Puedes aumentarlo como explicamos en el Error 1.

### ¿Puedo subir archivos de más de 1GB?

Sí, pero no es recomendable a través del navegador. Usa SFTP (FileZilla) o la línea de comandos. Además, asegúrate de que tu plan de hosting lo permita y de que el servidor tenga suficiente espacio.

### ¿Qué hago si no tengo acceso SSH?

Si solo tienes acceso a Syspanel, limítate a las opciones del panel. Para cambios más profundos, contacta con tu proveedor de hosting. Ellos pueden ajustar los límites de PHP desde el servidor.

### ¿Por qué los permisos 777 son peligrosos?

Porque cualquier usuario en el servidor (incluyendo posibles atacantes) puede modificar tus archivos. Siempre usa 755 para carpetas y 644 para archivos.

### ¿El puerto 2106 es seguro?

Sí, Syspanel usa HTTPS en ese puerto. Asegúrate de que tu conexión sea segura (candado en el navegador). No compartas tus credenciales.

## Conclusión: Tu checklist para subir archivos sin errores

Para evitar la mayoría de los Syspanel errores, sigue esta lista antes de subir archivos:

Verifica los límites de PHP en Syspanel (upload_max_filesize, post_max_size, max_execution_time).
Comprueba los permisos de la carpeta de destino (755 para carpetas, 644 para archivos).
Asegúrate de tener espacio en disco.
Usa SFTP para archivos grandes (>50MB).
Desactiva ModSecurity si el archivo es bloqueado injustamente.
Limpia la carpeta temporal si hay errores de movimiento.

Si después de todo esto sigues teniendo problemas, no dudes en contactar a tu proveedor de hosting. La mayoría de los Syspanel solución están al alcance de tu mano, pero a veces el servidor necesita ajustes a nivel de sistema. ¡Buena suerte con tus subidas!