本文将指导如何在 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 配置是否正确,可以通过运行一个简单的镜像来测试。
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