Passar para o conteúdo principal

Como instalar o PufferPanel no Linux (Ubuntu, Debian, AlmaLinux, Rocky Linux e CentOS)

O PufferPanel é um painel de gerenciamento de servidores de jogos leve, moderno e open-source. Ele foi projetado para criar e administrar servidores de jogos (como Minecraft, Rust, ARK, Terraria, FiveM, entre outros) de forma simplificada por meio de uma interface web intuitiva, consumindo pouquíssimos recursos do sistema operacional.

Requisitos

  • Um servidor VPS ou Bare Metal com instalação limpa de Ubuntu (20.04 ou superior), Debian (11 ou superior), AlmaLinux, Rocky Linux ou CentOS Stream;

  • Acesso administrativo de usuário root ou privilégios sudo via terminal SSH;

  • Mínimo de 1 vCPU e 12GB de RAM (o PufferPanel em si usa menos de 100 MB de memória, mas os servidores de jogos vão usar mais recursos);

  • Portas de rede liberadas no firewall:

    • 8080/TCP: Acesso à interface web do painel;

    • 5657/TCP: Porta interna do daemon (SFTP do PufferPanel);

    • Portas adicionais de acordo com os jogos que você for hospedar (ex: 25565 para Minecraft).

Passo 1: Atualizar o Sistema e Adicionar o Repositório Oficial

Conecte-se ao seu servidor via terminal SSH e adicione o repositório oficial mantido pela equipe do PufferPanel através do script do Packagecloud:

No Ubuntu ou Debian:

sudo apt update && sudo apt upgrade -y sudo apt install curl -y curl -s https://packagecloud.io/install/repositories/pufferpanel/pufferpanel/script.deb.sh | sudo bash

No AlmaLinux, Rocky Linux ou CentOS:

sudo dnf clean all && sudo dnf update -y sudo dnf install curl -y curl -s https://packagecloud.io/install/repositories/pufferpanel/pufferpanel/script.rpm.sh | sudo bash

Passo 2: Instalar o Pacote do PufferPanel

Com os repositórios configurados, instale o pacote oficial do PufferPanel:

No Ubuntu ou Debian:

sudo apt install pufferpanel -y

No AlmaLinux, Rocky Linux ou CentOS:

sudo dnf install pufferpanel -y

Passo 3: Criar o Usuário Administrador

Após a conclusão da instalação dos pacotes, você precisa criar o primeiro usuário administrativo para conseguir fazer login no painel:

sudo pufferpanel user add

O terminal solicitará os seguintes dados sequencialmente:

  1. Username: Nome de usuário (ex: admin);

  2. Email: Um email de contato válido;

  3. Password: Uma senha segura;

  4. Is this user an admin? (y/n): Digite y e pressione Enter para conceder permissões totais de administrador.

Passo 4: Iniciar o painel

Inicie o daemon do PufferPanel e configure-o para inicializar automaticamente com o boot do servidor:

sudo systemctl enable --now pufferpanel

Para verificar se o serviço está operando corretamente, execute:

sudo systemctl status pufferpanel

(O status exibido deve ser active (running)).

Passo 5: Liberar as Portas no Firewall

Abra as portas padrão da interface web e do serviço SFTP no firewall da sua distribuição:

No Ubuntu (UFW):

sudo ufw allow 8080/tcp sudo ufw allow 5657/tcp sudo ufw reload

No AlmaLinux / Rocky Linux / CentOS (Firewalld):

sudo firewall-cmd --permanent --add-port=8080/tcp sudo firewall-cmd --permanent --add-port=5657/tcp sudo firewall-cmd --reload

Passo 6: Acessar a Interface Web

Abra o seu navegador e acesse o endereço IP do seu servidor na porta 8080:

http://IP_DO_SEU_SERVIDOR:8080
  1. Insira o usuário (ou email) e a senha cadastrados no Passo 3;

  2. Na aba Templates, você poderá baixar modelos pré-configurados de servidores de jogos (Minecraft, Terraria, Rust, etc.);

  3. Na aba Servers, clique em Add Server para criar seu primeiro servidor de jogo diretamente pelo navegador.

Comandos Úteis do PufferPanel

  • Reiniciar o painel: sudo systemctl restart pufferpanel

  • Parar o painel: sudo systemctl stop pufferpanel

  • Ver logs de execução: sudo journalctl -u pufferpanel -f

  • Criar um novo usuário administrador no futuro: sudo pufferpanel user add

Respondeu à sua pergunta?