Instalar o CloudPanel num VPS Linux (Ubuntu/Debian)

O CloudPanel é um painel de controlo gratuito e leve que gere Nginx, PHP-FPM, bases de dados e certificados SSL a partir de uma interface web. Instalado num VPS Linux Infrawire, transforma um servidor vazio numa plataforma de alojamento multi-sites em poucos minutos. Este guia cobre Ubuntu 24.04 e Debian 12.

📋 Pré-requisitos

Um VPS KVM novo com Ubuntu 24.04 ou Debian 12, sem mais nada instalado (nem Apache, Nginx, MySQL ou outro painel).
Pelo menos 2 GB de RAM e acesso SSH como root. Na sua área de cliente encontra o IP e a palavra-passe root do VPS.
Um nome de domínio cujo registo DNS A (e AAAA se usar IPv6) aponte para VPS_IP.
As portas 22, 80, 443 e 8443 acessíveis a partir da Internet.

🔄 1. Preparar o sistema

Ligue-se como root e atualize os pacotes. O CloudPanel precisa de curl, wget e sudo.

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

Se o kernel foi atualizado, reinicie com reboot e volte a ligar-se antes de continuar.

⬇️ 2. Executar o instalador oficial

O instalador é primeiro descarregado e a sua soma SHA-256 é verificada antes da execução. A soma muda a cada versão do instalador: copie o valor atual e a lista atualizada de motores de base de dados da página oficial https://www.cloudpanel.io/docs/v2/getting-started/other/ (substitua SHA256_FROM_DOCS abaixo).

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

A variável CLOUD_PANEL_DB_ENGINE escolhe o servidor de base de dados. Os valores documentados são MYSQL_8.4, MYSQL_8.0, MARIADB_11.4 e MARIADB_10.11. Se a omitir, o instalador usa a sua escolha predefinida. O comando sha256sum -c deve mostrar install.sh: OK; se mostrar FAILED, pare e descarregue o ficheiro de novo. A instalação demora alguns minutos.

🔑 3. Criar a primeira conta de administrador

Abra https://VPS_IP:8443 no navegador. O certificado é autoassinado, por isso o navegador mostra um aviso: aceite-o para este primeiro acesso.

O primeiro visitante cria o administrador, portanto faça-o logo. Preencha o nome de utilizador, o e-mail e uma palavra-passe longa, e inicie sessão. Não deixe o painel exposto durante horas antes de criar a conta.

🌐 4. Adicionar um site PHP

No painel, clique em Sites, depois em Add Site e em Create a PHP Site. Escolha um modelo de aplicação (Generic, WordPress, Laravel, etc.), indique example.com como domínio, selecione uma versão do PHP e defina o utilizador e a palavra-passe do site. O CloudPanel cria o vhost Nginx, um pool PHP-FPM e um utilizador de sistema dedicado ao site.

Envie os seus ficheiros por SFTP com o utilizador do site (não o root) para /home/USER/htdocs/example.com. Também pode criar uma base de dados para o site em Databases.

🔒 5. Emitir um certificado Let's Encrypt

Verifique se example.com já aponta para VPS_IP:

Bash
1dig +short example.com

Depois abra o site, vá ao separador SSL/TLS, clique em Actions e escolha New Let's Encrypt Certificate. Selecione os nomes de domínio a incluir e confirme. A renovação é tratada automaticamente pelo CloudPanel.

🛡️ 6. Proteger o painel

Em Admin Area > Security > Firewall, limite a porta 8443 ao seu próprio endereço IP e remova a regra que a permite a partir de qualquer lado. Mantenha 22, 80 e 443 abertas conforme necessário.
Em Admin Area > Security, ative o Basic Auth no painel como segunda barreira.
No seu perfil de utilizador, ative a autenticação de dois fatores.
Use uma palavra-passe longa e única e mantenha o sistema atualizado:

Bash
1apt update && apt -y upgrade

✅ 7. Verificar a instalação

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

As portas 80, 443 e 8443 devem estar à escuta, os dois serviços devem responder active, e o último comando deve devolver HTTP 200 ou um redirecionamento com certificado válido.

🧰 Resolução de problemas

O instalador recusa-se a arrancar ou falha a meio: o CloudPanel tem de ser instalado num sistema limpo. Se já existia outro servidor web ou base de dados, reinstale o sistema operativo a partir da sua área de cliente e recomece.
A porta 8443 não responde: verifique se a firewall (regras do painel e qualquer outra firewall) a permite e se o seu IP não foi retirado da lista autorizada. Execute ss -tlnp | grep 8443 no servidor.
O Let's Encrypt falha: o domínio ainda não aponta para o VPS, ou um proxy esconde o IP real. Corrija o registo DNS, aguarde a propagação e tente de novo. A porta 80 tem de estar aberta.
Palavra-passe de admin perdida: reponha-a a partir da shell com clpctl user:reset:password --userName='admin' --password='NEW_PASSWORD'.

🎉 O CloudPanel está a funcionar: adicione os seus sites, proteja a porta 8443 e desfrute de uma stack de alojamento limpa no seu VPS.