From 74cb06dc3f2d8b51a1951c6a855393ac9026e46a Mon Sep 17 00:00:00 2001 From: SuperManito <68613938+SuperManito@users.noreply.github.com> Date: Wed, 31 Jul 2024 21:30:10 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E9=80=82=E9=85=8D=20Gentoo?= =?UTF-8?q?=20=E6=93=8D=E4=BD=9C=E7=B3=BB=E7=BB=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ChangeMirrors.sh | 257 +++++++++++++++++++++-------- README.md | 8 +- docs/assets/images/icon/gentoo.svg | 1 + docs/index.md | 3 +- docs/mirrors/index.md | 8 +- docs/use/command-options.md | 120 ++++++++------ docs/use/execution-flow.md | 10 -- docs/use/help.md | 31 +++- docs/use/index.md | 14 +- mkdocs.yml | 4 +- 10 files changed, 303 insertions(+), 153 deletions(-) create mode 100644 docs/assets/images/icon/gentoo.svg delete mode 100644 docs/use/execution-flow.md diff --git a/ChangeMirrors.sh b/ChangeMirrors.sh index 4e73ff4..2e431d9 100755 --- a/ChangeMirrors.sh +++ b/ChangeMirrors.sh @@ -1,6 +1,6 @@ #!/bin/bash ## Author: SuperManito -## Modified: 2024-07-27 +## Modified: 2024-07-31 ## License: MIT ## GitHub: https://github.com/SuperManito/LinuxMirrors ## Website: https://linuxmirrors.cn @@ -165,6 +165,7 @@ SYSTEM_OPENEULER="openEuler" SYSTEM_OPENSUSE="openSUSE" SYSTEM_ARCH="Arch" SYSTEM_ALPINE="Alpine" +SYSTEM_GENTOO="Gentoo" ## 定义系统版本文件 File_LinuxRelease=/etc/os-release @@ -175,6 +176,7 @@ File_OpenCloudOSRelease=/etc/opencloudos-release File_openEulerRelease=/etc/openEuler-release File_ArchLinuxRelease=/etc/arch-release File_AlpineRelease=/etc/alpine-release +File_GentooRelease=/etc/gentoo-release File_ProxmoxVersion=/etc/pve/.version ## 定义软件源相关文件或目录 @@ -190,12 +192,17 @@ File_ProxmoxSourceList=/etc/apt/sources.list.d/pve-no-subscription.list File_ProxmoxSourceListBackup=/etc/apt/sources.list.d/pve-no-subscription.list.bak File_LinuxMintSourceList=/etc/apt/sources.list.d/official-package-repositories.list File_LinuxMintSourceListBackup=/etc/apt/sources.list.d/official-package-repositories.list.bak -Dir_DebianExtendSource=/etc/apt/sources.list.d -Dir_DebianExtendSourceBackup=/etc/apt/sources.list.d.bak File_ArchLinuxMirrorList=/etc/pacman.d/mirrorlist File_ArchLinuxMirrorListBackup=/etc/pacman.d/mirrorlist.bak File_AlpineRepositories=/etc/apk/repositories File_AlpineRepositoriesBackup=/etc/apk/repositories.bak +File_GentooMakeConf=/etc/portage/make.conf +File_GentooMakeConfBackup=/etc/portage/make.conf.bak +File_GentooReposConf=/etc/portage/repos.conf/gentoo.conf +File_GentooReposConfBackup=/etc/portage/repos.conf/gentoo.conf.bak +Dir_GentooReposConf=/etc/portage/repos.conf +Dir_DebianExtendSource=/etc/apt/sources.list.d +Dir_DebianExtendSourceBackup=/etc/apt/sources.list.d.bak Dir_YumRepos=/etc/yum.repos.d Dir_YumReposBackup=/etc/yum.repos.d.bak Dir_openSUSERepos=/etc/zypp/repos.d @@ -238,32 +245,34 @@ function main() { function handle_command_options() { ## 命令帮助 function output_command_help() { - echo -e " -命令选项(参数名/含义/参数值)： + echo -e "\n命令选项(参数名/含义/参数值)： - --abroad 使用海外软件源 无 - --edu 使用中国大陆教育网软件源 无 - --source 指定软件源地址 地址 - --source-security 指定 Debian 的 security 软件源地址 地址 - --source-vault 指定 CentOS/AlmaLinux 的 vault 软件源地址 地址 - --use-official-source 使用操作系统官方软件源 无 - --branch 指定软件源分支(路径) 分支名 - --branch-security 指定 Debian 的 security 软件源分支(路径) 分支名 - --branch-vault 指定 CentOS/AlmaLinux 的 vault 软件源分支(路径) 分支名 - --codename 指定 Debian 系操作系统的版本代号 代号名称 - --protocol 指定 WEB 协议 http 或 https - --intranet 优先使用内网地址 true 或 false - --install-epel 安装 EPEL 附加软件包 true 或 false - --only-epel 仅更换 EPEL 软件源模式 无 - --close-firewall 关闭防火墙 true 或 false - --backup 备份原有软件源 true 或 false - --ignore-backup-tips 忽略覆盖备份提示 无 - --upgrade-software 更新软件包 true 或 false - --clean-cache 清理下载缓存 true 或 false - --print-diff 打印源文件修改前后差异 无 + --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 + --install-epel 是否安装 EPEL 附加软件包 true 或 false + --close-firewall 是否关闭防火墙 true 或 false + --backup 是否备份原有软件源 true 或 false + --upgrade-software 是否更新软件包 true 或 false + --clean-cache 是否清理下载缓存 true 或 false + --use-intranet-source 优先使用内网软件源地址 无 + --use-official-source 使用目标操作系统的官方软件源 无 + --only-epel 仅更换 EPEL 软件源模式 无 + --ignore-backup-tips 忽略覆盖备份提示 无 + --print-diff 打印源文件修改前后差异 无 -问题报告 https://github.com/SuperManito/LinuxMirrors/issues - " +问题报告 https://github.com/SuperManito/LinuxMirrors/issues\n" } ## 判断参数 @@ -291,6 +300,19 @@ function handle_command_options() { output_error "检测到 ${BLUE}$1${PLAIN} 为无效参数，请在该参数后指定软件源地址！" fi ;; + --source-epel) + if [ "$2" ]; then + echo "$2" | grep -Eq "\(|\)|\[|\]|\{|\}" + if [ $? -eq 0 ]; then + output_error "检测到无效参数值 ${BLUE}$2${PLAIN} ，请输入有效的地址！" + else + SOURCE_EPEL="$(echo "$2" | sed -e 's,^http[s]\?://,,g' -e 's,/$,,')" + shift + fi + else + output_error "检测到 ${BLUE}$1${PLAIN} 为无效参数，请在该参数后指定软件源地址！" + fi + ;; --source-security) if [ "$2" ]; then echo "$2" | grep -Eq "\(|\)|\[|\]|\{|\}" @@ -317,6 +339,19 @@ function handle_command_options() { output_error "检测到 ${BLUE}$1${PLAIN} 为无效参数，请在该参数后指定软件源地址！" fi ;; + --source-portage) + if [ "$2" ]; then + echo "$2" | grep -Eq "\(|\)|\[|\]|\{|\}" + if [ $? -eq 0 ]; then + output_error "检测到无效参数值 ${BLUE}$2${PLAIN} ，请输入有效的地址！" + else + SOURCE_PORTAGE="$(echo "$2" | sed -e 's,^http[s]\?://,,g' -e 's,/$,,')" + shift + fi + else + output_error "检测到 ${BLUE}$1${PLAIN} 为无效参数，请在该参数后指定软件源地址！" + fi + ;; ## 使用官方源 --use-official-source) USE_OFFICIAL_SOURCE="true" @@ -330,9 +365,17 @@ function handle_command_options() { output_error "检测到 ${BLUE}$1${PLAIN} 为无效参数，请在该参数后指定软件源地址！" fi ;; + --branch-epel) + if [ "$2" ]; then + SOURCE_EPEL_BRANCH="$2" + shift + else + output_error "检测到 ${BLUE}$1${PLAIN} 为无效参数，请在该参数后指定软件源地址！" + fi + ;; --branch-security) if [ "$2" ]; then - SOURCE_BRANCH_SECURITY="$2" + SOURCE_SECURITY_BRANCH="$2" shift else output_error "检测到 ${BLUE}$1${PLAIN} 为无效参数，请在该参数后指定软件源地址！" @@ -340,7 +383,15 @@ function handle_command_options() { ;; --branch-vault) if [ "$2" ]; then - SOURCE_BRANCH_VAULT="$2" + SOURCE_VAULT_BRANCH="$2" + shift + else + output_error "检测到 ${BLUE}$1${PLAIN} 为无效参数，请在该参数后指定软件源地址！" + fi + ;; + --branch-portage) + if [ "$2" ]; then + SOURCE_PORTAGE_BRANCH="$2" shift else output_error "检测到 ${BLUE}$1${PLAIN} 为无效参数，请在该参数后指定软件源地址！" @@ -356,7 +407,11 @@ function handle_command_options() { fi ;; ## 优先使用内网地址 + --use-intranet-source) + USE_INTRANET_SOURCE="true" + ;; --intranet) + ## 废弃的命令选项 if [ "$2" ]; then case "$2" in [Tt]rue | [Ff]alse) @@ -543,6 +598,8 @@ function collect_system_info() { SYSTEM_FACTIONS="${SYSTEM_ARCH}" elif [ -f $File_AlpineRelease ]; then SYSTEM_FACTIONS="${SYSTEM_ALPINE}" + elif [ -f $File_GentooRelease ]; then + SYSTEM_FACTIONS="${SYSTEM_GENTOO}" elif [ -s $File_RedHatRelease ]; then SYSTEM_FACTIONS="${SYSTEM_REDHAT}" elif [ -s $File_OpenCloudOSRelease ]; then @@ -632,7 +689,7 @@ function collect_system_info() { ;; esac ;; - "${SYSTEM_KALI}" | "${SYSTEM_DEEPIN}" | "${SYSTEM_ARCH}" | "${SYSTEM_ALPINE}") + "${SYSTEM_KALI}" | "${SYSTEM_DEEPIN}" | "${SYSTEM_ARCH}" | "${SYSTEM_ALPINE}" | "${SYSTEM_GENTOO}") # 理论全部支持或不作判断 ;; *) @@ -739,7 +796,7 @@ function collect_system_info() { "${SYSTEM_OPENSUSE}") SYNC_MIRROR_TEXT="刷新软件源" ;; - "${SYSTEM_ARCH}") + "${SYSTEM_ARCH}" | "${SYSTEM_GENTOO}") SYNC_MIRROR_TEXT="同步软件源" ;; esac @@ -750,17 +807,30 @@ function check_command_options() { if [[ "${USE_ABROAD_SOURCE}" == "true" && "${USE_EDU_SOURCE}" == "true" ]]; then output_error "两种模式不可同时使用！" fi - if [[ "${SYSTEM_JUDGMENT}" != "${SYSTEM_DEBIAN}" ]] && [[ "${SOURCE_SECURITY}" == "true" || "${SOURCE_BRANCH_SECURITY}" == "true" ]]; then - output_error "当前系统不支持使用 security 仓库相关命令选项，请确认后重试！" + if [[ "${DEBIAN_CODENAME}" ]]; then + if [[ "${SYSTEM_FACTIONS}" != "${SYSTEM_DEBIAN}" ]]; then + output_error "当前系统不支持使用指定版本代号命令选项，请确认后重试！" + fi fi - if [[ "${SYSTEM_FACTIONS}" != "${SYSTEM_DEBIAN}" ]] && [[ "${DEBIAN_CODENAME}" ]]; then - output_error "当前系统不支持使用指定版本代号命令选项，请确认后重试！" + if [[ "${INSTALL_EPEL}" == "true" || "${ONLY_EPEL}" == "true" ]]; then + if [[ "${SYSTEM_JUDGMENT}" == "${SYSTEM_FEDORA}" ]] || [[ "${SYSTEM_FACTIONS}" != "${SYSTEM_REDHAT}" && "${SYSTEM_FACTIONS}" && "${SYSTEM_OPENCLOUDOS}" || "${SYSTEM_FACTIONS}" && "${SYSTEM_OPENEULER}" ]]; then + output_error "当前系统不支持安装 EPEL 附件软件包故无法使用相关命令选项，请确认后重试！" + fi fi - if [[ "${SYSTEM_FACTIONS}" != "${SYSTEM_REDHAT}" || "${SYSTEM_JUDGMENT}" == "${SYSTEM_FEDORA}" ]] && [[ "${INSTALL_EPEL}" == "true" || "${ONLY_EPEL}" == "true" ]]; then - output_error "当前系统不支持安装 EPEL 附件软件包故无法使用相关命令选项，请确认后重试！" + if [[ "${SOURCE_SECURITY}" == "true" || "${SOURCE_SECURITY_BRANCH}" == "true" ]]; then + if [[ "${SYSTEM_JUDGMENT}" != "${SYSTEM_DEBIAN}" ]]; then + output_error "当前系统不支持使用 security 仓库相关命令选项，请确认后重试！" + fi fi - if [[ "${SYSTEM_JUDGMENT}" != "${SYSTEM_CENTOS}" && "${SYSTEM_JUDGMENT}" != "${SYSTEM_RHEL}" && "${SYSTEM_JUDGMENT}" != "${SYSTEM_ALMALINUX}" ]] && [[ "${SOURCE_VAULT}" == "true" || "${SOURCE_BRANCH_VAULT}" == "true" ]]; then - output_error "当前系统不支持使用 vault 仓库相关命令选项，请确认后重试！" + if [[ "${SOURCE_VAULT}" == "true" || "${SOURCE_VAULT_BRANCH}" == "true" ]]; then + if [[ "${SYSTEM_JUDGMENT}" != "${SYSTEM_CENTOS}" && "${SYSTEM_JUDGMENT}" != "${SYSTEM_RHEL}" && "${SYSTEM_JUDGMENT}" != "${SYSTEM_ALMALINUX}" ]]; then + output_error "当前系统不支持使用 vault 仓库相关命令选项，请确认后重试！" + fi + fi + if [[ "${SOURCE_PORTAGE}" == "true" || "${SOURCE_PORTAGE_BRANCH}" == "true" ]]; then + if [[ "${SYSTEM_JUDGMENT}" != "${SYSTEM_GENTOO}" ]]; then + output_error "当前系统不支持使用 portage 仓库相关命令选项，请确认后重试！" + fi fi } @@ -1146,6 +1216,13 @@ function backup_original_mirrors() { # /etc/apk/repositories backup_file $File_AlpineRepositories $File_AlpineRepositoriesBackup "repositories" ;; + "${SYSTEM_GENTOO}") + # /etc/portage/make.conf + backup_file $File_GentooMakeConf $File_GentooMakeConfBackup "make.conf" + # /etc/portage/repos.conf/gentoo.conf + [ -d "${Dir_GentooReposConf}" ] || mkdir -p "${Dir_GentooReposConf}" + backup_file $File_GentooReposConf $File_GentooReposConfBackup "gentoo.conf" + ;; esac fi } @@ -1261,6 +1338,9 @@ function remove_original_mirrors() { "${SYSTEM_ALPINE}") [ -f $File_AlpineRepositories ] && sed -i '1,$d' $File_AlpineRepositories ;; + "${SYSTEM_GENTOO}") + [ -f $File_GentooReposConf ] && sed -i '1,$d' $File_GentooReposConf + ;; esac } @@ -1319,6 +1399,10 @@ function change_mirrors_main() { "${SYSTEM_ALPINE}") diff_file $File_AlpineRepositoriesBackup $File_AlpineRepositories ;; + "${SYSTEM_GENTOO}") + diff_file $File_GentooMakeConfBackup $File_GentooMakeConf + diff_file $File_GentooReposConfBackup $File_GentooReposConf + ;; esac fi } @@ -1346,6 +1430,9 @@ function change_mirrors_main() { "${SYSTEM_ALPINE}") change_mirrors_Alpine ;; + "${SYSTEM_GENTOO}") + change_mirrors_Gentoo + ;; esac ## 比较差异 if [[ "${PRINT_DIFF}" == "true" ]]; then @@ -1382,6 +1469,9 @@ function change_mirrors_main() { "${SYSTEM_ALPINE}") apk update -f ;; + "${SYSTEM_GENTOO}") + emerge --sync --quiet + ;; esac if [ $? -eq 0 ]; then echo -e "\n$SUCCESS 软件源更换完毕" @@ -1398,12 +1488,6 @@ function change_mirrors_main() { ## 升级软件包 function upgrade_software() { function clean_cache() { - ## 跳过特殊系统 - case "${SYSTEM_JUDGMENT}" in - "${SYSTEM_RHEL}" | "${SYSTEM_OPENSUSE}" | "${SYSTEM_ARCH}" | "${SYSTEM_ALPINE}") - return - ;; - esac ## 交互确认 if [[ -z "${CLEAN_CACHE}" ]]; then CLEAN_CACHE="false" @@ -1447,16 +1531,27 @@ function upgrade_software() { $package_manager autoremove -y >/dev/null 2>&1 $package_manager clean packages -y >/dev/null 2>&1 ;; + "${SYSTEM_OPENSUSE}") + rm -rf /var/cache/zypp/* >/dev/null 2>&1 + ;; + "${SYSTEM_ALPINE}") + rm -rf /var/cache/apk/* >/dev/null 2>&1 + ;; + "${SYSTEM_GENTOO}") + eclean-dist --deep >/dev/null 2>&1 + eclean-packages --deep >/dev/null 2>&1 + ;; esac echo -e "\n$COMPLETE 清理完毕" } ## 跳过特殊系统 case "${SYSTEM_JUDGMENT}" in - "${SYSTEM_ARCH}" | "${SYSTEM_RHEL}") + "${SYSTEM_ARCH}") return ;; esac + ## 交互确认 if [[ -z "${UPGRADE_SOFTWARE}" ]]; then UPGRADE_SOFTWARE="false" @@ -1505,6 +1600,9 @@ function upgrade_software() { "${SYSTEM_ALPINE}") apk upgrade --no-cache ;; + "${SYSTEM_GENTOO}") + emerge --update --deep --with-bdeps=y --ask=n @world + ;; esac ## 清理缓存 clean_cache @@ -1578,7 +1676,7 @@ deb ${1} ${2}-security ${3} echo "${tips} $(gen_debian_source "${base_url}" "${SYSTEM_VERSION_CODENAME}" "${repository_sections}")" >>$File_DebianSourceList # 处理 debian-security 仓库源 - base_url="${WEB_PROTOCOL}://${SOURCE_SECURITY:-"${SOURCE}"}/${SOURCE_BRANCH_SECURITY:-"${SOURCE_BRANCH}-security"}" + base_url="${WEB_PROTOCOL}://${SOURCE_SECURITY:-"${SOURCE}"}/${SOURCE_SECURITY_BRANCH:-"${SOURCE_BRANCH}-security"}" echo "$(gen_debian_security_source "${base_url}" "${SYSTEM_VERSION_CODENAME}" "${repository_sections}")" >>$File_DebianSourceList else echo "deb ${base_url} ${SYSTEM_VERSION_CODENAME} ${repository_sections} @@ -1591,7 +1689,7 @@ $(gen_debian_source "${base_url}" "${SYSTEM_VERSION_CODENAME}" "${repository_sec $(gen_ubuntu_source "${base_url}" "${SYSTEM_VERSION_CODENAME}" "${repository_sections}")" >>$File_DebianSourceList ;; "${SYSTEM_KALI}") - repository_sections="main non-free contrib" + repository_sections="main contrib non-free non-free-firmware" echo "${tips} deb ${base_url} ${SYSTEM_VERSION_CODENAME} ${repository_sections} # deb-src ${base_url} ${SYSTEM_VERSION_CODENAME} ${repository_sections}" >>$File_DebianSourceList @@ -1618,7 +1716,7 @@ deb ${base_url} ${SYSTEM_VERSION_CODENAME} ${repository_sections} base_url="${WEB_PROTOCOL}://${SOURCE}/${base_system_source_branch}" echo "$(gen_debian_source "${base_url}" "${base_system_codename}" "${repository_sections}")" >>$File_LinuxMintSourceList # 处理 debian-security 仓库源 - base_url="${WEB_PROTOCOL}://${SOURCE_SECURITY:-"${SOURCE}"}/${SOURCE_BRANCH_SECURITY:-"${base_system_source_branch}-security"}" + base_url="${WEB_PROTOCOL}://${SOURCE_SECURITY:-"${SOURCE}"}/${SOURCE_SECURITY_BRANCH:-"${base_system_source_branch}-security"}" echo "$(gen_debian_security_source "${base_url}" "${base_system_codename}" "${repository_sections}")" >>$File_LinuxMintSourceList else # Ubuntu 版 @@ -1658,7 +1756,7 @@ deb ${base_url} ${SYSTEM_VERSION_CODENAME} ${repository_sections} fi } -## 更换基于 RedHat 系 Linux 发行版软件源 +## 更换基于 RedHat 系 Linux 发行版的软件源 function change_mirrors_RedHat() { ## 仅 EPEL 模式 if [[ "${ONLY_EPEL}" == "true" ]]; then @@ -1728,13 +1826,13 @@ function change_mirrors_RedHat() { sed -i "s|mirror.centos.org/\$contentdir|mirror.centos.org/centos-vault|g" CentOS-* sed -i "s/\$releasever/8.5.2111/g" CentOS-* # 单独处理 CentOS-Linux-Sources.repo - sed -i "s|vault.centos.org/\$contentdir|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_BRANCH_VAULT:-"centos-vault"}|g" CentOS-Linux-Sources.repo + sed -i "s|vault.centos.org/\$contentdir|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_VAULT_BRANCH:-"centos-vault"}|g" CentOS-Linux-Sources.repo ;; 7) sed -i "s|mirror.centos.org/\$contentdir|mirror.centos.org/${SOURCE_BRANCH}|g" CentOS-* sed -i "s/\$releasever/7/g" CentOS-* # 单独处理 CentOS-Sources.repo - sed -i "s|vault.centos.org/centos|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_BRANCH_VAULT:-"${SOURCE_BRANCH}"}|g" CentOS-Sources.repo + sed -i "s|vault.centos.org/centos|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_VAULT_BRANCH:-"${SOURCE_BRANCH}"}|g" CentOS-Sources.repo ;; esac sed -i "s|mirror.centos.org|${SOURCE}|g" CentOS-* @@ -1750,13 +1848,13 @@ function change_mirrors_RedHat() { # 最终版本为 8.5.2011，从 2022-02 开始切换至 centos-vault 分支 sed -i "s|mirror.centos.org/\$contentdir|mirror.centos.org/${SOURCE_BRANCH:-"centos-vault"}|g" CentOS-* sed -i "s/\$releasever/8.5.2111/g" CentOS-* - sed -i "s|vault.centos.org/\$contentdir|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_BRANCH_VAULT:-"centos-vault"}|g" CentOS-Linux-Sources.repo # 单独处理 CentOS-Linux-Sources.repo + sed -i "s|vault.centos.org/\$contentdir|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_VAULT_BRANCH:-"centos-vault"}|g" CentOS-Linux-Sources.repo # 单独处理 CentOS-Linux-Sources.repo ;; 7) # 最终版本为 7.9.2009，从 2024-07 开始切换至 centos-vault 分支 sed -i "s|mirror.centos.org/centos|mirror.centos.org/${SOURCE_BRANCH:-"centos-vault"}|g" CentOS-* sed -i "s/\$releasever/7.9.2009/g" CentOS-* - sed -i "s|vault.centos.org/centos|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_BRANCH_VAULT:-"centos-vault"}|g" CentOS-Sources.repo # 单独处理 CentOS-Sources.repo + sed -i "s|vault.centos.org/centos|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_VAULT_BRANCH:-"centos-vault"}|g" CentOS-Sources.repo # 单独处理 CentOS-Sources.repo ;; esac sed -i "s|mirror.centos.org|${SOURCE}|g" CentOS-* @@ -1772,7 +1870,7 @@ function change_mirrors_RedHat() { centos-addons.repo ;; 8) - sed -i "s|vault.centos.org/\$contentdir|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_BRANCH_VAULT:-"${SOURCE_BRANCH}"}|g" CentOS-Stream-Sources.repo # 单独处理 CentOS-Stream-Sources.repo + sed -i "s|vault.centos.org/\$contentdir|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_VAULT_BRANCH:-"${SOURCE_BRANCH}"}|g" CentOS-Stream-Sources.repo # 单独处理 CentOS-Stream-Sources.repo sed -e "s|^#baseurl=http|baseurl=${WEB_PROTOCOL}|g" \ -e "s|^mirrorlist=|#mirrorlist=|g" \ -e "s|mirror.centos.org/\$contentdir|${SOURCE}/${SOURCE_BRANCH}|g" \ @@ -1807,7 +1905,7 @@ function change_mirrors_RedHat() { 9) sed -e "s|^# baseurl=http|baseurl=${WEB_PROTOCOL}|g" \ -e "s|^mirrorlist=|#mirrorlist=|g" \ - -e "s|repo.almalinux.org/vault|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_BRANCH_VAULT:-"almalinux-vault"}|g" \ + -e "s|repo.almalinux.org/vault|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_VAULT_BRANCH:-"almalinux-vault"}|g" \ -e "s|repo.almalinux.org/almalinux|${SOURCE}/${SOURCE_BRANCH}|g" \ -i \ almalinux-* @@ -1815,7 +1913,7 @@ function change_mirrors_RedHat() { 8) sed -e "s|^mirrorlist=|#mirrorlist=|g" \ -e "s|^# baseurl=http|baseurl=${WEB_PROTOCOL}|g" \ - -e "s|repo.almalinux.org/vault|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_BRANCH_VAULT:-"almalinux-vault"}|g" \ + -e "s|repo.almalinux.org/vault|${SOURCE_VAULT:-"${SOURCE}"}/${SOURCE_VAULT_BRANCH:-"almalinux-vault"}|g" \ -e "s|repo.almalinux.org/almalinux|${SOURCE}/${SOURCE_BRANCH}|g" \ -i \ almalinux-ha.repo \ @@ -1861,7 +1959,7 @@ function change_mirrors_RedHat() { change_mirrors_or_install_EPEL # EPEL 附加软件包 } -## 更换基于 OpenCloudOS 发行版的软件源 +## 更换 OpenCloudOS 发行版软件源 function change_mirrors_OpenCloudOS() { ## 生成官方 repo 源文件 gen_repo_files_OpenCloudOS "${SYSTEM_VERSION_NUMBER:0:1}" @@ -1885,7 +1983,7 @@ function change_mirrors_OpenCloudOS() { change_mirrors_or_install_EPEL # EPEL 附加软件包 } -## 更换基于 openEuler 发行版的软件源 +## 更换 openEuler 发行版软件源 function change_mirrors_openEuler() { ## 生成官方 repo 源文件 gen_repo_files_openEuler @@ -1907,7 +2005,7 @@ function change_mirrors_openEuler() { change_mirrors_or_install_EPEL # EPEL 附加软件包 } -## 更换基于 openSUSE 发行版的软件源 +## 更换 openSUSE 发行版软件源 function change_mirrors_openSUSE() { ## 生成官方 repo 源文件 case "${SYSTEM_ID}" in @@ -1973,7 +2071,7 @@ function change_mirrors_openSUSE() { esac } -## 更换基于 Arch Linux 发行版的软件源 +## 更换 Arch Linux 发行版软件源 function change_mirrors_ArchLinux() { ## 使用官方源 if [[ "${USE_OFFICIAL_SOURCE}" == "true" ]]; then @@ -1994,7 +2092,7 @@ function change_mirrors_ArchLinux() { esac } -## 更换基于 Alpine Linux 发行版的软件源 +## 更换 Alpine Linux 发行版软件源 function change_mirrors_Alpine() { ## 使用官方源 if [[ "${USE_OFFICIAL_SOURCE}" == "true" ]]; then @@ -2012,6 +2110,34 @@ function change_mirrors_Alpine() { ${WEB_PROTOCOL}://${SOURCE}/${SOURCE_BRANCH}/${version_name}/community" >>$File_AlpineRepositories } +## 更换 Gentoo 发行版软件源 +function change_mirrors_Gentoo() { + ## 使用官方源 + if [[ "${USE_OFFICIAL_SOURCE}" == "true" ]]; then + grep -Eq "^GENTOO_MIRRORS=" $File_GentooMakeConf + if [ $? -eq 0 ]; then + sed -i "/^GENTOO_MIRRORS=/d" $File_GentooMakeConf + fi + [ -f $File_GentooReposConf ] && rm -rf $File_GentooReposConf + return + fi + ## 修改源 + grep -Eq "^GENTOO_MIRRORS=" $File_GentooMakeConf + if [ $? -eq 0 ]; then + sed -i "s|^GENTOO_MIRRORS=.*|GENTOO_MIRRORS=\"${WEB_PROTOCOL}://${SOURCE}/${SOURCE_BRANCH}\"|g" $File_GentooMakeConf + else + echo -e "\nGENTOO_MIRRORS=\"${WEB_PROTOCOL}://${SOURCE}/${SOURCE_BRANCH}\"" >>$File_GentooMakeConf + fi + echo "[DEFAULT] +main-repo = gentoo + +[gentoo] +location = /usr/portage +sync-type = rsync +sync-uri = rsync://${SOURCE_PORTAGE:-"${SOURCE}"}/${SOURCE_PORTAGE_BRANCH:-"gentoo-portage"} +auto-sync = yes" >$File_GentooReposConf +} + ## EPEL (Extra Packages for Enterprise Linux) 附加软件包 - 安装或更换软件源 function change_mirrors_or_install_EPEL() { if [[ "${INSTALL_EPEL}" != "true" ]]; then @@ -2061,12 +2187,11 @@ function change_mirrors_or_install_EPEL() { if [[ "${USE_OFFICIAL_SOURCE}" == "true" ]]; then return fi - ## 修改源（仓库分支名称暂时固定为 epel） - local epel_branch="epel" + ## 修改源 sed -e "s|^#baseurl=http\(s\)\?|baseurl=${WEB_PROTOCOL}|g" \ -e "s|^metalink=|#metalink=|g" \ - -e "s|download.example/pub/epel|${SOURCE}/${epel_branch}|g" \ - -e "s|download.fedoraproject.org/pub/epel|${SOURCE}/${epel_branch}|g" \ + -e "s|download.example/pub/epel|${SOURCE_EPEL:-"${SOURCE}"}/${SOURCE_EPEL_BRANCH:-"epel"}|g" \ + -e "s|download.fedoraproject.org/pub/epel|${SOURCE_EPEL:-"${SOURCE}"}/${SOURCE_EPEL_BRANCH:-"epel"}|g" \ -i \ $Dir_YumRepos/epel* } diff --git a/README.md b/README.md index 267721d..2373f21 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@

- GNU/Linux 更换系统软件源脚本 + GNU/Linux 更换系统软件源脚本及 Docker 安装脚本

@@ -86,11 +86,15 @@  Alpine Linux v3 / edge + +  Gentoo + all +

- 使用方法    软件源    常见问题    Docker 一键安装(额外脚本) + 使用方法    软件源    常见问题    Docker 安装(额外脚本)

diff --git a/docs/assets/images/icon/gentoo.svg b/docs/assets/images/icon/gentoo.svg new file mode 100644 index 0000000..8467343 --- /dev/null +++ b/docs/assets/images/icon/gentoo.svg @@ -0,0 +1 @@ +Gentoo Logo Vector \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index 7738de9..10a9deb 100644 --- a/docs/index.md +++ b/docs/index.md @@ -44,7 +44,7 @@ hide: --- - 脚本使换源变得更简单，默认交互运行，逐步引导用户更换软件源 + 脚本使换源变得更简单，默认交互运行，逐步引导用户选择软件源配置 同时提供了强大的命令选项，可实现各种定制需求和无交互操作 - :material-scale-balance:{ .lg .middle } __开源，MIT__ @@ -82,6 +82,7 @@ hide: | openSUSE | Leep 15 / Tumbleweed | | Arch Linux | all | | Alpine Linux | v3 / edge | +| Gentoo | all | diff --git a/docs/mirrors/index.md b/docs/mirrors/index.md index dc6d194..4eae48c 100644 --- a/docs/mirrors/index.md +++ b/docs/mirrors/index.md @@ -10,7 +10,7 @@ hide: > 下方列表中的镜像站均支持 `Debian` `Ubuntu` `CentOS` `openSUSE` `openEuler` 软件源，列表根据单位性质、地理位置、名称长度进行排序，与实际速度无关 -| 镜像站 | IPv6 | Arch Linux | Kali Linux | Deepin | Rocky Linux | AlmaLinux | EPEL | Fedora | OpenCloudOS | Alpine Linux | Armbian | Proxmox | Linux Mint | +| 镜像站 | IPv6 | Arch Linux | Kali Linux | Deepin | Rocky Linux | AlmaLinux | EPEL :material-information-outline:{ title="EPEL (Extra Packages for Enterprise Linux) 是由 Fedora 组织维护的一个附加软件包仓库，它主要适用于除 Fedora 操作系统以外的红帽系 Linux 发行版" } | Fedora | OpenCloudOS | Alpine Linux | Armbian | Proxmox | Linux Mint | | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | | [阿里云](https://mirrors.aliyun.com "mirrors.aliyun.com") | :supported: | :supported: | :supported: | :supported: | :incompatible: | :supported: | :supported: | :supported: | :unsupport: | :supported: | :supported: | :unsupport: | :supported: | | [腾讯云](https://mirrors.tencent.com "mirrors.tencent.com") | :unsupport: | :supported: | :supported: | :unsupport: | :supported: | :supported: | :supported: | :supported: | :supported: | :supported: | :unsupport: | :unsupport: | :supported: | @@ -47,7 +47,6 @@ hide: | 浙江大学 | [mirrors.zju.edu.cn](https://mirrors.zju.edu.cn "https://mirrors.zju.edu.cn") | | 山东大学 | [mirrors.sdu.edu.cn](https://mirrors.sdu.edu.cn "https://mirrors.sdu.edu.cn") | | 吉林大学 | [mirrors.jlu.edu.cn](https://mirrors.jlu.edu.cn "https://mirrors.jlu.edu.cn") | - | 上海交通大学 | [mirror.sjtu.edu.cn](https://mirror.sjtu.edu.cn "https://mirror.sjtu.edu.cn") | | 上海科技大学 | [mirrors.shanghaitech.edu.cn](https://mirrors.shanghaitech.edu.cn "https://mirrors.shanghaitech.edu.cn") | | 南方科技大学 | [mirrors.sustech.edu.cn](https://mirrors.sustech.edu.cn "https://mirrors.sustech.edu.cn") | | 南京邮电大学 | [mirrors.njupt.edu.cn](https://mirrors.njupt.edu.cn "https://mirrors.njupt.edu.cn") | @@ -60,6 +59,7 @@ hide: | 西安交通大学 | [mirrors.xjtu.edu.cn](https://mirrors.xjtu.edu.cn "https://mirrors.xjtu.edu.cn") | | 江西理工大学 | [mirrors.jxust.edu.cn](https://mirrors.jxust.edu.cn "https://mirrors.jxust.edu.cn") | | 重庆邮电大学 | [mirrors.cqupt.edu.cn](https://mirrors.cqupt.edu.cn "https://mirrors.cqupt.edu.cn") | + | 华中科技大学 | [mirrors.hust.edu.cn](https://mirrors.hust.edu.cn "https://mirrors.hust.edu.cn") | | 南阳理工学院 | [mirror.nyist.edu.cn](https://mirror.nyist.edu.cn "https://mirror.nyist.edu.cn") | | 武昌首义学院 | [mirrors.wsyu.edu.cn](https://mirrors.wsyu.edu.cn "https://mirrors.wsyu.edu.cn") | | 荆楚理工学院 | [mirrors.jcut.edu.cn](https://mirrors.jcut.edu.cn "https://mirrors.jcut.edu.cn") | @@ -67,6 +67,8 @@ hide: | 中国科学技术大学 | [mirrors.ustc.edu.cn](https://mirrors.ustc.edu.cn "https://mirrors.ustc.edu.cn") | | 西北农林科技大学 | [mirrors.nwafu.edu.cn](https://mirrors.nwafu.edu.cn "https://mirrors.nwafu.edu.cn") | | 大连东软信息学院 | [mirrors.neusoft.edu.cn](https://mirrors.neusoft.edu.cn "https://mirrors.neusoft.edu.cn") | + | 上海交通大学（思源） | [mirror.sjtu.edu.cn](https://mirror.sjtu.edu.cn "https://mirror.sjtu.edu.cn") | + | 上海交通大学（致远） | [mirrors.sjtug.sjtu.edu.cn](https://mirrors.sjtug.sjtu.edu.cn "https://mirrors.sjtug.sjtu.edu.cn") | ## 海外地区 :flag-world-map: @@ -78,6 +80,7 @@ hide: | 亚洲 · 01Link · 香港 :flag-HK: | [mirror.01link.hk](https://mirror.01link.hk "https://mirror.01link.hk") | | 亚洲 · 新加坡国立大学(NUS) · 新加坡 :flag-SG: | [download.nus.edu.sg/mirror](https://download.nus.edu.sg "https://download.nus.edu.sg") | | 亚洲 · SG.GS · 新加坡 :flag-SG: | [mirror.sg.gs](https://mirror.sg.gs "https://mirror.sg.gs") | + | 亚洲 · xTom · 新加坡 :flag-SG: | [mirrors.xtom.sg](https://mirrors.xtom.sg "https://mirrors.xtom.sg") | | 亚洲 · 自由软件实验室(NCHC) · 台湾 :flag-TW: | [free.nchc.org.tw](https://free.nchc.org.tw "https://free.nchc.org.tw") | | 亚洲 · OSS Planet · 台湾 :flag-TW: | [mirror.ossplanet.net](https://mirror.ossplanet.net "https://mirror.ossplanet.net") | | 亚洲 · 国立阳明交通大学 · 台湾 :flag-TW: | [linux.cs.nctu.edu.tw](https://linux.cs.nctu.edu.tw "https://linux.cs.nctu.edu.tw") | @@ -174,6 +177,7 @@ hide: | 亚洲 · 01Link · 香港 :flag-HK: | [mirror.01link.hk](https://mirror.01link.hk "https://mirror.01link.hk") | | 亚洲 · 新加坡国立大学(NUS) · 新加坡 :flag-SG: | [download.nus.edu.sg/mirror](https://download.nus.edu.sg "https://download.nus.edu.sg") | | 亚洲 · SG.GS · 新加坡 :flag-SG: | [mirror.sg.gs](https://mirror.sg.gs "https://mirror.sg.gs") | + | 亚洲 · xTom · 新加坡 :flag-SG: | [mirrors.xtom.sg](https://mirrors.xtom.sg "https://mirrors.xtom.sg") | | 亚洲 · 自由软件实验室(NCHC) · 台湾 :flag-TW: | [free.nchc.org.tw](https://free.nchc.org.tw "https://free.nchc.org.tw") | | 亚洲 · OSS Planet · 台湾 :flag-TW: | [mirror.ossplanet.net](https://mirror.ossplanet.net "https://mirror.ossplanet.net") | | 亚洲 · 国立阳明交通大学 · 台湾 :flag-TW: | [linux.cs.nctu.edu.tw](https://linux.cs.nctu.edu.tw "https://linux.cs.nctu.edu.tw") | diff --git a/docs/use/command-options.md b/docs/use/command-options.md index 3ddf4d4..379a1c3 100644 --- a/docs/use/command-options.md +++ b/docs/use/command-options.md @@ -2,70 +2,76 @@ | - | - | :-: | | `--abroad` | 使用海外软件源 | 无 | | `--edu` | 使用中国大陆教育网软件源 | 无 | -| `--source` | 指定软件源地址(域名或IP) | 地址 | -| `--source-security` | 指定 Debian 的 security 软件源地址(域名或IP) | 地址 | -| `--source-vault` | 指定 CentOS/AlmaLinux 的 vault 软件源地址(域名或IP) | 地址 | -| `--use-official-source` | 使用操作系统官方软件源 | 无 | -| `--branch` | 指定软件源分支(路径) | 分支名 | -| `--branch-security` | 指定 Debian 的 security 软件源分支(路径) | 分支名 | -| `--branch-vault` | 指定 CentOS/AlmaLinux 的 vault 软件源分支(路径) | 分支名 | +| `--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` | -| `--intranet` | 优先使用内网地址 | `true` 或 `false` | -| `--install-epel` | 安装 EPEL 附加软件包 | `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` | +| `--use-intranet-source` | 优先使用内网软件源地址 | 无 | +| `--use-official-source` | 使用目标操作系统的官方软件源 | 无 | | `--only-epel` | 仅更换 EPEL 软件源模式 | 无 | -| `--close-firewall` | 关闭防火墙 | `true` 或 `false` | -| `--backup` | 备份原有软件源 | `true` 或 `false` | | `--ignore-backup-tips` | 忽略覆盖备份提示（即不覆盖备份） | 无 | -| `--upgrade-software` | 更新软件包 | `true` 或 `false` | -| `--clean-cache` | 清理下载缓存 | `true` 或 `false` | -| `--print-diff` | 打印源文件修改前后差异 | `true` 或 `false` | | `--help` | 查看帮助菜单 | 无 | > 软件源格式 `<指定WEB协议>://<软件源地址>/<软件源分支>` -## 示例 +--- -### 指定软件源地址 - -若不想通过交互选择默认提供的软件源，你可以使用该命令选项指定软件源地址 +## 指定软件源地址 ``` { .bash .no-copy } bash <(curl -sSL https://linuxmirrors.cn/main.sh) \ --source mirror.example.com ``` -### 指定软件源分支 +--- -使用场景：目标镜像站有对应的系统镜像但是不符合本项目脚本关于软件源分支设置的默认规则 +## 指定软件源仓库分支 -项目脚本为了适配大的环境不会针对某一镜像站独特的镜像分支名称而单独适配，默认使用的分支名称如下 +主要使用场景：目标镜像站有对应的系统镜像但是不符合本项目脚本关于软件源分支设置的默认规则 + +??? note "项目默认使用的系统分支名称" + + 项目脚本为了适配大的环境不会针对某一镜像站独特的镜像分支名称而单独适配 + + | 系统名称 | 涉及的分支名称 | + | --- | :---: | + | Debian | debian / debian-archive | + | Ubuntu | ubuntu / ubuntu-ports | + | Kali Linux | kali | + | Linux Mint | linuxmint / ubuntu / ubuntu-ports / debian | + | Deepin | deepin | + | 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 | + | openSUSE | opensuse | + | Arch Linux | archlinux / archlinuxarm | + | Alpine Linux | alpine | + | Gentoo | gentoo / gentoo-portage | -
-| 系统名称 | 涉及的分支名称 | -| --- | :---: | -| Debian | debian / debian-archive | -| Ubuntu | ubuntu / ubuntu-ports | -| Kali Linux | kali | -| Linux Mint | linuxmint / ubuntu / ubuntu-ports / debian | -| Deepin | deepin | -| Armbian | armbian | -| Proxmox | proxmox | -| Red Hat Enterprise Linux :material-information-outline:{ title="9版本使用 Rocky Linux， 7、8版本使用CentOS" } | centos / centos-altarch / rocky | -| Fedora | fedora | -| CentOS | centos / centos-stream / centos-altarch / centos-vault | -| Rocky Linux | rocky | -| AlmaLinux | almalinux / almalinux-vault | -| OpenCloudOS | opencloudos | -| openEuler | openeuler | -| openSUSE | opensuse | -| Arch Linux | archlinux / archlinuxarm | -| Alpine Linux | alpine | -
请看下面的例子 -``` { .bash title="使用阿里云的 Rocky Linux 软件源" } +``` { .bash title="使用阿里云镜像站的 Rocky Linux 软件源" } bash <(curl -sSL https://linuxmirrors.cn/main.sh) \ --source mirrors.aliyun.com \ --branch rockylinux @@ -73,9 +79,11 @@ bash <(curl -sSL https://linuxmirrors.cn/main.sh) \ 阿里云镜像站的 Rocky Linux 镜像分支名称为 [`rockylinux`](https://mirrors.aliyun.com/rockylinux)，不符合默认规则，但是可以通过命令选项绕过脚本默认规则来实现。 -什么是默认规则？参考这几个例子： `Debian GNU/Linux => debian`、`Rocky Linux => rocky`、`AlmaLinux => almalinux` +> 部分系统会同时配置多个仓库的软件源，具体详见命令选项 -### 单独更换 EPEL 源 +--- + +## 单独更换 EPEL 源 !!! info "EPEL (Extra Packages for Enterprise Linux) 是由 Fedora 组织维护的一个附加软件包仓库，它主要适用于除 Fedora 操作系统以外的红帽系 Linux 发行版，配置 EPEL 仓库已成为广大用户的普遍需求，建议默认安装它" @@ -85,7 +93,9 @@ bash <(curl -sSL https://linuxmirrors.cn/main.sh) \ bash <(curl -sSL https://linuxmirrors.cn/main.sh) --only-epel ``` -### 恢复使用官方源 +--- + +## 恢复使用官方源 当你不小心删除了官方源的备份时可以使用此命令来恢复，使用此命令选项后将跳过选择软件源步骤 @@ -94,7 +104,9 @@ bash <(curl -sSL https://linuxmirrors.cn/main.sh) --use-official-source ``` > 部分系统不存在官方源例如 `Arch Linux`，届时会自动更换成兼容性较高的阿里云镜像站 -### 自定义 Debian Security 源 +--- + +## 自定义 Debian Security 源 如果你想尽可能提高服务器的安全性则建议使用官方源，因为镜像同步存在延迟 @@ -104,7 +116,9 @@ bash <(curl -sSL https://linuxmirrors.cn/main.sh) \ --branch-security debian-security ``` -### 指定 Debian 系 Linux 操作系统的版本代号 +--- + +## 指定 Debian 系 Linux 操作系统的版本代号 大多数情况下自定义版本代号用于更换系统版本，请看下面的例子 @@ -128,7 +142,9 @@ bash <(curl -sSL https://linuxmirrors.cn/main.sh) \ sed -i "s/$(lsb_release -cs)/指定版本代号/g" /etc/apt/sources.list ``` -### 更换 Ubuntu EOF版本软件源 +--- + +## 更换 Ubuntu EOF版本软件源 !!! info "EOF 为生命周期结束的缩写（End Of Life），Ubuntu 迭代速度较快一般非长期支持(LTS)版本的生命周期只有9个月。官方会定期从主仓库移除不在生命周期内的版本仓库目录，届时可能就需要使用镜像站的 `Ubuntu Old Releases` 分支" @@ -140,9 +156,11 @@ bash <(curl -sSL https://linuxmirrors.cn/main.sh) \ --branch ubuntu-old-releases ``` -## 无人值守 +--- -不通过交互完成换源操作，需要使用大量命令选项来实现，建议熟悉后再使用 +## 无人值守（自动化） + +不通过交互完成换源操作，至少需要使用如下命令选项来实现，建议熟悉后再使用 ``` { .bash .no-copy title="参考命令" } bash <(curl -sSL https://linuxmirrors.cn/main.sh) \ diff --git a/docs/use/execution-flow.md b/docs/use/execution-flow.md deleted file mode 100644 index 51c2929..0000000 --- a/docs/use/execution-flow.md +++ /dev/null @@ -1,10 +0,0 @@ - - 选择软件源 `交互` - - 检测到存在对应内网地址选择是否切换 `交互` - - 选择软件源使用的 WEB 协议 `交互` - - 检测如果是 RHEL/CentOS/Rocky 系统选择是否安装/覆盖 EPEL 扩展包软件源 `交互` - - 检测防火墙和SELINUX如果开启选择是否关闭 `交互` - - 备份原有源 - - 检测如果存在重复的备份文件选择是否覆盖 `交互` - - 更换软件源 - - 选择是否更新软件包 `交互` - - 选择是否清理已下载的软件包缓存 `交互` diff --git a/docs/use/help.md b/docs/use/help.md index 68f3dd0..27888d9 100644 --- a/docs/use/help.md +++ b/docs/use/help.md @@ -1,4 +1,3 @@ - ## 关于报错 Command not found !!! quote "" @@ -16,13 +15,11 @@ === "RedHat 系 / OpenCloudOS / openEuler" ``` sh - yum install -y curl || dnf install -y curl + dnf install -y curl || yum install -y curl ``` > `Red Hat Enterprise Linux`   `CentOS`   `Rocky Linux`   `AlmaLinux`   `Fedora`   `OpenCloudOS`   `openEuler` - 新装系统需要先执行一遍更新 `yum makecache` - === "openSUSE" ``` sh @@ -41,6 +38,12 @@ apk --no-cache add -f curl bash ``` + === "Gentoo" + + ``` sh + emerge --ask curl + ``` + ## 关于开启 SSH 远程登录的方法 !!! quote "" @@ -70,6 +73,8 @@ ps -ef | grep -q ssh ; [ $? -eq 0 ] && systemctl restart sshd || systemctl enable --now sshd ``` + > 命令仅供参考，只适配了部分常见发行版 + ## 还原已备份的软件源 !!! quote "" @@ -77,7 +82,7 @@ === "Debian 系" ``` sh - cp -rvf /etc/apt/sources.list.bak /etc/apt/sources.list + cp -rf /etc/apt/sources.list.bak /etc/apt/sources.list apt-get update ``` @@ -86,7 +91,7 @@ === "RedHat 系 / OpenCloudOS / openEuler" ``` sh - cp -rvf /etc/yum.repos.d.bak /etc/yum.repos.d + cp -rf /etc/yum.repos.d.bak /etc/yum.repos.d yum makecache ``` @@ -95,24 +100,32 @@ === "openSUSE" ``` sh - cp -rvf /etc/zypp/repos.d.bak /etc/zypp/repos.d + cp -rf /etc/zypp/repos.d.bak /etc/zypp/repos.d zypper ref ``` === "Arch Linux" ``` sh - cp -rvf /etc/pacman.d/mirrorlist.bak /etc/pacman.d/mirrorlist + cp -rf /etc/pacman.d/mirrorlist.bak /etc/pacman.d/mirrorlist pacman -Sy ``` === "Alpine Linux" ``` sh - cp -rvf /etc/apk/repositories.bak /etc/apk/repositories + cp -rf /etc/apk/repositories.bak /etc/apk/repositories apk update -f ``` + === "Gentoo" + + ``` sh + cp -rf /etc/portage/make.conf.bak /etc/portage/make.conf + [ -d /etc/portage/repos.conf ] && cp -rf /etc/portage/repos.conf/gentoo.conf.bak /etc/portage/repos.conf/gentoo.conf + emerge --sync --quiet + ``` + ## 其它 !!! quote "" diff --git a/docs/use/index.md b/docs/use/index.md index e8310e3..0d050cb 100644 --- a/docs/use/index.md +++ b/docs/use/index.md @@ -3,6 +3,8 @@ hide: - feedback --- +!!! question "请在使用前检查目标镜像站是否支持您所使用的操作系统" + ## 一键执行命令 === ":material-home: 中国大陆（默认）" @@ -11,8 +13,6 @@ hide: bash <(curl -sSL https://linuxmirrors.cn/main.sh) ``` - !!! question "请在使用前检查目标镜像站是否支持您所使用的操作系统" - ??? quote "原始执行命令" === ":simple-github: GitHub" @@ -37,8 +37,6 @@ hide: 1. 通过 `--edu` 命令选项来使用中国大陆教育单位软件源 - !!! question "请在使用前检查目标镜像站是否支持您所使用的操作系统" - ??? quote "原始执行命令" === ":simple-github: GitHub" @@ -63,8 +61,6 @@ hide: 1. 通过 `--abroad` 命令选项来使用海外软件源 - !!! question "请在使用前检查目标镜像站是否支持您所使用的操作系统" - ??? quote "原始执行命令" === ":simple-github: GitHub" @@ -89,19 +85,19 @@ hide: --- - 切换命令为 `sudo -i` 或 `su root`，不同系统环境使用的命令不一样，因为有些系统没有在初始安装时为 ROOT 用户设置固定密码（例如Ubuntu）所以需要使用 `sudo` 指令来提权 + 切换命令为 `sudo -i` 或 `su root`。不同系统使用的命令不同，因为有些系统没有在初始安装时为 ROOT 账户设置密码（例如 Ubuntu），故需要使用 `sudo -i` 命令来切换至 ROOT - :material-numeric-2:{style="color: #3CA7E5" .lg} __建议使用 `SSH` 远程工具__ --- - 如果你使用的系统终端界面不支持 `UTF-8` 编码那么将无法正常显示中文内容，导致无法查看交互内容。大部分系统都会自动开启该服务，否则请参考[启用方法](help.md#关于开启-ssh-远程登录的方法) + 如果你使用的系统终端界面无法正常显示中文内容那么将导致无法查看交互内容。部分系统会自动开启 SSH 服务，否则请参考[启用方法](help.md#关于开启-ssh-远程登录的方法) - :material-numeric-3:{style="color: #3CA7E5" .lg} __如果是在新系统上首次执行脚本__ --- - 当前执行方式依赖 `curl` 指令来获取脚本内容并执行，所以需要先通过包管理工具来安装该软件包，否则会报错 `Command not found`，安装方法详见[常见问题](help.md#关于报错-command-not-found)，若无法安装就复制[源码](https://gitee.com/SuperManito/LinuxMirrors/raw/main/ChangeMirrors.sh)到本地新建`.sh`脚本，然后通过 `bash` 手动执行 + 当前执行方式依赖 `curl` 指令获取脚本内容并执行，但部分操作系统没有预装此软件包，届时则会报错 `Command not found`，安装方法详见[常见问题](help.md#关于报错-command-not-found)。还可自行复制[源码](https://gitee.com/SuperManito/LinuxMirrors/raw/main/ChangeMirrors.sh)至本地新建任意名称的 `.sh` 脚本，粘贴源码内容后通过 `bash` 指令手动执行 diff --git a/mkdocs.yml b/mkdocs.yml index 9774f63..7e07bbd 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -146,9 +146,7 @@ nav: - "使用方法": - "使用方法": use/index.md - "常见问题": use/help.md - - "执行流程": use/execution-flow.md - - "高级用法": - - "命令选项": use/command-options.md + - "命令选项": use/command-options.md - "软件源列表": mirrors/index.md - "其它工具": other/index.md - "社区": community/index.md