Cómo solucionar errores de aaPanel (BaoTa): no abre, 502/504, disco lleno

Los problemas más comunes de aaPanel (BaoTa) son que el panel no abre, los errores 502/504 en sitios PHP, el disco lleno y la contraseña del panel olvidada. Esta guía le ofrece los comandos para diagnosticar cada uno de ellos en el panel aaPanel/BaoTa para Linux con Debian/Ubuntu o CentOS/Rocky/AlmaLinux. Casi todo se hace por SSH; consulte nuestra guía «Inicio de sesión por SSH» si necesita ayuda para conectarse.

Paso 1: aaPanel no abre — encuentre la URL correcta del panel

Las versiones recientes del panel generan durante la instalación un puerto aleatorio y una ruta de «entrada de seguridad» (security entry), por lo que abrir IP:8888 suele fallar o mostrar un error de entrada. Inicie sesión por SSH y ejecute bt default, o ejecute bt y elija 14 (ver la información predeterminada del panel), para obtener la URL completa, el puerto y la cuenta predeterminada. Si el servicio del panel no está en ejecución, reinícielo con bt restart.

# Show panel URL (with security entry), port and default account
bt default
# or open the menu and choose 14 (view panel default info)
bt

# Restart the panel service
bt restart

Paso 2: Compruebe el puerto del panel, el firewall del sistema y las políticas de seguridad

Si la URL es correcta pero sigue sin poder acceder, normalmente el puerto está bloqueado. Confirme en qué puerto escucha el panel y permítalo en el firewall del sistema operativo (abajo se usa 8888; sustitúyalo por el suyo). Si utiliza alguna protección de red o política de seguridad adicional delante del servidor, permita el puerto también allí. Compruebe además si su red local bloquea puertos poco habituales: pruebe desde la zona Wi-Fi de su teléfono.

# Which port is the panel listening on?
cat /www/server/panel/data/port.pl
ss -lntp | grep -E "BT-Panel|python"

# Debian / Ubuntu (ufw)
ufw allow 8888/tcp && ufw status
# CentOS / Rocky / AlmaLinux (firewalld)
firewall-cmd --permanent --add-port=8888/tcp && firewall-cmd --reload

Paso 3: Olvidó la contraseña o el usuario de aaPanel (BaoTa)

Inicie sesión por SSH, ejecute bt para abrir el menú de administración, introduzca 5 para cambiar la contraseña del panel o 6 para cambiar el nombre de usuario y escriba el nuevo valor. El cambio se aplica de inmediato. Si también olvidó un puerto personalizado, use 8 para definir un nuevo puerto del panel (y permítalo en el firewall).

bt
# 5  -> change panel password
# 6  -> change panel username
# 8  -> change panel port

Paso 4: Error 502 Bad Gateway en sitios web PHP

Un 502 significa que Nginx no recibe respuesta de PHP-FPM, normalmente porque PHP-FPM se ha bloqueado, no está en ejecución o se ha quedado sin procesos (workers). Compruebe el proceso y el archivo de socket, reinicie la versión de PHP correspondiente y lea el registro de errores del sitio y el registro de PHP-FPM. Si ve «server reached pm.max_children», aumente el número de procesos en la configuración de rendimiento de PHP del panel, vigilando la memoria disponible.

# Is PHP-FPM running? (74 = PHP 7.4, adjust to your version)
ps aux | grep php-fpm | head
ls -l /tmp/php-cgi-74.sock
/etc/init.d/php-fpm-74 restart

# Read the logs
tail -n 50 /www/wwwlogs/example.com.error.log
tail -n 50 /www/server/php/74/var/log/php-fpm.log
tail -n 50 /www/server/php/74/var/log/slow.log

Paso 5: Error 504 Gateway Timeout en sitios web PHP

Un 504 significa que una petición PHP tardó más de lo que Nginx está dispuesto a esperar; es típico en importaciones grandes, scripts de scraping o consultas SQL lentas. Primero localice el código lento con slow.log y el registro de consultas lentas de MySQL. Si de verdad se necesitan tiempos de ejecución largos, aumente los tiempos de espera de FastCGI en la configuración de Nginx del sitio y suba max_execution_time en php.ini en consecuencia.

# Inside the site's Nginx config (location ~ \.php$ or server block)
fastcgi_connect_timeout 60s;
fastcgi_send_timeout    300s;
fastcgi_read_timeout    300s;

Paso 6: Pruebe la configuración de Nginx con nginx -t

Si Nginx no arranca o todos los sitios caen después de editar un vhost, las reglas de reescritura o el SSL, pruebe primero la sintaxis. nginx -t muestra el archivo y la línea con el error; corríjalo y recargue. Si se indica que el puerto 80/443 está en uso, averigüe con ss qué programa lo ocupa.

/www/server/nginx/sbin/nginx -t
/etc/init.d/nginx reload

# Debian / Ubuntu / CentOS: see what holds port 80/443
ss -lntp | grep -E ":80 |:443 "

Paso 7: El disco lleno bloquea el panel y los sitios web

Un disco lleno provoca una cadena de fallos: el inicio de sesión en el panel falla, MySQL se detiene y los sitios muestran errores. Use los comandos siguientes para encontrar los directorios más grandes; los sospechosos habituales son los registros de los sitios en /www/wwwlogs, las copias locales en /www/backup y los registros binarios de MySQL. Vacíe con truncate los registros que siguen abiertos en lugar de borrarlos. Compruebe también los inodos con df -i (muchos archivos pequeños o de sesión). Nuestra guía «Poco espacio en disco» incluye más consejos de limpieza.

df -h
df -i
du -h --max-depth=1 /www 2>/dev/null | sort -h | tail -n 15
du -sh /www/wwwlogs /www/backup /www/server/data 2>/dev/null

# Empty (not delete) a huge log that is still open
truncate -s 0 /www/wwwlogs/example.com.log

# Purge old MySQL binary logs (run in mysql -uroot -p)
PURGE BINARY LOGS BEFORE NOW() - INTERVAL 3 DAY;

Preguntas frecuentes

El comando bt indica «command not found».

Use en su lugar /etc/init.d/bt default o /etc/init.d/bt restart. Si ese archivo tampoco existe, los archivos del panel están dañados; haga una copia de seguridad de sus datos y repare o reinstale el panel con el script oficial.

El error 502 vuelve poco después de reiniciar PHP.

Normalmente se agota la memoria o el número de procesos es demasiado alto y el kernel mata procesos. Revise free -m y las entradas OOM en dmesg, reduzca el número de procesos o añada swap (consulte nuestra guía «Swap en Linux»), o mejore su plan.

El panel abre pero indica que mi IP o dominio no está autorizado.

Anteriormente se configuraron IPs autorizadas o un dominio vinculado. Elija la opción correspondiente en el menú de bt para quitar la restricción de IP o la vinculación del dominio.

¿Sigue con problemas después de seguir estos pasos? Abra un ticket de soporte y el equipo técnico de IMIDC, disponible 24/7, le ayudará. Incluya la IP del servidor, la versión del sistema operativo, los comandos que ejecutó y una captura de pantalla del error para que podamos localizar el problema más rápido.