Instalar o aaPanel e uma stack LNMP num VPS Linux

O aaPanel é um painel web gratuito que instala e gere Nginx, MySQL/MariaDB, PHP, FTP e certificados SSL com poucos cliques. Num VPS Linux Infrawire, dá-lhe uma stack web LNMP pronta a usar sem editar ficheiros de configuração à mão. Este guia usa Ubuntu 24.04 ou Debian 12.

📋 Pré-requisitos

Um VPS KVM limpo com Ubuntu 24.04 ou Debian 12, sem servidor web nem outro painel instalado.
Acesso SSH como root e pelo menos 1 GB de RAM (2 GB é mais confortável para MySQL e PHP). Na sua área de cliente encontra o IP e a palavra-passe root do VPS.
Um domínio cujo registo A aponte para VPS_IP, se quiser alojar um site real.

🔄 1. Atualizar o sistema

Ligue-se como root e atualize os pacotes antes de instalar o que quer que seja.

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

⬇️ 2. Executar o instalador oficial

O nome do script de instalação contém um número de versão que muda com o tempo. Copie sempre o comando atual do site oficial do aaPanel (https://www.aapanel.com) e não de um tutorial antigo. À data de escrita, é assim:

Bash
1curl -ksSO https://www.aapanel.com/script/install_7.0_en.sh
2bash install_7.0_en.sh aapanel

O script pergunta se pode instalar o aaPanel no diretório /www: responda y. A instalação demora vários minutos. Por precaução, leia o script antes de o executar: é um simples ficheiro shell.

No fim, o instalador mostra o URL do painel, um nome de utilizador e uma palavra-passe. Copie-os de imediato, porque a palavra-passe é aleatória.

🔑 3. Recuperar o URL e as credenciais mais tarde

Se fechou o terminal, os dados de acesso estão disponíveis a qualquer momento com o comando bt:

Bash
1bt default

O URL tem o formato http://VPS_IP:PORT/SECURITY_PATH. A porta é aleatória e o caminho que a segue é a entrada de segurança: ambos são necessários para ver o formulário de login. Executar bt sem argumentos abre um menu interativo que também permite repor a palavra-passe, alterar o nome de utilizador ou a porta.

🧱 4. Instalar a stack LNMP

Após o primeiro login, o aaPanel sugere um conjunto de software recomendado. Escolha LNMP (Linux, Nginx, MySQL, PHP) e o método de instalação Fast, e depois selecione a versão do PHP de que a sua aplicação precisa. No mesmo ecrã pode também instalar o phpMyAdmin. A instalação continua em segundo plano e o progresso aparece na lista de tarefas.

Quando terminar, vá a Website > Add site, escreva example.com, crie uma base de dados se necessário e confirme. Coloque os seus ficheiros na raiz do site indicada pelo painel, normalmente em /www/wwwroot/example.com. Para ter HTTPS, abra as definições do site, SSL, escolha Let's Encrypt e peça o certificado quando o registo DNS já apontar para o VPS.

🔓 5. Abrir as portas necessárias

Abra as portas 80 e 443 para os sites, a 22 para SSH e a porta aleatória do painel. No painel, use Security > Firewall para adicionar uma regra por porta. Se usar UFW no Ubuntu, o equivalente é:

Bash
1ufw allow 22/tcp
2ufw allow 80/tcp
3ufw allow 443/tcp
4ufw allow PANEL_PORT/tcp
5ufw enable

Permita o SSH antes de ativar o UFW, caso contrário fica trancado fora. Substitua PANEL_PORT pela porta mostrada por bt default.

🛡️ 6. Proteger o painel

Em Settings, mude a porta do painel para outra porta alta e atualize a sua regra de firewall.
Mude a Security entrance (entrada de segurança) para um caminho personalizado difícil de adivinhar.
Altere o nome de utilizador e a palavra-passe predefinidos e ative a autenticação de dois fatores se a sua versão a oferecer.
Restrinja o acesso com Authorized IP se o seu endereço IP for estável.
Instale as atualizações com regularidade: use o aviso de atualização na página inicial do painel e mantenha o sistema atualizado com apt update && apt -y upgrade.
Remova da App Store o software que não usa.

O painel reinicia após uma mudança de porta; se perder o acesso, use bt por SSH para ler as novas definições.

✅ 7. Verificar

Bash
1bt default
2ss -tlnp | grep -E ':(80|443)\b'
3/www/server/nginx/sbin/nginx -t

O URL do painel deve abrir no navegador, as portas 80 e 443 devem estar à escuta quando existir um site, e o nginx -t deve indicar que a sintaxe está correta.

🧰 Resolução de problemas

A página do painel não carrega: a porta ou a firewall está a bloquear, ou omitiu o caminho de segurança. Verifique bt default e as regras da firewall e reinicie com /etc/init.d/bt restart.
Palavra-passe ou nome de utilizador esquecidos: execute bt e escolha a opção que altera a palavra-passe ou o nome de utilizador.
O instalador falha ou para: o sistema provavelmente não está limpo ou falta memória. Verifique free -h e df -h e reinstale o sistema operativo num VPS limpo se existia outro servidor web.
O Let's Encrypt falha: o domínio ainda não aponta para o VPS, ou a porta 80 está fechada. Corrija o DNS e a firewall e tente de novo.

🎉 O aaPanel e a sua stack LNMP estão prontos: crie os seus sites, proteja o painel e mantenha-o atualizado.