mihomo
代理内核 · 原 Clash Meta
mihomo 是由 Clash Meta 演进而来的代理内核，负责读取配置、匹配规则、处理 DNS 和转发连接。Clash Verge Rev 等图形客户端提供操作界面，界面中出现某个选项，不代表所有内核版本都支持同一种写法。遇到字段报错，先看客户端实际使用的内核与文档，再判断是否需要调整配置。
Clash 术语表
内核、代理模式、规则与 DNS，按概念查。先分清字段负责什么，再去改配置。
本页是客户端选型与配置资料的概念入口。每张卡片都有独立锚点，可直接分享；首次配置按快速上手操作，参数组合与实战写法查配置进阶。
内核与协议
界面负责操作，内核负责连接。节点是远端连接参数，端口是本地或远端的监听入口，不能混为一谈。
图形客户端
GUI client
图形客户端把订阅导入、代理选择、日志查看和系统代理设置做成可操作的界面，底层连接通常交给内核执行。不同客户端可能采用同一内核，但覆写方式、服务安装和权限申请入口并不相同。选型时同时看系统支持与配置管理方式，具体入口见客户端对比。
代理节点
proxy · 远端连接参数
节点是一组描述远端代理连接的参数，通常包括协议类型、服务器地址、端口与认证信息，有些协议还需要传输层或 TLS 参数。节点不是客户端本身，安装应用后仍需导入可用配置。连接失败时应区分参数错误、服务器不可达和本地网络问题，不要只凭节点名称或测试结果判断服务状态。
混合端口
mixed-port
混合端口在同一个本地监听端口接收 HTTP 代理和 SOCKS 代理请求，便于不同应用使用同一入口。它不是远端节点的服务器端口；仅供本机使用时，应用通常连接回环地址与该端口。修改数值后还要同步系统代理和手动填写的应用代理，操作细节见Clash 端口设置。
延迟测试
latency · 请求耗时
客户端通常通过代理访问指定测试地址，记录请求耗时，用它比较特定条件下的响应速度。结果会受测试站点、握手过程、连接复用和当时网络状态影响，并不等于下载带宽或视频播放能力。排查实际体验时，应使用目标应用验证，再结合日志看连接失败、丢包或拥塞，而不是只挑最小的毫秒数。
代理模式
规则、全局、直连决定流量往哪里走；系统代理与 TUN 决定流量如何进入内核。这是两组不同的设置。
规则模式
mode: rule
规则模式按配置中的规则选择出站目标，可以让不同域名或地址分别直连、走代理或被拒绝。规则通常按顺序匹配，命中后执行对应目标，因此具体条件应放在宽泛条件之前。新手日常使用可先选规则模式，但它的效果取决于规则内容与策略组定义，不会自动替配置补齐缺失的分流逻辑。
全局模式
mode: global
全局模式把进入内核的连接统一交给全局策略选择的目标，便于临时验证某个代理的访问能力。这里的全局指出站选择，不是系统流量接管：一个不读取系统代理的程序，仍可能绕过客户端。切换前确认全局策略实际选中了什么，排查结束后再恢复原模式，避免误把模式变化当成规则修复。
直连模式
mode: direct · DIRECT
直连模式让进入内核的连接不经过远端代理服务器，直接访问目标；规则中的 DIRECT 则是单条规则可引用的直连目标。两者影响范围不同，不能把一条直连规则理解为整套配置都已直连。直连模式也不等于退出应用，系统代理、TUN 和内核 DNS 仍可能处于工作状态。
系统代理
system proxy
系统代理是在操作系统设置中登记代理地址与端口，让遵循这些设置的应用把请求交给本机客户端。浏览器通常能够使用它，但部分游戏、命令行程序或自带网络栈的应用可能不读取这一设置。首次连接可先开启系统代理并用浏览器验证；应用仍无法访问时，再检查它自己的代理选项或考虑 TUN。
TUN 模式
tun · 虚拟网络接口
TUN 通过虚拟网络接口与路由配置，把流量送入代理内核，可覆盖部分不遵循系统代理的程序。它通常需要相应系统权限或客户端服务支持，启用后的覆盖范围还取决于路由、排除项与其他网络软件。TUN 不决定连接一定走代理，进入内核后仍按当前模式选择出站，开启步骤见TUN 配置。
规则与策略组
规则回答“这条连接属于哪类”，策略组回答“这一类连接选哪个出口”。引用名称必须与完整配置中的定义一致。
规则分流
rules · 条件匹配
规则分流根据域名、目标 IP 或其他条件，把连接交给指定策略组、直连目标或拒绝目标。常见域名规则有 DOMAIN 与 DOMAIN-SUFFIX，末尾通常用 MATCH 处理剩余连接。调整规则时不仅要看条件是否正确，还要看前面是否已有更宽泛的规则先命中，以及引用的策略名是否存在。
策略组
proxy-groups
策略组把多个节点或其他策略目标组织起来，让规则引用一个稳定名称，而不必逐条绑定具体节点。select 用于手动选择，url-test 用于按测试结果选优，fallback 用于按顺序进行可用性切换。它们解决的问题不同，配置组时应同时确认成员来源、测试条件和组间引用关系。
url-test
自动测试策略组
url-test 会定期通过组内代理访问指定 URL，再按测试结果与相关参数选择出口。测试地址决定比较的是哪条访问路径，间隔与容差则影响切换频率，过于频繁的切换未必适合持续连接。它适合减少手动选择，但不能保证大文件吞吐量，也不能保证所选代理对每个网站都同样好用。
GeoIP
GEOIP · 地址地区匹配
GeoIP 根据 IP 地址所属地区或数据库分类匹配连接，常用于地址层面的分流。结果来自数据库，并不代表用户所在地；云服务迁移、共享基础设施和数据库更新都可能影响分类。对域名连接使用这类规则时可能需要先解析地址，若规则带有 no-resolve，则不为该规则额外触发解析。
规则集
rule-providers · RULE-SET
规则集把一批匹配条件拆成独立资源，通过 rule-providers 定义，再由 RULE-SET 引用，方便集中更新和复用。资源格式与 behavior 必须匹配，域名列表、地址列表和经典规则不能随意混用。规则集本身不替你选择出口，最终动作仍由引用它的规则指定，更新后也要确认资源加载成功。
DNS 与网络栈
域名解析与连接转发是两条相关但不同的链路。网页打不开，可能卡在解析阶段，也可能卡在路由或远端连接阶段。
DNS
Domain Name System
DNS 将域名解析为地址等记录，让应用知道该连接哪个目标。系统、浏览器与代理内核可能分别使用自己的解析服务，所以修改内核 DNS 不一定会改变所有程序的查询路径。排查时先确认实际由谁解析，再看查询是否成功、返回地址是否符合预期，以及代理服务器域名是否也能正常解析。
Fake-IP
enhanced-mode: fake-ip
Fake-IP 向应用返回用于映射的虚拟地址，内核再利用地址与域名的对应关系处理后续连接，从而保留域名信息并配合分流。这个地址不是网站真实服务器地址，单看它不能判断解析出错。需要真实地址或与这种映射不兼容的应用，可按需要配置 fake-ip-filter，但例外范围应尽量具体。
DNS 泄漏
DNS leak · 非预期查询路径
DNS 泄漏指域名查询没有沿预期路径发出，而是交给了其他解析服务，可能暴露查询的域名。浏览器的加密 DNS、系统回退机制和未被接管的查询都需要分别检查，测试网站显示某个解析商名称也不足以说明完整路径。加密 DNS 保护传输过程，但是否符合预期，仍要看解析服务选择和流量路由。
域名嗅探
sniffer
域名嗅探尝试从连接中可见的协议元数据提取域名，例如部分 HTTP 请求或 TLS 握手信息，用来补充规则判断。它不等于解密 TLS 内容，也不能从所有连接中恢复域名，遇到加密元数据或非支持协议时可能没有结果。开启后如有兼容性问题，应按目标缩小嗅探范围，而不是假设所有 IP 连接都能被准确识别。
IPv6
Internet Protocol version 6
IPv6 使用 128 位地址，域名的 AAAA 记录通常提供这类地址。是否能正常连接取决于本地网络、DNS 返回结果、TUN 路由覆盖和代理出站能力，不能仅凭客户端里的 IPv6 开关判断。若只有部分网站异常，可比较 IPv4 与 IPv6 的解析及连接路径，再决定调整哪一层，避免用一个开关掩盖真正的路由问题。
订阅与配置文件
订阅提供远端资源，配置定义工作方式，覆写保留本地调整。更新之前，先弄清当前导入的是完整配置还是单独的代理列表。
订阅链接
subscription URL
订阅链接是获取远端配置或代理列表的地址，客户端可用它定期更新资源，避免逐个录入节点。不同服务返回的内容可能是完整 YAML、代理列表或其他格式，导入前要确认客户端支持的格式。链接常包含访问凭据，不应放进公开截图、日志或分享消息；具体导入入口见Clash 订阅链接导入。
YAML
config.yaml · 结构化配置文本
YAML 用缩进表达对象与列表层级，是 Clash 配置常用的文本格式；编辑时保持同级字段对齐，缩进使用空格。语法解析通过只说明文本结构可读，不代表策略组引用、字段名称和内核兼容性都正确。复制片段时要放到对应层级，避免重复顶层键，完整结构说明见Clash 配置文件。
代理集合
proxy-providers
代理集合通过 proxy-providers 管理独立的代理列表资源，再由策略组的 use 等配置引用。它适合将代理资源更新与本地规则维护分开，但资源内容必须符合所用内核要求，不能把任意完整配置直接当作代理集合使用。它与规则集也不同：前者提供连接候选，后者提供匹配条件。
本地覆写
override · merge · patch
本地覆写是在订阅内容之外保留自定义调整的机制，例如追加规则或修改监听端口，避免远端更新覆盖手动编辑。各客户端对合并、替换、规则插入和脚本执行的顺序可能不同，名称相似也不代表行为一致。修改后应查看最终生效配置，并确认重启或订阅更新后仍保持预期，而不是只检查编辑器中的原始文本。
外部控制接口
external-controller · 管理 API
外部控制接口让控制面板或客户端读取内核状态、切换策略并管理连接，由 external-controller 指定监听地址。它是管理入口，不是供浏览器上网的混合端口，两个端口不能互相替代。仅本机管理时优先限制在回环地址，设置认证并检查防火墙；开放到局域网前，应明确哪些设备能访问该接口。