如何在Docker容器内配置宿主机自定义主机名

• 对自定义桥接网络的网关IP存在认知偏差
  你配置里写的10.0.0.1是自建bridge网络的内部虚拟网关，根本不是能直接访问宿主机本地服务的有效地址：
  • 如果是Mac/Windows下的Docker Desktop环境，这个IP只是Docker后台虚拟机内部的NAT出口，完全没有把流量转发到物理宿主机本地HAProxy的逻辑，哪怕你在容器里curl 10.0.0.1，实际访问的是Docker虚拟机内部的网关，根本碰不到你跑在物理机上的服务。
  • 如果是原生Linux环境，虽然这个IP是宿主机上桥接网卡的真实地址，但默认防火墙规则会拦截从docker网段过来的外部访问，加上HAProxy大概率只绑定了本地回环或者物理网卡IP，没有监听这个桥接网卡的地址，自然会出现连curl 10.0.0.1都不通的情况。
• extra_hosts配置的映射目标失效
  你的extra_hosts语法本身没有问题，但映射到的10.0.0.1是不可达的，等于给域名配了个空的指向，自然没法正常解析连通。
  你能正常访问docker.host.internal的原因也很简单：这是docker内置的特殊域名，docker本身会通过端口转发、防火墙放通等方式打通容器到宿主机本地服务的通路，而你手动硬编码的10.0.0.1没有这套打通逻辑，哪怕是网关地址也没法正常访问宿主机服务。

方案一：复用docker内置的宿主机解析能力（推荐开发环境使用） #

这是docker 20.10版本之后原生支持的能力，不需要手动计算宿主机IP，也不需要调整防火墙、网络规则，只要修改compose配置即可：

networks:  
  local:
    driver: bridge
    # 没有固定IP需求的话，可以删掉自定义ipam配置，避免网段冲突
    # ipam:
    #   driver: default
    #   config:
    #     - subnet: 10.0.0.0/24
    #       gateway: 10.0.0.1

services:
  myservice:
    build:
      context: ../myservice
    networks:
      - local
    extra_hosts:
      # 用host-gateway替代硬编码的10.0.0.1，docker会自动把该域名解析到和docker.host.internal一致的可达地址
      - "myaccount.mycompany.io:host-gateway"

重新创建容器后，容器内访问myaccount.mycompany.io会直接走和docker.host.internal一样的通路，完全满足自定义主机名的业务需求，不需要额外配置。

方案二：保留自定义网段的适配方案（适合原生Linux开发环境） #

如果你确实需要固定的10.0.0.0/24网段，需要补齐三个缺失的配置才能让网关地址正常访问宿主机服务：

• 确认桥接网卡配置。在宿主机上执行ip addr show br-<你自定义网络ID的前12位>，确认桥接网卡上真的配置了10.0.0.1的IP，避免docker因为网段冲突自动调整了网关地址。
• 放通docker网段访问。调整宿主机防火墙规则，把10.0.0.0/24网段加入信任来源，允许该网段流量访问HAProxy监听的端口。
• 调整HAProxy绑定配置。确保HAProxy的监听地址没有仅绑定127.0.0.1，而是包含10.0.0.1，或者直接绑定对应端口到0.0.0.0。
  完成上述调整后，原有的extra_hosts配置即可正常生效。

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