Docker Swarm部署Windows容器端口暴露失败无法本地访问问题求助

问题根因与解决步骤 #

1. 容器启动崩溃排查方法

首先执行docker service ps <你的服务名称> --no-trunc查看服务启动失败的具体报错，再通过docker logs <失败的容器ID>查看容器内部运行日志定位崩溃原因。
你当前使用mode: host的端口发布模式出现崩溃，大概率是宿主机的8080端口已被其他进程占用（比如本地IIS、其他运行中的服务），host模式会直接绑定宿主机端口，端口冲突会直接导致容器启动失败。可执行netstat -ano | findstr :8080检查端口占用情况，结束占用进程或更换published端口即可解决。

2. 外部NAT网络绑定报错解决

你遇到的network is declared as external, but it is not in the right scope: "local" instead of "swarm"报错，是因为Docker默认创建的Windows NAT网络是本地作用域（local scope），Docker Swarm栈仅支持使用集群作用域（swarm scope）的网络。
执行以下命令创建符合要求的overlay网络：

docker network create --driver overlay --scope swarm win-swarm-network

后续在compose配置中直接引用该网络即可，不要使用默认的本地NAT网络。

3. dnsrr模式下IP无法访问的问题

dnsrr模式下分配的10.0.7.2是Swarm overlay网络的内部IP，该网段默认仅能在集群节点的容器之间互通，宿主机没有加入overlay网络，自然无法直接访问该IP，无需在这个方向浪费时间。

本地访问服务的完整可行配置 #

使用Swarm默认的ingress端口发布模式即可实现本地直接访问，无需配置host模式或dnsrr：

version: '3.8'
services:
  your-service-name:
    image: 你的Windows容器镜像地址
    networks:
      - win-swarm-network
    ports:
      - target: 80
        published: 8080
    deploy:
      mode: global
networks:
  win-swarm-network:
    external: true

部署完成后，直接在本地访问http://localhost:8080即可访问容器服务，若访问失败可检查Windows Defender防火墙是否放开了8080端口的入站规则，同时确认容器内的服务是否监听在0.0.0.0而非仅本地回环地址。

内容的提问来源于stack exchange，提问作者dna