使用docker-gen为Docker容器提供自动化nginx反向代理,可自动生成配置并在容器启停时重载nginx。
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容器
consoledocker 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环境变量指定域名:
consoledocker 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容器)。
被代理容器的要求
被代理的容器必须满足以下条件:
-
暴露端口:
- 通过Dockerfile中的
EXPOSE指令 - 或使用
docker run/docker create命令的--expose标志
- 通过Dockerfile中的
-
网络共享:
- 至少与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基础):
consoledocker pull docker.xuanyuan.run/nginxproxy/nginx-proxy:1.8
Alpine基础版本(-alpine后缀)
基于nginx:alpine镜像,体积更小:
consoledocker 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/
nginxproxy 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 nginx-proxy 镜像标签
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务