基于文件的简单订阅服务器。
主要为了方便在配置文件完全自己编写的情况下，快速导入 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要求 Go 1.24 或更新版本。
main.go 启动参数、日志与 HTTP 服务启动
handler/ Server 实例、路由装配和 HTTP 响应
server_e2e_test.go 本地 HTTP 服务与模拟上游的端到端回归
internal/
filestore/ 文件访问、白名单、用户文件与共享模板回退
subscription/ subscribe.txt 流式解析与订阅条目
template/ App 注入器、注册表、泛型处理流程和 DNS 转换
subconv/ INI 解析、重定向、subconverter 请求
provider/ provider 配置、上游发现、订阅获取、解密和 DNS 策略
yamlutil/ 保留格式的 YAML 输出工具
handler.New(Config, client) 创建独立服务实例，Server.RegisterRoutes 统一注册路由；入口和端到端测试使用同一套装配逻辑。原包级 Init 和处理函数已改为实例方法，业务实现包移入 internal/。命令行参数、URL 路由和运行数据目录保持兼容。
模板通过 Injector 接口匹配 App，Registry 按注册顺序选择首个匹配项。Codec[T] 和 pipeline[T] 统一解析、过滤有效命名订阅、顺序转换及序列化：YAML 使用 *yaml.Node 保留注释和顺序，文本配置使用 string。新增 App 时实现匹配规则、组合对应格式的转换步骤，再加入 DefaultRegistry；DNS 规则转换仍由各 App 按自身格式处理。
go test ./... # 包测试及端到端回归
go test ./handler -run E2E # 仅 HTTP 端到端测试
go test -race ./... # 并发与数据竞争检查
go vet ./... # 静态检查
go build -o sub-server端到端测试使用临时工作目录、本地 HTTP 上游和示例订阅地址，覆盖七类客户端、DNS 注入、白名单、文件回退、INI 转换／重定向、provider 响应及多实例隔离，无需真实 sub/ 数据或外部服务。
文件回退仅发生在用户文件不存在时；目录、权限或其他读取错误不会触发回退。用户文件、订阅列表、白名单和共享模板使用限定目录的读取，拒绝通过文件符号链接访问目录外的数据；无法完整读取的白名单拒绝访问。subconverter 连接失败或返回非 200 状态时对外返回 502 Bad gateway，不再返回伪成功或透传上游错误内容。未设置 -mcp 时不会生成 INI 输出的托管配置头，前缀末尾的 / 会统一去除。
配置文件存放：{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\n注入对应 DNS 策略"]
AJ -- "egern" --> AL["注入 external policy_group\n补充 policies\n注入 DNS upstreams/forward\n必要时写 auto_update.url"]
AJ -- "surge/surfboard" --> AM["注入 Proxy Group\n补充 include-other-group\n注入 Host DNS 策略\n必要时写 MANAGED-CONFIG"]
AJ -- "loon" --> AN["注入 Remote Proxy\n注入 Host DNS 策略"]
AJ -- "quanx" --> AO["注入 server_remote\n注入 dns 策略"]
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"以下 UUID 为文档占位值，实际使用时请生成自己的 UUID。
{workdir}
├── sub
│ ├── 00000000-0000-0000-0000-000000000001
│ │ ├── Loon.conf
│ │ ├── QuantumultX.conf
│ │ ├── Stash.yaml
│ │ └── Surge.conf
│ └── 00000000-0000-0000-0000-000000000002
│ ├── 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
│ ├── 00000000-0000-0000-0000-000000000001
│ │ └── subscribe.txt
│ ├── 00000000-0000-0000-0000-000000000002
│ │ └── 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}。
此处不详述，有需要看源码。
provider 配置仅包含 subscribeUrl 时，服务会使用默认 User-Agent: clash-verge 请求并直接返回订阅内容；可通过配置中的 headers.User-Agent 覆盖默认值。
GET /provider/proxy-dns 会遍历 sub/provider 下除 proxy-dns.yml 外的所有 provider，实时生成并返回 Mihomo 格式的 proxy-server-nameserver-policy，同时原子更新 sub/provider/proxy-dns.yml。服务也会按照服务器本地时区每天凌晨 3 点自动刷新该文件。
生成规则如下：
- 仅处理
proxy-server-nameserver中含有私有 DNS 的订阅；命中后保留该列表中的全部 DNS，包括公共备用 DNS。 - 默认从订阅的
proxies[].server提取域名最后两段并生成+.模糊匹配规则，IP 节点不参与域名规则。 proxy-dns.yml顶层的common-domains是可手工维护的常用域名列表，默认包含github.com。节点域名命中列表项或其子域时保留完整原始域名，不生成+.模糊规则。- DoH 追加
#DIRECT&skip-cert-verify=true，其他 DNS 追加#DIRECT。 - 合并规则时会使用对应节点完整域名探测 DNS 可用性；同一个 DNS 只探测一次，所有 DNS 均保留，最终规则中可用 DNS 排在不可用 DNS 前面。
- 域名规则相同或 DNS 服务器存在任一交集时合并，域名、DNS 和 provider 注释均去重。
通过 sub/template 返回 Clash 模板时，服务仅注入 dns.proxy-server-nameserver-policy，模板已有的 dns.nameserver-policy 保持不变。
返回 Stash 模板时仅注入 dns.nameserver-policy，并移除不支持的 dns.proxy-server-nameserver-policy。策略中的 DNS 会去除 #DIRECT、#DIRECT&skip-cert-verify=true 等 Mihomo 参数，并去重追加到 dns.proxy-server-nameserver。Clash 和 Stash 注入时都会将 proxy-dns.yml 中合并存储的组合域名键拆成单个域名规则，避免客户端对长 YAML 键的兼容问题。文件不存在或为空时会先生成。
通过 Surge、Surfboard 或 Loon 模板返回配置时，服务会复用同一套转换逻辑将策略插入 [Host]：组合域名逐条展开，+. 转为 *.，精确域名保持不变，DNS 地址移除 #DIRECT 等 Mihomo 参数，provider 注释继续保留。
通过 Quantumult X 模板返回配置时，服务会将策略转换后插入 [dns]：普通 DNS、DoH、DoQ 分别写为 server、doh-server、doq-server，每组规则使用可用性排序后的第一个 DNS。组合域名逐条展开，provider 注释继续保留。
通过 Egern 模板返回配置时，每个合并策略组会生成一个 dns.upstreams，并在 dns.forward 中生成引用该 upstream 的 domain_suffix 或 domain 规则。新增 forward 规则前插到模板已有规则之前；单供应商优先用供应商名称作为 upstream 名，多供应商使用 proxy-dns-N，重名时自动避让。
proxy-dns.yml 无需预先创建；手动请求聚合端点或到达定时刷新时间时会自动生成。后续可直接编辑其中的 common-domains 列表补充常用域名，刷新策略时该列表会被保留；模板注入只读取 proxy-server-nameserver-policy，不会注入 common-domains 元数据。
{workdir}
├── sub
│ └── provider
│ ├── airport.yml
│ └── proxy-dns.yml
└── sub-server参考文件：sub-server.service