Docker 官方提供了 Raspberry Pi OS 32 位（armhf）系统安装 Docker Engine 的方式，使用 64 位 (arm64) 系统需按照 Debian 的安装方式进行安装（Raspberry Pi OS 是基于 Debian 开发的操作系统）。本文着重介绍 Raspberry Pi OS (64-bit) 安装 Docker Engine 。

Raspberry Pi OS（32-bit）系统 Docker Engine 安装方式：https://docs.docker.com/engine/install/raspberry-pi-os/

操作系统要求

• Debian version: 12 (bookworm)，目前最新稳定版本
• Debian version: 11 (bullseye)，上一个稳定版本

☝️这是笔者在写这篇文章时的 Debian 版本情况，后续当 Debian 13 (Trixie) 稳定版本发布后，Docker 仓库就会移除对 Debian 11 (bullseye) 的支持

查看你的 Raspberry Pi OS 系统版本

$ cat /etc/os-release

卸载可能会冲突的软件包

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

设置 Docker 的 apt 存储库

由于国内网络原因，需要把 Docker 官方仓库地址替换为阿里云的 Docker 仓库地址

# 添加阿里云 Docker GPG 密钥:
$ sudo apt-get update
$ sudo apt-get install ca-certificates curl
$ sudo install -m 0755 -d /etc/apt/keyrings
$ sudo curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
$ sudo chmod a+r /etc/apt/keyrings/docker.asc

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

安装 Docker 软件包

安装最新版本：

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

指定版本安装：

# 列出可用版本
$ apt-cache madison docker-ce | awk '{ print $3 }'

# 选择所需的版本并安装：
$ VERSION_STRING=5:27.1.1-1~debian.12~bookworm
$ sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin

通过运行 hello-world 镜像验证安装是否成功

$ sudo docker run hello-world

此命令下载测试镜像并运行容器。当容器运行时，它会打印如下信息并退出：

docker 服务在基于 Debian 的发行版上默认会开机自启