nginx-proxy-pass-dockerize 镜像文档

1. 镜像概述

nginx-proxy-pass-dockerize是一个基于Nginx的轻量级反向代理镜像，旨在通过环境变量简化反向代理配置流程。无需手动编写Nginx配置文件，即可动态调整上游服务器地址、监听端口、虚拟主机、连接策略等核心参数。默认配置下，Nginx监听8080端口，并将请求代理至本地8000端口（127.0.0.1:8000），适用于Docker、Kubernetes等容器化环境中的服务请求转发场景。

2. 核心功能与特性

• 环境变量驱动配置：所有Nginx核心参数通过环境变量动态注入，无需手动修改配置文件
• 灵活的上游服务器配置：支持自定义上游服务器地址（IP:端口或域名）及连接保持（keepalive）策略
• 多虚拟主机支持：通过环境变量配置主域名及额外虚拟主机名，实现多域名代理
• 请求限制控制：可配置客户端请求体大小、超时时间，限制上传文件大小
• 日志标准化输出：默认将访问日志输出至容器标准输出，便于日志收集与分析
• 主机重写功能：支持将指定主机名的请求重写到目标主机名，实现域名跳转

3. 使用场景与适用范围

• Kubernetes Pod内代理：与应用容器部署在同一Pod中，作为前端代理（如示例中与gunicorn应用配合）
• 独立代理服务：作为独立服务部署，代理后端多个应用服务（需配置上游服务器DNS名称）
• 动态配置场景：需要频繁调整代理目标、端口或虚拟主机的开发/测试环境
• 微服务架构：作为服务网关，转发请求至不同微服务实例

4. 使用方法与配置示例

4.1 Docker 快速启动

使用默认配置启动（监听8080端口，代理至127.0.0.1:8000）：

docker run -d -p 8080:8080 instal/nginx-proxy-pass-dockerize:1.2

自定义上游服务器（例如代理至192.168.1.100:8080）：

docker run -d -p 8080:8080 \
  -e NGINX_UPSTREAM_SERVER=192.168.1.100:8080 \
  instal/nginx-proxy-pass-dockerize:1.2

4.2 Kubernetes 部署示例

以下是在Kubernetes中部署的示例（包含应用容器与代理容器）：

apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: instal-showcase-deployment
  namespace: instal-dashboard
spec:
  replicas: 3
  revisionHistoryLimit: 3
  template:
    metadata:
      labels:
        app: instal-showcase
    spec:
      containers:
        # 应用容器（示例为gunicorn服务）
        - name: instal-showcase
          image: gcr.io/feisty-gasket-***/instal-showcase:latest
          ports:
            - name: gunicorn
              containerPort: 8810
          readinessProbe:
            httpGet:
              path: /_probe
              port: gunicorn
        
        # nginx-proxy-pass容器
        - name: instal-showcase-nginx
          image: instal/nginx-proxy-pass-dockerize:1.2
          ports:
            - name: nginx
              containerPort: 8080
          resources:
            requests:
              memory: "8Mi"
              cpu: "10m"
          readinessProbe:
            httpGet:
              path: /_probe
              port: nginx
          env:
            # 上游服务器（同一Pod内的应用容器地址）
            - name: NGINX_UPSTREAM_SERVER
              value: '127.0.0.1:8810'
            # 主域名
            - name: NGINX_HOSTNAME
              value: instal.com
            # 额外虚拟主机
            - name: NGINX_EXTRA_SERVER_NAMES
              value: 'showcase.instal.com'
            # 禁用上游连接保持
            - name: NGINX_UPSTREAM_KEEPALIVE
              value: '0'
            # 启用主机重写
            - name: NGINX_HOST_REWRITE_ENABLED
              value: '1'
            # 需重写的主机名
            - name: NGINX_HOST_REWRITE_SERVER_NAMES
              value: [***]

5. 环境变量详细说明

灵感来源：[**]