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

Ubuntu 系统 Docker 完整安装及国内镜像加速配置

Ubuntu 系统 Docker 安装流程涵盖环境清理、依赖安装、阿里云源配置及镜像加速设置。首先移除旧版 Docker 组件避免冲突,随后安装 ca-certificates 等依赖并添加阿里云 GPG 密钥与软件源。通过配置七牛云镜像加速解决国内网络拉取慢的问题,最后运行 hello-world 验证服务状态。该方案适配 Ubuntu Jammy 及以上版本,命令可直接执行。

人间失格发布于 2026/2/21更新于 2026/9/972 浏览

一、安装前准备:清理旧版残留

系统可能预装旧版 Docker 组件(如 docker.io),容易与新版冲突,建议先彻底清理。

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)

说明:若提示'dpkg: no packages found matching...',说明系统无旧版组件,可直接进入下一步,属于正常现象。

二、正式安装:分步操作指南

步骤 1:安装必要依赖包

安装 HTTPS 传输所需证书、下载工具及密钥管理工具,确保后续源配置和软件安装顺利。

sudo apt update && sudo apt install -y ca-certificates curl gnupg

作用解析:

  • ca-certificates:验证 SSL 证书,保障 HTTPS 下载安全
  • curl:轻量下载工具,用于获取 Docker 官方密钥
  • gnupg:密钥加密与签名工具,验证软件包完整性

步骤 2:添加阿里云 Docker 源与 GPG 密钥

使用阿里云镜像源替代官方源,大幅提升下载速度,同时添加密钥确保软件包可信。

# 创建密钥存储目录并设置权限
sudo install -m 0755 -d /etc/apt/keyrings

# 下载阿里云 Docker GPG 密钥并转换为二进制格式
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 赋予密钥文件可读权限,确保 APT 能正常校验
sudo chmod a+r /etc/apt/keyrings/docker.gpg

接着添加阿里云 Docker 软件源,自动适配系统架构和版本:

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

步骤 3:更新源并安装 Docker Engine

更新 APT 缓存使新源生效,随后安装 Docker 全套组件(含核心服务、命令行工具、Compose 插件等)。

# 更新 APT 缓存
sudo apt update

# 安装 Docker 全套组件
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

组件说明:

  • docker-ce:Docker 社区版核心服务,最稳定的开源版本
  • docker-ce-cli:Docker 命令行客户端,用于执行 docker 命令
  • containerd.io:容器运行时,负责容器的创建、启动和管理
  • docker-compose-plugin:新版 Compose 插件,支持容器编排

三、关键配置:国内镜像加速

Docker 默认拉取 Docker Hub 镜像,国内网络访问缓慢,配置七牛云镜像加速可提升 3-5 倍速度。

# 启动 Docker 服务并设置开机自启
sudo systemctl enable --now docker

# 写入七牛云镜像加速配置(单行格式,避免缩进问题)
sudo tee /etc/docker/daemon.json <<-'EOF'
{"registry-mirrors":["https://reg-mirror.qiniu.com/"]}
EOF

# 重启 Docker 服务使配置生效
sudo systemctl restart docker

验证加速配置是否生效:

sudo docker info | grep -i mirror

若输出包含'https://reg-mirror.qiniu.com/',说明配置成功。

备选镜像源: 若七牛云加速效果不佳,可替换为以下源(多源用英文逗号分隔):

  • 阿里云:https://<专属地址>.mirror.aliyuncs.com(需登录阿里云控制台获取)
  • 腾讯云:https://mirror.ccs.tencentyun.com
  • 网易云:https://hub-mirror.c.163.com

四、安装验证:运行 Hello World 容器

通过运行测试容器,验证 Docker 是否正常工作。

sudo docker run hello-world

成功标志:终端输出以下内容,说明 Docker 安装、配置均正常:

Hello from Docker! This message shows that your installation appears to be working correctly.

目录

  1. 一、安装前准备:清理旧版残留
  2. 二、正式安装:分步操作指南
  3. 步骤 1:安装必要依赖包
  4. 步骤 2:添加阿里云 Docker 源与 GPG 密钥
  5. 创建密钥存储目录并设置权限
  6. 下载阿里云 Docker GPG 密钥并转换为二进制格式
  7. 赋予密钥文件可读权限,确保 APT 能正常校验
  8. 步骤 3:更新源并安装 Docker Engine
  9. 更新 APT 缓存
  10. 安装 Docker 全套组件
  11. 三、关键配置:国内镜像加速
  12. 启动 Docker 服务并设置开机自启
  13. 写入七牛云镜像加速配置(单行格式,避免缩进问题)
  14. 重启 Docker 服务使配置生效
  15. 四、安装验证:运行 Hello World 容器

更多推荐文章

查看全部
  • Redis 安装与配置教程 (Windows, Linux, macOS)
  • OpenCode 与 GitHub Copilot 生产环境落地对比评测
  • 前端 Base64 格式文件上传详解:原理、实现与最佳实践
  • 基于 Flux 模型的本地 AI 绘画部署与使用指南
  • Java 使用 Jackson 解析 JSON 数据示例
  • 吴恩达《AI for Everyone》课程笔记:从机器学习到企业转型
  • Flutter 三方库 discord_interactions 的鸿蒙化适配指南
  • Java I/O 操作详解
  • Qwen-Image-Edit-2511 发布:AI 图像编辑模型功能与使用指南
  • 深入理解强化学习:近端策略优化(PPO)算法详解
  • OpenClaw Gateway 连接异常排查与 Token 重置指南
  • Meson:现代 C/C++ 构建系统详解
  • Discord 机器人创建与配置完整流程
  • 最长有效括号:Python 动态规划解法
  • Trae AI 辅助编程实战指南:从入门到提效
  • AI 中的 Skills 详解:核心机制与场景应用
  • 小米温湿度计智能家居改造:ATC 固件刷写与 HA 集成
  • 国内大模型市场发展现状、技术架构与人才需求分析
  • AIGC 技术在元宇宙与虚拟世界中的应用
  • 2026 年各大高校 AIGC 检测政策汇总

相关免费在线工具

  • 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