mirror of
https://gitee.com/SuperManito/LinuxMirrors
synced 2025-11-03 16:00:26 +08:00
9.9 KiB
9.9 KiB
| 名称 | 含义 | 选项值 |
|---|---|---|
--abroad |
使用海外软件源 | 无 |
--edu |
使用中国大陆教育网软件源 | 无 |
--source |
指定软件源地址（域名或IP） | 地址 |
--source-epel |
指定 EPEL 附加软件包仓库的软件源地址（域名或IP） | 地址 |
--source-security |
指定 Debian 系统 security 仓库的软件源地址（域名或IP） | 地址 |
--source-vault |
指定 CentOS/AlmaLinux 系统 vault 仓库的软件源地址（域名或IP） | 地址 |
--source-portage |
指定 Gentoo 系统 portage 仓库的软件源地址（域名或IP） | 地址 |
--branch |
指定软件源分支（路径） | 分支名 |
--branch-epel |
指定 EPEL 附加软件包仓库的软件源分支（路径） | 分支名 |
--branch-security |
指定 Debian 系统 security 仓库的软件源分支（路径） | 分支名 |
--branch-vault |
指定 CentOS/AlmaLinux 系统 vault 仓库的软件源分支（路径） 分支名 | 分支名 |
--branch-portage |
指定 Gentoo 系统 portage 仓库的软件源分支（路径） | 分支名 |
--codename |
指定 Debian 系操作系统的版本代号 | 代号名称 |
--protocol |
指定 WEB 协议 | http 或 https |
--use-intranet-source |
是否优先使用内网软件源地址 | true 或 false |
--use-official-source |
是否使用目标操作系统的官方软件源 | true 或 false |
--install-epel |
是否安装 EPEL 附加软件包 | true 或 false |
--close-firewall |
是否关闭防火墙 | true 或 false |
--backup |
是否备份原有软件源 | true 或 false |
--upgrade-software |
是否更新软件包 | true 或 false |
--clean-cache |
是否清理下载缓存 | true 或 false |
--print-diff |
是否打印源文件修改前后差异 | true 或 false |
--only-epel |
仅更换 EPEL 软件源模式 | 无 |
--ignore-backup-tips |
忽略覆盖备份提示（即不覆盖备份） | 无 |
--help |
查看帮助菜单 | 无 |
软件源格式
<指定WEB协议>://<软件源地址>/<软件源分支>
指定软件源地址
bash <(curl -sSL https://linuxmirrors.cn/main.sh) \
--source mirror.example.com
指定软件源仓库分支
主要使用场景：目标镜像站有对应的系统镜像但是不符合本项目脚本关于软件源分支设置的默认规则
??? note "项目默认使用的系统分支名称"
项目脚本为了适配大的环境不会针对某一镜像站独特的镜像分支名称而单独适配
| 系统名称 | 涉及的分支名称 |
| --- | :---: |
| <a href="https://www.debian.org" target="_blank"><img src="/assets/images/icon/debian.svg" width="16" height="16" style="vertical-align: -0.35em"></a> Debian | debian / debian-archive |
| <a href="https://cn.ubuntu.com" target="_blank"><img src="/assets/images/icon/ubuntu.svg" width="16" height="16" style="vertical-align: -0.1em"></a> Ubuntu | ubuntu / ubuntu-ports |
| <a href="https://www.kali.org" target="_blank"><img src="/assets/images/icon/kali-linux.svg" width="16" height="16"></a> Kali Linux | kali |
| <a href="https://linuxmint.com" target="_blank"><img src="/assets/images/icon/linux-mint.ico" width="16" height="16" style="vertical-align: -0.2em"></a> Linux Mint | linuxmint / ubuntu / ubuntu-ports / debian |
| <a href="https://www.deepin.org" target="_blank"><img src="/assets/images/icon/deepin.png" width="16" height="16" style="vertical-align: -0.25em"></a> Deepin | deepin |
| <a href="https://zorin.com/os" target="_blank"><img src="/assets/images/icon/zorin-os.png" width="16" height="16" style="vertical-align: -0.15em"></a> Zorin OS | ubuntu / ubuntu-ports |
| <a href="https://www.armbian.com" target="_blank"><img src="/assets/images/icon/armbian.png" width="16" height="16" style="vertical-align: -0.2em"></a> Armbian | armbian |
| <a href="https://www.proxmox.com" target="_blank"><img src="/assets/images/icon/proxmox.svg" width="16" height="16" style="vertical-align: -0.2em"></a> Proxmox | proxmox |
| <a href="https://access.redhat.com/products/red-hat-enterprise-linux" target="_blank"><img src="/assets/images/icon/redhat.svg" width="16" height="16" style="vertical-align: -0.1em"></a> Red Hat Enterprise Linux :material-information-outline:{ title="9版本使用 <code>CentOS Stream</code>， 7、8版本使用<code>CentOS</code>" } | centos / centos-stream / centos-altarch / centos-vault |
| <a href="https://fedoraproject.org/zh-Hans" target="_blank"><img src="/assets/images/icon/fedora.ico" width="16" height="16" style="vertical-align: -0.2em"></a> Fedora | fedora |
| <a href="https://www.centos.org" target="_blank"><img src="/assets/images/icon/centos.svg" width="16" height="16" style="vertical-align: -0.2em"></a> CentOS | centos / centos-stream / centos-altarch / centos-vault |
| <a href="https://rockylinux.org" target="_blank"><img src="/assets/images/icon/rocky-linux.svg" width="16" height="16" style="vertical-align: -0.25em"></a> Rocky Linux | rocky |
| <a href="https://almalinux.org/zh-hans" target="_blank"><img src="/assets/images/icon/almalinux.svg" width="16" height="16" style="vertical-align: -0.15em"></a> AlmaLinux | almalinux / almalinux-vault |
| <a href="https://www.opencloudos.org" target="_blank"><img src="/assets/images/icon/opencloudos.png" width="16" height="16" style="vertical-align: -0.25em"></a> OpenCloudOS | opencloudos |
| <a href="https://www.openeuler.org/zh" target="_blank"><img src="/assets/images/icon/openeuler.ico" width="16" height="16" style="vertical-align: -0.2em"></a> openEuler | openeuler |
| <a href="https://www.opensuse.org" target="_blank"><img src="/assets/images/icon/opensuse.svg" width="16" height="16"></a> openSUSE | opensuse |
| <a href="https://archlinux.org" target="_blank"><img src="/assets/images/icon/arch-linux.ico" width="16" height="16" style="vertical-align: -0.15em"></a> Arch Linux | archlinux / archlinuxarm |
| <a href="https://www.alpinelinux.org" target="_blank"><img src="/assets/images/icon/alpine.png" width="16" height="16" style="vertical-align: -0.15em"></a> Alpine Linux | alpine |
| <a href="https://www.gentoo.org" target="_blank"><img src="/assets/images/icon/gentoo.svg" width="16" height="16" style="vertical-align: -0.2em"></a> Gentoo | gentoo / gentoo-portage |
请看下面的例子
bash <(curl -sSL https://linuxmirrors.cn/main.sh) \
--source mirrors.aliyun.com \
--branch rockylinux
阿里云镜像站的 Rocky Linux 镜像分支名称为 rockylinux，不符合默认规则，但是可以通过命令选项绕过脚本默认规则来实现。
部分系统会同时配置多个仓库的软件源，具体详见命令选项
单独更换 EPEL 源
!!! info "EPEL (Extra Packages for Enterprise Linux) 是由 Fedora 组织维护的一个附加软件包仓库，它主要适用于除 Fedora 操作系统以外的红帽系 Linux 发行版，配置 EPEL 仓库已成为广大用户的普遍需求，建议默认安装它"
有些时候你会发现想使用的镜像站没有 epel 镜像仓库，那么你可以在第一次运行脚本时不安装或更换 epel 源然后再单独执行下面的命令
bash <(curl -sSL https://linuxmirrors.cn/main.sh) --only-epel
恢复使用官方源
当你不小心删除了官方源的备份时可以使用此命令来恢复，使用此命令选项后将跳过选择软件源步骤
bash <(curl -sSL https://linuxmirrors.cn/main.sh) --use-official-source true
部分系统不存在官方源例如
Arch Linux，届时会自动更换成兼容性较高的阿里云镜像站
自定义 Debian Security 源
如果你想尽可能提高服务器的安全性则建议使用官方源，因为镜像同步存在延迟
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，并且建议在更新完成并重启系统后重新执行本换源脚本，因为仅更换软件源配置中的系统版本代号可能会在后期使用时产生一些兼容性问题
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，关于 Ubuntu Old Releases 分支的支持情况详见各镜像站
bash <(curl -sSL https://linuxmirrors.cn/main.sh) \
--source mirrors.ustc.edu.cn \
--branch ubuntu-old-releases
无人值守（自动化）
不通过交互完成换源操作，至少需要使用如下命令选项来实现，建议熟悉后再使用
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