Raspbian安装Docker

Raspbian 是专为树莓派硬件设计的 Linux 操作系统，基于 Debian 发行版并针对 ARM 架构深度优化

作为树莓派的官方操作系统（现称 Raspberry Pi OS），它提供轻量级桌面环境（如 LXDE）、硬件驱动及开发工具，适用于教育、物联网及嵌入式开发场景

Debian 安装 Docker 常用两种方式，基于官方提供的提供的 install-docker.sh 脚本安装和使用 apt/apt-get 的软件源安装。

Docker安装涉及的相关的软件项目：

基于脚本安装

基于脚本安装是Docker官方推荐的安装方式之一。

该脚本会安装最新、稳定版本的Docker CLI、Docker Engine，以及依赖。

脚本使用注意事项：

1. 需要 root 或 sudo 权限运行
2. 尝试自动检测您的 Linux 发行版和版本，并为您配置软件包管理系统。支持ubuntu|debian|raspbian/centos|fedora|rhel。
3. 不允许自定义大多数安装参数
4. 不询问确认直接安装所有依赖项和建议项
5. 默认安装最新稳定版的 Docker CLI、Docker Engine、Docker Buildx、Docker Compose、containerd 和 runc。使用此脚本配置机器时，可能导致这些软件包发生意外的主版本升级。部署到生产系统前请务必在测试环境中验证升级
6. 不适用于升级现有 Docker 安装。使用脚本更新现有安装时，依赖项可能不会升级到预期版本，导致使用过时的版本

该脚本原文件存在 Github 仓库，藏云阁代码仓库做了镜像，详情 https://gitea.cncfstack.com/docker/docker-install

1. 下载脚本

   curl -fsSL https://gitea.cncfstack.com/docker/docker-install/raw/branch/master/install.sh -o install-docker.sh
   

2. 验证脚本

   cat install-docker.sh
   

3. 模拟运行

   sh install-docker.sh --dry-run
   

4. 运行安装脚本。使用 Aliyun 提供软件源镜像提供软件包下载

   sudo sh install-docker.sh --mirror Aliyun
   

5. 启动 docker 服务，并设置开机启动

   systemctl start docker
   systemctl enable docker
   

apt/apt-get 安装

步骤1: 信任 Docker 的 GPG 公钥

Docker的GPG公钥是用于验证从Docker官方仓库下载的软件包的真实性和完整性的一种安全机制，在进行下载安装前需要倒入 GPG 公钥。

对于全新安装的 Debian12 系统，默认可能没有 curl 命令，或者系统 CA 证书不是最新的，也可能 HTTPS 支持缺少依赖。

需要先安装基础依赖

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

然后信任 Docker 的 GPG 公钥

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/raspbian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

步骤2: 配置入软件源信息

添加一个阿里云 docker.list 软件源配置

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] 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

或者使用清华源镜像

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/raspbian \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  tee /etc/apt/sources.list.d/docker.list > /dev/null

步骤3: 删除历史版本（可选）

如果你过去安装过 docker，需要先删掉，否则会出现安装冲突的情况

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

步骤4: 安装Docker

执行命令进行 Docker 相关软件包的安装

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

• 步骤5：启动 docker 服务，并设置开机启动

systemctl start docker systemctl enable docker

步骤6: 检查 Docker 运行状态

docker version

备用仓库与引用

如果默认的镜像源无法访问，可以使用以下信息进行安装。

• 国内企业和高校的镜像站
• 《国内软件源镜像站一览表(2025年状态更新)》
• Docker官方的安装说明（国内网站镜像）
• 阿里云Docker-CE仓库
• 清华Docker-CE仓库