Ubuntu 25.04 (ARM64) 安装 Docker 教程

Ubuntu 25.04 桌面版 (ARM64) 上安装 Docker 的完整步骤
镜像名字：ubuntu-25.04-desktop-arm64

注意未配置国内镜像，后期再补上，优化文档

步骤 1：更新系统包索引

sudo apt update && sudo apt upgrade -y

步骤 2：安装必要的依赖包

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common gnupg

步骤 3：添加 Docker 官方 GPG 密钥

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

步骤 4：添加 Docker 软件源

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

步骤 5：更新包索引并安装 Docker

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

步骤 6：验证 Docker 安装

sudo docker run hello-world

步骤 7：将当前用户添加到 docker 组（可选但推荐）

sudo usermod -aG docker $USER

添加完成后，需要注销并重新登录才能生效。

步骤 8：配置 Docker 镜像加速（可选）

创建或编辑 Docker 配置文件：

sudo nano /etc/docker/daemon.json

添加以下内容（使用阿里云镜像）：

{
  "registry-mirrors": ["https://<your-mirror-id>.mirror.aliyuncs.com"]
}

保存后重启 Docker：

sudo systemctl restart docker

步骤 9：启用 Docker 服务开机自启

sudo systemctl enable docker.service
sudo systemctl enable containerd.service

故障排除

如果遇到权限问题，确保当前用户已加入 docker 组并重新登录。
如果下载速度较慢，可以尝试其他镜像源，如清华大学镜像：

{
  "registry-mirrors": ["https://docker.mirrors.tuna.tsinghua.edu.cn"]
}

通过以上步骤，你可以在 Ubuntu 25.04 (ARM64) 上成功安装并配置 Docker。