CONFIG.YAML / 术语查阅
Clash 配置术语表。
从界面名称找到配置含义。按五个主题查阅 25 个常用术语，区分连接接管、DNS 解析与规则选择，避免把不同层的问题混在一起。
内核与客户端
先辨认正在使用的程序、内核和配置来源。同一个界面按钮，在不同客户端中可能对应不同的配置处理方式。
- mihomo / Clash.Metamihomo 内核
- mihomo 是由 Clash.Meta 演进而来的代理内核，承担协议连接、DNS 处理和规则匹配等工作；Clash.Meta 是它沿革中的旧名称。图形界面通常只是管理内核的入口，界面更新与内核更新不一定同步。遇到配置字段不支持时，先在客户端的关于或内核信息中确认实际版本，而不是只看应用名称。
- client / GUI客户端
- 客户端是用户安装并操作的应用，用于导入订阅、选择节点、设置系统代理和管理内核。它可能在启动前合并订阅、覆写设置与扩展配置，因此编辑订阅源文件不一定会改变最终生效内容。排查时应同时检查客户端开关和运行配置；选择应用可参考客户端横向评测。
- subscription / profile订阅
- 订阅通常指获取节点或整份配置的远程入口，更新操作会重新请求该资源。返回内容可能是完整 YAML，也可能只是节点列表，需要客户端或转换流程识别，并非所有链接都能直接互换。链接往往带有个人访问凭据，不宜出现在截图、公开日志或在线求助内容中；具体导入过程见订阅导入。
- proxies / server节点
- 节点是一组连接代理服务器所需的参数，通常包括服务器地址、端口、协议和认证信息。节点名称中的地区只是提供者标注，不能直接证明入口服务器或实际出口的位置。单个节点失败时，先换用同一配置中的其他节点对照，再判断是该服务器不可达、凭据失效，还是本地接管设置出了问题。
- config.yaml / indentationYAML 配置格式
- YAML 是表示配置层级的文本格式，依靠缩进区分父子字段，列表项通常以短横线开头。缩进应使用空格而非制表符，同层字段要对齐；字段看起来还在文件中，也可能因层级改变而未按预期生效。修改前保留原配置，每次只调整一处，先通过客户端配置检查，再观察运行行为。
代理协议
本地应用连接代理入口的协议，与内核连接远端节点的协议不是一回事。填写前先确认参数属于哪一段连接。
- HTTP / CONNECTHTTP 代理
- HTTP 代理是应用向代理入口提交请求的一种方式，访问 HTTPS 网站时通常通过 CONNECT 方法建立隧道。目标网站使用 HTTPS，不代表本地代理入口也启用了 TLS。给浏览器或命令行填写地址时，要使用客户端实际监听的端口；
mixed-port可在同一入口接受 HTTP 与 SOCKS 连接。
- SOCKS5 / UDP ASSOCIATESOCKS5
- SOCKS5 是应用可显式指定的代理协议，既支持 TCP 连接，也定义了 UDP 转发机制，但实际能否转发 UDP 取决于应用与整个链路。部分工具会区分本地解析域名和交由代理端解析，选择不同会改变 DNS 路径。应用内已设置 SOCKS5 时，应把这项设置也列入排查，不能只检查系统代理。
- ss / cipherShadowsocks
- Shadowsocks 是内核与远端代理服务器之间使用的加密代理协议，配置中常以
type: ss标识。地址、端口、加密方法和密码需要与服务器匹配，部分节点还附带额外插件参数。导入成功只说明配置被识别，不代表认证和网络连接一定成功；旧内核也可能不支持较新的加密方法。
- trojan / TLS / SNITrojan
- Trojan 通常在 TLS 连接上承载代理流量，除密码外还需要关注服务器名与证书验证。连接地址与证书对应域名不一致时，应核对订阅提供的 SNI 等参数，而不是直接关闭验证。系统时间偏差、证书过期或服务器名填写错误，都可能表现为握手失败，与节点是否能被普通网络探测到并不是同一个问题。
- hysteria2 / QUICHysteria 2
- Hysteria 2 是基于 QUIC 的代理协议，需要所在网络允许相应的 UDP 通信。它在部分丢包链路上有适用场景，但不能据协议名称推断速度一定更快。若同一网络里 TCP 类节点正常而这类节点持续超时，应检查 UDP 限制、服务器端口与防火墙；带宽参数也要结合服务端要求填写。
运行模式
接管方式决定请求能否进入内核，运行模式决定进入之后如何处理。先分清这两个层次，再选择需要调整的开关。
- mode: rule规则模式
- 规则模式会依据配置中的匹配条件，为已进入内核的连接选择直连、代理或拒绝策略。日常使用通常从这个模式开始，随后在连接列表检查目标域名命中了哪条规则。规则模式不负责让所有应用自动进入内核；若连接列表根本没有目标请求，应先检查接管方式，模式区别见模式选择。
- mode: global / GLOBAL全局模式
- 全局模式把已进入内核的连接交给全局策略处理，适合短时间对照规则是否导致访问差异。名称中的“全局”不等于接管整台设备：忽略系统代理的应用仍可能绕过内核。测试后切回规则模式，并检查全局策略当前选择的节点，避免把全局组和日常策略组选成不同节点造成误判。
- system proxy / mixed-port系统代理
- 系统代理是在操作系统中登记一个代理地址与端口，遵循该设置的应用会把请求发给本地客户端。某些游戏、命令行工具或自带网络栈的应用不读取此设置，因此开关亮起不代表所有流量都已接管。退出客户端后若网页仍无法访问，应检查系统是否残留了指向已关闭端口的代理设置。
- tun / auto-routeTUN 模式
- TUN 通过虚拟网络接口接收 IP 数据包，并配合路由设置把流量交给内核，可覆盖一部分不遵循系统代理的应用。桌面系统常需要管理员权限、服务或驱动，手机端通常涉及 VPN 权限。开启失败时先检查权限与其他 VPN 是否冲突；TUN 只是接管入口，并不自动保证 DNS 路径和分流规则正确。
- url-test / timeout延迟测试
- 客户端延迟测试通常测量经节点访问指定地址的耗时，是否计入握手等环节取决于实现。它不是下载带宽测试，不同测试地址、超时阈值和网络状态下的数值也不宜直接比较。超时不一定表示所有网站都不可访问，应结合实际访问和日志判断；详细步骤见节点延迟问题。
DNS 与解析
解析请求和业务连接可能走不同路径。查看配置时，同时确认谁在解析、向哪里查询，以及查询连接由谁接管。
- dns / nameserverDNS 域名解析
- DNS 用于把域名解析为 IP 地址等记录，让应用找到要连接的目标。系统、浏览器、应用与代理内核可能各自缓存结果或发起查询，所以修改内核 DNS 后，旧连接不一定立即变化。出现域名失败而直接访问地址正常的情况时，应检查解析日志和缓存，但直接访问 IP 也可能因证书或虚拟主机配置而失败。
- enhanced-mode: fake-ipFake-IP 虚拟地址
- Fake-IP 会向应用返回一个虚拟地址，并在内核中保存地址与域名的映射，让后续连接仍能关联到域名规则。看到虚拟地址不代表解析到了真实服务器，也不代表配置异常。某些局域网服务或应用不兼容这种行为时，可针对相关域名检查
fake-ip-filter，不必直接停用整个 DNS 模块。
- DNS leak / resolver pathDNS 泄漏
- DNS 泄漏是解析请求绕过预期路径，到达了其他解析服务的情况；判断重点是它是否符合预设策略。检测页显示的解析器地区只能提供线索，不能单独证明某个查询由运营商获知。应结合浏览器加密 DNS、系统设置、TUN 接管与连接日志交叉确认；直连域名有意使用本地解析，也不应一概当作异常。
- DoH / DoT加密 DNS
- DoH 通过 HTTPS 传输 DNS 查询，DoT 则使用 TLS；它们保护查询传输过程，但不会让查询自动经过代理节点。解析服务仍能处理收到的域名请求，连接路径也需要单独确认。配置以域名表示的上游 DNS 时，还要考虑首次如何解析该上游地址，避免解析依赖绕成循环。
- nameserver-policy按域名选择解析器
nameserver-policy用于给不同域名或受支持的匹配条件指定上游 DNS，例如让内部域名交给组织内解析服务。它改变的是解析器选择，不是业务连接的最终出口，因此还需配合规则分流检查连接路径。字段写在dns层级内，复杂匹配语法应核对当前内核支持情况，不宜照搬其他版本示例。
规则与分流
规则负责匹配，策略组负责选择，提供器负责加载资源。配置中名称相近的字段，承担的职责往往不同。
- rules / DIRECT / REJECT / MATCH规则分流
- 规则分流按域名、IP 地址等条件把连接交给对应策略，常规
rules列表自上而下检查，首条命中即决定去向。DIRECT表示直连，REJECT表示拒绝，末尾的MATCH常用于接住其他未命中流量。添加例外规则时要放在会提前命中的宽泛规则之前，并用连接记录核实结果。
- proxy-groups / select / url-test策略组
- 策略组把节点或其他策略组织成可供规则引用的目标，常见类型有手动选择、延迟选择和故障转移。切换一个组，不代表所有连接都会使用新节点：规则可能指向别的组，已经建立的连接也可能继续沿用旧路径。测试时先查命中的组，再检查该组当前实际选中的成员，必要时重新建立目标连接。
- GEOIP / geodataGeoIP 地址归属
- GeoIP 使用地址数据库判断目标 IP 的地区等归属，常用于按地址范围分流。数据库存在更新周期和误差，结果不能等同于设备所在地或服务所属公司的地区。命中结果不符预期时，应核对实际目标 IP、数据库来源与更新情况；配置中是否使用
no-resolve也会影响域名连接的匹配过程。
- rule-providers / RULE-SET规则集提供器
rule-providers用于加载本地或远程规则集合，把较大的域名、地址列表从主配置中拆开管理。只声明提供器不会自动参与分流，还需在规则列表中通过RULE-SET等方式引用，并指定去向。更新失败时检查资源地址、内容格式与行为类型是否匹配，避免把下载成功误认为规则已经生效。
- proxy-providers / use节点提供器
proxy-providers用于独立加载和更新节点集合，通常由策略组通过use引用。它不是整份客户端配置订阅，不能直接替代模式、DNS 或规则设置，返回资源也要符合内核要求。提供器更新后组内仍为空时，检查引用名称、过滤条件和加载日志；常见处理见订阅更新失败。