UBUNTU安装Docker出错时解决方法

kzdq

1. 彻底卸载旧版本 Docker

1. # 清除所有旧版 Docker 和 containerd
   
2. sudo apt remove --purge docker.io docker-compose containerd runc -y
   
3. sudo apt autoremove --purge -y

复制代码

# 删除残留数据和配置

1. sudo rm -rf /var/lib/docker
   
2. sudo rm -rf /var/lib/containerd

复制代码

2. 添加 Docker 官方仓库（适配 ARM64 架构）

1. # 安装依赖工具
   
2. sudo apt update
   
3. sudo apt install ca-certificates curl gnupg lsb-release -y

复制代码

1. # 创建密钥目录并下载 Docker GPG 密钥
   
2. sudo mkdir -p /etc/apt/keyrings
   
3. curl -fsSL <a href="https://download.docker.com/linux/ubuntu/gpg" target="_blank">https://download.docker.com/linux/ubuntu/gpg</a> | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

复制代码

1. # 添加官方仓库（明确指定 ARM64 架构）
   
2. echo "deb [arch=arm64 signed-by=/etc/apt/keyrings/docker.gpg] <a href="https://download.docker.com/linux/ubuntu" target="_blank">https://download.docker.com/linux/ubuntu</a> $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

复制代码

1. # 更新仓库索引
   
2. sudo apt update

复制代码

3. 安装 Docker 及组件

1. # 安装 Docker 官方版本
   
2. sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

复制代码

4. 安装独立版 Docker Compose（推荐）

1. # 下载最新版 Docker Compose
   
2. sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

复制代码

1. # 赋予执行权限
   
2. sudo chmod +x /usr/local/bin/docker-compose

复制代码

5. 验证安装

1. # 检查版本
   
2. docker --version          # 预期输出: Docker 24.0.x 或更高
   
3. docker-compose --version  # 预期输出: Docker Compose v2.x

复制代码

# 运行测试容器

1. sudo docker run hello-world

复制代码

权限优化（避免每次使用 sudo）

1. # 将当前用户加入 docker 组
   
2. sudo usermod -aG docker $USER

复制代码

1. # 立即生效组权限（退出终端重新登录也可）
   
2. newgrp docker

复制代码

1. # 验证无需 sudo 运行
   
2. docker run hello-world

复制代码