
library/ubuntu
Ubuntu是一款基于Debian的Linux操作系统,以自由软件为核心构建,由Canonical公司主导开发并提供支持。它注重用户友好性与开源精神,兼容多种硬件架构,广泛适用于个人电脑、服务器及嵌入式设备,提供长期支持版本(LTS)以保障系统稳定性,拥有全球活跃的开发者与用户社区,致力于为各类用户提供安全、高效且免费的开源计算体验。
让 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 Docker镜像介绍
基本参考信息
维护方
[Canonical]
获取帮助渠道
- Docker社区Slack:[dockr.ly/comm-slack]
- Server Fault:[Unix & Linux相关问题]
- Stack Overflow:[技术问题讨论]
支持的标签及对应Dockerfile链接
| 标签 | 说明 | Dockerfile链接 |
|---|---|---|
22.04, jammy-20251001, jammy | Jammy版本 | [查看] |
24.04, noble-20251001, noble, latest | Noble版本(latest指向最新LTS版) | [查看] |
25.04, plucky-20251001, plucky | Plucky版本 | [查看] |
25.10, questing-20251007, questing, rolling | Questing版本(rolling指向滚动更新版) | [查看] |
扩展参考信息
问题反馈渠道
[cloud-images bug跟踪平台] (需添加docker标签)
支持的架构
([更多说明] )
amd64:[amd64/ubuntu]arm32v7:[arm32v7/ubuntu]arm64v8:[arm64v8/ubuntu]ppc64le:[ppc64le/ubuntu]riscv64:[riscv64/ubuntu]s390x:[s390x/ubuntu]
镜像 artifact 详情
[repo-info仓库的repos/ubuntu/目录] ([历史记录] )
包含镜像元数据、传输大小等信息。
镜像更新
- [official-images仓库的
library/ubuntu标签] - [official-images仓库的
library/ubuntu文件] ([历史记录] )
本文档来源
[docs仓库的ubuntu/目录] ([历史记录] )
关于Ubuntu
Ubuntu是基于Debian的Linux操作系统,应用场景覆盖桌面、云端及各类联网设备。它是公共云与OpenStack云中最流行的操作系统,也是容器领域的首选平台(支持Docker、Kubernetes、LXD等),可实现容器规模化部署。Ubuntu以快速、安全、简洁为特点,全球数百万台PC均采用该系统。
Ubuntu的开发由Canonical Ltd.主导,该公司通过提供技术支持及相关服务盈利。Ubuntu项目坚持开源软件开发原则,鼓励用户使用、学习、改进和分发自由软件。
官网:[ubuntu.com]
![Ubuntu logo]
镜像内容说明
构建来源
本镜像基于Canonical提供的官方rootfs tarballs构建(可查看[]
标签说明
ubuntu:latest:指向“最新LTS版本”(推荐日常使用)。ubuntu:rolling:指向最新发布版本(不区分是否为LTS)。ubuntu:devel:动态关联镜像源中“devel”套件指向的版本,可通过以下命令获取当前对应的版本代号:bashwget -qO- [] | awk -F ': ' '$1 == "Codename" { print $2; exit }'
本地化设置(Locales)
作为最小化安装的Ubuntu镜像,默认仅包含C、C.UTF-8和POSIX三种locale。对于多数需要UTF-8编码的场景,C.UTF-8已足够使用,可通过-e LANG=C.UTF-8(运行时)或ENV LANG C.UTF-8(Dockerfile中)设置。
如需其他locale,可通过locales包安装并生成。以下是参考PostgreSQL的配置示例:
dockerfileRUN apt-get update && apt-get install -y locales && rm -rf /var/lib/apt/lists/* \ && localedef -i en_US -c -f UTF-8 -A /usr/share/locale/locale.alias en_US.UTF-8 ENV LANG en_US.utf8
unminimize命令变化
从Ubuntu 24.10 "Oracular Oriole"开始,最小化镜像不再默认包含unminimize命令,需通过以下命令单独安装:
bashapt-get install -y unminimize
根文件系统(rootfs)构建方式
Canonical发布的tarballs(对应[]] 中的脚本构建,核心逻辑位于live-build/auto/build。构建过程在Launchpad上执行,各版本的构建历史可查看:
- [Jammy]
- [Noble]
- [Plucky]
- [Questing]
许可协议
镜像中软件的许可信息可查看[Ubuntu官方许可页面] 。
与所有Docker镜像类似,本镜像可能包含其他软件(如基础系统的Bash等),这些软件可能适用不同许可协议。
部分自动检测到的许可信息可在[repo-info仓库的ubuntu/目录] 中找到。
使用前须知:使用本镜像时,用户需自行确保符合其中所有软件的许可协议要求。
ubuntu 国内 Docker 镜像拉取说明
在国内网络环境下,直接使用 docker pull 访问 Docker Hub 官方仓库时,较常遇到连接超时、TLS 握手失败或 registry 响应缓慢等情况。这类问题多与跨境链路质量、运营商策略及客户端 DNS 解析有关,并非单个镜像本身异常。
轩辕镜像提供两种常用加速方式:一是使用公共加速域名 docker.xuanyuan.run 拉取(可参考 登录认证方式);二是在控制台配置 专属域名拉取,将拉取命令中的 registry 前缀替换为分配的专属域名,通常能提升成功率与稳定性。
以 ubuntu 为例,加速拉取命令格式为 docker pull docker.xuanyuan.run/ubuntu:<标签>,请将 <标签> 替换为具体版本。下方「镜像拉取方式」区块提供与本文一致的命令示例,可直接复制使用。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务