
ubuntu/nginx
Nginx是一款高性能的反向代理和Web服务器,以高并发处理能力、低资源消耗及出色的稳定性著称,广泛应用于各类网站架构中,承担请求转发、负载均衡、静态资源服务等关键任务,其长期跟踪版本由Canonical公司负责维护,为用户提供持续可靠的技术支持与版本更新。
让 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
基于精简Ubuntu的Nginx Docker镜像
镜像概述
当前Nginx Docker镜像由Canonical提供,基于Ubuntu系统构建。该镜像会持续接收安全更新,并同步升级至新版Nginx或Ubuntu。本仓库可免费使用,且无用户速率限制。
关于Nginx
Nginx("engine X")是由Igor Sysoev开发的高性能Web服务器与反向代理服务器。它既可作为独立Web服务器使用,也能作为代理服务减轻后端HTTP或邮件服务器的负载。更多信息可访问Nginx官网。
标签与架构
LTS与ESM维护说明
- LTS:LTS渠道提供长达5年的免费安全维护。
- ESM:通过Canonical的受限仓库,可为客户提供长达10年的安全维护([获取详情] )。
标签详情表
| 渠道标签(主标签) | 其他可用标签 | 支持截止时间 | 当前版本 | 支持架构 |
|---|---|---|---|---|
1.27-24.04_stable | 1-24.04、1-24.04_beta、1-24.04_candidate、1-24.04_edge、1-24.04_stable、1.27-24.04、1.27-24.04_beta、1.27-24.04_candidate、1.27-24.04_edge | - | Nginx 1.27 on Ubuntu 24.04 LTS | amd64 |
1.26-24.10_beta | 1.26-24.10_edge、edge、latest | - | Nginx 1.26 on Ubuntu 24.10 | amd64、arm64、ppc64le、s390x |
1.24-24.04_beta | 1.24-24.04_edge | - | Nginx 1.24 on Ubuntu 24.04 LTS | amd64、s390x、ppc64le、arm64 |
1.24-23.10_beta | 1.24-23.10_edge | - | Nginx 1.24 on Ubuntu 23.10 | ppc64le、s390x、arm64、amd64 |
1.22-23.04_beta | 1.22-23.04_edge | - | Nginx 1.22 on Ubuntu 23.04 | s390x、arm64、amd64、ppc64le |
1.22-22.10_beta | 1.22-22.10_edge | - | Nginx 1.22 on Ubuntu 22.10 | amd64、s390x、ppc64le、arm64 |
1.18-22.04_beta | 1.18-22.04_edge | - | Nginx 1.18 on Ubuntu 22.04 LTS | amd64、s390x、ppc64le、arm64 |
1.18-21.10_beta | 1.18-21.10_edge | - | Nginx 1.18 on Ubuntu 21.10 | amd64、s390x、arm64、ppc64le |
1.18-21.04_beta | 1.18-21.04_edge | - | Nginx 1.18 on Ubuntu 21.04 | s390x、arm64、amd64、ppc64le |
1.18-20.04_beta | 1.18-20.04_edge | - | Nginx 1.18 on Ubuntu 20.04 LTS | arm64、amd64、ppc64le、s390x |
标签风险等级说明
渠道标签按稳定性从高到低排序为:stable > candidate > beta > edge。标注的标签隐含更风险等级的标签可用,例如:
- 若列出
beta,则edge也可使用; - 若列出
candidate,则beta和edge也可使用; - 若列出
stable,则全部四个等级标签均可用。
镜像版本会严格按edge→beta→candidate→stable的顺序迭代更新。
商业用途与ESM渠道
若需将镜像用于商业分发,或需要ESM维护支持,或使用未列出的渠道/版本,可联系Canonical团队(***:[***已删除],或通过[官方链接] )。
使用方法
本地启动
通过以下命令在本地启动容器:
shdocker run -d --name nginx-container -e TZ=UTC -p 8080:80 docker.xuanyuan.run/ubuntu/nginx:1.27-24.04_stable
启动后,可通过`[]
参数说明
| 参数 | 描述 |
|---|---|
-e TZ=UTC | 设置容器时区(示例为UTC)。 |
-p 8080:80 | 将容器内80端口映射到本地8080端口,暴露Nginx服务。 |
-v /local/path/to/website:/var/www/html | 挂载本地网站目录到容器内/var/www/html,以提供本地网站服务。 |
-v /path/to/conf.template:/etc/nginx/templates/conf.template | 挂载配置模板文件到容器内/etc/nginx/templates,模板会自动处理并生成配置文件到/etc/nginx/conf.d(例如模板中listen ${NGINX_PORT};会生成listen 80;)。 |
-v /path/to/nginx.conf:/etc/nginx/nginx.conf | 挂载本地Nginx配置文件(可参考[示例配置] )。 |
测试与调试
查看容器运行日志以调试问题:
CODE_TOKEN_1
Kubernetes部署
该镜像可在任意Kubernetes环境中部署。若暂无Kubernetes集群,推荐安装MicroK8s:
CODE_TOKEN_2
部署步骤
-
下载配置文件:
- [nginx.conf] (Nginx主配置)
- [index.html] (示例网页)
- [nginx-deployment.yml] (Kubernetes部署文件)
-
编辑
nginx-deployment.yml,将containers.nginx.image字段设置为目标标签(例如ubuntu/nginx:1.27-24.04_stable)。 -
创建配置映射并部署:
CODE_TOKEN_3
部署完成后,可通过`[]
问题反馈
若发现镜像 bug 或需请求功能,可通过以下链接提交issue:
[[]]
提交时请按格式命名标题:nginx: <问题摘要>,并附上所用镜像的完整摘要(通过以下命令获取):
shdocker images --no-trunc --quiet ubuntu/nginx:<tag>
废弃标签与渠道
以下渠道(标签)已停止更新,建议升级至新版渠道;若无法升级,可[联系支持] 。
| 渠道 | 版本 | 停止维护时间 | 升级路径 |
|---|---|---|---|
track |
更多相关 Docker 镜像与资源
以下是 ubuntu/nginx 相关的常用 Docker 镜像,适用于 反向代理、负载均衡、静态资源服务 等不同场景:
- library/nginx Docker 镜像说明
- ilios/nginx Docker 镜像说明(Nginx Web 服务器,轻量高效)
- bitnami/nginx Docker 镜像说明(Nginx Web 服务器,Bitnami 企业级配置,适合生产环境)
- linuxserver/nginx Docker 镜像说明(Nginx Web 服务器,LinuxServer 维护版本,适合静态资源服务和反向代理)
- arm64v8/nginx Docker 镜像说明(arm64v8 架构 Nginx 官方镜像,适合 ARM64 服务器与树莓派类设备的 Web 服务)
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务