树莓派 5（ARM64）安装 Docker 并配置镜像源与基础网段

树莓派 5（Raspberry Pi 5）使用 Debian-based 系统（如 Raspberry Pi OS），因此安装步骤与 Ubuntu 略有不同。本教程基于 ARM64 架构，并适配国内镜像源（阿里云）。

1. 卸载旧版本 Docker（如有）

for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do 
    sudo apt-get remove $pkg; 
done

2. 安装系统依赖

sudo apt-get update
sudo apt-get install ca-certificates curl

3. 添加 Docker 官方（阿里云镜像）GPG Key

创建 key 存放目录：

sudo install -m 0755 -d /etc/apt/keyrings

下载 Docker GPG key：

sudo curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/debian/gpg -o /etc/apt/keyrings/docker_aliyun.asc
sudo chmod a+r /etc/apt/keyrings/docker_aliyun.asc

4. 添加 Docker APT 软件源（使用阿里云镜像）

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker_aliyun.asc] \
http://mirrors.aliyun.com/docker-ce/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker_aliyun.list > /dev/null

sudo apt-get update

5. 安装 Docker

安装最新版 Docker Engine：

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

6. 配置用户组（可选）

目的：让普通用户无需每次都输入 sudo 执行 Docker。

sudo usermod -aG docker $USER
sudo reboot

⚠️ 执行后系统会重启，属于正常行为。

7. 验证 Docker 是否安装成功

docker info
docker version

8. 为树莓派配置 Docker 镜像源 & 基础网段

以下步骤与 Ubuntu 相同，树莓派也使用 /etc/docker/daemon.json。

8.1 创建 Docker 配置目录

sudo mkdir -p /etc/docker

8.2 写入镜像源和基础网段

使用国内常用加速源：

sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.1panel.live",
    "https://hub.rat.dev"
  ],
  "default-address-pools": [
    {
      "base": "172.16.0.0/12",
      "size": 24
    }
  ]
}
EOF

你也可以按需替换镜像源内容。

8.3 重启 Docker 服务

sudo systemctl daemon-reload && sudo systemctl restart docker

8.4 验证镜像源是否生效

docker info

查看：

Registry Mirrors 是否包含你配置的加速源
网络池是否为你设置的基础网段

Leifly

Docker安装-arm64(树莓派5)