Clash 术语手册

从界面名称查到内核概念。每条术语说明含义、使用位置与容易混淆的边界;卡片锚点可直接用于分享和查阅。

首次导入配置可先看上手教程;需要组合策略组、规则集与 DNS 设置时,转到高级用法。字段是否可用,以正在运行的内核及客户端支持情况为准。

内核与客户端

区分管理界面、流量处理引擎与系统入口,避免把界面开关当作连接已经生效的证据。

内核与客户端

客户端

Client

客户端是管理配置、代理选择、连接和日志的应用,通常还负责系统代理与服务权限。相似的界面不代表使用相同内核,也不代表支持同一套字段。迁移配置时,应同时检查客户端的配置处理方式与内核能力,而不是只比较菜单名称。

内核与客户端

内核

Core

内核是实际处理代理连接、DNS 与规则匹配的网络引擎,可以被图形客户端调用,也可以独立运行。客户端更新与内核更新可能分开进行,因此界面能保存某个选项,不代表当前内核能够执行。遇到未知字段或不支持的协议提示,应先确认内核名称与版本。

内核与客户端

mihomo

mihomo / Clash.Meta

mihomo 是源自 Clash 生态的代理内核,早期常以 Clash.Meta 名称出现在教程和客户端说明中。它不是某一个固定的图形客户端,同一内核可以搭配不同管理界面。参考旧教程时,需要对照当前字段文档,尤其留意 DNS、TUN 和嗅探选项的版本差异。

内核与客户端

系统代理

System proxy

系统代理把本地代理地址登记到操作系统,供遵循该设置的应用使用。它不会强制接管所有程序,独立设置代理的浏览器、命令行工具或游戏可能走另一条路径。排查时应核对本地监听端口、应用代理设置与连接日志;系统代理已开启不等于全部流量都已进入内核。

内核与客户端

外部控制器

External controller

外部控制器是面板或客户端访问内核状态的控制接口,配置字段常见为 external-controller。它可以用于查询连接、调整策略和读取运行状态,但不是浏览器应填写的代理端口。通常只监听本机;确需远程访问时,应设置认证并限制网络访问范围。

代理协议

节点描述连接目的地,协议描述连接方式;测试结果只反映特定目标与时刻的网络路径。

代理协议

代理节点

Proxy node

代理节点是一条出站连接配置,通常包含服务器地址、端口、协议、认证及传输参数。节点不是订阅:一个订阅可以提供多条节点,也可能附带完整规则。节点可以建立连接,只说明该出站基本可用;某个应用能否访问,还取决于规则是否把流量交给它。

代理协议

Shadowsocks

Shadowsocks / SS

Shadowsocks 使用约定的加密方法和凭据,在客户端与服务端之间传输代理流量。配置中常见 type: ss,加密方法、密码和服务端参数必须匹配。若节点需要额外插件或传输扩展,还应确认内核支持对应机制,不能只复制服务器地址和端口。

代理协议

Trojan

Trojan

Trojan 通常通过 TLS 连接承载代理流量,配置涉及服务器地址、密码与服务器名称等信息。认证成功和证书验证是不同环节,域名不匹配、系统时间异常也可能导致握手失败。遇到证书错误应检查名称、证书链与时间,不宜直接关闭验证作为长期处理方式。

代理协议

SOCKS5

SOCKS version 5

SOCKS5 是应用与代理协商目标连接的协议,可用于 TCP 连接和 UDP 转发,但它本身不提供传输加密。应用连接本地 SOCKS5 端口后,后续出站仍由内核规则决定。域名在本地还是代理侧解析取决于应用实现,配置应用时应分别确认代理地址与解析行为。

代理协议

延迟测试

Latency test / URL test

客户端的延迟测试通常通过代理请求指定地址,显示这一请求的耗时,不一定等同于 ICMP Ping。结果会受到测试站点、解析、握手与网络路径影响,较低数值不保证下载更快。测试超时也不必然说明节点完全失效,应结合实际目标访问和内核日志判断。

规则与分流

规则决定流量交给谁,策略组决定当前使用哪个出站。先确认匹配结果,再调整节点选择。

规则与分流

规则分流

Rule-based routing

规则分流在规则模式下检查域名、目标 IP 等连接特征,并把连接交给指定出站。规则通常从上到下匹配,先命中的条目决定结果,因此精确例外应放在宽泛规则之前。切换到全局模式后,不应继续按规则模式的预期解释流量去向。

规则与分流

策略组

Proxy group

策略组把多个代理或其他策略组组织成逻辑出站,规则可以直接引用它的名称。select 用于手动选择,url-test 按测试结果选择,fallback 通常按顺序选用可用成员。自动选择仍受测试地址与检测周期影响,不能保证每个目标都走最优路径。

规则与分流

规则集

Rule provider / Rule set

规则集把一批域名、IP 或规则条目存成独立资源,便于分类维护和定时更新。在 mihomo 中,通常通过 rule-providers 定义,再用 RULE-SET 引用。资源格式必须与声明的行为类型匹配;更新成功也不代表已经生效,还需检查引用名称、规则顺序与目标策略。

规则与分流

GeoIP

IP geolocation

GeoIP 根据 IP 地理归属数据库判断目标地址所属区域,常见写法为 GEOIP,CN,DIRECT。判定依据是 IP 记录,不能据此推断企业注册地或用户所在地。CDN 调度与数据库更新都可能改变结果;域名目标在匹配时还可能需要解析,使用 no-resolve 前应理解其限制。

规则与分流

MATCH

Catch-all rule

MATCH 是兜底规则,用于接住前面条目都没有命中的连接,例如 MATCH,代理。它通常放在列表最后;若提前出现,后续规则将失去匹配机会。日志中大量连接落到 MATCH 时,应检查域名信息、规则集加载和条目覆盖范围,而不是只更换节点。

DNS 与网络栈

流量接管、域名解析与代理出站是不同层次。开启 TUN 后,仍需分别检查路由和 DNS 路径。

DNS 与网络栈

DNS

Domain Name System

DNS 用于查询域名对应的地址等记录,内核中的 dns 段用于控制相关解析行为。解析请求经过哪里,与应用连接最终经过哪里,不一定相同。修改 nameserver 之前,应先确认应用是否真的使用内核 DNS;浏览器自己的加密 DNS 可能使用独立路径。

DNS 与网络栈

Fake-IP

Fake-IP

Fake-IP 向应用返回虚拟地址,并在内核中保存虚拟地址与域名的映射,便于后续使用域名规则。虚拟地址不是目标服务器的真实地址,因此在解析结果中看到它不等于解析故障。依赖真实地址的局域网服务或应用可能需要排除项,应按具体域名处理,避免把过宽范围加入过滤列表。

DNS 与网络栈

TUN 模式

TUN virtual network interface

TUN 通过虚拟网络接口接收被系统路由到内核的 IP 流量,能够覆盖部分不遵循系统代理的应用。是否实际接管取决于权限、路由、排除项与其他 VPN 的影响;TUN 不等于所有连接都必须走代理。进入内核的连接仍可按规则直连,DNS 接管也需要相应设置。

DNS 与网络栈

DNS 泄漏

DNS leak

DNS 泄漏指解析请求没有按预期经过指定路径,例如计划由内核处理,却由系统或应用直接发出。判断依据应是预期策略与实际请求,而不是检测网页是否显示某个熟悉的解析器名称。排查时同时检查 IPv4、IPv6、浏览器加密 DNS 和其他网络软件,避免只修改一处设置。

DNS 与网络栈

域名嗅探

Domain sniffing

域名嗅探从可识别的握手或应用层字段中提取域名,例如部分连接中的 HTTP Host 或 TLS 服务器名称。它可辅助补全域名信息,但不能解密任意应用内容,也不能保证识别全部连接。启用后若出现兼容性问题,应检查嗅探协议范围、跳过域名与目标覆盖设置。

配置与订阅

先分清完整配置、代理列表和规则资源,再决定导入入口。更新配置时也要核对本地修改是否保留。

配置与订阅

订阅

Subscription

订阅是通过链接拉取配置或代理列表的分发方式,链接返回的内容可能是完整 YAML,也可能是其他格式的节点列表。导入入口必须支持相应格式,网页能打开链接并不代表内核能够解析。订阅地址往往包含访问凭据,分享日志、截图或配置时应隐藏完整链接。

配置与订阅

YAML

YAML

YAML 是 Clash 配置常用的结构化文本格式,以缩进表达映射与列表层级,缩进应使用空格而不是制表符。语法能被解析,不代表字段名称、类型或引用一定正确。报错时先检查提示行附近的缩进、冒号与引号,再检查策略组和规则引用;实际错误也可能位于提示行之前。

配置与订阅

配置文件

Configuration file / config.yaml

配置文件描述监听端口、代理、策略组、规则与 DNS 等设置,常见名称是 config.yaml。文件名本身不决定内容,客户端可能先下载源配置,再应用本地覆写生成运行配置。界面设置与文件内容不一致时,应查客户端显示的实际运行配置,而不是只看订阅原文。

配置与订阅

代理集合

Proxy provider

代理集合通过 proxy-providers 管理可更新的代理列表,再由策略组引用其中成员。它不等同于完整配置订阅,也不负责提供规则;返回内容需要符合代理集合的格式要求。集合更新成功后仍看不到节点时,应检查策略组的 use 引用、筛选条件与资源解析日志。

配置与订阅

本地覆写

Local override / Merge

本地覆写是在订阅源配置之上补充或替换设置,常用于固定端口、自定义 DNS 或添加分流规则。不同客户端对列表合并、规则插入顺序和脚本处理的实现并不相同,不能假设同名功能行为一致。修改后应检查最终运行配置,并测试一次订阅更新,确认本地设置仍按预期保留。