Clash 术语表：订阅、规则分流、DNS 与 TUN 模式

内核与客户端

界面、后台进程和控制接口各有职责。排查时先确认正在运行哪个内核，再确认修改保存到了哪里。

mihomo 内核

Proxy core · mihomo

负责代理连接、规则匹配、DNS 解析和 TUN 流量处理的程序核心，源自 Clash Meta 项目。图形客户端可以调用 mihomo，但界面名称与内核名称不一定相同。遇到字段不支持或配置加载失败时，要核对实际内核及其版本，而不只是客户端版本。

内核与客户端

图形客户端

Graphical client · GUI

为内核提供订阅管理、策略选择、日志查看和系统设置界面的应用，例如 Clash Verge Rev。不同客户端对覆写、服务模式和配置保存的处理可能不同。同一份订阅换到另一客户端后，应重新检查系统代理、TUN 与本地修改，不能只看导入成功提示。

内核与客户端

外部控制接口

external-controller

供控制面板或管理程序读取连接、切换策略、重新加载配置的接口，由 external-controller 指定监听地址。它不是浏览器使用的代理端口，也不应代替 mixed-port 填入代理设置。启用时应配合 secret 访问密钥，并限制监听范围，避免把管理权限开放给不可信网络。

内核与客户端

控制面板

Dashboard · external-ui

连接外部控制接口的管理界面，通常用于查看规则、活动连接和策略组。external-ui 可用于指定面板静态文件目录，但面板本身不承担代理转发。关闭浏览器里的面板页面不一定会停止内核；面板打不开，也不必然说明代理连接已经中断。

内核与客户端

代理协议

节点是连接参数，协议是通信约定。先确认参数与服务端一致，再解释测试结果。

节点

Proxy endpoint · proxies

一组可用于建立代理连接的服务器参数，通常包含服务器地址、端口、协议和认证信息。在配置文件中，节点可直接写入 proxies，也可由代理集合提供。节点不等于完整配置，显示名称也不能证明实际出口位置；排查连接时需要结合日志和目标网站的访问结果。

代理协议

Proxy protocol · type

客户端与代理服务器之间交换数据所遵循的通信约定，节点中的 type 字段用于声明类型。协议、底层传输方式和 TLS 设置属于不同层次，不能只根据其中一个字段补齐其他参数。内核支持某种协议，也不代表当前订阅提供了该协议所需的完整信息。

代理协议

Shadowsocks

Shadowsocks · type: ss

一种加密代理协议，在 mihomo 节点配置中使用 type: ss。服务器地址、端口、加密方法 cipher 和密码需要与服务端一致，不能凭节点名称推断。若服务端要求额外插件或特定参数，还需确认内核兼容性；配置能通过语法解析，不代表远端服务一定可达。

代理协议

延迟测试

Latency test · URL test

通过指定测试地址检查连接并测量请求往返耗时的方式，结果受测试地址、连接复用和网络环境影响。测试成功只说明这次请求完成，不能证明所有网站或协议都可用。延迟也不等于下载速度；出现超时时，应先区分节点不可达、DNS 失败与测试地址自身无法访问。

代理协议

规则与分流

规则决定匹配范围，策略决定如何处理。日志中的命中规则与最终策略，应放在一起看。

规则分流

Rule-based routing · rules

按域名、IP 或其他条件，为连接选择处理策略的方式，规则模式通过 mode: rule 启用。规则一般从上向下匹配，命中后交给指定策略处理，末尾常用 MATCH 承接剩余连接。若规则引用名为 PROXY 的策略，该名称必须已在配置中定义，不能只复制规则行就运行。

规则与分流

策略组

Policy group · proxy-groups

在 proxy-groups 中定义的代理选择集合，供规则引用。select 用于手动选择，url-test 依据测试结果选择，fallback 按可用性和顺序切换，三者目的不同。组名、节点名及规则中的引用必须一致；自动测试选出的节点，也不一定最适合当前业务网站。

规则与分流

规则集

Rule provider · rule-providers

把大量匹配条件放到独立文件中，再由 rule-providers 管理的数据集合。主规则通过 RULE-SET 引用集合，并在该规则中指定处理策略。集合的 behavior 与文件内容格式需要对应；更新成功只说明文件取得成功，还应检查引用位置和前面是否已有规则提前命中。

规则与分流

GeoIP

IP geolocation · GEOIP

根据 IP 地址归属地区进行匹配的数据与机制，例如 GEOIP,CN,DIRECT 表示匹配对应地址后直连。使用 MMDB 数据模式时，常见数据库文件是 Country.mmdb；数据库缺失或更新失败可能影响规则工作。IP 归属信息不一定反映服务器的实际位置，也不能替代具体域名规则。

规则与分流

DNS 与网络栈

域名怎样解析、连接怎样保留域名信息，是两个相关但不同的问题。修改前先确认实际查询路径。

DNS

Domain Name System · dns

将域名解析为 IP 地址等记录的系统，mihomo 中由 dns 配置控制相关行为。操作系统、浏览器和内核可能各有解析设置，应用启用加密 DNS 后也可能走独立路径。遇到网页打不开时，应区分解析失败与连接失败，不能只替换 nameserver 就认定问题解决。

DNS 与网络栈

Fake-IP

Synthetic address · enhanced-mode

先为域名返回合成 IP，再在连接进入内核后恢复域名关联的 DNS 工作模式，通过 enhanced-mode: fake-ip 启用。它有助于保留域名匹配信息，合成地址并不是网站真实服务器地址。部分局域网服务或特殊应用需要加入 fake-ip-filter，调整后还要留意应用和系统的旧 DNS 缓存。

DNS 与网络栈

DNS 泄漏

DNS leak

DNS 查询没有遵循预期解析路径，而到达其他解析器的现象，例如预期经代理查询却仍发送给本地网络解析器。判断时要同时看系统 DNS、浏览器加密 DNS、TUN 接管和内核上游请求路径。测试页面显示某个地区的解析器，并不足以独立证明泄漏，需先明确期望路径再对照实际请求。

DNS 与网络栈

域名嗅探

Domain sniffing · sniffer

从可识别的连接握手信息中补充域名线索的功能，由 sniffer 配置控制，可辅助处理只携带目标 IP 的连接。它不等于解密 HTTPS 正文，也不能保证恢复所有域名，部分握手信息可能不可见。若出现误识别或特定应用异常，应检查嗅探范围及排除项，而不是把所有连接都强制覆盖。

DNS 与网络栈

订阅与配置文件

完整配置、节点来源和本地修改应分开理解。订阅更新后丢失的设置，往往需要放到覆写层保存。

由远程链接提供并可更新的配置或节点数据，常见内容包括 Clash YAML 配置、编码节点列表和协议链接集合。链接能够打开，不代表格式适合当前导入入口；返回 HTML 登录页也不是有效配置。订阅地址中的认证参数应按密码对待，不要公开粘贴到截图、工单或不可信转换服务。

订阅与配置文件

YAML

YAML configuration

mihomo 配置常用的结构化文本格式，用缩进表示层级，用短横线表示列表项。缩进应使用空格，不要混入制表符，包含特殊字符的字符串可按 YAML 语法加引号。报错 yaml: unmarshal errors 可能涉及字段类型或结构不符；文件能解析，也不代表节点、策略组和规则引用都正确。

订阅与配置文件

代理集合

Proxy provider · proxy-providers

在 proxy-providers 中定义的节点来源，可来自远程文件或本地文件，通常通过策略组的 use 字段引用。它负责提供节点，不等于包含 DNS、规则和监听端口的完整配置。把代理集合链接直接当完整订阅导入时，可能缺少运行所需结构，应先核对文件内容与客户端支持的导入方式。

订阅与配置文件

本地覆写

Local override · Merge

在订阅原文之外保存修改，并由客户端在生成运行配置时应用的机制，适合保留自定义规则、DNS 或监听设置。直接修改下载后的订阅文件，内容可能在下次更新时被替换。不同客户端对数组替换、规则追加及脚本执行顺序的处理不同，保存后应检查最终生效配置，不能只看编辑器中的片段。

订阅与配置文件

系统与平台

代理监听、系统设置与路由接管不是同一个开关。启用后用实际应用验证，关闭后检查系统是否恢复。

系统代理

System proxy

由操作系统向支持该设置的应用提供代理入口，通常指向客户端的本机监听地址和端口。部分程序使用自己的代理设置或直接连接，因此打开系统代理不等于整台设备的流量都已进入内核。退出客户端后若浏览器仍提示代理连接失败，应检查系统代理是否残留，以及对应监听进程是否仍在运行。

系统与平台

TUN 模式

Virtual network device · tun

借助虚拟网络设备和路由设置，将符合接管条件的 IP 流量交给内核处理，常用于不遵循系统代理的应用。启用通常需要管理员权限、系统服务或平台授权，但开关显示开启不代表所有路由已正确建立。遇到断网时应检查 DNS 接管、路由排除项和其他 VPN 冲突，再决定是否调整网络栈。

系统与平台

局域网共享

LAN access · allow-lan

允许其他设备通过当前设备的代理监听端口建立连接，常涉及 allow-lan、监听地址和系统防火墙。其他设备应填写当前设备的局域网地址，而不是填写代表自身的 127.0.0.1。共享代理入口不会自动改写整张网络的默认网关；使用时还应限制访问范围，并避免把代理端口开放到公共网络。

系统与平台

服务模式与开机自启

Service mode · Launch at startup

服务模式通常用于以系统服务等方式运行后台内核，开机自启则用于在系统启动或用户登录时运行程序，两者并不等价。关闭窗口可能只是最小化到托盘，也可能让内核继续运行，具体行为由客户端决定。设置后应分别确认界面是否启动、内核是否运行，以及系统代理或 TUN 是否按预期恢复。

系统与平台