一、工具说明
apt-mirror 是一款由 Go 语言编写的 Linux 发行版 APT 软件源切换工具
当前主要适用于 Debian trixie、Raspbian trixie、Ubuntu noble,采用 deb822 风格的 .sources 文件对软件源进行管理和配置
该工具通过自动识别系统发行版、版本代号及架构信息,对系统软件源配置进行备份、恢复、切换等管理操作
二、功能特性
当前工具支持以下功能:
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
mv apt-mirror-* apt-mirror2. 赋予执行权限
chmod +x apt-mirror3. 启动工具
因为涉及到软件的配置以及更新,需要使用 root 权限或通过 sudo 执行
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 0700DEEF 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 "..."这表示文件自签名以来未被篡改,且确实由本项目发布者签名
若验证失败或指纹不一致,请立即停止使用该文件
非商业用途可以使用,但必须注明出处;
若有改编需采用相同许可协议发布。