Docker Engine在树莓派Raspberry Pi OS上的安装指南

Docker Engine在树莓派Raspberry Pi OS上的安装指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

Docker Engine作为容器化技术的核心组件，在树莓派这类ARM架构设备上同样能够发挥重要作用。本文将详细介绍如何在32位Raspberry Pi OS系统上安装Docker Engine，帮助开发者快速搭建容器化开发环境。

系统要求

兼容的操作系统版本

Docker Engine支持以下32位Raspberry Pi OS版本：

• Raspberry Pi OS Bookworm 12（稳定版）
• Raspberry Pi OS Bullseye 11（旧稳定版）

防火墙注意事项

在安装Docker前，需特别注意以下防火墙相关事项：

1. 如果使用ufw或firewalld管理防火墙，Docker暴露的容器端口会绕过这些防火墙规则
2. Docker仅兼容iptables-nft和iptables-legacy
3. 不支持使用nft创建的防火墙规则

准备工作

卸载旧版本

为避免冲突，安装前需卸载可能存在的旧版本或非官方Docker包：

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

注意：此操作不会删除/var/lib/docker/下的镜像、容器、卷和网络数据。

安装方法

方法一：通过apt仓库安装（推荐）

这是最推荐的安装方式，便于后续更新管理。

1. 设置Docker的apt仓库：

# 添加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://download.docker.com/linux/raspbian/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://download.docker.com/linux/raspbian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

2. 安装Docker组件：

# 安装最新版本
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

3. 验证安装：

sudo docker run hello-world

方法二：手动安装deb包

适用于无法访问Docker仓库的环境。

1. 下载所需的deb包：

   • containerd.io
   • docker-ce
   • docker-ce-cli
   • docker-buildx-plugin
   • docker-compose-plugin

2. 安装下载的包：

sudo dpkg -i ./containerd.io_<version>_<arch>.deb \
    ./docker-ce_<version>_<arch>.deb \
    ./docker-ce-cli_<version>_<arch>.deb \
    ./docker-buildx-plugin_<version>_<arch>.deb \
    ./docker-compose-plugin_<version>_<arch>.deb

3. 启动服务并验证：

sudo service docker start
sudo docker run hello-world

方法三：使用便捷脚本（仅限测试环境）

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

注意：此方法不推荐用于生产环境。

升级Docker Engine

对于apt仓库安装方式，只需重复安装步骤选择新版本即可。对于手动安装方式，需下载新版本的deb包重新安装。

卸载Docker Engine

1. 卸载Docker相关包：

sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras

2. 删除数据：

sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

3. 删除源配置：

sudo rm /etc/apt/sources.list.d/docker.list
sudo rm /etc/apt/keyrings/docker.asc

安装后配置

建议完成以下配置：

1. 将非root用户加入docker组
2. 配置Docker开机自启
3. 设置日志轮转策略

常见问题

1. 权限问题：如果遇到权限错误，确保当前用户已加入docker组
2. 镜像兼容性：注意ARM架构的镜像与x86架构不兼容
3. 性能优化：树莓派资源有限，建议限制容器资源使用

通过本文的指导，您应该能够在树莓派上成功安装并运行Docker Engine，开启ARM架构下的容器化开发之旅。

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs