You need to enable JavaScript to run this app. 树莓派4(Raspbian 10 buster)安装Docker时报dpkg错误码1如何修复
优惠活动
大模型
产品
解决方案
定价
更多

树莓派4(Raspbian 10 buster)安装Docker时报dpkg错误码1如何修复

树莓派4 Raspbian 10 安装Docker dpkg报错修复指南

报错本质:官方安装脚本在执行apt-get install docker-ce步骤时,把所有标准输出重定向到了空设备,屏蔽了dpkg的具体报错细节。在Raspbian 10(Buster)的实际安装场景里,这个中断绝大多数是两个原因:

  • 树莓派默认swap空间太小(仅100MB),安装过程中内存耗尽触发系统OOM机制杀掉dpkg进程
  • 系统此前装过旧版本的Docker(比如Raspbian源自带的docker.io包),残留的文件和配置与官方docker-ce包冲突

第一步:抓取隐藏的真实报错

脚本把安装日志全屏蔽了,必须先跑一次带详细输出的安装命令,定位具体问题:
sudo apt-get install -y --no-install-recommends docker-ce
等终端跑完,就能看到dpkg中断的真实原因,常见的错误返回值有两个:

  • 返回值137:代表进程被系统OOM机制杀掉,属于内存不足问题
  • 返回值1/2:代表文件冲突、配置项冲突,属于旧版本残留问题

对应场景的修复操作

场景1:OOM内存不足导致的中断

树莓派4出厂默认仅配置100MB的swap交换空间,docker-ce安装包解压、配置阶段需要的临时内存很容易超过物理内存+100MB swap的上限,直接触发进程被杀。
修复步骤:

  1. 调整swap空间到2GB,满足安装的临时内存需求
    • 关闭当前生效的swap:sudo dphys-swapfile swapoff
    • 编辑swap配置文件:sudo nano /etc/dphys-swapfile,找到CONF_SWAPSIZE=100这一行,把数值改成2048,保存退出
    • 重新初始化swap并启用:sudo dphys-swapfile setup && sudo dphys-swapfile swapon
  2. 修复之前中断的dpkg状态,把没配置完的包补全:sudo dpkg --configure -a
  3. 重新执行官方安装脚本:sudo sh get-docker.sh

场景2:旧包残留/文件冲突导致的中断

如果日志显示某个系统路径下的文件被占用、或者包版本冲突,说明之前系统里装过其他版本的Docker,没有清理干净。
修复步骤:

  1. 全部卸载和Docker相关的现存包,清除残留配置:
    sudo apt-get remove -y docker docker-engine docker.io containerd runc
    sudo apt-get purge -y docker-ce docker-ce-cli containerd.io
    
  2. 删除残留的旧数据目录:
    sudo rm -rf /var/lib/docker /var/lib/containerd
  3. 重新拉取官方安装脚本执行安装:
    curl -fsSL https://get.docker.com -o get-docker.sh
    sudo sh get-docker.sh
    

安装完成的验证

  1. 执行docker --version能正常输出Docker的版本号,代表核心包安装成功
  2. 执行sudo docker run hello-world,能看到“Hello from Docker!”的输出,代表Docker服务已经正常启动

日常使用如果不想每次执行docker命令都加sudo,可以把pi用户加到docker用户组:sudo usermod -aG docker pi,退出当前终端重新登录后生效。


内容的提问来源于stack exchange,提问作者Nighthawx

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 02:54:01