配置概念 · 字段对照
Clash 术语手册
按概念定位配置问题：先区分客户端与内核，再查代理协议、规则、DNS 和更新字段。
本页收录 25 个常用术语。解释以 Clash 生态及 mihomo 常见配置为范围；具体支持情况仍需对照正在运行的内核与客户端说明。每张卡片都有独立锚点，可直接分享对应条目。
内核与客户端
界面负责操作入口，内核负责网络处理，订阅负责分发配置。排查兼容性时，需要分别确认这三个层次。
- 客户端Client / GUI
- 提供配置导入、代理开关、日志查看和更新入口的应用，实际网络处理通常交给内核完成。同一客户端可能支持切换内核，因此界面名称相同并不代表协议能力完全一致。反馈问题时应同时记录客户端名称、内核名称与各自版本，而不是只提供应用截图。
- 内核Core
- 负责读取配置、处理代理协议、匹配规则并转发连接的程序。某个字段能否生效，取决于内核及其版本，不只取决于设置页是否存在相应开关。客户端升级、内核升级和订阅更新是不同操作；新增协议无法仅靠刷新订阅获得支持。
- mihomoClash Meta 的后续项目名称
- 由 Clash Meta 项目演进而来的代理内核，提供规则分流、资源提供器、TUN 和 DNS 等能力，不是某一个桌面界面的专属名称。它既可以由图形客户端管理，也可以单独运行。复制配置前应核对所需功能是否受当前版本支持，版本演进关系可参阅内核差异说明。
- Clash Meta历史名称与生态标识
- Clash 生态中的内核分支名称，其后续维护使用 mihomo 名称。旧教程、配置注释以及部分客户端名称仍会保留 Meta 字样，不宜仅凭这个名称推断配置新旧。遇到字段解析错误，应查看实际运行内核的版本与报错位置，再决定更新内核还是调整配置。
- 订阅Subscription
- 通过远程 URL 获取并更新配置或代理资源的分发方式，链接可能返回完整 YAML 配置，也可能只返回代理列表，两者不能直接视为同一种格式。完整配置更新可能替换规则和策略组，持久修改宜使用客户端支持的覆写机制。订阅链接可能包含访问凭据，不应放入公开截图、日志或在线转换服务。
代理协议
协议规定客户端与服务端如何通信；服务器地址、认证信息、传输方式和 TLS 设置则共同构成一条可用的连接配置。
- 节点Proxy entry
- 对一个代理连接配置的常用称呼，通常包含服务器地址、端口、协议类型、认证和传输参数。节点名称只是显示标签，不构成对地理位置、带宽或可用性的保证。导入后无法连接时，应检查配置是否完整、内核是否支持该协议，以及本机能否访问服务端，而不是只看列表中是否出现名称。
- Shadowsockstype: ss
- 常见的代理协议，配置中通常使用
ss类型，需要服务器地址、端口、加密方法和密码等参数。客户端与服务端必须支持并使用一致的加密方法；部分配置还依赖插件或额外选项。看到相同协议名称不代表所有实现支持相同扩展，迁移配置时应逐项核对。
- VMesstype: vmess
- 使用用户标识等参数进行认证的代理协议，可搭配不同传输方式与 TLS 设置。导入成功只代表配置能够被读取，并不代表标识、路径或服务器名称一定正确。若认证或握手失败，应同时检查服务端参数与系统时间；单独更换 DNS 通常无法解决认证参数不匹配的问题。
- VLESStype: vless
- 强调轻量认证的代理协议，本身不提供传输加密，常与 TLS 或 REALITY 等机制配合使用。能否连接还取决于传输方式、服务器名称以及相关握手参数，而不是填写用户标识即可完成。不同内核版本支持的组合可能不同，不能将其他客户端的字段未经核对直接粘贴到 YAML 中。
- Trojantype: trojan
- 通常基于 TLS 建立连接的代理协议，常见配置包括服务器、端口、密码和服务器名称。证书验证错误可能来自名称不匹配、证书链异常或本机时间错误，应先定位原因。跳过证书验证会改变连接的安全条件，不宜把它作为所有握手错误的默认处理方式。
规则与分流
规则判断连接去向，策略组决定具体出口。查看命中记录通常比反复更换配置更容易定位分流问题。
- 规则分流rules / DOMAIN-SUFFIX / MATCH
- 按域名、目标 IP 等条件选择直连、代理或拒绝等处理策略的机制。规则通常从上到下匹配，命中后执行对应策略，因此宽泛规则放得太早可能遮住后面的精细规则。排查时先确认处于规则模式，再查看连接命中了哪条规则；兜底的
MATCH通常放在列表末尾。
- 策略组proxy-groups
- 将多个代理或其他策略组织为统一出口，让规则引用一个稳定的组名。
select通常供用户手动选择，url-test根据测试结果选择出口，fallback则侧重按顺序选用可用出口。自动选择依赖测试目标与检测周期，不等同于自动找到实际下载速度最高的线路。
- 规则集rule-providers / RULE-SET
- 将一批匹配条件放入独立文件，便于更新和复用，通常先在
rule-providers中声明，再用RULE-SET引用。规则集的behavior与format需要匹配文件内容。资源下载成功不代表已经参与分流，还应确认引用名称、规则顺序和目标策略是否正确。
- GeoIPGEOIP
- 基于 IP 地理归属数据库对目标地址进行分类匹配，适合补充域名规则未覆盖的连接。数据库标注并不是精确的服务器物理位置，CDN、地址分配变化与数据库更新时间都可能影响结果。域名连接执行这类规则时可能涉及解析；
no-resolve可限制为规则匹配而触发的解析，需理解取舍后使用。
- 延迟Latency / URL test
- 客户端对指定测试目标执行探测所需时间的指标，具体含义随测试 URL、协议、连接复用和网络环境而变化。较低的测试值不能直接推导出更高下载速度，也不能保证某个网站可访问。比较时应保持测试条件一致，再结合实际应用验证；异常结果可按延迟排查说明逐项检查。
DNS 与网络栈
流量是否进入内核、域名由谁解析、解析结果如何用于规则，是三个不同问题。开启一个开关不能代替整条链路检查。
- TUN 模式tun
- 通过虚拟网络接口及路由设置接管流量，可覆盖部分不遵循系统代理的应用。它通常需要额外权限，实际覆盖范围还取决于自动路由、路由排除项和系统网络环境。启用 TUN 不等于已经接管所有 DNS 或所有应用；与其他 VPN 并用时，应特别检查路由竞争和接口冲突。
- DNSDomain Name System
- 将域名转换为 IP 地址等记录的系统，解析结果也可能参与后续规则判断。操作系统解析、客户端内置解析与浏览器加密 DNS 可能走不同路径，改动其中一项未必影响其他路径。检查配置时应区分解析器地址、解析请求的出站方式以及缓存，详细配置顺序见完整手册 DNS 章节。
- Fake-IPenhanced-mode: fake-ip
- 向应用返回虚拟地址，并由内核维护虚拟地址与域名映射的 DNS 工作方式，便于后续按域名分流。应用看到的虚拟地址不是目标服务器真实地址，因此不能据此判断服务器位置。依赖真实解析结果的特殊应用可能需要加入
fake-ip-filter，调整后还应处理旧缓存并重新建立连接。
- DNS 泄漏DNS leak
- DNS 查询偏离预期路径，到达非预期解析器的情况；是否属于异常，需要先明确希望哪些查询走哪条路径。启用 TUN、Fake-IP 或加密 DNS 都不能单独证明解析符合预期。应结合系统设置、浏览器独立 DNS、客户端日志和测试结果判断，测试页显示的解析器地区也不能直接证明泄漏。
- Redir-Hostenhanced-mode: redir-host
- 通常向应用返回真实解析地址的 DNS 增强模式，与 Fake-IP 返回虚拟地址的方式不同。它可能更适合某些依赖真实地址的应用，但域名与连接之间的关联条件也会不同。切换模式后，操作系统和应用可能仍保留旧 DNS 缓存，宜清理缓存或重启相关应用后再比较效果。
配置文件字段
阅读字段时同时看名称、所在层级和单位。看起来相同的“更新间隔”，可能分别控制完整配置、代理资源或健康检查。
- YAMLconfig.yaml
- Clash 配置常用的数据序列化格式，使用缩进表示层级，用键值和列表组织字段。缩进应使用空格，不使用制表符；含特殊字符的字符串可按语法要求加引号。YAML 语法正确不代表内核认识全部字段，修改后应先查看配置检查结果，再加载使用，并保留可恢复的原始配置。
- moderule / global / direct
- 指定内核工作模式的顶层字段，常见值为
rule、global和direct，分别对应规则、全局和直连模式。它决定进入内核的连接如何选路，不负责让应用流量自动进入内核。全局模式并不等于系统所有应用都会使用代理，还要检查系统代理或 TUN 是否覆盖目标应用。
- proxy-providers代理资源提供器
- 用于声明代理资源来源，可从远程地址或本地文件读取代理列表，并按配置刷新。它与完整配置订阅不同：资源列表通常不负责定义整套规则与 DNS 设置，加载后还需要由策略组引用。排查资源更新失败时，应分别检查地址可达性、返回格式、本地缓存路径和引用关系。
- interval字段层级与时间单位
- 表示间隔，但含义由所在层级决定：提供器的
interval通常控制资源刷新，health-check.interval则控制可用性检测，常见单位都是秒。客户端完整配置更新界面可能使用分钟，两者不能直接照抄数值。缩短间隔不会修复格式或认证错误，更新失败可先查订阅更新排查。
- mixed-portHTTP / SOCKS 共享监听端口
- 在同一端口提供 HTTP 与 SOCKS 代理入口，方便应用指向统一的本地监听端口。端口已被其他程序占用时，内核可能无法建立监听，需要结合日志检查，而不是仅修改系统代理地址。允许局域网使用还涉及监听地址、防火墙与访问控制，不能只把端口号填入另一台设备就视为完成。