Clash 如何导入单个节点与自定义本地 YAML 配置文件

1. 协议分享链接（URI Scheme）的内部解密#

我们在网络上常见的单节点链接，本质上是遵循统一资源标识符（URI）规范的标准字符串。不同协议的设计哲学决定了其编码方式：

• Shadowsocks (ss://)： 通常格式为 ss://BASE64(method:password)@server:port#NodeName。其核心是将加密算法与连接密码通过 Base64 编码拼接在 @ 符号前面；
• VMess (vmess://)： 这是早期 V2Ray 生态最常用的格式。vmess:// 后面跟随的是一整串 Base64 编码的 JSON 纯文本。将其解码后，可以清晰看到包含 v（协议版本）、ps（节点备注名称）、add（服务器 IP 或域名）、port（端口）、id（用户 UUID）、net（传输协议如 ws/tcp）、tls（是否启用 TLS）等结构化字段；
• VLESS / Trojan / Hysteria 2 (vless://, trojan://, hysteria2://)： 现代抗 DPI 识别协议普遍抛弃了古老的全局 Base64 编码，直接采用人类可读的标准 URL Query 传参格式，例如： hysteria2://MyPassword@us.example.com:443?sni=us.example.com&alpn=h3#美国洛杉矶01。

2. 节点解析与策略组挂载通信拓扑图#

以下 Mermaid 架构图清晰展示了从原始单节点链接解析、字段映射，到最终被 Clash 内核挂载进分流策略组的完整技术流程：

3. 主流协议转换为 Clash YAML 字段的核心对照表#

为了让你在手动转换或编写节点时心中有数，下表列出了六大主流核心协议在 Clash / Mihomo 内核中的标准 YAML 字段要求：

1. Clash Verge Rev 本地导入步骤（Windows / macOS / Linux 桌面端）#

Clash Verge Rev 拥有极其直观的配置文件管理界面，支持直接将文件拖拽导入：

1. 启动 Clash Verge Rev 客户端；
2. 点击左侧主导航栏的 【订阅 / Profiles】 图标；
3. 在顶部右侧区域，点击 【新建 / New】 按钮；
4. 在弹出的类型选择对话框中：
   • 将类型（Type）从默认的“Remote”切换为 【Local】（本地文件）；
   • 设定一个容易辨识的名称（例如 My-Custom-Nodes）；
   • 在描述一栏可填写备注；
5. 点击 【保存 / Save】。此时在订阅列表中会多出一张标有“Local”属性的新配置卡片；
6. 鼠标右键单击这张新建的卡片，在右键菜单中选择 【编辑 / Edit】（或者选择【在资源管理器中打开】）；
7. 在内置的高级代码编辑器中，将你本地编写好的完整 YAML 文本全选粘贴进去，并按下快捷键 Ctrl + S（macOS 为 Cmd + S）保存；
8. 关闭编辑器窗口，左键单击该卡片选中激活（卡片边框高亮变为蓝色或紫色即表示当前生效）；
9. 点击左侧的 【代理 / Proxies】 菜单，你会惊喜地发现，你自建的单个节点已经整整齐齐地陈列在列表中，点击右上角的闪电图标即可进行并发连通性测试！

2. Mihomo Party 本地导入与可视化配置管理#

Mihomo Party 提供了非常优雅的卡片流设计：

1. 打开 Mihomo Party，在左侧导航点击 【订阅管理】；
2. 点击右上角的 【添加配置】；
3. 选择 【空白本地配置】；
4. 点击卡片上的 【文本编辑】 按钮，直接进入全屏代码编辑模式；
5. 将自定义的 YAML 内容直接粘贴并保存；
6. 切回仪表盘主界面，在顶部配置下拉菜单中选中刚才创建的本地配置项即可完成切换。

3. FlClash 导入本地文件多端实战#

如果你使用的是基于 Flutter 的轻量跨平台客户端 FlClash（在 Windows、macOS 以及 Android 平板手机上通用）：

1. 打开 FlClash，进入 【Profiles】 模块；
2. 点击右下角的悬浮 【+】号按钮；
3. 选择 【Import from file / 从文件导入】；
4. 在系统的文件选择器中，浏览找到你存放于本地磁盘的 custom-config.yaml 文件并点击打开；
5. FlClash 会对文件的 YAML 语法进行即时校验。校验通过后，长按或单击该配置文件将其设为主力配置（Active Profile）；
6. 返回代理页面启动服务。

4. 客户端内部热重载与实时日志排错#

本地配置文件的一大巨大优势就是修改即生效。

• 当你需要修改某个自建节点的密码、更换端口或增加一个分流域名时，无需重新导入，只需在客户端的配置卡片上右键选择【Edit】；
• 修改完毕后保存，客户端底层的内核控制器（External Controller）会自动向内核发送 PUT /configs 指令；
• 内核会在 0.1 秒内完成热重载（Hot Reload），现有的 TCP 连接不会产生任何断流卡顿；
• 如果你修改的内容存在语法错误，可以在左侧的 【日志 / Logs】 模块中实时看到红色的报错行数提示（如 yaml: unmarshal errors at line 45），便于毫秒级定位修改。

1. Merge Script 动态注入的核心执行机制#

Merge 脚本的工作逻辑非常纯粹： 每当客户端从机场拉取到最新的 YAML 文本后，不会直接将其喂给内核，而是先将配置转化为内存中的 JavaScript 对象并传递给你编写的 main(config) 函数；你可以在函数内部随意向 config.proxies 和 config["proxy-groups"] 压入数据，最后返回修改后的对象给内核。

2. 生产级 Merge 脚本实战代码#

打开 Clash Verge Rev，在左侧导航点击 【订阅 / Profiles】，在上方点击 【新建扩展配置】，类型选择 【Script】，在脚本编辑器中完整粘贴以下生产级代码：

1
// ==============================================================================
2
// 生产级 Clash Verge Rev 订阅后处理扩展脚本: 动态注入自建私有节点
3
// 核心价值: 彻底免疫机场订阅更新覆盖，让自建节点与机场专线永久共存
4
// ==============================================================================
5

6
function main(config) {
7
  // 1. 定义你的自建私有单个节点 (可按需添加多个)
8
  const myCustomNodes = [
9
    {
10
      name: "🚀 我的自建 VPS | 搬瓦工 CN2-GIA",
11
      type: "hysteria2",
12
      server: "198.51.100.22",
13
      port: 443,
14
      password: "MySuperStrongPassword888",
15
      sni: "bwh.example.com",
16
      alpn: ["h3"],
17
      up: "100 Mbps",
18
      down: "300 Mbps"
19
    },
20
    {
21
      name: "🛡️ 我的自建备用 | 瓦工 Reality",
22
      type: "vless",
23
      server: "203.0.113.99",
24
      port: 443,
25
      uuid: "e6f7a8b9-c0d1-2345-6789-0abcdef12345",
26
      cipher: "auto",
27
      tls: true,
28
      udp: true,
29
      client-fingerprint: "chrome",
30
      "reality-opts": {
31
        "public-key": "YourExactPublicKeyString43CharsLengthHere=",
32
        "short-id": "abcdef0123456789"
33
      },
34
      network: "tcp",
35
      servername: "www.yahoo.com"
36
    }
37
  ];
38

39
  // 2. 确保 config.proxies 数组存在，并将自定义节点拼接到最前面
40
  if (!Array.isArray(config.proxies)) {
41
    config.proxies = [];
42
  }
43
  // 将自建节点插入到节点列表的最顶端，方便在客户端面板快速查找
44
  config.proxies.unshift(...myCustomNodes);
45

46
  // 3. 提取所有自建节点的名字
47
  const customNodeNames = myCustomNodes.map(node => node.name);
48

49
  // 4. 自动遍历所有策略组，将自建节点名字挂载进你指定的核心策略组中
50
  if (Array.isArray(config["proxy-groups"])) {
51
    config["proxy-groups"].forEach(group => {
52
      // 常见的主选择策略组名称 (根据不同机场的命名习惯匹配)
53
      const targetGroupNames = ["PROXY", "节点选择", "PROXY-AUTO", "手动选择"];
54

55
      if (targetGroupNames.includes(group.name)) {
56
        if (Array.isArray(group.proxies)) {
57
          // 将自定义节点追加到该组候选列表的最前面
58
          group.proxies.unshift(...customNodeNames);
59
        }
60
      }
61
    });
62
  }
63

64
  // 5. 返回修改后的完整配置对象供内核加载
65
  return config;
66
}

3. 如何在客户端中绑定与生效该脚本#

1. 在脚本编辑器中点击保存，并将该脚本命名为 Inject-My-VPS；
2. 回到【订阅 / Profiles】主界面，找到你的商业机场主力订阅卡片；
3. 鼠标右键单击该机场卡片，在菜单中找到 【扩展配置 / Merge Profiles】；
4. 右键该订阅卡片点击【更新】。此时你会看到，无论是现在拉取还是未来每隔 24 小时自动更新，你的自建搬瓦工节点都会永远稳如泰山地排在代理列表的最顶部！

4. 更加解耦的工业级方案：使用本地文件型 Proxy-Providers#

除了编写 JavaScript 预处理脚本之外，现代 Mihomo 内核还原生支持一种甚至无需编写代码的高级解耦方案——本地文件型 proxy-providers。

该方案的工程设计哲学是将“纯节点参数池”与“复杂的策略分流逻辑”进行彻底的物理文件隔离：

1. 创建纯节点数据文件：你在本地任意路径（例如客户端的 profiles 目录下）创建一个极简的 YAML 文件，命名为 my-vps-nodes.yaml。这个文件内部只写且仅写 proxies: 数组，完全不需要包含任何端口、DNS 或分流规则代码：

1
# 纯节点独立存储池: my-vps-nodes.yaml (仅需维护 proxies 节点列表)
2
proxies:
3
  - name: "香港 01 | 自建纯净独享"
4
    type: hysteria2
5
    server: 198.51.100.55
6
    port: 443
7
    password: "StrongSecretPassword888"
8
    sni: "hk01.example.com"
9
    alpn:
10
      - h3
11
    skip-cert-verify: false
12

13
  - name: "美国 02 | 自建原生住宅"
14
    type: vless
15
    server: 203.0.113.77
16
    port: 443
17
    uuid: "f1e2d3c4-b5a6-7890-1234-567890abcdef"
18
    cipher: auto
19
    tls: true
20
    udp: true
21
    client-fingerprint: chrome
22
    reality-opts:
23
      public-key: "YourExact43CharsPublicKeyHereLongString12345="
24
      short-id: "12345678"
25
    network: tcp
26
    servername: "www.microsoft.com"

2. 在主配置中声明挂载该文件：在主配置文件或配置预处理中，使用 type: file 直接指向该本地文件，并将其动态挂载到策略组中：

1
# 动态加载本地独立节点提供者
2
proxy-providers:
3
  LocalCustomNodes:
4
    type: file
5
    path: ./my-vps-nodes.yaml # 指向你本地保存的纯节点文件
6
    health-check:
7
      enable: true
8
      interval: 300
9
      url: https://www.gstatic.com/generate_204
10

11
proxy-groups:
12
  - name: "PROXY"
13
    type: select
14
    use:
15
      - LocalCustomNodes # 关键！直接声明挂载上述本地节点池
16
    proxies:
17
      - DIRECT

3. 日常运维带来的巨大便利：
   • 以后当你新购了一台云服务器、或者临时拿到朋友分享的新节点时，你完全不需要碰客户端庞大复杂的主配置文件；
   • 你只需随手用文本编辑器打开这个极简的 my-vps-nodes.yaml，在末尾追加几行节点参数并保存；
   • 客户端内核检测到物理文件发生变动或健康检查探针触发时，会在毫秒级瞬间自动完成热重载。这种架构让自建节点的日常维护变得异常轻快与安全。

1. PowerShell 离线解码与 YAML 生成实战脚本#

在 Windows 电脑上，你可以直接打开 PowerShell，利用原生组件在本地秒级解码 vmess:// 节点并输出标准 Clash YAML 代码，全程完全不经过任何外部服务器：

1
# 适用系统: Windows PowerShell 5.1 / 7+ (无需联网，纯本地离线执行)
2
# 执行目的: 本地解析 vmess:// 字符串并自动格式化输出为 Clash 节点 YAML 语法
3

4
function Convert-VmessToClash {
5
    param (
6
        [Parameter(Mandatory=$true)]
7
        [string]$VmessUri
8
    )
9

10
    # 去除协议前缀
11
    $cleanUri = $VmessUri.Trim().Replace("vmess://", "")
12

13
    # Base64 字符串补齐补位
14
    $mod4 = $cleanUri.Length % 4
15
    if ($mod4 -gt 0) {
16
        $cleanUri += ("=" * (4 - $mod4))
17
    }
18

19
    try {
20
        # 本地解码 Base64 字符串为 JSON 文本
21
        $decodedBytes = [System.Convert]::FromBase64String($cleanUri)
22
        $jsonText = [System.Text.Encoding]::UTF8.GetString($decodedBytes)
23
        $node = ConvertFrom-Json -InputObject $jsonText
24

25
        # 输出标准 Clash YAML 格式
26
        Write-Host "`n====== 转换成功！复制下方 YAML 代码填入 proxies: 模块 ======" -ForegroundColor Green
27
        @"
28
  - name: "$($node.ps)"
29
    type: vmess
30
    server: $($node.add)
31
    port: $($node.port)
32
    uuid: $($node.id)
33
    alterId: $($node.aid)
34
    cipher: auto
35
    tls: $(if ($node.tls -eq "tls") { "true" } else { "false" })
36
    skip-cert-verify: false
37
    network: $(if ($node.net) { $node.net } else { "tcp" })
38
    $(if ($node.net -eq "ws") {
39
@"
40
    ws-opts:
41
      path: "$($node.path)"
42
      headers:
43
        Host: "$($node.host)"
44
"@
45
    })
46
"@
47
    } catch {
48
        Write-Error "解码失败，请确认输入的 vmess:// 链接是否完整合法！"
49
    }
50
}
51

52
# 实战调用示范 (替换为你真实的 vmess 链接):
53
# Convert-VmessToClash -VmessUri "vmess://ewogICJhZGQiOiAidXMuZXhhbXBsZS5jb20iLAogICJhaWQiOiAwLAogICJob3N0IjogInVzLmV4YW1wbGUuY29tIiwKICAiaWQiOiAiYTFiMmMzZDQtZTVmNi03ODkwLWFiY2QtZWYxMjM0NTY3ODkwIiwKICAibmV0IjogIndzIiwKICAicGF0aCI6ICIvdjJyYXkiLAogICJwb3J0IjogNDQzLAogICJwcyI6ICLlv6vpgJ8gMDF8576O5Zu95rSb5p2J546JIiwKICAidGxzIjogInRscyIsCiAgInYiOiAyCn0="

2. 跨平台 Python 转换脚本#

如果你在 macOS 或 Linux 终端下操作，使用系统内置的 Python 同样可以一行代码快速完成离线转换：

1
# 适用系统: macOS / Linux / Windows (Python 3.6+)
2
# 执行目的: 纯离线解析单节点链接，生成合规 YAML 文本
3
import base64
4
import json
5
import sys
6

7
def parse_vmess(uri):
8
    encoded = uri.replace("vmess://", "").strip()
9
    encoded += "=" * ((4 - len(encoded) % 4) % 4)
10
    data = json.loads(base64.b64decode(encoded).decode('utf-8'))
11

12
    yaml_node = f"""  - name: "{data.get('ps', 'Custom-Node')}"
13
    type: vmess
14
    server: {data.get('add')}
15
    port: {data.get('port')}
16
    uuid: {data.get('id')}
17
    alterId: {data.get('aid', 0)}
18
    cipher: auto
19
    tls: {'true' if data.get('tls') == 'tls' else 'false'}
20
    network: {data.get('net', 'tcp')}"""
21
    print(yaml_node)
22

23
if __name__ == "__main__":
24
    if len(sys.argv) > 1:
25
        parse_vmess(sys.argv[1])
26
    else:
27
        print("用法: python parse_node.py 'vmess://...'")

通过上述原生小脚本，你在几毫秒内就能把朋友分享的杂乱链接变成干干净净的 YAML 结构，既保护了数据隐私，又免去了格式报错的困扰。

1. 测试环境与对照变量#

• 测试宿主机平台：Windows 11 企业版，64GB 内存；
• 测试客户端：Clash Verge Rev v2.0.2（内置最新开源 Mihomo 内核）；
• 节点样本集：包含 1 个商业机场订阅（120 个节点）+ 2 个自建单节点（1 个 Hysteria 2、1 个 VLESS-Reality）；
• 评估指标项：
  1. 抗更新覆盖能力：机场订阅点击更新后，单节点是否依然完好保留；
  2. 技术学习门槛：操作的难易程度与代码依赖；
  3. 策略组调度灵活性：是否能让自建节点与机场节点共同参与 URL-Test 自动优选；
  4. 长期维护成本：当自建节点更换密码或端口时的修改复杂度。

2. 四大主流导入方案综合测评矩阵#

3. 数据解读与工程启示#

横向评测结果充分印证了一个核心工程逻辑：

• 如果你只想安安心心地使用自己的 1 到 2 个自建节点，且不需要复杂的机场订阅，方案 B（独立本地 YAML） 是最清爽、完全掌控在自己手中的模式；
• 而对于绝大多数现代复合型用户，方案 C（Merge Script 扩展脚本） 在“防冲刷”与“全自动”之间取得了最完美的工业级平衡。

案例一：在 proxies 成功追加了节点，但在客户端面板里空无一物#

案例二：修改 YAML 后客户端报错“found character that cannot start any token”#

案例三：自建 Hysteria 2 节点导入后提示“x509: certificate signed by unknown authority”#

1
- name: "Hys2-自建"
2
  type: hysteria2
3
  server: 45.76.xx.xx
4
  port: 443
5
  password: "pass"
6
  sni: "bing.com"

1
- name: "Hys2-自建"
2
  type: hysteria2
3
  server: 45.76.xx.xx
4
  port: 443
5
  password: "pass"
6
  sni: "bing.com"
7
  skip-cert-verify: true # 关键修复项：放行自签名证书

Q1：为什么不能把 vmess:// 链接直接贴到客户端的订阅 URL 输入框里？#

答：因为订阅 URL 输入框期望的是一个能够返回标准 YAML 文本的 HTTP/HTTPS 网络接口，而不是一段本地节点字符。 订阅 URL（如 https://airport.com/api/v1/...）在技术上是一个网络拉取端点，客户端会向该网址发起 HTTP GET 请求并下载一份完整的配置文件；而 vmess:// 是一串本地编码文本。你把单节点文本贴进订阅框，客户端尝试把一段 Base64 当作网址去发起网络请求，底层解析直接报错退出。单节点必须先解码转换为 YAML 格式放入本地文件方可被识别。

Q2：一个本地自定义 YAML 配置文件最多可以放多少个节点？#

答：在现代 Mihomo 内核下，理论上没有硬性上限，放几百甚至上千个节点都完全没有问题。 不过从日常使用体验角度考虑，建议一个本地配置中的单节点数量保持在 10 到 100 个以内。节点过多不仅会导致每次点击测速时本地网络与 CPU 出现瞬时尖峰负载，还会让图形界面的代理选择菜单变得极其冗长难翻。

Q3：节点名称支持 Emoji 国旗表情和纯中文吗？必须加双引号吗？#

答：完全支持 Emoji 和中文，且强烈建议使用英文双引号包裹。 Clash 现代内核全链路采用 UTF-8 编码，无论你是写“🇺🇸 洛杉矶”还是“🇯🇵 东京专线”，都可以完美渲染。但由于 Emoji 表情和部分特殊标点符号在底层可能会引起 YAML 词法解析器的断句误判，养成 name: "节点全名" 带双引号的书写习惯，是杜绝绝大多数奇葩报错的最佳防护措施。

Q4：怎么快速验证新导入的单个节点是否真正连通并能翻墙？#

答：不要只看客户端里的测速毫秒数，必须进行端到端的实际流量验证。 客户端面板上的闪电测速（URL-Test），本质上只是向测试网址（如 gstatic.com/generate_204）发了一次探测包并计算握手延迟，有时会出现“能测出延迟但打不开特定网站”的假连通情况。

• 最佳验证姿势：在 Clash Verge Rev 中将该节点单选激活，并将模式切换为【全局模式（Global）】；
• 打开浏览器隐身窗口，访问海外 IP 检测站点（如 https://ipinfo.io 或 https://whoer.net）；
• 如果网页显示的公网 IP 准确变成了你自建 VPS 的物理 IP，且能秒开 Google 首页，证明该节点端到端完全畅通无阻。

Q5：为什么自己搭的 VPS 节点在手机小火箭上可以用，导入 Clash 却一直显示 Timeout？#

答：这通常是由于客户端内核对协议特性的默认安全限制不同造成的。 最典型的就是前文案例三提到的 自签名证书校验（skip-cert-verify）：移动端部分工具为了用户体验，默认静默容忍自签名证书；而桌面端 Clash 内核为了绝对安全，默认强制开启严格的 CA 证书链校验。如果你的配置中没有显式声明 skip-cert-verify: true，Clash 就会直接主动断开握手，表现为持续的 Timeout。

Q6：本地 YAML 配置文件具体存放在操作系统的哪个文件夹里？#

答：不同操作系统和客户端有专属的应用数据目录：

• Clash Verge Rev：
  • Windows: %APPDATA%\clash-verge\profiles（在运行窗口输入直接直达）；
  • macOS: ~/Library/Application Support/clash-verge/profiles；
  • Linux: ~/.config/clash-verge/profiles。
• Mihomo Party：
  • Windows: %APPDATA%\mihomo-party\profiles；
  • macOS: ~/Library/Application Support/mihomo-party/profiles。 直接在客户端界面的配置卡片上右键选择【打开所在文件夹 / Open in Folder】，即可直达物理存储位置。

Q7：同一个自建节点可以在不同的策略组中多次复用吗？#

答：完全可以，这正是 Clash 策略组编排机制的魅力所在。 只要你在 proxies: 列表里将该节点定义过一次，你就可以在任意数量的策略组中引用它的名字。例如，你可以同时把 "我的自建VPS" 填入 PROXY 组、AUTO-TEST 自动测速组、以及专门分流海外 AI 服务的 AI-Tools 策略组中，内核会自动完成多路复用与调度，完全不会产生任何冲突。

Q8：自建单节点 VPS 与商业高端专线节点相比，日常使用体验有何本质区别？#

答：自建 VPS 胜在绝对私密与纯净度，商业专线胜在晚高峰抗拥堵与极端超低延迟。

• 自建 VPS 节点：IP 由你一人独享，几乎永远不会被 Google 弹验证码，非常适合用于登录海外私人网银、AWS 管理后台、自建服务等对安全隐私要求极严苛的场景；但由于使用的是普通公网直连线路，遇到晚高峰国际骨干网拥堵时，丢包率与延迟会显著上升；
• 商业高品质专线（如 光速云 核心专线推荐）：采用的是企业级 IPLC / IEPL 物理内网跨境直达光缆，晚高峰完全无视公网拥堵，千兆秒开 4K/8K 视频，适合日常高带宽娱乐、跨国视频会议与团队协作。因此，成熟用户的最佳策略是：商业专线作为日常主力托底，自建节点通过 Merge 脚本混合注入作为高纯净度私有通道。