TRKJ/LinuxMirrors
2
0
Fork 0
mirror of https://gitee.com/SuperManito/LinuxMirrors synced 2025-11-03 07:50:28 +08:00
Code Issues Packages Projects Releases Wiki Activity

更新文档

Browse Source
This commit is contained in:
Super Manito
2025-08-08 02:26:22 +08:00
parent 00f3b19edf
commit 4dd6bb0089
15 changed files with 127 additions and 132 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/changelog/index.en.md
View File

@@ -6,6 +6,14 @@ search:
exclude: true
---
### `2025-08-07`
* Adapted for TencentOS Server & Alibaba Cloud Linux to docker script [#00f3b19](https://github.com/SuperManito/LinuxMirrors/commit/00f3b19edfcb152f22337306e7fc25e135e75c14)
### `2025-08-03`
* Adapted for Huawei Cloud EulerOS to docker script [#b19f748](https://github.com/SuperManito/LinuxMirrors/commit/b19f748154d66fa6a385726ae899db5740499a7e)
### `2025-07-18`
* Added support for Oracle Linux OS [#76b8b08](https://github.com/SuperManito/LinuxMirrors/commit/76b8b0834ae493ed8731c83440c4a8f4dcad17dc)
@@ -28,7 +36,7 @@ search:
### `2025-05-12`
* Added "Only Replace Mirror Accelerator" command option to Docker script [#3f13f40](https://github.com/SuperManito/LinuxMirrors/commit/3f13f40111fa3631555ca7104cea21b4bb5adefa)
* Added "Only Replace Mirror Accelerator" command option to docker script [#3f13f40](https://github.com/SuperManito/LinuxMirrors/commit/3f13f40111fa3631555ca7104cea21b4bb5adefa)
### `2025-05-11`

8
docs/changelog/index.md
View File

@@ -6,6 +6,14 @@ search:
exclude: true
---
### `2025-08-07`
* Docker 脚本新增适配 TencentOS Server & Alibaba Cloud Linux 操作系统 [#00f3b19](https://github.com/SuperManito/LinuxMirrors/commit/00f3b19edfcb152f22337306e7fc25e135e75c14)
### `2025-08-03`
* Docker 脚本新增适配 Huawei Cloud EulerOS 操作系统 [#b19f748](https://github.com/SuperManito/LinuxMirrors/commit/b19f748154d66fa6a385726ae899db5740499a7e)
### `2025-07-18`
* 新增适配 Oracle Linux 操作系统 [#76b8b08](https://github.com/SuperManito/LinuxMirrors/commit/76b8b0834ae493ed8731c83440c4a8f4dcad17dc)

8
docs/changelog/index.zh-Hant.md
View File

@@ -6,6 +6,14 @@ search:
exclude: true
---
### `2025-08-07`
* Docker 腳本新增適配 TencentOS Server & Alibaba Cloud Linux 作業系統 [#00f3b19](https://github.com/SuperManito/LinuxMirrors/commit/00f3b19edfcb152f22337306e7fc25e135e75c14)
### `2025-08-03`
* Docker 腳本新增適配 Huawei Cloud EulerOS 作業系統 [#b19f748](https://github.com/SuperManito/LinuxMirrors/commit/b19f748154d66fa6a385726ae899db5740499a7e)
### `2025-07-18`
* 新增適配 Oracle Linux 作業系統 [#76b8b08](https://github.com/SuperManito/LinuxMirrors/commit/76b8b0834ae493ed8731c83440c4a8f4dcad17dc)

2
docs/index.en.md
View File

@@ -48,7 +48,7 @@ hide:
---
Just one command to run directly, zero technical barrier, no dependencies required
Documentation integrates AI search and chat, providing solutions for various scenarios
Documentation integrates AI search and chat, providing solutions for various use cases
- :material-vector-polyline:{ .lg .middle } __Wide System Support__

6
docs/index.zh-Hant.md
View File

@@ -68,7 +68,7 @@ hide:
---
最快僅需 10 秒即可完成軟體源的更換，高效能運維，節省大量時間成本
最快僅需 10 秒即可完成軟體源的更換，高效能維運，節省大量時間成本
項目經過數年的迭代與最佳化，腳本效能卓越運作穩定，場景判斷完善
- :octicons-globe-24:{ .lg .middle } __全球網絡，執行無憂__
@@ -83,9 +83,9 @@ hide:
---
腳本透過方向鍵互動逐步引導使用者選擇軟體來源配置，讓換源更簡單
此外腳本提供了豐富的命令選項，支援 CI/CD 整合與自動化維
此外腳本提供了豐富的命令選項，支援 CI/CD 整合與自動化維運
- :material-pencil-ruler-outline:{ .lg .middle } __高度可自訂__
- :material-pencil-ruler-outline:{ .lg .middle } __高度可自定義__
---

10
docs/mirrors/index.zh-Hant.md
View File

@@ -10,7 +10,7 @@ search:
???+ question "友情提示"
本項目預設提供的軟體源列表主要服務位於中國大陸的用戶，因此對您來說該頁面上可能存在許多無用的資訊。作者沒有精力去採集和維護全世界的可用軟體源，所以可能需要透過命令選項自訂使用才能滿足您的實際需求，具體預設的國際軟體源詳見下方。
本項目預設提供的軟體源列表主要服務位於中國大陸的用戶，因此對您來說該頁面上可能存在許多無用的資訊。作者沒有精力去採集和維護全世界的可用軟體源，所以可能需要透過命令選項自定義使用才能滿足您的實際需求，具體預設的國際軟體源詳見下方。
## 中國大陸 :flag-CN:
@@ -20,11 +20,11 @@ search:
???+ question "使用幫助"
:supported: 支援    :unsupport: 不支援    :incompatible: 不相容，表示軟體源分支命名不符合腳本預設規則但可以透過命令選項來使用，關於具體用法範例和各作業系統所使用的預設分支名稱[详见此处](../use/index.md#指定軟體源倉庫)
:supported: 支援    :unsupport: 不支援    :incompatible: 不相容，表示軟體源分支命名不符合腳本預設規則但可以透過命令選項來使用，關於具體用法範例和各作業系統所使用的預設分支名稱[請參見此處](../use/index.md#指定軟體源倉庫)
如果這裡沒有想使用的鏡像站那可以看看其它運行模式和命令選項。軟體源的速度區分刷新速度和下行速率，後者才是關鍵，具體請結合實際地理位置選擇嘗試，也可以透過[輔助工具網站](#工具網站)進行一些測試
如果這裡沒有想使用的鏡像站，那可以看看其它運行模式和命令選項。軟體源的速度區分刷新速度和下行速率，後者才是關鍵，具體請結合實際地理位置選擇嘗試，也可以透過[輔助工具網站](#工具網站)進行一些測試
:material-thumb-up-outline: 使用建議：速度上推薦 `中科大`、`字节(火山引擎)`，地域相容性上推薦 `阿里云`、`腾讯云`，軟體源種類上推薦 `南京大学`、`中科院`，境外、海外或複雜網路環境下不建議使用 `清华(TUNA)` 等容易阻斷的鏡像站
:material-thumb-up-outline: 使用建議：速度上推薦 `中科大`、`字節(火山引擎)`，地域相容性上推薦 `阿里雲`、`騰訊雲`，軟體源種類上推薦 `南京大學`、`中科院`，境外、海外或複雜網路環境下不建議使用 `清華(TUNA)` 等容易阻斷的鏡像站
??? note "中國大陸教育網（點擊展開查看）"
@@ -239,6 +239,6 @@ search:
<button class="md-button" title="https://tools.ipip.net/traceroute.php" onclick="window.open('https://tools.ipip.net/traceroute.php')">Tracert 路由追蹤測試</button>
<button class="md-button" title="https://ipw.cn/ipv6webcheck" onclick="window.open('https://ipw.cn/ipv6webcheck')">IPv6 接取測試</button>
!!! tip "該頁面顯示的皆為腳本預設提供可供選擇的軟體源位址，如果沒有找到你想使用的也沒有關係，腳本支援命令選項可自訂使用，詳見[進階用法](../use/index.md#命令選項進階用法)"
!!! tip "該頁面顯示的皆為腳本預設提供可供選擇的軟體源位址，如果沒有找到你想使用的也沒有關係，腳本支援命令選項可自定義使用，詳見[進階用法](../use/index.md#命令選項進階用法)"
> 本頁面涉及的旗幟圖示僅用於快速區分地理位置，不代表作者任何的政治立場，請不要過度解讀，特此聲明。

41
docs/other/index.en.md
View File

@@ -113,32 +113,25 @@ hide:
- :material-arm-flex-outline:{ .lg .middle } __Supports domestic derivative operating systems__
---
This project's script is compatible with a large number of derivative operating systems not supported by the official installation script.
Compatible with a number of derivative operating systems not supported by the official installation script. :material-information-outline:{ title="In addition to the systems displayed on the official website, it also supports special systems such as <code>Huawei Cloud EulerOS</code>&nbsp;&nbsp;<code>TencentOS Server</code>&nbsp;&nbsp;<code>Alibaba Cloud Linux</code>" }
</div>
<div class="icon-brand-section">
<div class="icon-brand-container no-select">
<a class="icon-brand-button" target="_blank" href="https://1panel.pro" title="1Panel">
<img src="/assets/images/sponsor/1panel.png" alt="1panel" />
</a>
<a class="icon-brand-button" target="_blank" href="https://www.aapanel.com" title="aaPanel" style="padding: 0 !important">
<img src="/assets/images/other/aaPanel.png" alt="aapanel" style="width: 76% !important" />
</a>
<a class="icon-brand-button" target="_blank" href="https://1ms.run" title="毫秒镜像">
<img src="/assets/images/sponsor/1ms-light.svg#only-light" alt="1ms" style="width: 97% !important" />
<img src="/assets/images/sponsor/1ms-dark.svg#only-dark" alt="1ms" style="width: 97% !important" />
</a>
<a class="icon-brand-button" target="_blank" href="https://arcadia.cool" title="One-stop code operation and maintenance platform" style="padding: 0 2px !important">
<img src="/assets/images/sponsor/arcadia-light.png#only-light" alt="Arcadia" style="width: 92% !important" />
<img src="/assets/images/sponsor/arcadia-dark.png#only-dark" alt="Arcadia" style="width: 92% !important" />
</a>
</div>
<div style="display: flex; align-items: center; gap: 8px;">
<p>After years of technical accumulation and production environment testing, it has been widely praised by the community and deeply loved by developers. It is used by major companies.</p>
<div class="icon-brand-section">
<div class="icon-brand-container no-select">
<a class="icon-brand-button" target="_blank" href="https://1panel.pro" title="1Panel">
<img src="/assets/images/sponsor/1panel.png" alt="1panel" />
</a>
<a class="icon-brand-button" target="_blank" href="https://www.aapanel.com" title="aaPanel" style="padding: 0 !important">
<img src="/assets/images/other/aaPanel.png" alt="aapanel" style="width: 76% !important" />
</a>
</div>
</div>
</div>
> :material-thumb-up-outline: After years of technical accumulation and production environment testing, it has been widely praised by the community and deeply loved by developers. It is used by major companies.
</br>
!!! tip "Docker Compose does not require a separate installation"
@@ -163,9 +156,9 @@ hide:
</div>
Due to certain uncontrollable factors, Docker Hub is generally inaccessible in mainland China, making it impossible to pull images. It is recommended to use the domestic registry mirrors listed below.
Due to some force majeure, the [Docker Hub](https://hub.docker.com) is currently inaccessible in the Chinese mainland network environment, so the image cannot be pulled normally. It is recommended to use the image warehouse source available in Chinese mainland mentioned below.
Note: The specified WEB protocol in the script is only for controlling the `Docker CE` software source. `Docker Registry` always uses the `HTTPS` protocol.
Note: The specified Web protocol in the script is only for controlling the `Docker CE` software source. `Docker Registry` always uses the `HTTPS` protocol.
!!! quote "Built-in Registry Mirrors"
@@ -248,7 +241,7 @@ hide:
```
=== "Manual Replacement"
- Install the `jq` package
=== "Debian-based / openKylin"

37
docs/other/index.md
View File

@@ -108,31 +108,24 @@ hide:
---
本项目脚本兼容大量不受官方安装脚本支持的衍生操作系统
兼容大量不受官方安装脚本支持的衍生操作系统 :material-information-outline:{ title="除官网首页展示的系统外还支持 <code>Huawei Cloud EulerOS</code>&nbsp;&nbsp;<code>TencentOS Server</code>&nbsp;&nbsp;<code>Alibaba Cloud Linux</code> 等特制系统" }
</div>
<div class="icon-brand-section">
<div class="icon-brand-container no-select">
<a class="icon-brand-button" target="_blank" href="https://1panel.cn" title="1Panel">
<img src="/assets/images/sponsor/1panel.png" alt="1panel" />
</a>
<a class="icon-brand-button" target="_blank" href="https://www.bt.cn" title="宝塔面板" style="padding: 0 !important">
<img src="/assets/images/other/bt.svg" alt="BT" />
</a>
<a class="icon-brand-button" target="_blank" href="https://1ms.run" title="毫秒镜像">
<img src="/assets/images/sponsor/1ms-light.svg#only-light" alt="1ms" style="width: 97% !important" />
<img src="/assets/images/sponsor/1ms-dark.svg#only-dark" alt="1ms" style="width: 97% !important" />
</a>
<a class="icon-brand-button" target="_blank" href="https://arcadia.cool" title="一站式代码运维平台" style="padding: 0 2px !important">
<img src="/assets/images/sponsor/arcadia-light.png#only-light" alt="Arcadia" style="width: 92% !important" />
<img src="/assets/images/sponsor/arcadia-dark.png#only-dark" alt="Arcadia" style="width: 92% !important" />
</a>
</div>
<div style="display: flex; align-items: center; gap: 8px;">
<p>经过了数年的技术沉淀与生产环境检验，广受社区好评，深得开发者喜爱，大厂都在使用</p>
<div class="icon-brand-section">
<div class="icon-brand-container no-select">
<a class="icon-brand-button" target="_blank" href="https://1panel.cn" title="1Panel">
<img src="/assets/images/sponsor/1panel.png" alt="1panel" />
</a>
<a class="icon-brand-button" target="_blank" href="https://www.bt.cn" title="宝塔面板" style="padding: 0 !important">
<img src="/assets/images/other/bt.svg" alt="BT" />
</a>
</div>
</div>
</div>
> :material-thumb-up-outline: 经过了数年的技术沉淀与生产环境检验，广受社区好评，深得开发者喜爱，大厂都在用
</br>
!!! tip "Docker Compose 不再需要独立安装"
@@ -157,7 +150,7 @@ hide:
</div>
由于一些不可抗力的因素，目前国内网络环境一般无法正常访问 Docker Hub 因此无法拉取镜像，建议使用下方提到的国内可用镜像仓库源
由于一些不可抗力的因素目前国内网络环境无法访问 [Docker Hub](https://hub.docker.com)，因此无法正常拉取镜像，建议使用下方提到的国内可用镜像仓库源
注：脚本内的指定 WEB 协议交互仅用于控制 `Docker CE` 软件源，`Docker Registry` 强制使用 `HTTPS` 协议
@@ -263,7 +256,7 @@ hide:
```
=== "手动替换"
- 安装 `jq` 软件包
=== "Debian 系 / openKylin"

45
docs/other/index.zh-Hant.md
View File

@@ -6,7 +6,7 @@ hide:
???+ question "為什麼會看到該提示？"
本項目腳本目前主要服務於簡體中文用戶，但是從立項之初就定義為了通用換源腳本，提供了諸多命令選項用於自訂使用，這也是本項目為什麼開始面向其它語言用戶使用的原因之一。腳本列印內容目前固定為簡體中文，隨著其它語言使用者的回饋和使用，腳本將來可能會支援繁體中文和英文。
本項目腳本目前主要服務於簡體中文用戶，但是從立項之初就定義為了通用換源腳本，提供了諸多命令選項用於自定義使用，這也是本項目為什麼開始面向其它語言用戶使用的原因之一。腳本列印內容目前固定為簡體中文，隨著其它語言使用者的回饋和使用，腳本將來可能會支援繁體中文和英文。
文檔使用工具進行翻譯，下方內容中的專業術語可能存在不準確的情況，歡迎修正。
@@ -28,7 +28,7 @@ hide:
bash <(curl -sSL https://raw.githubusercontent.com/SuperManito/LinuxMirrors/main/DockerInstallation.sh)
```
=== ":simple-gitee: Gitee 码云 (鏡像倉庫)"
=== ":simple-gitee: Gitee 碼雲 (鏡像倉庫)"
``` bash
bash <(curl -sSL https://gitee.com/SuperManito/LinuxMirrors/raw/main/DockerInstallation.sh)
@@ -75,7 +75,7 @@ hide:
bash <(curl -sSL https://raw.githubusercontent.com/SuperManito/LinuxMirrors/main/DockerInstallation.sh) --only-registry
```
=== ":simple-gitee: Gitee 码云 (鏡像倉庫)"
=== ":simple-gitee: Gitee 碼雲 (鏡像倉庫)"
``` bash
bash <(curl -sSL https://gitee.com/SuperManito/LinuxMirrors/raw/main/DockerInstallation.sh) --only-registry
@@ -114,31 +114,24 @@ hide:
---
本項目腳本相容於大量不受官方安裝腳本支援的衍生作業系統
相容於大量不受官方安裝腳本支援的衍生作業系統 :material-information-outline:{ title="除官網首頁展示的系統外也支援 <code>Huawei Cloud EulerOS</code>&nbsp;&nbsp;<code>TencentOS Server</code>&nbsp;&nbsp;<code>Alibaba Cloud Linux</code> 等特製系統" }
</div>
<div class="icon-brand-section">
<div class="icon-brand-container no-select">
<a class="icon-brand-button" target="_blank" href="https://1panel.pro" title="1Panel">
<img src="/assets/images/sponsor/1panel.png" alt="1panel" />
</a>
<a class="icon-brand-button" target="_blank" href="https://www.aapanel.com" title="aaPanel" style="padding: 0 !important">
<img src="/assets/images/other/aaPanel.png" alt="aapanel" style="width: 76% !important" />
</a>
<a class="icon-brand-button" target="_blank" href="https://1ms.run" title="毫秒镜像">
<img src="/assets/images/sponsor/1ms-light.svg#only-light" alt="1ms" style="width: 97% !important" />
<img src="/assets/images/sponsor/1ms-dark.svg#only-dark" alt="1ms" style="width: 97% !important" />
</a>
<a class="icon-brand-button" target="_blank" href="https://arcadia.cool" title="一站式程式碼維運平台" style="padding: 0 2px !important">
<img src="/assets/images/sponsor/arcadia-light.png#only-light" alt="Arcadia" style="width: 92% !important" />
<img src="/assets/images/sponsor/arcadia-dark.png#only-dark" alt="Arcadia" style="width: 92% !important" />
</a>
</div>
<div style="display: flex; align-items: center; gap: 8px;">
<p>經過了數年的技術沉澱與生產環境檢驗，廣受社區好評，深得開發者喜愛，大廠都在使用</p>
<div class="icon-brand-section">
<div class="icon-brand-container no-select">
<a class="icon-brand-button" target="_blank" href="https://1panel.pro" title="1Panel">
<img src="/assets/images/sponsor/1panel.png" alt="1panel" />
</a>
<a class="icon-brand-button" target="_blank" href="https://www.aapanel.com" title="aaPanel" style="padding: 0 !important">
<img src="/assets/images/other/aaPanel.png" alt="aapanel" style="width: 76% !important" />
</a>
</div>
</div>
</div>
> :material-thumb-up-outline: 經過了數年的技術沉澱與生產環境檢驗，廣受社區好評，深得開發者喜愛，大廠都在用
</br>
!!! tip "Docker Compose 不再需要獨立安裝"
@@ -163,7 +156,7 @@ hide:
</div>
由於一些不可抗力的因素，目前中國大陸網路環境一般無法正常造訪 Docker Hub 因此無法拉取鏡像，建議使用下方提到的國內可用鏡像倉庫來源
由於一些不可抗力的因素，目前中國大陸網路環境無法訪問 [Docker Hub](https://hub.docker.com)，因此無法正常拉取鏡像，建議使用下方提到的中國大陸可用鏡像倉庫來源
註：腳本內的指定 WEB 協議互動僅用於控制 `Docker CE` 軟體源，`Docker Registry` 強制使用 `HTTPS` 協議
@@ -248,7 +241,7 @@ hide:
```
=== "手動替換"
- 安裝 `jq` 軟體包
=== "Debian 係 / openKylin"
@@ -364,7 +357,7 @@ hide:
!!! quote ""
非新裝環境可能會在執行腳本後遇到 `Docker` 服務無法啟動的情況，建議重新安裝來解決，卸載不會刪除本機映像和容器數據
非新裝環境可能會在執行腳本後遇到 `Docker` 服務無法啟動的情況，建議重新安裝來解決，卸載不會刪除本機映像和容器資料
卸載指令如下：

1
docs/stylesheets/extra.css
View File

@@ -454,7 +454,6 @@
max-width: 100%;
width: fit-content;
border-radius: 6px;
border: 1px solid var(--md-default-fg-color--lightest);
}
.icon-brand-button {

4
docs/use/index.en.md
View File

@@ -463,7 +463,7 @@ hide:
| `--branch-portage` | Specify Gentoo portage repo (path) | `repo name` |
| `--branch-base-system` | Specify Linux Mint/Raspberry Pi OS base system repo (path) | `repo name` |
| `--codename` | Specify Debian/openKylin codename | `codename` |
| `--protocol` | Specify WEB protocol | `http` or `https` |
| `--protocol` | Specify web protocol | `http` or `https` |
| `--use-intranet-source` | Prefer intranet mirror address | `true` or `false` |
| `--use-official-source` | Use official mirror of target OS | `true` or `false` |
| `--use-official-source-epel` | Use official EPEL repo | `true` or `false` |
@@ -478,7 +478,7 @@ hide:
| `--pure-mode` | Pure mode, minimal output | none |
| `--help` | Show help menu | none |
> Full mirror format: `<WEB protocol>://<mirror address (domain or IP)>/<repo path>`
> Full mirror format: `<Web protocol>://<mirror address (domain or IP)>/<repo path>`
Below are some advanced usage examples

61
docs/use/index.zh-Hant.md
View File

@@ -6,7 +6,7 @@ hide:
???+ question "為什麼會看到該提示？"
本項目腳本目前主要服務於簡體中文用戶，但是從立項之初就定義為了通用換源腳本，提供了諸多命令選項用於自訂使用，這也是本項目為什麼開始面向其它語言用戶使用的原因之一。腳本列印內容目前固定為簡體中文，隨著其它語言使用者的回饋和使用，腳本將來可能會支援繁體中文和英文。
本項目腳本目前主要服務於簡體中文用戶，但是從立項之初就定義為了通用換源腳本，提供了諸多命令選項用於自定義使用，這也是本項目為什麼開始面向其它語言用戶使用的原因之一。腳本列印內容目前固定為簡體中文，隨著其它語言使用者的回饋和使用，腳本將來可能會支援繁體中文和英文。
文檔使用工具進行翻譯，下方內容中的專業術語可能存在不準確的情況，歡迎修正。
@@ -151,14 +151,14 @@ hide:
!!! tip "使用幫助"
選項卡分別代表腳本內建軟體源類型和取得腳本途徑，請在使用前檢查目標鏡像站是否支援您所使用的作業系統，可以在[軟體源列表](../mirrors/index.md)中查看。
選項卡分別代表腳本內建軟體源類型和獲取腳本途徑，請在使用前檢查目標鏡像站是否支援您所使用的作業系統，可以在[軟體源列表](../mirrors/index.md)中查看。
預設**自動備份**原有軟體源內容，如需了解更多請翻閱下方文檔。若使用過程中的某些選項令你疑惑不解，那麼在選擇軟體源後一路回車即是最佳實踐。
腳本支援在系統原有軟體源**損壞**、**缺失**、**無效**等異常環境下使用，無需額外安裝任何依賴。
!!! quote "關於軟體源的選擇（新用戶必讀）"
如果你不了解這些鏡像站那麼建議使用 `阿里雲 (相容性高、可用性強)` 或 `中國科學技術大學 (速度快)`，請不要陷入測速焦慮，內建的軟體源一般不會有太大的差異。
如果你不了解這些鏡像站，那麼建議使用 `阿里雲 (相容性高、可用性強)` 或 `中國科學技術大學 (速度快)`，請不要陷入測速焦慮，內建的軟體源一般不會有太大的差異。
本項目腳本是一個自動化維運工具，不會對鏡像站進行主觀的優劣排序和客製化適配，使用者的選擇應該是自由的，這也是為了開源軟體精神能夠得到更好的延續。
<div class="grid cards" markdown>
@@ -247,7 +247,7 @@ hide:
??? question "安裝不上？ （點擊展開查看其它解決方法）"
假如係統原有軟體源是無效的導致安裝不上 `curl` 軟體包，那麼對於 Linux 初學者來說可能會比較麻煩，這裡提供幾個在線獲取腳本的應急方法
假如系統原有軟體源是無效的導致安裝不上 `curl` 軟體包，那麼對於 Linux 初學者來說可能會比較麻煩，這裡提供幾個在線獲取腳本的應急方法
=== "使用 Python 下載"
@@ -265,7 +265,7 @@ hide:
=== "使用瀏覽器下載"
如果可以存取系統 ​​GUI 映像介面和桌面的話那可以直接在瀏覽器中開啟連結下載腳本，許多系統都會預先安裝 Firefox 火狐瀏覽器
如果可以訪問系統 ​​GUI 映像介面和桌面的話那可以直接在瀏覽器中開啟連結下載腳本，許多系統都會預先安裝 Firefox 火狐瀏覽器
之後再執行腳本即可
@@ -405,9 +405,9 @@ hide:
!!! quote ""
項目利用 [GitHub Action](https://github.com/SuperManito/LinuxMirrors/blob/main/.github/workflows/build-docs.yml#L29) 在每次提交後自動拷貝原始碼到文檔目錄作為網站資源發佈，網站託管於 :netlify: [Netlify](https://www.com)，網站託管於 :netlify: [Netlify](https://www.com)幾乎沒有使用風險。
項目利用 [GitHub Action](https://github.com/SuperManito/LinuxMirrors/blob/main/.github/workflows/build-docs.yml#L29) 在每次提交後自動拷貝原始碼到文檔目錄作為網站資源發佈，網站託管於 :netlify: [Netlify](https://www.netlify.com)，幾乎沒有使用風險。
當然你也可以使用程式碼託管倉庫的原始位址來調用，這裡只是想告訴你為什麼會有幾個不同的位址，預設的官網位址更容易記憶和存取。
當然你也可以使用程式碼託管倉庫的原始位址來調用，這裡只是想告訴你為什麼會有幾個不同的位址，預設的官網位址更容易記憶和訪問。
- #### 關於軟體源下載速度相關問題
@@ -417,7 +417,7 @@ hide:
軟體源（鏡像站）的網路延遲即 `Ping` 與下載速度沒有太大的關聯，雙方地理位置間隔的遠近不代表實際體驗，有些鏡像站下行總頻寬很高但實際測速卻並不理想，因為這與鏡像站的負載策略有關。
網路上也有很多基於 C、Python 編寫的鏡像站測速開源腳本，而本項目腳本基於 Bash Shell 編寫且不依賴任何第三方庫，Bash 是 Linux 運維中最常用的腳本語言並且絕大部分發行版都會預裝，這意味著用戶不需要安裝任何環境就能直接運行，這種便利性是其高級語言無法替代的，不過目前 Bash腳本可能不太容易實現精準測速的功能，使用其它高級語言編寫測速功能無疑是造輪子的行為。
網路上也有很多基於 C、Python 編寫的鏡像站測速開源腳本，而本項目腳本基於 Bash Shell 編寫且不依賴任何第三方庫，Bash 是 Linux 運維中最常用的腳本語言並且絕大部分發行版都會預裝，這意味著用戶不需要安裝任何環境就能直接運行，這種便利性是其他高級語言無法替代的，不過目前 Bash 腳本可能不太容易實現精準測速的功能，使用其它高級語言編寫測速功能無疑是造輪子的行為。
- #### 關於未啟用的軟體源倉庫
@@ -519,7 +519,7 @@ hide:
| <a href="https://www.opencloudos.org" title="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.openkylin.top" title="https://www.openkylin.top" target="_blank"><img src="/assets/images/icon/openkylin.ico" width="16" height="16" style="vertical-align: -0.25em"></a> **openKylin** | `openkylin` |
| <a href="https://openanolis.cn" title="https://openanolis.cn" target="_blank"><img src="/assets/images/icon/anolis.png" width="16" height="16" style="vertical-align: -0.1em"></a> **Anolis OS** | `anolis` |
| <a href="https://www.opensuse.org" title="https://www.opensuse.org" target="_blank"><img src="/assets/images/icon/opensuse.svg" width="16" height="16"></a> **openSUSE** | `opensuse` |
| <a href="https://www.opensuse.org" title="https://www.opensuse.org" target="_blank"><img src="/assets/images/icon/opensuse.svg" width="16" height="16" style="vertical-align: -0.15em"></a> **openSUSE** | `opensuse` |
| <a href="https://archlinux.org" title="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://manjaro.org" title="https://manjaro.org" target="_blank"><img src="/assets/images/icon/manjaro.svg" width="16" height="16" style="vertical-align: -0.2em"></a> **Manjaro** | `manjaro` |
| <a href="https://www.alpinelinux.org" title="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` |
@@ -542,9 +542,9 @@ hide:
- ### 單獨更換 EPEL 源
!!! info "EPEL (Extra Packages for Enterprise Linux) 是由 Fedora 組織維護的一個附加軟體包倉庫，它主要適用於除 Fedora 作業系統以外的紅帽系 Linux 發行版，配置 EPEL 倉庫已成為廣大用戶的普遍需求，建議默認安裝它"
!!! info "EPEL (Extra Packages for Enterprise Linux) 是由 Fedora 組織維護的一個附加軟體包倉庫，它主要適用於除 Fedora 作業系統以外的紅帽系 Linux 發行版，配置 EPEL 倉庫已成為廣大用戶的普遍需求，建議預設安裝它"
有些時候你會發現想使用的鏡像站沒有 EPEL 倉庫，那麼你可以在第一次運行腳本時不安裝或更換 EPEL 來源然後再單獨執行下面的命令
有些時候你會發現想使用的鏡像站沒有 EPEL 倉庫，那麼你可以在第一次運行腳本時不安裝或更換 EPEL 來源，然後再單獨執行下面的命令
``` bash
bash <(curl -sSL https://linuxmirrors.cn/main.sh) --only-epel
@@ -669,45 +669,14 @@ hide:
## 客製化腳本
如果你是其它項目的開發者希望透過本項目來製作專屬腳本那麼請參考下面提到的內容，目前已經有中國大陸教育單位鏡像站的維護者這樣做了。
如果你是其它項目的開發者希望透過本項目來製作專屬腳本，那麼請參考下面提到的內容，目前已經有中國大陸教育單位鏡像站的維護者這樣做了。
1. 首先不建議修改程式碼的底層邏輯，應盡量與本項目原始碼保持同步，腳本內容執行順序由 `main` 函數控制，程式碼邏輯清晰
2. 你可以簡單去除一些無關內容，例如將軟體源列表（陣列）`mirror_list_(default|edu|abroad|extranet|intranet)` 中的內容刪除，例如：`mirror_list_default=()`
3. 如果你想要自訂腳本列印內容可直接修改 `run_start` `run_end` `print_title` 這三個函數中的內容
4. 如果你想加入自訂 Shell 內容詳見 `main` 函數中腳本執行順序，可以在對應位置直接插入內容也可以封裝函數後調用
3. 如果你想要自定義腳本列印內容可直接修改 `run_start` `run_end` `print_title` 這三個函數中的內容
4. 如果你想加入自定義 Shell 內容請參見 `main` 函數中腳本執行順序，可以在對應位置直接插入內容也可以封裝函數後調用
5. 如果你想要縮減腳本體積那麼可以刪除一些不必要的內容，除了上面提到的軟體源列表還有一些涉及腳本工作的部分模組內容，具體如下：
1. 首先在刪除內容時應盡可能保留腳本原始結構，直接把涉及函數中的內容刪除即可，使其保留為空函數
2. 可以刪除一些不使用（作業系統）的軟體源原始內容 `gen_repo_files_xxx`，這些內容佔據了腳本 `60%` 以上的體積
3. 如果你不使用某些功能那麼可以刪除對應功能模組函數中的內容，`命令選項 handle_command_options`、`備份原有軟體源 backup_original_mirrors`、`更新軟體包 upgrade_software`
3. 如果你不使用某些功能，那麼可以刪除對應功能模組函數中的內容，`命令選項 handle_command_options`、`備份原有軟體源 backup_original_mirrors`、`更新軟體包 upgrade_software`
6. 腳本主要功能配置是由統一的變量控制的，命令選項亦是如此，這些全局變量由全大寫字母構成並遵循下劃線命名法，具體變量詳見如下表格，你只需要將這些變量聲明在腳本頭部（預留註釋區域）即可快速完成定制
| 變數名 | 意義 | 值型別 |
| :-: | :-: | :-: |
| `SOURCE` | 指定軟體源位址（網域名稱或IP） | `位址` |
| `SOURCE_EPEL` | 指定 EPEL 附加軟體包倉庫的軟體源位址（網域名稱或IP） | `位址` |
| `SOURCE_SECURITY` | 指定 Debian / Ubuntu 系統 security 倉庫的軟體源位址（網域名稱或IP） | `位址` |
| `SOURCE_VAULT` | 指定 CentOS / AlmaLinux 系統 vault 倉庫的軟體源位址（網域名稱或IP） | `位址` |
| `SOURCE_PORTAGE` | 指定 Gentoo 系統 portage 倉庫的軟體源位址（網域名稱或IP） | `位址` |
| `SOURCE_BASE_SYSTEM` | 指定 Linux Mint / Raspberry Pi OS 底層系統的軟體源位址（網域名稱或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 / Raspberry Pi OS 底層系統的軟體源倉庫（路徑） | `倉庫名稱` |
| `DEBIAN_CODENAME` | 指定 Debian 系 / openKylin 作業系統的版本代號 | `代號名稱` |
| `USE_INTRANET_SOURCE` | 是否優先使用內網軟體源位址 | `true` 或 `false` |
| `USE_OFFICIAL_SOURCE` | 是否使用目標作業系統的官方軟體源 | `true` 或 `false` |
| `USE_OFFICIAL_SOURCE_EPEL` | 是否使用 EPEL 附加軟體包的官方軟體源 | `true` 或 `false` |
| `WEB_PROTOCOL` | 指定 WEB 協議 | `http` 或 `https` |
| `INSTALL_EPEL` | 是否安裝 EPEL 附加軟體包 | `true` 或 `false` |
| `ONLY_EPEL` | 僅更換 EPEL 軟體源模式 | `true` 或 `false` |
| `BACKUP` | 是否備份原有軟體源 | `true` 或 `false` |
| `IGNORE_BACKUP_TIPS` | 忽略覆蓋備份提示（即不覆蓋備份） | `true` 或 `false` |
| `UPGRADE_SOFTWARE` | 是否更新軟體包 | `true` 或 `false` |
| `CLEAN_CACHE` | 是否在更新軟體包後清理下載快取 | `true` 或 `false` |
| `CLEAN_SCREEN` | 是否在運行前清除螢幕上的所有內容 | `true` 或 `false` |
| `PRINT_DIFF` | 是否列印原始文件修改前後差異 | `true` 或 `false` |
| `PURE_MODE` | 純淨模式，精簡列印內容 | `true` 或 `false` |
> 部分變數存在預設值，未涉及的變數無需聲明為空值（空字串），另外如果對應功能配置不存在那麼就可能會出現交互