Servidores

Servidores são a base de tudo no PrimeForge: é neles que os seus sites rodam e que ficam os serviços de infraestrutura (bancos de dados, cache, armazenamento). Esta página mostra como encontrar seus servidores na lista, quais tipos existem e como usar o assistente Criar Servidor para conectar uma máquina que você já tem ou provisionar uma nova na nuvem, do zero até o status Ready.

#A lista de servidores

Em Infraestrutura → Servidores você vê todos os servidores da organização. Cada linha traz o nome, o endereço IP, a região, o tipo, o status ao vivo e o indicador de conexão do Agent (verde quando conectado). No exemplo da Empresa XPTO, a lista mostra dois servidores: o Servidor Principal (tipo All-in-One) e o Servidor de Sites (tipo App Server).

Os status de servidor que você encontra na lista são:

• Provisionando / Instalando — o servidor está sendo configurado.
• Ready — provisionado e pronto para hospedar sites ou fornecer serviços.
• Unreachable (âmbar) — o painel está há 90 segundos sem receber sinal do Agent.
• Offline (vermelho) — 10 minutos sem sinal do Agent.

Clicar em uma linha abre a página daquele servidor, com toda a sua sub-navegação — detalhada em Gerenciando um Servidor.

#Tipos de servidor

O tipo escolhido no momento da criação define quais serviços são instalados. Você pode montar tudo em uma máquina só ou separar responsabilidades entre várias, conectadas pela malha WireGuard.

#Como escolher o tipo

Começando agora? Use All-in-One. Ele roda tudo em uma máquina só — o cenário mais simples e o suficiente para colocar sites com banco, cache, armazenamento e tempo real no ar.

Escalando? Separe as responsabilidades: coloque os sites em App Servers (enxutos, só com Traefik e containers de site), o banco em um servidor de Banco de dados, o armazenamento em um servidor de Armazenamento S3, e conecte tudo pela malha WireGuard. Essa separação permite escalar cada parte de forma independente — atualizar o servidor de banco sem tocar nos de app, ou adicionar mais App Servers sem afetar o banco.

É exatamente essa a arquitetura do exemplo: o Servidor Principal (All-in-One) concentra os serviços, e o Servidor de Sites (App Server) só roda containers, consumindo o PostgreSQL e o Redis do Servidor Principal pela malha WireGuard.

#O assistente Criar Servidor

Para adicionar um servidor, vá em Infraestrutura → Servidores e clique em Criar Servidor. O assistente conduz você por três decisões: o método, o tipo e, por fim, o provisionamento.

#Pré-requisitos

• Um VPS novo rodando Ubuntu 22.04 LTS ou 24.04 LTS (o provisionador aceita apenas essas versões).
• No mínimo 1 GB de RAM (2 GB recomendados para o tipo All-in-One).
• No mínimo 20 GB de disco.
• Acesso SSH como root (ou um usuário com sudo).
• Um domínio com DNS apontando para o IP do servidor (para os certificados TLS).

#Passo 1 — Escolher o método

O seletor de Método de Provisionamento oferece dois caminhos:

• Conectar Servidor Existente — você já tem um VPS (de qualquer provedor) com acesso SSH root. Informe o nome, o IP, a porta SSH, o usuário e a senha ou chave SSH. O PrimeForge conecta e roda o script de provisionamento na máquina. É o caminho mais comum. Antes de criar, você pode usar Verificar Conexão para validar que o SSH está acessível.
• Provisionar Automaticamente na Nuvem — você tem um Provedor de Servidor já configurado. O PrimeForge cria o VPS por você, envia a chave SSH da organização e faz o provisionamento de ponta a ponta. Os provedores com provisionamento automático são o DigitalOcean e o CloudPrime; ao escolher a credencial, o assistente carrega as regiões e os tamanhos disponíveis do provedor em tempo real.

Os provedores de nuvem são cadastrados em Ferramentas → Provedores de Servidor. O CloudPrime (cloudprime.com.br) é um provedor brasileiro com pontos de presença de baixa latência na América do Sul — útil quando seu público está no Brasil e nos países vizinhos.

#Passo 2 — Escolher o tipo

Selecione o tipo de servidor conforme a tabela acima. Se for o seu primeiro servidor, o All-in-One é a escolha recomendada — ele traz tudo o que um site precisa. Cada opção deixa claro quais serviços serão instalados, então você sabe de antemão o que a máquina vai fornecer.

#Passo 3 — Provisionar

Ao confirmar com Criar, o PrimeForge conecta via SSH (ou chama a API do provedor de nuvem) e executa o script de provisionamento, que instala e configura, na ordem:

1. Endurecimento de segurança (hardening) do sistema.
2. Docker — o runtime de containers de todos os sites.
3. Traefik — o proxy reverso com TLS automático via Let's Encrypt (nos tipos com sites).
4. Serviços de infraestrutura — PostgreSQL, MySQL, Redis, MinIO conforme o tipo escolhido.
5. Agent do PrimeForge — o binário Go que executa os comandos do painel.
6. Firewall UFW — liberando apenas SSH, HTTP/HTTPS e WireGuard.
7. Malha WireGuard — o túnel criptografado para a comunicação entre servidores.
8. Atualizações de segurança automáticas (unattended-upgrades), com reinício às 04:00 quando um novo kernel exigir.

Todo o processo leva de 5 a 15 minutos, dependendo da velocidade do servidor e de quais pacotes do sistema precisam ser atualizados. Você acompanha o progresso em tempo real, com um checklist de etapas que vai sendo marcado conforme cada uma termina.

Quando termina, o status do servidor muda para Ready e o indicador de conexão do Agent fica verde. A partir daí, se você tiver mais de um servidor, o PrimeForge estabelece automaticamente os túneis WireGuard entre eles, permitindo que um App Server alcance o banco e o Redis de outro servidor com segurança. O servidor já está pronto para hospedar sites (nos tipos App/All-in-One) ou fornecer serviços aos demais.

#Próximos passos

• Gerenciando um Servidor — a sub-navegação e o dia a dia de cada servidor.
• Topologia da Infraestrutura — veja a malha WireGuard e as dependências entre servidores no mapa.
• Visão Geral do Painel — acompanhe a frota pelo Dashboard.