Debian Docker 安装教程 – wiki大全

作者： /

Debian Docker 安装教程

Docker 是一个开源平台，用于开发、发布和运行应用程序。通过使用容器，Docker 能够将应用程序及其所有依赖项打包到一个标准化的单元中，确保应用程序在任何环境中都能以相同的方式运行。本教程将指导您如何在 Debian 系统上安装 Docker Engine。

推荐使用 Docker 官方仓库来安装 Docker，以确保您获得最新且受支持的版本。

1. 更新您的 Debian 系统

在安装任何新软件包之前，始终建议更新您的系统，以确保所有现有软件包都是最新版本，并刷新软件包列表。

bash
sudo apt update
sudo apt upgrade -y

2. 安装必要的依赖包

Docker 官方仓库通过 HTTPS 提供，因此需要安装一些工具来允许 apt 通过 HTTPS 访问这些仓库。

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

  • apt-transport-https: 允许 apt 通过 HTTPS 使用软件包仓库。
  • ca-certificates: 允许基于 SSL 的客户端和服务器检查对等方的 SSL 证书。
  • curl: 用于从网络传输数据。
  • gnupg: GNU Privacy Guard，用于验证软件包的 GPG 签名。

3. 添加 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

这几条命令会：
1. 创建一个目录 /etc/apt/keyrings 来存储 GPG 密钥（如果它不存在）。
2. 使用 curl 下载 Docker 的 GPG 密钥。
3. 通过 gpg --dearmor 将密钥转换为 apt 可识别的格式。
4. 将其保存到 /etc/apt/keyrings/docker.gpg。
5. 修改密钥文件的权限，使其可读。

4. 设置 Docker 仓库

现在，您需要将 Docker 官方仓库添加到您的 APT 软件源列表中。

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

这条命令会：
1. 检测您的系统架构 (dpkg --print-architecture)。
2. 获取您的 Debian 版本代号 (. /etc/os-release && echo "$VERSION_CODENAME")，例如 bookworm 或 bullseye。
3. 构建一个指向 Docker 稳定版仓库的 deb 条目。
4. 将此条目写入 /etc/apt/sources.list.d/docker.list 文件中。

添加仓库后，再次更新 apt 软件包索引，以便系统识别新的 Docker 仓库。

bash
sudo apt update

5. 安装 Docker Engine

现在，您可以安装 Docker Engine、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 Engine 社区版。
  • docker-ce-cli: Docker 命令行客户端。
  • containerd.io: 容器运行时，Docker Engine 使用它来管理容器的生命周期。
  • docker-buildx-plugin: Docker Buildx 插件，用于构建多平台镜像。
  • docker-compose-plugin: Docker Compose V2 插件。

6. 验证 Docker 安装

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

bash
sudo docker run hello-world

如果一切正常，此命令将下载一个测试镜像并在容器中运行它。您会看到一条信息性消息，表明您的 Docker 安装工作正常。

您还可以检查 Docker 服务的状态：

bash
sudo systemctl status docker

输出应显示 Docker 服务处于 active (running) 状态。

7. （可选）将 Docker 作为非 Root 用户管理

默认情况下，运行 Docker 命令需要使用 sudo。为了方便，您可以将当前用户添加到 docker 用户组，这样就不需要每次都使用 sudo。

bash
sudo usermod -aG docker $USER

重要提示: 添加用户到 docker 组后，您需要注销并重新登录您的会话，或者重启您的系统，以便更改生效。

重新登录后，您可以尝试不使用 sudo 运行 hello-world 容器：

bash
docker run hello-world

结论

恭喜！您已成功在 Debian 系统上安装并配置了 Docker Engine。现在，您可以开始使用 Docker 来构建、运行和管理您的容器化应用程序了。

滚动至顶部