nginx-proxy (多端口分支) 镜像文档

镜像概述和主要用途

本镜像为 nginxproxy/nginx-proxy 的分支版本，是一款用于Docker环境的自动Nginx反向代理工具。其核心功能是为运行中的Docker容器自动配置Nginx反向代理规则，并扩展支持为每个虚拟主机（域名）配置多个服务端口，解决了原版仅支持单端口的限制。

核心功能和特性

• 多端口虚拟主机：支持为单个虚拟主机（通过VIRTUAL_HOST指定）配置多个服务端口，满足多服务共存需求
• 自动配置Nginx：监听Docker事件，自动生成和更新Nginx配置文件，无需手动修改
• Docker原生集成：通过Docker环境变量和标签实现配置，与Docker容器生命周期同步
• 继承原版功能：保留nginxproxy/nginx-proxy的全部特性，包括HTTPS支持、自定义Nginx配置、网络隔离等
• 轻量级扩展：在原代码基础上最小化修改，保持兼容性和稳定性

使用场景和适用范围

• 需要为单个域名/虚拟主机暴露多个服务端口的Docker部署环境
• 多服务共存场景：如同一域名下同时提供Web服务（80/443）、API服务（3000）、WebSocket服务（8080）等
• 简化多端口反向代理配置的开发/测试环境
• 需动态调整服务端口的容器化应用架构

使用方法和配置说明

基本运行方式

与原版nginx-proxy类似，通过挂载Docker套接字实现配置自动生成：

bash
docker run -d \
  --name nginx-proxy \
  -p 80:80 \
  -p 443:443 \
  -v /var/run/docker.sock:/tmp/docker.sock:ro \
  pini-gh/nginx-proxy:pini

多端口配置方法

为容器配置多端口时，通过以下环境变量实现：

• VIRTUAL_HOST: 指定虚拟主机域名（如example.com）
• VIRTUAL_PORT: 指定多个端口，使用逗号分隔（如80,3000,8080）

多端口容器示例

启动一个需要暴露80和3000端口的应用容器：

bash
docker run -d \
  --name multi-port-app \
  -e VIRTUAL_HOST=example.com \
  -e VIRTUAL_PORT=80,3000 \
  my-app-image

容器启动后，nginx-proxy会自动生成Nginx配置，将example.com:80和example.com:3000都代理到该容器的对应端口。

高级配置

HTTPS支持

配合nginx-proxy/acme-companion可实现HTTPS自动配置，多端口场景下HTTPS端口（443）需单独映射：

bash
# 启动acme-companion容器
docker run -d \
  --name nginx-proxy-acme \
  --volumes-from nginx-proxy \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v acme:/etc/acme.sh \
  --env "DEFAULT_EMAIL=***" \
  nginxproxy/acme-companion

自定义端口映射

如需将容器端口映射到不同的主机端口，可通过VIRTUAL_HOST指定端口，格式为域名:主机端口：

bash
docker run -d \
  -e VIRTUAL_HOST=example.com:8080 \
  -e VIRTUAL_PORT=3000 \
  my-app-image

环境变量说明

注意事项

• 需确保主机端口未被其他服务占用
• 多端口配置时，Nginx会为每个端口生成独立的server块
• 继承原版nginx-proxy的网络配置限制，建议使用同一网络或配置--net=host（视场景而定）
• 容器重启或配置变更后，代理规则会自动更新，无需手动重启nginx-proxy

与原版差异

• 核心扩展：新增多端口虚拟主机支持
• 配置生成：调整Nginx配置模板，支持多端口server块生成
• 完全兼容原版的环境变量和使用方式，可无缝替换原版nginx-proxy