Redes overlay e routing mesh
Uma rede overlay é uma rede do Docker que atravessa as máquinas do cluster e liga containers de VPS diferentes como se estivessem na mesma máquina. Cada serviço ligado a ela ganha um nome no DNS interno do Swarm, por isso o app alcança o banco pelo nome do serviço em qualquer nó, sem saber em qual VPS a réplica está rodando.
Ficha e sumário da página
- Referência técnica
- Docker Engine v29.9.3
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
As três redes que o Swarm cria
Quando uma máquina inicia um cluster ou entra num cluster existente, o Docker cria duas redes nela. A primeira é a ingress, uma rede overlay especial que leva o tráfego das portas publicadas até as tarefas dos serviços. A segunda é a docker_gwbridge, uma rede bridge que liga as redes overlay à rede física da máquina. Você raramente mexe nelas, porque o Docker cria as duas com uma configuração que serve à maioria dos clusters.
A terceira rede é a que você cria para os seus serviços com o comando docker network create --driver overlay. Num arquivo de stack, ela aparece na chave networks. Um serviço criado com docker service create sem rede declarada fica ligado à ingress.
O nome do serviço vira um endereço
O Swarm tem um componente de DNS interno que registra cada serviço com o próprio nome. Um container do Chatwoot procura o banco pelo nome do serviço, como postgres. O DNS responde com um endereço virtual, chamado VIP, que pertence ao serviço, não a uma tarefa. O Docker mantém a lista das tarefas ativas por trás do VIP e distribui as conexões entre elas.
O VIP explica por que a troca de uma tarefa não quebra as conexões dos outros serviços. Quando uma réplica cai e volta em outro nó, o endereço dela muda, mas o VIP do serviço continua o mesmo. Os outros serviços seguem usando o nome e o VIP, sem saber em qual nó cada réplica está.
A outra forma de descoberta é o DNS round-robin, ligado com --endpoint-mode dnsrr. Nesse modo não existe VIP: uma consulta ao nome devolve a lista de endereços das tarefas. A documentação indica esse modo para quando você roda o próprio balanceador, como o HAProxy, porque ele não funciona junto com uma porta publicada pelo routing mesh.
Dentro da mesma rede overlay, você não publica as portas usadas entre serviços. No exemplo da documentação, um WordPress com banco MySQL publica só a porta HTTP do WordPress. O MySQL fica sem porta publicada, alcançável só pelos serviços da mesma rede.
O routing mesh recebe a porta em todo nó
Quando um serviço publica uma porta com --publish published=8080,target=80, todos os nós do cluster escutam a porta 8080, inclusive os nós sem tarefa daquele serviço. O caminho de uma conexão que chega a um nó sem réplica segue esta ordem:
Cliente
worker-3:8080Abre a conexão na porta publicada de qualquer nó.
Nó que recebe
published=8080Escuta a porta mesmo sem tarefa do serviço.
IPVS
target=80Escolhe uma das tarefas ativas do serviço.
Rede ingress
overlayLeva a conexão até o nó da tarefa escolhida.
Tarefa
web.2O container responde pela porta 80 dele.
Para a alta disponibilidade, o routing mesh tira do cliente a necessidade de saber onde as réplicas estão. Um balanceador externo ou um registro DNS com os IPs de vários nós continua funcionando quando uma réplica muda de máquina. Se um nó inteiro cai, os outros nós seguem aceitando a porta. Você ainda precisa deixar a porta publicada aberta entre os nós e o balanceador externo, quando houver um.
A publicação em modo host, com mode=host na opção --publish, desliga o routing mesh para aquela porta. A porta fica aberta só nos nós que rodam uma tarefa do serviço. A conexão vai direto para o container daquela máquina, sem passar pelo IPVS. A documentação usa como exemplo um serviço global de cache de DNS, com uma tarefa em cada nó publicando a porta 53 em modo host.
Portas entre os nós e cifragem
Os nós de um cluster conversam por três portas, que precisam estar abertas entre eles e fechadas para a internet:
2377/tcpPlano de controle do Swarm, para a gestão do cluster.7946/tcp e udpDescoberta das redes entre os containers dos nós.4789/udpTráfego das redes overlay, inclusive a ingress, em VXLAN.
O Swarm separa o tráfego em dois tipos. O tráfego de controle, com as mensagens de gestão como a entrada e a saída de nós, é cifrado em todo cluster, conforme a documentação do modo Swarm. O tráfego das aplicações, entre os containers, não é cifrado por padrão. A opção --opt encrypted no docker network create liga a cifragem IPsec no nível do VXLAN para uma rede overlay, com um custo de desempenho que a documentação manda medir antes de usar em produção.
A cifragem da overlay depende das entradas de firewall que o Docker grava no iptables do host. O Docker Engine v29.9.3 corrige o CVE-2026-115538, falha que deixava as redes overlay sem a cifragem e sem a proteção contra pacotes forjados depois de o firewalld limpar as entradas do iptables gravadas pelo Docker. Um cluster com redes cifradas e firewalld nas VPS tem motivo para estar nessa versão ou acima dela.
Redes que aceitam containers avulsos
Uma rede overlay criada sem opções aceita só serviços do Swarm. A opção --attachable permite ligar também containers avulsos, criados com docker run, à mesma rede. Esse recurso aparece quando uma tarefa de manutenção, como um container temporário de backup, precisa alcançar o banco de um serviço pela rede interna.
Nas stacks da Promovaweb, os serviços web entram na rede overlay compartilhada network_swarm_public, que o Traefik também alcança. A página Providers e labels do portal Traefik mostra como ele encontra esses serviços pelo provider Swarm.
O próximo passo é ver como o Swarm leva senhas e arquivos de configuração até as tarefas sem gravá-los na imagem, na página Secrets e configs.