🚀 Docker 零基础安装教程：含国内源配置，10 分钟搞定（通用稳定版）
兄弟们！想玩 Docker 项目，第一步必须先装 Docker！但国内直接连 Docker 官方源大概率 “拉取超时”，这篇教程把 “换国内源” 作为核心步骤提前安排，不管你用阿里云、腾讯云还是本地虚拟机，命令直接复制粘贴，我在 Ubuntu 20.04/22.04、Debian 10/11 上实测，零翻车，新手完全不用怕！
先跟大家说句实在的：Docker 安装的核心坑就是 “源速度慢”，其次才是依赖冲突、权限问题。这篇教程把国内源配置嵌在安装流程里，跟着走，装 Docker、拉镜像都能秒完成！
🔍 一、先搞懂：Docker 是啥？为啥必须换国内源？
1. Docker 到底能干嘛？（新手必知实用场景）
📦 快速部署应用：直播工具、节点面板、网站、云盘，用 Docker 装只要几条命令，不用配复杂环境；
🚫 隔离环境不冲突：Python 3.8 容器和系统 Python 3.10 不打架，删容器不留垃圾；
⚡ 轻量化省资源：1 核 1G 服务器能跑 3-4 个 Docker 应用，比虚拟机省资源；
🔄 跨平台方便：电脑配好的应用，复制到服务器就能用，不用重新适配。
2. 为啥必须换国内源？（新手踩坑重灾区）
🚀 解决拉取超时：Docker 官方源在国外，国内访问经常 “context deadline exceeded”（超时），换源后速度从 “几 KB/s” 变 “几 MB/s”；
📌 稳定不丢包：国内源（网易、中科大等）经过 CDN 加速，拉取镜像不易中断；
🛠️ 适配所有操作：换源后不管装 Docker 本身、拉 Portainer 镜像，还是部署 Nginx，都能走国内通道，全程顺畅。
📦 二、提前准备：3 样东西必须有！
部署前 1 分钟确认完，别等会儿卡壳：
✅ 符合要求的系统：Ubuntu 20.04+/Debian 10+（64 位！执行
uname -m输出 “x86_64” 才行）；✅ sudo 权限：普通用户输
sudo ls能执行，root 用户直接用；✅ 能访问国内网：不用科学上网，能连网易、中科大源就行（手机热点也可）。
🚀 三、开始安装：6 步搞定（含国内源配置），命令直接复制！
全程核心逻辑：清理旧版本→装依赖→加官方密钥→配国内 apt 源→装 Docker→配国内镜像源，每步带成功标志和报错处理，复制命令就行！
1. 第一步：清理旧版本 Docker（避免冲突，必做！）
\# 卸载旧版本组件
sudo apt-get remove docker docker-engine docker.io containerd runc
\# 清理残留数据
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
🟢 成功标志：无红色报错（没装过提示 “未找到软件包” 正常）。
2. 第二步：安装必要依赖包（支持 HTTPS 源）
sudo apt-get update && sudo apt-get install -y \\
  ca-certificates \\
  curl \\
  gnupg \\
  lsb-release
🟢 成功标志：显示 “正在设置”“已安装”；
🔴 报错处理：“无法定位软件包” 就再执行sudo apt-get update刷新。
3. 第三步：添加 Docker 官方 GPG 密钥（验证包完整性）
\# 创建密钥目录
sudo mkdir -p /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
📸 【图片 1：Docker GPG 密钥添加成功界面】
🖼-----------------------------------------------🖼
| |
| 红框标注：终端无红色报错，直接返回命令提示符 |
| （类似 “user@server:~$”） |
| 下方文字说明：此界面代表密钥添加成功，可进下一步 |
| 配置国内 apt 源 |
| |
| |
🖼-----------------------------------------------🖼
4. 第四步：配置 Docker 国内 apt 源（装 Docker 走国内通道）
👉 Ubuntu 用户执行：
echo "deb \[arch=\$(dpkg --print-architecture) signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu \\
  \$(lsb\_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
👉 Debian 用户执行：
echo "deb \[arch=\$(dpkg --print-architecture) signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://mirrors.ustc.edu.cn/docker-ce/linux/debian \\
  \$(lsb\_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
⚠️ 用中科大国内 apt 源（替代官方源），装 Docker 时直接从国内下载，速度快 10 倍！
📸 【图片 2：Docker 国内 apt 源配置验证界面】
🖼-----------------------------------------------🖼
| |
| 红框标注：执行cat /etc/apt/sources.list.d/docker.list|
| 输出含 “mirrors.ustc.edu.cn/docker-ce” 的仓库地址 |
| 下方文字说明：输出国内源地址，证明 apt 源配置成功， |
| 装 Docker 时会走国内通道 |
| |
| |
🖼-----------------------------------------------🖼
5. 第五步：安装 Docker 核心组件
\# 更新apt缓存（识别国内源）
sudo apt-get update
\# 安装Docker（自动装最新稳定版）
sudo apt-get install -y docker-ce docker-ce-cli containerd.io
🟢 成功标志：显示 “docker-ce 已安装”“设置 containerd.io …”；
🔴 报错处理：依赖错误就执行sudo apt-get upgrade -y更新系统。
📸 【图片 3：Docker 安装完成界面】
🖼-----------------------------------------------🖼
| |
| 红框标注：“docker-ce (版本号) 已安装”“设置 |
| docker-ce-cli …” 等提示文字 |
| 下方文字说明：看到 “已安装” 代表 Docker 核心组件装好了， |
| 下一步配镜像源就能拉取应用了 |
| |
| |
🖼-----------------------------------------------🖼
6. 第六步：配置 Docker 国内镜像源（拉应用镜像走国内通道）
这是解决 “拉取超时” 的关键！执行命令创建配置文件：
\# 创建Docker配置目录
sudo mkdir -p /etc/docker
\# 写入国内镜像源（网易+中科大+百度，3个源更稳定）
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": \["https://hub-mirror.c.163.com", "https://docker.mirrors.ustc.edu.cn", "https://mirror.baidubce.com"]
}
EOF
\# 重启Docker使配置生效
sudo systemctl daemon-reload
sudo systemctl restart docker
验证镜像源是否生效：
docker info
🟢 成功标志：输出中 “Registry Mirrors” 项列出刚才配置的 3 个国内源。
📸 【图片 4：Docker 镜像源验证成功界面】
🖼-----------------------------------------------🖼
| |
| 红框标注：docker info输出中 “Registry Mirrors” 下方 |
| 列出 “https://hub-mirror.c.163.com” 等国内源地址 |
| 下方文字说明：出现国内源列表，证明镜像源配置成功， |
| 拉取 Portainer、Nginx 等镜像会走国内通道，不超时 |
| |
| |
🖼-----------------------------------------------🖼
🔧 四、启动与验证：确保 Docker 能用（新手必做！）
1. 启动 Docker 并设开机自启
sudo systemctl start docker
sudo systemctl enable docker
🟢 验证：sudo systemctl status docker显示绿色 “active (running)”。
📸 【图片 5：Docker 服务运行状态界面】
🖼-----------------------------------------------🖼
| |
| 红框标注：“Active: active (running) since …” |
| （“active (running)” 为绿色字体） |
| 下方文字说明：绿色运行状态代表 Docker 服务正常，且已 |
| 配置国内源，可直接装 Portainer 等应用 |
| |
| |
🖼-----------------------------------------------🖼
2. 测试镜像拉取（验证国内源效果）
docker run hello-world
🟢 成功标志：秒拉取，输出 “Hello from Docker!”（无超时提示）。
🆙 五、进阶优化：普通用户免 sudo 用 Docker（推荐！）
sudo groupadd docker
sudo usermod -aG docker \$USER
newgrp docker
🟢 验证：docker run hello-world（不加 sudo）正常输出，配置生效。
❌ 六、避坑指南：国内源配置常见问题！
1. 镜像源配置后仍超时？
🔴 原因：配置文件格式错（少逗号 / 引号），或没重启 Docker；
🟢 解决：用cat /etc/docker/daemon.json检查格式，重新执行daemon-reload && restart docker。
2. apt 源配置后无法更新？
🔴 原因：系统版本代号错（如 Ubuntu 22.04 代号 “jammy”）；
🟢 解决：执行lsb_release -cs获取正确代号，重新配置 apt 源。
3. 提示 “permission denied”？
🔴 原因：普通用户没 docker 组权限；
🟢 解决：重新执行 “免 sudo” 步骤，注销再登录。
要是安装遇到问题，评论区留言，我看到就回复！后续分享 Portainer 可视化管理教程，关注我，新手变高手！
📚 参考资料
Docker 官方安装文档：https://docs.docker.com/engine/install/ubuntu/
中科大 Docker 源说明：https://mirrors.ustc.edu.cn/help/docker-ce.html
Docker 镜像源配置指南：https://docs.docker.com/registry/recipes/mirror/
Ubuntu 用户组配置：https://help.ubuntu.com/community/AddingUsers
评论区