fritzduchardt/nginx-environment-configurator

nginx-environment-configurator

基于环境变量生成Nginx反向代理配置。

可在Kubernetes环境中作为https://kubernetes.io/docs/concepts/workloads/pods/init-containers/%E4%BD%BF%E7%94%A8%EF%BC%8C%E8%A6%86%E7%9B%96Nginx%E9%BB%98%E8%AE%A4%E9%85%8D%E7%BD%AE%EF%BC%8C**%E6%97%A0%E9%9C%80ConfigMap%E5%8D%B3%E5%8F%AF%E5%AE%8C%E6%88%90%E9%85%8D%E7%BD%AE%E6%B8%B2%E6%9F%93**%E3%80%82

Github仓库

https://github.com/fritzduchardt/nginx-environment-configurator

核心功能

容器将前缀为"LOCATION_"和"PROXYPASS_"的环境变量转换为对应Nginx反向代理配置。例如：

• LOCATION_1=/ + PROXYPASS_1=http://localhost:8080/ 生成默认路径代理配置
• 支持多组规则（后缀数字需一致）

使用场景

适用于Kubernetes环境中动态调整Nginx反向代理规则的场景，避免频繁更新ConfigMap的运维成本。

配置说明

1. 定义反向代理规则：通过LOCATION_<数字>指定路径，PROXYPASS_<数字>指定目标地址
2. 指定配置路径：通过NGINX_CONFIG_PATH设置生成的配置文件存放位置

Kubernetes部署示例

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: your-deployment-name
spec:
  replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/name: your-application-name
  template:
    metadata:
      labels:
        app.kubernetes.io/name: your-application-name
    spec:
      initContainers:
        - image: fritzduchardt/nginx-environment-configurator:latest
          name: nginx-config
          volumeMounts:
            - name: nginx-conf
              mountPath: "/work-dir"
          env:
            - name: NGINX_CONFIG_PATH
              value: "/work-dir/default.conf"
            - name: LOCATION_1
              value: "/"
            - name: PROXYPASS_1
              value: "http://localhost:8080/"
            - name: LOCATION_2
              value: "/swagger"
            - name: PROXYPASS_2
              value: "http://localhost:8081/"
      containers:
        - image: your-app-image:latest
          name: your-app
        - image: swaggerapi/swagger-ui:latest
          name: swagger
          ports:
            - containerPort: 8081
          env:
            - name: PORT
              value: "8081"
            - name: SWAGGER_JSON_URL
              value: "http://localhost:8080/v2/api-docs"
        - image: nginx:latest
          name: nginx
          volumeMounts:
            - mountPath: /etc/nginx/conf.d/
              name: nginx-conf
      volumes:
        - name: nginx-conf
          emptyDir: {}