Rede overlay criptografada perde o IPsec depois de um reload do firewalld
A criptografia de uma rede overlay depende de duas entradas que o dockerd instala no iptables ao criar o primeiro endpoint local: uma na cadeia OUTPUT da tabela mangle marca os datagramas VXLAN com o VNI da rede, e uma no topo da cadeia INPUT da tabela filter descarta o que chega com esse VNI sem ter passado pelo IPsec. O dockerd escuta os eventos do firewalld pelo D-Bus e reprograma as próprias entradas, mas o driver overlay não entra nesse mecanismo. Um reload do firewalld apaga as duas entradas e o host envia VXLAN em texto claro e aceita datagramas em texto claro com o VNI da rede, o que permite injetar quadros Ethernet pela porta UDP 4789. O estado só volta quando o último endpoint local da rede é removido e outro entra, ou quando o dockerd reinicia, e nada é escrito no log.
Casos de uso afetados
- Você tem um host do Swarm com pelo menos uma tarefa ou container ligado a uma rede overlay criada com a opção encrypted.
- O firewalld está ativo nesse host com FirewallBackend=iptables, com FirewallBackend=nftables numa versão sem o commit b7faa74, ou com entradas diretas, chains próprias ou passthrough configurados.
- O host recebe firewall-cmd --reload de uma ferramenta de configuração, teve o firewalld reiniciado durante uma atualização de pacote ou iniciou o firewalld depois do dockerd.
Confira na sua instância
Confira em cada host a versão com docker version e o backend com grep FirewallBackend /etc/firewalld/firewalld.conf. Liste as redes com docker network ls --filter driver=overlay e veja no docker network inspect se a rede usa encrypted e qual VNI aparece em com.docker.network.driver.overlay.vxlanid_list. Guarde a saída de iptables-save -t mangle e de iptables-save -t filter e procure as entradas que citam esse VNI. Rode firewall-cmd --reload num host de homologação com a configuração afetada, repita as duas listagens e compare: se as entradas sumiram, a falha está presente. Numa captura controlada do UDP 4789 entre dois hosts, os pacotes aparecem como VXLAN legível em vez de ESP.
Versões afetadas e correções
| Linha | Afetadas | Corrigidas |
|---|---|---|
| Docker Engine | < 29.9.3 | 29.9.3 |
| github.com/moby/moby/v2 | <=v2.0.0-beta.28 | v2.0.0-beta.29 |
O aviso não traz paliativo que preserve a criptografia sozinho. Manter o firewalld 2.0.0 ou superior em nftables, sem configuração direta, evita que ele apague as entradas, e reiniciar o dockerd depois de cada evento reprograma tudo, com o custo de reiniciar as tarefas do host. Fechar o UDP 4789 na borda da rede impede a injeção vinda de fora, mas não protege o conteúdo entre os hosts. Num host que ainda tem as entradas, o tráfego vindo do host afetado é descartado, e o pacote já cruzou a rede sem proteção. O CVE correspondente é CVE-2026-115538.
