热门搜索:
blacklabelops/nginx
自动构建
blacklabelops
这是一个Docker化的Nginx反向代理服务器镜像，支持多服务器配置、HTTPS（含自签名及Let's Encrypt证书）、基础认证、静态文件服务等功能，可通过环境变量灵活配置，适用于各类Web服务反向代理场景。
12 次收藏下载次数: 0状态：自动构建维护者：blacklabelops仓库类型：镜像最近更新：7 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Docker化Nginx
支持的标签及对应Dockerfile
| Nginx版本 | 标签 | Dockerfile |
|---|---|---|
| latest | latest | https://github.com/blacklabelops/nginx/blob/master/Dockerfile |
| 1.10.3-r0 | 2.2 | https://github.com/blacklabelops/nginx/blob/2.2/Dockerfile |
| undefined | development | https://github.com/blacklabelops/nginx/blob/development/Dockerfile |
推荐：使用带标签的版本镜像。阅读发布说明，建议逐步升级，必要时回滚。
功能特性
- 支持通过环境变量配置多服务器
- 支持为每个服务器配置任意数量的反向代理
- 支持HTTPS及临时自签名证书
- 支持为每个服务器指定SSL证书
- 支持Let's Encrypt证书
支持与功能请求
在Hipchat留言提问：blacklabelops/hipchat
快速启动
bash$ docker run -d \ -p 80:80 \ --name nginx \ blacklabelops/nginx
默认服务器将在80端口可用。
配置文件
您可以使用自定义配置文件覆盖镜像的自动配置功能。
示例：
bash$ docker run -d \ -v your_local_config_file.conf:/etc/nginx/nginx.conf \ -p 80:80 \ --name nginx \ blacklabelops/nginx
反向代理设置
bash$ docker run -d \ -p 80:80 \ --name nginx \ -e "SERVER1REVERSE_PROXY_LOCATION1=/" \ -e "SERVER1REVERSE_PROXY_PASS1=http://www.heise.de/" \ blacklabelops/nginx
反向代理将转发到[***]
多服务器配置
可以通过环境变量定义任意数量的服务器。每个变量需以"SERVER"加服务器编号开头。
示例：
服务器1反向代理1：
- 路径：/
- 代理目标：[***]
服务器2反向代理1：
- 服务器名称：dummy.example.com
- 路径：/
- 代理目标：[***]
bash$ docker run -d \ -p 80:80 \ --name nginx \ -e "SERVER1REVERSE_PROXY_LOCATION1=/" \ -e "SERVER1REVERSE_PROXY_PASS1=http://www.heise.de/" \ -e "SERVER2SERVER_NAME=dummy.example.com" \ -e "SERVER2REVERSE_PROXY_LOCATION1=/alternate" \ -e "SERVER2REVERSE_PROXY_PASS1=http://www.alternate.de/" \ blacklabelops/nginx
尝试访问http://localhost（使用Docker工具时替换localhost为对应IP），若要调用第二个代理，需通过DNS服务器解析dummy.example.com的请求。
多反向代理配置
可为每个服务器定义任意数量的反向代理。每个环境变量需以"SERVER"加服务器编号开头，并在变量后添加数字序号。
示例：
反向代理1：
- 路径：/
- 代理目标：[***]
反向代理2：
- 路径：/alternate
- 代理目标：[***]
bash$ docker run -d \ -p 80:80 \ --name nginx \ -e "SERVER1REVERSE_PROXY_LOCATION1=/" \ -e "SERVER1REVERSE_PROXY_PASS1=http://www.heise.de/" \ -e "SERVER1REVERSE_PROXY_LOCATION2=/alternate" \ -e "SERVER1REVERSE_PROXY_PASS2=http://www.alternate.de/" \ blacklabelops/nginx
尝试访问http://localhost和https://localhost/alternate（使用Docker工具时替换localhost为对应IP）。
HTTPS反向代理
该容器支持HTTPS。通过环境变量CERTIFICATE_DNAME输入Distinguished Name（DN），容器将生成自签名证书。DN示例：
/CN=SBleul/OU=Blacklabelops/O=blacklabelops.net/L=Munich/C=DE
- CN = 您的姓名
- OU = 组织单元
- O = 组织名称
- L = 地点（如城市名）
- C = 国家/地区代码
bash$ docker run -d \ -p 80:80 \ -p 443:443 \ -e "SERVER1REVERSE_PROXY_LOCATION1=/" \ -e "SERVER1REVERSE_PROXY_PASS1=http://www.heise.de/" \ -e "SERVER1CERTIFICATE_DNAME=/CN=SBleul/OU=Blacklabelops/O=blacklabelops.com/L=Munich/C=DE" \ -e "SERVER1HTTPS_ENABLED=true" \ --name nginx \ blacklabelops/nginx
注意：Web服务器将使用相同端口提供HTTPS服务！
Let's Encrypt证书自动续期
该镜像支持通过side容器自动每月续期Let's Encrypt证书。端口80和443由Nginx使用，因此我们使用webroot挑战进行证书续期。
每次续期后，Nginx配置和证书将在不重启Nginx的情况下重新加载，不影响系统可用性。
- 在Let's Encrypt和Nginx容器之间创建挑战卷。
- 启动带有挑战卷的Nginx容器。
- 启动带有挑战卷和webroot模式的Let's Encrypt容器。 4.. 最后启动Cron容器，以便在证书更改后重新加载Nginx配置。
创建acme握手的额外卷：
bash$ docker volume create letsencrypt_challenges
这是Let's Encrypt的acme挑战令牌存储和Nginx处理的位置。
然后启动带有SSL设置和挑战卷的Nginx：
bash$ docker run -d \ -p 443:443 \ -p 80:80 \ -v letsencrypt_certs:/etc/letsencrypt \ -v letsencrypt_challenges:/var/www/letsencrypt \ -e "NGINX_REDIRECT_PORT80=true" \ -e "SERVER1REVERSE_PROXY_LOCATION1=/" \ -e "SERVER1REVERSE_PROXY_PASS1=http://www.heise.de/" \ -e "SERVER1HTTPS_ENABLED=true" \ -e "SERVER1HTTP_ENABLED=false" \ -e "SERVER1LETSENCRYPT_CERTIFICATES=true" \ -e "SERVER1CERTIFICATE_FILE=/etc/letsencrypt/live/example.com/cert.pem" \ -e "SERVER1CERTIFICATE_KEY=/etc/letsencrypt/live/example.com/privkey.pem" \ -e "SERVER1CERTIFICATE_TRUSTED=/etc/letsencrypt/live/example.com/fullchain.pem" \ --name nginx \ blacklabelops/nginx
Nginx现在可以通过卷处理acme挑战令牌。
基础用户认证
您可以为任何反向代理设置密码保护。此外，您可以指定任意数量的用户。
示例：为第一个反向代理指定用户admin和密码admin：
bashdocker run -d \ -p 80:80 \ --name nginx \ -e "SERVER1REVERSE_PROXY_LOCATION1=/" \ -e "SERVER1REVERSE_PROXY_PASS1=http://www.heise.de/" \ -e "SERVER1REVERSE_PROXY_BASIC_AUTH_REALM1=Secure Location" \ -e "SERVER1REVERSE_PROXY_BASIC_AUTH1USER1=admin" \ -e "SERVER1REVERSE_PROXY_BASIC_AUTH1PASSWORD1=admin" \ blacklabelops/nginx
参考资料
- NGINX
- Letsencrypt
- Docker主页
- Docker Compose
- Docker用户指南
更多相关 Docker 镜像与资源
以下是 blacklabelops/nginx 相关的常用 Docker 镜像，适用于 反向代理、负载均衡、静态资源服务 等不同场景：
- library/nginx Docker 镜像说明
- nginx/nginx-ingress Docker 镜像说明（Kubernetes Ingress 控制器）
- ilios/nginx Docker 镜像说明（Nginx Web 服务器，轻量高效）
- library/traefik Docker 镜像说明（现代反向代理和负载均衡器）
- ubuntu/nginx Docker 镜像说明（Nginx Web 服务器，基于 Ubuntu，适合生产环境）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull blacklabelops/nginx:<标签>
更多 nginx 镜像推荐
library/nginx
Docker 官方镜像
Nginx 官方 Docker 镜像，提供高性能 Web 服务器和反向代理能力，适合部署静态站点、反向代理和负载均衡入口，可通过挂载配置和静态目录快速搭建统一的 Web 与 API 网关层。
2.1万 次收藏10亿+ 次下载
18 天前更新
nginx/nginx-ingress
NGINX 官方镜像
NGINX和NGINX Plus入口控制器是专为Kubernetes设计的流量管理工具，主要用于管理外部HTTP/HTTPS流量进入Kubernetes集群，支持请求路由、负载均衡、SSL终止、流量控制等功能，适用于容器化应用和微服务架构，其中NGINX Plus还提供商业支持、高级监控和增强的负载均衡能力，帮助提升集群流量管理的效率与安全性。
120 次收藏10亿+ 次下载
13 天前更新
nginx/nginx-prometheus-exporter
NGINX 官方镜像
NGINX Prometheus Exporter用于收集并导出NGINX与NGINX Plus的监控指标，供Prometheus采集以实现对其运行状态的监控。
51 次收藏5000万+ 次下载
4 个月前更新
nginx/unit
NGINX 官方镜像
此仓库已停用，建议用户改用Docker官方提供的镜像，具体官方镜像可通过链接[]
66 次收藏1000万+ 次下载
3 年前更新
nginx/nginx-ingress-operator
NGINX 官方镜像
用于NGINX和NGINX Plus入口控制器的NGINX入口操作器，基于Helm图表构建。
4 次收藏100万+ 次下载
13 天前更新
nginx/nginx-quic-qns
NGINX 官方镜像
用于 NGINX QUIC 协议互操作性测试的 Docker 镜像，集成 QUIC 支持，简化 QUIC 实现的兼容性验证与功能测试流程。
1 次收藏1万+ 次下载
4 年前更新
镜像拉取常见问题
功能
排错
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"