Ubuntu 系统上安装 Docker

文章目录

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

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

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

1. 卸载旧版本（如有）

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

sudoaptremove-ydockerdocker-engine docker.io containerd runc

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

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

sudoaptupdatesudoaptinstall-yca-certificatescurlgnupg lsb-release

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

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

sudomkdir-p/etc/apt/keyringscurl-fsSLhttps://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg|sudogpg--dearmor-o/etc/apt/keyrings/docker.gpg

4. 添加阿里云 Docker 软件源

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

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"|sudotee/etc/apt/sources.list.d/docker.list>/dev/null

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

sudoaptupdate

5. 安装 Docker 及相关组件

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

sudoaptinstall-ydocker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

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

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

sudosystemctl startdockersudosystemctlenabledocker

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

sudosystemctl statusdocker

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

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

sudousermod-aGdocker$USERnewgrpdocker

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

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

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

sudomkdir-p/etc/dockersudotee/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 服务使其生效：

sudosystemctl daemon-reloadsudosystemctl restartdocker

9. 验证安装

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

dockerrun hello-world

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

---

📖 延伸阅读

• 一人公司（OPC）典型案例与商业模式研究报告
• 主流 Claw 类产品技术与商业差异全景报告
• 常见误区：管理者最容易踩的 5 个坑
• 团队 AI 成熟度自评模型