From 7785fe98b2741911cf3634cbf892ced363ae313b Mon Sep 17 00:00:00 2001
From: iBug <git@ibugone.com>
Date: Fri, 19 Apr 2024 22:01:08 +0800
Subject: [PATCH] mirrors: Consolidate services pages

---
 docs/services/mirrors/genindex.md |  7 -------
 docs/services/mirrors/http.md     |  9 ---------
 docs/services/mirrors/services.md | 33 +++++++++++++++++++++++++++++++
 mkdocs.yml                        |  5 +----
 4 files changed, 34 insertions(+), 20 deletions(-)
 delete mode 100644 docs/services/mirrors/genindex.md
 delete mode 100644 docs/services/mirrors/http.md
 create mode 100644 docs/services/mirrors/services.md

diff --git a/docs/services/mirrors/genindex.md b/docs/services/mirrors/genindex.md
deleted file mode 100644
index 91769ce2..00000000
--- a/docs/services/mirrors/genindex.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# 首页生成
-
-镜像站主页是静态的，由 <https://git.lug.ustc.edu.cn/mirrors/mirrors-index> 脚本生成。
-
-crontab 会定时运行该脚本，生成首页和 [mirrorz 项目](https://mirrorz.org/)需要的数据。
-
-在首页展示的「获取安装镜像」、「获取开源软件」、「反向代理列表」分别由 config 内配置指定，「文件列表」内容则会从[同步程序 yuki](https://github.com/ustclug/yuki) 的 api 中获取。
diff --git a/docs/services/mirrors/http.md b/docs/services/mirrors/http.md
deleted file mode 100644
index f79fa74b..00000000
--- a/docs/services/mirrors/http.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# HTTP service
-
-Mirrors 使用 OpenResty（一个打包 Nginx 和一堆有用的 Lua 模块的软件包）提供 HTTP 服务。
-
-配置文件位于 LUG GitLab 上：<https://git.lug.ustc.edu.cn/mirrors/nginx-config>，此仓库对应 mirrors 上的 `/etc/nginx` 目录。
-
-## 请求限制策略
-
-见[限制策略](limiter.md)。
diff --git a/docs/services/mirrors/services.md b/docs/services/mirrors/services.md
new file mode 100644
index 00000000..b259e6f2
--- /dev/null
+++ b/docs/services/mirrors/services.md
@@ -0,0 +1,33 @@
+# 镜像服务
+
+## 首页生成
+
+镜像站主页是静态的，由 <https://git.lug.ustc.edu.cn/mirrors/mirrors-index> 脚本生成。
+
+crontab 会定时运行该脚本，生成首页和 [mirrorz 项目](https://mirrorz.org/)需要的数据。
+
+在首页展示的「获取安装镜像」、「获取开源软件」、「反向代理列表」分别由 config 内配置指定，「文件列表」内容则会从[同步程序 yuki](https://github.com/ustclug/yuki) 的 api 中获取。
+
+## HTTP 服务
+
+Mirrors 使用 OpenResty（一个打包 Nginx 和一堆有用的 Lua 模块的软件包）提供 HTTP 服务。
+
+配置文件位于 LUG GitLab 上：<https://git.lug.ustc.edu.cn/mirrors/nginx-config>，此仓库对应 mirrors 上的 `/etc/nginx` 目录。
+
+### 请求限制策略
+
+见[限制策略](limiter.md)。
+
+## Rsync 服务
+
+未完待续。
+
+## 反向代理服务
+
+未完待续。
+
+## FTP 服务（已废弃）
+
+Mirrors 曾经提供 FTP 服务，由 vsftpd 提供。在将主力服务器从 mirrors2 迁移至 mirrors4 时废弃，即 mirrors4 上从未安装配置过 vsftpd（但 mirrors2 上还留存有配置文件）。
+
+由于年代久远且我们不再打算恢复 FTP 服务，这部分文档也就咕咕咕了。
diff --git a/mkdocs.yml b/mkdocs.yml
index 6e1685aa..0fa29b80 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -125,11 +125,8 @@ nav:
       - Docker: "services/mirrors/docker.md"
       - IPMI: "services/mirrors/ipmi.md"
       - ZFS: "services/mirrors/zfs.md"
-      - Genindex: "services/mirrors/genindex.md"
+      - Services: services/mirrors/services.md
       - Monitoring: services/mirrors/monitor.md
-      - HTTP Service: services/mirrors/http.md
-      - Rsync Service: "#"
-      - Reverse Proxy: "#"
       - Limiter: "services/mirrors/limiter.md"
       - Repo sync: "#"
       - Mail list: "services/mirrors/mail-list.md"