手把手教你轻松搞定树莓派换源

【保姆级教程】小白也能轻松搞定树莓派换源，让你的 apt 下载速度起飞 🚀[2025.07.09最新]

摘要

很多国内的小伙伴在使用树莓派时，都会遇到一个头疼的问题——默认的官方软件源访问速度太慢，sudo apt-get update 能跑上一天，很显然这是不正确的。这会极大地影响我们对于树莓派的开发效率。这篇文章将以小白的视角教你如何给树莓派更换国内镜像源，彻底解决下载速度慢的烦恼，让你的树莓派体验焕然一新！

关键词： 树莓派 Raspberry Pi 换源 apt 软件源 镜像源 清华源 阿里源

为什么要换源？

在国内网络环境下，直接连接到树莓派位于国外的官方软件源，会因为网络延迟高、国际出口带宽限制等原因，导致下载软件包（比如通过 apt 命令安装软件）的过程异常缓慢，甚至频繁失败。

更换为国内的镜像源，相当于将软件仓库“搬”到了国内。我们访问国内服务器的速度是飞快的，因此可以：

• ⚡ 大幅提升下载速度：节约大量等待时间。
• ✨ 提高更新成功率：避免因网络问题导致更新失败。
• 😊 优化整体使用体验：让项目开发和学习过程更流畅。

一、树莓派初始设置

在开始换源前，确保你的树莓派已完成基础配置。建议配置项包括：

• 启用SSH远程连接
• 设置网络连接（WiFi或有线）
• 更新系统时区和语言
• 配置用户权限

注意：具体配置步骤可参考树莓派官方文档或其他详细教程。

二、准备工作

2.1 远程连接工具

推荐使用以下工具连接树莓派：

• RealVNC Viewer：提供图形化界面，适合新手
• MobaXterm：支持复制粘贴，命令行操作更便捷
• PuTTY + WinSCP：轻量级SSH客户端组合

2.2 备份原始配置

在修改源之前，建议先备份原始配置文件：

# 备份软件源配置
sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup
sudo cp /etc/apt/sources.list.d/raspi.list /etc/apt/sources.list.d/raspi.list.backup

三、系统信息确认

3.1 查看系统版本（这里以树莓派5为例）

首先确认你的系统版本，这是选择正确镜像源的关键：

lsb_release -a

3.2 查看处理器架构

uname -m

常见架构说明：

• aarch64：ARM 64位架构
• armv7l：ARM 32位架构

四、选择并替换国内镜像源

国内有许多优秀的镜像源可供选择：

• 清华大学镜像站：速度快，更新及时
• 阿里云镜像站：稳定性好
• 中科大镜像站：教育网友好
• 华为云镜像站：企业级稳定

本文以清华源为例进行演示。

4.1 编辑 raspi.list 文件

使用 nano 编辑器打开 raspi.list 文件：

sudo nano /etc/apt/sources.list.d/raspi.list

将原内容注释掉，并添加清华源：

# 原始官方源（已注释）
#deb http://archive.raspberrypi.com/debian/ bookworm main
# Uncomment line below then 'apt-get update' to enable 'apt-get source'
#deb-src http://archive.raspberrypi.com/debian/ bookworm main

# 清华大学镜像源
deb http://mirrors.tuna.tsinghua.edu.cn/raspberrypi/ bookworm main

操作提示：编辑完成后，按 Ctrl+O 保存，Ctrl+X 退出。

复制粘贴注意：推荐使用MobaXterm等支持复制粘贴的终端工具。

4.2 获取适配的Debian源

根据前面确认的系统信息，访问 清华大学Debian镜像站 获取对应的源地址。主要选择如下图

重要：请根据你的系统版本选择正确的代号：

• Debian 12 对应 bookworm
• Debian 11 对应 bullseye
• Debian 10 对应 buster

以Debian 12 (bookworm) 为例，对应的源配置为：

# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware

deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware

deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware

# 安全更新源（使用清华镜像以提高速度）
deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware

4.3 编辑主源文件

sudo nano /etc/apt/sources.list

将原始内容注释掉，替换为上述清华源配置。

编辑提示：完成编辑后，按 Ctrl+O 保存，Ctrl+X 退出。

至此已完成换源配置。

五、更新软件源列表和软件包

5.1 更新软件包索引

sudo apt update

如果看到类似 Hit 和 Get 的信息快速滚动，且没有报错，说明换源成功！以下为成功案例

5.2 升级已安装的软件包

sudo apt upgrade -y

说明：-y 参数表示自动确认所有升级操作。

5.3 验证换源效果

换源成功后，你会发现：

• 下载速度明显提升
• 更新过程更稳定，减少中断
• 整体系统响应更快

六、故障排除

6.1 常见错误及解决方案

错误1：GPG error 或签名验证失败

# 更新GPG密钥
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys [KEY_ID]

错误2：404 Not Found 错误

• 检查系统版本代号是否正确
• 确认镜像源地址是否有误

错误3：网络连接问题

• 检查网络连接状态
• 尝试其他镜像源（如阿里云、华为云）

6.2 恢复原始配置

如果遇到问题需要恢复：

sudo cp /etc/apt/sources.list.backup /etc/apt/sources.list
sudo cp /etc/apt/sources.list.d/raspi.list.backup /etc/apt/sources.list.d/raspi.list
sudo apt update

七、其他推荐镜像源

除了清华源，你还可以选择：

阿里云镜像源：

deb https://mirrors.aliyun.com/debian/ bookworm main contrib non-free non-free-firmware

华为云镜像源：

deb https://mirrors.huaweicloud.com/debian/ bookworm main contrib non-free non-free-firmware

中科大镜像源：

deb https://mirrors.ustc.edu.cn/debian/ bookworm main contrib non-free non-free-firmware

总结：换源完成！现在你的树莓派应该能够以更快的速度下载和更新软件包了。建议定期运行 sudo apt update && sudo apt upgrade 来保持系统最新状态。