Shinyproxy：构建Docker镜像时如何传递Hosts配置

先帮你理清楚之前三个方案失败的原因，再给你靠谱的实现方式：

为什么你的三个方案都不行？ #

• 方案1：Dockerfile直接COPY /etc/hosts
  Docker构建时只能访问构建上下文目录（就是你执行docker build时指定的那个目录，默认是当前目录）里的文件，宿主机的/etc/hosts不在这个上下文范围内，所以Docker找不到它，自然报错。

• 方案2：复制到应用目录再COPY
  这个操作本身没问题，但你复制的是构建时刻的宿主机hosts——如果后续宿主机修改了hosts，容器里的不会同步；而且换一台服务器构建，镜像里的hosts就变成那台服务器的了，没法做到"在所有服务器环境运行"的要求。

• 方案3：构建时加--add-host
  搞错时机啦！--add-host是运行容器时的参数，构建镜像阶段根本不会处理这个参数，所以完全无效。

正确的实现方式（分两种场景） #

场景1：容器运行时自动适配宿主机hosts（推荐，保证镜像通用性） #

如果你的需求是让容器在任意服务器上运行时，自动使用该服务器的/etc/hosts配置，最合理的方式是运行容器时挂载宿主机的hosts文件：

• 用docker run命令：

  docker run -v /etc/hosts:/etc/hosts your-image-name
  

  这样容器内的/etc/hosts会和宿主机完全同步，宿主机修改hosts，容器里立刻生效。
  👉 小提示：如果担心容器修改hosts影响宿主机，可以先复制一份宿主机hosts到临时目录再挂载：

  cp /etc/hosts /tmp/container-hosts
  docker run -v /tmp/container-hosts:/etc/hosts your-image-name
  

• 用docker-compose的话，在docker-compose.yml里添加：

  services:
    your-service:
      # 其他配置...
      volumes:
        - /etc/hosts:/etc/hosts
  

场景2：构建镜像时注入当前宿主机的hosts（仅适合固定配置场景） #

如果你的镜像需要固定携带构建时宿主机的hosts（比如某些内部域名必须在镜像里提前配置），可以先把宿主机hosts复制到构建上下文，再在Dockerfile里COPY：

1. 执行构建前先复制hosts到当前目录：

   cp /etc/hosts ./temp-hosts
   

2. Dockerfile里添加：

   COPY temp-hosts /etc/hosts
   

3. 执行构建，完成后删掉临时文件：

   docker build -t your-image-name .
   rm ./temp-hosts
   

   👉 注意：这个方案构建出来的镜像hosts是固定的，换服务器运行时不会自动适配新服务器的hosts，所以只适合不需要跨环境通用的场景。

最佳实践总结 #

如果你要保证镜像能在所有服务器环境运行，优先选择「运行时挂载宿主机hosts」的方案——这样镜像本身不绑定任何特定环境的配置，到任意服务器运行时都会自动使用该服务器的hosts，完美符合你的需求。

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