Nginx简单代理镜像文档

镜像概述与主要用途

本镜像基于Nginx Alpine构建，集成了常用Nginx模块，提供轻量级的流量代理功能。主要用于将流量代理到指定的上游服务端点，支持TCP/UDP流模式和HTTP模式，通过环境变量即可快速配置，无需复杂的手动配置文件编写。

核心功能与特性

• 轻量级基础：基于Nginx Alpine镜像，体积小、资源占用低
• 常用模块集成：已预编译常用Nginx模块，满足基础代理需求
• 灵活代理模式：支持stream（TCP/UDP流量）和http（HTTP流量）两种代理模式
• 环境变量配置：通过环境变量即可定义上游服务、端口和代理模式，配置简单
• 可扩展配置：支持根据需求自定义Nginx工作进程数等高级配置参数

使用场景与适用范围

适用于需要快速搭建轻量级代理服务的场景，例如：

• 数据库服务（如MySQL、PostgreSQL）的TCP流量代理
• 简单HTTP服务的请求转发
• 开发/测试环境中的临时流量路由
• 需要隔离或转发特定端口流量的场景

使用方法与配置说明

环境变量配置

通过以下环境变量进行基础配置：

Docker部署示例

基本部署命令（stream模式）

bash
docker run -d \
  -e UPSTREAM_HOST=target-service.example.com \
  -e PORT=8080 \
  -e NGINX_PROXY_MODE=stream \
  --name nginx-proxy \
  your-image-name:latest

HTTP模式部署示例

bash
docker run -d \
  -e UPSTREAM_HOST=web-service.example.com \
  -e PORT=80 \
  -e NGINX_PROXY_MODE=http \
  -p 80:80 \
  --name nginx-http-proxy \
  your-image-name:latest

高级配置

可根据实际需求调整Nginx工作进程数等高级参数，具体配置方法可参考Nginx***文档，通过自定义配置文件或额外环境变量实现。