如何在Ubuntu上自动为Docker容器注入host.docker.internal配置？

直接在你的docker-compose.yml里统一添加以下配置即可，无需区分操作系统：

services:
  # 替换成你的服务名称
  your-service-name:
    # 其他服务配置（镜像、端口、卷等）...
    extra_hosts:
      - 'host.docker.internal:host-gateway'

原理说明 #

• Windows和Mac的Docker Desktop（18+版本）本身会自动注入host.docker.internal，但手动添加这条配置不会产生冲突——host-gateway是Docker官方支持的跨平台占位符，在Win/Mac环境下会自动映射到正确的宿主机地址，和Docker自动添加的条目效果一致。
• Ubuntu等Linux原生Docker环境中，这条配置会直接将host.docker.internal指向宿主机网关，完美补全平台差异。

额外优化（可选） #

如果担心某些场景下重复添加host条目，也可以通过环境变量实现条件注入：

1. 在Ubuntu的终端配置文件（如~/.bashrc或~/.zshrc）中添加：

   export DOCKER_EXTRA_HOSTS="extra_hosts:\n      - 'host.docker.internal:host-gateway'"
   

2. 在docker-compose.yml中引用变量：

   services:
     your-service-name:
       # 其他配置...
       ${DOCKER_EXTRA_HOSTS:-}
   

这种方式下，只有Ubuntu环境会加载extra_hosts配置，Win/Mac则保持默认行为。

你的思路完全没问题——核心就是抹平Docker在不同平台的行为差异，避免频繁修改配置文件的繁琐操作。

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