落叶的心思的博客

一个记录与折腾的小站

Debian 与 Ubuntu 上 Docker Engine 安装超详细教程

发布时间:

发布者:

分类:

阅读数:

13

点赞数:

0

阅读时长预计:

7 分钟

Linux 的发行版非常多,每个版本的操作可能略有差异。为了让大家更容易上手,这篇教程只以 使用最广泛的 Debian 和 Ubuntu 为例来演示 Docker 的安装和配置。
至于其他的安装方法,如有需求,文末会附上 Docker 官方教程的链接,方便参考。

第一步:Debian 安装教程

1 系统要求

  • Debian Trixie 13(稳定版)
  • Debian Bookworm 12(旧稳定版)
  • Debian Bullseye 11(旧稳定版)

架构:x86_64/amd64、armhf/arm64、ppc64le衍生版如 Kali Linux 可能需要手动替换版本代号。

2 卸载旧版本

在安装前,先卸载可能冲突的旧包:

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-doc podman-docker containerd runc | cut -f1)

这不会删除 /var/lib/docker/ 下的镜像、容器、卷和网络。如果需要全新安装,请手动清理这些数据。

3 设置 Docker APT 仓库

3.1 更新软件包列表

sudo apt update

3.2 安装必要依赖

sudo apt install ca-certificates curl

3.3 创建密钥存放目录

sudo install -m 0755 -d /etc/apt/keyrings

3.4 下载 Docker 官方 GPG 密钥

sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc

3.5 修改密钥权限

sudo chmod a+r /etc/apt/keyrings/docker.asc

3.6 添加 Docker 仓库

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

3.7 更新软件包列表(包含 Docker 仓库)

sudo apt update

4 安装 Docker Engine

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

5 启动并检查 Docker 服务

sudo systemctl status docker

如果未启动,则手动启动:

sudo systemctl start docker

6 验证安装

运行官方测试镜像:

sudo docker run hello-world

出现确认信息表示 Docker 安装成功。

第二步:Ubuntu 安装教程

1 系统要求

  • Ubuntu Questing 25.10
  • Ubuntu Plucky 25.04
  • Ubuntu Noble 24.04 (LTS)
  • Ubuntu Jammy 22.04 (LTS)

架构:x86_64/amd64、armhf/arm64、s390x、ppc64le衍生版如 Linux Mint 可能不完全支持。

2 卸载旧版本

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)

3 设置 Docker APT 仓库

3.1 更新软件包列表

sudo apt update

3.2 安装必要依赖

sudo apt install ca-certificates curl

3.3 创建密钥存放目录

sudo install -m 0755 -d /etc/apt/keyrings

3.4 下载 Docker 官方 GPG 密钥

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

3.5 修改密钥权限

sudo chmod a+r /etc/apt/keyrings/docker.asc

3.6 添加 Docker 仓库

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

3.7 更新软件包列表(包含 Docker 仓库)

sudo apt update

4 安装 Docker Engine

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

5 启动并检查 Docker 服务

sudo systemctl status docker

如果未启动,则手动启动:

sudo systemctl start docker

6 验证安装

sudo docker run hello-world

出现确认信息表示 Docker 安装成功。

第三步:把用户加入 Docker 组

为了让普通用户直接运行 Docker 命令,无需每次加 sudo,需要把用户加入 docker 组。

示例如下:

# 假设你的用户名是 “alice”

sudo usermod -aG docker alice

或者如果你想给当前登录用户加权限,可以直接用:

sudo usermod -aG docker $USER

⚠️ 执行后,需要注销并重新登录,或者执行下面命令让权限立即生效:

newgrp docker

完成后,你可以直接运行 Docker 命令而不加 sudo

docker run hello-world

如果能成功运行并打印确认信息,说明权限设置成功。

第四步:卸载 Docker Engine

1. 卸载相关软件包

卸载步骤如下:

sudo apt purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras

2. 删除 Docker 数据(镜像、容器、卷等)

sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

3. 删除 Docker 软件源和密钥

sudo rm /etc/apt/sources.list.d/docker.sources
sudo rm /etc/apt/keyrings/docker.asc

如果你修改过配置文件,请手动清理。

官方文档:

https://docs.docker.com/engine/install

Docker 高频命令实操手册:

这里跳转

转载声明:

转载此文章请注明出处。

若本文内容侵犯了您的权益,请通过本站下方邮箱与我联系,我会尽快处理,谢谢!

分享到:

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注