unleashed/nginx-proxy

!https://img.shields.io/badge/nginx-1.11.10-brightgreen.svg !https://img.shields.io/badge/license-MIT-blue.svg https://travis-ci.org/jwilder/nginx-proxy.svg?branch=master](https://travis-ci.org/jwilder/nginx-proxy) https://img.shields.io/docker/stars/jwilder/nginx-proxy.svg](https://hub.docker.com/r/jwilder/nginx-proxy 'DockerHub') https://img.shields.io/docker/pulls/jwilder/nginx-proxy.svg](https://hub.docker.com/r/jwilder/nginx-proxy 'DockerHub')

镜像概述

unleashed/nginx-proxy是jwilder/nginx-proxy的分支版本，包含热修复。该镜像运行Nginx和https://github.com/jwilder/docker-gen工具，docker-gen会根据Docker容器的启动/停止事件自动生成Nginx反向代理配置并重新加载Nginx，实现容器的自动反向代理。

核心功能

• 自动配置: 根据容器的VIRTUAL_HOST环境变量自动生成反向代理规则
• 多端口支持: 默认使用80端口，可通过VIRTUAL_PORT指定其他端口
• SSL支持: 支持单域名、通配符证书及SNI，可与Let's Encrypt集成
• 基础认证: 通过htpasswd文件实现虚拟主机的身份验证
• 自定义配置: 支持全局或按虚拟主机的Nginx配置扩展
• IPv6支持: 通过ENABLE_IPV6环境变量开启IPv6
• 多网络支持: 可连接到多个Docker网络的后端容器

使用场景

• 快速部署多容器应用的反向代理
• 微服务架构中统一入口管理
• 需要自动配置SSL的Web服务
• 本地开发环境的多域名测试

配置说明

基本使用

启动nginx-proxy容器：

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

启动需要代理的容器（需暴露端口并设置VIRTUAL_HOST）：

bash
docker run -e VIRTUAL_HOST=foo.bar.com --expose 80 your-app-image

Docker Compose示例

yaml
version: '2'
services:
  nginx-proxy:
    image: unleashed/nginx-proxy
    container_name: nginx-proxy
    ports:
      - "80:80"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro

  whoami:
    image: jwilder/whoami
    container_name: whoami
    environment:
      - VIRTUAL_HOST=whoami.local

启动后测试：

bash
docker-compose up
curl -H "Host: whoami.local" localhost

SSL配置

启动带SSL支持的容器：

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 unleashed/nginx-proxy

证书文件需按虚拟主机名.crt和虚拟主机名.key的格式存放于/path/to/certs目录。

基础认证配置

挂载htpasswd目录：

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

htpasswd文件需按虚拟主机名命名，例如foo.bar.com的认证文件为/path/to/htpasswd/foo.bar.com。

自定义Nginx配置

• 全局配置: 将配置文件挂载到/etc/nginx/conf.d目录（后缀为.conf）
• 按虚拟主机配置: 将配置文件挂载到/etc/nginx/vhost.d目录，文件名与VIRTUAL_HOST一致