如何在Debian系统上安装Docker完整教程

本文将指导如何在 Debian 系统上安装 Docker,并完成基本的配置和验证。

准备工作

确保您已经拥有一个安装好的 Debian 系统,并且具有 root 或 sudo 权限。以下步骤假设您使用的是 Debian 11 (Bullseye) 或更高版本。

更新系统

在开始安装之前,建议先更新系统的包列表和已安装的包。

sudo apt update
sudo apt upgrade -y

安装必要的依赖

Docker 需要一些依赖包才能正确安装和运行。

sudo apt install -y apt-transport-https ca-certificates curl gnupg2 software-properties-common

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

更新包列表

添加完 GPG 密钥后,需要更新包列表以包含 Docker 官方仓库。

sudo apt update

安装 Docker Engine

使用以下命令安装 Docker Engine。

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

验证 Docker 安装

安装完成后,可以通过运行以下命令来验证 Docker 是否安装成功。

sudo docker --version

如果安装成功,命令行将输出 Docker 的版本信息。

配置 Docker 以允许非 root 用户运行

默认情况下,只有 root 用户可以运行 Docker 命令。为了方便普通用户使用,可以将用户添加到 docker 组。

sudo usermod -aG docker ${USER}
sudo systemctl restart docker

添加用户后,需要注销并重新登录,或者使用以下命令立即生效。

newgrp docker

运行一个简单的 Docker 容器

验证 Docker 配置是否正确,可以通过运行一个简单的镜像来测试。

如何在Debian系统上安装Docker完整教程

sudo docker run hello-world

如果一切正常,该命令将下载 hello-world 镜像并运行一个容器,输出 Docker 的欢迎信息。

查看 Docker 日志

如果遇到问题,可以通过查看 Docker 的日志来排查。

sudo journalctl -u docker.service

卸载 Docker

如果需要卸载 Docker,可以使用以下命令。

sudo apt purge -y docker-ce docker-ce-cli containerd.io
sudo apt autoremove -y
sudo rm /usr/share/keyrings/docker-archive-keyring.gpg
sudo rm /etc/apt/sources.list.d/docker.list