nginxproxy/nginx-proxy

nginx-proxy 镜像文档

概述

nginx-proxy是一个运行nginx和docker-gen的Docker容器，docker-gen能够自动生成nginx反向代理配置，并在容器启动或停止时重载nginx服务。这使得管理多个Docker容器的反向代理变得简单高效。

核心功能与特性

• 自动化生成nginx反向代理配置文件
• 容器生命周期管理：在容器启动/停止时自动更新并重载nginx配置
• 通过环境变量VIRTUAL_HOST轻松指定代理域名
• 支持多种容器网络配置
• 提供Debian和Alpine两种基础镜像变体，满足不同场景需求

使用场景与适用范围

适用于需要为多个Docker容器提供反向代理服务的场景，特别适合：

• 开发环境中快速部署多个Web服务
• 小型生产环境中管理多个基于Docker的Web应用
• 需要通过域名自动路由到不同容器的场景

使用方法与配置说明

基本使用

启动nginx-proxy容器

console
docker run --detach \
    --name nginx-proxy \
    --publish 80:80 \
    --volume /var/run/docker.sock:/tmp/docker.sock:ro \
    nginxproxy/nginx-proxy:1.8

启动被代理容器

启动需要被代理的容器时，添加VIRTUAL_HOST环境变量指定域名：

console
docker run --detach \
    --name your-proxied-app \
    --env VIRTUAL_HOST=foo.bar.com \
    nginx

当DNS配置将foo.bar.com解析到运行nginx-proxy的主机时，访问http://foo.bar.com将被路由到设置了VIRTUAL_HOST=foo.bar.com的容器（上例中的your-proxied-app容器）。

被代理容器的要求

被代理的容器必须满足以下条件：

1. 暴露端口：

   • 通过Dockerfile中的EXPOSE指令
   • 或使用docker run/docker create命令的--expose标志

2. 网络共享：

   • 至少与nginx-proxy容器共享一个Docker网络
   • 默认情况下，nginx-proxy仅连接到默认bridge网络，无法连接其他网络中的容器

注意：不支持在VIRTUAL_HOST中指定端口号。如需相关功能，请参考https://github.com/nginx-proxy/nginx-proxy/tree/main/docs#virtual-ports%E6%88%96https://github.com/nginx-proxy/nginx-proxy/tree/main/docs#custom-external-httphttps-ports%E6%96%87%E6%A1%A3%E3%80%82

镜像变体

nginx-proxy提供两种镜像变体：

Debian基础版本

基于nginx:mainline镜像（Debian slim基础）：

console
docker pull nginxproxy/nginx-proxy:1.8

Alpine基础版本（-alpine后缀）

基于nginx:alpine镜像，体积更小：

console
docker pull nginxproxy/nginx-proxy:1.8-alpine

重要：

不推荐在生产环境中使用latest（nginxproxy/nginx-proxy、nginxproxy/nginx-proxy:latest）或alpine（nginxproxy/nginx-proxy:alpine）标签。

这些标签指向main分支的最新提交，不保证稳定性，可能会因非向后兼容更新或破坏性变更导致部署中断。应始终明确指定所需版本以确保部署稳定性。

额外文档

更多详细文档请查看https://github.com/nginx-proxy/nginx-proxy/tree/main/docs%E3%80%82

技术支持

由以下提供支持：GoLand 和 PyCharm