EclipseFdn Nginx Docker镜像文档

镜像概述

EclipseFdn Nginx Docker镜像是由Eclipse Foundation维护的官方Nginx容器化解决方案，基于Nginx官方镜像构建，提供稳定、高性能的Web服务器环境。该镜像适用于快速部署HTTP服务、实现反向代理、负载均衡及静态资源托管，满足各类Web应用的基础服务需求。

核心功能与特性

• 高性能HTTP服务：支持HTTP/1.1、HTTP/2协议，提供高效的静态资源传输能力
• 反向代理：可作为应用服务器前端代理，转发请求至后端服务（如Tomcat、Node.js等）
• 负载均衡：内置负载均衡模块，支持轮询、IP哈希、最少连接等策略，分发请求至多个后端节点
• SSL/TLS终端：支持SSL证书配置，实现HTTPS加密传输，保障数据传输安全
• 灵活配置：支持自定义Nginx配置文件，可通过挂载方式注入个性化配置
• 轻量级设计：基于Alpine或Debian基础镜像（具体取决于版本），镜像体积小，启动速度快

使用场景与适用范围

• 静态网站托管：部署静态HTML、CSS、JavaScript等资源，提供高效访问服务
• API网关：作为前端请求入口，路由API请求至不同后端微服务
• 负载均衡器：为多实例应用提供请求分发，提高系统可用性与并发处理能力
• Web应用前端代理：处理静态资源请求，转发动态请求至应用服务器，减轻后端负载
• SSL终端：集中管理SSL证书，简化后端服务的HTTPS配置

使用方法与配置说明

基本使用（docker run）

通过以下命令快速启动Nginx服务，映射80端口至主机：

docker run -d --name eclipse-nginx -p 80:80 eclipsefdn/nginx:latest

访问http://localhost即可看到Nginx默认欢迎页面。

自定义配置

Nginx的核心配置通过nginx.conf文件管理，推荐通过挂载主机目录或配置文件的方式自定义配置：

1. 挂载自定义配置文件：

将主机上的nginx.conf挂载至容器内的/etc/nginx/nginx.conf：

docker run -d --name eclipse-nginx -p 80:80 -v /path/to/your/nginx.conf:/etc/nginx/nginx.conf eclipsefdn/nginx:latest

2. 挂载配置目录：

若需添加多个站点配置，可挂载conf.d目录（存放各站点.conf文件）：

docker run -d --name eclipse-nginx -p 80:80 -v /path/to/your/conf.d:/etc/nginx/conf.d eclipsefdn/nginx:latest

静态资源托管

挂载主机静态资源目录至容器内Nginx的默认网站根目录（通常为/usr/share/nginx/html）：

docker run -d --name eclipse-nginx -p 80:80 -v /path/to/your/static/files:/usr/share/nginx/html eclipsefdn/nginx:latest

反向代理示例

创建conf.d/proxy.conf配置文件，实现反向代理至后端服务（如[***]）：

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass [***]
        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;
    }
}

启动容器时挂载该配置文件目录，并通过网络连接后端服务：

docker run -d --name eclipse-nginx -p 80:80 -v /path/to/your/conf.d:/etc/nginx/conf.d --link backend:backend eclipsefdn/nginx:latest

Docker Compose示例

version: '3'

services:
  nginx:
    image: eclipsefdn/nginx:latest
    ports:
      - "80:80"
      - "443:443"  # 启用HTTPS时
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d
      - ./nginx/ssl:/etc/nginx/ssl  # SSL证书目录
      - ./static:/usr/share/nginx/html
    depends_on:
      - backend
    restart: always

  backend:
    image: node:18-alpine
    command: node /app/server.js
    volumes:
      - ./backend:/app
    restart: always

环境变量与动态配置

该镜像通过配置文件实现所有功能，无默认环境变量。如需动态调整，可结合envsubst生成配置：

1. 创建模板文件nginx.conf.template：

server {
    listen ${NGINX_PORT:-80};
    server_name ${SERVER_NAME:-localhost};
}

2. 启动时生成配置：

docker run -d --name eclipse-nginx -p 80:80 -e NGINX_PORT=80 -e SERVER_NAME=example.com -v /path/to/nginx.conf.template:/etc/nginx/nginx.conf.template eclipsefdn/nginx:latest sh -c "envsubst < /etc/nginx/nginx.conf.template > /etc/nginx/nginx.conf && nginx -g 'daemon off;'"

注意事项

• 镜像标签：建议使用具体版本（如1.25.3）而非latest，确保一致性
• 配置验证：启动前通过nginx -t验证配置文件正确性
• 日志管理：默认日志输出至stdout，可挂载目录持久化存储日志
• 安全加固：生产环境启用SSL/TLS，限制HTTP方法，配置安全响应头