Clash 名词解释
按设置所在的层次查词:先区分客户端与内核,再理解配置、规则、流量接管和 DNS。每个术语都可通过标题旁的锚点单独分享。
配置从哪里来
流量如何进入
连接从哪里出去
CORE / PROTOCOL
内核与协议
客户端界面、内核能力与远程服务器各有边界。遇到“不支持协议”时,先确认实际运行的内核。
- mihomo
- core · mihomomihomo 是 Clash Meta 后续使用的内核名称,负责代理协议、规则匹配、DNS 与连接处理。Clash Verge Rev 等图形客户端可以围绕内核提供操作界面,但二者不是同一个项目。查阅配置字段时,应对照当前内核版本,而不是只看客户端名称。
- 客户端与内核
- GUI / core客户端负责订阅管理、托盘菜单、系统代理和设置展示,内核负责执行网络处理。客户端界面上的开关,可能会生成配置,也可能调用系统服务。排查问题时分别记录客户端名称与内核信息,可以避免把界面行为误认为内核限制。
- 节点
- proxies节点是一份代理服务器的连接定义,通常包含服务器地址、端口、协议与认证参数。节点名称只是标签,不能单凭名称确认出口位置、带宽或可用服务。节点是否能用,需要结合连接日志、目标网站访问和服务端状态判断。
- 代理协议
- type · Shadowsocks / VMess / Trojan代理协议规定客户端与代理服务端如何交换数据,节点的
type用于指定协议类型。协议、传输方式与 TLS 属于不同层次,填写其中一项并不能替代其他参数。导入失败时,要同时检查内核支持范围和服务端提供的完整配置。
PROFILE / STRUCTURE
配置文件结构
先确认当前启用的 Profile,再检查订阅更新与本地修改的合并关系。
- Profile 配置文件
- config.yaml · ProfileProfile 是供内核加载的一份完整配置,常见内容包括代理定义、策略组、分流规则和 DNS 设置。客户端可以保存多份 Profile,但实际运行通常以当前选中的配置及其覆写结果为准。切换配置后,应检查策略组和规则是否同步变化,而不只看列表中的选中标记。
- YAML
- mapping · sequence · indentationYAML 是 Clash 配置常用的数据表达格式,使用缩进表示层级,用短横线表示列表项。缩进应使用空格,同层字段保持对齐,包含特殊字符的字符串可使用引号。保存前应检查重复键、布尔值和列表位置;语法能解析并不代表字段含义一定正确。
- 订阅
- remote profile · update interval订阅通过远程地址获取并更新节点或配置,返回内容可能是完整 Profile,也可能只是节点集合。更新间隔决定何时重新拉取内容,不代表节点会持续保持在线。订阅链接可能包含账户访问参数,分享日志或截图前应先移除相关地址。
- 代理提供者
- proxy-providers · use
proxy-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 / mixed
stack指定 TUN 数据包使用的网络栈实现,常见选项包括 system、gvisor 和 mixed。可用选项、兼容表现及具体行为会随平台和内核版本变化,不存在适用于所有设备的固定最优值。调整时保持其他设置不变,并重新验证发生问题的应用连接。
- 混合代理端口
- mixed-port: 7890
mixed-port在同一个监听端口接收 HTTP 与 SOCKS 代理连接,7890 只是常见配置值。应用手动填写代理时,地址和端口必须与当前运行配置一致。允许局域网连接还涉及监听地址与防火墙规则,不应把本机可访问直接等同于其他设备可访问。
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-mode
fake-ip-filter配合过滤模式控制域名是否采用真实解析结果,常用于处理局域网服务或依赖真实地址的应用。名单的含义需要结合当前过滤模式判断,不能只看域名是否出现在列表里。遇到兼容问题时先定位具体域名,再做小范围调整并重新测试。
- DNS 泄漏
- resolver path · encrypted DNSDNS 泄漏指域名查询走了不符合预期的解析路径,例如原本应经代理处理的查询仍发给本地解析器。检测页面显示的解析器名称只是线索,应结合浏览器加密 DNS、系统设置和客户端日志判断。若某类域名本就设计为本地直连解析,其出现不应被自动视为配置错误。
- 域名嗅探
- sniffer · HTTP Host · TLS SNI域名嗅探尝试从受支持协议的连接元数据中补充域名,例如 HTTP Host 或可见的 TLS SNI。获得域名后可以辅助规则匹配,但并非解密整个连接,也不能保证对所有加密流量生效。是否覆盖原目标、处理哪些端口,应按实际需求配置,避免扩大影响范围。