- 卸载可能冲突的软件包
删除任何已有的 Docker 软件包以避免冲突:
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done
- 更新软件包索引
确保您的软件包索引是最新的:
sudo apt-get update
- 安装必要的依赖
sudo apt-get install ca-certificates curl
- 添加 Docker 官方 GPG 密钥
添加 Docker 的 GPG 密钥以验证软件包:
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
- 设置 Docker 软件源
将 Docker 官方仓库添加到系统中:
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
- 安装 Docker 软件包
安装 Docker 引擎、命令行工具和 containerd:
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
- 验证 Docker 是否安装成功
运行一个测试容器来确认 Docker 是否安装成功:
sudo docker run hello-world
如果成功,您将看到一条消息,表示 Docker 已正确安装。
- 为非 root 用户启用 Docker 权限
默认情况下,Docker 命令需要使用 sudo
。如果希望普通用户也能运行 Docker 命令,请将当前用户添加到 docker
用户组:
sudo usermod -aG docker $USER
注意:该变更在您退出并重新登录之后才会生效,您也可以选择重启系统:
sudo reboot
重新登录后再次运行测试命令:
docker run hello-world
如果成功,您将看到相同的确认信息,此时不需要使用 sudo。
安全提示:将用户加入 docker 用户组等同于授予该用户 root 权限。在多用户系统中请谨慎操作。