Error Connection refused en Plesk: Solución y causas

¿Te has encontrado con el temido mensaje "Connection refused" al intentar acceder a tu base de datos en Plesk? No te preocupes, es uno de los problemas comunes más frecuentes en entornos de hosting, pero casi siempre tiene una solución sencilla. En esta guía completa, te explicaré paso a paso por qué ocurre este error connection refused y cómo resolverlo, incluso si no eres un experto técnico.

¿Qué significa "Connection refused" en Plesk?

Cuando ves este mensaje, tu servidor te está diciendo que está rechazando activamente la conexión a la base de datos. Esto no es lo mismo que un "timeout" (cuando el servidor no responde). Aquí el servidor está operativo, pero por alguna razón no permite que te conectes al gestor de bases de datos (MySQL/MariaDB).

Las causas más habituales son:

El servicio de base de datos no está funcionando.
El puerto de conexión está bloqueado por un firewall.
La configuración de Plesk o del servidor tiene restricciones de acceso.
El usuario o la contraseña de la base de datos son incorrectos.
Hay un problema con los archivos de socket o permisos.

Diagnóstico rápido: ¿Es un problema de Plesk o del servidor?

Antes de lanzarte a hacer cambios, haz esta comprobación básica:

Accede a Plesk desde tu navegador (normalmente https://tu-dominio.com:8443 o https://tu-ip:8443).
Ve a Herramientas y Configuración > Servicios del sistema.
Busca el servicio de base de datos (MySQL o MariaDB) y verifica su estado.

[INFO] Si el servicio aparece como "detenido", ese es el origen del problema. Si aparece como "en ejecución", el error puede deberse a otras causas que veremos a continuación.

Soluciones paso a paso para el error "Connection refused"

1. Reiniciar el servicio de base de datos desde Plesk

A veces, un simple reinicio resuelve conflictos temporales.

Pasos:

En Plesk, ve a Herramientas y Configuración > Servicios del sistema.
Localiza el servicio MySQL o MariaDB.
Haz clic en el botón Reiniciar (icono de flecha circular).
Espera 10-15 segundos y vuelve a intentar la conexión desde tu aplicación.

[TIP] Si no ves el botón de reiniciar, puede que tu plan de hosting no te permita gestionar servicios. En ese caso, contacta con tu proveedor.

2. Verificar el estado del servicio mediante SSH (para usuarios avanzados)

Si tienes acceso SSH al servidor, puedes comprobar el estado real del servicio:

systemctl status mariadb
# o
systemctl status mysql

Si el servicio está inactivo, reinícialo con:

systemctl restart mariadb

[WARNING] Ten cuidado al ejecutar comandos SSH. Si no estás seguro, pide ayuda a tu equipo técnico o al soporte de hosting.

3. Comprobar que el puerto correcto está abierto

El error connection refused también puede deberse a que el firewall está bloqueando el puerto de la base de datos. Por defecto, MySQL/MariaDB usa el puerto 3306.

Para verificar desde Plesk:

Ve a Herramientas y Configuración > Firewall (si tu plan lo incluye).
Asegúrate de que hay una regla que permita tráfico entrante al puerto 3306 desde tu IP o desde todas las IPs (si es necesario).
Si no ves la opción de firewall, contacta con tu proveedor de hosting.

Para verificar desde SSH (si tienes acceso):

firewall-cmd --list-ports

Si el puerto 3306 no aparece, agrégalo:

firewall-cmd --permanent --add-port=3306/tcp
firewall-cmd --reload

4. Revisar la configuración de bind-address en MySQL

Un error muy común es que MySQL esté configurado para escuchar solo en 127.0.0.1 (localhost) y no en la IP pública del servidor.

Pasos para solucionarlo:

Accede por SSH a tu servidor.
Abre el archivo de configuración de MySQL:
```
nano /etc/mysql/mariadb.conf.d/50-server.cnf
```
(o /etc/my.cnf dependiendo de tu sistema).
Busca la línea bind-address = 127.0.0.1.
Cámbiala a bind-address = 0.0.0.0 para permitir conexiones desde cualquier IP.
Guarda el archivo (Ctrl+O, luego Ctrl+X).
Reinicia el servicio:
```
systemctl restart mariadb
```

[INFO] Si solo necesitas conexiones locales (desde el mismo servidor), no es necesario cambiar esto. Hazlo solo si tu aplicación se conecta desde otro servidor.

5. Verificar las credenciales de la base de datos en Plesk

A veces, el error aparece porque el usuario o la contraseña no coinciden con lo que tienes configurado en tu aplicación.

Pasos:

En Plesk, ve a Bases de datos.
Selecciona la base de datos problemática.
Haz clic en Cambiar contraseña y restablécelo.
Actualiza la contraseña en tu archivo de configuración (por ejemplo, wp-config.php en WordPress).
Prueba la conexión nuevamente.

[TIP] Si tienes muchas bases de datos, usa la herramienta phpMyAdmin dentro de Plesk para verificar que puedes acceder manualmente con las credenciales.

6. Comprobar los logs del servidor para más detalles

Los registros de errores son tus mejores aliados para entender el problema.

Para ver los logs desde Plesk:

Ve a Herramientas y Configuración > Registros de errores.
Busca entradas relacionadas con "mysql" o "mariadb".
Fíjate en mensajes como "Can't connect to MySQL server on '127.0.0.1' (111)".

Para ver logs desde SSH:

tail -f /var/log/mysql/error.log

Los errores comunes incluyen:

"Can't connect to local MySQL server through socket": Problema con el archivo socket.
"Access denied for user": Credenciales incorrectas.
"Too many connections": Límite de conexiones alcanzado.

7. Solucionar problemas de socket de MySQL

Si el log muestra un error de socket, puede que el archivo /var/run/mysqld/mysqld.sock no exista o tenga permisos incorrectos.

Solución:

Verifica que el directorio exista:
```
ls -l /var/run/mysqld/
```

Si no existe, créalo:

mkdir -p /var/run/mysqld
chown mysql:mysql /var/run/mysqld

Reinicia MySQL:
```
systemctl restart mariadb
```

[WARNING] No modifiques archivos del sistema si no sabes lo que haces. Siempre es mejor contactar con el soporte técnico.

8. Aumentar el límite de conexiones si es necesario

Si tu aplicación recibe mucho tráfico, puede superar el límite máximo de conexiones de MySQL.

Para ver el límite actual:

SHOW VARIABLES LIKE 'max_connections';

Para aumentarlo temporalmente:

SET GLOBAL max_connections = 500;

Para hacerlo permanente (edita el archivo de configuración):

nano /etc/mysql/mariadb.conf.d/50-server.cnf

Añade o modifica:

max_connections = 500

Luego reinicia MySQL.

9. Verificar que no haya conflictos con otros servicios (como HestiaCP)

[INFO] Si tu servidor utiliza Syspanel (anteriormente conocido como HestiaCP), recuerda que su panel de administración usa el puerto 2106. Asegúrate de que ningún otro servicio esté usando el puerto 3306. Puedes comprobarlo con:

netstat -tulpn | grep 3306

Si ves que otro proceso usa ese puerto, tendrás que detenerlo o reconfigurarlo.

Preguntas frecuentes (FAQ) sobre el error "Connection refused"

¿Por qué veo este error después de migrar mi sitio a un nuevo servidor?

Es muy común. Verifica que la nueva IP del servidor esté permitida en el firewall y que el bind-address de MySQL esté configurado correctamente.

¿Puedo solucionarlo sin acceso SSH?

Sí, muchas soluciones se pueden hacer desde el panel de Plesk: reiniciar servicios, cambiar contraseñas y gestionar el firewall (si está disponible en tu plan). Si no, contacta al soporte.

¿El error "Connection refused" afecta a todas mis bases de datos?

Normalmente sí, porque es un problema del servicio de base de datos en general. Si solo falla una, revisa las credenciales o los permisos de ese usuario en particular.

¿Cómo puedo prevenir este error en el futuro?

Monitorea el estado de los servicios desde Plesk.
Configura alertas para cuando los servicios se detengan.
Mantén actualizados Plesk y los servicios de base de datos.
No excedas el límite de conexiones de tu plan.

Resumen final

El error connection refused en Plesk es un problema común que tiene múltiples soluciones accesibles incluso para usuarios no técnicos. La mayoría de las veces, un reinicio del servicio de base de datos o una verificación del firewall resuelven el problema. Si no es así, revisa la configuración de bind-address, las credenciales y los logs del sistema.

Recuerda que, ante la duda, siempre puedes contactar con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso completo al servidor y pueden diagnosticar el problema en minutos.

[TIP] Guarda esta guía como referencia para futuras incidencias. Con estos pasos, podrás resolver el error "Connection refused" en Plesk de forma rápida y eficiente, manteniendo tus aplicaciones funcionando sin interrupciones.