Ubuntu 24.04 使用清华源安装 Docker 完整指南

rukyli
21
2025-07-30

以下是完整的 Ubuntu 24.04 使用清华源安装 Docker 的 Markdown 文档,包括所有遇到的问题及其解决方案。


📌 前言

本教程适用于 Ubuntu 24.04(Noble Numbat),由于 Docker 官方 尚未提供 Ubuntu 24.04 的官方支持,我们将使用 Ubuntu 22.04(Jammy)的 Docker 源 进行安装,并解决可能遇到的 GPG 密钥错误 和 软件包找不到的问题


📌 目录

  1. 检查 Ubuntu 版本
  2. 删除旧的 Docker APT 源
  3. 添加 Docker GPG 密钥
  4. 添加清华大学 Docker APT 源
  5. 更新 APT 软件包索引
  6. 安装 Docker
  7. 验证 Docker 是否安装成功
  8. 运行测试容器
  9. (可选)配置国内镜像加速
  10. (可选)安装 Docker Compose
  11. (可选)将当前用户加入 Docker 组
  12. 卸载 Docker(如果需要)

🔹检查Ubuntu版本

首先,确认你的 Ubuntu 版本:

lsb_release -a

如果输出类似:

Distributor ID: Ubuntu Description:    Ubuntu 24.04 LTS Release:        24.04 Codename:       noble

说明你的系统是 Ubuntu 24.04,可以继续安装。


🔹 删除旧的DockerAPT源

如果之前添加过 Docker 源,先删除:

sudo rm -f /etc/apt/sources.list.d/docker.list

🔹 添加DockerGPG密钥

由于 Ubuntu 24.04 可能会遇到 GPG 密钥错误(NO_PUBKEY 7EA0A9C3F273FCD8),我们手动添加 Docker 官方 GPG 密钥:

sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo tee /etc/apt/keyrings/docker.asc > /dev/null sudo chmod a+r /etc/apt/keyrings/docker.asc

🔹添加清华大学DockerAPT源

由于 Ubuntu 24.04 还没有官方 Docker 源,我们使用 Ubuntu 22.04(Jammy)的 Docker 源

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu jammy stable" | sudo tee /etc/apt/sources.list.d/docker.list

说明

  • signed-by=/etc/apt/keyrings/docker.asc 让 APT 使用刚刚下载的 GPG 密钥来验证 Docker 软件包。

🔹 更新 APT 软件包索引

sudo apt update

如果这一步 不再报错,说明 GPG 密钥问题已经解决。


🔹 安装 Docker

sudo apt install -y docker-ce docker-ce-cli containerd.io

🔹 验证 Docker 是否安装成功

docker --version

如果安装成功,会输出类似:

Docker version 24.0.5, build 1234567

🔹 运行测试容器

sudo docker run hello-world

如果 Docker 运行正常,会看到类似的输出:

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

🔹 (可选)配置国内镜像加速

由于 Docker Hub 在国内访问较慢,可以使用 清华、阿里云、网易等国内镜像加速器

sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<EOF {   "registry-mirrors": [    "https://mirror.ccs.tencentyun.com",    "https://hub-mirror.c.163.com",    "https://docker.mirrors.ustc.edu.cn",    "https://registry.docker-cn.com",    "https://mirror.baidubce.com"  ] } EOF

然后重启 Docker:

sudo systemctl daemon-reload sudo systemctl restart docker

🔹 (可选)安装 Docker Compose

sudo apt install -y docker-compose

验证安装:

docker-compose --version

🔹 (可选)将当前用户加入 Docker 组

默认情况下,运行 Docker 需要 sudo,如果想要免 sudo 运行 Docker:

sudo usermod -aG docker $USER

然后退出当前终端并重新登录,或者运行:

newgrp docker

测试是否可以免 sudo 运行:

docker ps

🔹 卸载 Docker(如果需要)

如果你想卸载 Docker,可以运行:

sudo apt remove -y docker-ce docker-ce-cli containerd.io sudo apt autoremove -y sudo rm -rf /var/lib/docker sudo rm -rf /var/lib/containerd

🎯 总结

步骤命令作用
检查 Ubuntu 版本lsb_release -a确保是 Ubuntu 24.04
删除旧的 Docker APT 源sudo rm -f /etc/apt/sources.list.d/docker.list清理错误的源
添加 Docker GPG 密钥`curl -fsSL https://download.docker.com/linux/ubuntu/gpgsudo tee /etc/apt/keyrings/docker.asc > /dev/null`
添加清华 Docker APT 源`echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu jammy stable"sudo tee /etc/apt/sources.list.d/docker.list`
更新 APT 软件包索引sudo apt update确保 APT 能找到 Docker
安装 Dockersudo apt install -y docker-ce docker-ce-cli containerd.io安装 Docker
验证安装docker --version确保 Docker 正常运行
运行测试容器sudo docker run hello-world确保 Docker 能运行容器
配置国内镜像加速/etc/docker/daemon.json加快 Docker 拉取镜像速度

🎉 结论

  • Ubuntu 24.04 目前没有官方 Docker 源,所以我们使用 Ubuntu 22.04(Jammy)的 Docker 源 来安装 Docker。
  • 这个方法 大概率可行,但如果遇到兼容性问题,建议等待 Docker 官方发布对 Ubuntu 24.04 的正式支持。
  • 如果安装过程中遇到问题,请提供 完整的错误信息,我会帮助你解决!🚀
动物装饰