配置字段 · 概念边界 · 查阅入口

Clash 名词解释

按设置所在的层次查词:先区分客户端与内核,再理解配置、规则、流量接管和 DNS。每个术语都可通过标题旁的锚点单独分享。

配置从哪里来 流量如何进入 连接从哪里出去
CORE / PROTOCOL

内核与协议

客户端界面、内核能力与远程服务器各有边界。遇到“不支持协议”时,先确认实际运行的内核。

mihomo
core · mihomomihomo 是 Clash Meta 后续使用的内核名称,负责代理协议、规则匹配、DNS 与连接处理。Clash Verge Rev 等图形客户端可以围绕内核提供操作界面,但二者不是同一个项目。查阅配置字段时,应对照当前内核版本,而不是只看客户端名称。
客户端与内核
GUI / core客户端负责订阅管理、托盘菜单、系统代理和设置展示,内核负责执行网络处理。客户端界面上的开关,可能会生成配置,也可能调用系统服务。排查问题时分别记录客户端名称与内核信息,可以避免把界面行为误认为内核限制。
节点
proxies节点是一份代理服务器的连接定义,通常包含服务器地址、端口、协议与认证参数。节点名称只是标签,不能单凭名称确认出口位置、带宽或可用服务。节点是否能用,需要结合连接日志、目标网站访问和服务端状态判断。
代理协议
type · Shadowsocks / VMess / Trojan代理协议规定客户端与代理服务端如何交换数据,节点的 type 用于指定协议类型。协议、传输方式与 TLS 属于不同层次,填写其中一项并不能替代其他参数。导入失败时,要同时检查内核支持范围和服务端提供的完整配置。
节点延迟
URL test · timeout客户端显示的延迟通常来自经节点访问测试地址所花的时间,不一定是单纯的 ICMP 往返时间。测试目标、连接握手和网络路径都会影响结果,低延迟也不等于高下载速度。超时只说明该次测试没有按时完成,判断方法见延迟测试教程。
PROFILE / STRUCTURE

配置文件结构

先确认当前启用的 Profile,再检查订阅更新与本地修改的合并关系。

Profile 配置文件
config.yaml · ProfileProfile 是供内核加载的一份完整配置,常见内容包括代理定义、策略组、分流规则和 DNS 设置。客户端可以保存多份 Profile,但实际运行通常以当前选中的配置及其覆写结果为准。切换配置后,应检查策略组和规则是否同步变化,而不只看列表中的选中标记。
YAML
mapping · sequence · indentationYAML 是 Clash 配置常用的数据表达格式,使用缩进表示层级,用短横线表示列表项。缩进应使用空格,同层字段保持对齐,包含特殊字符的字符串可使用引号。保存前应检查重复键、布尔值和列表位置;语法能解析并不代表字段含义一定正确。
订阅
remote profile · update interval订阅通过远程地址获取并更新节点或配置,返回内容可能是完整 Profile,也可能只是节点集合。更新间隔决定何时重新拉取内容,不代表节点会持续保持在线。订阅链接可能包含账户访问参数,分享日志或截图前应先移除相关地址。
代理提供者
proxy-providers · useproxy-providers 将节点来源独立定义,策略组通过 use 引用提供者名称。这样可以更新节点集合,同时保留本地策略组和规则结构。提供者文件与完整 Profile 的结构不同,把完整订阅直接填入提供者地址前,需要确认返回格式是否匹配。
本地覆写
override · merge · patch本地覆写是在远程配置之外保留修改的机制,常用于端口、DNS 和自定义规则。直接编辑订阅下载的文件,可能在下一次更新时被替换;覆写能否保留则取决于客户端实现。修改后应检查最终运行配置,尤其确认列表字段是追加、替换还是重新排序。
RULES / OUTBOUND

分流规则

规则判断目标,策略组决定出站。匹配条件与出站名称要分别检查。

规则分流
rules · MATCH规则模式按配置顺序检查连接,通常由第一条命中的规则决定出站。规则末尾填写的策略组名称必须存在,DIRECT 与 REJECT 则是内置出站。将 MATCH 放在最后可接住尚未命中的连接,放得过早会使后续规则失去作用。
策略组
proxy-groups · select / url-test / fallback策略组将多个出站组织成一个可被规则引用的名称。select 用于手动选择,url-test 根据测试结果自动选择,fallback 通常按顺序选取可用项。嵌套策略组时要避免循环引用,具体结构见策略组配置进阶。
DOMAIN-SUFFIX
DOMAIN-SUFFIX,github.com,PROXY此规则按域名后缀匹配,填写 github.com 可以覆盖该域名及其子域名,不需要再写通配符。它不同于仅匹配指定域名的 DOMAIN,也不同于按文本包含关系匹配的关键词规则。若连接只有 IP 且无法关联域名,域名规则可能不会命中。
GeoIP
GEOIP,CN,DIRECTGeoIP 依据目标 IP 在地理数据库中的分类进行匹配,不根据网页语言判断。数据库可能滞后,网站使用 CDN 时,不同解析结果也可能对应不同分类。它用于判断连接目标,不能直接证明代理节点的实际出口地区;排查时应同时查看目标 IP 和命中规则。
规则集
rule-providers · RULE-SET · behavior规则集把一批域名、网段或规则独立管理,通过 rule-providers 定义,再在 rules 中引用。behavior 决定集合按 domain、ipcidr 或 classical 等形式解析,必须与内容相符。更新规则集不会自动调整引用位置,优先级仍由主规则列表中的顺序决定。
CAPTURE / LISTENER

网络接管方式

“流量有没有进入内核”和“进入后走哪个出站”是两项检查,不能用同一个开关解释。

系统代理
system proxy · HTTP / SOCKS系统代理向操作系统登记代理地址和端口,供遵从此设置的应用使用。部分命令行程序、游戏或自带网络设置的应用不会自动跟随,因此开启后不代表所有流量都已接管。验证时先用浏览器建立新连接,再在客户端连接页确认记录,步骤见系统代理设置。
TUN 模式
tun · auto-route · dns-hijackTUN 通过虚拟网络设备与路由接管 IP 流量,可覆盖部分不遵从系统代理的应用。它通常需要相应系统权限,并与路由排除、DNS 接管等设置共同工作。开启后如果出现断网,应依次检查服务权限、路由与解析路径,不要仅通过反复更换节点判断原因。
TUN stack
stack: system / gvisor / mixedstack 指定 TUN 数据包使用的网络栈实现,常见选项包括 system、gvisor 和 mixed。可用选项、兼容表现及具体行为会随平台和内核版本变化,不存在适用于所有设备的固定最优值。调整时保持其他设置不变,并重新验证发生问题的应用连接。
混合代理端口
mixed-port: 7890mixed-port 在同一个监听端口接收 HTTP 与 SOCKS 代理连接,7890 只是常见配置值。应用手动填写代理时,地址和端口必须与当前运行配置一致。允许局域网连接还涉及监听地址与防火墙规则,不应把本机可访问直接等同于其他设备可访问。
出站模式
mode: rule / global / direct规则模式按规则列表选择出站,全局模式通常使用全局策略选择,直连模式让进入内核的流量直接连接。模式控制的是出站决策,不负责让应用流量进入内核。全局模式因此不等于全设备接管,边界对照见出站模式说明。
DNS / DOMAIN MAPPING

DNS 解析

先明确谁在查询域名、查询发往哪里,再调整 Fake-IP 与域名嗅探。

DNS 解析
dns · nameserverDNS 解析将域名转换为 IP 等记录,应用、操作系统、内核和代理服务端都可能参与。浏览器启用独立的加密 DNS 后,查询路径可能与系统设置不同。访问失败时,应区分解析失败、连接失败和规则选择错误,不能仅因网页打不开就认定节点不可用。
Fake-IP
enhanced-mode: fake-ipFake-IP 模式向应用返回映射地址,并在内核中保留该地址与域名的关联。应用随后连接映射地址时,内核利用关联信息恢复域名并执行分流;该地址不是网站的真实服务器地址。它需要后续流量正确进入内核,单独改变 DNS 返回值并不能完成流量接管。
Fake-IP 过滤
fake-ip-filter · fake-ip-filter-modefake-ip-filter 配合过滤模式控制域名是否采用真实解析结果,常用于处理局域网服务或依赖真实地址的应用。名单的含义需要结合当前过滤模式判断,不能只看域名是否出现在列表里。遇到兼容问题时先定位具体域名,再做小范围调整并重新测试。
DNS 泄漏
resolver path · encrypted DNSDNS 泄漏指域名查询走了不符合预期的解析路径,例如原本应经代理处理的查询仍发给本地解析器。检测页面显示的解析器名称只是线索,应结合浏览器加密 DNS、系统设置和客户端日志判断。若某类域名本就设计为本地直连解析,其出现不应被自动视为配置错误。
域名嗅探
sniffer · HTTP Host · TLS SNI域名嗅探尝试从受支持协议的连接元数据中补充域名,例如 HTTP Host 或可见的 TLS SNI。获得域名后可以辅助规则匹配,但并非解密整个连接,也不能保证对所有加密流量生效。是否覆盖原目标、处理哪些端口,应按实际需求配置,避免扩大影响范围。