news 2026/4/18 5:41:03

树莓派换源入门教程:图文并茂轻松学会

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
树莓派换源入门教程:图文并茂轻松学会

树莓派换源实战指南:从卡顿到飞速的系统加速术

你有没有遇到过这样的场景?刚拿到一台崭新的树莓派,兴致勃勃地插上电、烧好系统,准备安装第一个软件时,终端里却一行行缓慢滚动着:

0% [Connecting to archive.raspbian.org (93.93.128.193)]

等了三分钟,进度条才走到 5%,apt update跑了快半小时还没完……这种体验,对新手来说简直是劝退现场。

别急——问题不在你的树莓派,而在于它正在“跨国取货”。


为什么默认源这么慢?

树莓派运行的是基于 Debian 的Raspberry Pi OS,它通过APT(Advanced Package Tool)来管理软件包。当你执行sudo apt update时,系统会去访问官方源服务器archive.raspbian.org,这个服务器位于英国,数据要绕一大圈穿过国际网络才能到达你家路由器。

国内用户连上去,延迟高、丢包多、带宽窄,下载速度动辄卡在几十 KB/s,更新个系统能喝三杯茶。

但其实,我们完全不需要千里迢迢去英国“进货”。国内已经有多个高校和企业把这套软件仓库完整镜像了下来,并通过 CDN 加速分发。只要告诉树莓派:“别去国外了,改去清华或阿里云拉数据”,速度立刻起飞。

这就是所谓的——换源


换源的本质是什么?

简单说,换源就是修改/etc/apt/sources.list文件中的网址,把原本指向境外的archive.raspbian.org换成国内镜像站提供的地址。

比如:

# 原始源(国外) deb http://archive.raspbian.org/raspbian/ bullseye main contrib non-free rpi # 清华镜像源(国内) deb https://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ bullseye main contrib non-free rpi

改完之后,再运行apt update,你会发现:
以前要半小时的操作,现在几十秒搞定;
以前动不动超时失败,现在稳如老狗;
以前装个 Node.js 要命,现在顺滑得像本地拷贝。

这不是玄学,是实实在在的地理优势 + 网络优化。


国内哪些镜像站靠谱?怎么选?

目前主流支持树莓派的国内镜像站有以下几个,都是经过长期运营、同步稳定的选择:

镜像站地址同步频率推荐理由
清华大学 TUNAhttps://mirrors.tuna.tsinghua.edu.cn每小时一次社区活跃,文档齐全,覆盖全运营商
中科大 USTChttps://mirrors.ustc.edu.cn实时同步教育网出身,公网也很稳
阿里云 Aliyunhttps://mirrors.aliyun.com每小时一次商业级带宽,响应极快
华为云https://mirrors.huaweicloud.com每小时一次提供专属路径,适配性好

✅ 所有这些镜像都完整同步了 Raspbian 官方仓库,包括main,contrib,non-free,rpi组件,且保留 GPG 签名验证机制,安全无篡改。

推荐选择顺序
优先用清华阿里云,全国通吃,延迟低。如果你在校园网环境,中科大可能更快。


手把手教你手动换源(最稳妥方式)

第一步:确认你的系统版本

不同版本的 Raspberry Pi OS 使用不同的代号(codename),必须匹配正确,否则会报错。

查看命令:

cat /etc/os-release

重点关注这一行输出:

VERSION_CODENAME=bookworm

或者

VERSION_CODENAME=bullseye
  • Bookworm:2023年及以后发布的最新版系统(基于 Debian 12)
  • Bullseye:旧版系统(Debian 11),仍有不少人在用

⚠️ 记下你的代号,后面替换源要用!


第二步:备份原始配置

任何系统修改前都要先备份!防止改错导致无法更新。

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

这句的意思是:把原来的软件源文件复制一份,名字叫.bak结尾。万一出问题还能还原。


第三步:编辑 sources.list

使用nano编辑器打开文件:

sudo nano /etc/apt/sources.list

你会看到类似下面的内容:

deb http://archive.raspbian.org/raspbian/ bookworm main contrib non-free rpi deb-src http://archive.raspbian.org/raspbian/ bookworm main contrib non-free rpi

我们要做两件事:

  1. 注释掉原内容:在每行前面加一个#
    # deb http://archive.raspbian.org/raspbian/ bookworm main contrib non-free rpi # deb-src http://archive.raspbian.org/raspbian/ bookworm main contrib non-free rpi

  2. 添加新源(以清华为例):

deb https://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ bookworm main contrib non-free rpi deb-src https://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ bookworm main contrib non-free rpi

📌 注意事项:
- 协议一定要用https,更安全;
- URL 中的bookworm要替换成你自己的系统代号;
- 不要漏掉最后的组件列表(main contrib non-free rpi);
-deb-src行可保留,虽然一般不用源码包,但留着也没坏处。

保存退出方法:
- 按Ctrl + O→ 回车(写入文件)
- 按Ctrl + X(退出编辑器)


第四步:更新索引并测试

sudo apt update

如果一切正常,你会看到飞快的连接速度,几秒钟就能加载完所有元数据。

接着可以测试安装一个轻量工具验证是否生效:

sudo apt install neofetch -y

安装完成后运行:

neofetch

能看到漂亮的系统信息图,说明换源成功!


进阶技巧:一键脚本自动换源(适合批量部署)

如果你有好几台树莓派要配置,一个个改太麻烦。可以用下面这个自动化脚本一键完成。

创建脚本文件:

nano auto-change-source.sh

粘贴以下内容(以阿里云为例):

#!/bin/bash # 自动识别系统版本并切换为阿里云镜像源 MIRROR="https://mirrors.aliyun.com" CODENAME=$(grep VERSION_CODENAME /etc/os-release | cut -d= -f2) echo "🔍 检测到系统版本: $CODENAME" # 备份原文件(带时间戳) sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak.$(date +%Y%m%d-%H%M%S) # 写入新源 cat << EOF | sudo tee /etc/apt/sources.list deb $MIRROR/raspbian/raspbian/ $CODENAME main contrib non-free rpi deb-src $MIRROR/raspbian/raspbian/ $CODENAME main contrib non-free rpi EOF echo "✅ 已切换至阿里云镜像源" echo "🔄 正在清理缓存并更新..." sudo apt clean sudo apt update

保存后赋予执行权限:

chmod +x auto-change-source.sh

运行脚本:

./auto-change-source.sh

从此五台十台树莓派,一分钟全部搞定。


常见问题与避坑指南

❌ 报错:No Release fileHash Sum mismatch

原因:系统版本不匹配
你用了bookworm的源,但系统其实是bullseye,反之亦然。

✅ 解决办法:
1. 查看真实版本:cat /etc/os-release
2. 修改sources.list中的代号
3. 重新运行apt update


❌ 报错:GPG error: NO_PUBKEY 9165938D90FDDD2E

说明缺少树莓派官方签名密钥。

运行以下命令重新导入:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 9165938D90FDDD2E

⚠️ 注意:apt-key在新版系统中已被弃用。长期建议将密钥导入/etc/apt/trusted.gpg.d/目录中,但对普通用户而言,上述命令仍是最快恢复手段。


🌐 DNS 解析慢?试试指定子域名

部分镜像站提供专用子路径,减少跳转开销:

  • 清华:https://mirrors.tuna.tsinghua.edu.cn/raspbian/
  • 阿里云:https://mirrors.aliyun.com/raspbian/

这些域名解析更快,建议优先使用。


更进一步:让“换源”成为开发习惯

掌握换源只是开始。真正的高手会把它融入整个工作流:

✅ 最佳实践清单

实践说明
始终使用 HTTPS 源防止中间人攻击
定期检查镜像状态可访问 https://status.reposado.cloud 查看各镜像健康度
不要混用多个镜像站避免版本冲突和依赖混乱
保留备份至少一周出问题随时回滚
结合 pi-gen 构建自定义镜像高级玩家可在烧录前就预置国内源,实现“开箱即上网”

小改动,大收益:不只是提速

你以为换源只是为了快一点?其实它的意义远不止于此。

想象一下:
- 学生做实验时不再因更新失败重装系统;
- 工程师部署边缘设备时能快速批量配置;
- 极客搭建智能家居中枢时不被网络拖累节奏;
- 开源项目贡献者在国内也能顺畅构建环境。

换源,是打破地理壁垒的第一步,也是国产化生态建设的真实缩影

今天我们在树莓派上换了个源,明天也许就能推动更多嵌入式平台实现本地化适配。


如果你已经完成了换源操作,不妨试试这条命令感受下变化:

time sudo apt update

对比前后耗时,你会惊讶于:原来只需要改几行配置,就能让整套系统焕然一新。

互动时刻:你在哪所学校或公司?你们有没有自己的内部镜像源?欢迎在评论区分享你的换源经验或推荐的镜像站点!

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/18 5:24:57

带你了解pytorch,pytorch基本内容介绍

Pytorch作为深度学习库&#xff0c;常被使用。原因在于&#xff0c;pytorch代码更为简单。不管是深度学习新手还是老手&#xff0c;pytorch都是一大利器。为增进大家对pytorch的了解&#xff0c;本文将对pytorch的简单知识加以讲解。如果你对本文内容具有兴趣&#xff0c;不妨继…

作者头像 李华
网站建设 2026/4/18 5:22:02

你真的了解C#中的unsafe吗?一文看懂指针编程的利与弊

第一章&#xff1a;你真的了解C#中的unsafe吗&#xff1f;C# 作为一门以安全性和稳定性著称的高级语言&#xff0c;通常通过托管内存和垃圾回收机制来管理资源。然而&#xff0c;在某些特定场景下&#xff0c;开发者需要绕过这些限制以获得更高的性能或与非托管代码交互&#x…

作者头像 李华
网站建设 2026/4/13 7:56:30

树莓派5人脸追踪实战:PyTorch实时检测核心要点

树莓派5人脸追踪实战&#xff1a;PyTorch实时检测核心要点从一个“卡顿”的摄像头说起你有没有试过在树莓派上跑一个人脸检测模型&#xff0c;结果画面像幻灯片一样一帧一卡&#xff1f;明明代码逻辑没问题&#xff0c;但就是跟不上节奏。这正是我在搭建人脸追踪系统时遇到的第…

作者头像 李华
网站建设 2026/4/18 4:00:07

C#集合筛选从入门到精通,20年架构师总结的6大黄金法则

第一章&#xff1a;C#集合筛选的核心概念与演进历程C# 作为 .NET 平台的主流编程语言&#xff0c;其集合筛选能力在多个版本迭代中持续增强。从早期的循环遍历到 LINQ 的引入&#xff0c;集合筛选逐步实现了声明式语法与高性能执行的统一。传统筛选方式的局限性 在 C# 2.0 时代…

作者头像 李华
网站建设 2026/4/18 4:02:07

从入门到精通:C#交错数组访问的7种实用场景与代码示例

第一章&#xff1a;C#交错数组访问的基本概念在C#中&#xff0c;交错数组&#xff08;Jagged Array&#xff09;是一种特殊的多维数组结构&#xff0c;它由多个一维数组组成&#xff0c;每个子数组可以拥有不同的长度。这种灵活性使其适用于处理不规则数据结构&#xff0c;例如…

作者头像 李华
网站建设 2026/4/18 4:02:12

打工人年终总结!好用远程控制软件搞定年终总结

年终总结是打工人的职场期末考试写得好不好&#xff0c;直接关乎年终奖多少和来年升职加薪可自己做的时候素材不够&#xff0c;缺文件真让人头大&#xff01;再好的功劳也不能因为“找不到文件”难自证吧&#xff1f;别愁&#xff0c;UU远程就是年终总结好帮手&#xff0c;帮你…

作者头像 李华