Debian 安装 Docker

本文介绍在 Debian 系统上安装 Docker Engine 的方法。

系统要求

Docker Engine 支持以下 Debian 版本（64位）：

• Debian 12（Bookworm）
• Debian 11（Bullseye）

通过官方 APT 仓库安装

第一步：卸载旧版本

for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do
  sudo apt-get remove $pkg
done

第二步：添加 Docker GPG 密钥和仓库

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

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg \
  -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

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

sudo apt-get update

第三步：安装 Docker Engine

sudo apt-get install -y \
  docker-ce \
  docker-ce-cli \
  containerd.io \
  docker-buildx-plugin \
  docker-compose-plugin

第四步：验证安装

sudo docker run hello-world

使用国内镜像源

网络受限时，使用阿里云镜像源：

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

sudo install -m 0755 -d /etc/apt/keyrings
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

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

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

安装后配置

免 sudo 使用 Docker

sudo usermod -aG docker $USER
newgrp docker

设置开机自启

sudo systemctl enable docker
sudo systemctl start docker

配置镜像加速

sudo tee /etc/docker/daemon.json <<EOF
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerhub.icu"
  ]
}
EOF

sudo systemctl daemon-reload
sudo systemctl restart docker

卸载 Docker

sudo apt-get purge docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

总结

Debian 的安装流程与 Ubuntu 基本一致，区别在于仓库 URL 中使用 debian 而非 ubuntu。安装完成后同样建议配置免 sudo、开机自启和镜像加速。