Clash Verge 如何手动添加代理节点？

功能定位：手动添加节点解决什么问题

Clash Verge 是一款跨平台的 Clash 内核图形客户端，支持订阅管理与本地配置。手动添加代理节点，指的是不依赖订阅链接，直接在配置文件中逐条写入节点信息。这适用于以下场景：你只有少量自建节点（如家庭 VPS）、订阅链接暂时不可用、或需要临时测试某个新协议节点。与订阅方式相比，手动添加更加灵活，但维护成本也更高——当节点超过 10 个时，每次修改都需要重载配置，容易因缩进或拼写错误导致节点不可用。从 2026 年 10 月的视角看，Clash Verge 的配置语法与 Clash 核心保持一致，手动添加节点仍然是核心基础操作，也是理解 Clash 代理工作原理的最佳入门方式。

核心操作：编辑配置文件的两个路径

手动添加节点的本质是修改 Clash 的 YAML 配置文件。Clash Verge 提供两种编辑方式：一是使用内置的文本编辑器，二是用外部编辑器直接修改本地文件。两种方式各有利弊：内置编辑器操作便捷且有基本验证，而外部编辑器适合批量编辑或习惯专业工具的用户。下面分平台说明最短路径。

方式一：通过 Clash Verge 内置编辑器

打开 Clash Verge，左侧导航栏点击「Profiles」（配置文件），当前激活的配置文件会高亮显示。点击该配置右侧的编辑图标（通常是一支笔的图标），即可在新标签页打开内置的 YAML 编辑器。这是最推荐的方式：无需手动查找文件路径，且编辑器会自动检查缩进（在最新版本中，内置编辑器支持语法高亮与基础验证）。将节点信息添加到 proxies: 字段下，保存后回到主界面点击「重启核心」即可生效。如果配置文件中没有 proxies: 字段，需要手动创建，注意在字段名后加冒号并换行缩进。

方式二：通过外部编辑器（适用于批量编辑）

如果你习惯使用 VS Code、Sublime Text 等专业编辑器，可以直接修改 Clash Verge 的本地配置文件。配置文件位置因操作系统而异：

• Windows：路径通常为 %USERPROFILE%\.config\clash\profiles\ 或 Clash Verge 安装目录下的 profiles 文件夹。
• macOS： ~/.config/clash/profiles/
• Linux： ~/.config/clash/profiles/

文件命名通常是 xxx.yaml。找到当前使用的配置文件（可以通过 Clash Verge 主界面查看配置文件名），用外部编辑器打开后编辑 proxies: 部分。保存后，在 Clash Verge 主界面点击「重载配置文件」或切换一下配置再切回来，也可生效。注意：外部编辑时如果 Clash Verge 正在使用该文件，可能会提示文件锁定，此时建议先退出 Clash Verge 再编辑，或者改用内置编辑器以避免冲突。

节点格式：必学 YAML 填写规范

手动添加的关键是写出符合 Clash 内核规范的 YAML 节点对象。每个节点是一个字典，字段因协议而异。下面以最常见的 Shadowsocks 和 VMess 为例，展示完整格式。建议在添加前先确认服务器端使用的协议版本，避免因版本差异导致连接失败。

Shadowsocks 节点示例

在 proxies: 字段下添加：

- name: "my-ss-node"
  type: ss
  server: 192.168.1.100
  port: 8388
  cipher: aes-128-gcm
  password: "your-password"
  udp: true

其中 name 是别名（可自定义），cipher 需与服务器端一致，常见有 aes-256-gcm、chacha20-ietf-poly1305。填错加密方式会直接导致连接失败。注意密码如果包含特殊字符（如 $、#），需要用双引号包裹，否则 YAML 解析可能出错。

VMess 节点示例

VMess 节点略有不同，需要填写 uuid、alterId 和 security：

- name: "vmess-node"
  type: vmess
  server: example.com
  port: 443
  uuid: "550e8400-e29b-41d4-a716-446655440000"
  alterId: 0
  cipher: auto
  tls: true
  network: ws
  ws-path: /path
  ws-headers:
    Host: example.com

注意：alterId 默认为 0，许多现代 VMess 服务器已弃用 alterId；若服务器未启用 TLS 则需将 tls 设为 false。填写错误会导致握手失败，日志中可见 TLS handshake error 或 authentication failed。如果使用 WebSocket 传输，请确保 ws-path 和 ws-headers 中的 Host 与实际服务器配置一致。

添加后的验证与生效

保存配置文件后，在 Clash Verge 主界面的「Proxies」标签页中应能看到新增的节点。点击该节点，观察延迟测试结果（从 2024 年起，Clash Verge 内置了基于 ICMP 或 TCP 的延迟测试）。如果节点显示超时或连接失败，请检查：

• 缩进是否正确——YAML 对缩进极其敏感，建议使用 2 个空格，不要用 Tab。
• 服务器地址、端口、密码等是否与服务端匹配。
• 是否在全局代理模式下测试？先切换到「Rule」模式或「Direct」模式，再测试节点本身。

一个可复现的验证步骤：在 Clash Verge 日志（Logs 标签页）中筛选该节点的连接记录。如果出现 failed to dial 等字样，说明配置有误。根据经验，超过 80% 的手动添加失败案例源自 YAML 缩进错误或密码中的特殊字符未加引号。建议在编辑完成后，先用在线 YAML 校验器（如 yamllint.com）检查一遍结构。

例外与取舍：什么时候不该手动添加

手动添加虽然自由，但有以下边界：

• 节点数量过多：超过 10 个节点时，手动维护成本急剧上升。每次新增、修改或删除都需要编辑 YAML，且容易引入格式错误。建议使用订阅链接或 proxy-provider 来自动拉取。
• 节点频繁变化：如果服务器 IP、密码、端口每周变更，手动更新非常低效。订阅方式更合适。
• 需要负载均衡或自动测速：手动添加的节点只能被动选择，无法像 proxy-groups 那样自动切换。如果要实现 url-test 类型的策略组，仍需配合订阅或 proxy-provider。

一个典型场景：你有一台自建 VPS，仅用于访问少数网站，节点数量 1-3 个，且长期不变。此时手动添加最清晰，也避免订阅链接泄露。反之，若你使用机场服务，节点列表上百，务必使用订阅链接，否则手动维护的代价将远超收益。

故障排查指南

手动添加后最常见的报错及处置：

现象1：保存后节点未出现在列表中

原因通常是配置文件语法错误，Clash 内核拒绝加载整个配置。查看日志，会提示 YAML 解析失败。处置：使用在线 YAML 校验器（如 yamllint.com）或 Clash Verge 内置验证（若有）检查缩进。特别注意 proxies: 后必须换行并缩进，列表项以 - 开头。

现象2：节点延迟显示超时但实际可用

Clash Verge 的延迟测试有时默认使用 ICMP ping，而某些服务器禁 ping。可以去「Settings」中修改延迟测试类型为 TCP（需 Clash Verge 1.6+ 版本支持）。另一种可能是防火墙屏蔽了 ICMP，不影响实际代理流量。建议先尝试通过浏览器访问网站来验证节点是否可用，而不仅依赖延迟测试结果。

现象3：连接后无法访问任何网站

检查策略组配置。手动添加的节点不会自动加入任何策略组，需要在 proxy-groups: 中将该节点名加入 proxies 列表，或设置 use 为节点名。最简单方式：在「Proxies」页面手动选择该节点，或者将其设置为全局代理。如果还是不行，检查系统代理设置是否被其他软件抢占，例如某些 privacy tool 或代理工具可能会覆盖系统代理配置。

适用与不适用场景清单

适用场景（推荐手动添加）

• 拥有 1-5 个自建节点且长期不变。
• 临时测试新协议或服务器配置。
• 不希望暴露订阅链接给第三方客户端。
• 需要精确控制节点参数（如自定义 WS 路径、TLS SNI）且不想依赖订阅翻倍。

不适用场景（应使用订阅）

• 节点数量超过 10 个。
• 节点信息频繁更新（如动态 IP、每周换端口）。
• 需要利用 Clash 的 proxy-provider 实现自动更新和负载均衡。
• 与其他用户共享同一套配置，手动同步不便。

最佳实践清单

结合经验，以下做法可降低手动添加的出错率：

1. 使用 Clash Verge 内置编辑器：内置编辑器会实时检查 YAML 缩进，且自动备份（部分版本支持）。
2. 为节点命名遵循规范：避免使用中文、空格和特殊符号（可用下划线或连字符），否则某些策略组中显示异常。
3. 先测试再应用：添加后先切换到「Rule」模式，仅用该节点访问一个简单网站（如 ip.sb），确认 IP 正确。
4. 开启日志记录：在 Clash Verge 的「Settings」中开启核心日志，级别设为「warning」或「info」。遇到问题时第一时间查看日志。
5. 备份原始配置：大规模编辑前复制一份配置文件；Clash Verge 的「Profiles」页面支持导出当前配置。
6. 使用 proxy-groups 整合：即使手动添加节点，也建议构建一个 select 类型策略组把节点纳入，方便切换。

FAQ（常见问题）

性能与成本视角的总结

手动添加代理节点在低节点数（<10）且稳定不变时，是最直接的方案：无需依赖外部订阅服务，隐私性更好。但一旦节点数量增多或变化频繁，维护成本（时间、出错概率）会超过订阅方式。建议以 10 个节点为阈值——超过后优先采用订阅 + proxy-provider 方案。Clash Verge 的强大之处在于同时支持两种方式，你可以混合使用：部分节点手动添加，部分通过订阅拉取，只要注意命名不冲突即可。

无论采用哪种方式，养成备份配置文件的习惯。Clash Verge 的「Configs」页面支持导出为 ZIP，建议每次有较大改动前执行一次导出。展望未来，随着 Clash Verge 持续迭代，手动编辑的体验可能会进一步简化（例如内置节点模板功能），但理解 YAML 语法和节点结构始终是灵活使用 Clash 的基础。