一、安装前准备:清理旧版残留
系统可能预装旧版 Docker 组件(如 docker.io),容易与新版冲突,建议先彻底清理。
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)
说明:若提示'dpkg: no packages found matching...',说明系统无旧版组件,可直接进入下一步,属于正常现象。
二、正式安装:分步操作指南
步骤 1:安装必要依赖包
安装 HTTPS 传输所需证书、下载工具及密钥管理工具,确保后续源配置和软件安装顺利。
sudo apt update && sudo apt install -y ca-certificates curl gnupg
作用解析:
ca-certificates:验证 SSL 证书,保障 HTTPS 下载安全curl:轻量下载工具,用于获取 Docker 官方密钥gnupg:密钥加密与签名工具,验证软件包完整性
步骤 2:添加阿里云 Docker 源与 GPG 密钥
使用阿里云镜像源替代官方源,大幅提升下载速度,同时添加密钥确保软件包可信。
# 创建密钥存储目录并设置权限
sudo install -m 0755 -d /etc/apt/keyrings
# 下载阿里云 Docker GPG 密钥并转换为二进制格式
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
# 赋予密钥文件可读权限,确保 APT 能正常校验
sudo chmod a+r /etc/apt/keyrings/docker.gpg
接着添加阿里云 Docker 软件源,自动适配系统架构和版本:
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
步骤 3:更新源并安装 Docker Engine
更新 APT 缓存使新源生效,随后安装 Docker 全套组件(含核心服务、命令行工具、Compose 插件等)。

