Instalar CloudPanel en un VPS Linux (Ubuntu/Debian)

CloudPanel es un panel de control gratuito y ligero que gestiona Nginx, PHP-FPM, bases de datos y certificados SSL desde una interfaz web. Instalado en un VPS Linux Infrawire, convierte un servidor vacío en una plataforma de alojamiento multisitio en pocos minutos. Esta guía cubre Ubuntu 24.04 y Debian 12.

📋 Requisitos previos

Un VPS KVM recién creado con Ubuntu 24.04 o Debian 12, sin nada más instalado (ni Apache, ni Nginx, ni MySQL, ni otro panel).
Al menos 2 GB de RAM y acceso SSH como root. En su área de cliente encontrará la IP y la contraseña root del VPS.
Un nombre de dominio cuyo registro DNS A (y AAAA si usa IPv6) apunte a VPS_IP.
Los puertos 22, 80, 443 y 8443 accesibles desde Internet.

🔄 1. Preparar el sistema

Conéctese como root y actualice los paquetes. CloudPanel necesita curl, wget y sudo.

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl wget sudo

Si se actualizó el kernel, reinicie con reboot y vuelva a conectarse antes de continuar.

⬇️ 2. Ejecutar el instalador oficial

Primero se descarga el instalador y se verifica su suma SHA-256 antes de ejecutarlo. La suma cambia con cada versión del instalador: copie el valor actual y la lista actualizada de motores de base de datos desde la página oficial https://www.cloudpanel.io/docs/v2/getting-started/other/ (sustituya SHA256_FROM_DOCS más abajo).

Bash
1curl -sS https://installer.cloudpanel.io/ce/v2/install.sh -o install.sh
2echo "SHA256_FROM_DOCS install.sh" | sha256sum -c
3sudo CLOUD_PANEL_DB_ENGINE=MARIADB_11.4 bash install.sh

La variable CLOUD_PANEL_DB_ENGINE elige el servidor de base de datos. Los valores documentados son MYSQL_8.4, MYSQL_8.0, MARIADB_11.4 y MARIADB_10.11. Si la omite, el instalador usa su valor por defecto. El comando sha256sum -c debe mostrar install.sh: OK; si muestra FAILED, deténgase y vuelva a descargar el archivo. La instalación tarda unos minutos.

🔑 3. Crear la primera cuenta de administrador

Abra https://VPS_IP:8443 en su navegador. El certificado es autofirmado, así que el navegador mostrará una advertencia: acéptela para este primer acceso.

El primer visitante crea al administrador, así que hágalo de inmediato. Rellene el nombre de usuario, el correo electrónico y una contraseña larga, y luego inicie sesión. No deje el panel expuesto durante horas antes de crear la cuenta.

🌐 4. Añadir un sitio PHP

En el panel, haga clic en Sites, luego en Add Site y después en Create a PHP Site. Elija una plantilla de aplicación (Generic, WordPress, Laravel, etc.), escriba example.com como dominio, seleccione una versión de PHP y defina el usuario y la contraseña del sitio. CloudPanel crea el vhost de Nginx, un pool de PHP-FPM y un usuario de sistema dedicado al sitio.

Suba sus archivos por SFTP con el usuario del sitio (no root) a /home/USER/htdocs/example.com. También puede crear una base de datos para el sitio en Databases.

🔒 5. Emitir un certificado Let's Encrypt

Compruebe que example.com ya apunta a VPS_IP:

Bash
1dig +short example.com

Abra después el sitio, vaya a la pestaña SSL/TLS, haga clic en Actions y elija New Let's Encrypt Certificate. Seleccione los nombres de dominio que desea incluir y confirme. CloudPanel gestiona la renovación automáticamente.

🛡️ 6. Proteger el panel

En Admin Area > Security > Firewall, limite el puerto 8443 a su propia dirección IP y elimine la regla que lo permite desde cualquier lugar. Mantenga abiertos 22, 80 y 443 según lo necesite.
En Admin Area > Security, active Basic Auth en el panel como segunda barrera.
En su perfil de usuario, active la autenticación de dos factores.
Use una contraseña larga y única, y mantenga el sistema actualizado:

Bash
1apt update && apt -y upgrade

✅ 7. Verificar la instalación

Bash
1ss -tlnp | grep -E ':(80|443|8443)\b'
2systemctl is-active nginx clp-agent
3curl -I https://example.com

Los puertos 80, 443 y 8443 deben estar en escucha, ambos servicios deben responder active, y el último comando debe devolver HTTP 200 o una redirección con un certificado válido.

🧰 Solución de problemas

El instalador se niega a ejecutarse o falla a mitad: CloudPanel debe instalarse en un sistema limpio. Si ya había otro servidor web o una base de datos, reinstale el sistema operativo desde su área de cliente y empiece de nuevo.
El puerto 8443 no responde: compruebe que el cortafuegos (reglas del panel y cualquier otro cortafuegos) lo permite y que su IP no se haya quitado de la lista autorizada. Ejecute ss -tlnp | grep 8443 en el servidor.
Let's Encrypt falla: el dominio aún no apunta al VPS, o un proxy oculta la IP real. Corrija el registro DNS, espere la propagación y reintente. El puerto 80 debe estar abierto.
Contraseña de admin perdida: restablézcala desde el shell con clpctl user:reset:password --userName='admin' --password='NEW_PASSWORD'.

🎉 CloudPanel está en marcha: añada sus sitios, proteja el puerto 8443 y disfrute de una pila de alojamiento limpia en su VPS.