Skip to content

Commit

Permalink
更新文档
Browse files Browse the repository at this point in the history
  • Loading branch information
SuperManito committed Dec 29, 2024
1 parent 22d6202 commit 9cb5eef
Show file tree
Hide file tree
Showing 5 changed files with 121 additions and 69 deletions.
18 changes: 17 additions & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,28 @@ hide:
- footer
---

<div class="grid" markdown>
<figure style="margin: 0" markdown>
![](assets/images/brand/light/2.png#only-light){ width="300" }
![](assets/images/brand/dark/2.png#only-dark){ width="300" }
<figcaption>GNU/Linux 更换系统软件源脚本及 Docker 安装脚本</figcaption>
<figcaption>脚本使换源更简单</figcaption>
</figure>
<figure style="margin: 0; width: 500px; display: flex; flex-direction: column; justify-content: center" markdown>
=== "GNU/Linux"

``` { .bash title="一键命令" }
bash <(curl -sSL https://linuxmirrors.cn/main.sh)
```

=== "Docker"

``` { .bash title="一键命令" }
bash <(curl -sSL https://linuxmirrors.cn/docker.sh)
```

</figure>
</div>

<div class="grid" markdown>

Expand All @@ -27,7 +43,7 @@ hide:
---

深入考察了国内镜像站的系统适配情况,测试了下载速度与IPv6兼容性
另外提供全网搜集的中国大陆教育网镜像站和海外镜像站供用户选择
另外提供全网搜集的国内教育网镜像站和海外镜像站供用户选择

- :material-rocket-launch-outline:{ .lg .middle } __零技术门槛__

Expand Down
14 changes: 7 additions & 7 deletions docs/mirrors/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ hide:

如果这里没有想使用的镜像站那可以看看其它运行模式和命令选项。软件源的速度区分刷新速度和下行速率,后者才是关键,具体请结合实际地理位置选择尝试,还可以通过[辅助工具网站](#工具网站)进行一些测试

:material-thumb-up-outline: 使用建议:速度上推荐 `中科大`、`字节跳动(火山引擎)`,地域兼容性上推荐 `阿里云`、`腾讯云`,海外或复杂网络环境下不建议使用 `清华(TUNA)` 等容易阻断的镜像站
:material-thumb-up-outline: 使用建议:速度上推荐 `中科大`、`字节跳动(火山引擎)`,地域兼容性上推荐 `阿里云`、`腾讯云`,境外、海外或复杂网络环境下不建议使用 `清华(TUNA)` 等容易阻断的镜像站

??? note "中国大陆教育网(点击展开查看)"

Expand Down Expand Up @@ -241,25 +241,25 @@ hide:
| 非洲 · Liquid Telecom · 肯尼亚 :flag-KE: | [mirror.liquidtelecom.com](https://mirror.liquidtelecom.com "https://mirror.liquidtelecom.com") |
| 非洲 · Dimension Data · 南非 :flag-ZA: | [mirror.dimensiondata.com](https://mirror.dimensiondata.com "https://mirror.dimensiondata.com") |

???+ note "帮助项目完善更多海外软件源"
???+ note "帮助项目完善更多境外、海外软件源"

该列表中的软件源参考自 [`Ubuntu 镜像列表`](https://launchpad.net/ubuntu/+cdmirrors "https://launchpad.net/ubuntu/+cdmirrors")、[`Debian 镜像列表`](https://www.debian.org/CD/http-ftp/#mirrors "https://www.debian.org/CD/http-ftp/#mirrors")、[`Fedora Mirror Manager`](https://admin.fedoraproject.org/mirrormanager/mirrors "https://admin.fedoraproject.org/mirrormanager/mirrors") 并且在此之前全部经过了有效性验证,但未作实际测试

作者没有精力持续维护列表中的这些海外镜像站,如果你想补充更多海外软件源或更正当前已有,请修改脚本内的 [`mirror_list_abroad 数组变量`](https://github.com/SuperManito/LinuxMirrors/blame/main/ChangeMirrors.sh#L60 "https://github.com/SuperManito/LinuxMirrors/blame/main/ChangeMirrors.sh#L66") 并按照下面的编辑规范进行修改
作者没有精力持续维护列表中的这些境外、海外镜像站,如果你想补充更多软件源或更正当前已有,请修改脚本内的 [`mirror_list_abroad 数组变量`](https://github.com/SuperManito/LinuxMirrors/blame/main/ChangeMirrors.sh#L60 "https://github.com/SuperManito/LinuxMirrors/blame/main/ChangeMirrors.sh#L66") 并按照下面的编辑规范进行修改

你可以在确认软件源地址无误后前往 GitHub 仓库提交 [Pull Requests](https://github.com/SuperManito/LinuxMirrors/pulls "https://github.com/SuperManito/LinuxMirrors/pulls"),也可以 :material-source-fork: Fork 仓库后自行定制使用

- 海外软件源编辑规范
- 境外以及海外软件源编辑规范

完整格式:`洲 · 软件源名称 · 国家/地区@软件源地址(域名)`

请根据地理位置、国家或地区进行排序以便于用户选择,有标志性缩写字符的单位应在最后用括号补充,单位的名称应以域名作为优先原则,下面是命名规则:

- 教育单位:需使用中文译名,全称中若含有国家或地区的名称则也要带上,注意区分下属单位,例如学院、学生会、社团等。常见的二级域名格式 `ftp.mirrors.xxx.xxx` 应直接采用顶级单位的名称,如果有三级域名则应考虑是否在名称中加上下属单位,以域名为优先原则

注:`Technology` 一词应称为 `理工` 而不能使用翻译结果的 `技术` 一词
注:`Technology` 一词应称为 `理工` 而不能使用翻译结果的 `技术` 一词,大部分教育单位都有正式或公认的中文译名

- 非教育单位:应优先采用其上属官网所自称的英文品牌名称,注意是正式的英文名称不是logo中的字符,如果没有并且是除中文、英文以外的语言应使用域名作为名称
- 非教育单位:应优先采用其上属官网所自称的品牌名称,注意是正式的英文名称而不是logo中的字符,如果没有并且网站是除中文、英文以外的语言文字应使用网站域名作为名称

## 工具网站

Expand All @@ -268,4 +268,4 @@ hide:
<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#命令选项高级用法)</br>特此声明:本页面用到的旗帜符号仅用于快速区分地理位置不代表作者的任何政治立场,请不要过度解读!"
!!! tip "该页面展示的均为脚本默认提供可供选择的软件源地址,如果没有找到你想使用的也没有关系,脚本支持命令选项可自定义使用,详见[高级用法](../use/index.md#命令选项高级用法)</br>特此声明:本页面涉及的旗帜图标仅用于快速区分地理位置不代表作者的任何政治立场,请不要过度解读!"
73 changes: 39 additions & 34 deletions docs/other/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,6 @@ hide:
## :fontawesome-brands-docker:{style="color: #086dd7"} Docker 安装脚本

支持 `选择或更换软件源以及镜像仓库``安装指定版本``重装` 等功能
脚本参考 [官方文档](https://docs.docker.com/engine/install) 使用包管理工具实现安装,支持的系统详见下方表格

<table>
<tr>
<td><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</td>
Expand Down Expand Up @@ -47,7 +44,7 @@ hide:
</tr>
</table>

=== ":octicons-globe-16: CDN(推荐)"
=== ":octicons-globe-16: 官网(推荐)"

``` bash
bash <(curl -sSL https://linuxmirrors.cn/docker.sh)
Expand All @@ -59,62 +56,70 @@ 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)
```

脚本集成安装 [`Docker Engine`](https://docs.docker.com/engine)[`Docker Compose (插件)`](https://docs.docker.com/compose/install/linux),可选择安装版本、下载软件源、镜像加速器,支持 ARM 架构处理器
=== ":simple-jsdelivr: jsDelivr"

``` bash
bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)
```

支持 `选择或更换软件源以及镜像仓库``安装指定版本``重装` 等功能,支持 ARM 架构处理器

脚本参考 [官方文档](https://docs.docker.com/engine/install) 使用系统包管理工具安装,集成安装 [`Docker Engine`](https://docs.docker.com/engine)[`Docker Compose (插件)`](https://docs.docker.com/compose/install/linux)

Docker Compose 自 V2 版本起开始作为 Docker CLI 的一部分,不再需要单独安装,请使用 `docker compose` 命令代替 `docker-compose`
> 注:Docker Compose 自 V2 版本起开始作为 Docker CLI 的一部分,不再需要单独安装,请使用 `docker compose` 命令替代 `docker-compose`
!!! node "软件源说明"

`Docker CE` 软件仓库,全称 Docker Community Edition(Docker 社区版),用于下载并安装 Docker 相关软件包
`Docker Registry` 镜像仓库,用于控制拉取镜像的默认来源存储仓库,又称镜像加速器,默认为官方的 Docker Hub 仓库

由于一些不可抗力的因素,目前国内网络环境一般无法正常访问 Docker Hub 从而导致无法拉取镜像,建议使用推荐的镜像源,不过速度可能会很慢
由于一些不可抗力的因素,目前国内网络环境一般无法正常访问 Docker Hub 因此无法拉取镜像,使用推荐的镜像源勉强能够使用不过速度可能会很慢

### 命令选项
- ### 命令选项

| 名称 | 含义 | 选项值 |
| :-: | :-: | :-: |
| `--source` | 指定 `Docker CE` 源地址(域名或IP) | 地址 |
| `--source-registry` | 指定镜像仓库地址(域名或IP) | 地址 |
| `--codename` | 指定 Debian 系操作系统的版本代号 | 代号名称 |
| `--install-latest` | 是否安装最新版本的 Docker Engine | `true``false` |
| `--close-firewall` | 是否关闭防火墙 | `true``false` |
| `--clean-screen` | 是否在运行前清除屏幕上的所有内容 | `true``false` |
| `--ignore-backup-tips` | 忽略覆盖备份提示(即不覆盖备份) ||
| 名称 | 含义 | 选项值 |
| :-: | :-: | :-: |
| `--source` | 指定 `Docker CE` 源地址(域名或IP) | 地址 |
| `--source-registry` | 指定镜像仓库地址(域名或IP) | 地址 |
| `--codename` | 指定 Debian 系操作系统的版本代号 | 代号名称 |
| `--install-latest` | 是否安装最新版本的 Docker Engine | `true``false` |
| `--close-firewall` | 是否关闭防火墙 | `true``false` |
| `--clean-screen` | 是否在运行前清除屏幕上的所有内容 | `true``false` |
| `--ignore-backup-tips` | 忽略覆盖备份提示(即不覆盖备份) ||

> 软件源完整格式 `<WEB协议>://<软件源地址(域名或IP)>/<软件源仓库(路径)>`
> 软件源完整格式 `<WEB协议>://<软件源地址(域名或IP)>/<软件源仓库(路径)>`
### 关于服务报错无法启动
- ### 关于服务报错无法启动

!!! quote ""
!!! quote ""

非新装环境可能会在运行脚本后遇到 `Docker` 服务无法启动的情况,建议重新安装来解决,卸载不会删除镜像和容器数据
非新装环境可能会在运行脚本后遇到 `Docker` 服务无法启动的情况,建议重新安装来解决,卸载不会删除镜像和容器数据

卸载命令如下:
卸载命令如下:

=== "Debian 系"
=== "Debian 系"

``` bash
apt-get remove -y docker* containerd.io runc && apt-get autoremove
```
``` bash
apt-get remove -y docker* containerd.io runc && apt-get autoremove
```

> `Debian` &nbsp; `Ubuntu` &nbsp; `Kali` &nbsp; `Linux Mint` &nbsp; `Deepin` &nbsp; `Zorin OS` &nbsp; `Armbian` &nbsp; `Proxmox`
> `Debian` &nbsp; `Ubuntu` &nbsp; `Kali` &nbsp; `Linux Mint` &nbsp; `Deepin` &nbsp; `Zorin OS` &nbsp; `Armbian` &nbsp; `Proxmox`

=== "RedHat 系 / openEuler / OpenCloudOS / Anolis OS"
=== "RedHat 系 / openEuler / OpenCloudOS / Anolis OS"

``` bash
yum remove -y docker* containerd.io podman* runc
```
``` bash
yum remove -y docker* containerd.io podman* runc
```

> `Red Hat Enterprise Linux` &nbsp; `CentOS` &nbsp; `Rocky Linux` &nbsp; `AlmaLinux` &nbsp; `Fedora` &nbsp; `openEuler` &nbsp; `OpenCloudOS` &nbsp; `Anolis OS`
> `Red Hat Enterprise Linux` &nbsp; `CentOS` &nbsp; `Rocky Linux` &nbsp; `AlmaLinux` &nbsp; `Fedora` &nbsp; `openEuler` &nbsp; `OpenCloudOS` &nbsp; `Anolis OS`

卸载完成后重新执行脚本安装即可
卸载完成后重新执行脚本安装即可

## 其它

Expand Down
Loading

0 comments on commit 9cb5eef

Please sign in to comment.