Documentação

Primeiros passos

Em poucos minutos você sai do cadastro para o terminal do seu servidor:

1. Crie sua conta em Começar Grátis com nome, e-mail e senha. Marque o aceite dos Termos e da Privacidade.
2. Confirme seu e-mail clicando no link que enviamos. Não chegou? Olhe a caixa de spam/promoções e, na tela de verificação, clique em Reenviar Email de Verificação.
3. Ative a autenticação em dois fatores — é obrigatória e aparece logo após o primeiro login (passo a passo em Segurança e 2FA). Guarde os códigos de backup!
4. Confira os requisitos do seu servidor em Requisitos do servidor.
5. Adicione o servidor seguindo Adicionar um servidor.
6. Pronto: abra o Terminal, os Arquivos ou o Monitor na página do servidor.

Mapa do painel

Na página de cada servidor você encontra os botões:

Requisitos do servidor

O EzServer se conecta ao seu servidor por SSH — não é preciso instalar nenhum agente. Basta que:

• O servidor rode Linux (Ubuntu, Debian, AlmaLinux, Rocky, CentOS e derivados). Ubuntu 20.04+ e Debian 11+ são os mais testados.
• Tenha um IP público fixo (IPv4) acessível pela internet.
• A porta SSH (padrão 22) esteja liberada no firewall do servidor e no firewall/"security group" do provedor.
• Você tenha um usuário com acesso SSH — de preferência root, para que monitoramento, serviços e backups funcionem completamente.

Verificar antes de cadastrar

Do seu computador, confirme que consegue entrar no servidor:

ssh -p 22 root@SEU_IP

Se esse comando não funcionar do seu computador, também não vai funcionar pelo EzServer — resolva primeiro com o provedor (veja Solução de problemas).

Firewall (UFW) e Fail2ban

Se você usa ufw, garanta que o SSH esteja liberado:

sudo ufw allow 22/tcp
sudo ufw status

Se o servidor usa Fail2ban e você errou a senha várias vezes, o IP do EzServer pode ter sido bloqueado. Libere com:

sudo fail2ban-client status sshd
sudo fail2ban-client set sshd unbanip IP_BLOQUEADO

Adicionar um servidor

1. No painel, clique em Novo Servidor (em Ações Rápidas, no menu lateral) ou, na lista de Servidores, no botão Novo Servidor.
2. Preencha os campos:

3. Em Opções Adicionais, marque Testar conexão SSH antes de criar — assim você descobre na hora se IP, porta ou credencial estão errados. Marque também Auto-detectar configuração do servidor para o EzServer identificar sistema, serviços e aplicações.
4. Clique em Criar Servidor. Você será levado à página do servidor, de onde abre o terminal, os arquivos, o monitoramento e os backups.

Deu erro ao criar?

• "O endereço IP deve ser válido" — você digitou um domínio ou incluiu http://. Use só o IP.
• "Você atingiu o limite de N servidores do seu plano" — veja Planos e assinatura.
• Falha no teste de conexão — consulte a tabela em Solução de problemas.

Trocar a senha ou a chave depois

Na lista de Servidores, clique no ícone de lápis (Editar Configurações) do servidor e informe a nova senha ou chave. Sempre que você trocar a senha de root no servidor, atualize-a também no EzServer.

Usar chave SSH (recomendado)

Chaves SSH são mais seguras que senha e não expiram quando alguém troca a senha do servidor. Crie uma chave exclusiva para o EzServer e sem frase-senha (passphrase) — o EzServer não consegue usar chaves protegidas por passphrase.

1. Gere a chave no seu computador

Funciona no Linux, macOS e Windows 10/11 (PowerShell):

ssh-keygen -t ed25519 -C "ezserver" -f ~/.ssh/ezserver -N ""

Isso cria dois arquivos: ~/.ssh/ezserver (chave privada) e ~/.ssh/ezserver.pub (chave pública). No Windows, ~ é C:\Users\SEU_USUARIO. Se o comando perguntar uma passphrase, apenas aperte Enter duas vezes (deixe em branco).

2. Autorize a chave pública no servidor

Linux/macOS:

ssh-copy-id -i ~/.ssh/ezserver.pub root@SEU_IP

Windows (PowerShell) ou manualmente — entre no servidor e rode, colando o conteúdo do ezserver.pub no lugar indicado:

mkdir -p ~/.ssh && chmod 700 ~/.ssh
echo "COLE_AQUI_O_CONTEUDO_DO_ezserver.pub" >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

3. Teste e cadastre

ssh -i ~/.ssh/ezserver root@SEU_IP

Se entrou sem pedir senha, mostre a chave privada e copie todo o conteúdo, incluindo as linhas -----BEGIN ...----- e -----END ...-----:

cat ~/.ssh/ezserver

No cadastro do servidor, escolha Método de Autenticação → Chave SSH e cole no campo Chave SSH Privada.

Cuidados

• Cole a chave privada (sem .pub). A pública começa com ssh-ed25519 ou ssh-rsa e não funciona nesse campo.
• Chaves no formato PuTTY (.ppk) precisam ser convertidas: no PuTTYgen, Conversions → Export OpenSSH key.
• Se aparecer "SSH private key is invalid or unreadable", a chave foi colada incompleta ou tem passphrase — gere uma nova com o comando acima e salve de novo no servidor.

Terminal SSH

O terminal roda direto no navegador — nada para instalar. Abra a página do servidor e clique em Terminal (ou no ícone de terminal na lista de Servidores).

Barra de ferramentas

Sessões que não se perdem

Se o servidor tiver o tmux instalado, o EzServer abre o terminal dentro de uma sessão chamada ezserver. Assim, se a internet cair ou você fechar a aba, o comando continua rodando e, ao reconectar, você volta exatamente onde estava. Para ativar, instale o tmux no servidor:

# Ubuntu / Debian
apt install -y tmux

# AlmaLinux / Rocky / CentOS
dnf install -y tmux

Sem tmux, o terminal funciona normalmente, mas um comando em execução é interrompido se a conexão cair. Para tarefas longas (ex.: atualizações, importação de banco), prefira ter o tmux instalado.

Dicas

• Copiar/colar: selecione o texto e use o botão Copiar; para colar, use Ctrl+V (ou Cmd+V no Mac) com o terminal em foco.
• O terminal usa as mesmas credenciais cadastradas no servidor. Se aparecer erro de autenticação, atualize a senha ou a chave (veja Adicionar um servidor).

Gerenciador de arquivos

Na página do servidor, clique em Arquivos. Você navega pelas pastas como em um explorador de arquivos, com os mesmos privilégios do usuário SSH cadastrado.

Navegação

• Digite um caminho na barra de endereço (ex.: /var/www) e clique em Ir. Use Voltar e Atualizar na barra de ferramentas.
• Duplo clique abre pastas; em arquivos de texto, abre o editor.
• Ative Mostrar Ocultos para ver arquivos como .env e .htaccess.
• Atalhos: Ctrl+A seleciona tudo, Ctrl+C / Ctrl+V copiam e colam, Delete exclui a seleção.

Ações (botão direito sobre o item)

Para criar uma pasta, use Nova Pasta na barra de ferramentas. Comprimir, extrair e alterar permissões rodam em segundo plano: acompanhe pelo aviso no canto da tela e a lista é atualizada ao terminar.

Uploads

• Clique em Upload e selecione ou arraste os arquivos: até 20 arquivos por vez e 1 GB por arquivo.
• Arquivos grandes são enviados em partes; mantenha a aba aberta até a barra de progresso concluir.
• Para enviar um site inteiro, comprima-o em .zip no seu computador, faça upload e use Extrair.

Downloads

• Downloads são preparados em segundo plano (até 10 GB). Quando ficam prontos, aparece um link válido por 60 minutos.
• Ao baixar vários itens ou uma pasta, eles chegam compactados em .zip (ou .tar.gz se o servidor não tiver zip).
• Pastas de sistema como /proc, /sys, /dev e /boot não podem ser baixadas.

"Permissão negada"?

O gerenciador tem os mesmos privilégios do usuário SSH. Se você cadastrou um usuário comum, ele não consegue alterar arquivos de outros usuários (ex.: de root ou www-data). Use root no cadastro ou ajuste o dono dos arquivos pelo terminal.

Monitoramento

O EzServer lê as métricas pela própria conexão SSH — nenhum agente é instalado. São coletados uso de CPU, memória, disco (partição /) e carga média (load 1/5/15 min).

Na lista de servidores

• Cada servidor mostra CPU, memória, disco e o status (Online, Offline).
• Com Auto ON ativado, a lista se atualiza sozinha enquanto a página estiver aberta. Use Atualizar Todos para forçar uma leitura agora.
• Desconhecido significa que ainda não houve nenhuma leitura; Online (dados antigos), que a última leitura tem mais de 10 minutos. Clique em atualizar para buscar dados novos.

Página Monitor

Na página do servidor, clique em Monitor para a visão detalhada. Use Coletar Métricas para uma leitura imediata. As abas mostram:

Servidor aparece Offline?

Offline quer dizer que o EzServer não conseguiu se conectar por SSH na última tentativa — não necessariamente que o servidor caiu. Teste o acesso pelo Terminal; se falhar, veja Solução de problemas.

Backups

Os backups são enviados para um armazenamento externo seguro (object storage), fora do seu servidor. Assim, mesmo que o servidor seja perdido, a cópia continua disponível.

Fazer um backup agora

1. Na página do servidor, clique em Backups e depois em Backup Rápido.
2. Escolha o Tipo de Backup:
   • Completo — arquivos e bancos de dados;
   • Apenas Banco de Dados;
   • Apenas Arquivos.
3. Opcional: marque Comprimir backup (recomendado) e Criptografar backup. Se criptografar, informe uma Chave de Criptografia com pelo menos 16 caracteres e guarde-a — sem ela o backup não pode ser aberto, e nós não temos como recuperá-la.
4. Confirme. O backup roda em segundo plano e aparece na lista com o progresso; você pode sair da página.

Baixar e consultar

• Na lista de backups do servidor, use o ícone de Download para baixar e Detalhes para ver o conteúdo e o tamanho.
• A página Backups do menu lateral reúne os backups de todos os seus servidores.

Restaurar

Para restaurar um backup em um servidor, fale com o suporte informando o servidor e a data do backup — fazemos a restauração com você, com segurança. Se preferir restaurar por conta própria, baixe o backup e extraia os arquivos pelo Gerenciador de arquivos (use Extrair) ou importe o .sql no seu banco.

Boas práticas

• Faça um Backup Rápido antes de qualquer mudança grande: atualização do sistema, migração de banco, deploy de nova versão.
• De tempos em tempos, baixe um backup e confira se ele abre — backup que nunca foi testado não é backup.
• Backups grandes demoram; o tempo depende do tamanho dos arquivos e da velocidade de upload do seu servidor.

Serviços e bancos de dados

Serviços

Na página do servidor, clique em Serviços para ver os serviços do sistema (nginx, apache, mysql, php-fpm, redis, docker etc.) e o estado de cada um. Para cada serviço você pode:

• Iniciar, Parar ou Reiniciar;
• ver os logs recentes — o primeiro lugar a olhar quando algo não sobe;
• instalar serviços comuns que ainda não existem no servidor (Ubuntu/Debian e, para alguns pacotes, AlmaLinux/Rocky/CentOS).

Atenção: parar ou reiniciar o servidor web ou o banco de dados derruba o site por alguns segundos. Prefira horários de pouco movimento.

Bancos de dados

Clique em Banco de Dados na página do servidor. O EzServer procura bancos MySQL/MariaDB, PostgreSQL e MongoDB e permite:

• navegar pelas tabelas e ver a estrutura;
• executar consultas SQL;
• exportar e importar dados.

Consultas como DELETE, DROP e UPDATE sem WHERE são executadas de verdade e não têm como desfazer — faça um Backup Rápido antes.

Se nenhum banco aparecer, confira pelo Terminal se o serviço está rodando (systemctl status mysql) e se o usuário SSH tem acesso a ele.

Observação: as páginas de Serviços e de Banco de Dados ficam disponíveis apenas para o dono do servidor (não para usuários com quem ele foi compartilhado).

Domínios e DNS

Em Domínios (menu lateral) você cadastra os domínios dos seus projetos e os associa aos servidores, mantendo tudo organizado em um só lugar. Em Gerenciamento DNS você registra as zonas e os registros (A, AAAA, CNAME, MX, TXT, NS, SRV e CAA) de cada domínio.

Cadastrar um domínio

1. Clique em Novo Domínio (em Ações Rápidas, no menu lateral).
2. Digite o domínio completo (ex.: minhaloja.com.br ou app.minhaloja.com.br).
3. Escolha o Tipo de Domínio — para a maioria dos casos, Domínio Externo (o DNS continua no seu provedor atual) — e, se quiser, selecione o servidor.
4. Clique em Criar Domínio.

Apontar o domínio para o seu servidor

Os registros que fazem o domínio abrir o seu site são publicados pelo provedor de DNS do domínio — normalmente onde você o registrou (Registro.br, GoDaddy, Hostinger, Cloudflare…). Os registros cadastrados no EzServer servem como referência e organização; configure-os também no seu provedor para que passem a valer na internet. No painel do provedor, crie:

A propagação costuma levar de alguns minutos a algumas horas. Para conferir de onde o domínio está respondendo:

dig +short minhaloja.com.br
nslookup minhaloja.com.br

O resultado deve ser o IP do seu servidor. Se usar Cloudflare com o proxy ligado (nuvem laranja), aparecerão IPs da Cloudflare — isso é normal.

Dicas

• Ao migrar um site de servidor, reduza o TTL do registro A para 300 um dia antes; a troca de IP passa a valer mais rápido.
• O certificado SSL (HTTPS) só pode ser emitido depois que o domínio já aponta para o servidor.

Compartilhar com a equipe

Dê acesso a servidores e domínios para colegas, freelancers ou clientes — sem passar senhas. Cada pessoa usa a própria conta EzServer (com 2FA) e você pode revogar o acesso a qualquer momento.

Convidar alguém

1. A pessoa precisa já ter uma conta no EzServer. Se ainda não tiver, peça que se cadastre primeiro.
2. No menu lateral, abra Compartilhamentos e clique em Novo Compartilhamento.
3. Digite o e-mail da conta dela e clique em Validar.
4. Marque os servidores e/ou domínios que serão compartilhados.
5. Escolha as permissões e clique em 📧 Enviar Convite.

O que cada permissão libera

Excluir o servidor, ver Serviços e Banco de Dados continuam exclusivos do dono. Como Editar dá acesso ao terminal, conceda apenas a quem você confia.

Aceitar um convite

1. Abra o e-mail do convite e clique no link. Se não estiver logado, você será levado ao login — entre com a mesma conta do e-mail convidado.
2. Revise os recursos e clique em Aceitar Recursos Selecionados (ou Recusar Convite).
3. Os itens aceitos aparecem nas suas listas, marcados como compartilhados.

O convite vale por 7 dias. Se expirar, peça um novo. Convites pendentes também aparecem em Compartilhamentos → Pendentes.

Revogar

Em Compartilhamentos → Enviados, clique em Revogar. O acesso é removido na hora.

Importar e exportar servidores

Leve sua lista de servidores (com credenciais) de uma conta EzServer para outra — útil para trocar de conta, consolidar equipes ou manter uma cópia de segurança do cadastro.

Exportar

1. Em Servidores, clique em Importar/Exportar.
2. Clique em Exportar Servidores. Será baixado um arquivo .esexport.

Guarde esse arquivo como se fosse uma senha: ele contém os dados de acesso SSH de todos os servidores exportados. Não envie por e-mail/WhatsApp e apague-o depois de importar.

Importar

1. Na mesma tela, em Importar Servidores, selecione o arquivo .esexport (até 10 MB).
2. Escolha o que fazer com servidores que já existem na conta (a comparação é pelo IP):
   • Ignorar (Skip) — mantém o servidor atual e pula o do arquivo (padrão, mais seguro);
   • Substituir — troca os dados atuais pelos do arquivo;
   • Mesclar — combina as informações.
3. Confirme. Ao final aparece o resumo: Novos, Substituídos, Mesclados, Ignorados e Falhas.

Limites

• A importação respeita o limite de servidores do seu plano. Se aparecer "Limite atingido", faça upgrade em Assinatura antes de importar.
• Só é possível uma importação/exportação por vez, com no máximo 5 operações por minuto.

IA Assistente

O Assistente IA SSH fica ao lado do terminal. Você descreve o que quer em português e ele monta o comando certo para o seu servidor, executa e explica o resultado.

Como usar

1. Abra o Terminal do servidor e aguarde conectar. No computador, o painel da IA aparece à direita; no celular, toque em Assistente IA.
2. Digite o pedido e pressione Enter (Shift+Enter quebra linha). Exemplos:
   • "quanto espaço livre tem no disco?"
   • "por que o nginx não está subindo?"
   • "quais processos estão usando mais memória?"
3. Ou use os atalhos: 📊 Status, 💾 Espaço, 🧠 Memória, ⚙️ Processos e 📋 Logs.

Importante: os comandos são executados automaticamente

Quando a IA gera um comando, ele é executado no servidor na hora (a mensagem mostra "📝 Executando: …"). Comandos claramente destrutivos, como rm -rf /, são bloqueados, mas ainda assim:

• peça consultas e diagnósticos com liberdade; para alterações (apagar, reiniciar, instalar), prefira pedir "me diga o comando para…" e rodá-lo você mesmo no terminal depois de conferir;
• faça um Backup Rápido antes de mudanças importantes.

Se aparecer "⚠️ Terminal desconectado"

A IA usa a conexão do terminal. Clique em Reconectar no terminal e tente de novo.

Usar o EzServer com o Claude (MCP)

Com o Model Context Protocol (MCP), o Claude Desktop ou o Claude Code passam a enxergar seus servidores do EzServer: você pede em linguagem natural ("qual servidor está com o disco mais cheio?") e o Claude consulta ou executa comandos com segurança, pela sua conta.

Ferramentas disponíveis

Pré-requisitos

• Node.js 18 ou superior instalado no seu computador. Confira com node --version; se não tiver, baixe em nodejs.org (versão LTS).
• Claude Desktop ou Claude Code instalado.

Passo 1 — Baixe o cliente e copie seus dados

1. No painel, abra Perfil e role até Integração MCP (Claude Desktop).
2. Clique em Baixar mcp-client.js e salve o arquivo (ex.: na pasta Downloads). Anote o caminho completo.
3. Na mesma seção, escolha a aba Windows ou Mac/Linux e clique em Copiar. O JSON já vem com seu Token API MCP e seu USER_ID preenchidos.

Passo 2a — Claude Desktop

1. Abra o arquivo de configuração do Claude Desktop (crie-o se não existir):
   • Windows: pressione Win + R, digite %APPDATA%\Claude e abra claude_desktop_config.json.
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. Cole o JSON copiado e troque SEU_USUARIO pelo caminho real onde salvou o mcp-client.js. O arquivo deve ficar assim:

{
  "mcpServers": {
    "ezserver-ssh": {
      "command": "node",
      "args": ["C:\\Users\\maria\\Downloads\\mcp-client.js"],
      "env": {
        "MCP_API_KEY": "SEU_TOKEN_MCP",
        "USER_ID": "SEU_USER_ID",
        "MCP_SERVER_URL": "https://ezserver.app"
      }
    }
  }
}

• No Windows, as barras do caminho precisam ser duplas (\\), como no exemplo.
• Se o arquivo já tiver outros servidores em mcpServers, adicione apenas o bloco "ezserver-ssh" dentro dele — não duplique a chave mcpServers.

3. Salve e feche completamente o Claude Desktop (inclusive pelo ícone da bandeja/barra de menus) e abra de novo.
4. Teste pedindo: "Liste meus servidores do EzServer".

Passo 2b — Claude Code (terminal)

Rode o comando abaixo trocando o token, o ID e o caminho do arquivo:

claude mcp add ezserver-ssh \
  -e MCP_API_KEY=SEU_TOKEN_MCP \
  -e USER_ID=SEU_USER_ID \
  -e MCP_SERVER_URL=https://ezserver.app \
  -- node /caminho/para/mcp-client.js

Confira com claude mcp list — o ezserver-ssh deve aparecer como conectado.

Problemas comuns

Trate o token MCP como uma senha: quem tiver o token pode executar comandos nos seus servidores. Se ele vazar, clique em Regenerar Token.

Segurança e autenticação em dois fatores (2FA)

Como o EzServer dá acesso root aos seus servidores, a autenticação em dois fatores é obrigatória. Sem ela, o painel não libera as funções de gerenciamento.

Ativar o 2FA (primeiro acesso)

1. Instale um app autenticador no celular: Google Authenticator, Microsoft Authenticator ou Authy.
2. Após confirmar seu e-mail e fazer login, você cai automaticamente na tela Configurar Autenticação de Dois Fatores.
3. Escaneie o QR Code com o app (ou digite a chave manual exibida abaixo dele).
4. Digite o código de 6 dígitos que aparece no app e clique em Ativar Autenticação de Dois Fatores.
5. Salve os códigos de backup que aparecem em seguida (botões Baixar (.txt) ou Copiar). Eles são a única forma de entrar se você perder o celular.

Perdi o celular / troquei de aparelho

• Na tela de verificação, clique em Usar código de backup e digite um dos códigos salvos. Cada código funciona uma única vez.
• Depois de entrar, vá em Perfil → Autenticação de Dois Fatores (2FA) → Códigos de Backup e clique em Gerar Novos (a senha da conta será pedida).
• Se não tiver mais nenhum código, fale com o suporte a partir do e-mail cadastrado na conta.

O código de 6 dígitos é recusado

Quase sempre é o relógio do celular fora de sincronia. Ative a data/hora automática do aparelho (no Google Authenticator: Configurações → Correção de horário para códigos → Sincronizar agora) e tente com um código novo.

Como protegemos seus dados

• Senhas e chaves SSH ficam criptografadas no banco de dados e nunca são exibidas de volta na interface.
• Comandos executados pelos servidores são registrados em log de auditoria.
• Nunca envie senhas ou chaves privadas ao suporte — nossa equipe não pede credenciais.

Planos e assinatura

Toda conta nova começa no plano Grátis (1 servidor), sem cartão de crédito. Compare os planos na página de Planos.

Contratar ou mudar de plano

1. No painel, abra Assinatura no menu lateral (ou acesse /subscription).
2. No plano desejado, clique em Solicitar Plano e confirme.
3. Enviamos o link de pagamento para o e-mail da sua conta.
4. Assim que o pagamento é confirmado, o plano é liberado e os novos limites passam a valer.

Cancelar

Na mesma tela, clique em Cancelar Assinatura e confirme. A conta volta imediatamente para os limites do plano Grátis (1 servidor); seus servidores cadastrados não são apagados.

Limite de servidores atingido

Ao tentar cadastrar um servidor além do limite, aparece a mensagem "Você atingiu o limite de N servidores do seu plano". Os servidores já cadastrados continuam funcionando; para adicionar outro, remova um servidor ou mude de plano.

Solução de problemas

Encontre abaixo a mensagem que apareceu para você. Elas vêm do teste de conexão, do terminal ou do cadastro do servidor.

Erros de conexão SSH

Outros problemas comuns

Ainda precisa de ajuda?

Fale com a gente pela página de Contato. Para agilizar, informe: nome ou IP do servidor, a mensagem de erro exata e o que você já tentou. Nunca envie senhas ou chaves privadas.