官方参考文档：https://docs.docker.com/engine/install/debian/

说明

需要先在 泰山派3M-RK3576 开发板上烧录 Debian12 的系统镜像，之后再按照以下步骤来安装 Docker。

注意：操作之前，请确保泰山派3M-RK3576网络已经链接！

必要设置

如果使用的是 2026-03-06 之前的镜像，那么在安装 Docker 之前，我们需要在泰山派的系统中运行两个命令：

sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy

这两个命令的作用是将系统的 iptables 和 ip6tables 设置为 legacy 模式，以确保 Docker 能够正常运行。

镜像安装

特别说明

我们在国内安装 Docker 的时候，可能会遇到网络问题导致安装失败的情况。为了避免这种情况，国内就出现了一些镜像网站，这些镜像网站一般提供了 Docker 的安装脚本，并且在脚本中配置了国内的镜像源，这样就可以避免网络问题导致安装失败的情况。

运行下面的脚本：

# 方式一：阿里云镜像源安装Docker:
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# 方式二：使用中国区AzureChinaCloud的镜像源安装Docker:
curl -fsSL https://get.docker.com | bash -s docker --mirror AzureChinaCloud

如果还是不行可以使用轩辕镜像一键安装脚本

bash <(curl -fsSL https://xuanyuan.cloud/docker.sh)

安装完成之后，可以通过 docker --version 命令来验证 Docker 是否安装成功：

lckfb@TaishanPi-3M:~$ docker --version
Docker version 29.2.1, build a5c7197

后续需要自行添加 docker 镜像源，以便拉取镜像时能够使用国内的镜像源来加速下载速度。