FASTPANELWIKI

Início rápido

Como atualizar o FASTPANEL®

Nesta página

Por padrão, o FASTPANEL® é atualizado automaticamente de acordo com o agendamento definido pelo agendador Cron. Você não precisa realizar nenhuma ação adicional para que o painel seja atualizado.

Atualização manual

Se, por algum motivo, for necessário forçar uma atualização, execute o seguinte comando no console via SSH:

/usr/local/fastpanel2/app/updater

Um arquivo executável será iniciado, o que atualizará o FASTPANEL® para a versão mais recente.

Configurar chaves SSH

Nesta página

No FASTPANEL® você pode adicionar chaves SSH para usuários a fim de simplificar e proteger o acesso ao servidor.

As chaves SSH (Public Key Authentication) fornecem uma maneira segura e conveniente de acessar um servidor sem usar senhas, com base em um par de chaves privada e pública. Em vez de digitar uma senha todas as vezes, o cliente usa a chave privada, enquanto o servidor a verifica em relação à chave pública, melhorando tanto a segurança quanto a usabilidade.

Criação de par de chaves

aviso

Mantenha sua chave privada em segurança e nunca a compartilhe com ninguém.

Primeiro, você precisa gerar seu par de chaves privada e pública.

macOS / Linux

Abra um terminal e execute:

ssh-keygen

Pressione Enter para aceitar o local padrão do arquivo e defina uma frase secreta, se necessário.
Suas chaves serão salvas em ~/.ssh/id_ed25519 (privada) e ~/.ssh/id_ed25519.pub (pública).

Windows

OpenSSH

Abra o PowerShell e execute:

ssh-keygen

Pressione Enter para aceitar o local padrão do arquivo e defina uma frase secreta, se necessário.
Suas chaves serão salvas em C:\Users\YourUser\.ssh\id_ed25519 (privada) e C:\Users\YourUser\.ssh\id_ed25519.pub (pública).

PuTTYgen
  1. Baixe e instale o PuTTYgen.
  2. Inicie o PuTTYgen e clique em "Generate".
  1. Mova o cursor do mouse aleatoriamente sobre a janela do PuTTYgen até que o processo de geração seja concluído.
  2. Salve a chave privada (.ppk) e copie o texto da chave pública.

Adicionar uma chave pública ao painel

Abra o FASTPANEL® e clique no seu nome de usuário no canto superior direito da tela. Em seguida, selecione "SSH Keys".

Clique no botão "Add SSH key".

  • No primeiro campo, cole sua chave pública (ela geralmente começa com ssh-ed25519 ou ssh-rsa, dependendo do algoritmo escolhido) da seção anterior.

  • No segundo campo, você pode adicionar uma descrição para ajudar a diferenciar a chave.

Depois disso, você poderá se conectar ao seu servidor via SSH usando as credenciais do proprietário do site, sem digitar uma senha.

Habilitar acesso SSH e gerenciar chaves existentes

Se você precisar gerenciar as chaves de outros usuários ou remover chaves do usuário atual, vá para "Management" → "Users". Clique nos três pontos ao lado do usuário cujas chaves você deseja gerenciar.

Na seção aberta, você pode:

  1. Adicionar uma nova chave.
  2. Excluir uma chave existente.
  3. Habilitar ou desabilitar o acesso SSH para o usuário.

Configuração de NAT

Nesta página

NAT é um mecanismo de tradução de endereços de rede que traduz os endereços IP dos pacotes. O NAT permite que servidores em uma rede local funcionem com servidores em uma rede externa.

Se o servidor com FASTPANEL® tiver um endereço IP privado e o NAT estiver configurado na rede local, para garantir o funcionamento correto com domínios DNS, sites e serviços de e-mail, você deverá configurar o mapeamento dos endereços IP privado e público do servidor.

Para configurar o mapeamento de endereços IP:

  1. Abra o menu lateral esquerdo → "Gerenciamento de IP" → "Mapeamento de IP"

  2. Clique em "Adicionar"

  3. Para os endereços IP locais, insira o endereço IP público correspondente

  4. Clique em "Salvar"

Após configurar o mapeamento de endereços, os endereços IP internos serão convertidos em endereços IP externos ao criar domínios DNS.

Lista de portas para encaminhamento

Para o funcionamento correto dos principais serviços, você precisa configurar o encaminhamento das seguintes portas:

  • FASTPANEL: 8888, 7777

  • FTP: 21, 65000-65500

  • SSH: 22

  • SFTP: 2222

  • HTTP, HTTPS: 80, 443

  • IMAP, IMAPS: 143, 993

  • POP3, POP3S: 110, 995

  • SMTP, SMTPS: 25, 587, 465

  • DNS(se o bind9 for usado): 53

Outros serviços, como o MySQL, normalmente funcionam apenas em IPs locais e não exigem acesso público.

Definir endereço do painel

Nesta página

Introdução

Além do acesso padrão ao FASTPANEL® por endereço IP, você também pode definir qualquer domínio ou subdomínio apontado para o seu servidor com o FASTPANEL® instalado como o endereço do painel.

Para começar, verifique se existe um registro A válido para o nome de domínio que você deseja usar como endereço do painel. Você pode verificar isso usando os comandos:

Windows:

nslookup example.com

Linux/MacOS:

host example.com

Se o registro A estiver correto, você verá a seguinte saída:

example.com has address $IP_ADDRESS

Onde, em vez de $IP_ADDRESS, deve ser especificado o endereço IP do seu servidor. Se houver um endereço diferente, corrija-o na conta do seu provedor de DNS e aguarde a atualização do cache DNS. Esse processo normalmente leva de 20 a 60 minutos.

Definindo o endereço do painel

Para definir um dos seus domínios ou subdomínios como endereço do painel, acesse “Configurações” -> “Principal” -> “Endereços do painel” e clique no botão azul “Adicionar endereço”.

Na próxima janela, adicione o domínio que deseja usar como endereço do painel e clique em "Salvar".

Depois disso, o FASTPANEL® estará disponível em um endereço:

example.com:8888

Acesso direto

Para configurar o acesso direto sem especificar a porta 8888, clique no ícone de lápis ao lado do endereço do painel definido:

Em seguida, ative a caixa de seleção "Acesso direto" e selecione os endereços IP que deseja usar para esse nome de domínio:

E clique em "Salvar".

Certificado SSL para o endereço do painel

Para o endereço do painel, você pode emitir um certificado SSL gratuito da Let's Encrypt, usar um certificado pago existente ou um certificado autoassinado. Para fazer isso, clique no texto azul "SSL" ao lado do endereço do painel:

Em seguida, na janela que será aberta, selecione o tipo de certificado:

E clique em "Salvar".

Possíveis problemas

Observe que é melhor usar um domínio que não esteja atrás do Cloudflare como endereço do FASTPANEL®, pois isso pode causar problemas com o FASTPANEL® ao acessar por nome de domínio devido a limitações do lado do Cloudflare.

Se surgirem problemas ao usar esse tipo de domínio, verifique se eles também ocorrem ao acessar o painel pelo endereço IP. Caso contrário, desative o proxy para o nome de domínio usado como endereço do seu FASTPANEL® na seção DNS do Cloudflare.

Como desinstalar o FASTPANEL®

importante

Se você quiser mudar do FASTPANEL® para um painel de controle diferente, reinstalar o sistema operacional (SO) é a única maneira de prosseguir. Antes de fazer isso, é crucial fazer backup de todos os dados importantes em um armazenamento externo. Isso garantirá que você possa restaurar seus projetos após a reinstalação.

O FASTPANEL® pode ser desinstalado sem interromper o funcionamento dos sites. No entanto, isso levará a consequências como:

  • Interrupção da renovação automática dos certificados SSL da Let's Encrypt emitidos por meio do FASTPANEL®.
  • Desativação das tarefas de backup configuradas anteriormente no FASTPANEL®.
  • Você poderá alterar as configurações do site, criar e editar usuários, caixas de correio, contas FTP/SFTP etc. apenas por meio de configuração manual.

Se você tem certeza de que deseja desinstalar o FASTPANEL® e entende totalmente as consequências, pode fazer isso executando os seguintes comandos no console do servidor como root:

Debian/Ubuntu:

apt-get remove fastpanel2 fastpanel2-nginx

CentOS/AlmaLinux/RockyLinux:

yum remove fastpanel2 fastpanel2-nginx

Se você precisar restaurar o funcionamento do FASTPANEL® no futuro, poderá reinstalar os pacotes desinstalados anteriormente. No entanto, não há garantia de que o painel de controle retomará o funcionamento correto após isso.
Para instalar os pacotes do FASTPANEL®, use os comandos:

Debian/Ubuntu:

apt-get update
apt-get install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

CentOS/AlmaLinux/RockyLinux:

yum makecache
yum install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

Como instalar o FASTPANEL®

importante

O painel só pode ser instalado em um sistema operacional limpo, sem nenhum software pré-instalado. A instalação em um servidor com software pré-configurado não é possível!

Para instalar o FASTPANEL®, é necessário um servidor virtual (VPS) ou dedicado com acesso root.

O hardware do servidor deve atender aos requisitos mínimos do sistema:

RAM: 1G
Espaço livre: 5Gb
CPU: 1 núcleo, 1 Ghz

Os sistemas operacionais compatíveis são os seguintes (somente arquitetura de 64 bits):

Debian: 9, 10, 11, 12

Ubuntu: 18.04, 20.04, 22.04, 24.04

CentOS: 7

AlmaLinux: 8

Rocky Linux: 8


Após a instalação de um dos sistemas operacionais compatíveis, é necessário realizar as seguintes ações:

  1. Conecte-se ao servidor via SSH usando a senha de root:

    ssh root@your.server
  2. Instale as atualizações mais recentes do sistema operacional e o utilitário wget, que é necessário para executar o script de instalação do painel de controle. Depois disso, reinicie o servidor:

    Debian / Ubuntu:

    apt-get update && apt-get upgrade && apt-get install ca-certificates wget && reboot

    CentOS / AlmaLinux / Rocky Linux:

    yum makecache && yum update && yum install ca-certificates wget && reboot
  3. Após a reinicialização do servidor, execute o processo de instalação do FASTPANEL® executando o seguinte comando:

    dica

    Ao instalar o painel, você pode escolher a versão do MySQL. Você pode saber mais neste artigo.

    wget https://repo.fastpanel.direct/install_fastpanel.sh -O - | bash -
  4. Depois que o FASTPANEL® for instalado, você receberá uma mensagem com os dados de acesso:

    Parabéns! FASTPANEL instalado com sucesso e disponível para você em https://1.2.3.4:8888
    Login: fastuser
    Senha: password

O FASTPANEL Extended está habilitado por padrão para todos os usuários. Não é necessário ativar uma licença.

Como redefinir a senha

Nesta página

Introdução

FASTPANEL® oferece duas maneiras diferentes de alterar a senha de qualquer usuário:

Alterando a senha pelo próprio FASTPANEL

Essa forma é adequada se a senha anterior for conhecida (o acesso ao painel não foi perdido).

Para usar esta opção, você precisa fazer login no FASTPANEL® e ir ao menu "Management" → "Users" e, em seguida, clicar em "Change Password"

Na janela modal que se abre, digite sua senha antiga e, em seguida, digite uma nova senha duas vezes e, depois disso, clique no botão "Save"

Alterando a senha via SSH

Essa forma é adequada se a senha anterior for desconhecida (o acesso ao painel foi perdido). Para alterar a senha via SSH, a senha antiga não é necessária.

Para usar esta opção, você precisa:

  1. Conectar-se ao seu servidor via SSH usando sua senha de root:

    ssh root@your.server
  2. Use um comando passwd user_name

    Por exemplo, para alterar a senha do usuário chamado fastuser, o comando deve ser parecido com:

    passwd fastuser

    Depois que você executar o comando, será necessário inserir e confirmar uma nova senha

    observação

    nenhum caractere será exibido na tela durante a digitação e a confirmação de uma nova senha.

  3. Se a alteração da senha for bem-sucedida, você receberá a seguinte mensagem:

    passwd: password updated successfully

Depois disso, você poderá fazer login no painel usando sua nova senha