mihomo
mihomo 是负责解析配置、匹配规则和建立出站连接的代理内核。客户端界面负责导入文件和切换设置,真正执行这些设置的是内核。遇到不识别的字段时,先查实际运行的内核版本,而不是只看应用版本。
Clash / mihomo · 术语索引
从客户端界面或 YAML 字段查术语。遇到分流结果与预期不符时,先区分流量有没有被接管、命中了哪条规则,以及规则指定的策略组最终选了哪个出口。
mihomomihomo 是负责解析配置、匹配规则和建立出站连接的代理内核。客户端界面负责导入文件和切换设置,真正执行这些设置的是内核。遇到不识别的字段时,先查实际运行的内核版本,而不是只看应用版本。
节点是配置中定义的一个代理出口,通常包含协议、服务器地址、端口和该协议所需的参数。proxies 可以直接列出节点,而策略组只负责在候选出口之间选择。显示名称能用于引用,但不能据此判断节点是否可达或使用什么协议。
代理协议约定客户端和服务端如何交换数据。节点中的 type 决定其余字段如何解释,因此换协议不能只改名称,还要使用服务端支持的一整组参数。本地应用接入代理时用的协议,也不一定和内核连接远端节点用的协议相同。
面板上的毫秒数通常来自一次发往指定 URL 的探测,不是到所有目的地的往返时间。不同测试地址、超时设置或连接复用行为都可能让数值不可直接比较。下载速度和持续稳定性应另外测试;一次探测超时也不等于所有访问都失败。
订阅是客户端定期获取配置内容的来源,通常以链接导入。响应可能是完整配置,也可能只是节点清单;能否直接启用取决于响应格式和客户端支持。订阅链接可能含访问凭据,排查导入问题时不要公开完整链接。
YAMLYAML 用缩进表示层级,用键值对和序列组织数据。例如 dns: 下缩进的 enable: 属于 DNS 配置,不是顶层开关。缩进使用空格;语法通过后,还要确认字段名称、层级和值类型符合内核要求。
proxy-providersproxy-providers 按提供者组织节点,来源可以是远程地址或本地文件。策略组通过 use 引用提供者,所以节点列表更新时,通常不必逐一重写组内候选项。如果提供者更新成功但组里没有节点,检查引用名称和筛选条件。
覆写把本地修改与订阅原文分开保存,例如调整 DNS 字段或在订阅规则前插入一条例外。覆盖同名字段、追加列表和前插列表不是同一种操作,具体行为由客户端决定。更新订阅后应查看合并结果,确认改动仍处在需要的层级和顺序。
proxy-groups策略组把候选节点、内置出口或其他组集中在一个名称下,供规则引用。select 由用户手动选择;fallback 按候选顺序优先采用可用项。规则命中组名后,还需查看该组当前选中的出口,才能判断连接实际走向。
url-testurl-test 使用指定 URL 探测候选出口,并依据延迟结果选路。interval 控制探测间隔,tolerance 用于避免因小幅延迟差异频繁切换。它衡量的是对测试目标的响应,不能保证所选出口访问其他站点也更快。
在 mode: rule 下,内核按 rules 中的顺序检查连接,通常由第一条匹配的规则决定后续策略。DOMAIN-SUFFIX 可匹配指定域名及其子域名。若某个子域名需要不同处理,应把较具体的规则放在覆盖范围更大的规则之前。
GeoIPGEOIP 依据 IP 数据集匹配目的地址的类别,例如国家或地区代码。它不是域名后缀判断,查询结果也不能证明服务归属。连接目标是域名时,规则可能需要先解析地址;no-resolve 用于避免仅为这条规则触发解析。
MATCHMATCH 匹配此前规则尚未处理的连接,常见写法包括 MATCH,DIRECT。它通常位于规则列表末尾;如果放在前面,后面的规则将无法处理已被它匹配的连接。访问意外落入兜底时,先核对前序规则和日志中的目标域名或 IP。
Fake-IPdns.enhanced-mode: fake-ip 让内核为符合条件的 DNS 请求返回合成地址,并保存域名与地址的对应关系。接管后续连接时,内核可据此恢复域名以匹配规则。依赖真实地址的局域网服务或应用可按需通过 fake-ip-filter 排除。
DNS 泄漏指 DNS 查询经过预期之外的解析路径,例如网页连接走代理,但查询仍由本地网络的解析器处理。是否构成泄漏,取决于事先规定的解析路径,而不是检测页显示的国家或地区。排查时分别核对浏览器安全 DNS、系统解析器和内核使用的上游。
tun.enable: true 是启用 TUN 的配置写法,通过虚拟网络接口和路由接管流量。它能覆盖一些不遵循系统代理设置的应用,但接管范围受系统权限、路由规则和排除项限制。启用后仍需分别确认目标流量和 DNS 查询是否按预期处理。
mixed-portmixed-port 在一个监听端口接受 HTTP 和 SOCKS 代理请求。7890 是常见示例,不是所有客户端的默认值;应用应填写当前实际监听的端口。从其他设备连接时,还需要核对 allow-lan、监听地址和防火墙设置。
GUI图形客户端提供配置导入、策略选择和日志查看等界面,可以集成内核或管理独立的内核进程。不同客户端即使使用同类内核,覆写语法、菜单位置和系统集成能力也可能不同。选型时应先确认平台支持,再比较实际使用的功能。
系统代理设置向遵循它的应用提供代理地址和端口,本身不安装用于接管流量的路由。不读取系统代理的应用可能直接连接,或使用应用内单独指定的代理。关闭客户端后如果系统仍指向本地端口,而端口已停止监听,遵循该设置的应用就可能无法联网。
x64、amd64 和 x86_64 通常指同一种 64 位 x86 架构;arm64 和 aarch64 通常指 64 位 ARM。下载前要同时确认操作系统、架构和安装包格式。如果同一客户端提供多个构建,优先选择与系统匹配的原生构建。