手动导入 YAML 配置文件

什么时候需要手动导入

订阅是一个 HTTP(S) 地址，客户端定时去拉，把结果转成本地配置。手动导入是另一条路：你给客户端一个文件，它就跑这个文件，不联网找任何东西。

• 别人发来的完整配置。自建服务器、公司内网的分流方案，多半是这个形式。
• 自己照模板写的。就一两台固定服务器，犯不上搞订阅。
• 从订阅另存下来又改过的。这份从此和订阅脱钩，对面换 IP 它不会跟。

两条路，挑一条走

1. 在配置页找新建入口，类型选「本地」或 Local，把文件选进去。Clash Verge Rev 的入口在「订阅」页顶部。
2. 或者绕过界面：用托盘菜单里的「打开配置目录」，把 .yaml 丢进去，别照别人的教程猜路径。
3. 回客户端点那张卡片，让它成为当前配置。有的客户端要右键选「使用」。
4. 看日志开头十几行。加载成功会打出节点数和规则条数，失败的原因也在这里。

后缀 .yaml 和 .yml 都认，列表不刷新就重启一次。另外，别人给的配置除了节点，还可能带 rules、external-controller、secret，导入前扫一眼比事后排查省事。

导入了，但没生效

解析失败时客户端多半给一行带行号的提示，形如 yaml: line 42: 再跟一句英文。照那个行号去看。下面五种占了绝大多数。

• Tab 缩进。YAML 只认空格，而编辑器把 Tab 画成一片空白，肉眼分不出来。打开「显示空白字符」再看。
• 全角标点。聊天软件里复制的片段常带中文引号，name: "HK-01" 的引号是全角就解析不了。
• proxies 里节点名重复。策略组指过去走哪个说不准，有的内核直接拒绝加载。
• proxy-groups 引用了不存在的节点名。多一个空格、少一个 emoji 都算另一个名字，报错指向组名而不是行号。
• 文件带 BOM。记事本另存 UTF-8 会在开头塞三个字节，内核读到的第一个键就是坏的。换个编辑器存成不带 BOM 的。

mixed-port: 7890
mode: rule
proxies:
  - name: my-node
    type: ss
    server: 203.0.113.10
    port: 8388
    cipher: aes-256-gcm
    password: change-me
proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - my-node
      - DIRECT
rules:
  - DOMAIN-SUFFIX,example.com,PROXY
  - MATCH,PROXY

卡住就先把配置换成上面这个骨架，确认它能加载，再一块一块把自己的东西加回去。

本地文件不会自己更新

本地配置没有来源地址，「更新」按钮对它不起作用，有的客户端直接把它灰掉。在外部编辑器改完存盘，客户端也不一定察觉——重新选一次配置或者重启内核才进得去。