在 Armbian 上安装 Docker

最近更新: 2026-10-21

在 reComputer RK3576 或 RK3588 上执行以下步骤。

1. 安装 Docker

如果已安装 Docker，请跳过此步骤。开发环境可运行：

bash

bash <(curl -fsSL https://get.docker.com)

2. 为支持 OTA 的 Armbian 配置存储

在启用了 OTA overlayroot 的 Armbian 26.8.7 Gnome 及更新版本上，请将 Docker 和 containerd 的存储位置移到根目录 overlay 之外，否则容器可能因 overlay 挂载错误（invalid argument）而无法运行。未使用 overlayroot 的系统可跳过此步骤。

确认 /media/root-rw 挂载在可写的用户数据文件系统上，而不是 overlay：

bash

findmnt -T /media/root-rw
sudo mkdir -p /etc/docker /etc/containerd

编辑 /etc/docker/daemon.json：

bash

sudo nano /etc/docker/daemon.json

设置以下属性，并保留其他已有配置：

json

{
  "data-root": "/media/root-rw/docker",
  "registry-mirrors": ["https://docker.nju.edu.cn", "https://docker.m.daocloud.io"]
}

要在 nano 中保存，请按 Ctrl+O（字母 O），再按 Enter 确认文件名。按 Ctrl+X 退出并返回终端。

编辑 /etc/containerd/config.toml：

bash

sudo nano /etc/containerd/config.toml

在所有 [table] 节之前的顶层设置 root。如果已有 root，请修改其值，不要重复添加：

toml

root = "/media/root-rw/containerd"

再次保存并退出 nano：依次按 Ctrl+O、Enter、Ctrl+X。

3. 重启并验证

bash

sudo systemctl enable docker
sudo systemctl restart containerd docker
sudo docker run --rm hello-world

看到 Hello from Docker! 后，即可使用 Docker 部署模型。