Docker 已成为现代 Linux 服务器的基础组件之一，无论是部署应用、搭建开发环境，还是运行自动化服务，Docker 都是高频工具。本文将系统性介绍如何在 Debian 与 Ubuntu 系统上正确安装 Docker，并解释关键步骤与常见问题。
一、安装前的基本要求
在开始之前，请确认：
✔ 系统为 Debian / Ubuntu
✔ 拥有 root 权限或 sudo 权限
✔ 系统可以访问外网（Docker 官方源）
查看系统版本：
或：
Ubuntu 安装 Docker
Ubuntu 必须使用 Docker 官方仓库，不要使用系统默认仓库（版本通常较旧）。
1️⃣ 更新系统
2️⃣ 安装依赖包
这些包用于安全仓库通信。
3️⃣ 添加 Docker GPG Key
4️⃣ 添加 Docker 官方仓库
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \ https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" \ | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
更新索引：
5️⃣ 安装 Docker
6️⃣ 启动 Docker
验证：
Debian 安装 Docker
⚠ Debian 与 Ubuntu 仓库 不能混用，必须使用 Debian 专用源。
1️⃣ 更新系统
2️⃣ 安装依赖
3️⃣ 添加 Docker GPG Key
sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/debian/gpg \ | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
4️⃣ 添加 Debian Docker 仓库
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \ https://download.docker.com/linux/debian \ $(lsb_release -cs) stable" \ | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
更新索引：
5️⃣ 安装 Docker
6️⃣ 启动 Docker
验证：
常见问题排查
❌ 1. docker: command not found
原因：
✔ Docker 未安装
✔ PATH 未刷新
解决：
或重新登录 SSH。
❌ 2. unable to resolve host
典型错误：
原因：主机名未写入 /etc/hosts
修复：
添加：
❌ 3. Docker 仓库 404 错误
典型错误：
原因：
✔ Debian 使用了 Ubuntu 仓库
✔ 版本代号不匹配
核心原则：
✅ Ubuntu → ubuntu 源
✅ Debian → debian 源
安装完成后的建议配置
允许非 root 用户运行 Docker
重新登录生效。
测试 Docker
如果看到欢迎信息 → 安装成功。
总结
Docker 安装失败的核心原因通常是：
✔ 仓库选错（最常见）
✔ 系统版本识别错误
✔ 网络问题
只要遵循一个原则即可避免大多数问题：
Debian 与 Ubuntu 必须使用各自官方 Docker 仓库
