Debian | debian / debian-archive |
| 
Ubuntu | ubuntu / ubuntu-ports |
| 
Kali Linux | kali |
| 
Linux Mint | linuxmint / ubuntu / ubuntu-ports / debian |
| 
Deepin（深度） | deepin |
| 
Zorin OS | ubuntu / ubuntu-ports |
| 
Armbian | armbian |
| 
Proxmox | proxmox |
| 
Red Hat Enterprise Linux :material-information-outline:{ title="9版本使用 CentOS Stream， 7、8版本使用CentOS" } | centos / centos-stream / centos-altarch / centos-vault |
| 
Fedora | fedora |
| 
CentOS | centos / centos-stream / centos-altarch / centos-vault |
| 
Rocky Linux | rocky |
| 
AlmaLinux | almalinux / almalinux-vault |
| 
OpenCloudOS（鸥栖） | opencloudos |
| 
openEuler（开源欧拉） | openeuler |
| 
openKylin（开放麒麟） | openkylin |
| 
Anolis OS（龙蜥） | anolis |
| 
openSUSE | opensuse |
| 
Arch Linux | archlinux / archlinuxarm |
| 
Alpine Linux | alpine |
| 
Gentoo | gentoo / gentoo-portage |
请看下面的例子
``` { .bash title="使用阿里云镜像站的 Rocky Linux 软件源" }
bash <(curl -sSL https://linuxmirrors.cn/main.sh) \
--source mirrors.aliyun.com \
--branch rockylinux
```
阿里云镜像站的 Rocky Linux 镜像分支名称为 [`rockylinux`](https://mirrors.aliyun.com/rockylinux)，不符合默认规则，但是可以通过命令选项绕过脚本默认规则来实现。
> 部分系统会同时配置多个仓库的软件源，具体详见命令选项
- ### 单独更换 EPEL 源
!!! info "EPEL (Extra Packages for Enterprise Linux) 是由 Fedora 组织维护的一个附加软件包仓库，它主要适用于除 Fedora 操作系统以外的红帽系 Linux 发行版，配置 EPEL 仓库已成为广大用户的普遍需求，建议默认安装它"
有些时候你会发现想使用的镜像站没有 epel 镜像仓库，那么你可以在第一次运行脚本时不安装或更换 epel 源然后再单独执行下面的命令
``` bash
bash <(curl -sSL https://linuxmirrors.cn/main.sh) --only-epel
```
- ### 恢复使用官方源
当你不小心删除了官方源的备份时可以使用此命令来恢复，使用此命令选项后将跳过选择软件源步骤
``` bash
bash <(curl -sSL https://linuxmirrors.cn/main.sh) --use-official-source true
```
> 部分系统不存在官方源例如 `Arch Linux`，届时会自动更换成兼容性较高的阿里云镜像站
- ### 自定义 Debian Security 源
如果你想尽可能提高服务器的安全性则建议使用官方源，因为镜像同步存在延迟
``` bash
bash <(curl -sSL https://linuxmirrors.cn/main.sh) \
--source-security security.debian.org \
--branch-security debian-security
```
- ### 指定 Debian 系 Linux 操作系统的版本代号
大多数情况下自定义版本代号用于更换系统版本，请看下面的例子
=== "升级 Debian 至最新 12 版本 Bookworm"
``` bash
bash <(curl -sSL https://linuxmirrors.cn/main.sh) \
--codename bookworm
```
=== "将 Debian 版本切换到测试分支"
``` bash
bash <(curl -sSL https://linuxmirrors.cn/main.sh) \
--codename testing
```
更换软件源后还需要执行系统更新命令 `apt-get dist-upgrade`，并且建议在更新完成并重启系统后重新执行本换源脚本，因为仅更换软件源配置中的系统版本代号可能会在后期使用时产生一些兼容性问题
``` { .bash title="若脚本无法实现指定版本代号，你也可以在执行脚本后手动替换" }
sed -i "s/$(lsb_release -cs)/指定版本代号/g" /etc/apt/sources.list
```
- ### 更换 Ubuntu EOF版本软件源
!!! info "EOF 为生命周期结束的缩写（End Of Life），Ubuntu 迭代速度较快一般非长期支持(LTS)版本的生命周期只有9个月。官方会定期从主仓库移除不在生命周期内的版本仓库目录，届时可能就需要使用镜像站的 `Ubuntu Old Releases` 分支"
具体版本支持情况详见官方 [Wiki](https://wiki.ubuntu.com/Releases)，关于 `Ubuntu Old Releases` 分支的支持情况详见各镜像站
``` bash
bash <(curl -sSL https://linuxmirrors.cn/main.sh) \
--source mirrors.ustc.edu.cn \
--branch ubuntu-old-releases
```
- ### 无人值守（自动化）
不通过交互完成换源操作，至少需要使用如下命令选项来实现，建议熟悉后再使用
``` { .bash .no-copy title="参考命令" }
bash <(curl -sSL https://linuxmirrors.cn/main.sh) \
--source mirror.example.com \
--protocol http \
--use-intranet-source false \
--install-epel true \
--close-firewall true \
--backup true \
--upgrade-software false \
--clean-cache false \
--ignore-backup-tips
```
---
## 定制脚本
如果你是其它项目的开发者希望通过本项目来制作专属脚本，目前已经有国内教育单位镜像站的维护者这样做了，下面简单介绍一下具体定制方法。
1. 首先不建议修改代码的底层逻辑，应尽量与本项目源码保持同步，脚本内容执行顺序由 `main` 函数控制，代码逻辑清晰
2. 你可以简单去除一些无关内容，例如将三个软件源列表（数组）中的内容删除 `例：mirror_list_default=()`
3. 脚本主要功能配置是由统一的变量控制的，命令选项亦是如此，这些全局变量由全大写字母构成并遵循下划线命名法，具体变量详见如下表格，你只需要将这些变量声明在脚本头部（预留注释区域）即可快速完成定制
| 变量名 | 含义 | 值类型 |
| :-: | :-: | :-: |
| `SOURCE` | 指定软件源地址（域名或IP） | `地址` |
| `SOURCE_EPEL` | 指定 EPEL 附加软件包仓库的软件源地址（域名或IP） | `地址` |
| `SOURCE_SECURITY` | 指定 Debian 系统 security 仓库的软件源地址（域名或IP） | `地址` |
| `SOURCE_VAULT` | 指定 CentOS/AlmaLinux 系统 vault 仓库的软件源地址（域名或IP） | `地址` |
| `SOURCE_PORTAGE` | 指定 Gentoo 系统 portage 仓库的软件源地址（域名或IP） | `地址` |
| `SOURCE_BASE_SYSTEM` | 指定 Linux Mint 系统底层系统的软件源地址（域名或IP） | `地址` |
| `SOURCE_BRANCH` | 指定软件源分支（路径） | `分支名` |
| `SOURCE_EPEL_BRANCH` | 指定 EPEL 附加软件包仓库的软件源分支（路径） | `分支名` |
| `SOURCE_SECURITY_BRANCH` | 指定 Debian 系统 security 仓库的软件源分支（路径） | `分支名` |
| `SOURCE_VAULT_BRANCH` | 指定 CentOS/AlmaLinux 系统 vault 仓库的软件源分支（路径） | `分支名` |
| `SOURCE_PORTAGE_BRANCH` | 指定 Gentoo 系统 portage 仓库的软件源分支（路径） | `分支名` |
| `SOURCE_BASE_SYSTEM_BRANCH` | 指定 Linux Mint 系统底层系统的软件源分支（路径） | `分支名` |
| `DEBIAN_CODENAME` | 指定 Debian 系 / openKylin 操作系统的版本代号 | `代号名称` |
| `USE_OFFICIAL_SOURCE` | 是否使用目标操作系统的官方软件源 | `true` 或 `false` |
| `USE_INTRANET_SOURCE` | 是否优先使用内网软件源地址 | `true` 或 `false` |
| `WEB_PROTOCOL` | 指定 WEB 协议 | `http` 或 `https` |
| `INSTALL_EPEL` | 是否安装 EPEL 附加软件包 | `true` 或 `false` |
| `ONLY_EPEL` | 仅更换 EPEL 软件源模式 | `true` 或 `false` |
| `CLOSE_FIREWALL` | 是否关闭防火墙 | `true` 或 `false` |
| `BACKUP` | 是否备份原有软件源 | `true` 或 `false` |
| `IGNORE_BACKUP_TIPS` | 忽略覆盖备份提示（即不覆盖备份） | `true` 或 `false` |
| `UPGRADE_SOFTWARE` | 是否更新软件包 | `true` 或 `false` |
| `CLEAN_CACHE` | 是否清理下载缓存 | `true` 或 `false` |
| `PRINT_DIFF` | 是否打印源文件修改前后差异 | `true` 或 `false` |
> 部分变量存在默认值，未涉及的变量无需声明为空值（空字符串），另外如果对应功能配置不存在那么就可能会出现交互