文件概览

「文件」功能用于托管和动态生成文件内容：普通的文本文件、脚本文件，以及 mihomo 配置文件。

文件类型

• 普通文件（file）：托管文本内容（模板、脚本、规则等）
  • 来源：本地文本（content）或远程链接（url）
• mihomo 配置文件（mihomoConfig）：动态生成完整 mihomo 配置
  • 来源：local（本地内容）/ remote（远程内容）/ none（生成空配置）/ subscription / collection（用已保存的订阅/组合订阅生成）

生成配置文件

目标	做法	参考
Mihomo	新建 mihomo 配置，选订阅 + 覆写模板	使用覆写生成 Mihomo 配置
sing-box	远程模板 + 脚本操作转换（如 sub-store-template）	生成 sing-box 配置
Surfboard	模板文件 + 同步配置做远程托管	Surfboard 远程托管配置

生成 mihomo 配置时，除了「选订阅 + 覆写」的模板方式，还可以直接用处理操作把订阅产物写进配置：

• 从订阅添加节点（Add Proxies）：把单条订阅或组合订阅产出的节点写入当前 mihomo 配置的 proxies 字段（这是 mihomo 配置文件专有的操作，普通文件不可用），见 订阅处理 - 操作类
• 配合快速设置、节点去重、脚本操作等，可对一个源配置做完整加工

详见 订阅转换 - 生成配置文件。

输出链接与运行时覆盖

文件保存后获得输出链接 /api/file/<name>。请求文件链接时，可临时覆盖来源配置（只影响本次请求，不修改已保存的文件）：type（file / mihomoConfig）、source（普通文件来源）、sourceType（mihomo 配置来源）、sourceName、mode 等。

支持的覆盖参数与示例见 链接参数 - 文件链接运行时覆盖；其他通用参数（target、content、ua、noCache 等）同样适用于文件链接。

常见用法

• 托管配置文件：把配置放在 Sub-Store 里统一管理、更新，客户端拉取文件链接
• 套加速拉取 GitHub 资源：利用文件功能配合加速服务拉取 GitHub 上的模板/覆写/脚本资源（境外资源直连困难时的常规做法，见折腾啥博客）
• 加密/解密：支持 age 加密（ProxyUtils.age），配合 age-secret-key 参数使用

参考

• 文件脚本
• 同步：把文件产物定时上传到 Gist
• 链接参数说明（官方 Wiki）