【零基础部署】Ubuntu 安装 Docker 保姆级教程
Docker 是当今最流行的容器化平台之一，它能让你把应用及其依赖打包到一个轻量级的容器中运行。无论你是想搭建开发环境、部署服务，还是学习云原生技术，Docker 都是必备技能。本文将手把手带你从零开始，在 Ubuntu 系统上完成 Docker 的安装与配置。
1. 适用范围与前置条件
本教程适用于 Ubuntu 20.04、22.04 和 24.04 等主流 LTS 版本。开始之前，请确保你满足以下条件：
- 拥有一台安装了 Ubuntu 系统的电脑或服务器
- 拥有
sudo权限（即管理员权限） - 拥有稳定的网络连接
如果你使用的是云服务器，一般默认就具备
sudo权限，直接连接终端即可操作。
2. 卸载旧版本 Docker
如果你之前安装过旧版 Docker 或相关组件，建议先将其卸载，避免版本冲突。如果从未安装过，这一步也可以执行，不会有任何影响。
sudoaptremovedockerdocker-engine docker.io containerd runc执行完成后，系统中残留的旧版 Docker 相关包会被清理干净。
3. 安装必要的依赖包
在添加 Docker 官方源之前，需要先安装一些基础工具，它们能帮助系统安全地访问和管理软件仓库。
sudoaptupdatesudoaptinstall-yapt-transport-https ca-certificatescurlsoftware-properties-common这几个包的作用分别是：
- apt-transport-https：让 APT 能通过 HTTPS 协议访问软件源
- ca-certificates：提供 CA 证书，确保下载安全
- curl：命令行下载工具，后续添加 GPG 密钥时会用到
- software-properties-common：提供管理软件源的辅助工具
4. 添加 Docker 官方 GPG 密钥
GPG 密钥用于验证从 Docker 官方仓库下载的软件包是否被篡改，是保障安全性的重要步骤。
curl-fsSLhttps://download.docker.com/linux/ubuntu/gpg|sudoapt-keyadd-如果终端返回OK，说明密钥添加成功。
注意：在较新的 Ubuntu 版本中，
apt-key已被标记为过时。但目前它仍然可以正常工作。如果你希望使用更现代的方式，可以将密钥存放到/etc/apt/keyrings/目录下，后续步骤会用到此路径。
5. 添加 Docker APT 软件源
接下来需要将 Docker 官方仓库添加到系统的软件源列表中，这样你才能通过apt install来安装最新版 Docker。
echo"deb [arch=$(dpkg --print-architecture)signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu$(lsb_release-cs)stable"|sudotee/etc/apt/sources.list.d/docker.list>/dev/null这条命令会自动识别你的系统架构（amd64 或 arm64）和 Ubuntu 版本代号（如 jammy、noble），无需手动修改。
如果你在上一步使用了apt-key add，也可以用以下简化版本：
sudoadd-apt-repository"deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/ubuntu$(lsb_release-cs)stable"添加完成后，更新一下软件包索引：
sudoaptupdate6. 安装 Docker 及相关组件
现在可以正式安装 Docker 了。以下命令会安装 Docker 引擎、CLI 客户端、containerd 运行时，以及 BuildKit 构建工具和 Docker Compose 插件。
sudoaptinstall-ydocker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin各组件说明：
- docker-ce：Docker 社区版引擎（Community Edition），核心组件
- docker-ce-cli：Docker 命令行工具，用来执行各种 Docker 命令
- containerd.io：容器运行时，负责实际的容器生命周期管理
- docker-buildx-plugin：增强的构建插件，支持多平台构建
- docker-compose-plugin：Docker Compose 插件，用于编排多容器应用
7. 启动并设置 Docker 开机自启
安装完成后，需要手动启动 Docker 服务，并将其设置为开机自动启动，这样每次重启服务器后 Docker 都能自动运行。
sudosystemctl startdockersudosystemctlenabledocker你可以用以下命令检查 Docker 服务的运行状态：
sudosystemctl statusdocker如果看到active (running)字样，说明 Docker 已经成功启动。
8. 将当前用户添加到 docker 组
默认情况下，执行 Docker 命令需要sudo权限。为了方便日常使用，可以将当前用户添加到docker用户组，这样以后使用 Docker 就不再需要输入sudo。
sudousermod-aGdocker$USER执行后需要注销并重新登录才能生效。如果你是通过 SSH 连接的服务器，退出后重新连接即可。
⚠️ 注意：将用户加入
docker组等同于赋予其 root 级别的容器操作权限，请确保你信任该用户。在生产环境中要谨慎使用。
重新登录后，你可以不加sudo直接执行 Docker 命令来验证：
dockerps如果没有报错permission denied，说明配置成功。
9. 配置国内镜像加速
由于 Docker 默认的镜像仓库（Docker Hub）位于海外，在国内拉取镜像时速度可能很慢甚至无法连接。配置国内镜像加速器可以显著提升镜像下载速度。
编辑或创建 Docker 的配置文件：
sudomkdir-p/etc/dockersudotee/etc/docker/daemon.json<<-'EOF' { "registry-mirrors": [ "https://docker.xuanyuan.me", "https://docker.1ms.run", "https://docker.m.daocloud.io" ] } EOF这里配置了三个国内镜像源，Docker 会按顺序尝试使用。如果某个镜像不可用，会自动切换到下一个。
配置完成后，需要重启 Docker 服务使配置生效：
sudosystemctl daemon-reloadsudosystemctl restartdocker10. 验证安装是否成功
万事俱备，让我们运行一个测试容器来验证 Docker 是否安装成功。
dockerrun hello-world如果看到类似以下的输出信息，恭喜你，Docker 已经安装成功！
Hello from Docker! This message shows that your installation appears to be working correctly.这条命令的工作原理是：Docker 会自动从镜像仓库拉取hello-world镜像，创建一个容器并运行，容器会打印一段欢迎信息后自动退出。
你还可以用以下命令确认 Docker 版本和系统信息：
dockerversiondockerinfo11. 常见问题排查
Q：执行docker run hello-world时提示permission denied怎么办？
A：说明你还没有将用户添加到docker组，或者添加后还没有重新登录。请确认已执行sudo usermod -aG docker $USER，并注销重新登录。
Q：拉取镜像时一直超时怎么办？
A：请检查是否正确配置了镜像加速器（参见第 9 步）。配置完成后记得重启 Docker 服务。如果仍然超时，可以尝试更换其他镜像源。
Q：提示Unable to locate package docker-ce怎么办？
A：说明 Docker 软件源没有正确添加。请检查/etc/apt/sources.list.d/目录下是否有docker.list文件，并确认文件内容中的 Ubuntu 版本代号是否正确。运行lsb_release -cs可以查看当前系统的代号。
12. 总结
到这里，你已经完成了 Ubuntu 上 Docker 的完整安装与配置。让我们回顾一下关键步骤：
- 卸载旧版本，避免冲突
- 安装基础依赖工具
- 添加 Docker 官方 GPG 密钥和软件源
- 安装 Docker 引擎及相关组件
- 启动服务并设置开机自启
- 将用户添加到
docker组以简化操作 - 配置国内镜像加速，提升下载速度
- 运行
hello-world验证安装
接下来，你可以开始学习 Docker 的核心操作，比如拉取镜像、运行容器、编写 Dockerfile 等。祝你容器化之旅愉快！