以下是完整的 Ubuntu 24.04 使用清华源安装 Docker 的 Markdown 文档,包括所有遇到的问题及其解决方案。
📌 前言
本教程适用于 Ubuntu 24.04(Noble Numbat),由于 Docker 官方 尚未提供 Ubuntu 24.04 的官方支持,我们将使用 Ubuntu 22.04(Jammy)的 Docker 源 进行安装,并解决可能遇到的 GPG 密钥错误 和 软件包找不到的问题。
📌 目录
- 检查 Ubuntu 版本
- 删除旧的 Docker APT 源
- 添加 Docker GPG 密钥
- 添加清华大学 Docker APT 源
- 更新 APT 软件包索引
- 安装 Docker
- 验证 Docker 是否安装成功
- 运行测试容器
- (可选)配置国内镜像加速
- (可选)安装 Docker Compose
- (可选)将当前用户加入 Docker 组
- 卸载 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/gpg | sudo 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 |
安装 Docker | sudo 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 的正式支持。
- 如果安装过程中遇到问题,请提供 完整的错误信息,我会帮助你解决!🚀