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 |
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull ubuntu/nginx:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"