Debian 系统 Docker 安装终极指南（一站式解决网络问题）

本指南提供在 Debian 11 (Bullseye) 和 Debian 12 (Bookworm) 上安装 Docker 的最稳定方法。通过使用国内镜像源，可以彻底解决因网络问题导致的安装失败和镜像拉取缓慢。

第一步：准备工作

1.1 卸载旧版本

为避免冲突，首先卸载系统中可能存在的旧版 Docker。

sudo apt-get remove docker docker-engine docker.io containerd runc
sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

如果提示未找到软件包，请忽略，这说明系统很干净。

1.2 更新系统并安装依赖

更新 apt 软件包索引，并安装 apt 使用 HTTPS 仓库所必需的依赖包。

sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    -y

第二步：添加 Docker 软件源（解决网络问题的关键）

官方源在国内访问不稳定，我们直接使用阿里云的镜像源进行配置。

2.1 添加 Docker 的 GPG 密钥

从阿里云镜像站下载 Docker 的官方 GPG 密钥，以验证软件包的完整性。

# 创建用于存放 GPG 密钥的目录
sudo install -m 0755 -d /etc/apt/keyrings

# 从阿里云镜像下载 GPG 密钥
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 修改密钥文件的权限
sudo chmod a+r /etc/apt/keyrings/docker.gpg

2.2 设置 Docker 的 APT 仓库

将阿里云的 Docker 仓库地址添加到系统的软件源列表中。

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

第三步：安装 Docker Engine

仓库配置完毕，现在可以从镜像源安装 Docker 了。

# 再次更新 apt 包索引，以加载新仓库的包信息
sudo apt-get update

# 安装最新版本的 Docker Engine 及相关组件
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

第四步：后续优化配置（强烈推荐）

4.1 配置用户组免 `sudo` 运行 Docker

为了避免每次执行 docker 命令都输入 sudo，将当前用户添加到 docker 用户组。

sudo usermod -aG docker $USER

重要提示：此命令执行后，您必须退出当前终端会话并重新登录，新的用户组权限才会生效。

4.2 配置 Docker 镜像加速器

安装时解决了软件源问题，现在解决拉取镜像（如 nginx, mysql）时的网络问题。

创建或修改 /etc/docker/daemon.json 文件，写入国内镜像加速器地址。

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live",
    "https://docker.1ms.run",
    "https://registry.cn-hangzhou.aliyuncs.com"
  ]
}
EOF

重启 Docker 服务使配置生效：

sudo systemctl daemon-reload
sudo systemctl restart docker

第五步：验证安装

运行经典的 hello-world 镜像，验证 Docker 是否已正确安装并可以正常工作。

docker run hello-world

如果看到以下输出，恭喜您，Docker 已成功安装并完成网络优化！

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.
...

至此，您已在 Debian 系统上拥有了一个功能完整、网络流畅的 Docker 环境。