使用docker stack deploy部署时无法指定IP:端口的问题求助

你遇到的问题是Docker Swarm Stack部署时无法绑定127.0.0.1回环IP，这是因为Swarm默认使用ingress网络来发布服务端口，这种模式下端口会绑定到节点的所有网卡（也就是*:8001->80/tcp），不支持直接在ports字段中指定回环IP。

解决方案：使用host端点模式 #

要让服务绑定到127.0.0.1，你需要修改docker-compose.yml，添加endpoint_mode: host配置，同时保留端口的回环IP绑定：

version: "3"
services:
  dhsearch:
    image: dhsearch
    ports:
      - "127.0.0.1:8001:80"  # 明确指定回环IP
    deploy:
      replicas: 1
      endpoint_mode: host     # 启用host模式，绕过ingress网络

然后重新部署服务：

docker stack deploy -c docker-compose.yml dhsearch

注意事项 #

• endpoint_mode: host会让服务直接使用主机的网络命名空间，不再通过Swarm的ingress负载均衡网络。这意味着：
  • 服务只能部署在单个节点上（如果设置replicas>1，多个副本会在同一节点上竞争端口，导致启动失败）
  • 主机上的其他服务或进程不能占用127.0.0.1:8001端口
  • 跨节点无法访问这个服务（因为绑定的是节点本地回环）

验证部署结果 #

重新部署后，执行docker stack services dhsearch，应该会看到端口显示为127.0.0.1:8001->80/tcp。

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