Deep Links zh

深度链接（URL 方案）

🌐 English · Русский · 中文

ClashFest 可以直接通过链接导入订阅。点击这样的链接（在浏览器、聊天，或面板的「添加到应用」按钮中）会打开 ClashFest，弹出确认对话框，并将订阅作为一个命名配置文件导入。

主方案 —— clashfest://

clashfest://installconfig?url=<经过 URL 编码的订阅 URL>&name=<可选名称>

• url（必填）—— 你的订阅 URL，需百分号编码。
• name（可选）—— 导入配置文件的显示名称。

示例

订阅 URL：

https://panel.example.com/sub/abc123

深度链接（已编码）：

clashfest://installconfig?url=https%3A%2F%2Fpanel.example.com%2Fsub%2Fabc123&name=SwiftVPN

务必对 url 值进行 URL 编码。订阅 URL 中未编码的 ?、&、=、/ 会破坏解析。

同样支持（兼容）

为与其他 Clash 客户端互通，ClashFest 也接受：

方案	主机
clashfest:// （主）	installconfig 或 install-config
clash://	installconfig 或 install-config
clashmeta://	installconfig 或 install-config

因此以下写法效果相同：

clashfest://install-config?url=<encoded>&name=<name>
clash://install-config?url=<encoded>&name=<name>
clashmeta://install-config?url=<encoded>&name=<name>

为你自己的服务优先使用 clashfest://installconfig；仅当你需要一条能在多个 Clash 家族应用中通用的链接时，才保留 clash:// 形式。

行为与安全

• 打开链接绝不会静默导入 —— 添加前用户会看到一个标明订阅名称的确认对话框。
• 导入的配置文件与手动添加的行为完全一致（自动更新、流量、品牌等）。
• 若未安装 ClashFest，链接不会有任何动作 —— 请将链接放在带有安装回退的普通网页之后。

面向面板 / 运营方

用你面板的模板变量生成按用户的安装链接：

clashfest://installconfig?url={{SUBSCRIPTION_URL_ENCODED}}&name={{USERNAME}}

确保订阅 URL 由面板输出时已经过百分号编码。搭配 Operator API 响应头，让新导入的配置文件在首次拉取时即被品牌化。

相关

• 快速上手 —— 在应用内导入订阅
• Operator API —— 为导入的配置文件做品牌定制