我在帮很多Debian用户解决Docker安装问题时，遇到过不少典型报错，下面整理了最常见的几种情况和对应的解决办法，你可以对照自己的报错信息来排查：

1. 依赖包冲突/缺失导致安装失败 #

这是最常见的问题，执行sudo apt install docker-ce时经常会提示“无法满足依赖”或者某包版本不兼容。

解决步骤：

• 先彻底清理旧版Docker残留（如果之前装过非官方版本）：

  sudo apt remove -y docker docker-engine docker.io containerd runc
  sudo apt autoremove -y && sudo apt clean
  

• 更新系统包索引并升级现有包：

  sudo apt update && sudo apt upgrade -y
  

• 重新配置Docker官方仓库（确保用的是官方源，而不是系统默认的旧源）：

  # 导入官方GPG密钥
  curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
  # 添加稳定版仓库
  echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  

• 再次更新索引后安装完整的Docker套件：

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

2. 内核版本过低引发的兼容性报错 #

Docker对Debian的内核版本有最低要求：Debian 10（Buster）需要内核4.19+，Debian 9（Stretch）需要4.9+，如果你的内核版本低于这个标准，安装时会出现报错。

解决步骤：

• 先检查当前内核版本：

  uname -r
  

• 如果版本不达标，升级内核（以Debian 9为例，其他版本类似）：

  # 添加backports仓库
  echo "deb http://deb.debian.org/debian stretch-backports main" | sudo tee /etc/apt/sources.list.d/stretch-backports.list
  # 安装新内核
  sudo apt update && sudo apt -t stretch-backports install linux-image-amd64
  # 重启系统生效
  sudo reboot
  

• 重启后再次验证内核版本，然后重新执行Docker安装命令。

3. GPG密钥验证失败报错 #

安装时出现类似“The following signatures couldn't be verified because the public key is not available: NO_PUBKEY XXXXXXXX”的报错，说明Docker仓库的密钥未正确导入。

解决步骤：

• 重新导入官方密钥并确保权限正确：

  curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
  sudo chmod a+r /usr/share/keyrings/docker-archive-keyring.gpg
  

• 重新更新包索引：

  sudo apt update
  

• 再次尝试安装Docker。

额外调试建议 #

如果以上方法都没解决问题，你可以：

• 执行sudo apt install docker-ce -f强制修复依赖，查看详细的错误提示
• 查看/var/log/apt/term.log日志文件，里面会记录更具体的安装失败原因，方便进一步排查

内容的提问来源于stack exchange，提问作者Felix D.