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:
- Ligue Ativar gateway de saida.
- 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.
- 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. |
- Clique em Aplicar gateway.
- 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
- Clique em Sugerir com base nos recursos no topo da tela.
- 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).
- Clique em Aplicar sugestões nos campos para preencher o formulário.
- 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.