Clash 订阅：导入、更新与格式说明

Clash 订阅本质上是一份由服务商维护的远程 YAML 配置；导入时要让客户端界面和订阅格式使用同一类内核。当前 VilaVPN 计划包含 Shadowsocks、Hysteria2、AnyTLS，想让这些协议都进入 Clash，应优先选择 Clash Meta/mihomo 订阅，再在客户端的「订阅」页导入和更新。

本文以开源的 Clash Verge Rev 桌面客户端为例；它内置 Clash.Meta（mihomo）内核，菜单文字以项目当前简体中文资源为准；其他客户端的按钮位置可能不同，但判断格式的方法相同。

先选对 Clash 订阅格式

“Clash 订阅”不是一个固定协议名，而是一个客户端能读取的配置文件。服务商可以为不同内核生成不同 YAML。VilaVPN 的 feed 代码把普通 Clash 和 Clash Meta 分成两个渲染器，不能只看文件名或链接后缀判断兼容性。

上表是对 VilaVPN 当前代码的核对，不代表所有名为 Clash 的客户端都支持同样的协议。表中的 VMess、VLESS、Trojan、SOCKS5 和 HTTP 只表示渲染器能输出，不表示当前在售套餐含这些协议；当前在售计划按官方数据为 Shadowsocks、Hysteria2、AnyTLS。普通渲染器里 VLESS 和 Hysteria2 的代码是注释状态，也没有 AnyTLS 分支；Meta 渲染器才把 Hysteria2 和 AnyTLS 写入 proxies。因此，导入成功但节点数量异常时，先检查是否拿错了渲染器。

导入 Clash 订阅链接

1. 准备自己的链接。在 VilaVPN 客户中心打开产品详情，在「选择你的APP」中选择 clashVerge（Clash Verge Rev），再点「复制订阅链接」。不要使用公开分享的链接；VilaVPN feed 响应会带订阅用量信息，应该只在自己的客户端中使用。
2. 打开订阅页。在 Clash Verge Rev 左侧选择「订 阅」。项目的中文资源将这个页面标题标为「订阅」；左侧代理文字是「代 理」，进入后页面标题为「代理组」。
3. 粘贴并导入。先在「订阅文件链接」输入框粘贴完整 URL，再点击「导入」或按回车；没有 URL 时「导入」不可用。字段旁也提供「粘贴」动作。
4. 确认文件格式。如果客户端提示「无效的订阅链接，请输入以 http:// 或 https:// 开头的地址」，检查复制时是否缺少协议头；URL 校验会先去掉首尾空格。如果拖入本地文件时提示「仅支持 YAML 文件」，说明文件扩展名应为 .yaml 或 .yml，不要把这条提示当成订阅链接判断。
5. 启用并查看节点。导入后在订阅卡片的菜单里选择「使用」，再打开「代理组」页。悬停相关控件可看到「节点数量」和「延迟测试」提示；需要比较线路时使用对应功能，并结合真实任务观察体验。

不要把订阅链接当作普通网页地址来改写。VilaVPN 的 Clash feed 会从模板生成完整 YAML，并把节点加入 proxies，再把节点名称加入多个 proxy-groups；手动截取其中一行或只复制某个节点，都会丢失原有的分组和规则。

更新订阅与保留自定义设置

Clash Verge Rev 的订阅页单个菜单提供「更新」；批量更新控件的悬停提示为「更新所有订阅」。单个链接失效时只更新对应卡片，多个链接一起维护时使用批量控件。项目的后端命令分别处理“从 URL 导入”和“更新已有配置”，更新失败会返回明确的错误码，不会把失败伪装成成功。

1. 先在「订阅」页选中正在使用的配置，点击「更新」。
2. 等待更新结果，再回到「代理组」页确认节点和代理组仍然存在。
3. 需要自动更新时，从订阅卡片菜单的「编辑信息」进入「编辑配置」对话框（新建时标题为「新建配置」），设置「更新间隔」；新建配置的「允许自动更新」默认已开。
4. 不要把间隔设得过短。Clash Verge Rev 的提示写明，频繁更新可能触发内核重载并中断现有连接；1440 分钟（24 小时）是警告下限，不是预填默认值。留空不会排程；要每天更新请自行填写 1440 分钟。

如果你在本地编辑过 YAML，更新前先保留一份备份，并记下改动属于哪一层：原始订阅、应用设置，还是扩展覆写。客户端的配置流程会对 YAML 做格式校验；手动改错缩进、键名或列表结构，可能导致当前配置无法应用。需要长期自定义时，可以复制为本地配置并单独维护，但不要误以为本地副本会继续接收远程更新。

Clash / mihomo YAML 看什么

Mihomo 文档把节点写在 proxies 数组中，每个节点至少有 name、type、server、port 等字段；代理组写在 proxy-groups 中，并用 type 和 proxies 描述选择方式。你不需要逐项重写这些字段，但可以用它们判断文件是否像一份完整的 Clash 配置。

• proxies 为空：文件可能只是骨架，或者服务商没有为该内核生成节点。
• 有节点却没有 proxy-groups：客户端可能能读到节点，但没有可用的选择组，体验会因客户端而异。
• type: hysteria2 或 type: anytls 出现：先按客户端内核文档确认是否支持对应类型；字段出现本身不构成兼容性保证。
• 文件是 JSON 或一串 URI：不要把它当作原生 Clash YAML 直接导入。回到服务商的客户端选项，重新选择 Clash Meta/mihomo 格式。

“订阅链接转换”只在确实没有目标客户端格式时考虑。转换会引入额外变量，排查时很难区分原链接、转换服务和客户端的问题；能直接获得目标格式，就优先使用原生链接。无论采用哪种来源，先确认文件能通过 YAML 校验，再让客户端加载。

导入失败时按顺序排查

1. 先看错误原文。Clash Verge Rev 的资源区分「导入订阅失败」「读取订阅失败」和「更新订阅失败」。不同阶段的错误不要用同一个办法反复尝试。
2. 再核对账户状态。VilaVPN feed 可能返回 Not Service、Not Active 或 Subscription not activated...。分别对应错误或已重置的链接、服务未激活，以及需要先激活订阅；回到客户中心处理后，再重新导入。
3. 再核对内核。当前 VilaVPN 计划包含 Hysteria2、AnyTLS 时，改用 Clash Meta/mihomo 链接和客户端，并确认该内核支持对应类型。
4. 最后做体验核对。在客户端内置延迟测试中比较节点，切换一个协议或节点，再用 Wi-Fi 与移动数据分别完成实际任务。这样能把订阅格式问题和本地网络时段问题分开。

如果你曾经在客户中心重置过订阅链接，旧链接不会自动变成新链接。删除旧配置后，重新复制新链接并导入；这一步也能避免继续使用已经失效的地址。

常见问题

Clash 和 mihomo 到底是什么关系？

Clash 是一组客户端和内核生态的统称；mihomo 是 Clash.Meta 系列的内核项目。Clash Verge Rev 的 README 明确写着内置 Clash.Meta（mihomo）内核，所以本文把“Clash 订阅”用于用户搜索词，把“mihomo”用于格式和协议兼容性判断。

订阅链接和本地 YAML 应该选哪个？

需要服务商持续提供节点和规则更新时，保留远程订阅链接；只想维护一份固定配置或做实验时，再使用本地 YAML。两者都要满足客户端的 YAML 校验，区别在于来源和更新方式。

为什么导入成功，却看不到 Hysteria2 或 AnyTLS？

先检查是否使用了普通 Clash 渲染器，或当前内核是否支持对应类型。VilaVPN 的 Meta 渲染器才生成这两类条目；重新在客户中心选择 clashVerge 后复制链接，更新后再查看悬停提示「节点数量」。

多久更新一次订阅比较合适？

填写大于 0 且小于 1440 分钟的间隔时，Clash Verge Rev 会提示可能频繁触发内核重载；1440 分钟（24 小时）是警告下限，表单不预填该值。留空不会自动更新；要每天更新请填写 1440 分钟。

订阅链接失效或疑似泄露怎么办？

不要继续反复刷新旧链接。回到 VilaVPN 客户中心重置订阅链接，复制新链接后替换客户端中的旧配置；如果服务本身未激活，先完成激活再导入。

VilaVPN 与 VilaNet

新用户建议先使用 VilaVPN 官方 VilaNet 应用；它覆盖 iOS、Android、Windows、macOS、Linux、Apple TV 和 Android TV，也提供 OpenWrt / Merlin 路由器版本。需要下载时请前往 VilaNet 下载页。第三方 Clash/mihomo 客户端是兼容的旧选项；若设备跑不了 VilaNet，再暂时使用。

想继续了解协议选择，可阅读 协议对比、Hysteria2 深入说明 和 VPN 故障排查。

参考来源

1. Clash Verge Rev README
2. Clash Verge Rev 简体中文订阅资源
3. Clash Verge Rev 简体中文布局资源
4. Clash Verge Rev 简体中文代理资源
5. Clash Verge Rev 订阅页交互
6. Clash Verge Rev URL 校验
7. Clash Verge Rev profile 命令
8. Clash Verge Rev 更新间隔常量
9. Clash Verge Rev 更新计时器
10. Clash Verge Rev 配置默认值
11. mihomo 官方文档：通用字段
12. mihomo 官方文档：代理组
13. mihomo 官方文档：Hysteria2
14. mihomo 官方文档：AnyTLS
15. VilaVPN 官方：选择合适的应用
16. VilaVPN 客户区语言与应用映射（官方数据）
17. VilaVPN 订阅接口（官方数据）

VilaVPN 编辑部