在 Ubuntu 上安装 Docker,最推荐使用通过官方软件仓库安装的方式,这种方式便于后续的管理和更新。

以下是详细的安装步骤,已为您整合并优化,特别针对国内用户提供了镜像源配置,可以显著提升下载速度。

🐳 在 Ubuntu 上安装 Docker 的完整步骤

1. 卸载旧版本 (可选)

如果您的系统中之前安装过旧版本的 Docker,建议先将其卸载,以避免冲突。

sudo apt-get remove docker docker-engine docker.io containerd runc
2. 设置 Docker 软件仓库

在开始之前,需要更新软件包索引并安装一些基础依赖,以便 apt 可以通过 HTTPS 使用仓库。

# 更新 apt 包索引
sudo apt-get update

# 安装必要的依赖包
sudo apt-get install -y ca-certificates curl gnupg lsb-release

接下来,添加 Docker 的官方 GPG 密钥和软件仓库。为了获得更快的下载速度,这里推荐使用阿里云的镜像源。

# 1. 创建密钥存储目录
sudo install -m 0755 -d /etc/apt/keyrings

# 2. 下载并添加阿里云的 GPG 密钥
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 3. 设置密钥文件权限
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# 4. 添加 Docker 软件仓库(使用阿里云源)
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
3. 安装 Docker 引擎

添加仓库后,再次更新软件包索引,然后安装 Docker 的核心组件。

# 更新 apt 包索引,使新加的 Docker 仓库生效
sudo apt-get update

# 安装 Docker 引擎、命令行工具及容器运行时
sudo apt-get install -y docker-ce docker-ce-cli containerd.io
4. 验证安装

安装完成后,Docker 服务通常会自动启动。您可以通过以下命令验证安装是否成功。

# 查看 Docker 版本
docker --version

# 运行一个测试容器
sudo docker run hello-world

如果看到 "Hello from Docker!" 的欢迎信息,说明 Docker 已经成功安装并运行。


✨ 安装后的常用配置

为了获得更好的使用体验,建议您进行以下两项配置。

1. 配置非 root 用户使用 Docker

默认情况下,执行 docker 命令需要 sudo 权限。通过将您的用户添加到 docker 用户组,可以避免每次都输入 sudo。

# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER

# 刷新用户组,使更改立即生效
newgrp docker

之后您就可以直接运行 docker ps 等命令,而无需 sudo 了。

2. 配置镜像加速器

从 Docker Hub 拉取镜像在国内速度可能较慢。配置镜像加速器可以显著提升拉取速度。

# 1. 创建 Docker 配置目录(如果不存在)
sudo mkdir -p /etc/docker

# 2. 创建或编辑 daemon.json 配置文件
sudo tee /etc/docker/daemon.json <<EOF
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live"
  ]
}
EOF

# 3. 重新加载配置并重启 Docker 服务
sudo systemctl daemon-reload
sudo systemctl restart docker

配置完成后,您可以再次运行 sudo docker run hello-world 来测试镜像拉取速度是否得到改善。

更多推荐