Clash Meta 配置文件生成器：订阅转 YAML 与导入排查

更新于 2026-10-24 · acaisbest.shop

简答：不想手写 YAML 时，订阅优先用 proxy-providers，单节点用于逐项排错；生成后检查字段和策略组引用，再用 mihomo -t 校验，最后导入 Clash Verge Rev 并查看日志确认规则命中。

定义：Clash Meta 配置文件生成器，是把节点参数或订阅链接整理为 Mihomo 可读取的 YAML，并同时生成策略组、规则、DNS 或 TUN 配置的工具、模板或本地处理流程。

先试这一步：按输入内容选择模板

如果你正在找“Clash Meta 配置文件生成器”，最快的做法不是先改一大份 YAML，而是先判断手里的输入是什么：只有一个节点，就用单节点模板；有订阅链接，就用 proxy-providers 保留自动更新；需要接管系统流量，再单独启用 DNS 和 TUN。下面这张速查卡可以直接决定入口。

Clash Meta 配置文件生成方式速查

你的情况	优先选择	先检查什么
只有 VLESS、Hysteria2、TUIC 或 WireGuard 参数	单节点 YAML	服务器、端口、认证字段、TLS 或传输参数是否来自服务端原始信息
已有订阅链接，节点会持续变化	`proxy-providers`	订阅地址是否含账号凭证、provider 名称是否唯一、策略组是否引用 provider
想统一管理多个节点	provider 加 `select` 或 `url-test`	策略组是否引用真实节点或 provider，自动测速组是否误加入 `DIRECT`
想让未设置代理的应用也走客户端	DNS 加 TUN	系统权限、路由、DNS 劫持和应用兼容性

本页提供的是可复制模板和校验流程，不是把订阅上传到服务器的在线表单。浏览器本地处理或自建转换流程更适合带认证信息的订阅；使用第三方在线转换器前，应先确认数据处理方式，用过后如担心凭证暴露，应在订阅服务处重置或更换订阅链接。

关系先说清：Clash Meta 是社区中常用的旧称，当前内核项目名称为 Mihomo；Clash Verge Rev 是桌面客户端，不等于 Mihomo 内核。配置能否导入，取决于客户端捆绑的内核和它支持的字段，字段定义应以 Mihomo 配置文档为准。

订阅转 YAML：用 proxy-providers 保留自动更新

订阅入口适合节点数量较多、服务端会持续更新的情况。Mihomo 的 proxy-providers 用 provider 名称保存远程节点集合，HTTP 类型需要 url，本地保存位置可用 path，策略组再通过 use 引用 provider。官方字段说明见 Mihomo Proxy Providers 文档。

mixed-port: 7890
mode: rule
log-level: info
allow-lan: false

proxy-providers:
  subscription:
    type: http
    url: "https://example.com/your-subscription"
    path: ./proxy-providers/subscription.yaml
    interval: 3600
    health-check:
      enable: true
      url: https://www.gstatic.com/generate_204
      interval: 300
      timeout: 5000

proxy-groups:
  - name: PROXY
    type: select
    use:
      - subscription
    proxies:
      - DIRECT
  - name: AUTO
    type: url-test
    use:
      - subscription
    url: https://www.gstatic.com/generate_204
    interval: 300
    tolerance: 50

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,PROXY

订阅入口：url 换成服务端提供的订阅地址，不要把带认证信息的链接放进公开文档、截图或聊天记录。
策略组引用：use 中的 subscription 必须与上方 provider 名称完全一致。
自动测速：AUTO 只引用订阅节点，没有加入 DIRECT，避免测速时直连被选中。
规则兜底：最后保留 MATCH,PROXY，否则未匹配流量没有明确处理方式。

如果你需要把订阅内容转换为静态 YAML，建议先在本地完成转换，再检查生成结果中的 proxies、proxy-groups、rules 和 DNS；不要因为“转换成功”就跳过内核校验。

单节点模板：协议字段不要混填

单节点配置适合排查“节点显示但连不上”的问题。通用字段通常包括唯一的 name、协议 type、服务器 server 和数字端口 port；认证、TLS、SNI、传输方式等字段再根据协议补充。通用字段可参考 Mihomo 通用代理字段。

常见协议的字段方向

协议	核心认证字段	常见附加字段	核对重点
VLESS	`uuid`	`tls`、`servername`、`flow`、`network`、`ws-opts`、`grpc-opts`、`reality-opts`	Reality 的公钥和 short-id 必须来自服务端；普通 TLS 不要自行猜测 Reality 字段
Hysteria2	`password`	`sni`、`up`、`down`、`obfs`、`obfs-password`、`ports`	端口跳跃和 salamander 混淆参数必须与服务端一致
TUIC	按服务端选择 `token`，或 `uuid` 与 `password`	`sni`、`alpn`、`udp-relay-mode`、`congestion-controller`	不要把不同版本的认证字段同时填入
WireGuard	`private-key` 与 peer 公钥	`ip`、`allowed-ips`、`pre-shared-key`、`mtu`、`remote-dns-resolve`	客户端地址、服务端公钥和 allowed-ips 必须对应服务端配置

协议字段应分别对照 VLESS 文档、Hysteria2 文档、TUIC 文档和 WireGuard 文档。例如 VLESS 普通 TLS 模板可以这样写：

proxies:
  - name: "VLESS-节点"
    type: vless
    server: server.example.com
    port: 443
    uuid: "00000000-0000-0000-0000-000000000000"
    udp: true
    tls: true
    servername: example.com
    network: tcp

proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - "VLESS-节点"
      - DIRECT

rules:
  - MATCH,PROXY

这里没有默认添加 client-fingerprint。它是可选字段，只有在服务端参数或实际兼容需求明确时才填写；没有可靠来源时，删除比猜一个值更安全。WebSocket、gRPC、Reality 等传输参数也不能仅凭协议名称推断，必须按服务端给出的原始参数填写。

DNS、fake-ip 与 TUN：先理解作用，再决定是否开启

DNS 和 TUN 是进阶选项，不是每份配置都必须开启。Mihomo 文档将 fake-ip 与 redir-host列为两种 DNS 增强模式：前者适合透明接管场景，后者更接近传统域名解析。fake-ip 地址段应使用文档中的保留范围，例如 198.18.0.1/16，不要改成普通公网地址。具体字段见 Mihomo DNS 配置文档。

dns:
  enable: true
  ipv6: false
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - https://dns.example.com/dns-query
  proxy-server-nameserver:
    - 1.1.1.1
  fake-ip-filter:
    - "+.lan"
    - "+.local"

tun:
  enable: false
  stack: mixed
  auto-route: true
  auto-detect-interface: true

nameserver：处理普通域名解析，可按所在网络替换为实际可访问的 DNS 或 DoH。
proxy-server-nameserver：专门直接解析代理节点的域名，避免“连接代理前又必须先通过代理解析节点域名”的循环；它不是让代理服务器域名再走代理。
fake-ip：透明接管更方便，但局域网、游戏、企业内网和部分应用可能需要加入过滤或切换到 redir-host 对比。
TUN：会改变系统流量接管和路由方式，先保持 enable: false 验证普通代理，再按客户端支持和系统权限开启。

TUN 的路由、DNS 劫持、MTU 和平台字段应参考 Mihomo TUN 文档。Windows 可能需要允许 TUN 服务模式，macOS 需要在系统隐私与安全性中放行网络扩展或解除隔离，Linux 需要检查专用用户对配置目录和相关设备的权限，Android 需要允许 VPN 接管；iOS 没有对应的 Clash Verge Rev 桌面客户端，应使用支持该配置格式的其他客户端。

5 项生成前校验：避免导入后空节点或无法启动

YAML 格式：缩进只用空格，不使用 Tab；冒号后留空格；名称、密码和 URL 中含有特殊字符时使用引号。
节点字段：name 不重复，server 不为空，port 是数字，UUID、密码、密钥和 URL 没有被截断。
协议组合：VLESS 的 servername、Reality 公钥、short-id、network 和传输选项要与服务端一致；没有对应参数就删除可选字段。
引用关系：proxy-groups 引用的节点、组或 provider 必须已经声明；规则中的策略组名称也必须存在。
网络条件：端口没有被其他程序占用，DNS 地址可以访问，TUN 开启时具备系统权限。常见代理端口为 7897 或 7890，实际以客户端设置页为准。

如果使用官方 mihomo 命令行，可在下载并放置好内核后运行：

mihomo -t -d <配置目录>
mihomo -t -f config.yaml

-d用于指定配置目录，-f用于指定配置文件；实际启动参数仍应结合所用客户端或服务管理方式确认。校验对象是配置文件本身，不能代替节点连通性测试。端口占用排查时，Linux 可用 sudo ss -lntup；macOS 使用 lsof -nP -iTCP:<端口> -sTCP:LISTEN；Windows 可用系统自带的 netstat -ano。

导入 Clash Verge Rev：本地 YAML 与远程订阅

Clash Verge Rev 的官方配置文档将导入分为远程订阅和本地配置两类，并说明本地配置可通过新建配置文件或拖拽文件导入。可查看Clash Verge Rev 配置文件文档，菜单名称以当前版本界面为准。

打开 Clash Verge Rev，进入“订阅（Profiles）”页面。
导入本地配置时，选择“新建配置文件”或将保存好的 config.yaml 拖入配置列表；也可以选择你自己命名的 YAML 文件。
导入远程订阅时，在订阅地址输入框粘贴 URL，再执行导入或保存。
确认配置出现在列表后，点击该配置的激活或使用按钮。
进入代理页面，先选择 PROXY 或生成的实际策略组，再查看连接日志中的命中策略；必要时对比开启前后的出口 IP。

本地 YAML 导入成功，只代表文件被读取，不代表节点一定可连接。远程订阅更新后，手动改动可能被新的订阅内容覆盖；如果要长期保留自定义规则或策略组，应使用客户端支持的覆写或追加语法，不要直接覆盖顶层 proxies、rules，也不要引用未声明的策略组。

生成后常见问题：按现象定位

配置生成与导入故障速查

现象	优先检查	处理顺序
YAML 无法导入	Tab、缩进、重复键、特殊字符	用纯文本编辑器保存，删除 Tab 和重复顶层键，再执行 `mihomo -t`
订阅导入后列表为空	URL、provider 路径、返回内容	查看更新日志，确认 URL 可访问，再检查 provider 是否被策略组通过 `use` 引用
节点存在但连接失败	服务器、端口、UUID、密码、SNI、Reality 参数	逐项对照服务端原始参数，不要把 `server`、SNI、Host 当成同一个字段
域名无法解析	DNS、fake-ip、IPv6、代理节点域名解析	先关闭 TUN 或切换 `redir-host` 做对比，再检查 `proxy-server-nameserver` 和 DNS 日志
开启 TUN 后网络异常	系统权限、路由、DNS 劫持、MTU	先关闭 TUN 验证普通代理，再按平台权限、路由和 MTU 逐项恢复

判断是否真正走了代理，应查看连接日志里命中的策略，或对比代理开启前后的出口 IP；仅看到客户端显示“已连接”，不能证明目标流量已经按预期匹配。

如果下一步遇到域名解析错误，可以继续查看Clash DNS 解析失败的定位步骤；遇到证书校验错误，可参考Clash x509 报错排查；使用 v2rayN 导入订阅，则查看v2rayN 订阅导入与连接排查。

常见问题

Clash Meta 配置文件生成器生成的 YAML 能直接导入 Clash Verge Rev 吗？

通常可以，但 YAML 语法、字段和策略组引用都必须被客户端内核支持。导入后还要激活配置，并从连接日志确认实际命中的策略。

订阅链接应该放在 proxies 还是 proxy-providers？

需要自动更新时优先放在 proxy-providers；proxies 适合直接写入单节点。订阅 URL 不是单节点字段，不能仅放进 proxies 就完成订阅解析。

把订阅交给在线转换器安全吗？

订阅链接通常可能包含账号凭证。优先选择浏览器本地处理或自建转换流程；使用第三方在线服务前应确认其数据处理方式，用过后可在订阅服务处重置链接。

为什么策略组里看不到订阅节点？

常见原因是策略组没有通过 use 引用正确的 provider，或 provider 名称、策略组名称存在大小写和空格差异。先检查声明，再检查引用。

VLESS 配置里的 server、servername、SNI 和 Host 是一回事吗？

不是。server 是连接目标地址，servername 常用于 TLS 或 Reality 的服务名，WebSocket 等传输还可能有独立 Host。字段名称和层级必须按对应 Mihomo 文档及服务端参数填写。

fake-ip 和 redir-host 怎么选？

fake-ip 更适合透明接管和 DNS 劫持场景，redir-host 更接近传统解析。遇到局域网、游戏、企业内网或特定应用异常时，可先切换模式或关闭 TUN 做对比。