树莓派上更换镜像源的方法

在树莓派上更换镜像源（如改为清华源、阿里云源等）可以显著提升软件安装和更新速度。以下是详细步骤，包含两种修改方式（直接替换文件或使用sed命令），并附常见问题解决方案：

‌方法一：直接修改配置文件（推荐新手）‌

‌1. 确认系统版本代号，执行命令查看当前系统版本‌

cat /etc/os-release | grep VERSION_CODENAME

• 输出示例：VERSION_CODENAME=bookworm（记录代号如bookworm或bullseye）。

记录输出结果（如bookworm、bullseye 或者trixie），后续需替换到镜像源地址中。

‌2. 备份原始配置文件（主源文件和专属源文件）‌

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. 修改主源文件（sources.list）‌

sudo nano /etc/apt/sources.list

删除原有内容，替换为以下内容（以清华源为例，版本代号替换为你的实际值）：

# 清华大学 TUNA 镜像源 - 主软件库 deb https://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ bookworm main contrib non-free non-free-firmware deb-src https://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ bookworm main contrib non-free non-free-firmware

‌保存退出‌：按Ctrl + X→ 输入Y→ 回车。

‌4. 修改树莓派专属源文件（raspi.list）‌

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

删除原有内容，替换为：

# 清华大学 TUNA 镜像源 - 树莓派专属组件 deb https://mirrors.tuna.tsinghua.edu.cn/raspberrypi/ bookworm main deb-src https://mirrors.tuna.tsinghua.edu.cn/raspberrypi/ bookworm main

‌保存退出‌：同上。

‌方法二：使用sed命令快速替换（适合进阶用户）‌

‌1. 替换主源文件‌

sudo sed -i 's|raspbian.raspberrypi.org|mirrors.tuna.tsinghua.edu.cn/raspbian|g' /etc/apt/sources.list

‌2. 替换专属源文件‌

sudo sed -i 's|archive.raspberrypi.org/debian|mirrors.tuna.tsinghua.edu.cn/raspberrypi|g' /etc/apt/sources.list.d/raspi.list

‌注意‌：此方法需确保系统版本代号与镜像源路径匹配（如bookworm），否则需手动调整。

‌5. 更新软件源列表‌

sudo apt clean # 清理旧缓存 sudo apt update # 更新软件列表

‌成功标志‌：终端显示Get:XX http://mirrors.tuna.tsinghua.edu.cn/...且下载速度提升。

‌6. 验证更换结果‌

尝试安装一个软件包（如vim）：

sudo apt install vim

若能正常安装且无报错，说明换源成功。

‌常见问题解决‌

‌1. 报错GPG error: The following signatures couldn't be verified‌

‌原因‌：镜像源的 GPG 密钥未更新。
‌解决方案‌：

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys [报错提示的KEY_ID]

或直接更新所有密钥：

sudo apt-key adv --refresh-keys --keyserver keyserver.ubuntu.com

‌2. 报错404 Not Found‌

‌原因‌：系统版本代号（如bookworm）与镜像源路径不匹配。
‌解决方案‌：

• 检查/etc/os-release中的VERSION_CODENAME。
• 手动修改sources.list和raspi.list中的版本代号。

‌3. 更换其他镜像源‌

若需使用阿里云或中科大源，替换地址如下：

• ‌阿里云‌：

  deb https://mirrors.aliyun.com/raspbian/raspbian/ bookworm main deb https://mirrors.aliyun.com/raspberrypi/ bookworm main

• ‌中科大‌：

  deb https://mirrors.ustc.edu.cn/raspbian/raspbian/ bookworm main deb https://mirrors.ustc.edu.cn/raspberrypi/ bookworm main

‌总结‌

1. ‌备份文件‌ → 2. ‌修改配置‌（直接编辑或sed命令）→ 3. ‌更新软件源‌ → 4. ‌验证结果‌。
2. 推荐使用清华源或阿里云源，国内访问速度更快。
3. 若遇到问题，优先检查版本代号和 GPG 密钥。