使用Dockerfile构建Nginx镜像指南

基本Dockerfile示例

以下是一个简单的Dockerfile，用于构建一个基本的Nginx镜像：

# 使用官方Nginx基础镜像
FROM nginx:latest

# 维护者信息(可选)
LABEL maintainer="yourname@example.com"

# 删除默认的Nginx配置文件
RUN rm /etc/nginx/conf.d/default.conf

# 复制自定义配置文件
COPY nginx.conf /etc/nginx/conf.d/

# 复制网站内容
COPY ./html /usr/share/nginx/html

# 暴露80端口
EXPOSE 80

# 容器启动时运行Nginx
CMD ["nginx", "-g", "daemon off;"]

详细步骤说明

1. 准备项目结构：

   /your-project
   ├── Dockerfile
   ├── nginx.conf
   └── html/
      ├── index.html
      └── ...
   

2. 创建Nginx配置文件 (nginx.conf)：

   server {
      listen 80;
      server_name localhost;
   
      location / {
          root /usr/share/nginx/html;
          index index.html;
      }
   }
   

3. 构建镜像：

   docker build -t my-nginx .
   

4. 运行容器：

   docker run -d -p 8080:80 --name my-nginx-container my-nginx
   

高级用法

1. 使用特定版本的Nginx

FROM nginx:1.21.6-alpine

2. 多阶段构建（适用于需要编译的场景）

# 构建阶段
FROM node:14 as build
WORKDIR /app
COPY . .
RUN npm install && npm run build

# 生产阶段
FROM nginx:alpine
COPY --from=build /app/dist /usr/share/nginx/html
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

3. 添加环境变量

FROM nginx:alpine
ENV NGINX_PORT=80
COPY nginx.template /etc/nginx/conf.d/nginx.template
CMD /bin/sh -c "envsubst '\$NGINX_PORT' < /etc/nginx/conf.d/nginx.template > /etc/nginx/conf.d/default.conf && nginx -g 'daemon off;'"

4. 添加健康检查

HEALTHCHECK --interval=30s --timeout=3s \
  CMD curl -f http://localhost/ || exit 1

最佳实践

1. 使用轻量级基础镜像（如nginx:alpine）
2. 将不经常变化的指令放在Dockerfile前面以利用缓存
3. 使用.dockerignore文件排除不必要的文件
4. 为生产环境使用特定版本标签而非latest
5. 最小化镜像层数（合并相关RUN命令）

验证构建

构建完成后，可以通过以下命令验证：

docker images  # 查看构建的镜像
docker run -d -p 8080:80 my-nginx  # 运行测试
curl localhost:8080  # 测试访问

希望这个指南能帮助你成功构建Nginx镜像！如有其他问题，欢迎随时提问。