Ubuntu 系统上安装 Docker

文章目录

- - [1. 卸载旧版本（如有）](#1. 卸载旧版本（如有）)
  - [2. 更新系统并安装必要依赖](#2. 更新系统并安装必要依赖)
  - [3. 添加阿里云 Docker 官方 GPG 密钥](#3. 添加阿里云 Docker 官方 GPG 密钥)
  - [4. 添加阿里云 Docker 软件源](#4. 添加阿里云 Docker 软件源)
  - [5. 安装 Docker 及相关组件](#5. 安装 Docker 及相关组件)
  - [6. 启动 Docker 并设置开机自启](#6. 启动 Docker 并设置开机自启)
  - [7. 配置免 sudo 使用 Docker（可选但推荐）](#7. 配置免 sudo 使用 Docker（可选但推荐）)
  - [8. 配置镜像加速（国内用户必做）](#8. 配置镜像加速（国内用户必做）)
  - [9. 验证安装](#9. 验证安装)
  - [📖 延伸阅读](#📖 延伸阅读)

在 Ubuntu 系统上安装 Docker，推荐使用官方仓库进行安装，这样既能保证获取到最新的稳定版本，也便于后续升级。考虑到国内的网络环境，本教程将使用阿里云的镜像源，以确保安装过程流畅、快速。

以下是完整的安装与配置步骤：

1. 卸载旧版本（如有）

如果你之前安装过旧版的 Docker 或相关组件，建议先进行清理，避免版本冲突。如果从未安装过，执行此命令也不会有任何影响。

bash 复制代码

sudo apt remove -y docker docker-engine docker.io containerd runc

2. 更新系统并安装必要依赖

安装一些基础工具，帮助系统安全地访问和管理软件仓库。

bash 复制代码

sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

3. 添加阿里云 Docker 官方 GPG 密钥

GPG 密钥用于验证下载的软件包是否被篡改，是保障安全的重要步骤。

bash 复制代码

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

4. 添加阿里云 Docker 软件源

将 Docker 的国内仓库地址添加到系统的软件源列表中，命令会自动识别你的 Ubuntu 版本代号（如 noble, jammy 等）。

bash 复制代码

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

添加完成后，再次更新软件包索引：

bash 复制代码

sudo apt update

5. 安装 Docker 及相关组件

正式安装 Docker 引擎、CLI 客户端、容器运行时以及 Docker Compose 插件。

bash 复制代码

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

6. 启动 Docker 并设置开机自启

安装完成后，启动 Docker 服务并设置为开机自动运行。

bash 复制代码

sudo systemctl start docker
sudo systemctl enable docker

你可以通过以下命令检查 Docker 的运行状态，看到 active (running) 即表示成功启动：

bash 复制代码

sudo systemctl status docker

7. 配置免 sudo 使用 Docker（可选但推荐）

默认情况下，只有 root 或拥有 sudo 权限的用户才能执行 Docker 命令。将当前用户加入 docker 用户组后，即可免 sudo 操作。

bash 复制代码

sudo usermod -aG docker $USER
newgrp docker

注：执行完 newgrp docker 后，如果提示权限不足，可以尝试重新连接终端或重启系统。

8. 配置镜像加速（国内用户必做）

为了在国内网络环境下快速拉取 Docker Hub 上的镜像，需要配置镜像加速器。这里为你配置了多个国内常用的镜像源：

bash 复制代码

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com",
    "https://mirror.aliyuncs.com"
  ]
}
EOF

配置完成后，重启 Docker 服务使其生效：

bash 复制代码

sudo systemctl daemon-reload
sudo systemctl restart docker

9. 验证安装

最后，运行一个官方的测试容器来验证 Docker 是否安装并配置成功：

bash 复制代码

docker run hello-world

如果终端输出了 "Hello from Docker!" 的相关欢迎信息，恭喜你，Docker 已经完美安装在你的 Ubuntu 系统中了！🎉

Ubuntu 系统上安装 Docker

文章目录

1. 卸载旧版本（如有）

2. 更新系统并安装必要依赖

3. 添加阿里云 Docker 官方 GPG 密钥

4. 添加阿里云 Docker 软件源

5. 安装 Docker 及相关组件

6. 启动 Docker 并设置开机自启

7. 配置免 sudo 使用 Docker（可选但推荐）

8. 配置镜像加速（国内用户必做）

9. 验证安装

📖 延伸阅读