一、安装前准备:清理旧版残留
系统可能预装旧版 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 插件等)。
# 更新 APT 缓存
sudo apt update
# 安装 Docker 全套组件
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
组件说明:
docker-ce:Docker 社区版核心服务,最稳定的开源版本docker-ce-cli:Docker 命令行客户端,用于执行 docker 命令containerd.io:容器运行时,负责容器的创建、启动和管理docker-compose-plugin:新版 Compose 插件,支持容器编排
三、关键配置:国内镜像加速
Docker 默认拉取 Docker Hub 镜像,国内网络访问缓慢,配置七牛云镜像加速可提升 3-5 倍速度。
# 启动 Docker 服务并设置开机自启
sudo systemctl enable --now docker
# 写入七牛云镜像加速配置(单行格式,避免缩进问题)
sudo tee /etc/docker/daemon.json <<-'EOF'
{"registry-mirrors":["https://reg-mirror.qiniu.com/"]}
EOF
# 重启 Docker 服务使配置生效
sudo systemctl restart docker
验证加速配置是否生效:
sudo docker info | grep -i mirror
若输出包含'https://reg-mirror.qiniu.com/',说明配置成功。
备选镜像源: 若七牛云加速效果不佳,可替换为以下源(多源用英文逗号分隔):
- 阿里云:https://<专属地址>.mirror.aliyuncs.com(需登录阿里云控制台获取)
- 腾讯云:https://mirror.ccs.tencentyun.com
- 网易云:https://hub-mirror.c.163.com
四、安装验证:运行 Hello World 容器
通过运行测试容器,验证 Docker 是否正常工作。
sudo docker run hello-world
成功标志:终端输出以下内容,说明 Docker 安装、配置均正常:
Hello from Docker! This message shows that your installation appears to be working correctly.
