Pular para o conteúdo
Documentação

Configs

Ajustes gerais do painel (nome do servidor, e-mail do responsável, tempo de login), retenção de dados, gateway de saída e parâmetros globais do HAProxy.

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

A tela Configs (título Configuracoes) reúne as preferências do próprio painel e os parâmetros globais do HAProxy que antes exigiam editar o haproxy.cfg. Ela fica em Sistema > Configs.

A tela tem blocos independentes, e cada um tem o seu botão de salvar:

Bloco O que guarda Recarrega o HAProxy?
Geral do painel Nome do servidor, e-mail do responsável, tempo de login Não
Retencao de dados Quanto tempo guardar backups e históricos Não
Alertas Canais e eventos de aviso (veja Alertas) Não
Gateway de saida NAT para as VMs da rede interna Não (mexe no kernel/firewall)
Global, Timeouts (defaults), Opcoes HTTP (defaults) Parâmetros do haproxy.cfg Sim, pelo botão Aplicar e Reload

Dica: os blocos Geral do painel, Retencao de dados e Alertas salvam sem recarregar a página e sem voltar ao topo.

Geral do painel

Campo O que informar
Nome do servidor Nome curto para identificar este proxy (até 40 caracteres: letras, números, espaço e . - ( ) /). Aparece no topo do menu, no título da aba do navegador e nos alertas. Vazio = usa o hostname da máquina nos alertas.
Email do responsavel E-mail usado como padrão na emissão dos certificados Let's Encrypt, destino dos alertas por e-mail e padrão onde o painel pedir e-mail.

Clique em Salvar. A mensagem Identificacao salva. confirma.

Dica: sem e-mail preenchido aqui, a emissão de certificado tenta reaproveitar o e-mail da conta do Let's Encrypt que já existir no servidor.

Tempo de login

Campo O que informar
Tempo de login (horas) Por quanto tempo a sessão do painel fica válida antes de pedir login de novo. De 1 a 168 horas (padrão 6).

Clique no botão de salvar ao lado do campo. O novo tempo vale a partir do próximo login.

Retenção de dados

Define por quanto tempo o painel guarda cópias e históricos. Valores maiores ocupam mais disco no stats.db e em /etc/haproxy/backups/.

Campo O que informar
Backups do haproxy.cfg: manter os ultimos Quantos backups do haproxy.cfg manter. 0 = sem limite. A linha mostra quantos arquivos e MB existem hoje.
Backups: apagar mais velhos que (dias) Apaga backups mais antigos que N dias. 0 = sem limite. O backup mais recente nunca é apagado.
Historico por hora (dias) Histórico agregado por hora de tráfego, uso do cache e acertos das regras. De 7 a 730 (padrão 90).
Detalhe por minuto (dias) Tráfego por minuto e estatísticas dos servidores (os gráficos do Dashboard). De 1 a 30 (padrão 3). É o que mais pesa no banco.
Saude dos dominios (dias) Histórico de uptime da tela Saude (uptime). De 1 a 90 (padrão 7).

Clique em Salvar e confirme.

Atenção: ao salvar, os backups além do limite são apagados na hora (a mensagem informa quantos). Se precisar de algum backup antigo, baixe-o antes na tela Backups.

Alertas

O bloco Alertas envia avisos por Telegram, webhook ou e-mail quando um domínio cai, um servidor fica DOWN, um certificado está vencendo, o reload falha ou há pico de bloqueios. A configuração está detalhada em Alertas.

Gateway de saída (internet para as VMs internas)

Use este bloco quando as VMs da rede interna (os backends) não têm saída própria para a internet e devem sair pelo IP público deste servidor. O painel liga o roteamento (ip_forward) e uma regra de NAT (masquerade) no nftables, e mantém tudo ativo após reiniciar o servidor.

O bloco mostra o estado atual:

  • Roteamento (ip_forward): ligado ou desligado no kernel;
  • NAT (masquerade): regra nftables ativo ou inativo.

Para ativar:

  1. Ligue Ativar gateway de saida.
  2. Em Redes internas de origem (quem sai por aqui), marque as redes que podem sair por este servidor. A lista mostra cada rede com a interface e o IP local.
  3. Escolha o Firewall de encaminhamento:
Opção Efeito
Restrito Recomendado. Só as redes marcadas saem; o resto do encaminhamento é bloqueado.
Liberado Encaminha tudo, sem filtro.
  1. Clique em Aplicar gateway.
  2. Nas VMs, aponte o gateway (e o DNS, se for o caso) para o IP interno deste servidor, mostrado no texto do bloco.

Para desligar, desmarque Ativar gateway de saida e clique em Aplicar gateway: o NAT é removido e o ip_forward volta a 0.

Atenção: com o gateway ligado o servidor passa a funcionar como roteador. Se este servidor cair, as VMs que dependem dele ficam sem internet.

Bloco antigo de bots e rate limit

Em servidores instalados com versões antigas podem aparecer dois cartões em amarelo:

  • Bloqueio de bots antigo: User-Agents bloqueados por linhas fixas no ft_https. Clique em Mover para a Blocklist para levá-los à Blocklist de UA em Regras, sem interromper o bloqueio.
  • Rate Limiting global (antigo): limite de requisições por IP (Requests / 10s, Stick Table Size). O lugar disso agora é Regras (aba Limite por dominio ou ação Limitar (429) nas Condicoes). Configure lá, desligue Rate Limit ativo aqui e clique em Aplicar e Reload; o cartão some.

Os cabeçalhos HSTS e nosniff ficam em Protecao avancada (Cabecalhos de seguranca).

Parâmetros do HAProxy

Os três blocos abaixo alteram o haproxy.cfg e só são aplicados ao clicar em Aplicar e Reload.

Global

Campo O que muda
Max Conexoes maxconn global: total de conexões simultâneas que o HAProxy aceita. Acima disso, novas conexões esperam.
Threads nbthread: quantas threads o HAProxy usa. Normalmente igual ao número de CPUs.
Buffer Size tune.bufsize: tamanho do buffer por conexão (bytes). Aumente só se houver cabeçalhos/cookies muito grandes.
Max Headers tune.http.maxhdr: máximo de cabeçalhos HTTP por requisição.

Timeouts (defaults)

Os valores aceitam unidades do HAProxy (5s, 30s, 1m).

Campo O que muda
Connect Tempo para abrir a conexão com o backend. Se estourar, o visitante recebe 503.
Client Inatividade máxima do visitante.
Server Inatividade máxima do backend. Páginas que demoram mais que isso para responder recebem 504.
HTTP Keep-Alive Tempo de espera por uma nova requisição na mesma conexão.
HTTP Request Tempo máximo para o visitante enviar os cabeçalhos da requisição (protege contra conexões lentas).
Queue Tempo máximo na fila quando os servidores estão no limite.
MaxConn (defaults) Limite de conexões por frontend/backend.

Dica: relatórios ou exportações que demoram minutos no backend estouram o Server. Em vez de subir o timeout para todos, ajuste Timeout resposta só no backend que precisa, na tela do backend.

Opções HTTP (defaults)

Opção Efeito
HTTP Keep-Alive option http-keep-alive: mantém conexões persistentes.
Forward For option forwardfor: envia o IP real do visitante ao backend no cabeçalho X-Forwarded-For.
HTTP Log option httplog: log detalhado de cada requisição.
Dont Log Null option dontlognull: não registra conexões que não enviaram requisição.

Sugerir com base nos recursos

  1. Clique em Sugerir com base nos recursos no topo da tela.
  2. O painel lê CPUs, RAM e o limite de arquivos abertos do servidor e mostra uma tabela com Campo, Atual, Sugerido e Motivo (para threads e limites de conexão).
  3. Clique em Aplicar sugestões nos campos para preencher o formulário.
  4. Revise e clique em Aplicar e Reload para gravar.

Aplicar

Clique em Aplicar e Reload e confirme. O painel valida a configuração, cria um backup automático e recarrega o HAProxy. Se a validação falhar, nada é gravado e a mensagem mostra o erro.

O botão Editor Raw, no topo, abre a tela Config Raw.

Veja também

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!