debian 12上安装docker

在 Debian 12 上安装 Docker 的步骤如下：

1. 卸载旧版本（如有）

sudo apt remove docker docker-engine docker.io containerd runc

2. 安装依赖工具

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

3. 添加 Docker 官方 GPG 密钥

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

4. 设置 Docker 仓库

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

5. 安装 Docker Engine

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

6. 启动 Docker 并设置开机自启

sudo systemctl enable --now docker

7. 验证安装

sudo docker run hello-world

如果看到欢迎信息，说明安装成功。

8. 管理 Docker 用户组（可选）

将当前用户加入 docker 组，避免每次使用 sudo：

sudo usermod -aG docker $USER

退出当前终端重新登录后生效。

9. 检查 Docker 状态

systemctl status docker
docker version

卸载 Docker

sudo apt 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

常见问题

1. 权限问题：执行 docker 命令报错权限不足？
   确保用户已加入 docker 组（见步骤 8），并重新登录终端。
2. 网络问题：拉取镜像慢？
   配置国内镜像源（如阿里云、中科大）：

sudo mkdir -p /etc/docker
echo '{"registry-mirrors": ["https://<你的镜像加速器地址>"]}' | sudo tee /etc/docker/daemon.json
sudo systemctl restart docker

3. 仓库设置失败：
   检查 Debian 代号（如 bookworm）是否在 /etc/apt/sources.list.d/docker.list 中正确写入。

通过以上步骤，你已在 Debian 12 上成功安装 Docker。