Pular para o conteúdo

Solucionar conflito de portas abertas entre Docker e firewall UFW

Por Equipe Técnica AviraHost · 16 min de leitura · Atualizado em · Docker, UFW, firewall, Linux, segurança, iptables, AviraHost · 0

Solucionar conflito de portas abertas entre Docker e firewall UFW é o procedimento de conter a exposição acidental de serviços de rede causada pela manipulação nativa de iptables realizada pelo daemon do Docker. Para proteger os containers e restabelecer o controle de tráfego pelo firewall, siga estes passos:

  1. Identifique as portas expostas externamente na interface pública do servidor.
  2. Vincule serviços não públicos explicitamente ao endereço de loopback local (127.0.0.1).
  3. Configure as regras da chain DOCKER-USER nos arquivos de pós-execução do UFW.
  4. Recarregue as configurações do firewall e valide o isolamento externo.

Pré-requisitos

  • Servidor rodando Ubuntu 24.04 LTS ou Debian 13 com Docker Engine instalado.
  • Firewall UFW (Uncomplicated Firewall) instalado e habilitado.
  • Acesso administrativo com privilégios via comando sudo.
  • Cliente de terminal ou estação remota para testar a acessibilidade das portas a partir de uma rede externa.

Diagnóstico do bypass do UFW pelo Docker

O bypass de regras ocorre porque a arquitetura de rede do Docker manipula tabelas do Netfilter de forma autônoma. Quando o UFW é habilitado, ele define regras padrão para pacotes que entram na máquina, alocando essas restrições primariamente na chain INPUT. O Docker, por sua vez, realiza DNAT na tabela nat/PREROUTING, convertendo o endereço de destino dos pacotes para o IP interno do container. Após esse DNAT, a decisão de roteamento direciona o pacote para a chain FORWARD — e não para INPUT — porque o destino final é um container encaminhado, não o próprio host.

O Docker insere suas chains (DOCKER-USER e DOCKER) no início da chain FORWARD, antes das chains do UFW (ufw-before-forward e ufw-user-forward). Por esse motivo, qualquer pacote destinado a uma porta mapeada em um container é encaminhado diretamente ao seu destino, sem jamais passar pelas regras de bloqueio convencional estabelecidas via ufw deny na chain INPUT. Para compreender melhor a base do firewall, consulte nosso artigo sobre Como Configurar Firewall em Servidor VPS Linux: Guia Prático com UFW.

Para constatar se o seu host está vulnerável a essa exposição indesejada, inicie verificando as portas TCP em escuta e, separadamente, os sockets UDP ativos:

sudo ss -tlpn
sudo ss -ulpn

Uma possível saída para sockets TCP indicará processos docker-proxy ouvindo no endereço genérico 0.0.0.0 — porém note que a presença do processo docker-proxy depende da configuração de userland-proxy e do backend de rede do Docker; em algumas configurações a porta estará acessível sem um processo docker-proxy visível. Complemente sempre a análise com docker port <container>, docker inspect <container> e um teste de acesso a partir de uma rede externa:

tcp   LISTEN 0      4096         0.0.0.0:8080       0.0.0.0:*    users:(("docker-proxy",pid=1420,fd=4))
tcp   LISTEN 0      4096            [::]:8080          [::]:*    users:(("docker-proxy",pid=1426,fd=4))

Em seguida, verifique como o Docker estruturou as regras de roteamento dentro do Netfilter:

sudo iptables -t nat -L DOCKER -n -v

Você observará que portas mapeadas recebem regras de destino DNAT (Destination NAT) automáticas, convertendo pacotes externos diretamente para os IPs internos da rede Docker (geralmente sob o bloco 172.17.0.0/16 ou similar), contornando as restrições que você acreditava estarem protegendo seu servidor.

Isolamento de containers via loopback local

A forma mais elegante e limpa de resolver conflitos de portas sem alterar o funcionamento do Netfilter é restringir o binding da porta do container para que ela responda exclusivamente na interface de loopback (127.0.0.1). Por padrão, quando você especifica -p 8080:80, o Docker assume o endereço coringa 0.0.0.0:8080:80, abrindo o serviço em todas as placas de rede do host, inclusive na interface pública voltada para a internet.

Ao associar a porta ao loopback, o serviço fica acessível apenas internamente dentro do próprio sistema operacional. Essa garantia aplica-se ao Docker Engine 28.0.0 ou posterior. Em versões anteriores à 28.0.0, portas publicadas em 127.0.0.1 podiam ser alcançadas por outros hosts do mesmo segmento de rede em determinadas configurações de camada 2. Independentemente da versão, mantenha filtragem adicional no firewall e valide a acessibilidade a partir de uma rede externa. Esse modelo é a arquitetura ideal quando se utiliza um proxy reverso (como Nginx ou Traefik) rodando no host para intermediar as requisições públicas de HTTPS e aplicar certificados TLS. Para entender estratégias avançadas de isolamento interno de serviços, veja nosso guia sobre Otimizar Docker Compose: portas só para serviços internos.

Para aplicar essa restrição via linha de comando ao instanciar um container avulso, declare o IP explicitamente no parâmetro de portas:

docker run -d --name web-interno -p 127.0.0.1:8080:80 nginx:alpine

Em ambientes orquestrados com Docker Compose, ajuste a seção ports no arquivo docker-compose.yml:

services:
  app:
    image: postgres:16-alpine
    restart: always
    environment:
      POSTGRES_PASSWORD: senha_temporaria_exemplo
    ports:
      - "127.0.0.1:5432:5432"

Após recriar o container, execute o utilitário ss para validar que o socket local está de fato isolado da interface pública:

sudo ss -tlpn | grep 5432

A saída deve exibir estritamente o endereço de loopback, garantindo que conexões externas vindas da internet não consigam negociar o handshake TCP com a porta:

tcp   LISTEN 0      4096   127.0.0.1:5432       0.0.0.0:*    users:(("docker-proxy",pid=2839,fd=4))

Configuração da chain DOCKER-USER no UFW

Quando é estritamente necessário expor portas de containers na interface pública ou permitir acesso a redes e IPs específicos (como um banco de dados liberado apenas para o IP fixo de uma filial), o isolamento em loopback não atende. Nesses cenários, a solução oficial recomendada pela equipe do Docker é interceptar o tráfego na chain DOCKER-USER.

O Docker cria a chain DOCKER-USER logo no início da chain FORWARD antes de processar qualquer regra própria. Esse mecanismo depende do backend iptables do Docker Engine; verifique se ele está ativo com docker info | grep -i iptables antes de prosseguir — no backend nftables nativo não existe uma chain DOCKER-USER equivalente e os comandos iptables apresentados podem não representar a configuração ativa. Por padrão, essa chain contém apenas uma regra RETURN, deixando todo o tráfego passar livremente. Podemos injetar regras no arquivo de pós-roteamento do UFW para forçar o descarte de pacotes não autorizados que entram pela interface de rede pública (geralmente identificada como eth0 ou enp3s0).

Primeiro, descubra o nome exato da sua interface pública de internet consultando a rota padrão do sistema:

ip route show default

A saída indicará diretamente a interface associada à rota padrão:

default via 203.0.113.1 dev eth0 proto static

Neste exemplo, a interface de internet é a eth0. Confirme os endereços ativos com ip -brief address se necessário. Agora, abra o arquivo de regras suplementares do UFW:

sudo nano /etc/ufw/after.rules

Role até o final do arquivo e, após a instrução final COMMIT, acrescente o bloco de controle para a chain DOCKER-USER. Substitua eth0 pela sua interface real e defina as exceções necessárias. Atenção: a chain DOCKER-USER só existe após o daemon Docker ter sido iniciado ao menos uma vez; execute sudo ufw reload somente depois que o Docker estiver ativo para evitar erros de chain inexistente:

# FILTRAGEM DOCKER-USER COMPATÍVEL COM UFW
*filter
:DOCKER-USER - [0:0]

# Permite tráfego estabelecido e relacionado (respostas a conexões legítimas)
-A DOCKER-USER -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT

# Permite que um IP externo específico acesse a porta publicada 8080 no host.
# A DOCKER-USER é percorrida após o DNAT; use --ctorigdstport para casar pela
# porta original publicada no host (8080), não pela porta interna do container (80).
-A DOCKER-USER -i eth0 -s 198.51.100.50 -p tcp -m conntrack --ctorigdstport 8080 --ctdir ORIGINAL -j ACCEPT

# Permite tráfego entre redes internas de containers e loopback
-A DOCKER-USER -i docker0 -j ACCEPT
-A DOCKER-USER -i lo -j ACCEPT

# Bloqueia conexões entrando pela interface pública com destino às bridges do Docker.
# As regras abaixo restringem o DROP explicitamente pela interface de saída (-o),
# evitando bloquear encaminhamento não relacionado a containers (VPNs, VMs, bonds).
# Se o host tiver propósito exclusivo de containers e não rotear para outras interfaces,
# pode-se simplificar para: -A DOCKER-USER -i eth0 -j DROP
-A DOCKER-USER -i eth0 -o docker0 -j DROP
-A DOCKER-USER -i eth0 -o br+ -j DROP

COMMIT

Se o seu ambiente utiliza IPv6 e o Docker Engine tem IPv6 habilitado, replique as regras equivalentes em /etc/ufw/after6.rules (ajustando endereços e CIDRs para IPv6) para garantir que o tráfego IPv6 encaminhado também seja filtrado.

Para entender como manipular prioridades e regras mais detalhadas no sistema, confira o guia sobre Otimizar UFW no Ubuntu 24.04: regras, prioridade e logs. Após salvar o arquivo, recarregue o UFW para ativar a nova estrutura de filtros:

sudo ufw reload

A confirmação esperada no terminal deve indicar que o firewall foi atualizado com sucesso:

Firewall reloaded

Para certificar-se de que a chain DOCKER-USER foi preenchida na ordem correta, execute:

sudo iptables -L DOCKER-USER -n -v --line-numbers

A listagem deve refletir as regras DROP escopadas pela interface de entrada pública (eth0) e pelas interfaces de saída das bridges (docker0, br+), posicionadas logo após as regras de permissão (ACCEPT), garantindo que conexões públicas não autorizadas sejam rejeitadas antes de entrarem nas bridges do Docker sem afetar outros caminhos de roteamento do host.

Problemas comuns e como resolver

Sintoma: Regras do UFW param de funcionar após reiniciar o serviço do Docker

Causa: Ao reiniciar o serviço docker.service, as chains nativas do daemon são recriadas no Netfilter, o que faz o Docker reinserir seus saltos no topo da chain FORWARD, podendo desordenar as diretivas inseridas pelo arquivo after.rules do UFW.
Solução: Execute sudo ufw reload imediatamente após reiniciar o daemon do Docker. Caso deseje automatizar essa sincronização em produção, configure um override do systemd executando sudo systemctl edit docker.service e insira o seguinte conteúdo completo no editor:

[Service]
ExecStartPost=/usr/sbin/ufw reload

Após salvar, execute sudo systemctl daemon-reload e valide o arquivo com systemd-analyze verify docker.service antes de aplicar em produção.

Sintoma: Containers perderam a conectividade com a internet externa

Causa: Foram aplicadas regras genéricas de bloqueio na chain DOCKER-USER sem a inclusão da regra fundamental que autoriza pacotes já estabelecidos e relacionados (conntrack). Com isso, quando o container tenta resolver um nome DNS ou baixar um pacote externo, a resposta dos servidores remotos é descartada pelo firewall.
Solução: Garanta que a regra -A DOCKER-USER -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT seja a primeira linha inserida dentro da chain DOCKER-USER no arquivo /etc/ufw/after.rules e recarregue o UFW.

Sintoma: Comunicação entre containers em redes diferentes foi interrompida

Causa: Foi declarada a regra -A DOCKER-USER -j DROP sem restringir a interface de entrada, fazendo com que o DROP incondicional atinja também o tráfego entre bridges internas virtuais (br-*) e interrompa o roteamento inter-redes do Docker.
Solução: Aplique a diretiva -j DROP exclusivamente condicionada à interface de entrada pública usando a flag -i (como -i eth0 -j DROP), nunca declarando -A DOCKER-USER -j DROP de maneira incondicional. Em hosts que roteiam tráfego para outros fins além de containers (VPNs, VMs, bonds), escopie também pela interface de saída da bridge (-o docker0 ou -o br+) para evitar bloquear encaminhamento não relacionado.

Perguntas frequentes

Por que o Docker ignora as regras do firewall UFW?

O Docker realiza DNAT na tabela nat/PREROUTING, convertendo o endereço de destino do pacote para o IP interno do container. Após esse DNAT, a decisão de roteamento direciona o pacote para a chain FORWARD — e não para a chain INPUT onde ficam as regras do UFW — porque o destino final é o container, não o próprio host. Dentro da chain FORWARD, o Docker insere suas chains DOCKER-USER e DOCKER no início, antes das chains do UFW, fazendo com que o tráfego para portas mapeadas seja encaminhado diretamente ao container sem jamais ser avaliado pelas políticas convencionais do UFW.

Desativar iptables no daemon.json do Docker resolve o problema?

Embora a diretiva iptables: false impeça a criação de regras automáticas, ela geralmente quebra o roteamento de rede nativo dos containers, incluindo acesso externo e conexões entre redes virtuais. Essa prática não é recomendada para servidores de produção modernos.

Qual é a maneira mais simples de proteger uma porta exposta pelo Docker?

A abordagem mais direta é vincular a porta explicitamente ao endereço de loopback durante a publicação, utilizando o padrão 127.0.0.1:porta:porta no comando docker run ou no compose file. Dessa forma, o serviço fica restrito ao host e pode ser gerenciado de forma segura por um proxy reverso.

O ufw-docker é uma solução segura para produção?

O ufw-docker é um projeto de terceiros, não um componente oficial do UFW nem do Docker. Ele é amplamente adotado por administradores de sistemas para modificar a chain DOCKER-USER de forma compatível com a sintaxe do UFW, permitindo autorizar ou bloquear conexões públicas a containers específicos sem interromper a comunicação de rede interna da engine. Para uso em produção, recomenda-se fixar uma versão auditada, verificar o código e a origem do utilitário, testar as regras geradas, manter um plano de rollback e confirmar compatibilidade com o backend iptables do Docker instalado.

Conclusão

  • Sempre vincule serviços auxiliares, como bancos de dados e caches, ao endereço 127.0.0.1 para neutralizar a exposição pública por design.
  • Utilize a chain DOCKER-USER no arquivo /etc/ufw/after.rules para gerenciar com precisão quais endereços IP têm autorização para interagir com serviços expostos.
  • Audite periodicamente as portas do seu servidor utilizando ferramentas de escaneamento externo para validar que novas implantações não criaram brechas na filtragem de tráfego.

Leia também

Precisa de ajuda com segurança e firewall em servidores?

Manter a segurança e o isolamento de rede entre containers e regras de borda exige uma infraestrutura estável, rápida e configurável. Nossos servidores VPS contam com acesso root completo para você implementar suas diretivas de segurança sem limitações.

Conheça nossos planos de Servidor VPS


Esta resposta foi útil?