nginx-proxy

nginxproxy/nginx-proxy Docker Image

nginxproxy

使用docker-gen为Docker容器提供自动化nginx反向代理,可自动生成配置并在容器启停时重载nginx。

173 次收藏下载次数: 0状态:社区镜像维护者:nginxproxy仓库类型:镜像最近更新:

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 \
    docker.xuanyuan.run/nginxproxy/nginx-proxy:1.8

启动被代理容器

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

console
docker run --detach \
    --name your-proxied-app \
    --env VIRTUAL_HOST=foo.bar.com \
    docker.xuanyuan.run/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或https://github.com/nginx-proxy/nginx-proxy/tree/main/docs#custom-external-httphttps-ports文档。

镜像变体

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

Debian基础版本

基于nginx:mainline镜像(Debian slim基础):

console
docker pull docker.xuanyuan.run/nginxproxy/nginx-proxy:1.8

Alpine基础版本(-alpine后缀)

基于nginx:alpine镜像,体积更小:

console
docker pull docker.xuanyuan.run/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。

技术支持

由以下提供支持:https://www.jetbrains.com/go/ 和 https://www.jetbrains.com/pycharm/

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 nginx-proxy 镜像标签

docker pull docker.xuanyuan.run/nginxproxy/nginx-proxy:<标签>

DockerHub 原生拉取命令

docker pull nginxproxy/nginx-proxy:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告