919 字
5 分钟
apt-mirror APT 软件源切换工具

一、工具说明#

apt-mirror 是一款由 Go 语言编写的 Linux 发行版 APT 软件源切换工具

当前主要适用于 Debian trixie、Raspbian trixie、Ubuntu noble,采用 deb822 风格的 .sources 文件对软件源进行管理和配置

该工具通过自动识别系统发行版、版本代号及架构信息,对系统软件源配置进行备份、恢复、切换等管理操作

self4m
/
apt-mirror
Waiting for api.github.com...
00K
0K
0K
Waiting...

二、功能特性#

当前工具支持以下功能:

1. 备份当前软件源#

自动对当前正在使用的软件源配置进行备份:

  • 以时间戳作为备份标识
  • 保障软件源切换过程中的回滚、追溯

2. 列出软件源备份#

自动扫描本地备份记录,并列出所有可用的备份版本

3. 恢复软件源备份#

从历史备份中选择指定的备份进行恢复:

  • 自动扫描本地备份记录
  • 列出所有可用的备份版本
  • 按指定备份恢复对应的软件源配置

4. 更换软件源(自动备份)#

在更换软件源前自动执行备份操作,并根据当前系统环境完成软件源配置:

  • 自动匹配系统发行版及版本代号
  • 自动匹配系统架构
  • 采用 deb822 风格进行软件配置
  • 更换完成后将自动进行 apt update

当前支持的软件源镜像包括:

  • 官方软件源
  • 阿里云镜像源
  • 腾讯云镜像源
  • 清华大学镜像源
  • 中国科学技术大学镜像源
  • 南京大学镜像源

5. 删除软件源备份#

用于清理历史备份的软件源配置文件:

  • 支持删除所有已备份的软件源配置
  • 支持删除指定已备份的软件源配置
  • 不影响当前正在使用的软件源

三、使用方法#

1. 下载工具#

请前往项目的 Release 页面,根据目标机器架构下载对应的可执行文件:

  • apt-mirror-amd64:amd64(x86_64)
  • apt-mirror-arm64:arm64(aarch64)
  • apt-mirror-armhf:armhf(ARMv7 / arm32)

下载完成后,建议重命名为 apt-mirror

Terminal window
mv apt-mirror-* apt-mirror

2. 赋予执行权限#

Terminal window
chmod +x apt-mirror

3. 启动工具#

因为涉及到软件的配置以及更新,需要使用 root 权限或通过 sudo 执行

Terminal window
sudo ./apt-mirror

执行后工具会在终端中展示当前系统识别信息(发行版/代号/架构等),并提供可用各个功能的入口

4. 构建方法#

提供 build.bat(Windows)和 build.sh(Linux/macOS)两个构建脚本,分别在对应系统下直接运行即可完成编译

四、注意事项#

  • 本工具仅修改本地 APT 软件源配置文件,不提供任何软件包或镜像服务
  • 建议在执行软件源切换前保持系统网络正常

五、GnuPG验证#

本项目发布的二进制文件使用 GnuPG 进行签名。请在使用前验证文件的完整性与来源

项目 GnuPG 公钥文件将放置于仓库根目录GitHub Release 页面,其公钥指纹如下:

DEEF 95DA B2A7 52E5 D56E B571 A283 2DA7 0E23 0700
DEEF 95DA B2A7 52E5 D56E B571 A283 2DA7 0E23 0700

验证方式:

  • 下载并导入项目 GnuPG 公钥:

    Terminal window
    gpg --import publickey.asc
  • 核对公钥指纹信息,确保与上方指纹完全一致

    Terminal window
    gpg --fingerprint 0E230700
  • 将二进制文件与对应的签名文件(.sig)放置于同一目录,例如:

    apt-mirror-****
    apt-mirror-****.sig
  • 执行验证命令

    Terminal window
    gpg --verify apt-mirror-****.sig apt-mirror-****
  • 如果验证成功,将看到类似如下输出:

    Terminal window
    gpg: Good signature from "..."

    这表示文件自签名以来未被篡改,且确实由本项目发布者签名

    若验证失败或指纹不一致,请立即停止使用该文件

apt-mirror APT 软件源切换工具
https://www.self4m.com/posts/apt-mirror/
✍️作者
Self4m
📅发布于
2026-01-12
©️许可协议
CC BY-NC-SA 4.0

商业用途必须事先获得作者授权;
非商业用途可以使用,但必须注明出处;
若有改编需采用相同许可协议发布。