一文掌握GitHub热门开源项目Docker（树莓派版）

引言

Docker作为当今最流行的容器化技术，可以帮助我们轻松部署和管理应用。在树莓派这样的ARM架构设备上使用Docker，能够充分发挥其低功耗、便携性的优势。本文将手把手教你如何在树莓派上安装和使用Docker，并部署GitHub上的热门开源项目。

准备工作

硬件要求

• 树莓派3/4/5（推荐4B及以上版本）
• 至少16GB的microSD卡
• 稳定的网络连接

软件要求

• Raspberry Pi OS（64位版本）
• 已配置SSH或可直接访问终端

💡 小贴士：使用64位系统能获得更好的兼容性，执行uname -m确认是否为aarch64

第一步：安装Docker引擎

1.1 更新系统包

sudo apt update && sudo apt upgrade -y

1.2 安装Docker官方脚本

curl -fsSL https://get.docker.com | sh

原理说明：
– curl下载安装脚本
– -fsSL参数组合表示：
– f：静默模式
– s：不显示进度条
– S：显示错误信息
– L：跟随重定向

1.3 将当前用户加入docker组

sudo usermod -aG docker $USER
newgrp docker  # 立即生效无需重启

验证安装：

docker --version
# 应显示类似：Docker version 24.0.5, build ced0996

第二步：配置Docker环境

2.1 启用守护进程（如未自动启动）

sudo systemctl enable --now docker

2.2 Docker镜像加速（国内用户建议）

创建配置文件：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF

重启服务生效：

sudo systemctl restart docker

第三步：部署GitHub热门项目示例

我们以Portainer为例，这是一个轻量级的Docker管理UI。

3.1 ARM架构镜像拉取技巧

标准命令：

docker pull portainer/portainer-ce:latest --platform linux/arm64/v8 

⚠️ 注意：很多x86镜像不兼容ARM架构，必须确认有ARM版本或支持多架构

3.2 Portainer容器部署

docker run -d \
    --name portainer \
    -p 9000:9000 \
    --restart=always \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v portainer_data:/data \
    portainer/portainer-ce:latest --platform linux/arm64/v8 

参数解析：
– -d：后台运行容器
– --restart=always：自动重启策略
– -v挂载卷实现数据持久化
– --platform指定ARM架构

访问管理界面：

http://<树莓派IP>:9000/

ARM架构特别注意事项

1. 镜像兼容性检查：

   代码片段 复制代码

   docker manifest inspect <镜像名>
   

   查看是否有linux/arm64

2. 编译多平台镜像：

   代码片段 复制代码

   docker buildx build --platform linux/arm64,linux/amd64 .
   

3. 性能优化：

   代码片段 复制代码

   # /etc/docker/daemon.json添加：
   {
     "default-runtime": "runc",
     "features": {"buildkit": true}
   }
   

Q&A常见问题解决

❓ Q1: Docker命令报权限错误

Got permission denied while trying to connect to the Docker daemon socket...

✅ 解决：确保执行过usermod -aG docker $USER并重新登录

❓ Q2: ARM镜像拉取失败

no matching manifest for linux/arm/v7 in the manifest list entries  

✅ 解决：确认镜像支持ARM架构或尝试指定具体版本号而非latest

❓ Q3: Portainer无法连接Docker

Cannot connect to the Docker daemon at unix:///var/run/docker.sock...

✅ 解决：检查是否遗漏了-v /var/run/docker.sock:/var/run/docker.sock

GitHub热门ARM项目推荐

1. Pi-hole – DNS级广告拦截器

   代码片段 复制代码

   docker run -d \
       --name pihole \ 
       -p53:53/tcp -p53:53/udp \ 
       -e TZ="Asia/Shanghai" \ 
       pihole/pihole:latest --platform linux/arm64/v8 
   

2. Home Assistant – IoT智能家居平台

3. Jellyfin -媒体服务器

Docker常用命令速查表

Final总结要点

✔️ Docker在树莓派上的安装只需一条命令
✔️ ARM架构需要特别注意镜像兼容性问题
✔️ Portainer提供友好的Web管理界面
✔️ GitHub上有大量优秀的ARM兼容项目

现在你已经掌握了在树莓派上使用Docker的核心技能！快去探索更多有趣的GitHub开源项目吧~ 🎉

📌 进阶建议：学习使用docker-compose管理多容器应用，这是部署复杂项目的利器！