debian 安装 docker

在 Debian 系统上安装 Docker 可以按照以下步骤进行：

1、更新软件包列表：

打开终端并运行以下命令以确保您的包管理器的列表是最新的：

     sudo apt update

2、安装必要的软件包：

在安装 Docker 之前，需要确保系统已安装一些必需的软件包，这些包帮助apt 通过 HTTPS 使用仓库：

     sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release

3、添加 Docker 的官方 GPG 密钥：

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

     curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

这一步会下载 Docker 的公钥，并使用gpg --dearmor 命令将其转换为适用于apt 的格式，存储在/usr/share/keyrings 目录下。

4、设置 Docker 稳定版仓库：

将 Docker 的仓库地址添加到系统的apt 源列表中，创建一个新的文件docker.list 在/etc/apt/sources.list.d/ 目录下：

     echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

这个命令做了以下几件事：

使用echo 命令构造源配置字符串。

$(dpkg --print-architecture) 获取系统架构。

$(lsb_release -cs) 获取当前 Debian 发行版的代号。

tee 命令将这些信息写入/etc/apt/sources.list.d/docker.list 文件中，以便apt 可以读取这个新的源。

5、再次更新软件包列表：

添加了新的源之后，再次更新包列表以确保apt 知道新添加的源：

     sudo apt update

6、安装 Docker Engine：

可以安装最新版本的 Docker Engine 及其依赖：

     sudo apt install docker-ce docker-ce-cli containerd.io

7、验证 Docker 安装：

安装完成后，检查 Docker 是否正确安装并运行：

     sudo systemctl status docker

你还可以运行一个测试容器来验证 Docker 的安装：

     sudo docker run hello-world

8、（可选）允许非 root 用户执行 Docker 命令：

如果你希望非 root 用户也能运行 Docker 命令，可以将用户添加到docker 组：

     sudo usermod -aG docker $USER

注销并重新登录，或者重启计算机以应用这些更改。

FAQs

Q1: 如果遇到“E: Type ‘echo’ is not known on line 1 in source list /etc/apt/sources.list.d/docker.list”错误怎么办？

A1: 这个错误通常意味着在创建/etc/apt/sources.list.d/docker.list 文件时，命令的输出格式存在问题，使得 APT 无法正确解析文件，这可能是由于命令格式或执行方式导致的，为确保没有其他干扰因素，可以用一个更简单、直接的方法手动添加所需的仓库，创建或修改docker.list 文件：

手动编辑docker.list 文件：

打开终端，使用一个文本编辑器手动打开或创建docker.list 文件，这里我们使用nano，你也可以使用任何你熟悉的文本编辑器，比如vim 或gedit。

运行以下命令：

       sudo nano /etc/apt/sources.list.d/docker.list

手动输入以下内容，替换<your_debian_version> 为你的 Debian 版本代号，比如buster,stretch,bullseye 等，如果你不确定你的 Debian 版本，可以通过运行lsb_release -cs 来查看：

       deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian <your_debian_version> stable

确保你手动输入这行内容，不要复制粘贴命令输出，这样可以避免潜在的格式或隐藏字符问题。

保存并关闭文件：

如果你使用nano 编辑器，按Ctrl+X 退出编辑器，然后按Y 确认保存更改，最后按Enter 保存文件。

更新 APT 源：

更新你的软件包列表，确保没有错误：

       sudo apt update

如果在执行sudo apt update 时没有报错，说明你的docker.list 文件已经正确设置，APT 能够识别和处理这个新的源。

Q2: 如何验证 Docker 是否成功安装？

A2: 安装完成后，可以通过以下步骤验证 Docker 是否成功安装：

检查 Docker 服务状态：

     sudo systemctl status docker

如果看到类似于“active (running)”的状态信息，则说明 Docker 服务正在运行。

运行测试容器：

     sudo docker run hello-world

如果一切正常，你应该会看到输出信息表明容器正在运行，并且会显示一些关于 Docker 客户端和服务器的信息。