mihomo 内核
Proxy engine · formerly Clash Meta
mihomo 是 Clash Meta 后续使用的项目名称，承担配置解析、规则匹配、代理连接与 DNS 处理。它可以独立运行，也可以由图形客户端启动和管理。同样的客户端界面可能搭配不同内核构建，因此某项协议或配置字段能否使用，应以实际运行内核的支持情况为准。
查阅内核与平台配置说明 →
概念速查
Clash 术语表
从内核、连接协议到配置文件，按功能查阅 24 个常用概念。先确认术语所在层次，再对照客户端设置或运行日志，避免把解析问题与连接问题混为一谈。
内核与客户端
界面负责操作入口，内核负责处理连接。排查兼容性时，需要同时确认两者。
Clash 客户端
Graphical client
Clash 客户端通常为内核提供图形操作入口，包括导入订阅、切换代理组、查看日志和设置系统代理。客户端名称与内核名称不是同一概念，界面中的选项也不一定覆盖内核全部能力。选型时应分别检查操作系统支持、配置兼容性和权限管理方式，而不只比较界面外观。
查看客户端选型指南 →节点
Proxy endpoint
节点是一组代理连接参数，通常包含服务器地址、端口、协议、认证信息及传输设置。节点显示名称只是便于选择的标签，不能证明服务器位置、线路质量或可用带宽。节点载入成功只说明配置可被读取，仍需通过连接测试和实际访问确认服务是否可用。
延迟测试
URL Test · request timing
客户端常通过某个节点访问指定测试地址，并把请求过程中的耗时显示为延迟。该数值可能包含连接建立、协议握手与目标响应时间，不能直接等同于 ICMP Ping。低延迟也不代表高下载速度；比较节点时，应保持测试地址一致，并结合丢包、连续访问和实际传输表现判断。
阅读延迟测试原理 →代理协议
协议规定客户端与服务器如何交换数据。协议、传输方式与加密层需要分别识别。
Shadowsocks
Encrypted proxy protocol
Shadowsocks 使用共享密钥与指定加密方法在客户端和服务器之间传输代理流量。填写节点时，加密方法、密码以及相关协议参数必须与服务端一致，不能仅凭地址和端口建立连接。不同加密方法的支持范围与运行开销不同，旧配置能导入并不意味着当前内核支持其中所有选项。
VMess
V2Ray protocol
VMess 是 V2Ray 生态中的代理协议，常以 UUID 标识用户，并可搭配不同传输方式。WebSocket、TLS 与 VMess 不属于同一层，配置时需要分别对齐协议认证、传输路径和服务器名称。部分认证过程依赖合理的系统时间，遇到握手失败时应同时检查时钟与服务端参数。
VLESS
Lightweight proxy protocol
VLESS 是使用 UUID 认证的轻量代理协议，本身不提供通用的载荷加密层，实际连接常结合 TLS 或 REALITY 等配置。服务端声明的流控、传输方式与安全参数需要完整匹配。不能把 VMess 配置中的类型名称改成 VLESS 就视为完成转换，因为两者的协议结构与所需参数不同。
Trojan
TLS-based proxy protocol
Trojan 通常在 TLS 连接中传输代理流量，并使用密码进行认证。连接时除检查密码，还应确认服务器名称与证书是否匹配，以及证书信任链是否有效。跳过证书验证会改变安全边界，不应作为握手失败的默认处理方法；优先排查系统时间、域名配置和服务端证书状态。
规则与分流
规则决定连接走哪条路径，代理组决定路径引用的具体节点。顺序与名称都属于配置的一部分。
规则分流
Rule-based routing
规则分流根据域名、目标 IP、进程等条件，为连接选择直连、代理或拒绝策略。规则通常自上而下检查，第一条命中后便采用对应结果，因此更具体的例外应放在宽泛规则之前。修改规则后，应从连接详情确认实际命中项；只观察出口 IP，往往无法解释某个应用为何仍走原来的路径。
查看规则语法与优先级 →代理组
Proxy group
代理组为多个节点或策略提供一个统一名称，规则可以引用这个名称，而不必逐条指定节点。常见类型包括手动选择的 select、按测试结果选择的 url-test，以及按可用性回退的 fallback。自动选择依赖测试条件，不保证在所有业务中都更快；组内节点、测试地址与切换条件需要一起检查。
DIRECT、REJECT 与 PROXY
Built-in policies and configured names
DIRECT 是内置直连策略，表示不经代理服务器建立目标连接；REJECT 表示拒绝匹配的连接。PROXY 则通常只是配置作者选用的代理组名称，不是所有配置都自带的固定策略。规则引用的组名必须与定义完全一致，大小写、空格或重命名不一致都可能导致配置载入失败。
MATCH
Catch-all rule
MATCH 用于匹配前面规则未处理的所有剩余连接，通常作为规则列表末尾的兜底项。例如 MATCH,DIRECT 表示剩余连接直连，具体选择应符合配置目的。若把它放在列表开头，后续细分规则通常便不会再有匹配机会；排查分流异常时应优先检查它的位置。
GeoIP 与 GeoSite
IP geography and domain categories
GeoIP 提供 IP 归属分类，GeoSite 提供域名分类，两者用于规则判断，并不提供代理节点。数据中的分类结果可能随来源和更新时间变化，也不等同于用户或服务器的精确物理位置。使用时需要确认内核支持的数据格式、文件是否载入成功，以及对应规则有没有被更靠前的规则覆盖。
查看数据库更新与规则写法 →DNS 与网络栈
流量接管与域名解析是两条相关但不同的链路。开启代理后，仍需确认应用实际使用的路径。
TUN 模式
Virtual network interface
TUN 模式通过虚拟网络接口接收 IP 流量，再交由内核执行分流与连接处理。相较系统代理，它可以覆盖更多不读取系统代理设置的应用，但实际范围仍取决于路由、排除项和平台实现。启用时通常需要相应权限，并应检查与其他 VPN、虚拟网卡及局域网访问规则是否冲突。
查阅各平台 TUN 设置 →系统代理
Operating system proxy settings
系统代理把操作系统提供的代理设置指向客户端的本地监听地址和端口，供遵循该设置的应用使用。它不等同于为所有网络连接建立统一隧道，部分游戏、命令行工具或自带网络栈的应用可能不读取这些设置。客户端退出后若遗留了代理设置，而监听端口已经关闭，浏览器便可能出现无法连接的问题。
DNS
Domain Name System
DNS 用于把域名解析为 IP 地址等记录，解析成功之后才通常进入目标连接阶段。浏览器安全 DNS、系统解析器与内核 DNS 可能同时存在，因此修改客户端中的 DNS 选项不一定改变所有应用的查询路径。排查时应区分解析失败、返回地址不合适和目标连接失败，三者需要不同的处理步骤。
Fake-IP
Synthetic address mapping
Fake-IP 为查询的域名返回一个合成地址，并在内核保存地址与域名的映射。后续连接到达内核时，可以利用映射恢复域名，再执行分流与实际连接，而不是把该地址视为网站的真实 IP。依赖真实解析结果的应用可能需要例外配置；切换 DNS 模式后，也要注意系统或应用仍可能保留旧缓存。
DNS 泄漏
DNS query path leakage
DNS 泄漏通常指查询绕过预期解析路径，例如原本计划经代理发送，却由应用直接查询另一个解析器。判断重点是查询实际发往何处、使用何种传输以及是否符合预期，不能只凭出口 IP 推断。加密 DNS 能保护特定传输环节，但不自动保证查询经过代理；应结合浏览器设置、系统路由和内核日志检查。
查看网络故障排查问答 →订阅与配置文件
订阅负责分发，配置负责描述行为。导入成功、语法有效与连接可用是三个不同的检查结果。
订阅
Subscription URL
订阅是通过一个地址获取并更新节点信息或完整配置的分发方式，返回内容未必适用于所有客户端。地址中可能包含访问凭据，分享截图、日志或求助信息时应先隐藏完整地址。更新订阅可能覆盖本地编辑内容，因此自定义规则宜放在客户端支持的覆写或合并机制中，并在更新后检查实际结果。
查看订阅导入步骤 →YAML
YAML configuration format
YAML 是 Clash 配置常用的结构化文本格式，通过缩进表达层级，通过列表和映射组织参数。缩进应使用空格而不是制表符，包含特殊字符的内容应按 YAML 规则加引号。语法解析通过只代表文本结构有效，字段是否受支持、引用的代理组是否存在，还需要由当前内核进一步检查。
config.yaml
Runtime configuration file
config.yaml 是代理内核常见的配置文件名，可以描述监听端口、节点、代理组、规则与 DNS 设置。图形客户端可能把订阅、覆写内容及界面设置合并成另一份运行配置，因此正在编辑的文件不一定是内核最终读取的文件。遇到修改不生效时，应确认当前配置、保存状态与重载结果，而不是重复改动同一字段。
订阅转换
Subscription conversion
订阅转换把节点信息或已有配置整理为另一种客户端可识别的格式，也可能添加代理组和规则模板。格式转换不能为内核增加原本不支持的协议，源数据缺少的必要参数也不会自动补齐。使用远程转换服务时，服务端可能接触原订阅地址与节点凭据，应先确认处理范围；已有兼容配置时可优先直接导入。
proxy-providers
External proxy providers
proxy-providers 用于声明远程或本地的节点集合，使节点更新与主配置维护可以分开进行。集合载入后，通常还需由代理组通过 use 引用，节点才会出现在对应选择范围内。提供者的下载成功不等于组内节点可连接，仍应分别检查内容格式、引用名称和节点测试结果。
rule-providers
External rule providers
rule-providers 用于声明外部规则集合，并通过 RULE-SET 在主规则列表中指定使用位置及目标策略。集合的内容组织方式必须与声明的 behavior 和 format 相匹配，不能把域名列表直接当成任意格式的规则集。规则集内部内容更新后，主列表中的先后顺序仍然决定它能否命中连接。