wils@web ~ $ cat ~/ajuda/como-configurar-um-balanceador-de-carga-com-haproxy-2-8-para-aplicacoes-web.md

Servidores

Como configurar um balanceador de carga com HAProxy 2.8 para aplicações web

atualizado em 19/08/2026

O HAProxy é uma solução popular para balanceamento de carga, amplamente utilizada em ambientes de produção para distribuir o tráfego entre múltiplos servidores. Neste manual, vamos aprender como configurar o HAProxy 2.8 para aplicações web.

Pré-requisitos

  • Um servidor Linux (Ubuntu, CentOS, etc.)
  • HAProxy 2.8 instalado
  • Acesso root ou sudo

Passo a Passo

1. Instalação do HAProxy

Primeiro, instale o HAProxy usando o gerenciador de pacotes da sua distribuição:

# Para Ubuntu/Debian
sudo apt update
sudo apt install haproxy
# Para CentOS/RHEL
sudo yum install haproxy

2. Configuração do HAProxy

O arquivo de configuração do HAProxy geralmente está localizado em /etc/haproxy/haproxy.cfg. Abra-o com um editor de texto:

sudo nano /etc/haproxy/haproxy.cfg

Adicione a seguinte configuração básica:

global
    log /dev/log local0
    maxconn 2000

defaults
    log global
    option httplog
    timeout connect 5000ms
    timeout client 50000ms
    timeout server 50000ms

frontend http_front
    bind *:80
    acl is_webservice path_beg /api
    use_backend api_back if is_webservice
    default_backend web_back

backend web_back
    server web1 192.168.1.2:80 check
    server web2 192.168.1.3:80 check

backend api_back
    server api1 192.168.1.4:80 check
    server api2 192.168.1.5:80 check

Esta configuração define um frontend que escuta na porta 80 e direciona o tráfego para diferentes backends com base no caminho da URL.

3. Teste e Reinicie o HAProxy

Após salvar as alterações, teste a configuração:

sudo haproxy -c -f /etc/haproxy/haproxy.cfg

Se não houver erros, reinicie o HAProxy para aplicar as alterações:

sudo systemctl restart haproxy

4. Verificação do Status

Para verificar se o HAProxy está funcionando corretamente, você pode usar:

sudo systemctl status haproxy

Conclusão

Agora você tem um balanceador de carga configurado com o HAProxy. Lembre-se de monitorar o desempenho e ajustar as configurações conforme necessário. Uma dica é habilitar o modo de stats do HAProxy para visualizar métricas de desempenho.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.