Ubuntu上安装Docker遇到错误信息“Package ‘docker-ce‘ has no installat

在 Ubuntu 上敲 apt-get install docker-ce，报一堵墙：E: Package 'docker-ce' has no installation candidate；紧接着装 docker-ce-cli 又是 Unable to locate package。这个报错的字面意思是「你的软件源里没有这个包」，但绝大多数时候并不是源里真没有，而是 apt 的索引没读到 Docker 自己的仓库。本文按「更新索引 → 装依赖 → 加 GPG → 加源 → 再装」的顺序走一遍。

一、先把索引刷出来

no installation candidate 最常见成因就是 apt 的软件包缓存过旧，压根不知道有 Docker 这个源：

sudo apt-get update

如果你用的是新立得或者其他图形工具，也确认一下所有软件库都是启用状态、并且都刷新过。

二、装依赖并加官方 GPG 密钥

Docker 的源走 HTTPS + 签名，先把必备工具装上：

sudo apt-get install ca-certificates curl gnupg lsb-release

然后加 Docker 的官方 GPG 密钥（以国内可访问的镜像地址为例）：

curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -

不签名的源不加密钥也能配，但 apt 会一直警告，生产环境还是老老实实加。

三、把 Docker 的仓库写进去

echo "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list

这里几个点要注意：

• $(lsb_release -cs) 会自动填当前发行版代号（focal、jammy、noble），写死代号在跨版本机器上会直接 404。
• stable 是字面量，不要顺手加引号或改英文标点。
• 架构要和机器对上，arm64 机器要写 [arch=arm64]。
• 国内网络不畅时可以换成清华、中科大的 Docker 镜像源，写法相同，只要把地址换掉、GPG 地址也一起换掉。

四、再刷一次索引，然后装

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

顺序不能反：必须先写源、再 update，索引里才有 docker-ce 这个包名，否则你装一百次还是同一句 no candidate。

五、验证装好没有

sudo docker version
sudo docker info
sudo docker run hello-world

能跑出 hello-world 就说明这条链路通了。docker info 里的 Server Version、Storage Driver 两项值得看一眼，确认引擎真的起来了而不是只有客户端。

六、还是不行就查这四项

• 源里到底有没有包：apt-cache policy docker-ce，有输出说明索引读到了。
• 网络能不能到源：apt-get update -o Debug::Acquire::http=true 看具体哪一步卡住。
• 代号对不对：lsb_release -a 核对。
• 旧包冲突：之前装过旧版本的 docker、docker.io、containerd，先用 apt-get remove docker docker.io containerd 清干净再装。

七、新手最常踩的两个坑

一是直接把阿里云 Ubuntu 通用源那几行贴进 sources.list，很多教程里那三行重复写入的版本其实只是把 main 写了三遍，真正缺的是第三步 Docker 自己的仓库，贴了也没用。二是加了源不去 update，apt 拿的还是三天前的索引，看起来像「源里没有」。记住「加源必 update、update 后才装」，这两步能解决九成 case。

qidao123.com企服评测-应用市场 编辑提示