bamx/nginx

镜像概述

本镜像是基于官方Nginx镜像（https://hub.docker.com/_/nginx/%EF%BC%89%E6%9E%84%E5%BB%BA%E7%9A%84%E8%A1%8D%E7%94%9F%E9%95%9C%E5%83%8F%EF%BC%8C%E7%BB%A7%E6%89%BF%E4%BA%86%E5%AE%98%E6%96%B9Nginx%E7%9A%84%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E4%B8%8E%E7%89%B9%E6%80%A7%E3%80%82%E4%BD%9C%E4%B8%BA%E9%AB%98%E6%80%A7%E8%83%BD%E7%9A%84HTTP%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%92%8C%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E5%85%B6%E4%B8%BB%E8%A6%81%E7%94%A8%E9%80%94%E5%8C%85%E6%8B%AC%E6%8F%90%E4%BE%9BWeb%E6%9C%8D%E5%8A%A1%E3%80%81%E5%AE%9E%E7%8E%B0%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%E3%80%81SSL%E7%BB%88%E7%AB%AF%E5%8F%8A%E9%9D%99%E6%80%81%E8%B5%84%E6%BA%90%E6%89%98%E7%AE%A1%E7%AD%89%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%90%84%E7%B1%BBWeb%E5%BA%94%E7%94%A8%E9%83%A8%E7%BD%B2%E5%9C%BA%E6%99%AF%E3%80%82

核心功能与特性

功能继承

• 完整继承官方Nginx的全部核心功能，包括HTTP/HTTPS协议支持、虚拟主机配置、URL重写、Gzip压缩、SSL/TLS加密解密等
• 支持FastCGI、uWSGI、SCGI等协议的反向代理，可对接PHP、Python等后端应用

性能与稳定性

• 保持官方Nginx的轻量级特性，镜像体积小，资源占用低
• 基于Nginx成熟的事件驱动架构，支持高并发连接，性能稳定可靠

灵活性与可扩展性

• 支持通过挂载外部配置文件自定义Nginx行为，满足个性化需求
• 可通过Docker Volume挂载静态资源、日志文件等，实现数据持久化
• 支持与其他容器服务联动，作为微服务架构中的API网关或流量入口

安全性与维护性

• 持续同步官方Nginx镜像的更新，及时修复安全漏洞
• 遵循Docker最佳实践，减少镜像***面，运行环境安全可控

使用场景与适用范围

静态网站部署

适用于托管HTML、CSS、JavaScript、图片等静态资源，可直接作为静态网站服务器使用。

反向代理服务

可将客户端请求转发至后端应用服务器（如Node.js、Java、Python服务等），实现请求路由与负载均衡。

API网关

在微服务架构中，作为统一入口处理API请求，实现请求过滤、认证授权、限流等功能。

SSL终端

集中处理HTTPS加密解密，减轻后端服务的SSL处理压力，简化证书管理。

负载均衡

通过Nginx的upstream模块，将请求分发至多个后端节点，提高服务可用性与并发处理能力。

使用方法与配置说明

基本运行

通过以下命令可快速启动容器，默认监听80端口并提供Nginx默认欢迎页面：

bash
docker run -d -p 80:80 --name my-nginx docker.xuanyuan.run/vendored-nginx-image

部署静态网站

将本地静态网站文件目录挂载至容器内的/usr/share/nginx/html目录，即可部署自定义静态网站：

bash
docker run -d -p 80:80 -v /path/to/local/html:/usr/share/nginx/html --name my-static-site docker.xuanyuan.run/vendored-nginx-image

挂载自定义配置

Nginx的主配置文件路径为/etc/nginx/nginx.conf，默认站点配置位于/etc/nginx/conf.d/default.conf。通过-v参数挂载自定义配置文件可覆盖默认配置：

bash
# 挂载自定义主配置文件
docker run -d -p 80:80 -v /path/to/nginx.conf:/etc/nginx/nginx.conf --name my-nginx docker.xuanyuan.run/vendored-nginx-image

# 挂载自定义站点配置
docker run -d -p 80:80 -v /path/to/conf.d:/etc/nginx/conf.d --name my-nginx docker.xuanyuan.run/vendored-nginx-image

Docker Compose示例

以下为使用Docker Compose部署静态网站的配置示例（docker-compose.yml）：

yaml
version: '3'
services:
  nginx:
    image: docker.xuanyuan.run/vendored-nginx-image
    ports:
      - "80:80"
      - "443:443"  # 如需HTTPS，开放443端口
    volumes:
      - ./html:/usr/share/nginx/html  # 静态网站文件
      - ./conf.d:/etc/nginx/conf.d    # 自定义站点配置
      - ./ssl:/etc/nginx/ssl          # SSL证书文件（如需HTTPS）
      - ./logs:/var/log/nginx         # 日志持久化
    restart: always

核心配置说明

主要配置文件路径

• 主配置文件：/etc/nginx/nginx.conf（全局配置）
• 站点配置目录：/etc/nginx/conf.d/（推荐将站点配置文件放在此目录，以.conf为后缀）
• 默认网站根目录：/usr/share/nginx/html
• 日志目录：/var/log/nginx/（包含access.log和error.log）

自定义站点配置示例

创建./conf.d/my-site.conf文件，配置一个静态网站服务：

nginx
server {
    listen 80;
    server_name example.com;  # 替换为实际域名

    root /usr/share/nginx/html;
    index index.html index.htm;

    # 日志配置
    access_log /var/log/nginx/example.access.log;
    error_log /var/log/nginx/example.error.log;

    # 静态资源缓存配置
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 30d;
        add_header Cache-Control "public, max-age=2592000";
    }
}

通过Docker Compose启动后，访问http://example.com即可访问自定义静态网站。

反向代理配置示例

在./conf.d/proxy.conf中配置反向代理至后端API服务：

nginx
server {
    listen 80;
    server_name api.example.com;

    location / {
        proxy_pass http://backend-service:3000;  # 后端服务地址（Docker网络内可使用服务名）
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

环境变量支持

本镜像继承官方Nginx镜像的环境变量特性，可通过环境变量动态配置部分参数，常用变量包括：

• NGINX_HOST：默认服务器名，需配合自定义配置模板使用
• NGINX_PORT：默认监听端口，需配合自定义配置模板使用

如需使用环境变量动态生成配置，可参考官方Nginx镜像文档中的配置模板方案。