Ubuntu Docker 安装中文讲解
关键要点
- Docker 在 Ubuntu 上的安装步骤较为标准,但使用国内镜像源(如清华大学或阿里云)可以显著提高下载速度,特别适合中国用户。
- 安装过程涉及更新软件包、添加 GPG 密钥、设置仓库并安装 Docker,建议使用 LTS 版本(如 20.04、22.04、24.04)以确保稳定性。
- 配置国内镜像加速器可进一步优化体验,但需根据网络环境选择合适的镜像源。
安装概述
以下是安装 Docker on Ubuntu 的简要步骤,适合初学者。所有操作需以管理员权限(sudo)执行,确保你的 Ubuntu 是 64 位版本,并建议使用 LTS 版本以获得长期支持。
更新和准备
- 更新软件包索引:
sudo apt-get update
- 安装必要软件包:
sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
添加国内镜像源
为加快下载速度,推荐使用国内镜像:
- 清华大学镜像:
curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
- 阿里云镜像(备用):
curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
sudo sh -c 'echo "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" > /etc/apt/sources.list.d/docker.list'
安装 Docker
- 更新索引并安装:
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
- 验证安装:
sudo docker run hello-world
如果看到 “Hello from Docker!”,说明安装成功。
优化(可选)
- 配置镜像加速器以加快拉取速度,编辑
/etc/docker/daemon.json
,添加国内镜像地址(如阿里云、Docker Hub 国内镜像),然后重启 Docker:
sudo systemctl daemon-reload
sudo systemctl restart docker
更多详细步骤和参考资料,请见下文。
详细报告
以下是关于 Ubuntu Docker 安装的全面分析,基于 2025 年 7 月 22 日的最新信息,结合可靠中文来源,确保内容适合中国用户的需求。报告涵盖安装步骤、系统要求、优化建议及参考资料,力求全面且实用。
背景与系统要求
Docker Engine-Community 支持多种 Ubuntu 版本,但推荐使用 LTS(长期支持)版本,如 Noble 24.04、Jammy 22.04、Focal 20.04,以确保稳定性。截至 2025 年,这些版本分别支持 Docker v27.2.1(24.04 和 22.04)及 v27.2.1(20.04)。支持的架构包括 amd64、arm64、armhf、ppc64el、s390x,生产环境建议使用 LTS 版本。
- 支持的 Ubuntu 版本:
- Noble 24.04 (Docker v27.2.1)
- Jammy 22.04 (Docker v27.2.1)
- Focal 20.04 (Docker v27.2.1)
- Bionic 18.04 (Docker v24.0.2,较旧)
- 注意:非 LTS 版本可能支持的平台较少,且更新周期较短,不建议生产环境使用。
安装前的准备
在安装 Docker 前,需确保系统满足要求并卸载旧版本(如有)。以下是详细步骤:
卸载旧版本
如果之前安装过 Docker 或相关组件(如 docker、docker-engine、docker.io),需先卸载:
for pkg in docker docker-engine docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt remove $pkg; done
这确保不会出现版本冲突。
更新软件包和安装依赖
更新软件包索引并安装必要的依赖:
sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
这些包确保 apt 能通过 HTTPS 下载并验证软件包。
安装方法
安装 Docker 有两种主要方法:手动通过 APT 安装(推荐)和使用自动脚本。以下详细说明。
方法 1:手动通过 APT 安装(推荐)
步骤 1:添加 GPG 密钥和仓库
为确保软件包的真实性,需添加 Docker 的 GPG 密钥。考虑到国内网络环境,推荐使用国内镜像源:
- 清华大学镜像源:
curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
- 阿里云镜像源(备用):
curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
sudo sh -c 'echo "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" > /etc/apt/sources.list.d/docker.list'
注意:lsb_release -cs
返回你的 Ubuntu 发行版代号(如 focal、jammy),确保正确。
步骤 2:更新并安装 Docker
更新软件包索引并安装 Docker Engine:
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
如果需要安装特定版本,可先列出可用版本:
apt-cache madison docker-ce
然后安装指定版本,例如:
sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io
步骤 3:验证安装
运行以下命令测试 Docker 是否正常工作:
sudo docker run hello-world
成功输出应包括 “Hello from Docker!” 和相关步骤,如从 Docker Hub 拉取镜像。
方法 2:使用自动安装脚本
对于测试或开发环境,可使用 Docker 官方提供的安装脚本,适合快速安装:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
若需使用国内镜像,可添加 --mirror Aliyun
参数:
sudo sh get-docker.sh --mirror Aliyun
注意:官方不建议在生产环境中使用此方法,且脚本可能不使用国内镜像,下载速度可能较慢。
优化与配置
安装完成后,可进行以下优化以提升使用体验。
配置 Docker 服务
启动并启用 Docker 服务,确保开机自启:
sudo systemctl enable docker
sudo systemctl start docker
添加用户到 Docker 组
为避免每次使用 Docker 需输入 sudo,可将当前用户添加到 docker 组:
sudo groupadd docker
sudo usermod -aG docker $USER
完成后,需重新登录终端(或重启)以使更改生效。
配置镜像加速器
国内用户常因网络原因拉取镜像较慢,可配置国内镜像加速器。编辑 /etc/docker/daemon.json
(若不存在则创建),添加以下内容:
{
"registry-mirrors": [
"[invalid url, do not cite]
"[invalid url, do not cite]
"[invalid url, do not cite]
"[invalid url, do not cite]
"[invalid url, do not cite]
"[invalid url, do not cite]
"[invalid url, do not cite]
"[invalid url, do not cite]
"[invalid url, do not cite]
"[invalid url, do not cite]
]
}
保存后,重载并重启 Docker:
sudo systemctl daemon-reload
sudo systemctl restart docker
验证配置:
sudo docker info
输出中应看到配置的镜像加速器。
常见问题与注意事项
- 权限问题:若未加入 docker 组,运行
docker
命令需 sudo,否则会报错。 - 网络问题:若下载速度慢,优先使用国内镜像源,并确保网络稳定。
- 防火墙设置:Docker 暴露的容器端口可能绕过防火墙规则(如 ufw),需注意安全配置。
卸载 Docker
若需卸载 Docker,可执行以下命令移除软件包并清理文件:
sudo apt-get purge docker-ce
sudo rm -rf /var/lib/docker
这将删除 Docker 及其相关数据。
参考资料
以下是提供以上信息的可靠中文来源,供进一步查阅:
这些资源提供了详细的步骤和额外的配置选项,适合不同用户的需求。
总结
通过以上步骤,你可以在 Ubuntu 上成功安装 Docker,并通过国内镜像源和加速器优化使用体验。建议根据实际网络环境选择合适的镜像源,并定期检查官方文档以获取最新更新。