ubuntu安装docker

Ubuntu 25.04 安装docker

一、卸载旧版本

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

二、获取软件最新源

sudo apt-get update

三、安装 apt 依赖包

用于通过HTTPS来获取仓库

sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common

四、安装GPG证书

因为Ubuntu 22.04 开始，系统已弃用 apt-key 命令。直接将密钥添加到全局可信密钥环的做法不再被推荐，取而代之的是将每个仓库的密钥单独存放在 /etc/apt/trusted.gpg.d/ 目录。

方法一：Docker官方推荐路径（推荐）

此方法将密钥存放在/etc/apt/keyrings/目录，是目前许多官方软件源推荐的方式。

# 创建密钥环目录
sudo install -m 0755 -d /etc/apt/keyrings
# 下载Docker官方GPG密钥
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
# 设置密钥文件权限
sudo chmod a+r /etc/apt/keyrings/docker.asc

方法二：Ubuntu系统兼容路径

此方法将转换后的密钥存放在Ubuntu传统的/etc/apt/trusted.gpg.d/目录。

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg

五、添加Docker APT仓库

添加仓库时，使用 signed-by 参数明确指定上一步下载的密钥文件路径。

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://aliyun.com/docker-ce/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list

备注：若出现重复配置报错使用以下解决方案：

步骤1：查看现有的Docker源文件

首先，让我们查看这两个文件的内容：

cat /etc/apt/sources.list.d/archive_uri-https_mirrors_aliyun_com_docker-ce_linux_ubuntu-noble.list
cat /etc/apt/sources.list.d/docker.list

步骤2：删除重复的源文件（推荐）

保留一个配置正确的源文件，删除另一个。通常建议保留你手动创建的docker.list，删除自动生成的那个：

rm /etc/apt/sources.list.d/archive_uri-https_mirrors_aliyun_com_docker-ce_linux_ubuntu-noble.list

步骤3：验证并更新

删除重复源后，更新APT包列表：

sudo apt-get update

现在重复配置的警告应该消失了。

六、安装docker

apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

🔍 验证配置

安装完成后，验证Docker是否正常工作：

sudo docker --version
sudo docker run hello-world

💡 预防重复配置的建议

在添加新源前检查现有配置：

ls -la /etc/apt/sources.list.d/ | grep docker
docker info