配置Nginx基础镜像Dockerfile时的页面访问与健康检查问题

问题现象 #

• Docker镜像构建成功，但容器启动后状态持续显示health: starting
• 执行curl http://localhost:8093返回curl: (52) Empty reply from server
• 容器日志报错：directory index of '/usr/share/nginx/html/' is forbidden，但本地目录确实存在index.html文件

核心问题分析 #

1. Node构建阶段未生成可被Nginx解析的静态HTML：当前Dockerfile仅复制了Node应用的index.js到Nginx目录，未执行构建步骤生成最终的静态index.html
2. 端口映射完全不匹配：运行命令将主机8093端口映射到容器8080端口，但Nginx监听的是80端口，Node应用监听的是8084端口，端口逻辑混乱
3. 自定义Nginx配置未生效：用户编写的nginx.conf未复制到容器中，Nginx使用默认配置，无法正确识别索引文件
4. 健康检查逻辑不合理：当前健康检查访问Nginx的根路径，若文件或配置异常则直接失败，不如使用独立的健康检查端点可靠

分步修复方案 #

1. 完善Node构建阶段，生成静态HTML文件 #

修改第一阶段Dockerfile，添加脚本将HTML模板替换变量，生成最终可直接用Nginx部署的index.html：

# Stage 1: Build Stage
FROM node:alpine AS builder

RUN apk add --update curl && \
    rm -rf /var/cache/apk/*

WORKDIR /usr/app

COPY ./package.json ./
RUN npm install

# 复制Node代码和HTML模板文件
COPY ./index.js ./
COPY ./index.html ./template.html

# 执行脚本，替换模板变量并生成最终index.html
RUN node -e "
const fs = require('fs');
const os = require('os');
const version = process.env.VERSION || 'production.v1.0';

function getIPAddress() {
  const interfaces = os.networkInterfaces();
  for (const dev in interfaces) {
    const iface = interfaces[dev].filter(details => details.family === 'IPv4' && !details.internal);
    if (iface.length > 0) return iface[0].address;
  }
  return '0.0.0.0';
}

let template = fs.readFileSync('./template.html', 'utf8');
template = template.replace('[SERVER_IP_ADDRESS]', getIPAddress())
                   .replace('[SERVER_HOSTNAME]', os.hostname())
                   .replace('[APP_VERSION]', version);
fs.writeFileSync('./index.html', template);
"

2. 修正Dockerfile运行阶段配置 #

• 复制生成的静态index.html到Nginx目录
• 复制自定义nginx.conf到Nginx配置路径，覆盖默认配置
• 调整健康检查为使用独立端点

# Stage 2: Runtime Stage
FROM nginx:latest

# 清理默认Nginx站点文件
RUN rm -rf /usr/share/nginx/html/*
# 复制自定义Nginx配置
COPY ./nginx.conf /etc/nginx/conf.d/default.conf

# 从构建阶段复制生成好的index.html
COPY --from=builder /usr/app/index.html /usr/share/nginx/html/

WORKDIR /usr/share/nginx/html

# 暴露Nginx实际监听的80端口
EXPOSE 80

ARG VERSION
ENV VERSION=production.${VERSION:-v1.0}

# 使用配置中定义的/healthcheck端点做健康检查，更稳定
HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
  CMD curl -f http://localhost:80/healthcheck || exit 1

CMD ["nginx", "-g", "daemon off;"]

3. 修正容器运行命令 #

将端口映射改为主机8093对应容器的80端口（Nginx监听端口）：

docker run -d -p 8093:80 --name web13 local/base:v10

4. 验证修复效果 #

• 查看容器健康状态：docker inspect web13 | grep HealthStatus，应显示healthy
• 访问服务：curl http://localhost:8093，应返回填充了服务器IP、主机名和版本信息的HTML内容
• 查看容器日志：docker logs web13，无报错信息

内容的提问来源于stack exchange，提问作者Miłosz