mihomo
Proxy core
由 Clash Meta 项目延续而来的代理内核，负责连接处理、规则匹配、DNS 与各类协议实现。图形客户端通过配置文件和控制接口调用它，窗口布局并不是内核本身的功能。判断某个字段能否使用，应查看当前运行的内核版本和文档，而不是只看客户端名称。
配置查阅 / 名词解释
Clash 名词解释
内核、协议、规则与订阅术语。按设置场景查阅含义，区分界面选项、连接参数和实际生效范围。
CORE / CLIENT
内核与客户端
先辨认谁处理连接，再判断设置作用在哪一层。客户端名称与内核名称不能互相替代。
Clash Meta
Historical project name
mihomo 项目的历史名称，也是一些客户端、订阅说明与旧教程沿用的名称。所谓 Meta 配置，通常指使用该内核家族扩展能力的 Clash 风格 YAML，而不是一种独立的文件格式。原版内核未必能识别其中的新协议或字段，迁移时仍需检查兼容性。
图形客户端
Graphical user interface · GUI
提供订阅导入、策略选择、系统设置和日志查看界面的应用，例如 Clash Verge Rev。客户端负责把操作整理为内核配置，并可能管理服务权限、启动任务与配置覆写。界面出现某个选项，并不代表当前操作系统、内核版本和权限已经满足它的使用条件。
系统代理
System proxy
将操作系统的代理设置指向客户端本地监听地址，让遵循该设置的应用把请求交给内核。它不是全部系统流量的统一入口，部分命令行工具、游戏或独立网络程序可能忽略该设置。遇到某个程序未走代理时，应先确认它的代理支持方式，再考虑单独配置或 TUN 接管。
TUN 模式
Virtual network interface
通过虚拟网络接口接收 IP 数据包，再由内核进行连接处理和分流的工作方式。它能覆盖部分不遵循系统代理的应用，但实际范围仍受路由、排除项、权限和 DNS 设置影响。启用后要检查服务状态与连接去向；仅看到开关处于开启状态，不能确认流量已经进入内核。
TRANSPORT / AUTHENTICATION
代理协议
协议决定客户端与服务端如何通信。地址、认证信息、传输层和安全层需要成套匹配，名称本身不是速度结论。
Shadowsocks
Shadowsocks · SS
常缩写为 SS 的加密代理协议，配置一般涉及服务端地址、端口、加密方法和密码。客户端与服务端必须使用相互兼容的方法，不能因为名称都写着 Shadowsocks 就认为任意参数都能通用。若提供方要求额外插件或指定协议版本，还需确认当前内核的支持范围。
VMess
VMess protocol
源于 V2Ray 生态的代理协议，使用 UUID 等参数标识用户，认证还可能受到系统时间明显偏差的影响。VMess 是协议类型，WebSocket 等是承载传输，两者不是互相替代的选项。导入后若握手失败，应分别核对身份参数、传输路径、TLS 设置和设备时间。
VLESS
VLESS protocol
源于 V2Ray 生态的轻量代理协议，本身不提供载荷加密，实际部署通常配合 TLS 或 REALITY 等安全层。UUID 只是配置的一部分，传输方式、服务端名称及相关安全参数同样需要匹配。不能将某种传输或安全层的支持情况，直接等同于所有 VLESS 配置都能使用。
Trojan
TLS-based proxy protocol
通常依托 TLS 保护连接、以密码完成认证的代理协议。排查连接问题时，需要分别看服务端地址、密码、服务端名称与证书信任，不能仅凭端口号判断它是否配置正确。遇到证书报错，应先核对域名、系统时间和证书链，不宜把跳过证书验证当作常规处理步骤。
Hysteria2
QUIC-based proxy protocol
基于 QUIC 的代理协议，底层依赖 UDP，适用性会受到网络对 UDP 的支持、丢包状况和服务端配置影响。配置中的带宽参数参与相关传输行为，不是对实际下载速度的保证。若当前网络限制 UDP，即使认证信息正确，也可能无法建立连接，需先区分网络路径与参数问题。
TUIC
QUIC-based proxy protocol
基于 QUIC 的代理协议，提供连接复用与 UDP 转发等能力。不同协议版本的认证字段和实现细节可能不同，应按服务端提供的完整参数导入，而不是只改协议名称。移动端电量表现还取决于连接活跃度、网络切换与应用行为，不能仅凭 TUIC 或其他协议名称作固定排序。
RULES / POLICY
规则与分流
规则选择策略，策略组选择出口。理解这两层关系，才能判断切换节点之后哪些连接会改变。
规则分流
Rule-based routing
在规则模式下，按目标域名、IP 或其他条件决定连接使用哪项策略。规则从上向下匹配，通常命中即停，因此具体例外应放在宽泛规则之前。比如 DOMAIN-SUFFIX,github.com,Proxy 将相应域名交给名为 Proxy 的策略，前提是该策略在配置中确实存在。
策略组
Proxy group
由节点、其他策略组或内置策略组成的集合，是规则可以引用的目标。select 用于手动选择，url-test 根据测试结果选择，fallback 按可用性及配置顺序处理。切换组内选项通常主要影响新连接，已有长连接可能继续使用原出口，是否关闭旧连接取决于客户端操作。
节点
Proxy endpoint
客户端里对一组代理服务连接参数的常用称呼，通常包括地址、端口、协议与认证信息。显示名称只是便于识别的标签，不足以证明服务位置、线路质量或适用范围。节点能通过检测，也不表示所有请求都会使用它；实际出口还要结合当前模式、命中规则与策略组选择判断。
GeoIP
IP geolocation matching
通过 IP 数据库按国家或地区代码匹配目标地址的规则能力，例如 GEOIP,CN,DIRECT。结果依赖数据库内容，不代表企业注册地或用户所在地。目标最初是域名时，匹配可能涉及解析；带有 no-resolve 的规则会限制为匹配而主动触发解析的行为。
MATCH
Final catch-all rule
不附带匹配条件的兜底规则，用于处理前面没有命中的连接，例如 MATCH,Proxy。它通常应放在 rules 列表末尾，因为提前放置后，后面的规则无法再接收剩余连接。兜底目标可以是策略组或内置策略，最终含义由配置中的实际名称决定。
延迟测试
URL latency test
通过节点请求指定测试地址并记录耗时的检测方式，通常不是直接对服务端做 ICMP 测试。结果受到测试地址、连接复用、DNS 与当前网络状态影响，不等同于文件下载速度。一次测试成功只能说明当次测试路径可用，不能保证其他网站、UDP 应用或后续连接具有相同表现。
DNS / NETWORK STACK
DNS 与网络栈
域名解析与连接转发是相关但不同的过程。排查时要同时看系统、浏览器和内核，不能只检查一个开关。
DNS
Domain Name System
将域名解析为 IP 地址等记录的系统，是建立许多网络连接之前的一步。内核处理的 DNS、操作系统解析器与浏览器安全 DNS 可能走不同路径，所以配置内核解析服务器并不自动接管全部应用查询。出现域名访问失败而直接访问地址正常时，可以结合解析结果、缓存和日志定位问题。
Fake-IP
Synthetic IP mapping
为域名返回虚拟地址，并在内核中保存域名与地址映射的 DNS 工作方式。后续连接进入内核时，可以借助映射关联原域名，虚拟地址不是网站真实服务端地址。少数应用若依赖真实解析结果，可能需要通过 fake-ip-filter 添加兼容性例外，具体条目应根据实际故障验证。
DNS 泄漏
DNS leak
指 DNS 查询没有沿预期路径发送，而是到达其他解析器的现象；是否偏离预期，要先明确配置希望实现的解析策略。检查时应结合系统 DNS、浏览器安全 DNS、IPv6、接管设置和实际查询记录。测试网站显示的解析器地区只是一项线索，不能单独作为结论，直连解析也可能是有意设置的结果。
域名嗅探
Domain sniffing
从 HTTP Host、TLS SNI 等连接元信息中尝试恢复目标域名的能力，可帮助原本只带 IP 的连接参与域名规则匹配。它不等于解密 HTTPS 正文，也不能保证在所有协议和加密形式下取得域名。是否需要启用及是否覆盖目标，应结合 DNS 模式、配置范围与兼容性要求决定。
SUBSCRIPTION / CONFIGURATION
订阅与配置文件
完整配置、节点集合与规则集合不是同一种输入。导入前先确认文件结构，更新后再看最终生效内容。
订阅
Subscription
通过远程地址获取节点或完整配置的更新来源，不同来源返回的内容结构可能不同，不能只凭链接后缀判断是否兼容。订阅地址可能包含访问凭据，截图、日志和求助内容中应避免公开。更新可能替换原文件，因此长期保留的自定义规则宜通过客户端支持的覆写方式管理，而不是直接改远程文件副本。
YAML
YAML configuration format
用于表达配置层级、列表和键值关系的文本格式，Clash 风格配置常使用 .yaml 或 .yml 扩展名。缩进应使用空格，同层级保持一致；包含特殊字符的字符串还要留意引号。文件能被解析，只说明格式通过，字段是否受支持、策略引用是否存在，仍需要内核进一步检查。
rule-providers
Rule providers
用于定义外部规则集来源的配置项，可按需要设置更新间隔、内容格式和匹配行为。定义来源之后，还要在 rules 中通过 RULE-SET 引用，规则集不会仅因下载成功就自动参与分流。其格式与 behavior 必须匹配，优先级由引用在主规则列表中的位置决定。
proxy-providers
Proxy providers
用于引入代理节点集合的配置项，可管理来源、更新间隔与健康检查，策略组通常通过 use 引用对应集合。它侧重节点来源管理，和用 proxies 直接列出节点的方式不同。节点集合本身不等于完整客户端配置，通常仍需要策略组、规则和其他设置共同组成可用配置。
配置覆写
Configuration override
客户端在原始配置基础上合并、追加或修改字段的处理方式，常用于保留个人规则、DNS 或监听设置。不同客户端对列表替换、前置规则和字段合并的处理并不完全相同，不能只看覆写片段就确认结果。修改后应检查最终生效配置，并在更新订阅后重新验证，防止字段冲突或规则顺序改变。
按问题继续查阅
- 需要完成首次连接：阅读订阅导入与代理生效检查步骤。
- 需要比较协议和内核：阅读协议参考与配置兼容性说明。
- 遇到设置不生效：到帮助中心按问题分类排查。