Clash 术语表

从客户端、协议到规则和 DNS,按配置中出现的位置查词。每条解释说明作用、适用边界与常见误区,配置键保留原文。

内核与客户端

界面负责管理设置,内核负责处理连接。端口、系统代理和控制接口分别承担不同任务。

mihomo

Clash Meta → mihomo

mihomo 是原名 Clash Meta 的代理内核,负责读取配置、建立连接、处理 DNS 并执行分流规则。支持哪些协议与配置字段,要以正在运行的内核版本为准,不能只看客户端名称。图形客户端通常将它作为后台组件,也可以在服务器上独立运行。

查看内核相关排查 →

客户端与内核

GUI / core

客户端是导入订阅、选择策略组、查看日志的操作界面;内核是实际接收和转发连接的程序。两者可能分别发布更新,因此更新客户端不一定意味着内核同时更新。遇到不支持的字段时,应记录客户端版本与内核版本,再判断是界面限制还是解析能力不足。

按平台查看客户端 →

系统代理

system proxy

系统代理把操作系统的代理设置指向本机监听地址,让遵循该设置的应用将请求交给内核。某些游戏、命令行程序和自行管理网络连接的应用不会读取这项设置,需要单独配置代理或使用 TUN。关闭客户端后若设置未恢复,应用可能继续访问已经停止监听的端口。

混合端口

mixed-port

混合端口在同一个监听端口接收 HTTP 代理和 SOCKS5 请求,便于应用使用统一入口。常见配置示例是 mixed-port: 7890,但实际端口应以当前设置为准。填写代理地址时还要确认监听地址与访问范围,端口被其他进程占用会导致启动或连接失败。

外部控制接口

external-controller

外部控制接口向面板提供连接状态查询、代理组切换等管理能力,不是应用转发业务流量的代理入口。把控制接口端口填入浏览器代理设置,不能代替混合端口。需要从其他设备访问时,应配置认证并限制可访问来源,避免将管理能力直接暴露到公网。

代理协议

协议定义客户端与代理服务器如何通信。名称相同还不够,认证、传输和证书参数也必须对应。

Shadowsocks

type: ss

Shadowsocks 是一种加密代理协议,节点配置通常包含服务器地址、端口、密码和加密方法。客户端与服务端的加密方法必须兼容,密码或端口错误都可能表现为超时。若节点还使用插件,插件参数也需要匹配;UDP 是否可用则取决于双方实现和网络条件。

VMess 与 VLESS

type: vmess / vless

VMess 与 VLESS 是两种不同的代理协议,不是同一节点的两个可互换标签。节点除了身份参数,还可能需要 WebSocket、gRPC、TLS 等传输与安全设置,必须与服务端逐项对应。仅将 type 改成另一种协议不能完成转换,旧内核也可能无法识别新增字段。

Trojan

type: trojan

Trojan 通常使用 TLS 保护连接,并以密码完成认证。连接失败时除了检查服务器和密码,还应核对服务器名称、证书是否有效以及本机时间是否准确。它支持的具体传输方式取决于实现,不能根据协议名称推断所有附加参数都能被当前内核接受。

Hysteria2

type: hysteria2

Hysteria2 是基于 QUIC 的代理协议,底层需要网络允许 UDP 通信。节点可用性不仅取决于内核支持,还受认证、证书与网络 UDP 策略影响。换到另一种协议可以作为对照测试,但不能据此断言某种协议在所有网络上更快,持续吞吐还要通过实际业务验证。

TLS 与 SNI

tls / servername / sni

TLS 用于保护连接并验证对端身份,SNI 则在握手中告知服务器本次请求对应的名称。配置里的服务器地址与证书名称不一定相同,因此要按节点提供方的参数填写相关字段。出现证书错误时先核对名称、系统时间和证书状态,不宜把跳过证书验证作为长期解决方法。

规则与分流

规则回答“这条连接交给谁”,代理组回答“使用哪个成员”。列表顺序会直接改变结果。

规则分流

mode: rule / rules

规则模式按 rules 列表从上到下检查连接,命中后采用该行指定的策略。域名规则、IP 规则和规则集可以同时存在,但具体规则通常应放在宽泛规则之前。末尾的 MATCH,PROXY 用于承接未命中前面规则的流量,前提是配置中已定义名为 PROXY 的策略组。

DIRECT、PROXY 与 REJECT

routing target

DIRECT 是内置直连策略,REJECT 是内置拒绝策略;PROXY 通常只是配置作者给代理组起的名字,并非必然存在的内置组。规则末尾可以引用实际组名,例如 DOMAIN-SUFFIX,example.com,PROXY。直连表示不经代理节点转发,不代表绕过本机内核的全部处理过程。

代理组策略

proxy-groups

代理组将节点或其他策略组组织成可被规则引用的目标。select 用于手动选择,url-test 根据探测结果选择成员,fallback 按成员顺序寻找可用连接。自动策略判断的是指定探测目标下的表现,不保证所有网站都同样可用,也不能把探测结果当作下载速度排名。

GeoIP 与 GEOSITE

GEOIP / GEOSITE

GEOIP 根据 IP 数据库分类,GEOSITE 根据域名集合分类,两者的匹配对象不同。GEOIP,CN,DIRECT 需要可用的 IP 数据,分类结果也受数据库更新影响。IP 所属地区不能完整代表网站用途或访问需求,重要业务可配合明确的域名规则,而不是只依赖地区分类。

规则集

rule-providers / RULE-SET

规则集把一批规则拆成可独立维护的数据源,通过 rule-providers 声明,再由 RULE-SET 引入规则列表。数据格式需要与 behavior 对应,例如域名集合不能随意当作完整规则行解析。集合更新与主订阅更新是不同过程,引用位置仍参与整体规则顺序,更新失败时还要检查本地缓存与日志。

DNS 与网络栈

域名解析、连接接管和网络路由是不同层次。启用一个开关,不代表其余层次已经配置完成。

DNS

dns / nameserver

DNS 将域名解析为网络地址,内核可以按配置接收查询并选择上游解析器。系统 DNS、浏览器自带的加密 DNS 和内核 DNS 可能同时存在,修改其中一处不一定影响其他来源。排查时先确认查询实际由谁发起、交给谁处理,再检查上游可达性,避免把解析错误误认为节点故障。

Fake-IP

dns.enhanced-mode: fake-ip

Fake-IP 为域名分配映射地址,让内核在后续连接中保留域名关联,从而更容易执行域名分流。这个地址不是网站真实 IP,因此不能直接用它判断服务器所在位置。遇到局域网服务或依赖真实解析结果的应用,可以按需要设置 fake-ip-filter,并在改动后处理应用与系统中的旧解析缓存。

TUN 模式

tun.enable

TUN 通过虚拟网络接口把 IP 流量送入内核,适合处理不遵循系统代理设置的应用。具体覆盖范围取决于路由、排除项、权限和客户端实现,启用后并不是所有流量都必然走代理节点。连接仍由当前模式与规则决定出口;与其他 VPN 同时运行时,需要检查是否出现路由或 DNS 接管冲突。

DNS 泄漏

DNS egress

DNS 泄漏指查询经由不符合预期的出口或解析器发出,判断前必须先明确期望的解析路径。常见排查项包括系统 DNS、应用自带加密 DNS、IPv6 路由与内核 DNS 接管设置。测试页面显示某个解析器名称只是线索,不能单凭名称判断全部流量路径,宜结合日志、网络设置与重复测试确认。

查看 DNS 排查 →

IPv6

ipv6 / AAAA

IPv6 是与 IPv4 并存的网络协议,DNS 的 AAAA 记录可返回 IPv6 地址。系统拥有 IPv6 路由,并不代表代理节点或内核的相关配置已经支持同一路径。出现部分网站直连或超时时,应分别核对 DNS 返回、系统路由和代理处理能力,临时关闭 IPv6 可以用于对照,但不应代替对实际原因的定位。

订阅与配置文件

订阅是来源,节点是连接参数,配置文件决定整体行为。本地修改还要考虑更新覆盖和合并顺序。

订阅

subscription / profile

订阅是用于取得节点列表或完整配置的远程来源,不等同于客户端或代理内核。返回内容可能只含节点,也可能包含规则和代理组,因此导入成功后还要确认它是否满足当前客户端的格式要求。链接可能带有账户标识,分享日志与截图时应遮蔽;本地改动也可能被下一次订阅更新覆盖。

查看订阅导入步骤 →

节点

proxies

节点描述一条代理连接需要的服务器、协议、端口和认证参数,通常由订阅提供方维护。节点名称只是标签,不能仅凭地区文字或线路名称确认实际出口、协议能力和稳定性。选择时应结合目标服务是否可达、持续传输表现与账户计费规则,而不是只看列表中的名称。

延迟

latency / url-test

客户端显示的延迟通常是完成一次指定探测请求所耗的时间,包含哪些环节取决于实现与测试方式。较低数值不等于较高下载带宽,超时也可能只是探测目标无法访问。只有测试地址、网络环境和时间条件接近时才适合比较,最终还要用实际网站访问与持续传输验证节点质量。

YAML 与 config.yaml

configuration syntax

YAML 是常见配置格式,config.yaml 是常用文件名,不是另一种配置协议。层级通过空格缩进表达,列表项通常以连字符开头,制表符或错误缩进可能导致解析失败。语法正确也不代表字段受到当前内核支持,修改前应保存可用副本,并通过客户端日志确认加载结果。

配置覆写

override / merge / patch

配置覆写是在订阅基础上追加或修改本地设置的机制,可用于保存自定义规则、DNS 与端口。不同客户端对列表追加、字段替换和执行顺序的处理不一致,不能把一款客户端的覆写文件直接当作通用标准。修改后应查看最终生效配置,确认规则位置和组名引用,并保留原始订阅与覆写内容的备份。