Capítulos deste vídeo

O que é

Perder o acesso ao painel tem solução — há um caminho de fallback pelo IP e ferramentas de
emergência via SSH. O sintoma define a saída.

Não abre pelo domínio

Se o painel não carrega pelo domínio (SSL não emitiu, DNS mudou):

  1. Acesse pelo IP na porta 2222: https://SEU_IP:2222.
  2. Faça login normalmente.
  3. Reemita o SSL / reconfigure o domínio em Domínio do painel.

O acesso pelo IP é limitado — alguns recursos da gestão de sites não funcionam sobre o IP (sem
SSL válido). Use-o para destravar e volte ao domínio.

Você foi banido (fail2ban)

Se você não acessa de lugar nenhum e suspeita de ban do fail2ban (errou senha várias vezes), remova
o ban do seu IP:

gws-cli unban SEU_IP

E adicione seu IP à whitelist depois (ver Fail2ban).

Esqueceu a senha

  • Na tela de login, use Recuperar senha (requer SMTP configurado).
  • Ou, via SSH, troque a senha direto: gws-cli passwd.

Não recebe o código 2FA

Se o SMTP parou e você não recebe o código do 2FA por e-mail (ou perdeu o app autenticador), desative
o 2FA pela CLI de emergência:

gws-cli 2fa-disable

Depois faça login com usuário e senha, corrija o SMTP e reative o 2FA pelo perfil (ver
Autenticação em duas etapas).

A CLI de emergência

O gws-cli (em /usr/local/bin/gws-cli) é a caixa de ferramentas para essas situações via SSH:
users, passwd, 2fa-disable, unban, status. Ver Automação e CLI.

Veja também