Windows
在系统的「关于」页面确认系统类型,再核对客户端标注的处理器架构。首次安装可以先用系统代理验证浏览器连接,不必同时开启虚拟网卡。如果安装器或系统弹出权限提示,先看提示涉及的是安装、服务还是网络接入,不用为了一条提示把防火墙整项关掉。替换旧客户端前,先退出旧进程并保留原配置。
前往下载127.0.0.1 / 客户端入口
先确认系统和处理器架构,再选安装包。图形客户端通常把导入配置、切换策略组和查看日志放在同一个界面里,适合第一次安装。已经在使用命令行内核的读者,可以在下载页单独查看内核入口,避免把内核包当作桌面安装程序。
在系统的「关于」页面确认系统类型,再核对客户端标注的处理器架构。首次安装可以先用系统代理验证浏览器连接,不必同时开启虚拟网卡。如果安装器或系统弹出权限提示,先看提示涉及的是安装、服务还是网络接入,不用为了一条提示把防火墙整项关掉。替换旧客户端前,先退出旧进程并保留原配置。
前往下载从「关于本机」区分 Intel 处理器与 Apple 芯片,再选对应安装包。若启动时出现系统安全提示,回到项目的发布说明确认安装要求;如果能启动却不能接管流量,再检查系统代理状态和客户端的网络权限。换到另一台机器时,优先迁移配置,别直接复制旧应用的数据目录。
前往下载选包时看设备上运行的系统所支持的架构,不只看手机芯片的宣传参数。首次连接通常会弹出系统的 VPN 授权提示,确认后再看客户端是否进入已连接状态。若问题只在锁屏后出现,先检查系统是否暂停了应用的后台运行;若一连接就断开,则先看有没有另一个应用占用 VPN。
前往下载从下载页进入商店详情,先看系统要求,再决定是否安装。首次连接时按系统提示允许添加 VPN 配置;导入成功和连接成功是两个不同状态,不能只凭配置列表里出现名称判断。已有工作用的 VPN 配置时,先确认能否切换,尤其是在单位管理的设备上。
前往下载桌面用户先核对发行版、包格式和处理器架构,再决定使用哪个图形客户端。不同桌面环境对系统代理的处理并不相同:浏览器能走代理,不代表终端命令会读取同一组设置。只在服务器上运行内核时,应另外确认配置路径和服务权限,让监听范围与实际用途一致。
前往下载DIRECT / 配置门牌
本地监听、流量接管和规则分流是三件事:端口决定应用把请求交到哪里,接管方式决定哪些请求能进内核,规则才决定进入内核的请求往哪走。记住这三个位置,排查时就能区分请求是没进来,还是进来后走错了路径。
规则模式会从上到下检查每条规则,命中后便使用该条指定的目标,并不会再往下找更精确的规则。示例按私网地址、示例域名、其余流量三个层次分别处理:第一条让指定地址段直连,第二条用来观察域名匹配和拒绝结果,最后一条负责兜底。它不依赖任何远程节点,适合先在测试配置里看日志,再把同样的顺序用到自己的配置中。实际编辑时,别把拒绝规则误写成范围太广的域名后缀。
MATCH 放最后。no-resolve 避免为这条地址规则主动把域名解析成 IP。mode: rule
rules:
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- DOMAIN,example.org,REJECT
- MATCH,DIRECT
策略组把规则里引用的名字和真正处理连接的出口分开。为同一组流量更换出口时,只改组内选择即可,不用逐条改写域名规则。示例中的手动组只有直连和拒绝,适合在单独的测试配置里观察切换后的区别;移到日常配置时,再换成文件里实际存在的节点或组名。自动测速类组另有探测目标与间隔设置,用在移动设备前,要把额外探测带来的唤醒算进去。
name 完全一致。mode: rule
proxy-groups:
- name: 手动选择
type: select
proxies:
- DIRECT
- REJECT
rules:
- DOMAIN,example.org,手动选择
- MATCH,DIRECT
内置 DNS 处理到达内核的域名查询,nameserver 列出可用的上游解析地址。开启内置解析并不等于所有应用都会使用它:浏览器可能启用了自己的安全 DNS,系统也可能仍按网络连接的设置查询。排错时先辨认哪一侧发出了请求,再看上游是否可达。单位的内部域名如果依赖专用解析服务,不适合直接用公共上游替换原有设置。
dns:
enable: true
nameserver:
- 223.5.5.5
只打开系统代理时,一些应用不会主动使用该入口。支持 TUN 的客户端可以用虚拟网卡和路由把更多流量交给内核,但这一步涉及操作系统权限,也可能改变打印机、共享目录和公司网络的访问路径。示例面向支持这些字段的 Mihomo 桌面环境,开启前先记下当前的网络状态。若切换后连本地服务都打不开,先关闭虚拟网卡并复测,别同时修改规则和解析设置。
auto-route 启用自动路由配置。auto-detect-interface 用于自动识别出口网卡。tun:
enable: true
stack: system
auto-route: true
auto-detect-interface: true
界面里的配置档案通常是本地文件和远程订阅的列表;Mihomo 配置里的 profile 则控制部分运行状态是否保存,两者不是同一个功能。示例保存手动选择的策略组选项,方便重启后恢复。若订阅更新时删除了某个节点或改了组名,原选择仍可能失效。要长期保留自定义规则,先看看客户端有没有单独的覆写功能,不要把本地修改只留在下次刷新会替换的文件里。
profile。profile:
store-selected: true
store-fake-ip: false
便签上的 mixed-port: 7890 是示例,不是每款客户端的固定端口。127.0.0.1 指向当前设备;手机里的同一个地址不会指到电脑。只供本机使用时,保持 allow-lan: false,然后以客户端实际显示的监听端口为准。遇到端口冲突,在确认当前端口被占用后再换端口,并把手动填写过旧端口的应用一并改掉。
mixed-port / 初次连接
第一次尽量保留能正常联网的原始状态,一次只改一个设置。先确认配置能读入,再看请求能不能进入内核,最后才看规则分到哪里。这样即使第二步不通,也不用回头把订阅重新导入一遍。
01 / config.yaml
在配置或订阅页面添加已有的本地文件或订阅地址。导入完成后先检查策略组和规则是否出现,再选中该档案并确认它是当前生效项。若界面只显示下载成功,却没有加载内容,先看导入日志有没有格式或网络报错。订阅地址可能含有访问凭据,分享报错时不要截图带出完整地址。
02 / mode: rule
日常使用先选规则模式;确认需要转发的规则指向正确的策略组,再到组内检查所选出口。桌面上可先通过系统代理测试遵循该设置的应用,手机则按客户端的连接操作完成系统授权。不要把规则模式和系统代理当作二选一:前者决定怎么分流,后者决定请求怎么进入。
03 / 127.0.0.1
新开一个网页请求,再到客户端的连接记录中对照域名、命中规则和出口。完全没有新记录,先查应用是否使用代理入口;有记录却失败,再检查策略组、解析和连接报错。需要测试命令行时,单独确认终端程序读到的代理设置,不用浏览器的结果替它下结论。
config.yaml / 项目来源
Clash开源网是独立的资料站,整理客户端入口、配置示例和排查方法。客户端的发布说明、维护状态和功能边界以各项目为准。读源码时,先分清看到的是负责网络处理的内核,还是控制它的客户端界面。
早期 Clash 项目把代理节点、策略组和分流规则组织进同一份配置。原项目后来停止维护,但这套配置结构和围绕它形成的使用习惯仍由社区中的其他项目延续。旧教程里的界面、菜单路径和字段,不能直接当成现有客户端的操作说明;老截图可以用来理解概念,具体操作仍要看当前项目。
迁移旧档案时,先保留一份原文件,另存副本,再对照通用字段、节点类型和规则目标。旧档案能被读入,也不一定意味着每项设置都以原来的方式处理。先确认基本连接,再逐项恢复依赖较多的功能,比在迁移时整份重写容易定位问题。
图形客户端通常管理配置档案、系统集成和日志展示。即使两个客户端采用相近的内核,它们的托盘操作、开机启动、后台服务和覆写入口仍可能不同。系统授权或安装界面的问题,可以先从客户端项目的说明找答案;规则判断和协议能力则更适合对照内核文档。
查阅公开的问题记录时,先看记录描述的操作系统和复现条件。相同的报错文字,可能来自文件权限、系统网络服务或配置语法。提交问题时,可以提供精简后的字段片段、错误出现的步骤和相关日志,先去掉节点信息、订阅地址及日志里的个人数据。
Mihomo 是 Clash.Meta 延续发展后的项目名,其公开仓库在 MetaCubeX 名下,采用 GPL-3.0 许可证。支持相关功能的客户端可以把用户选定的配置交给内核,由内核负责监听、规则匹配和连接转发。客户端可能还会把界面设置合并到最终配置,因此导入的文件与内核实际加载的内容不一定完全相同。
确认一个字段有无生效时,先比对保存的配置与客户端提供的生效配置,再看内核日志。不要只根据按钮名称推断底层状态。例如,看到系统代理已打开,并不能推断虚拟网卡已经启用;两者改变的是不同的入口。
程序升级更新的是客户端本身,内核是否随安装包更新由该项目决定;订阅刷新则更新配置内容,规则集也可能另有刷新周期。界面上这些动作往往都叫「更新」,但它们修改的对象不同。出现异常时,先记住最近一次更新的是哪一项,再对照对应项目的变更记录。
改动前保留一个以前能用的配置副本,改动后优先复测原来正常的请求。订阅一刷新就出现问题,先看策略组和规则引用有没有变;升级应用后才出现问题,先看系统权限和启动日志。不要为了恢复一次连接,同时刷新订阅、覆盖配置和替换内核。
在 MetaCubeX/mihomo 仓库可以查看源代码、许可证和发布记录。下面的命令需要先安装 Git,只将源码取到当前目录下的 mihomo 子目录,不会安装客户端或修改系统代理。如果只是想取得可运行的程序,仍应从下载页按系统选包。
git clone https://github.com/MetaCubeX/mihomo.git
127.0.0.1 / 排查记录
排查文章按现象分开写。打不开程序,先看启动记录;能打开却没有流量,先检查应用与本地端口的连接;只有一种应用不通时,就从那种应用使用的代理设置查起。先选和当前现象最接近的一篇。
启动即崩溃多与 YAML 语法错误、端口被占用或内核文件缺失有关,按日志线索逐步恢复正常启动。
适合程序还没显示主界面就退出的情况。先区分它退出在读取配置之前还是之后,再决定是恢复配置副本、腾出端口,还是修复安装。
从安装包选择、管理员权限、防火墙放行到 TUN 虚拟网卡启用,串起 Windows 上的完整配置步骤与易错点。
适合卡在系统权限提示或服务安装的读者。先弄清哪一步需要权限,再决定是按正常流程授权,还是回到只用系统代理的设置。
浏览器插件抢占、终端不读系统代理、环境变量缺失是常见原因,按浏览器和终端两条线逐一定位。
适合网页与命令行表现不一致的情况。对照两个应用有没有使用同一个本地端口,再判断问题是在应用入口还是分流规则。