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

在树莓派上更换镜像源（如改为清华源、阿里云源等）可以显著提升软件安装和更新速度。以下是详细步骤，包含两种修改方式（直接替换文件或使用 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 密钥。