Pular para o conteúdo
Documentação

Portas TCP

Encaminhe portas TCP brutas (MySQL, SSH, FTP, Postgres, Redis, RDP) do HAProxy para servidores internos, com restrição por IP ou DDNS.

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

A tela Portas TCP publica serviços que não são sites, como banco de dados, SSH, FTP ou área de trabalho remota. O HAProxy escuta uma ou mais portas e repassa a conexão, sem abrir nem alterar o conteúdo, para os servidores internos que você indicar.

Para abrir, vá em Infraestrutura > Portas TCP no menu lateral.

Cada proxy criado aqui vira um bloco listen tcp_<nome> em mode tcp na configuração do HAProxy. Toda alteração é validada com haproxy -c antes de ser gravada e, se a validação falhar, nada muda.

Criar um proxy TCP

  1. Clique em Novo Proxy TCP.
  2. Se quiser, escolha um Preset (opcional): MySQL (3306), PostgreSQL (5432), SSH (22), FTP (21) - controle, Redis (6379), MongoDB (27017), RDP (3389) ou SMTP (25). O preset preenche nome, porta de escuta e porta de destino (só os campos ainda vazios).
  3. Preencha os campos:
Campo O que informar
Nome do proxy Identificador com letras, números, - e _ (ex.: mysql). Gera o bloco listen tcp_<nome>
Porta(s) de escuta Porta pública no HAProxy. Use vírgula para várias e - para intervalo (ex.: 21,30000-30010)
Bind Endereço onde escutar. * = todas as interfaces (padrão), ou um IP específico do servidor
Balance Como distribuir conexões entre servidores: roundrobin (revezamento), leastconn (o servidor com menos conexões abertas), source (o mesmo IP de origem vai sempre para o mesmo servidor) ou first (enche o primeiro servidor antes de usar o próximo)
Timeout Tempo máximo de inatividade da conexão, para cliente e servidor (padrão 1h; aceita 30s, 5m, 1h...)
Nome do servidor Nome do primeiro servidor de destino (ex.: db1)
Endereco (IP ou hostname) IP ou nome do servidor interno (ex.: 192.0.2.5)
Porta destino Porta do serviço no servidor interno
Preservar porta Liga quando o destino deve receber na mesma porta em que o cliente conectou. Use para FTP passivo com faixa de portas (ex.: 40001-40100). Desabilita o campo Porta destino
  1. Clique em Criar Proxy. A mensagem Proxy TCP 'nome' criado nas portas ... confirma a criação e o HAProxy é recarregado.

A configuração gerada fica assim:

listen tcp_mysql
	bind *:3306
	mode tcp
	balance roundrobin
	option tcplog
	timeout connect 5s
	timeout client 1h
	timeout server 1h
	server db1 192.0.2.5:3306 check

Atenção: as portas 80, 443 e a porta do próprio painel são reservadas, e uma porta já usada por outro proxy não pode ser reaproveitada. Nesses casos aparece Porta(s) ja em uso ou reservada(s).

Atenção: abrir uma porta de banco de dados ou SSH para a internet expõe o serviço a tentativas de invasão. Sempre que possível, use a restrição por IP (veja abaixo).

Acompanhar o proxy

Cada proxy aparece num cartão com o nome e etiquetas de endereço/portas, algoritmo de balanceamento, timeout e, se houver, Restrito (N) com a quantidade de IPs liberados. A tabela lista os servidores de destino:

Coluna O que mostra
Servidor Nome do servidor
Destino Endereço e porta. mesma porta indica que a porta de escuta é preservada
Status Estado informado pelo HAProxy: UP, DOWN, MAINT etc., ou Desabilitado
Sessoes Conexões atual / máximo / total desde o último reload

Dica: servidores com Preservar porta são criados sem checagem de saúde (o teste precisaria de uma porta fixa), então o HAProxy não tira esse servidor de rotação automaticamente se ele cair.

Adicionar, pausar e remover servidores

  • Adicionar: clique em Servidor no cartão do proxy, informe Nome do servidor, Endereco (IP ou hostname) e Porta destino (ou ligue Preservar porta) e clique em Adicionar. Com dois ou mais servidores o HAProxy passa a distribuir as conexões conforme o Balance.
  • Desabilitar / Habilitar: os botões de pausa e play na coluna Acoes colocam o servidor em manutenção ou o devolvem. O efeito é imediato, sem reload, e a mudança fica gravada na configuração.
  • Remover: o botão da lixeira na linha do servidor remove só aquele servidor, após confirmação.

Atenção: desabilitar ou remover o único servidor de um proxy deixa a porta sem destino: as conexões passam a falhar.

Editar ou remover o proxy

  • O botão do lápis abre Editar Proxy, onde você muda Porta(s) de escuta, Bind, Balance e Timeout. Os servidores de destino e a restrição de acesso são preservados. Clique em Salvar.
  • O botão da lixeira no cabeçalho do cartão remove o proxy inteiro, com todas as portas e a lista de IPs liberados, depois de confirmar.

Restringir o acesso por IP ou DDNS

Use a restrição para que só endereços conhecidos consigam conectar, por exemplo o escritório e a casa do administrador.

  1. Clique no botão do escudo com cadeado no cabeçalho do proxy. Abre a janela Restricao de Acesso (TCP).
  2. Preencha:
Campo O que informar
IPs / faixas (CIDR) permitidos Um por linha (ou separados por vírgula/espaço). Aceita IPv4, IPv6 e faixas CIDR, ex.: 203.0.113.10 ou 198.51.100.0/24
Hostnames DDNS Nomes de DNS dinâmico, ex.: escritorio.exemplo.com.br. São resolvidos automaticamente a cada 5 minutos
  1. Clique em Salvar. O cartão passa a mostrar a etiqueta Restrito (N).

Conexões de qualquer endereço fora da lista são rejeitadas logo na abertura (tcp-request connection reject). A janela mostra também IPs atualmente liberados, já com os DDNS resolvidos. Se você usa DDNS e o IP acabou de mudar, clique em Resolver DDNS agora para não esperar os 5 minutos.

Para tirar a restrição, abra a mesma janela, deixe os dois campos vazios e clique em Salvar.

Dica: se nenhum dos nomes DDNS resolver e não houver IP fixo na lista, o painel não aplica a restrição (aviso Nenhum IP resolvido), para não bloquear todo mundo por engano.

Logs dos proxies TCP

Os proxies TCP gravam log no formato tcplog. Por padrão eles saem misturados no log geral do HAProxy. Para ter um arquivo por proxy, vá em Sistema > Logs, no cartão Logs de portas TCP, e clique em Ativar separacao de logs TCP (requer o rsyslog instalado no servidor). Os proxies criados depois disso já nascem com o log separado.

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!