Debian 上安装 Docker 教程 – wiki词典

作者： /

在 Debian 上安装 Docker 的详细教程

Docker 是一个开源平台，用于开发、发布和运行应用程序。它通过使用容器来打包应用程序及其所有依赖项，确保应用程序在任何环境中都能一致地运行。本文将详细指导您如何在 Debian 系统上安装 Docker Engine。

前提条件

在开始安装之前，请确保您的 Debian 系统满足以下条件：

  • 操作系统： Debian 10 (Buster), Debian 11 (Bullseye), 或 Debian 12 (Bookworm)。
  • 用户权限： 拥有 sudo 权限的用户。
  • 网络连接： 稳定的互联网连接以下载软件包。

安装步骤

以下是在 Debian 上安装 Docker 的详细步骤：

1. 更新软件包索引并安装必要的工具

首先，更新您的 apt 软件包索引，并安装 Docker 仓库所需的软件包。这些工具包括 ca-certificates、curl 和 gnupg，用于安全地添加 HTTPS 仓库。

bash
sudo apt update
sudo apt install ca-certificates curl gnupg apt-transport-https -y

2. 添加 Docker 的官方 GPG 密钥

为了验证下载的 Docker 软件包的真实性，您需要添加 Docker 的官方 GPG 密钥。

bash
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

  • sudo install -m 0755 -d /etc/apt/keyrings：创建用于存放 GPG 密钥的目录，并设置适当的权限。
  • curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg：下载 Docker 的 GPG 公钥，并使用 gpg --dearmor 命令将其转换为适用于 APT 的格式，然后保存到 /etc/apt/keyrings/docker.gpg。
  • sudo chmod a+r /etc/apt/keyrings/docker.gpg：设置 GPG 密钥文件的读取权限。

3. 设置 Docker 仓库

将 Docker 的官方仓库添加到您的 APT 源列表中。这将允许您的系统从 Docker 官方源获取 Docker 软件包。

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

  • 此命令会根据您的 Debian 版本（例如 bookworm、bullseye）动态构建仓库地址，并将其添加到 /etc/apt/sources.list.d/docker.list 文件中。
  • sudo apt update：在添加仓库后，再次更新软件包索引，以便 APT 能够识别新添加的 Docker 仓库。

4. 安装 Docker Engine

现在，您可以安装 Docker Engine、Docker CLI、containerd 和 Docker Compose 插件。

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

  • docker-ce：Docker 社区版（Community Edition）核心组件。
  • docker-ce-cli：Docker 命令行接口。
  • containerd.io：一个工业标准的容器运行时，Docker 使用它来管理容器的生命周期。
  • docker-buildx-plugin：用于构建多平台 Docker 镜像的插件。
  • docker-compose-plugin：用于定义和运行多容器 Docker 应用程序的工具。

5. 验证安装

安装完成后，您可以通过运行一个简单的 hello-world 镜像来验证 Docker 是否正确安装并正在运行。

bash
sudo docker run hello-world

如果一切正常，您将看到一条消息，表明 Docker 守护进程已成功从 Docker Hub 拉取并运行了 hello-world 镜像，并打印出一条确认信息。

6. 以非 root 用户管理 Docker (推荐)

默认情况下，运行 Docker 命令需要 sudo 权限。为了避免每次都输入 sudo，您可以将当前用户添加到 docker 用户组中。

bash
sudo usermod -aG docker $USER

  • sudo usermod -aG docker $USER：将当前用户 ($USER) 添加到 docker 用户组。
  • 重要： 添加用户到 docker 组后，您需要注销并重新登录您的系统，或者重启您的机器，以便更改生效。

重新登录后，您应该可以在不使用 sudo 的情况下运行 Docker 命令：

bash
docker run hello-world

总结

通过遵循以上步骤，您已经在 Debian 系统上成功安装了 Docker Engine。现在，您可以开始使用 Docker 来构建、运行和管理您的容器化应用程序。

滚动至顶部