Pular para o conteúdo
Documentação

Modo de operação: Apache, NGINX ou NGINX + Apache

Como escolher e trocar o servidor web que atende os sites: Apache Only, NGINX Only ou NGINX + Apache.

R Regis Manze 20/11/2026 5 min de leitura

O Modo de operação define qual servidor web atende os sites deste servidor. Acesse em Runtime & Performance → Modo de Operacao.

No topo da tela aparecem o modo atual e a situação de Apache, NGINX, Certbot e a quantidade de certificados SSL ativos.

Os três modos

Modo Portas Fluxo da requisição Quando usar
Apache Only Apache na 80 Cliente → Apache → PHP-FPM Servidores pequenos e configuração mais simples. Sites usam .htaccess normalmente.
NGINX Only NGINX na 80/443 Cliente → NGINX (SSL) → PHP-FPM Menor consumo de memória. Não há Apache, então não há .htaccess: as regras de reescrita ficam no NGINX.
NGINX + Apache NGINX na 80/443, Apache na 8080 Cliente → NGINX (SSL) → Apache → PHP-FPM NGINX entrega estáticos e SSL; Apache mantém .htaccess e mod_rewrite.

Em todos os modos o PHP roda em PHP-FPM, com um pool por usuário.

Trocar de modo

  1. Abra Modo de Operacao.
  2. No cartão do modo desejado, clique em Trocar para Apache Only, Trocar para NGINX Only ou Trocar para NGINX + Apache.
  3. Confirme a mensagem.

O que o painel faz na troca:

  • Instala o NGINX, se o modo novo usa NGINX e ele ainda não existe.
  • Ajusta as portas do Apache (80 no Apache Only, 8080 nos modos com NGINX).
  • Regenera a configuração de todos os domínios para o modo novo.
  • Liga, desliga e habilita no boot os serviços conforme o modo.

Atenção: a troca reinicia o servidor web. Faça em horário de pouco movimento.

Proteções na troca

  • Para NGINX Only, o painel testa a configuração (nginx -t) e confirma que o NGINX subiu antes de parar o Apache. Se o NGINX falhar, o Apache continua no ar e a tela mostra o erro.
  • Para NGINX + Apache, se o teste do NGINX falhar, o NGINX não é recarregado.
  • Nos modos com Apache, o painel testa a configuração do Apache (configtest) antes de reiniciá-lo. Se o teste falhar, o Apache não é reiniciado e continua rodando com a configuração que já estava carregada; a tela mostra o erro.
  • Ao entrar em Apache Only, o NGINX é parado e desabilitado, e as configurações dele são removidas.

NGINX Only e regras de reescrita

Sem Apache, o arquivo .htaccess é ignorado. Cada domínio usa um template de reescrita escolhido ao criar o domínio, no campo Template da Aplicacao:

Template Uso
Generico try_files para index.php. Serve para a maioria dos sites PHP.
Magento 2 Regras do Magento 2. Também ajusta os diretórios temporários do PHP para var/tmp da loja.
Laravel Regras do Laravel.

O conteúdo de cada template pode ser editado em Configuracoes → Templates. Veja Configurações do servidor web e do kernel.

Dica: antes de trocar para NGINX Only, confira se algum site depende de regras próprias no .htaccess (redirecionamentos, bloqueios, cabeçalhos). Essas regras precisam ser recriadas no template.

Certificados SSL nos modos com NGINX

Nos modos NGINX Only e NGINX + Apache, a tela mostra o bloco Certificados SSL, com a lista de domínios e a situação de cada um.

Botão O que faz
Let's Encrypt Emite um certificado gratuito com o certbot para o domínio e seus aliases. Pede um e-mail para avisos.
Certificado Customizado Envia um certificado próprio (.crt/.pem, de preferência a cadeia completa) e a chave privada (.key).
Renovar Todos Renova os certificados Let's Encrypt.
Emitir SSL Atalho na linha do domínio para emitir pelo Let's Encrypt.
Remover SSL Tira o SSL do domínio, que volta a responder só em HTTP.

No Certificado Customizado, o painel confere antes de gravar se o certificado está em formato PEM, se a chave está em PEM e sem senha, e se os dois formam par. Se o servidor web recusar a configuração, nada muda.

O certificado Let's Encrypt tem sempre o nome do domínio principal. Ao mudar os aliases e emitir de novo, o mesmo certificado é renovado com os novos nomes.

Atenção: para o Let's Encrypt validar, o domínio precisa já apontar para o IP deste servidor.

No modo Apache Only esse bloco não aparece. Para gerenciar SSL no próprio servidor, troque para NGINX + Apache. Se houver um HAProxy na frente terminando o SSL, os certificados são gerados lá. Veja a categoria Administração: SSL, HAProxy e DNS.

Página "domínio não configurado"

Quando um domínio aponta para o servidor mas não tem site cadastrado, o servidor mostra esta página em vez de abrir o primeiro site da lista. Edite o HTML na caixa e clique em Salvar e aplicar. Use Restaurar padrao para voltar ao texto original.

O certificado usado no HTTPS dessa página é próprio, então o navegador pode exibir um aviso de certificado antes de mostrá-la.

Capa de site inativo

É a página exibida, com status 503, para domínios desativados e domínios de contas suspensas, em HTTP e HTTPS. Os arquivos do site não são alterados. Ao reativar, o site volta como estava.

A tela lista os domínios inativos no momento. Edite o HTML e clique em Salvar e aplicar, ou Restaurar padrao.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!