webdevops/nginx

Nginx镜像

镜像概述和主要用途

本镜像为Nginx容器化部署方案，由https://build.webdevops.io/%E6%9E%84%E5%BB%BA%E5%B9%B6%E6%B5%8B%E8%AF%95%EF%BC%8C%E6%8F%90%E4%BE%9B%E9%AB%98%E6%80%A7%E8%83%BD%E7%9A%84Web%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%92%8C%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E8%83%BD%E5%8A%9B%E3%80%82%E9%80%82%E7%94%A8%E4%BA%8E%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E9%9D%99%E6%80%81%E8%B5%84%E6%BA%90%E6%9C%8D%E5%8A%A1%E3%80%81API%E6%8E%A5%E5%8F%A3%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E3%80%81%E8%B4%9F%E8%BD%BD%E5%9D%87%E8%A1%A1%E5%89%8D%E7%AB%AF%E8%8A%82%E7%82%B9%E7%AD%89%E5%9C%BA%E6%99%AF%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E6%88%96%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E8%87%AA%E5%AE%9A%E4%B9%89%E6%9C%8D%E5%8A%A1%E5%8F%82%E6%95%B0%E3%80%82

核心功能和特性

• 高性能Web服务：支持HTTP/HTTPS协议，优化静态文件传输性能
• 反向代理与负载均衡：可配置后端服务代理及简单负载均衡策略
• 灵活配置：支持环境变量注入基础配置，或通过卷挂载自定义Nginx配置文件
• 稳定性保障：由WebDevOps构建系统持续集成测试，确保镜像兼容性和稳定性
• 轻量级设计：基于精简基础镜像，减少资源占用

使用场景和适用范围

• 静态网站部署（HTML、CSS、JavaScript、图片等资源）
• API服务反向代理（对接后端微服务或独立API接口）
• 负载均衡前端节点（分发请求至多个后端实例）
• 开发/测试环境Web服务器模拟
• 微服务架构中的边缘网关

使用方法和配置说明

基本部署（docker run）

bash
# 启动基础Nginx服务，映射80端口
docker run -d -p 80:80 --name nginx-web docker.xuanyuan.run/webdevops/nginx

挂载自定义配置文件

bash
# 将本地配置文件挂载至容器配置目录（推荐）
docker run -d -p 80:80 \
  -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf \
  -v $(pwd)/conf.d:/etc/nginx/conf.d \
  --name nginx-custom docker.xuanyuan.run/webdevops/nginx

docker-compose配置示例

yaml
version: '3'
services:
  nginx:
    image: docker.xuanyuan.run/webdevops/nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./conf.d:/etc/nginx/conf.d  # 挂载站点配置
      - ./static:/usr/share/nginx/html  # 挂载静态资源
    environment:
      - NGINX_HOST=example.com  # 默认主机名
      - NGINX_PORT=80  # 默认监听端口
    restart: always

配置说明

• 环境变量：支持通过环境变量设置基础参数（如NGINX_HOST默认主机名、NGINX_PORT监听端口等），具体变量列表见http://dockerfile.readthedocs.io/en/latest/content/DockerImages/dockerfiles/nginx.html
• 配置文件路径：主配置文件位于/etc/nginx/nginx.conf，站点配置推荐放在/etc/nginx/conf.d/目录（支持.conf后缀文件自动加载）
• 日志输出：访问日志和错误日志默认输出至容器标准输出，可通过docker logs <容器名>查看

文档和支持

• 详细文档：包含标签说明、环境变量列表等完整配置指南，参见http://dockerfile.readthedocs.io/en/latest/content/DockerImages/dockerfiles/nginx.html
• 社区支持：通过https://webdevops.io/slack/%E8%8E%B7%E5%8F%96%E6%8A%80%E6%9C%AF%E6%94%AF%E6%8C%81%E5%92%8C%E9%95%9C%E5%83%8F%E6%9B%B4%E6%96%B0%E4%BF%A1%E6%81%AF