Serviços, Bancos e Armazenamento
Todo servidor gerenciado pelo PrimeForge pode hospedar um conjunto de serviços bare-metal — PostgreSQL, MySQL, Redis, SeaweedFS (S3) e Reverb — além do nginx do host, que recebe as requisições de todos os sites do servidor (um vhost por site). Esses serviços rodam diretamente no sistema operacional (como unidades systemd), fora do isolamento de cada site, o que os torna rápidos e estáveis. Esta página explica quais serviços existem, onde eles rodam na sua frota e como você os instala, configura, atualiza e inspeciona a partir de três páginas de cada servidor: Serviços (que cuida também dos runtimes de PHP e Node instalados no host), Bancos de dados e Armazenamento.
Quem pode fazer o quê: qualquer membro vê as páginas; Developer ou acima também abre as configurações em modo leitura, pede uma nova verificação de versões, vê a saída das operações e inspeciona bancos; Admin ou acima instala, configura, reinicia, atualiza e desinstala serviços e runtimes.
Nos exemplos usamos a organização de demonstração PrimeForge, com dois servidores ligados pela malha WireGuard:
- Worker 2 (
201.33.85.149) — roda nginx, PostgreSQL 18, Redis 8, SeaweedFS e Reverb, e hospeda sites comon20-full.babytor.com.br,n20-storage.babytor.com.br(Laravel com SQLite e S3) en20-php.secnote.com.br, migrado do Worker 1. - Worker 1 (
187.108.200.65) — tipo App Server, roda só o nginx e os runtimes, e serven20-static.secnote.com.br,n20-express.secnote.com.br,n20-next.secnote.com.bren20-todo.secnote.com.br(um app de tarefas que usa o PostgreSQL, o Redis e o Reverb do Worker 2). Quando um site dele precisa de banco, Redis ou S3, usa os serviços do Worker 2 pela malha.
Quais serviços existem
O PrimeForge instala cinco serviços bare-metal, além do nginx do host:
| Serviço | Para que serve | Versão padrão em instalações novas |
|---|---|---|
| PostgreSQL | Banco de dados relacional principal (recomendado para Laravel) | 18 (repositório oficial PGDG) |
| MySQL | Banco de dados relacional alternativo — instalado só quando você pede | 9.7 LTS (repositório oficial repo.mysql.com) |
| Redis | Cache, filas e sessões | 8 (repositório oficial packages.redis.io) |
| SeaweedFS (S3) | Armazenamento de objetos compatível com S3 (uploads e mídia dos sites) — um único processo weed mini |
versão homologada pelo PrimeForge, conferida por SHA-256 |
| Reverb | Servidor WebSocket para recursos em tempo real do Laravel (unidade primeforge-reverb) |
— |
| nginx | Servidor web do host: um vhost por site, roteamento por domínio e TLS automático por site (acme.sh) | pacote do Ubuntu |
Nos servidores All-in-One você também pode instalar a IA Local (Ollama), que aparece como mais uma linha na página Serviços. Os detalhes estão em IA Local.
Há três jeitos rápidos de saber onde cada serviço está:
- Na Visão geral do servidor, abaixo do nome, aparece um selo por serviço instalado — verde em execução, âmbar recuperando ou em instalação/atualização, vermelho parado ou com falha, cinza quando o agente não mandou relatório recente. A dica mostra o estado e a versão, e o selo leva à página Serviços.
- Na lista de Infraestrutura → Servidores, o filtro Serviço mostra só os servidores em que o serviço escolhido está instalado. Em arquiteturas com vários servidores isso deixa claro, por exemplo, que o PostgreSQL usado por
n20-todo.secnote.com.brestá no Worker 2. - Na página Serviços de cada servidor, cada linha mostra a versão em uso.

Onde cada serviço roda na frota
O conjunto inicial de serviços depende do tipo do servidor escolhido na criação:
- All-in-One — nginx + PostgreSQL + Redis + SeaweedFS + Reverb. Tudo numa máquina só; ideal para começar.
- Servidor de aplicação (App Server) — só o nginx e os runtimes. Dedicado a hospedar sites; consome banco, Redis e S3 de outros servidores pela malha WireGuard.
- Servidor de banco de dados — PostgreSQL + Redis.
- Armazenamento S3 — só SeaweedFS.
- Serviços (S3 + DB + Reverb) — PostgreSQL + Redis + SeaweedFS + Reverb, sem hospedar sites.
O MySQL não faz parte de nenhum tipo: quando precisar dele, instale-o pela página Serviços. Os serviços ficam acessíveis em 127.0.0.1 para os sites do mesmo servidor e no IP WireGuard do servidor para os sites de outros servidores da sua organização — nunca pela internet.
O tipo define só o ponto de partida. Você pode acrescentar ou remover serviços depois; quando o conjunto instalado deixa de casar com o perfil do tipo, o servidor passa a ser do tipo Personalizado (veja abaixo).
Página de Serviços do servidor
Abra o servidor e escolha Serviços no grupo Infraestrutura da sub-navegação.
A página tem, de cima para baixo:
- A seção Runtimes, com as versões de PHP e Node do host (nos servidores que hospedam sites — veja Runtimes (PHP e Node)).
- A seção Serviços instalados, com quantos são, o Perfil original: do servidor e, se ele já virou personalizado, o selo Custom. É uma lista com uma linha para o nginx (nos servidores que hospedam sites) e uma linha para cada serviço instalado. Os serviços que ainda não existem no servidor ficam no menu Instalar serviço, no topo da página.
Cada linha mostra o nome, a versão já formatada (só o número, não a saída crua do psql — a saída completa aparece ao passar o mouse) e o estado com um ponto colorido. Abaixo vêm a descrição do serviço e uma linha com quando foi instalado, quando foi atualizado, se está Atualizado ou com Atualização disponível e o link N sites dependentes. Esse link abre, na própria linha, um selo por site que usa o serviço, com link para a página do site. Num servidor compartilhado, sites de outra organização aparecem só como contagem, nunca pelo nome. O Reverb mostra também em qual PHP roda (Usa PHP 8.5).
À direita ficam Configurar (nginx, PostgreSQL, MySQL e Redis) e Ver credenciais. Um serviço sem Configurar, como o SeaweedFS e o Reverb, mostra Reiniciar no lugar. O menu ⋮ de cada linha reúne o resto (Admin ou acima): Reiniciar, as atualizações que podem ser aplicadas e Desinstalar. Um Developer vê apenas Configurar, em modo leitura.

Inventário de software: versões e atualizações
A página não consulta o servidor toda vez que é aberta. Ela mostra o resultado da última verificação de software — uma consulta ao host que lê as versões instaladas de PHP, Node, nginx e dos serviços, e pergunta ao apt (e ao php.net e nodejs.org) se há versões mais novas.
- A verificação é pedida sozinha quando você abre a página e o resultado guardado tem mais de 10 minutos, depois de toda instalação, remoção ou atualização, e uma vez por dia.
- Enquanto ela roda, a seção Runtimes mostra Verificando as versões instaladas neste servidor… e as linhas dos serviços mostram Atualizações: verificando…. A página se atualiza sozinha quando o resultado chega.
- Para pedir uma nova verificação na hora, use Atualizar no topo da página ou Verificar atualizações na seção Runtimes (Developer ou acima).
- Ao lado do título Runtimes aparece verificado há tempo. Se a última consulta falhou, um aviso explica o erro e a página continua mostrando o último resultado bom.
Instalar um serviço
Precisa de Redis num App Server sem recriar o servidor? É aqui que você resolve (Admin ou acima):
- Abra o menu Instalar serviço no topo da página e escolha o serviço (por exemplo, Instalar Redis).
- Confirme no modal. O servidor roda o mesmo instalador usado na criação do servidor, guarda as credenciais em
/etc/primeforge/service-credentialse detecta a versão instalada. - Acompanhe a linha: ela passa de instalando (ponto âmbar pulsando) para em execução (ponto verde). A página se atualiza sozinha a cada 15 segundos.
- Com o serviço rodando, Ver credenciais abre um modal com os dados de conexão (por exemplo, a senha do Redis ou o usuário do PostgreSQL).
O assistente de criação de site percebe a mudança na hora: depois de instalar o Redis no Worker 1, esse servidor passa a ser oferecido como opção de Redis, e o .env dos sites dele aponta para 127.0.0.1.
Instalar um serviço que o perfil do tipo não prevê torna o servidor Personalizado — por exemplo, Redis num App Server. Desinstalar até voltar ao perfil original restaura o tipo automaticamente.
Configurar um serviço
PostgreSQL, MySQL, Redis e nginx têm o botão Configurar, que abre um painel lateral com os ajustes mais comuns. O painel nunca altera o arquivo de configuração do pacote: ele grava só um arquivo próprio, lido depois do original:
| Serviço | Arquivo do painel |
|---|---|
| PostgreSQL | /etc/postgresql/<versão>/main/conf.d/primeforge.conf |
| MySQL | /etc/mysql/mysql.conf.d/zz-primeforge.cnf |
| Redis | /etc/redis/primeforge.conf |
| nginx | /etc/nginx/conf.d/primeforge-tuning.conf |
O painel tem quatro abas:
- Configuração rápida — os parâmetros mais ajustados, cada um com o valor Em vigor e de onde ele vem (lido do serviço, arquivo do painel ou padrão do pacote). Campo vazio = padrão do pacote.
- PostgreSQL: Conexões simultâneas (max_connections), Cache compartilhado (shared_buffers), Memória por operação (work_mem), Memória de manutenção (maintenance_work_mem), Cache estimado do sistema (effective_cache_size) e Registrar consultas lentas a partir de (log_min_duration_statement).
- MySQL: Conexões simultâneas (max_connections), Buffer pool do InnoDB (innodb_buffer_pool_size), Tempo de conexão ociosa (wait_timeout), Log de consultas lentas (slow_query_log) e Consulta lenta a partir de (long_query_time).
- Redis: Memória máxima (maxmemory), Política ao atingir o limite (maxmemory-policy) e Persistência AOF (appendonly).
- nginx: Keep-alive (keepalive_timeout), Tempo para receber o corpo (client_body_timeout), Tempo de envio (send_timeout) e Mostrar a versão do nginx (server_tokens). O tamanho máximo de upload e o gzip são definidos por site, no vhost de cada um.
- Editor bruto — uma linha por configuração (
parâmetro = valorno PostgreSQL e no MySQL,diretiva valorno Redis,diretiva valor;no nginx). Ele aceita apenas uma lista permitida de parâmetros de ajuste — memória, conexões, tempos, limites de log e, no PostgreSQL, autovacuum, checkpoint e planejador. Qualquer coisa que aponte para arquivos, bibliotecas, comandos, portas, endereços ou credenciais é recusada com a mensagem de que não é permitida. - Sites dependentes — os sites que usam o serviço e seriam afetados por um reinício.
- Histórico — cada alteração, quem fez, a situação (Aplicando, Aplicada, Desfeita (arquivo anterior mantido) ou Falhou) e o botão Voltar a esta versão.
Para aplicar uma mudança:
- Ajuste os valores e clique em Revisar alterações.
- A revisão mostra O que muda (parâmetro, antes, depois e o que é preciso Para aplicar: Recarga, Na hora ou Reinício), Como será aplicado e o arquivo final.
- Se algum valor exige reinício (no PostgreSQL,
max_connectionseshared_buffers), a revisão lista os sites afetados e pede que você marque a confirmação do reinício. - Clique em Salvar e aplicar. A aplicação roda em segundo plano e o resultado chega no sino e no Histórico.
O serviço valida o arquivo antes de qualquer recarga (postgres -C, mysqld --validate-config, um Redis descartável ou nginx -t). Se a validação recusar, nada muda. Se o serviço não responder depois de aplicar, o arquivo anterior volta e o serviço é trazido de volta automaticamente. MySQL e Redis recebem os novos valores sem reiniciar; PostgreSQL e nginx recarregam sem derrubar conexões; um reinício acontece só com sua confirmação e com o servidor em modo de manutenção. Enquanto uma alteração ainda está sendo aplicada, uma nova no mesmo serviço é recusada.


O nginx
Nos servidores que hospedam sites, a primeira linha é a do nginx: Servidor web do host: recebe as requisições de todos os sites deste servidor. Ela mostra o estado (Em execução ou Parado), a versão, o teste da configuração — Configuração válida (nginx -t) ou nginx -t falhou —, a versão Disponível quando há atualização e os sites servidos.
- Configurar abre o mesmo painel descrito acima, com os ajustes do bloco
http. - Atualizar (Admin ou acima, quando há versão nova) atualiza só os pacotes do nginx pelo apt, com o servidor em manutenção, e confere
nginx -te o estado do serviço no fim. A confirmação lista os sites servidos e avisa que não há restauração automática: o apt não reinstala a versão anterior. Acompanhe com Ver progresso.
Reiniciar, atualizar e manter
- Reiniciar (no menu ⋮, ou na linha quando o serviço não tem Configurar) — executa
systemctl restartno serviço. O modal diz quantos sites do servidor usam o serviço e ficam sem ele por alguns segundos. O mesmo reinício aparece, por serviço, no menu Mais da Visão geral do servidor (Reiniciar serviço). - Atualizações — o menu ⋮ só lista o que pode ser aplicado, e a linha do serviço diz Atualização disponível. Quando não há nada, a linha diz Atualizado (ou Atualizações: verificando… enquanto o inventário roda). Os itens possíveis são:
- Atualizar (minor) — para PostgreSQL, MySQL e Redis, instala pelo apt a correção mais nova da mesma série e reinicia o serviço. O item mostra Atual e Disponível; antes de rodar, o painel diz qual versão entra e quais sites ficam alguns segundos sem o serviço durante o reinício. A configuração que o painel escreveu no servidor (senha do Redis, endereços de escuta) é mantida quando o pacote traz um arquivo de configuração novo. O Redis nunca troca de versão principal por aqui: o servidor fixa o Redis na versão principal instalada.
- Atualizar SeaweedFS — o servidor baixa a release homologada das releases no GitHub, confere o checksum SHA-256 fixado pelo PrimeForge, troca o binário
weedde forma atômica (o anterior fica como.prev) e reinicia o serviço. Se a verificação de saúde falhar, o binário anterior volta sozinho. O servidor fica em modo de manutenção durante a troca. - Upgrade major… e Reverter… — nunca rodam automaticamente. Quando um banco está atrás da versão maior padrão (por exemplo, um PostgreSQL 17 antigo com o 18 disponível), ou quando você precisa voltar após uma atualização ruim, o painel mostra um roteiro guiado e pede que você confirme Tenho backup e entendo. O PrimeForge não executa por você uma migração de dados que não tem volta.
Atualizações automáticas
O quadro Atualizações automáticas, no fim da página Serviços, mostra o que o servidor instala sozinho e quando:
- O que instalar — Só correções de segurança (o padrão: as correções de segurança do Ubuntu, nginx incluído) ou Segurança e correções dos serviços (também as correções do PostgreSQL, Redis, MySQL e PHP, e as atualizações do Ubuntu). Nenhuma das duas troca de versão principal: PostgreSQL 18 continua 18, Redis 8 continua 8, PHP 8.5 continua 8.5.
- Próxima execução — quando o servidor roda as atualizações. Em Configurar você escolhe o horário (no fuso do painel); sem horário, vale o padrão do Ubuntu.
- Última execução — quando rodou pela última vez e o que instalou. Se falhou, o log completo está em Logs › Atualizações de segurança (unattended-upgrades).
- Correções esperando agora — tudo o que já tem correção publicada e ainda não foi instalado, serviço por serviço e PHP por PHP. Atualizar (no topo da página) verifica de novo.

Uma correção instalada sozinha reinicia o serviço que mudou: os sites que usam PostgreSQL, Redis ou MySQL ficam alguns segundos sem ele. O PHP de cada site é recarregado sem derrubar requisições. O servidor nunca reinicia sozinho; quando uma atualização do kernel pede reinício, o aviso aparece no topo das páginas do servidor. Configurar exige Admin.
Instalar, configurar, reiniciar, atualizar e desinstalar ficam registrados em Operações → Incidentes e logs → Log de Auditoria.
Desinstalar um serviço (proteções de dados)
A desinstalação é deliberadamente difícil de fazer por engano:
- Bloqueio por dependência — se algum site depende do serviço, o item Desinstalar do menu ⋮ fica desativado e a dica dele diz "Bloqueado: N site(s) dependem deste serviço", com os domínios. Contam tanto os sites que apontam para este servidor (banco, Redis, S3, Reverb) quanto os sites do próprio servidor que usam o serviço local — de todas as organizações, embora só os sites da sua apareçam pelo nome. Sites com SQLite não contam. O botão também fica desativado enquanto há outra operação em andamento no serviço.
- Confirmação por nome digitado — digite o nome do serviço exatamente (por exemplo
postgresql) no campo Digite "postgresql" para confirmar. - Reconhecimento dos dados — nos serviços que guardam dados (PostgreSQL, MySQL, Redis, SeaweedFS) é preciso marcar Fiz backup ou não preciso dos dados.
- Manter dados por padrão — Manter dados em disco (remover apenas o serviço) vem ligado: o serviço, seus pacotes, unidades, regras de firewall e credenciais são removidos, mas os diretórios de dados ficam no servidor. Desligado, é uma remoção completa, e o modal diz exatamente quais diretórios serão apagados para sempre.

Desinstalar também remove o arquivo de configuração do painel e o histórico de configurações daquele serviço; uma reinstalação começa dos padrões do pacote. Serviços desinstalados são lembrados, então o monitoramento para de esperá-los e não tenta "ressuscitar" um serviço que você removeu de propósito. A operação coloca o servidor em modo de manutenção automaticamente.
Runtimes (PHP e Node)
A seção Runtimes, no topo da página Serviços dos servidores que hospedam sites, mostra as versões de PHP e Node instaladas no host. De onde elas vêm:
- PHP — pacotes de Ondřej Surý: o PPA ondrej até o Ubuntu 24.04 e packages.sury.org a partir do Ubuntu 26.04. Cada versão tem seu próprio php-fpm.
- Node — builds oficiais do nodejs.org, um por versão maior em
/opt/primeforge/node/{major}, baixados e conferidos por SHA-256.
Cada versão instalada é uma linha da lista, primeiro as de PHP e depois as de Node, com:
- a versão completa e, no PHP, o serviço que a serve (Servido por
php8.5-fpm); - os selos do catálogo: Padrão (novos sites nascem com ela), Descontinuada (não é mais oferecida para sites novos), Fora do catálogo (instalada aqui, mas o painel não a oferece mais), Padrão do sistema (o
nodede/usr/local/bin) e Árvore fora do root (arquivos que outro usuário pode alterar — reinstale a versão); - a situação da atualização: Atualização disponível, Atualização do pacote (mesma versão do PHP com uma revisão nova do pacote, em geral correção de segurança), Atualizado ou Não verificado;
- o uso: quantos sites do servidor usam a versão e, se for o caso, usado por Reverb;
- Configurar e o menu ⋮ com Atualizar (ou Reinstalar) e Remover.
Abaixo da lista, uma nota lembra que uma versão em uso por sites ou serviços não pode ser removida.

Instalar, atualizar e remover versões
Todas as operações rodam em segundo plano, uma por vez por servidor, e esperam um deploy em andamento terminar (Admin ou acima):
- Instalar versão — escolha Runtime e Versão (só versões oferecidas pelo painel e ainda não instaladas aqui) e clique em Instalar. Leva alguns minutos e as versões existentes não são tocadas.
- Atualizar — no PHP, o apt instala a nova versão em todos os pacotes daquela versão do PHP e recarrega o php-fpm dos sites que a usam (as requisições em andamento têm até 10 s para terminar). No Node, o novo build é baixado, conferido e trocado pelo atual; os sites passam para o novo binário sem derrubar requisições. Se o Reverb do servidor roda naquele PHP, ele é reiniciado logo depois. Filas, Horizon, agendador e daemons dos sites passam a usar a nova versão no próximo deploy ou reinício deles.
- Atualizar tudo — aparece quando há versões desatualizadas; enfileira uma atualização por versão e mostra antes o que ficará de fora e por quê.
- Remover — desinstala a versão do host depois que você digita a versão para confirmar. A remoção é recusada, com o motivo, quando a versão é a Padrão do painel, quando algum site do servidor está fixado nela (seus domínios são listados) ou quando o Reverb do servidor roda nela. Se houver releases antigas construídas com essa versão, o modal avisa que a volta de versão com um clique para elas passa a ser recusada até você reinstalar o runtime; o site no ar não é afetado.
Enquanto a operação roda, a linha mostra Instalando…, Removendo… ou Atualizando… com Ver progresso no menu ⋮, que abre a saída do console ao vivo. Se a operação falhar, a linha mantém o aviso (por exemplo, Instalação falhou há 5 minutos) com Ver saída e Dispensar. O botão Histórico lista as últimas operações de runtime do servidor, cada uma com sua saída. Ver a saída é para Developer ou acima; dispensar, para Admin ou acima.

Padrões de PHP e Node do servidor
O Configurar de cada versão define os padrões deste servidor para aquela versão. Eles valem para os sites novos e para todo site que não personalizou a configuração; a configuração do próprio site tem precedência, chave a chave. A ordem é: padrão do sistema → servidor → site.
O painel tem as abas:
- Configuração rápida — no PHP: Limite de memória, Tamanho máximo de upload, Tamanho máximo de POST, Tempo máximo de execução, Tempo máximo de entrada, Máximo de variáveis de entrada, Exibir erros, Fuso horário, OPcache e Memória do OPcache. No Node: Memória do heap (max-old-space-size) e NODE_ENV. Cada campo mostra o valor em vigor e o padrão do sistema.
- Editor bruto — as mesmas chaves no formato
diretiva = valor. Uma linha removida volta ao padrão do sistema. - Sites afetados — os sites do servidor nessa versão, marcados Herda ou Personalizado (com as chaves que cada um definiu).
- Histórico — as alterações, com a situação (Aplicando, Aplicada, Aplicada em parte, Falhou) e Voltar a esta versão.
Ao clicar em Revisar alterações, você vê O que muda, os Sites que herdam e serão atualizados (com o efeito em cada um: recarga sem interrupção ou reinício) e os Sites com valor próprio (não mudam). A maioria das chaves do PHP aplica com recarga graciosa; a Memória do OPcache e as configurações do Node exigem reiniciar os sites, e a revisão pede que você confirme o reinício. Clique em Salvar e aplicar — o resultado por site chega no sino e no Histórico. Um site parado tem os arquivos atualizados, mas não é ligado.
A Memória do OPcache é uma configuração só do servidor. Na página Runtime de cada site, cada valor aparece como Personalizado, Padrão do servidor ou Padrão do sistema, com Voltar ao padrão do servidor — veja Configuração de Sites.

Bancos de dados
A sub-página Bancos de dados reúne os bancos usados pelos sites do servidor — PostgreSQL, MySQL, SQLite e Redis — com um visualizador integrado, para você inspecionar a estrutura sem abrir um terminal nem instalar um cliente. Ela aparece nos servidores que rodam banco ou Redis e nos que hospedam sites.
No topo, Serviços de banco mostra um bloco por engine presente (com a versão) e, para Admin ou acima, o botão Sincronizar do .env, que relê em segundo plano o .env dos sites que usam este servidor e atualiza o que o painel sabe deles.

Abas "Por serviço" e "Por site"
- Por serviço — uma linha por site que usa um banco ou o Redis deste servidor, com Site, Banco, Servidor da aplicação (marcado Remoto quando o site roda em outro servidor e usa este banco pela malha, como os sites do Worker 1) e Status. Cada linha tem Ver, que abre o visualizador, e Copiar URL, com Copiar URL de conexão e Copiar URL com túnel SSH. As URLs levam a senha real do banco, por isso só aparecem para quem pode ver o
.envdo site (Developer ou acima). - Por site — os sites do servidor com o tipo de banco, se o Redis está habilitado, o servidor da aplicação e o status. Útil para responder "qual banco pertence a
n20-todo.secnote.com.br?".
Sites com SQLite, como n20-storage.babytor.com.br, também aparecem: o banco é um arquivo no diretório compartilhado do site.
Visualizador de banco
Clique em Ver num banco PostgreSQL ou MySQL (Developer ou acima). O visualizador abre num painel lateral com:
- o Tamanho do banco;
- as Informações de conexão: Conexões máx., Ativas no banco e Ativas no servidor;
- as tabelas, com Linhas e Tamanho de cada uma, e as colunas de cada tabela (chave primária, autoincremento, chave estrangeira, nulo e valor padrão).
O visualizador mostra estrutura e contagens, não edita dados. Tudo é lido pelo próprio servidor por um canal seguro — você não precisa expor o banco à internet. Para conectar uma ferramenta sua, use Copiar URL com túnel SSH.

Armazenamento
A sub-página Armazenamento aparece nos servidores que rodam SeaweedFS (All-in-One, Serviços, Armazenamento S3 ou qualquer servidor em que você o instalou) e mostra os buckets S3 do servidor. Os dados são lidos do servidor quando a página abre (Consultando os buckets no servidor…); use Atualizar no topo para ler de novo.
Cada site com S3 habilitado recebe um bucket próprio (por exemplo {slug}-media), com uma chave de acesso que só enxerga aquele bucket. A página mostra:
- um resumo: SeaweedFS em execução (ou SeaweedFS parado, com o atalho Abrir Serviços), Armazenamento total e o total de buckets e de objetos;
- a tabela Buckets, com Bucket, Site (o site dono do bucket), Tamanho, Objetos e Criado em.
Um bucket que não pertence a nenhum site do painel — de um site excluído, por exemplo — aparece com o site órfão e a ação Excluir bucket órfão (Admin ou acima). Para confirmar, digite o nome do bucket; a exclusão apaga todos os objetos dele e não pode ser desfeita.

A API S3 de cada servidor é privada: responde na porta 8333 só em 127.0.0.1 (para sites do mesmo servidor) e no IP WireGuard do servidor (para sites de outros servidores da malha). Não há console nem subdomínio público — esta página é a interface.
Mover o banco ou o bucket para outro servidor
Um site pode levar o banco PostgreSQL/MySQL ou o bucket S3 dele para outro servidor da organização sem mudar de servidor: o código continua onde está e passa a usar os dados no servidor novo pela malha WireGuard. Use quando um servidor de banco está ficando sem espaço, quando você quer separar os dados de um All-in-One num servidor de Banco de dados ou de Armazenamento S3, ou para trazer de volta para perto do site um banco que estava em outro servidor.
A ação fica em Site › Serviços, no menu da linha Banco de dados ou Armazenamento S3: Mover para outro servidor (Admin ou acima). Ela aparece desligada, com o motivo ao passar o mouse, quando o servidor do site não está respondendo, quando já existe uma mudança ou uma janela de manutenção em andamento, durante um deploy ou uma migração do site, e em sites com balanceamento de carga.
O assistente
- Destino — os servidores da organização que têm o mesmo banco (PostgreSQL ou MySQL) ou o SeaweedFS instalado, com a versão e o espaço livre que o agente informou por último. Um servidor que não pode receber os dados aparece bloqueado com o motivo (por exemplo, uma versão de PostgreSQL mais antiga que a de origem: um dump não volta para uma versão anterior).
- Revisão — de onde para onde, os nomes do banco e do usuário (ou do bucket), as verificações, a estimativa da janela de manutenção e o passo a passo. Um impedimento não deixa o assistente seguir.
- Confirmação — marque Entendo que o site fica em manutenção durante a janela. e digite o domínio do site.

O que acontece
- O painel confere origem, destino, espaço em disco nos dois servidores e no próprio painel, e o
.envdo site. Se algo impedir, a mudança para aqui sem tocar em nada. - Cria no destino o banco e o usuário (ou o bucket e a chave) com as mesmas credenciais de hoje. Se faltar o túnel WireGuard entre o servidor do site e o destino, ele é criado antes.
- Só para o bucket: uma cópia quente, com o site no ar.
- Abre a janela de manutenção: o site mostra a página de manutenção e os workers, o Horizon, o agendador e os daemons param, para que nada seja gravado durante a cópia final.
- A cópia final: o dump do banco (gerado na origem, transferido criptografado e restaurado no destino) ou só o que mudou no bucket desde a cópia quente.
- A verificação: a contagem de linhas de cada tabela tem de ser igual nos dois lados (com checksum do conteúdo nas tabelas menores), ou os dois buckets têm de ficar idênticos.
- A troca: o painel aponta o
.envpara o novo servidor, refaz o cache de configuração e comprova que o app conecta — tudo ainda dentro da janela. - Fecha a janela: o site volta e só reinicia o que estava rodando antes.
A janela dura poucos minutos: um tempo fixo de preparo mais o tempo de copiar o banco (ou de comparar os objetos do bucket). Uma mudança cuja janela estimada passaria do limite (20 minutos por padrão) é recusada antes de começar.
Enquanto a mudança anda, Serviços mostra um quadro com a situação, a etapa atual, o início, o tempo decorrido e se a janela está aberta, além do registro de cada etapa; a Visão geral do site mostra uma linha curta com um atalho para Serviços. Se algo falhar antes da troca, o site continua nos dados de origem e o que foi criado no destino é removido. Se a verificação ou a troca falharem dentro da janela, o site volta para os dados de origem, que não foram tocados, e a mudança aparece como Desfeita. Nos dois casos o quadro explica o que houve e oferece Tentar de novo.
A cópia antiga
Depois de uma mudança concluída, os dados de origem ficam onde estavam, como cópia antiga, e aparecem em Serviços › Cópias antigas com o servidor, os nomes e a data. Uma semana depois, e a cada semana até ser removida, o painel avisa pelo alerta Cópia antiga de dados ainda guardada após mudança de servidor (veja Notificações). Elas nunca são oferecidas como "sobras" para limpeza.
- Remover cópia antiga apaga o banco e o usuário (ou o bucket e a chave) do servidor de origem. O site não é afetado, mas não há como desfazer: digite o nome do banco ou do bucket para confirmar. A remoção roda em segundo plano: a linha mostra Removendo… até terminar, e o resultado chega no sino de quem pediu. Se falhar, a cópia continua lá e o aviso diz o motivo.
- Voltar para a origem abre o mesmo assistente com o destino fixado no servidor da cópia antiga: os dados atuais do site são copiados para lá e substituem a cópia antiga; a cópia que fica no servidor de onde os dados saem passa a ser a nova cópia antiga. A cópia antiga do destino é apagada logo no início: se a mudança falhar, ela não volta (os dados do site continuam intactos onde estão) e sai da lista de cópias antigas. Enquanto essa mudança anda, Remover cópia antiga fica desligado para essa cópia.
O Histórico de mudanças de dados, abaixo, lista cada mudança com a data, de onde para onde, a situação, quem pediu e quanto durou a janela.
O que é recusado, e por quê
- SQLite — o banco é um arquivo dentro do site, não um serviço de outro servidor; não há o que mover por aqui.
- Sites com balanceamento de carga — várias instâncias escrevem nos mesmos dados; ainda não são suportados.
- Um usuário do banco que é dono de outros bancos, ou um
.envcom chaves que apontam para o servidor atual e que o painel não reescreve (por exemplo umDATABASE_URLou uma segunda conexão) — mover deixaria o app falando com dois lugares. Ajuste antes. - Um destino que já tem um banco, usuário ou bucket com o mesmo nome e que não é uma cópia antiga deste site — o painel não sobrescreve dados que não conhece.
- O servidor do painel não recebe o PostgreSQL nem o S3 de um site (um site hospedado nele só pode usar um MySQL local).
- Espaço em disco insuficiente na origem, no destino ou no painel, e uma janela estimada acima do limite.
Próximos passos
- Gerenciando um Servidor — as demais páginas do servidor, modo de manutenção e configurações
- Monitoramento e Agendador — acompanhe a saúde dos serviços e a recuperação automática
- Sites — crie um site e escolha em quais servidores ficam o banco, o Redis e o S3
- Configuração de Sites — ligue serviços num site e ajuste o PHP e o Node dele