基于文件的简单订阅服务器。
主要为了方便在配置文件完全自己编写的情况下，快速导入 Surge、QuantumultX、Loon 等客户端。
同时也为了与家人或亲友分享时，隐藏原始订阅地址，避免被滥用。
git clone https://github.com/alecthw/simple-sub-server.git
cd simple-sub-server
export GOOS=linux GOARCH=amd64 # 可选，交叉编译
go build -o sub-server配置文件存放：{workdir}/sub/{uuid}/{file}。
uuid必须是合法的uuid，做了校验。
代码中做了防越级处理，不能添加父子路径，即 file 的值中不能包含字符 / 、 \ 和 .. 。
请求url：http://127.0.0.1:8080/{uuid}/{file}。
flowchart TD
A["收到请求 GET /{uuid}/{file}"] --> B{"uuid 合法?"}
B -- "否" --> X403["403 Forbidden"]
B -- "是" --> C{"file 安全?\n无 /、\\、.."}
C -- "否" --> X403
C -- "是" --> D{"file 是订阅输出类型?\n.yaml/.yml/.conf/.json/.ini"}
D -- "否\n如 subscribe.txt / whitelist.txt" --> X403
D -- "是" --> E["定位用户目录 sub/{uuid}"]
E --> F{"用户目录存在?"}
F -- "否" --> X404["404 Not found"]
F -- "是" --> G{"存在 whitelist.txt?"}
G -- "存在" --> H{"file 在白名单中?"}
H -- "否" --> X403
H -- "是" --> I["继续处理"]
G -- "不存在" --> I
I --> J{"用户目录下存在 file?"}
J -- "存在" --> K["读取 sub/{uuid}/{file}"]
J -- "不存在" --> L{"file 后缀是 .ini?"}
L -- "是" --> M["回退读取 sub/subconv/{file}"]
L -- "否" --> N["回退读取 sub/template/{file}"]
M --> O{"回退文件存在?"}
N --> O
O -- "否" --> X404
O -- "是" --> P{"需要 subscribe.txt?\nini 或可注入模板"}
P -- "是" --> Q{"sub/{uuid}/subscribe.txt 存在?"}
Q -- "否" --> X404
Q -- "是" --> R["读取文件内容"]
P -- "否" --> R
K --> R
R --> S{"读取到的是 .ini?"}
S -- "是" --> T["解析 ini"]
T --> U{"存在 [Redirect]?"}
U -- "是" --> V["校验 Redirect.file"]
V --> W{"目标文件名安全?"}
W -- "否" --> X404
W -- "是" --> Y["302 Redirect\nLocation: {mcp}/{uuid}/{Redirect.file}"]
U -- "否" --> Z["读取 subscribe.txt\n组装 Profile.url"]
Z --> AA["调用 subconverter /sub"]
AA --> AB{"target 是 surge/surfboard\n且设置 -mcp?"}
AB -- "是" --> AC["追加 #!MANAGED-CONFIG"]
AB -- "否" --> AD["返回 subconverter 内容"]
AC --> AD
AD --> X200["200 text/plain"]
S -- "否" --> AE{"文件来自 template 目录?"}
AE -- "否" --> AF["直接返回用户目录文件内容"]
AF --> X200
AE -- "是" --> AG{"是否匹配模板注入器?"}
AG -- "否" --> X404
AG -- "是" --> AI["读取 subscribe.txt\n解析 name=url"]
AI --> AJ{"模板类型"}
AJ -- "clash/stash" --> AK["注入 proxy-providers"]
AJ -- "egern" --> AL["注入 external policy_group\n补充 policies\n必要时写 auto_update.url"]
AJ -- "surge/surfboard" --> AM["注入 Proxy Group\n补充 include-other-group\n必要时写 MANAGED-CONFIG"]
AJ -- "loon" --> AN["注入 Remote Proxy"]
AJ -- "quanx" --> AO["注入 server_remote"]
AK --> X200
AL --> X200
AM --> X200
AN --> X200
AO --> X200
./sub-server -dir /path/to/workDir -host 127.0.0.1:8080 -subcnv "http://127.0.0.1:25500"{workdir}
├── sub
│ ├── 56d00b21-554d-5a90-6daa-52537050fb20
│ │ ├── Loon.conf
│ │ ├── QuantumultX.conf
│ │ ├── Stash.yaml
│ │ └── Surge.conf
│ └── 58cfbff0-18c8-1f7d-400a-ba07a305b1e6
│ ├── clash.ini
│ ├── ClashMeta.yaml
│ └── ClashMetaOnlyCN.yaml
└── sub-serversubconverter 服务器默认地址 http://127.0.0.1:25500，可以通过启动参数 -subcnv 修改。
当前文件后缀为 ini 时，则认为是 subconverter 配置文件，将调用 subconverter 服务。文件内容写法与 subconverter 配置档案相同。调用时，是将配置拆解成独立参数，然后调用的。
支持将 ini 文件放到 subconv 目录下集中管理，ini 文件中不填 url 订阅链接，然后在各个目录下创建 subscribe.txt 文件，文件中一行填一个 name=url 订阅链接。
当从 template 目录读取以 clash、stash、egern 开头的 yaml 文件，或以 surge、surfboard、loon、quanx 开头的 conf 文件时，会将 subscribe.txt 中的订阅附加到对应配置中。
当 subconv 目录下的 ini 文件内容为 [Redirect] 时，会返回 302 重定向到 file 指向的订阅文件；配置了 -mcp 时，重定向地址为 {mcp}/{uuid}/{file}，可用于将原 subconverter 入口平滑切换到基于模板文件的输出。
[Redirect]
file=clash_simple.yaml目录结构如下：
{workdir}
├── sub
│ ├── 56d00b21-554d-5a90-6daa-52537050fb20
│ │ └── subscribe.txt
│ ├── 58cfbff0-18c8-1f7d-400a-ba07a305b1e6
│ │ └── subscribe.txt
│ └── subconv
│ ├── clash.ini
│ ├── singbox.ini
│ └── surfboard.ini
└── sub-server通过启动参数 -mcp 设置托管配置前缀后，subconverter 的 surge/surfboard 输出会自动补充 MANAGED-CONFIG。
当从 template 输出 surge / surfboard 配置时，会在文件头添加 #!MANAGED-CONFIG {mcp}/{uuid}/{file}；输出 egern 配置时，会补充 auto_update.url 为 {mcp}/{uuid}/{file}。
此处不详述，有需要看源码。
{workdir}
├── sub
│ └── provider
│ └── airport.yml
└── sub-server参考文件：sub-server.service