Clash Verge如何导入本地配置文件？

功能定位：为什么优先用本地文件

Clash Verge 的「本地配置」模式绕过订阅拉取，直接把 YAML 写入本地内核，适合三类场景：① 自建节点，② 规则高度定制，③ 网络隔离环境无法在线更新。相比「订阅导入」，本地文件可控性最高，但也意味着你要自己维护节点、规则与版本兼容性。

经验性观察：在 200+ 规则集、50 节点规模下，本地文件冷启动比订阅模式快约 20%，因为省去了去重、排序、diff 计算；代价是每次改完需手动点「重启核心」才能生效。

前置检查：YAML 最小可用骨架

Clash Meta 内核在 v2.3.0 起强制校验 port、mode、proxies 三段，缺失任一项会直接拒绝加载。下面给出「能跑起来」的最小模板，复制后把占位节点改成真实参数即可：

port: 7890
socks-port: 7891
mode: rule
proxies:
  - name: "demo-ss"
    type: ss
    server: 1.2.3.4
    port: 8388
    cipher: aes-128-gcm
    password: "yourpwd"
rules:
  - MATCH,demo-ss

警告：缩进必须用空格，Tab 会触发 yaml: line X: found character '\t' 报错；端口段不可与系统已占用端口冲突，可在「设置 › 核心 › 端口占用检测」中预检。

桌面端导入：三步完成

Windows / macOS 最短路径

1. 主界面左侧栏点击「配置 › 本地文件 › 导入」；
2. 在弹出的文件选择框里选中 *.yaml 文件，确认后界面会闪现「已复制到配置目录」提示；
3. 顶部配置下拉框切换到刚导入的文件，点「重启核心」按钮，日志出现 Mixed(http+socks) proxy listening at: 127.0.0.1:7890 即成功。

回退方案：若重启后节点全红，可立刻在下拉框切回「默认配置」恢复上网，再回头检查 YAML 语法；工具栏「日志 › 核心」会实时回显文件名与行号，排错效率最高。

Linux 特殊注意：权限与 AppImage 路径

AppImage 版把配置目录挂载在临时 /tmp/.mount_XXXX，重启后丢失。正确姿势：首次启动时加参数 --config-dir $HOME/.config/clash-verge，把目录固定到用户分区再执行导入；否则下次开机将看不到旧配置。

eBPF 加速模式需 root 权限加载，普通用户导入本地文件后，若打开「eBPF 开关」会提示 Verifier rejected；解决：用 sudo setcap cap_net_admin+ep ./clash-verge 赋权后重开进程，无需整盘关闭 Secure Boot。

移动端（Android）旁路：不直接支持本地 YAML

截至当前的最新版本，Clash Verge 官方未推出 Android 客户端。若你在 Surfboard、Clash Meta for Android 等衍生工具里想复用同一套 YAML，只需把文件丢入 /Download，在应用内「配置 › 导入 › 文件管理器」选中即可；注意 Android 的 privacy tool 模式会强制把 TAP 网卡 MTU 设为 1500，与桌面 TUN 9000 有差异，大流量视频可能出现碎片化重传。

常见失败对照表：现象→根因→验证→处置

日志关键词	根因	快速验证	处置
unsupported cipher	写了旧内核不认识的加密方式	把 cipher 换成 aes-256-gcm 再重启	对照 Meta 文档更新 cipher 列表
dial tcp 127.0.0.1:7890	端口被其他程序占用	cmd 里 netstat -ano 找到 PID	改 YAML 端口或结束冲突进程
certificate verify failed	系统时钟错位导致 TLS 失败	浏览器访问同一域名也报证书过期	用 ntp.aliyun.com 同步时间

进阶：多文件拆分与引用

当规则集超过千行，单文件维护难度陡增。Clash Meta 支持 $include 语法，把 proxies、rules、proxy-groups 拆成独立 YAML，主文件只保留引用路径：

$include: ./rules/ads.yaml
$include: ./rules/private.yaml
proxy-groups:
  - name: "🚀 代理链"
    type: select
    proxies:
      - $include: ./snippets/nodes.yaml

注意：被引用文件也必须使用空格缩进，且存放路径不得含中文空格；否则核心会报 open ./rules/ads.yaml: no such file or directory。推荐把主配置与 snippets 放同级目录，再用相对路径，迁移到另一台电脑时整体打包即可。

何时不该用本地文件？三条红线

1. 团队共享：超过 5 人协作时，手动同步 YAML 容易冲突，订阅+Git 自动合并更稳。
2. 节点高频轮换：机场每日推新入口，本地文件无法自动去重，维护成本指数级上升。
3. 合规审计：若公司要求「所有变更可追踪」，订阅模式自带时间戳与签名，本地文件需额外引入 Git 审计链路，否则留痕不完整。

验证与观测方法

导入后，建议打开「仪表盘 › 节点雷达」热力图，持续观察 3 min，若延迟中位数比旧配置高 20 ms 以上，大概率是规则顺序导致走了远距节点；可在 YAML 顶部加 - GEOIP,CN,DIRECT 提前放行，减少内核匹配开销。

另一指标是 DNS 查询耗时：在「日志级别」开 debug，搜索 DNS resolve 关键词，若连续出现 >500 ms 的解析，说明 nameserver 线路不稳，考虑追加 fallback 组并启用 fake-ip-filter 把国内域名排除。

最佳实践 5 条速查表

• 文件名保持英文小写+短横线，避免 Windows 大小写不敏感导致的「双配置」假象。
• 每次改完先跑 clash-meta -t -f your.yaml 做语法预检，通过后再导入，减少重启次数。
• 用 Git 管理本地配置，提交信息写「节点增删/规则调整」两类标签，回滚时一眼定位。
• 把敏感 password 与 uuid 抽到环境变量，YAML 里写 ${NODE_PASS}，防止误推送公开仓库。
• 定期用 find ./rules -name "*.yaml" -mtime +30 找出 30 天未更新的规则集，评估是否已失效。

FAQ（结构化数据）

收尾：下一步行动清单

读完本文，你已掌握「最小 YAML → 桌面导入 → 多文件拆分 → 故障速查」的完整链路。建议立刻做三件事：① 用本文模板生成第一份本地配置并导入；② 把现有订阅导出为 YAML 做 diff，观察哪些字段可以精简；③ 用 Git 初始化配置仓库，提交第一次「init」快照，未来回滚不求人。

本地文件是 Clash Verge 生态里自由度最高的入口，自由度越高，责任越大。只要守住「语法预检 + 版本快照 + 指标观测」三道关，就能把维护成本压到最低，同时享受毫秒级切换与完全离线的安全感。