Docker构建阶段自定义/etc/hosts文件遇权限及存在性问题求助

1. 用Docker BuildKit的--add-host参数（最优方案） #

Docker BuildKit支持在构建阶段直接注入host映射，完全绕过/etc/hosts的读写限制，且不需要修改镜像内容。

• 启用BuildKit构建：
  执行构建命令前设置环境变量：

  COMPOSE_DOCKER_CLI_BUILD=1 DOCKER_BUILDKIT=1 docker-compose build
  

  你的环境（Docker 20.10.18+Compose 2.11.2）原生支持BuildKit，无需额外安装。

• 传递host映射参数：
  直接在构建命令中添加--add-host：

  COMPOSE_DOCKER_CLI_BUILD=1 DOCKER_BUILDKIT=1 docker-compose build --build-arg ADD_HOST="example.com:192.168.1.100"
  

  或者在Dockerfile中结合RUN的--add-host选项：

  RUN --add-host=example.com:192.168.1.100 \
      curl example.com # 这里执行依赖host映射的构建步骤
  

2. 临时挂载tmpfs修改/etc/hosts #

如果无法使用BuildKit，可通过在构建阶段临时挂载tmpfs到/etc目录，绕过只读限制：

FROM your-base-image

# 提前准备好包含额外条目的hosts文件（放在构建上下文目录）
COPY custom-hosts /tmp/custom-hosts

# 挂载tmpfs到/etc，临时写入自定义hosts并执行构建步骤
RUN --mount=type=tmpfs,target=/etc \
    cat /tmp/custom-hosts > /etc/hosts \
    && npm install # 示例：执行需要host解析的构建操作

说明：tmpfs是临时文件系统，仅在当前RUN步骤生效，构建完成后不会留在最终镜像中；若后续步骤也需host映射，需重复该挂载逻辑。

3. 更换或调整基础镜像 #

如果基础镜像的根文件系统是只读（如distroless类镜像），优先考虑更换为常规可写镜像（如alpine:latest、ubuntu:jammy），这类镜像默认允许修改/etc/hosts。

若必须使用只读基础镜像，可通过多阶段构建在可写镜像中完成依赖host的步骤，再复制产物到目标镜像：

# 第一阶段：使用可写镜像完成需要host解析的构建
FROM alpine:latest AS builder
COPY custom-hosts /etc/hosts
RUN curl example.com > /tmp/build-output

# 第二阶段：复制产物到只读基础镜像
FROM gcr.io/distroless/static-debian11
COPY --from=builder /tmp/build-output /app/

4. 纠正挂载配置误区 #

构建阶段无法使用docker-compose.yml中的volumes挂载hosts文件，因为该配置仅在容器启动时生效。构建阶段的文件注入只能通过COPY指令或BuildKit参数实现。

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