树莓派国内镜像源一键配置指南

原创

于 2026-02-05 02:05:46 发布 · 1.3k 阅读

1. 为什么树莓派需要换国内镜像源

刚拿到树莓派的朋友们可能都遇到过这样的问题：系统更新慢得像蜗牛，安装个软件要等半天，有时候甚至直接卡住不动。这其实不是你的树莓派性能问题，而是默认的软件源服务器都在国外，国内访问速度实在感人。

我刚开始玩树莓派的时候也踩过这个坑。记得有一次安装一个不到10MB的软件包，居然花了半个多小时，还时不时断连。后来才知道，只需要把软件源换成国内的镜像站，速度就能提升几十倍不止。

国内镜像源其实就是把国外的软件包同步到国内的服务器上。这样我们在下载更新时，就不用绕远路去国外服务器，直接从国内的镜像站获取，速度自然就上来了。目前国内比较知名的镜像站有清华大学、阿里云、中国科学技术大学等，都提供了树莓派镜像服务。

2. 准备工作：确认你的树莓派系统信息

在开始换源之前，有两条关键信息需要先确认：系统版本和硬件架构。这两个信息决定了你应该使用哪个镜像源配置，如果用错了会导致更新失败。

查看系统版本很简单，打开终端输入：

lsb_release -a

你会看到类似这样的输出：

No LSB modules are available.
Distributor ID: Debian
Description:    Debian GNU/Linux 11 (bullseye)
Release:        11
Codename:       bullseye

这里的Codename就是系统代号，比如bullseye、bookworm等，这是选择镜像源的重要依据。

接下来查看硬件架构：

uname -m

常见的架构有armv7l（32位）和aarch64（64位）。现在新的树莓派5基本都是64位架构了。

我建议在修改源文件前先做个备份，这样万一配置错了还能恢复。执行以下命令：

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

这样就有了原始配置的备份，可以放心大胆地进行修改了。

3. 一键配置脚本：最快最省事的方法

如果你不想一个个文件手动编辑，我这里有个一键配置脚本，支持多个国内镜像源选择。这个脚本会自动检测你的系统版本，然后替换为对应的国内源。

创建并运行脚本的方法：

#!/bin/bash

# 检测系统版本
CODENAME=$(lsb_release -c | awk '{print $2}')
ARCH=$(uname -m)

echo "检测到系统版本: $CODENAME, 架构: $ARCH"

# 选择镜像源
echo "请选择镜像源:"
echo "1) 清华大学镜像站"
echo "2) 阿里云镜像站"
echo "3) 中国科学技术大学镜像站"
read -p "输入选择 (1-3): " MIRROR_CHOICE

case $MIRROR_CHOICE in
    1)
        DEBIAN_MIRROR="https://

标签