配置名词 / 字段对应 / 使用边界

Clash 术语表

按配置主题查找名词。每个条目说明概念、对应字段与常见误区；字段解释以 mihomo 为参考，客户端界面中的名称可能不同。

内核与客户端

先区分处理连接的内核与管理配置的界面，再判断问题发生在哪一层。

Clash

Clash ecosystem

Clash 原指基于规则工作的代理内核，也常被用于概括兼容其配置方式的客户端生态。看到“支持 Clash 配置”时，不能据此认定所有客户端都支持相同字段或协议。排查配置错误前，应先确认实际运行的内核名称，而不是只记录安装包或窗口标题。

mihomo

Core / 原 Clash.Meta

mihomo 是由 Clash.Meta 延续发展的开源代理内核，负责连接处理、DNS 解析、协议通信与规则执行。它可以独立运行，也可以由图形客户端启动和管理。配置文档中的 tun、sniffer 等字段能否使用，需要结合内核版本及所在平台判断。

图形客户端

GUI client

图形客户端为内核提供订阅导入、策略选择、日志查看及系统集成等操作入口。界面中修改的设置可能经过客户端合并后才传给内核，因此编辑的文件不一定就是最终生效文件。客户端版本与内核版本是两组信息；提交问题时同时记录两者，比只提供界面截图更有助于定位。

系统代理

System proxy

系统代理将操作系统的代理设置指向客户端的本地监听地址，例如回环地址上的 HTTP 或混合端口。只有遵循这项设置的应用才会通过它发送连接，部分命令行工具和游戏会使用独立网络设置。开启系统代理不等于接管全部流量，也不等于自动修改所有 DNS 查询路径。

延迟测试

URL test / Delay

客户端通常通过某个节点访问指定测试地址，再根据实现记录请求耗时；它不一定等同于 ICMP ping。测试地址、连接复用、超时设置与当时网络状况都会影响结果。较低的测试值只说明这次测试路径耗时较短，不能直接推导下载带宽、视频吞吐或其他网站的可达性。

代理协议

协议决定客户端与代理服务端如何通信。节点参数必须与服务端对应，名称相同不代表配置可以直接互换。

代理节点

Proxy / proxies

代理节点是一组连接代理服务端所需的参数，通常包含 type、server、port 及认证字段。节点可以直接定义在 proxies 中，也可以由节点提供器加载。显示名称只是本地引用标识，不能单凭名称中的地区或倍率文字判断真实路由、性能与服务能力。

HTTP 代理

type: http / CONNECT

HTTP 代理使用 HTTP 代理语义转发请求，访问 HTTPS 目标时通常通过 CONNECT 建立隧道。配置里的 HTTP 代理节点是一个远程出口，与客户端本地开放的 HTTP 监听端口不是同一个概念。目标使用 HTTPS，也不自动意味着客户端到代理服务器这一段采用 TLS，需要检查节点的传输设置。

SOCKS5

type: socks5

SOCKS5 是一种代理协议，提供 TCP 连接和 UDP 转发机制，也可使用用户名与密码认证。协议本身不提供传输加密，不能把“需要密码”理解为链路已经加密。UDP 是否实际可用，还要看应用是否使用对应机制、服务端是否支持，以及节点配置是否启用相关能力。

Shadowsocks

type: ss

Shadowsocks 是一种加密代理协议，在 mihomo 节点配置中使用 type: ss。服务端地址、端口、加密方法与密码必须匹配，不能用修改节点名称的方式转换协议。涉及插件或 UDP 转发时，还需要确认内核支持相应功能，并与服务端使用的参数保持一致。

Trojan

type: trojan / TLS / SNI

Trojan 是使用 TLS 保护传输的代理协议，节点配置入口为 type: trojan。连接是否成功不仅取决于密码，还与目标地址、SNI、证书链和传输方式有关。遇到证书错误时，应先核对域名、设备时间与证书状态，不应把跳过证书验证当作常规修复步骤。

规则与策略组

规则负责判断连接属于哪一类；策略组负责决定这一类连接最终使用哪个出口。

规则分流

mode: rule / rules

规则分流按照域名、IP、进程等条件，为连接选择直连、拒绝或代理出口。在规则模式下，rules 通常自上而下匹配，先命中的规则决定处理目标；更具体的例外应放在宽泛规则之前。规则中引用的策略组名称必须真实存在，切换到全局模式后也不能继续假定连接仍按这套顺序分流。

策略组

proxy-groups / select / url-test / fallback

策略组把多个节点或其他策略组组织成稳定的出口名称，供规则引用。select 通常用于手动选择，url-test 依据测试结果选择，fallback 则侧重按顺序寻找可用出口。具体选择结果受测试地址与参数影响；组内节点看起来可用，不代表每个业务目标都能访问。

GeoIP

GEOIP / GeoIP.mmdb / geoip.dat

GeoIP 根据数据库记录的 IP 归属分类执行匹配，例如 GEOIP,CN,DIRECT。它不是实时地理定位，也不直接表示网站的语言或运营主体，CDN 地址变化同样会影响结果。实际使用的数据文件取决于内核的数据模式；添加 no-resolve 时，还要理解它对域名触发解析的限制。

GeoSite

GEOSITE / geosite.dat

GeoSite 是按服务或用途整理的域名集合，可通过 GEOSITE 规则引用。分类名和收录范围由数据源维护，不同来源不一定包含相同类别，也不保证及时覆盖新增域名。它匹配的是域名集合，与按 IP 归属匹配的 GeoIP 不能互相替代；更新后应检查数据加载日志。

MATCH

MATCH,DIRECT

MATCH 是不附加匹配条件的兜底规则，通常放在 rules 末尾，接收前面未命中的连接。目标可以是代理策略组，也可以是 DIRECT 等内置策略，并非固定要求走代理。如果把它放在列表前部，后面的普通规则将失去匹配机会，因此检查顺序通常比继续增加规则更重要。

DNS 与网络栈

解析路径和连接路径是两件事。判断接管是否完整，需要同时检查应用、操作系统与内核配置。

DNS

Domain Name System / dns

DNS 将域名解析为 IP 地址等记录，mihomo 的 dns 段用于配置内置解析服务及其上游。填写 nameserver 不意味着所有应用会自动使用它，系统解析器和浏览器自带的加密 DNS 仍可能走其他路径。排错时应分别确认由谁发起查询、查询送往哪里，以及解析结果对应的连接如何路由。

TUN 模式

tun / Virtual network interface

TUN 模式通过虚拟网络接口接收由系统路由送入的 IP 数据包，可覆盖部分不遵循系统代理的程序。它通常涉及额外权限、网络栈与路由设置，实际接管范围还受排除规则、IPv6 和其他 VPN 影响。开启 tun.enable 只是配置入口，仍需结合路由表、连接日志和 DNS 接管结果验证。

Fake-IP

enhanced-mode: fake-ip / fake-ip-filter

Fake-IP 为域名查询返回合成地址，内核保存地址与域名的映射，连接进入内核后再利用该映射执行分流。合成地址不是目标服务器的真实地址，直接拿它做地理归属判断没有意义。对依赖真实解析结果的服务，可以按兼容性需求配置 fake-ip-filter，修改后还应注意旧 DNS 缓存的影响。

DNS 泄漏

DNS leak / Resolver path

DNS 泄漏指域名查询偏离预期解析路径，被发送到非预期解析器的情况。检查时要同时考虑系统 DNS、应用自带 DoH、IPv6 以及网络切换后的回落行为，不能只看网页出口 IP。测试页显示的解析器名称只能提供线索，应结合实际预期、内核日志与重复测试确认，TUN 模式本身也不是结论。

域名嗅探

sniffer / Host / SNI

域名嗅探从连接中可观察的协议元数据提取域名，例如 HTTP Host 或部分 TLS 握手中的 SNI，用于补充只有 IP 的连接信息。它不能解密任意 HTTPS 内容，也不能保证每条连接都得到域名。启用 sniffer 后，应按协议和目标验证行为，不能把它当作 DNS 配置或准确规则数据的替代品。

订阅与配置文件

区分完整配置、节点集合和规则集合，才能确定应该从哪个入口导入，以及更新会覆盖哪些内容。

订阅

Subscription URL / Profile

订阅是通过 URL 获取并更新节点或配置的分发方式，不是一种代理协议。链接返回的内容可能是完整 YAML、编码后的节点列表或其他格式，应使用客户端对应的导入入口。订阅地址可能携带账户授权参数，应视作敏感信息；公开日志或截图时需要隐藏完整链接，更新失败也不等于所有已缓存节点立即失效。

YAML

config.yaml / Mapping / Sequence

YAML 是 mihomo 配置采用的数据序列化格式，映射表示字段关系，列表表示一组项目，缩进决定层级。缩进应使用空格，带特殊字符的值需要根据语法正确引用，不能把 Tab 与空格混用。文件能被 YAML 解析器读取，只说明格式成立，还需要检查字段类型、策略名称引用和内核对字段的支持。

节点提供器

proxy-providers / use

节点提供器通过 proxy-providers 定义，从远程或本地来源加载节点集合，再由策略组的 use 字段引用。它把节点更新与规则、策略组结构分离，适合保留本地分流逻辑的配置。提供器来源不一定接受任意完整配置文件；排错时应检查返回内容、缓存路径、更新状态以及引用名称是否一致。

规则提供器

rule-providers / RULE-SET / behavior

规则提供器通过 rule-providers 加载可更新的规则集合，再由 RULE-SET 规则接入主规则列表。behavior 区分域名、IP 段或经典规则等内容类型，format 则描述文件格式，两者都必须与来源对应。仅定义提供器不会自动参与分流，还要检查引用位置及它在 rules 中的顺序。

覆写与合并

Override / Merge / Effective configuration

覆写与合并是在订阅配置基础上保留或追加本地设置的处理过程，常用于调整端口、DNS 或补充规则。具体由客户端实现：有的字段会整体替换，有的会合并，列表也可能采用前插或后附方式。修改后应查看最终生效配置并重新加载；override.yaml 只是常见文件命名，并不是所有客户端都会自动读取的统一入口。