voxweb/nginx

popso后端专用Nginx镜像

镜像概述和主要用途

本镜像为popso后端系统专门设计，基于官方Nginx稳定版构建，针对popso后端服务的网络请求处理特性进行优化。主要用于接收客户端HTTP/HTTPS请求，通过反向代理转发至popso后端服务实例，同时提供静态资源（如JS、CSS、图片等）访问服务，是popso后端系统的关键网络层组件。

核心功能和特性

• popso后端适配性：内置针对popso后端服务的默认Nginx配置，减少部署时的配置工作量
• 反向代理：支持将客户端请求动态转发至一个或多个popso后端服务实例，处理请求路由
• 静态资源服务：优化静态文件处理性能，支持popso后端所需的各类静态资源（JS、CSS、图片等）的高效访问
• 灵活配置：支持通过环境变量或挂载配置文件自定义Nginx配置，适配不同部署场景
• 负载均衡：可选配置实现popso后端多实例的请求负载均衡，提升系统可用性
• SSL/TLS支持：可配置HTTPS加密通信，保障数据传输安全
• 轻量高效：基于官方Nginx精简版构建，镜像体积小，启动速度快

使用场景和适用范围

• popso后端服务的生产环境HTTP/HTTPS请求处理与转发
• 开发/测试环境中模拟popso后端的网络请求流程
• 需要静态资源服务与反向代理功能的popso相关应用部署
• 多实例popso后端服务的负载均衡场景

详细使用方法和配置说明

基本使用（docker run）

通过以下命令快速启动容器，使用默认配置连接popso后端服务：

bash
docker run -d --name popso-nginx -p 80:80 docker.xuanyuan.run/popso/nginx-backend

注：默认配置下，Nginx会将请求转发至localhost:8080的popso后端服务，若后端服务地址不同，需通过环境变量或配置文件调整。

Docker Compose配置示例

在popso后端服务部署中，推荐使用docker-compose管理服务依赖：

yaml
version: '3.8'
services:
  nginx:
    image: docker.xuanyuan.run/popso/nginx-backend
    ports:
      - "80:80"       # HTTP端口
      - "443:443"     # 若启用HTTPS需开放此端口
    environment:
      - POPSO_BACKEND_HOST=popso-api  # popso后端服务容器名/IP
      - POPSO_BACKEND_PORT=8080       # popso后端服务端口
      - ENABLE_STATIC=true            # 是否启用静态资源服务（默认true）
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d  # 挂载自定义配置文件（可选）
      - ./static:/usr/share/nginx/html    # 挂载静态资源目录（可选）
    depends_on:
      - popso-api

  popso-api:
    image: docker.xuanyuan.run/popso/backend-service  # popso后端服务镜像
    # 后端服务配置...

配置参数说明

环境变量

通过环境变量调整基础配置，无需修改Nginx配置文件：

挂载配置文件

如需深度自定义Nginx配置（如负载均衡、SSL配置等），可将自定义配置文件挂载至容器内的Nginx配置目录：

bash
# 挂载自定义配置文件示例（覆盖默认配置）
docker run -d --name popso-nginx \
  -p 80:80 \
  -v /path/to/your/nginx.conf:/etc/nginx/nginx.conf \
  -v /path/to/your/conf.d:/etc/nginx/conf.d \
  docker.xuanyuan.run/popso/nginx-backend

自定义后端服务路由示例

若需配置多路径路由（如区分API请求与静态资源请求），可创建自定义Nginx配置文件（如popso-nginx.conf）：

nginx
server {
    listen 80;
    server_name localhost;

    # API请求转发至popso后端服务
    location /api/ {
        proxy_pass http://${POPSO_BACKEND_HOST}:${POPSO_BACKEND_PORT}/api/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    # 静态资源请求处理
    location /static/ {
        root ${STATIC_ROOT};
        expires 1d;  # 配置缓存策略
    }
}

通过挂载该配置文件启动容器：

bash
docker run -d --name popso-nginx \
  -p 80:80 \
  -e POPSO_BACKEND_HOST=popso-api \
  -e POPSO_BACKEND_PORT=8080 \
  -v $(pwd)/popso-nginx.conf:/etc/nginx/conf.d/default.conf \
  docker.xuanyuan.run/popso/nginx-backend

SSL/TLS配置示例

启用HTTPS需准备SSL证书（如cert.pem和key.pem），并创建包含SSL配置的Nginx配置文件：

nginx
server {
    listen 443 ssl;
    server_name popso-backend.example.com;

    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;

    # 其他SSL配置（如协议版本、加密套件等）
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    # 请求转发配置
    location / {
        proxy_pass http://${POPSO_BACKEND_HOST}:${POPSO_BACKEND_PORT};
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

启动容器时挂载证书文件和配置文件：

bash
docker run -d --name popso-nginx \
  -p 443:443 \
  -e POPSO_BACKEND_HOST=popso-api \
  -e POPSO_BACKEND_PORT=8080 \
  -v $(pwd)/ssl:/etc/nginx/ssl \
  -v $(pwd)/popso-ssl.conf:/etc/nginx/conf.d/default.conf \
  popso/nginx-backend