Gerenciando um Servidor

Cada servidor tem sua própria página de detalhes, organizada em uma sub-navegação vertical agrupada por assunto. É dali que você acompanha a saúde do servidor, vê os sites que ele hospeda, lê os logs do host, gerencia a rede entre servidores, controla o acesso por chaves SSH e configura o comportamento — incluindo o modo de manutenção e a exclusão. Esta página percorre as principais páginas dessa sub-navegação. Para abrir a página de um servidor, clique nele na lista em Infraestrutura → Servidores, em um cartão no Dashboard, ou escolha-o no seletor de contexto {servidor} ▾ no alto de qualquer página de servidor ou site.

A sub-navegação de um servidor pronto fica assim:

Grupo Páginas
(sem grupo) Visão geral
Cargas de trabalho Sites · Agendador · Comandos
Infraestrutura Serviços · Bancos de dados · Armazenamento
Rede e segurança Rede · Chaves SSH
Diagnóstico Monitoramento · Logs · Atividade
(sem grupo) Configurações

Quem pode usar o Terminal vê também a entrada Terminal no grupo Rede e segurança, que abre um shell já conectado a este servidor.

Com o Ollama instalado, o grupo Cargas de trabalho ganha a página IA Local — veja IA Local (Ollama).

Um servidor que ainda não terminou de provisionar mostra só Visão geral, Atividade e Configurações — esta última é justamente a página que corrige o IP, a porta SSH ou as credenciais de que um provisionamento falho costuma precisar. Cada página também some sozinha nos tipos de servidor e nos papéis que não podem tê-la: um servidor de banco não tem Sites, Armazenamento só existe onde há SeaweedFS, e Agendador e Logs pedem o papel Developer ou acima. Não existe uma página separada de "Editar servidor": os campos do servidor são um modal dentro de Configurações, e a zona de perigo vive lá também.

Visão Geral

A página Visão geral é o painel de instrumentos do servidor. O que você mais usa vem primeiro, em largura total, e o estado da máquina fica em uma coluna lateral compacta:

  • Sites (N) — os sites hospedados, cada um com o status e um botão de deploy, mais um atalho Novo site.
  • Tarefas agendadas (N) — as tarefas cron do servidor, com o resultado da última execução, o estado do heartbeat quando houver e um botão para rodar agora.
  • Atividade recente — as últimas ações registradas neste servidor.
  • Status (coluna lateral) — o status do servidor (Pronto, Inacessível, Offline…), se o Agent está conectado, a versão do Agent e a latência entre o painel e o servidor. Durante uma janela de manutenção, é aqui que aparece o botão para encerrá-la.
  • Informações do servidor (coluna lateral) — endereço IP, IP privado, tipo, sistema operacional, núcleos de CPU, memória e disco.
  • Serviços de infraestrutura (coluna lateral) — para servidores que rodam serviços do sistema (como o All-in-One), o estado de cada serviço (PostgreSQL, Redis, SeaweedFS, Reverb e, quando instalado, MySQL): verde para em execução, âmbar para recuperando, vermelho para falhou.

Visão geral de um servidor

No cabeçalho ficam Criar site, Copiar IP e Mostrar na topologia (que abre o mapa destacando este servidor e os vizinhos dele). Para Admin ou acima, o menu Mais guarda as operações raras de host: Recarregar nginx, Reiniciar php-fpm (escolhendo a versão), Reiniciar servidor (com o nome digitado para confirmar), e um Reiniciar {serviço} por serviço em execução. O menu Agente reúne Atualizar agente (quando o agente está desatualizado) e Reverter agente; com o servidor Inacessível ou Offline, também as recuperações por SSH, Forçar reconexão e Reinstalar.

Nome e cabeçalho

Todas as páginas do servidor mostram no topo o nome, o IP e os serviços instalados. Para renomear, use o lápis ao lado do nome (Admin ou acima). O nome precisa ter pelo menos 3 letras e não pode repetir o de outro servidor da conta.

Terminal

O item Terminal do menu lateral abre uma sessão root neste servidor. Referência de comandos lista só o que existe nele: os sites com seus caminhos, os serviços instalados e, no host do painel, os comandos do painel.

Diagnosticar

Quando o painel perde o contato com o agente do servidor (servidor Inacessível ou Offline, por exemplo), a faixa de estado no topo das páginas do servidor traz Diagnosticar para Admin ou acima. Ele abre Diagnosticar conexão com {servidor}, que mostra como o painel acessa o servidor hoje (IP, porta SSH, autenticação e o último sinal do agente) e, ao clicar em Verificar, segue o caminho do painel até o servidor e de volta:

  1. O servidor responde no IP e na porta SSH?
  2. O painel consegue entrar por SSH?
  3. O serviço do agente (primeforge-agent) está rodando?
  4. O servidor alcança o painel?
  5. O agente já reconectou ao painel?

A verificação para no primeiro passo que falhar e explica o que costuma causar aquela falha. Ela não altera nada no servidor. Para corrigir, use Corrigir conexão (abre o Editar servidor, com o teste de conexão descrito em Configuração do servidor) ou Reinstalar agente, que recoloca o serviço do agente com uma credencial nova sem afetar os sites.

Reinício necessário

Quando uma atualização instalada só entra em vigor depois de reiniciar (um novo kernel, por exemplo), o servidor ganha o selo Reinício necessário em Servidores, e todas as páginas dele mostram um aviso no topo com a data em que a pendência começou. Clique no aviso para ver os pacotes que aguardam o reinício e se já existe um reinício agendado.

As atualizações de segurança continuam automáticas, mas o servidor nunca reinicia sozinho: você recebe a notificação Reinício necessário (no sino e nos canais da organização) e escolhe a hora. Para reiniciar, use Reiniciar servidor no próprio aviso (Admin ou acima, digitando o nome do servidor). O aviso some sozinho quando o servidor volta. Durante o reinício o servidor fica em manutenção, para que nenhum alerta dispare por um reinício que você mesmo pediu: a manutenção termina 3 minutos depois de o servidor voltar (tempo para os sites e serviços subirem), e no máximo 10 minutos depois do pedido. O host do painel mostra o aviso, mas não pode ser reiniciado pelo painel.

A saúde dos serviços é monitorada automaticamente: o Agent verifica cada serviço a cada 30 segundos e, se algum cair, o PrimeForge tenta reiniciá-lo sozinho (com um intervalo de segurança entre tentativas). Depois de três tentativas sem sucesso, o serviço é marcado como Falhou e um alerta crítico é criado.

Quando um servidor está Inacessível ou Offline mas você sabe que ele está saudável, a Visão geral também oferece Forçar reconexão do agente e Reinstalar agente (para papéis Admin ou acima) — veja Solução de Problemas. Enquanto o Agent está indisponível, uma faixa no topo de todas as páginas do servidor (e dos sites dele) diz desde quando, e as ações que dependem do Agent aparecem desabilitadas com o motivo no tooltip.

Faixa de estado do servidor no topo de uma página de site

Atividade

A página Atividade (grupo Diagnóstico) é um feed de auditoria específico daquele servidor: uma linha do tempo com quem fez o quê e quando, restrita às ações que afetaram essa máquina. Instalações de serviço, deploys de sites hospedados nela, mudanças de configuração, entradas em modo de manutenção — tudo aparece aqui em ordem cronológica.

Feed de atividade de um servidor

É a forma mais rápida de responder "o que mudou neste servidor recentemente?" quando você está investigando um comportamento inesperado. O registro é somente leitura e faz parte do mesmo histórico do Log de Auditoria da organização, apenas filtrado por servidor — e respeita a mesma política: um membro que não pode ler a auditoria da organização também não lê este feed.

Sites

A página Sites (grupo Cargas de trabalho) lista todas as aplicações hospedadas naquele servidor, com o status de cada uma e ações rápidas. É a visão "por servidor" dos seus sites: em vez de olhar toda a organização, você vê só o que roda naquela máquina.

Sites hospedados em um servidor

No exemplo da organização PrimeForge, a página Sites do Worker 2 mostra n20-full, n20-horizon, n20-pulse, n20-reverb e n20-storage (.babytor.com.br) e n20-php.secnote.com.br, que foi migrado do Worker 1, enquanto a do Worker 1 (App Server) mostra n20-static, n20-express, n20-next e n20-todo (.secnote.com.br). Clicar em um site abre a página dele. Criar um site a partir desta página já deixa o servidor escolhido no assistente.

Comandos

A página Comandos (grupo Cargas de trabalho, Admin ou acima para executar) roda neste servidor um dos scripts de servidor da organização, como o usuário que o script define. Clique em Executar script, escolha o script e confira em O que será executado o usuário, a pasta e o conteúdo antes de confirmar. Cada execução fica listada abaixo, com a saída completa. Gerenciar scripts leva a Operações › Scripts, onde os scripts são escritos — veja Scripts.

Toda organização começa com o script Diagnóstico do servidor. Ele é somente leitura e mostra em tabelas o sistema, os patches de segurança pendentes, as versões instaladas, os serviços, os usuários, os grupos, o SSH, as portas e o firewall.

Página Comandos de um servidor

Logs

A página Logs (grupo Diagnóstico) lê os registros do próprio host — não os de um site — pelo Agent, sem sessão SSH. Escolha a fonte e o painel mostra as últimas linhas:

  • Nginx (serviço), Nginx — acesso (access.log) e Nginx — erros do host (error.log).
  • PHP {versão} (php-fpm) — uma fonte por versão de PHP que algum site do servidor usa.
  • Os serviços que o tipo do servidor roda — PostgreSQL, MySQL, Redis, SeaweedFS, Reverb.
  • Agente PrimeForge — o journal do Agent, útil quando ele reconecta demais.
  • SSH (sshd), Autenticação (auth.log) e Atualizações de segurança (unattended-upgrades).

Você escolhe quantas linhas ler (100, 200, 500 ou 1000), filtra o que está na tela (por exemplo error, timeout, 502), clica em Atualizar ou liga Seguir para acompanhar as novas linhas ao vivo. Uma linha abaixo do seletor diz exatamente o que está sendo lido (a unit do systemd ou o arquivo).

A página exige o papel Developer ou acima. As fontes sensíveis — o error.log do nginx, SSH, auth.log e as atualizações de segurança — aparecem marcadas "só Admin" e só abrem para Admin ou acima. Os arquivos de log exigem um Agent recente; se o do servidor for mais antigo, a página avisa e aponta para a atualização na Visão geral.

Página Logs do servidor com o journal do nginx selecionado

Os logs de cada aplicação (acesso e erros do vhost do site, laravel.log, workers) ficam na página Logs do próprio site — veja Configuração de Sites.

Rede

A página Rede (grupo Rede e segurança) reúne as duas faces da rede do servidor: a malha WireGuard entre ele e os demais servidores da organização, e o firewall UFW da máquina. Os endereços antigos /connections e /firewall continuam funcionando e redirecionam para /network.

Rede privada WireGuard

Quando você tem mais de um servidor, o PrimeForge estabelece automaticamente túneis WireGuard criptografados entre eles — é por esse túnel que um App Server alcança o banco de dados e o Redis de outro servidor com segurança.

Peers WireGuard de um servidor, na página Rede

Um peer pode aparecer como Painel PrimeForge, sem endereço público nem ações: é o túnel do próprio painel até este servidor, e não é gerenciado por esta página.

Para cada peer da malha, a página exibe:

  • Estado da conexão (conectado/desconectado).
  • Último handshake — quando o túnel trocou pacotes pela última vez.
  • Bytes transferidos — o volume de tráfego pelo túnel.
  • Endpoint — o IP e a porta do outro lado.

Cada peer traz as ações de conectar, desconectar e Restabelecer túnel, esta última para quando o handshake parou sem o painel perceber. No exemplo, é aqui que você confirma que o Worker 1 e o Worker 2 estão de fato conversando — é essa conexão que permite a um site hospedado no App Server usar o PostgreSQL, o Redis, o S3 e o Reverb do All-in-One. Como os serviços cross-server passam por essa rede, manter os servidores geograficamente próximos reduz a latência de cada consulta ao banco.

Regras de firewall (UFW)

Na metade de baixo da mesma página fica o firewall UFW do servidor, gerenciado através do agente — sem necessidade de uma sessão SSH — logo abaixo da malha WireGuard. As duas coisas eram páginas separadas e viraram uma só; os endereços antigos /connections e /firewall redirecionam para /network.

Seção de firewall da página Rede, com o status do UFW e a tabela de regras

O que a página oferece:

  • Status do Firewall — indica se o UFW está ativo, com as ações Ativar firewall / Desativar firewall. Desativar pede confirmação em vermelho: isso expõe todas as portas do servidor.
  • Tabela de regras — cada regra com seu número, porta/serviço-alvo, ação (permitir/negar) e origem.
  • Adicionar regra — porta (1–65535) ou nome de serviço, protocolo (tcp / udp / qualquer), ação, origem (any, um IP ou um intervalo CIDR) e um comentário. As entradas são estritamente validadas antes de chegarem ao servidor.
  • Excluir — apaga uma regra pelo número. Regras de sistema que mantêm a plataforma funcionando (SSH, HTTP, HTTPS, a malha WireGuard) são protegidas e não podem ser removidas pelo painel.

Permissões e auditoria

Visualizar o firewall é aberto a todos os membros da organização; adicionar, remover, ativar e desativar exigem o papel Admin ou superior. Toda alteração é registrada na auditoria. Se o agente do servidor estiver offline, a página mostra um aviso e as alterações ficam indisponíveis até ele reconectar — o painel prefere dizer que não sabe a mostrar um estado de firewall desatualizado como se fosse o atual.

Chaves SSH

A página Chaves SSH (grupo Rede e segurança) controla quais chaves SSH têm acesso àquela máquina específica. Ela complementa as chaves globais da organização (que valem para todos os servidores): as chaves adicionadas aqui aplicam-se somente a este servidor — útil, por exemplo, para um sistema de CI/CD que precisa acessar apenas uma máquina.

Chaves SSH de um servidor

Nesta página você pode:

  • Adicionar chave — a chave já entra vinculada a este servidor.
  • Importar do servidor — procura no authorized_keys do root e do usuário primeforge chaves que o painel ainda não conhece e as vincula a este servidor.
  • Ver quais chaves globais também têm acesso.
  • Remover deste servidor — a chave sai deste servidor e continua nos demais em que está. Se a chave é global, ela deixa de ser global e passa a valer só para os servidores que a mantêm, e servidores criados depois não a recebem; para voltar a ser global, edite a chave em Configurações › Chaves SSH. A chave de provisionamento não pode ser removida de um servidor: o painel perderia o acesso a ele.

As chaves são distribuídas para o servidor quando você as adiciona e revogadas ao remover — o Agent reescreve o arquivo authorized_keys no local, sem derrubar sessões ativas. Gerencie chaves sempre pelo painel (não direto no servidor), para que tudo fique registrado no Log de Auditoria e possa ser revogado de forma centralizada.

Configurações

A página Configurações reúne a configuração do servidor, o modo de memória padrão, o modo de manutenção e a zona de perigo. Nenhuma outra sub-página traz ações de editar ou excluir o servidor: elas moram aqui.

Configurações de um servidor

Configuração do servidor

Aqui você vê o nome, o endereço IP, o IP privado, a porta e o usuário SSH e a chave pública SSH da organização, e atualiza, pelo modal Editar servidor, o nome de exibição e os dados de conexão SSH (deixe a senha em branco para manter a atual). O tipo é definido no provisionamento e não é trocado por aqui. Se o servidor tem túneis WireGuard ativos apontando para o IP atual, a troca de IP é recusada até você desconectá-los na página Rede. Quando você muda o IP, a porta, o usuário, o método de autenticação ou a senha/chave, o painel testa a conexão SSH com os dados novos antes de salvar e recusa a mudança se não conseguir entrar — a menos que você marque Salvar mesmo se o teste de conexão falhar (útil quando o servidor ainda está desligado). O modal também tem um botão para testar antes de salvar.

A chave pública da organização também é a sua saída quando o painel perde o acesso SSH: adicione-a ao authorized_keys pelo console do provedor e o painel volta a se conectar.

Modo de memória padrão

Define como os sites deste servidor se comportam ao atingir o limite de memória: Estrito é um teto rígido sem swap — o kernel encerra (OOM) o processo que passa do limite e o systemd o reinicia; Flexível nunca encerra — acima do limite o site fica mais lento e usa swap, e o painel alerta. Cada site pode sobrescrever o padrão na sua página Runtime; os que herdam o padrão recebem a mudança na hora.

Modo de manutenção

Quando você vai fazer um trabalho planejado em um servidor — uma atualização importante de banco, manutenção de kernel, migração de hardware — a maquinaria de autocorreção do PrimeForge normalmente atrapalharia: reiniciaria os serviços que você acabou de parar e dispararia alertas para a equipe. O modo de manutenção manda o painel ficar quieto.

Clique em Entrar em modo de manutenção e escolha:

Campo Opções
Duração 30 minutos, 1 hora, 4 horas ou 12 horas — a janela expira automaticamente
Motivo Texto livre (ex.: "upgrade major do PostgreSQL"), exibido na faixa e registrado no Log de Auditoria

Modal Entrar em modo de manutenção, com duração e motivo

Enquanto a manutenção está ativa:

  • A autorrecuperação de serviços e os reinícios automáticos das unidades systemd (dos serviços e dos sites) ficam pausados — o painel não vai reiniciar o que você parou de propósito.
  • A reconciliação de sites e as verificações de alerta por limiar ficam suspensas para este servidor.
  • Os webhooks de status do servidor (server.unreachable, server.offline, ...) ficam silenciados.
  • Os sites continuam rodando — o modo de manutenção muda o que o painel faz, não o que o servidor faz.
  • A faixa de estado "Modo de manutenção até ...", com o motivo, aparece nas páginas do servidor e nas dos sites que ele hospeda. Ela é informativa: deploys e demais ações continuam liberados durante a janela.

Clique em Encerrar manutenção agora para sair antes da hora — a autorrecuperação, os reinícios e os alertas voltam imediatamente. Entrar e sair são ambos auditados e exigem o papel Admin ou acima. As operações de ciclo de vida que o próprio PrimeForge executa (como a desinstalação de um serviço ou a atualização do SeaweedFS) já entram em manutenção sozinhas, para que um reinício deliberado não gere um falso alerta de "serviço fora do ar".

Zona de perigo

A ação Excluir servidor remove permanentemente o servidor do PrimeForge, com as chaves SSH vinculadas, as conexões e os dados de monitoramento. Ela é exclusiva do papel Owner e pede que você digite o nome do servidor para confirmar.

  • Servidor com sites — a exclusão é bloqueada enquanto houver sites nele: o modal lista os domínios e oferece Excluir também os N site(s) deste servidor. Os sites são excluídos em segundo plano pelo fluxo normal (webhook do GitHub removido, serviços externos liberados); quando terminarem, exclua o servidor de novo.
  • Servidor criado pelo painel no DigitalOcean — a exclusão também destrói o droplet no provedor. Se a destruição falhar (por exemplo, um token revogado), o servidor sai do painel mesmo assim e uma notificação crítica avisa que a VM continua cobrando.
  • Servidor CloudPrime — a API da CloudPrime não tem exclusão: o servidor sai do painel, mas a VPS continua rodando até você finalizá-la no painel da CloudPrime (veja Credenciais).
  • Servidor conectado por SSH — nada é apagado no VPS; o PrimeForge apenas deixa de gerenciá-lo.

Próximos passos