Debian Docker 安装指南 – wiki大全


Debian Docker 安装指南

Docker 是一种开源平台,用于开发、发布和运行应用程序。它通过将应用程序及其所有依赖项打包到称为容器的标准化单元中,从而实现了快速、一致和可靠的部署。本指南将详细介绍如何在 Debian 系统上安装 Docker Engine。

前提条件

在开始安装之前,请确保您的 Debian 系统满足以下要求:

  • 操作系统: 官方支持 Debian 11 (“Bullseye”)、Debian 12 (“Bookworm”) 或 Debian 13 (“Trixie”)。
  • 用户权限: 您需要具有 sudo 权限的用户或者 root 访问权限。
  • 互联网连接: 安装过程中需要下载软件包。

推荐的安装方法:使用 Docker 官方 APT 存储库

Docker 官方推荐使用其 APT 存储库进行安装,这样可以确保您始终获得最新版本的 Docker Engine,并且能够方便地接收更新。

步骤 1:更新系统软件包索引

首先,更新您的 Debian 系统软件包索引,以确保您拥有最新的可用软件包信息。

bash
sudo apt update

步骤 2:安装必要的软件包

安装允许 apt 通过 HTTPS 使用存储库并处理 GPG 密钥的软件包。

bash
sudo apt install ca-certificates curl gnupg -y

步骤 3:添加 Docker 的官方 GPG 密钥

Docker 使用 GPG 密钥对其软件包进行签名,以确保其真实性和完整性。您需要首先创建一个用于存储密钥的目录,然后下载并添加 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

4:设置 Docker APT 存储库

将官方 Docker 存储库添加到您系统的 APT 源列表中。此命令会自动检测您的 Debian 版本的代号。

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

添加存储库后,再次更新 apt 软件包索引以包含新的 Docker 存储库信息。

bash
sudo apt update

步骤 5:安装 Docker Engine、CLI 和 Containerd

现在,您可以安装 Docker 的核心组件。您可以选择性地包含 docker-buildx-plugindocker-compose-plugin 以获得增强功能,例如多平台构建和使用 Compose 文件定义和运行多容器 Docker 应用程序。

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

步骤 6:验证 Docker 安装

安装完成后,验证 Docker 服务是否正在运行以及您是否可以执行 Docker 命令。

首先,检查 Docker 服务的状态:

bash
sudo systemctl status docker

您应该看到服务处于“active (running)”状态。

接下来,运行一个简单的 hello-world 容器来验证安装是否成功:

bash
sudo docker run hello-world

如果安装成功,此命令会下载一个测试镜像并在一个容器中运行它,然后打印一条消息,表明您的 Docker 安装已正常工作。

安装后的推荐步骤

为了提高使用便利性和安全性,建议执行以下安装后配置。

将当前用户添加到 docker 用户组(非 root 用户管理 Docker)

默认情况下,运行 Docker 命令需要使用 sudo。为了允许非 root 用户执行 Docker 命令,您可以将您的用户添加到 docker 用户组。

bash
sudo usermod -aG docker $USER

重要提示:
为了使此更改生效,您需要注销并重新登录您的会话,或者重启您的系统。


滚动至顶部