跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

Ubuntu 系统安装 Docker 及配置国内镜像源

介绍在 Ubuntu 系统上安装 Docker 的完整步骤。内容包括卸载旧版本、配置清华大学镜像源仓库、安装 Docker 引擎及服务启动验证。此外还涵盖了非 root 用户配置、常见问题解决及镜像加速设置。通过本指南可快速完成 Docker 环境搭建,提升开发部署效率。

星河入梦发布于 2026/3/22更新于 2026/10/201K 浏览
Ubuntu 系统安装 Docker 及配置国内镜像源

概述

Docker 是一个开源的应用容器引擎,允许开发者将应用及其依赖打包到一个可移植的容器中,从而实现快速部署和跨平台运行。本指南将详细介绍在 Ubuntu 系统上安装 Docker 的完整步骤,特别使用了清华大学镜像源以加速国内用户的下载过程。

准备工作

在开始安装前,请确保:

  • 使用的是 Ubuntu 系统(本教程适用于 Ubuntu 16.04 及以上版本)
  • 拥有 sudo 权限或 root 用户权限
  • 能够访问互联网

完整安装步骤

1. 卸载旧版本(如有)

为避免版本冲突,建议先卸载系统中可能存在的旧版本 Docker:

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

注意:如果这是首次安装 Docker,系统中可能没有这些旧版本,但执行此命令可以确保环境的清洁。

2. 设置 Docker 仓库
2.1 更新系统包索引
sudo apt-get update
2.2 安装必要的依赖包
sudo apt-get install ca-certificates curl
2.3 创建密钥目录并设置权限
sudo install -m 0755 -d /etc/apt/keyrings
2.4 下载 Docker 官方 GPG 密钥(使用国内镜像)
sudo curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
2.5 设置密钥文件权限
sudo chmod a+r /etc/apt/keyrings/docker.asc
2.6 添加 Docker 仓库源(使用清华镜像)
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

重要说明:此命令自动检测系统架构和 Ubuntu 版本代号,确保添加正确的仓库地址。

3. 安装 Docker 引擎
3.1 再次更新包索引
sudo apt-get update
3.2 安装 Docker 及相关组件
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

安装的组件说明:

  • docker-ce: Docker 社区版
  • docker-ce-cli: Docker 命令行工具
  • containerd.io: 容器运行时
  • docker-buildx-plugin: 扩展构建功能
  • docker-compose-plugin: Docker Compose 插件(用于多容器应用)
4. 启动和启用 Docker 服务
4.1 启动 Docker 服务
sudo systemctl start docker
4.2 设置 Docker 开机自启
sudo systemctl enable docker

验证安装

安装完成后,可以通过以下命令验证 Docker 是否正确安装:

# 查看 Docker 版本信息
sudo docker version
# 运行测试容器
sudo docker run hello-world

如果看到 'Hello from Docker!' 的消息,说明 Docker 已成功安装并正常运行。

配置非 root 用户使用 Docker(可选)

默认情况下,Docker 需要 sudo 权限。如果您希望普通用户也能运行 Docker 命令,可以将用户添加到 docker 组:

sudo usermod -aG docker $USER

注意:执行此命令后,需要注销并重新登录才能生效。

常见问题解决

1. 如果遇到 GPG 密钥错误

可以尝试重新下载密钥:

sudo rm /etc/apt/keyrings/docker.asc
sudo curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo apt-get update
2. 如果仓库地址无法访问

可以尝试其他国内镜像源,如阿里云:

# 替换清华源为阿里云源
sudo sed -i 's|https://mirrors.tuna.tsinghua.edu.cn/docker-ce|https://mirrors.aliyun.com/docker-ce|g' /etc/apt/sources.list.d/docker.list
sudo apt-get update
3. 安装特定版本的 Docker

如果需要安装特定版本,可以先查看可用版本:

apt-cache madison docker-ce

然后安装指定版本:

sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io

配置 Docker 镜像加速(推荐)

为进一步加速 Docker 镜像的拉取,可以配置国内镜像加速器:

  1. 创建或修改 Docker 配置文件:
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
 "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF
  1. 重启 Docker 服务使配置生效:
sudo systemctl restart docker

总结

通过以上步骤,已经成功在 Ubuntu 系统上安装了 Docker 社区版。使用清华大学镜像源可以显著加快下载速度,特别适合国内用户。安装完成后,可以开始使用 Docker 来创建、部署和运行容器化应用程序。

Docker 的强大功能将在开发、测试和部署工作中发挥重要作用,帮助实现环境一致性和快速部署。现在,可以尝试拉取其他镜像或创建自己的 Dockerfile 来构建自定义镜像了。

提示:建议定期更新 Docker 以获得最新功能和安全补丁:

sudo apt-get update
sudo apt-get upgrade

目录

  1. 概述
  2. 准备工作
  3. 完整安装步骤
  4. 1. 卸载旧版本(如有)
  5. 2. 设置 Docker 仓库
  6. 2.1 更新系统包索引
  7. 2.2 安装必要的依赖包
  8. 2.3 创建密钥目录并设置权限
  9. 2.4 下载 Docker 官方 GPG 密钥(使用国内镜像)
  10. 2.5 设置密钥文件权限
  11. 2.6 添加 Docker 仓库源(使用清华镜像)
  12. 3. 安装 Docker 引擎
  13. 3.1 再次更新包索引
  14. 3.2 安装 Docker 及相关组件
  15. 4. 启动和启用 Docker 服务
  16. 4.1 启动 Docker 服务
  17. 4.2 设置 Docker 开机自启
  18. 验证安装
  19. 查看 Docker 版本信息
  20. 运行测试容器
  21. 配置非 root 用户使用 Docker(可选)
  22. 常见问题解决
  23. 1. 如果遇到 GPG 密钥错误
  24. 2. 如果仓库地址无法访问
  25. 替换清华源为阿里云源
  26. 3. 安装特定版本的 Docker
  27. 配置 Docker 镜像加速(推荐)
  28. 总结

更多推荐文章

查看全部
  • C++ 继承机制详解
  • 小米 MiLoco 本地协同智能助手部署实战
  • C++ 红黑树实现详解:概念、规则与代码
  • CentOS 系统定时执行 Python 邮件发送任务的五种方案
  • 基于 FPGA 的深度强化学习框架实现超音速闭环智能流动控制实验
  • QuantConnect LEAN 引擎:开源量化交易核心架构与实战
  • C++ 红黑树封装 set 与 map 底层实现
  • 基于腾讯云 HAI 与 DeepSeek 快速搭建个人网页
  • 《Agent Runtime 工程化》第三章 最小 Agent Loop:3.8 动手任务
  • TypeTale 字字动画:免费 AIGC 视频创作工具
  • 汽车雷达多径环境下幽灵目标检测算法研究
  • 低资源模型(7B)Prompt 高质量输出策略
  • Windows 11 环境下 Python 3.12.5 安装与配置实战
  • WhisperLiveKit 本地部署指南:从环境配置到服务启动
  • Pico 4XVR 1.10.13 安装包下载与安装教程
  • VRChat 跨语言交流工具 VRCT 使用指南
  • Trae 编辑器 C++ 编译环境配置实战
  • Pi0 机器人大模型在昇腾 A2 上的部署与性能测评
  • 企业构建 AI 大模型应用的步骤流程与关键问题解析
  • Spring Boot 结合 Leaflet 实现省级旅游口号 WebGIS 可视化

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online