Docker构建阶段修改/etc/hosts报错，如何完成nginx.conf配置合法性校验

Docker 构建阶段默认将 /etc/hosts 挂载为只读文件系统，因此直接修改该文件的方案不可行，可参考以下三种稳定方案完成 Nginx 配置校验：

方案1：使用Docker Build原生参数（最简单，优先推荐） #

无需修改Dockerfile，仅需要在执行构建命令时添加--add-host参数，即可直接向构建阶段的/etc/hosts文件注入需要的解析记录：

# 单个域名
docker build --add-host rest-service:127.0.0.1 -t nginx-proxy .

# 多个域名可多次指定参数
docker build \
  --add-host rest-service:127.0.0.1 \
  --add-host admin-service:127.0.0.1 \
  -t nginx-proxy .

该方案无需修改镜像内部逻辑，也不会引入额外依赖，仅需调整构建命令即可。

方案2：使用高版本Nginx原生测试参数 #

如果无法修改构建命令，且使用的Nginx版本≥1.19.3，可以直接使用Nginx自带的--hosts测试参数指定自定义hosts文件，不需要修改系统hosts：

# 生成临时测试用hosts文件
RUN cat > /tmp/test_hosts << EOF
127.0.0.1 localhost rest-service
EOF

# 指定自定义hosts文件执行配置校验
RUN nginx -t --hosts /tmp/test_hosts

# 测试完成后清理临时文件
RUN rm -f /tmp/test_hosts

方案3：使用nss_wrapper兼容低版本Nginx #

如果使用的Nginx版本低于1.19.3，无法使用原生--hosts参数，可以通过轻量工具nss_wrapper实现自定义hosts注入：

Debian/Ubuntu基础镜像示例： #

# 安装依赖
RUN apt update && apt install -y --no-install-recommends libnss-wrapper

# 生成临时hosts文件
RUN echo "127.0.0.1 rest-service" > /tmp/hosts

# 注入自定义hosts执行配置测试
RUN LD_PRELOAD=libnss_wrapper.so NSS_WRAPPER_HOSTS=/tmp/hosts nginx -t

# 清理依赖和临时文件，减小镜像体积
RUN apt purge -y libnss-wrapper && apt autoremove -y && rm -rf /var/lib/apt/lists/* /tmp/hosts

Alpine基础镜像示例： #

# 安装依赖
RUN apk add --no-cache nss-wrapper

# 生成临时hosts文件
RUN echo "127.0.0.1 rest-service" > /tmp/hosts

# 注入自定义hosts执行配置测试
RUN LD_PRELOAD=libnss_wrapper.so NSS_WRAPPER_HOSTS=/tmp/hosts nginx -t

# 清理依赖和临时文件
RUN apk del nss-wrapper && rm -f /tmp/hosts

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