Windows
适合优先使用图形界面、按应用排查代理行为的桌面环境。在系统的“关于”页面确认处理器架构,再对照下载页的包类型。初次连接可先打开系统代理验证浏览器;只有目标应用不读取系统代理时,再考虑 TUN。升级前退出旧客户端,并确认后台服务也已停止。若客户端退出后浏览器仍无法联网,先检查系统代理是否保留了指向本地端口的设置。单位设备上的管理员授权和防火墙设置应遵守设备管理要求。
前往下载MIHOMO / CONFIG SCENES
CONFIG REFERENCE
策略组决定出口,规则决定哪些连接使用这个出口。先从这两层检查分流,再看 DNS 是否返回了预期结果,以及流量是否进入内核。
把规则指向策略组,可以更换出口而不用重写域名列表。select 由用户选定成员;url-test 按探测结果选取成员;fallback 则优先使用列表中靠前的可用成员。例子只用内置策略来说明引用关系。接入订阅后,先核对组名和成员名,再从连接记录确认规则命中的组与最终出口。客户端的界面可能隐藏部分字段,排查时以生效配置为准。
proxy-groups:
- name: Proxy
type: select
proxies: [DIRECT, REJECT]
rules:
- MATCH,Proxy
查阅策略组类型与实战
将域名列表从主配置抽出,能独立维护规则内容,同时把出口选择留在 rules。示例从本地文件加载,文件内容须对应 domain 行为和 YAML 格式,文件路径需从内核配置目录确认。改用 HTTP 规则集时再配更新周期。规则从上到下匹配;命中前面的直连条目后,不会继续执行后续规则。出现误分流,先核对规则集是否载入,再检查条目顺序。
rule-providers:
local-domains:
type: file
behavior: domain
format: yaml
path: ./rules/local-domains.yaml
rules:
- RULE-SET,local-domains,DIRECT
- MATCH,DIRECT
查阅规则集订阅化管理
启用内核 DNS 后,先配置可达的默认上游,再为确实需要特殊解析的域名设置 nameserver-policy。策略回答的是“向谁查询”,并不等于指定连接出口。遇到部分站点打不开时,先区分解析失败和连接失败:对比客户端日志与系统解析结果,确认浏览器是否使用了独立 DNS。例子采用一个常规上游,实际环境应按网络可达性和管理要求选择。
dns:
enable: true
nameserver:
- 223.5.5.5
查阅 DNS 配置优化
TUN 通过虚拟网卡接收流量,适合那些不读取系统代理设置的应用;Fake-IP 则让内核用地址映射保留域名信息,两者解决的问题不同。示例请求自动设置路由,并把发往常规 DNS 端口的流量交给内核。启用前确认系统权限、默认网卡和已有 VPN 的路由。若局域网服务有异常,先逐项检查路由与 DNS 例外,避免同时改动多个开关。
tun:
enable: true
auto-route: true
dns-hijack:
- any:53
dns:
enable: true
enhanced-mode: fake-ip
查阅 TUN 与 Fake-IP
部分应用提交连接请求时只有目标 IP,域名规则因而可能无法命中。嗅探可从受支持的协议元数据补充域名,但是否可读取取决于连接本身,并不能保证获得结果。示例只检查指定端口上的 TLS 流量,并保持原目标地址。排查时对照同一连接开启前后的域名与规则记录;如果没有变化,再检查端口范围、协议类型和已有的 DNS 映射。
sniffer:
enable: true
override-destination: false
sniff:
TLS:
ports: [443]
查阅域名嗅探
不要把长期保留的修改只写在远程订阅生成的文件里,下次刷新可能会覆盖它。可为不同来源定义独立的代理提供器,再由同一策略组引用。示例用两份本地提供器文件说明结构。合并后要检查名称冲突、组成员以及规则优先级;若客户端另有覆写功能,还要核对它是替换还是追加。覆写脚本的入口和执行顺序由客户端定义,不是内核通用接口。
proxy-providers:
work:
type: file
path: ./providers/work.yaml
personal:
type: file
path: ./providers/personal.yaml
proxy-groups:
- name: Proxy
type: select
use: [work, personal]
查阅覆写与多订阅合并
控制接口供兼容的面板读取连接信息和切换策略,并不是向应用转发流量的混合端口。只需本机管理时,优先将控制接口绑定到回环地址,并在本地设置独立的认证值。allow-lan 管的是代理入口,不能替代控制接口自身的监听限制。面板打不开时,按顺序核对控制端口、进程监听和认证设置,不必先改代理端口或放宽监听范围。
mixed-port: 7890
allow-lan: false
external-controller: 127.0.0.1:9090
查阅外部控制面板
PLATFORM PACKAGES
先看操作系统与处理器架构,再比较客户端。图形客户端适合在界面中管理配置;单独运行 mihomo 则需要自行处理配置目录、进程管理和系统网络设置。如果是替换已有客户端,先保存本地覆写和策略组选择,再退出旧客户端。遇到端口占用时,先确认旧进程是否退出,不要直接修改订阅里的端口来绕过问题。
适合优先使用图形界面、按应用排查代理行为的桌面环境。在系统的“关于”页面确认处理器架构,再对照下载页的包类型。初次连接可先打开系统代理验证浏览器;只有目标应用不读取系统代理时,再考虑 TUN。升级前退出旧客户端,并确认后台服务也已停止。若客户端退出后浏览器仍无法联网,先检查系统代理是否保留了指向本地端口的设置。单位设备上的管理员授权和防火墙设置应遵守设备管理要求。
前往下载在“关于本机”查看芯片信息,区分 Apple Silicon 与 Intel。以下载页实际列出的架构为准,不用根据系统界面或设备年份猜测。使用菜单栏切换代理时,可到系统网络设置复核代理状态。若一启动就退出,先检查安装包架构和系统要求;如果只是个别应用不能联网,先排除应用自己的代理设置。迁移旧配置时,分别确认订阅地址、本地文件和策略选择,不要假定新客户端会读取另一个客户端的工作目录。
前往下载根据设备架构选择 APK;下载页提供通用包时,可用它减少选错架构的概率。首次连接通常需要确认系统 VPN 请求。若设备上已有其他 VPN,先检查系统当前允许哪个应用建立连接。保持默认的电池策略做一次前台和锁屏测试,再决定是否需要调整后台权限。锁屏后掉线与切换无线网络后掉线可能是两类问题:前者先看进程是否被暂停,后者先确认系统 VPN 是否已在新网络上重新连接。
前往下载通过下载页进入客户端的 App Store 详情,先核对系统要求。安装后按应用提示添加 VPN 配置,再导入已有订阅。若订阅在桌面端可用、在移动端却无法导入,应先检查客户端支持的配置格式与字段,而不是直接修改服务端地址。测试时可分别使用无线网络和蜂窝网络,确认问题是否只出现在某种接入方式。如果设备受单位或学校管理,VPN 配置项可能由管理策略限制,应先确认允许的使用范围。
前往下载桌面系统优先按发行版的包管理方式和处理器架构选择安装包。桌面代理设置不一定会同步到终端,命令行工具应单独确认是否读取相应的代理环境变量。服务器或路由器通常更适合单独运行内核,并显式指定配置目录、工作用户与日志位置。启动失败时先区分包不兼容、缺少依赖和服务权限不足;连接失败时再看监听地址和路由。两类问题的排查入口不同,不必为了测试而同时修改防火墙与系统路由。
前往下载FIRST CONNECTION
建议先保留一份可以正常启动的配置,再逐步更改分流规则和网络接管方式。每次只改变一个设置,测试同一个目标,确认变化来自哪个开关。
安装后进入“配置”或“订阅”页面,选择从 URL 导入已有订阅,或者从文件导入本地 YAML。列表出现新条目后,手动选中它并确认已应用。能看到配置名称只表示条目已经保存,未必说明内核成功加载。若应用失败,先看报错指出的字段或行号,核对缩进、引用名称和客户端支持的字段。向他人求助时,提供相关字段与报错即可,不要把订阅地址或完整配置贴到公开讨论区。
将运行模式设为“规则”,保留配置给出的分流逻辑。桌面端先用系统代理测试支持该设置的应用,移动端按系统提示建立 VPN 连接。如果目标程序没有进入连接列表,再考虑应用独立代理或 TUN。系统代理决定应用是否把请求交给客户端,运行模式决定内核接收请求后如何处理,两处设置不能互相替代。若设备已有其他网络接管工具,先停止旧工具测试,避免把路由冲突误判成订阅失效。
选一个预期直连的目标和一个应走代理的目标,分别发起新请求。在连接记录里查看目标域名、命中规则和最终出口,不要只以页面能否打开来判断分流。如果有记录但出口不对,先检查规则顺序和策略组当前成员;如果没有记录,先确认应用的连接是否被接管。调整规则后要建立新连接再比较,应用复用已有连接时,观察到的结果可能仍来自修改前。
SOURCE / RELEASES
原版 Clash 停止维护后,相关客户端与内核项目沿各自的代码仓库继续演进。mihomo 源于 Clash.Meta 分支,仍使用读者熟悉的规则、策略组和 YAML 配置结构,但也发展了自己的字段与行为。名称里带有 Clash,并不表示项目共享同一维护者或发布周期。阅读旧教程时,应先识别它讲的是原版内核、后续分支,还是某款图形客户端,尤其要留意安装入口、服务模式和 DNS 配置的差异。
迁移归档客户端的配置时,先导入一份副本,观察内核启动日志和客户端生成的实际配置。旧字段能被解析,并不代表旧有网络行为会被原样保留;系统权限、路由和 DNS 默认值也可能变化。
mihomo 负责解析运行配置、接收连接、执行规则并选择出口。Clash Verge Rev、FlClash 等图形客户端在此基础上提供配置管理、菜单开关与连接视图。托盘交互、订阅更新入口和覆写编辑器通常属于界面层;规则匹配失败和模块初始化报错则需查内核日志。两个界面都提供名为“系统代理”的开关,也可能用不同方式管理系统设置。排查时先确认问题归哪一层,不必为解决界面问题重写整份 YAML。
同一订阅在不同客户端上的表现有差异时,查看各自应用了哪些本地覆写、启用了哪些代理入口。若能导出生效配置,把相关字段放在一起比较,比对照整个设置页面更容易找出区别。
上游仓库用来查源码、改动和公开议题。遇到配置问题,可先用报错原文或字段名搜索;如果只是某个客户端的安装器无法启动,应从该客户端的发布记录和议题查起。准备反馈时,写明系统架构、接管方式、复现步骤和实际结果。用最小配置复现有助于判断是字段关系、网络环境还是界面设置,不需要附带完整的订阅内容。本站提供客户端入口与中文文档;对项目功能和维护状态的判断,以各项目的上游记录为准。
如果同一问题只在接入某个网络后出现,也应注明何时开始复现,以及切回原网络是否恢复。这样维护者能区分环境限制和稳定可复现的软件回归。
图形客户端的发布与 mihomo 内核的发布是两条线。界面更新未必伴随内核更新,单独替换内核也可能超出客户端的支持范围。安装前先区分稳定发布和预发布,核对包的系统与架构,再读有关 DNS、TUN、权限或配置迁移的改动说明。更新完成后,用现有配置验证启动、订阅加载、直连和代理出口。出现异常时,保留旧配置与更新前的正常操作记录,以便回退或逐项确认变化。
无需在更新客户端的同时更换规则集、重设上游 DNS 或启用新模式。如果把升级和配置修改分开做,即使出现网络问题,也能明确应先恢复哪一步。
TECHNICAL NOTES
梳理 Clash 原版内核停更后的分支演进,讲清 mihomo 内核与各图形客户端的分工、维护状态与选择依据,帮助读者看懂项目名字背后的关系。
覆盖安装包选择、首次启动、导入订阅、开启系统代理与服务模式,并整理防火墙拦截、端口占用、杀软误报等 Windows 高频问题。
按配置文件从上到下的顺序,解释通用端口、运行模式、dns、proxies、proxy-groups、rule-providers 与 rules 各段作用及常见写错位置。