【零基础部署】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。echodeb [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-repositorydeb [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-ceDocker 社区版引擎Community Edition核心组件docker-ce-cliDocker 命令行工具用来执行各种 Docker 命令containerd.io容器运行时负责实际的容器生命周期管理docker-buildx-plugin增强的构建插件支持多平台构建docker-compose-pluginDocker 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 等。祝你容器化之旅愉快