wodanio/nginx-reverse-proxy

Nginx反向代理

镜像概述和主要用途

本项目提供一个基于Nginx的简单、灵活且可动态配置的反向代理解决方案。它允许将HTTP请求转发到各种后端服务器，这些服务器通过环境变量进行定义，无需手动修改Nginx配置文件。

核心功能和特性

• 动态配置：通过环境变量直接定义代理规则，无需编辑配置文件
• 多后端支持：支持单后端服务器（通过PROXY_<n>_PASS）或多后端服务器列表（通过PROXY_<n>_UPSTREAM）
• 协议灵活性：可配置后端服务器使用HTTP或HTTPS协议（通过PROXY_<n>_UPSTREAM_HTTPS控制）
• 请求头自定义：支持设置是否传递请求头信息（通过PROXY_<n>_SET_HEADER控制）

使用场景和适用范围

• 多域名请求转发：将不同域名的请求分发到对应的后端服务
• 简单负载均衡：通过多后端服务器列表实现请求的自动分发
• 快速部署需求：无需手动编写Nginx配置，通过环境变量快速搭建反向代理
• 开发/测试环境：适用于需要临时或快速配置代理的开发、测试场景

使用方法和配置说明

环境变量参数说明

使用示例

方法一：单后端服务器配置

bash
docker run -d -p 80:80 \
  -e PROXY_0_HOST=example.com \
  -e PROXY_0_PASS=http://backend1.local \
  -e PROXY_1_HOST=another-example.com \
  -e PROXY_1_PASS=http://backend2.local \
  wodanio/nginx-reverse-proxy:latest

说明：将example.com的请求转发到http://backend1.local，another-example.com的请求转发到http://backend2.local。

方法二：多后端服务器及高级配置

bash
docker run -d -p 80:80 \
  -e PROXY_0_HOST=example.com \
  -e PROXY_0_SET_HEADER=true \
  -e PROXY_0_UPSTREAM=backend1.local,backend2.local,backend3.local \
  -e PROXY_1_HOST=another-example.com \
  -e PROXY_1_UPSTREAM_HTTPS=true \
  -e PROXY_1_UPSTREAM=backend1.local,backend2.local \
  wodanio/nginx-reverse-proxy:latest

说明：

• example.com：传递请求头，请求转发到backend1.local、backend2.local、backend3.local（HTTP协议）
• another-example.com：请求转发到backend1.local、backend2.local（HTTPS协议）