CONFIGURATION INDEX · 27 TERMS
Clash Meta 配置术语表
按内核架构、代理协议、规则分流、订阅配置与网络诊断整理常见概念。每个条目说明术语在配置中的位置、实际作用以及容易混淆的边界,便于阅读 YAML、导入订阅和检查连接路径。
CATEGORY ROUTES
按配置层次查找
C-01 · CORE
内核与架构
说明客户端界面、代理内核、本地监听端口与系统流量接管之间的关系。理解这一层后,可以区分界面操作问题、内核配置问题和操作系统网络设置问题。
- mihomo
-
别名:Meta 内核
mihomo 是 Clash Meta 延续演进后的代理内核名称,负责读取配置、监听本地端口、建立远端连接并执行规则匹配。图形客户端通常把订阅管理、策略切换和日志查看包装成界面,真正处理流量的部分仍由内核完成。
不同客户端可能携带不同发布时间的内核,因此同一份配置在字段兼容性上可能出现差异。遇到未知字段或启动失败时,应先确认客户端所使用的内核类型与更新状态。
- Clash Meta
-
相关:mihomo、Meta 配置
Clash Meta 最初用于指代在 Clash 基础上扩展协议、DNS 与流量接管能力的内核分支,也常被用于描述围绕该内核形成的客户端生态。当前技术文档中出现 Meta 内核时,通常需要结合上下文判断是否具体指 mihomo。
Clash Meta 不是某一个固定图形客户端的专用名称。Windows、macOS、Android、iOS 与 Linux 客户端可以采用不同界面,但底层配置概念大体相通。
- GUI 客户端
-
英文:Graphical User Interface Client
GUI 客户端为代理内核提供图形操作层,常见功能包括导入订阅、选择策略组、切换代理模式、启停系统代理和查看日志。它降低了直接编辑配置文件的频率,但不会改变配置字段本身的含义。
界面中的开关最终会转换成内核参数或系统设置。比较不同客户端时,需要分别观察界面功能、内核版本、平台适配和配置兼容性,不能只依据按钮名称判断能力是否相同。
- Mixed Port
-
配置键:mixed-port
Mixed Port 是同时接受 HTTP 与 SOCKS5 请求的本地监听端口。应用只需要连接这个端口,内核会依据请求类型分别处理,适合希望减少端口配置数量的桌面环境。
它与远端节点端口不是同一概念:Mixed Port 只在本机等待应用连接,节点端口则用于连接远端服务。若本地端口已被其他程序占用,内核可能无法启动监听并在日志中报告绑定失败。
- TUN 模式
-
相关:虚拟网络接口、路由接管
TUN 模式通过虚拟网络接口接收系统流量,再由内核按规则决定出口。它适合不读取系统代理设置的应用,也能覆盖比普通 HTTP 代理更广的连接范围。
启用 TUN 通常涉及系统权限、路由表和 DNS 配置,部分平台还需要安装服务组件。若出现内网不可达、网络断开或域名解析异常,应同时检查 TUN 路由、接口排除项与 DNS 工作模式。
C-02 · PROTOCOL
代理协议
代理协议决定客户端如何与远端服务通信。地址和端口只是连接入口,协议类型、认证信息、传输方式与 TLS 参数共同决定节点能否建立有效连接。
- 节点
-
英文:Proxy Node
节点是配置中可供策略组选择的代理连接条目,通常包含名称、服务器地址、端口、协议类型与认证参数。节点名称主要用于界面识别,不代表实际线路质量或所在位置一定与名称一致。
节点能够出现在列表中,只说明配置已被解析,不表示连接已经验证成功。确认可用性时还要检查 DNS、握手、证书、认证信息与远端服务状态。
- 代理协议
-
相关:认证、传输、加密
代理协议是客户端与远端服务建立代理连接时遵循的通信规范。不同协议要求的认证字段、加密方式和传输参数不同,即使服务器地址相同,也不能随意替换协议类型。
订阅转换或手工编辑配置时,缺少一个关键字段就可能造成握手失败。日志中的超时、认证失败和证书错误属于不同阶段,应按对应协议逐项核对。
- Shadowsocks
-
缩写:SS
Shadowsocks 是常见的加密代理协议,配置通常包含服务器地址、端口、密码和加密方法。客户端与服务端必须使用一致的加密方法,字段不匹配时无法建立有效会话。
部分配置还会附带插件或传输选项,这些扩展参数需要客户端内核支持。导入后若节点无法使用,应确认订阅没有在转换过程中丢失插件字段。
- Trojan
-
常见组合:Trojan + TLS
Trojan 通常在 TLS 连接上承载代理通信,配置重点包括服务器地址、端口、密码、服务器名称与证书验证设置。服务器名称用于 TLS 握手,不一定与节点显示名称或连接地址相同。
证书错误不应简单归类为节点延迟问题。系统时间、服务器名称、证书链和中间网络干预都可能影响 TLS 验证,需要结合日志中的具体错误判断。
- VMess 与 VLESS
-
相关传输:TCP、WebSocket、gRPC
VMess 与 VLESS 是两类常见代理协议,均可能搭配 TCP、WebSocket、gRPC、TLS 等传输组合。协议名称相近不代表字段可以互换,用户标识、加密选项、流控和传输参数需要分别处理。
排查此类节点时,应先核对协议主体,再检查传输层路径、主机名和 TLS 设置。只修改端口或策略组通常不能修复字段不一致造成的连接失败。
C-03 · ROUTING
规则与分流
规则系统把连接特征映射到策略组。匹配顺序、解析结果和兜底规则会共同影响最终出口,因此修改规则时需要观察完整链路,而不是只看某一条规则文本。
- 规则分流
-
英文:Rule-based Routing
规则分流是根据域名、目标 IP、来源 IP、进程或外部规则集决定连接出口的过程。命中的连接可以交给代理策略组、直接连接,也可以按配置拒绝。
分流结果取决于规则顺序和客户端实际获得的信息。若域名已经在系统外部解析成 IP,部分域名规则可能缺少匹配条件,此时需要结合 DNS 模式检查。
- 规则模式
-
界面常见项:Rule
规则模式按照配置中的 rules 列表自上而下检查连接,通常由第一条命中的规则决定策略。它适合同时保留直连、代理和其他出口,而不必让所有流量使用同一个节点。
切换到规则模式后,策略组内的节点选择仍然有效。规则负责决定进入哪个组,策略组再决定该组最终使用哪个节点或动作,两者属于不同层次。
- 策略组
-
配置键:proxy-groups
策略组把多个节点或其他策略组合成一个逻辑出口,规则通常引用策略组名称而不是直接引用单个节点。常见类型包括手动选择、自动测试、故障转移和负载分配。
策略组可以继续引用其他组,因此配置可能形成多层选择关系。修改组名时,还需要同步检查 rules 与其他策略组中的引用,否则配置可能加载失败或回退到非预期出口。
- RULE-SET
-
相关:Rule Provider
RULE-SET 用于在主规则列表中引用独立规则集合,并把命中的连接交给指定策略。大型域名或 IP 列表可以单独维护,不必全部写入主配置。
规则集合需要先在 Provider 区域声明来源、行为类型与更新周期。若远程文件无法下载、格式与 behavior 不匹配或引用名称写错,对应 RULE-SET 就不能按预期工作。
- GeoIP
-
示例语义:GEOIP,CN,DIRECT
GeoIP 依据目标 IP 在地理数据库中的归属进行匹配。它处理的是 IP,而不是域名文字本身,因此结果受 DNS 解析地址、数据库版本和内容分发网络调度影响。
同一域名可能在不同网络环境下解析到不同地区的地址,GeoIP 结果也会随之变化。需要精确按域名控制时,通常应把域名规则放在相关 GeoIP 规则之前。
- MATCH
-
作用:最终兜底
MATCH 通常位于规则列表末尾,接收此前未被其他规则命中的连接。它决定未知流量的默认出口,是检查规则配置时不可忽略的一项。
如果 MATCH 放置过早,后续规则将没有机会参与匹配。若大量连接都落入 MATCH,应检查前置规则是否加载成功、域名信息是否可用,以及规则类型是否符合当前流量。
C-04 · CONFIG
订阅与配置
订阅负责传递远程内容,YAML 负责表达配置结构,客户端则负责保存、更新和加载。把这三部分分开观察,更容易定位下载失败、解析失败与运行失败的差别。
- 订阅
-
常见形式:远程 URL
订阅是由服务提供方发布并可定期更新的配置来源,内容可能包含节点、策略组、规则或经过转换的完整 YAML。客户端保存订阅地址后,会按手动操作或设定周期重新请求内容。
订阅能够在浏览器中打开,不等于返回内容一定适合当前客户端。解析失败时还要检查响应格式、字段兼容性、访问权限与中间转换服务的输出。
- YAML
-
配置扩展名:.yaml 或 .yml
YAML 是 Clash 配置常用的文本序列化格式,依靠缩进表达层级,并使用冒号、短横线和列表组织字段。它对缩进和字符结构较敏感,复制时混入制表符或破坏空格层级都可能导致解析失败。
语法正确只表示文档能够被解析,不代表字段一定受到当前内核支持。编辑配置后,应先观察加载日志,再验证策略组、DNS 与规则是否完整出现。
- Proxy Provider
-
配置键:proxy-providers
Proxy Provider 把节点列表从主配置拆分成独立来源,可以使用本地文件或远程地址,并设置更新时间与健康检查。策略组通过 use 字段引用 Provider 中的节点。
Provider 更新成功并不代表主订阅也被替换,两者具有各自的更新路径。排查节点列表过期时,应确认当前节点来自主配置还是某个 Provider。
- 配置文件
-
客户端界面常称:Profile
配置文件是保存端口、DNS、节点、策略组和规则等设置的 YAML 文档。客户端可以同时保存多个配置,但通常只有当前选中的配置会被加载到内核。
切换配置会改变整套策略与监听参数,不等同于只切换节点。若修改后没有生效,应确认编辑的是当前配置,并执行重新加载或重启内核所需的操作。
- 自动更新间隔
-
常见单位:秒、分钟或小时
自动更新间隔表示客户端或 Provider 再次请求远程内容前等待的周期。较短周期能更快获得变更,但会增加请求次数;较长周期则可能让节点和规则保持旧状态更久。
更新间隔不会修复已经失效的订阅地址。若手动更新也失败,应先检查链接可达性、返回状态、代理环路与订阅格式,再决定是否调整周期。
C-05 · NETWORK
网络与诊断
连接问题通常跨越域名解析、本地监听、系统路由和远端握手。诊断时应记录故障发生在哪一阶段,再读取对应日志,避免用单次延迟测试替代完整判断。
- DNS
-
英文:Domain Name System
DNS 把域名转换为 IP 地址。Clash Meta 可以配置上游解析服务器、备用解析路径和分流行为,使域名查询与代理规则配合工作。
域名能否解析、解析请求走哪条路径、连接最终使用哪个出口是三个相关但不同的问题。修改 DNS 后,应重新加载配置并建立新连接,避免旧缓存影响判断。
- Fake-IP
-
配置值:enhanced-mode: fake-ip
Fake-IP 模式向应用返回保留地址,并由内核维护保留地址与原始域名之间的映射。连接到该地址时,内核可以恢复域名信息,再执行域名规则和真实解析。
部分局域网设备、特殊域名或依赖真实解析结果的应用可能需要加入过滤名单。遇到局域网发现、登录验证或特定应用异常时,可以检查 fake-ip-filter,而不是直接删除全部 DNS 配置。
- DNS 泄漏
-
诊断对象:解析路径
DNS 泄漏指域名查询没有按预期经过配置的解析链路,而是交给其他网络接口、系统 DNS 或未计划使用的上游。它描述的是查询路径偏离,不等同于所有连接都绕过代理。
检测时应同时观察系统 DNS、浏览器安全 DNS、TUN 设置与 Clash 日志。仅凭检测页面显示某个解析服务,不能直接确定泄漏来源,还需对照当前网络和上游配置。
- 延迟
-
常见单位:ms
延迟是一次测试请求从发出到获得响应所用的时间。客户端显示的数值通常针对指定测试地址,只反映当时的路径、握手与目标响应情况。
延迟较低不保证大文件传输速度更高,也不能证明所有网站都走同一路径。选节点时还应观察连接稳定性、丢包、带宽和目标服务的实际访问结果。
- 系统代理
-
相关:HTTP、HTTPS、SOCKS
系统代理把操作系统的代理设置指向 Clash 的本地监听端口,使遵循该设置的应用把请求交给内核。它通常不接管忽略系统设置的应用,也不天然覆盖所有 UDP 流量。
关闭客户端前恢复系统代理状态,可以避免系统仍指向已经停止监听的本地端口。若浏览器可用而其他应用不可用,应检查应用是否支持系统代理,或评估是否需要 TUN 模式。
- 代理环路
-
常见表现:更新超时、重复连接
代理环路是代理请求再次被送回同一个代理入口,并在路径中重复转发的异常状态。订阅更新、节点连接或本地服务若错误继承系统代理,都可能形成环路。
排查时可以暂时关闭系统代理,检查订阅请求是否被代理,并核对应用排除项与 TUN 路由。日志中持续出现相同目标和本地端口的重复连接,是判断环路的重要线索。