modules/nginx-proxy-pass

镜像概述

该镜像提供基于Nginx的反向代理基础配置，默认监听8080端口并转发请求到本地回环接口8000端口。用户可通过环境变量自定义各项参数，满足不同场景的反向代理需求。

核心功能

• 通过环境变量配置上游服务地址与端口
• 自定义Nginx监听端口、工作进程数及连接数
• 支持多虚拟主机配置
• 提供URL重写功能（基于指定主机名）
• 可配置Gzip压缩类型、请求超时时间等参数
• 日志输出到容器标准输出，便于监控

使用场景

1. Kubernetes Pod内作为前端代理，转发请求到后端应用服务
2. 多虚拟主机的反向代理场景
3. 需要对特定主机名进行URL重写的需求
4. 限制上传文件大小、请求超时等场景

配置说明

以下为支持的环境变量及默认值：

部署示例

Docker Run 示例

bash
docker run -d \
  -p 8080:8080 \
  -e NGINX_UPSTREAM_SERVER=127.0.0.1:8810 \
  -e NGINX_HOSTNAME=instal.com \
  -e NGINX_EXTRA_SERVER_NAMES=showcase.instal.com \
  -e NGINX_HOST_REWRITE_ENABLED=1 \
  -e NGINX_HOST_REWRITE_SERVER_NAMES=www.instal.com \
  modules/nginx-proxy-pass

Kubernetes Deployment 示例

yaml
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:
        - name: instal-showcase
          image: gcr.io/feisty-gasket-***/instal-showcase:latest
          ports:
            - name: gunicorn
              containerPort: 8810
          readinessProbe:
            httpGet:
              path: /_probe
              port: gunicorn
        - name: instal-showcase-nginx
          image: modules/nginx-proxy-pass
          ports:
            - name: nginx
              containerPort: 8080
          resources:
            requests:
              memory: "8Mi"
              cpu: "10m"
          readinessProbe:
            httpGet:
              path: /_probe
              port: nginx
          env:
            - 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: [***]