pebbletech/nginx-proxy

pebbletech/nginx-proxy镜像说明

镜像概述

pebbletech/nginx-proxy镜像整合nginx和docker-gen工具，通过监听Docker socket自动生成反向代理配置，当容器启动或停止时自动重载nginx，简化多容器环境下的反向代理管理。

核心功能

• 自动生成nginx反向代理配置，无需手动编写
• 支持多虚拟主机（含通配符、正则表达式）
• 支持多端口选择，可指定容器暴露的端口
• 支持SSL（单主机证书、wildcard证书、SNI）
• 支持基础认证保护虚拟主机
• 支持全局或按虚拟主机的自定义nginx配置

使用场景

适用于Docker环境下需要为多个容器服务提供反向代理的场景，如：

• 微服务架构中多个服务的统一入口管理
• 多应用部署时的域名路由
• 开发/测试环境中快速搭建反向代理

配置说明

基本运行

启动nginx-proxy容器：

bash
docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro pebbletech/nginx-proxy

启动需要代理的容器（设置虚拟主机环境变量）：

bash
docker run -e VIRTUAL_HOST=foo.bar.com ...

多端口设置

若容器暴露多个端口，默认使用80端口；可通过VIRTUAL_PORT指定端口：

bash
docker run -e VIRTUAL_HOST=foo.bar.com -e VIRTUAL_PORT=8080 ...

SSL支持

启动容器时挂载证书目录（证书文件需按虚拟主机名命名，如foo.bar.com.crt和foo.bar.com.key）：

bash
docker run -d -p 80:80 -p 443:443 -v /path/to/certs:/etc/nginx/certs -v /var/run/docker.sock:/tmp/docker.sock:ro pebbletech/nginx-proxy

基础认证

挂载htpasswd目录（需提前创建对应虚拟主机的htpasswd文件）：

bash
docker run -d -p 80:80 -p 443:443 \
  -v /path/to/htpasswd:/etc/nginx/htpasswd \
  -v /path/to/certs:/etc/nginx/certs \
  -v /var/run/docker.sock:/tmp/docker.sock:ro \
  pebbletech/nginx-proxy

自定义配置

• 全局配置：将自定义.conf文件挂载到/etc/nginx/conf.d目录
• 按虚拟主机配置：将文件挂载到/etc/nginx/vhost.d目录，文件名与VIRTUAL_HOST一致
• 位置块配置：在/etc/nginx/vhost.d目录下创建{VIRTUAL_HOST}_location文件，添加位置块相关配置