Windows
先在系统信息中查看处理器类型。安装后导入订阅,确认策略组可用,再启用系统代理。只有需要接管更多应用时才配置服务模式与 TUN;防火墙提示、端口占用和残留代理应分别排查。归档客户端仅用于兼容旧环境,不应把停止维护的软件作为新设备的默认选择。
前往下载客户端负责导入配置、呈现开关和管理连接;mihomo 内核负责解析规则、建立代理连接和处理 DNS。先分清两者,再决定需要调整哪一层。以下片段用于理解语法,不是可直接替换订阅的完整配置。
规则模式把域名、地址或规则集映射到处理策略。内核从上到下检查,命中后停止继续匹配,因此具体域名通常放在宽泛规则之前,兜底规则放在最后。DIRECT 表示直连,REJECT 表示拒绝;代理策略则需要引用配置中实际存在的节点或策略组。与全局模式相比,规则模式可分别安排不同业务的出口。遇到网站路径不符合预期时,先查看连接记录中的命中规则,再修改顺序,避免同时改动多个条件。
mode: rule
rules:
- DOMAIN-SUFFIX,example.org,DIRECT
- DOMAIN,blocked.example,REJECT
- MATCH,DIRECT
阅读规则语法与优先级 →
策略组为规则提供稳定的目标名称,组内可以放节点,也可以引用其他策略组。手动选择适合固定业务出口,自动测试适合根据测试结果挑选可达路径。测试延迟只反映指定地址的一次请求过程,不等同于下载带宽或所有网站的访问速度。导入订阅后,应先确认组内存在可用选项,再检查规则是否引用该组。示例只展示手动组结构;实际使用时可用配置内已有的节点名替换直连选项,并保持名称完全一致。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
rules:
- MATCH,PROXY
了解延迟测试的适用范围 →
DNS 决定域名如何得到地址,规则决定连接如何选择出口,两者需要配合检查。开启内核 DNS 并不代表系统和所有应用都会使用它;浏览器安全 DNS、系统解析缓存与其他网络工具都可能改变实际路径。fake-ip 模式用映射地址保留域名信息,兼容性问题则需要结合特定应用排查。示例只启用本地监听与基础解析。调整前记录原设置,修改后重新建立连接,确认解析请求确实到达预期入口,而不是仅观察网页能否打开。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
nameserver:
- 223.5.5.5
查看指南中的 DNS 设置 →
系统代理适用于遵循代理设置的应用,TUN 则通过虚拟网络接口与路由接管更广范围的连接。它适合需要统一处理应用流量的场景,但也会涉及系统权限、网卡与 DNS 路径。启用前先保证普通代理连接正常,再授予客户端所需的服务权限。自动路由不是所有环境的通用答案,已有 VPN、虚拟机网络或旁路由时尤其需要检查路由冲突。出现断网应先关闭 TUN 恢复原路径,再查看日志,而不是反复切换节点。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
查阅 TUN 模式概念 →
YAML 依靠缩进表达层级,键名、列表符号和策略引用都可能导致载入失败。订阅更新通常会重新生成配置,直接修改生成文件可能在下次更新后丢失;需要长期保留的规则应优先使用客户端支持的覆写功能。排错时先记录错误行、当前配置和触发操作,再逐项恢复。日常保持适量日志即可,临时提高日志级别后应及时还原。分享日志前删除订阅地址、认证信息与个人访问记录,只保留能够说明问题的上下文。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: false
查阅配置与故障问题 →
先确定操作系统和处理器架构,再比较客户端界面与功能。客户端名称相近,不代表安装包、配置扩展和更新方式完全相同。初次安装可从 Clash Plus 开始比较;Linux 桌面用户可优先查看 Clash Verge Rev。安装包详情集中在下载页,主页只提供平台入口。
先在系统信息中查看处理器类型。安装后导入订阅,确认策略组可用,再启用系统代理。只有需要接管更多应用时才配置服务模式与 TUN;防火墙提示、端口占用和残留代理应分别排查。归档客户端仅用于兼容旧环境,不应把停止维护的软件作为新设备的默认选择。
前往下载在“关于本机”中确认 Apple 芯片或 Intel 处理器,下载对应构建。首次运行时按系统提示授权网络相关功能,随后检查菜单栏状态和当前配置。休眠唤醒、切换网络后若连接异常,先查看代理与网络服务状态。ClashX Meta 的归档入口与维护中的客户端在下载页分开标示。
前往下载优先使用匹配设备架构的安装包。启动连接时需要确认系统 VPN 授权;同一用户空间通常不能同时运行多个 VPN 服务。后台连接中断时,检查电池优化、后台活动与厂商省电限制。分应用代理和全设备接管是不同范围的设置,修改后应使用目标应用实际验证。
前往下载Clash Plus 通过 App Store 安装,产品官网为 clashplus.io。导入服务提供方支持的配置后,确认系统 VPN 授权与策略选择。连接能否建立还取决于订阅有效性、节点可达性及当前网络;系统 VPN 标识表示连接状态,不能单独证明所有请求都按预期分流。
前往下载桌面环境可选择 Clash Verge Rev 或 FlClash,并确认发行版使用的包格式。系统代理设置是否生效取决于桌面环境和应用支持,命令行工具也可能需要单独配置。服务器与路由器用户可查看 mihomo 内核入口,自行安排服务管理、配置目录和权限,不必安装桌面界面。
前往下载客户端不是代理服务本身。开始前准备有效的订阅地址或配置文件,并确认服务提供方支持所选客户端的配置格式。不要把订阅地址提交到不熟悉的转换网站;地址中可能包含用于访问账户资源的认证信息。
打开客户端的配置或订阅页面,选择通过链接导入或从本地文件导入。保存后等待配置载入,查看是否出现代理组和节点。若提示解析错误,先确认下载到的是配置文本,而不是登录页面、错误提示或其他客户端格式;暂时不要继续开启系统代理。
在代理组中选择可用出口,日常使用先采用规则模式。桌面端先开启系统代理,移动端按提示允许 VPN 连接。需要 TUN 时再单独启用并检查权限。一次只改变一项设置,保留可恢复的原始状态,便于区分节点问题与本机路由问题。
访问实际需要使用的网站或应用,同时在连接页查看命中规则与出口。再测试一个应当直连的目标,确认分流不是全量走同一路径。延迟测试通过但页面打不开时,继续检查 DNS、目标服务与应用代理支持。退出客户端前关闭系统代理,避免留下不可达的本地入口。
选择客户端时,区分项目名称、内核能力与服务提供方。界面上的同一个开关,在不同客户端中可能使用不同实现;是否支持某项配置,应以实际内核和对应项目文档为准。
Clash 生态由代理内核、图形客户端和配置工具等不同项目组成。原始 Clash 项目停止公开维护后,社区继续围绕兼容配置与新功能开发相关实现。mihomo 延续了 Clash Meta 的内核发展路线。名称里带有 Clash 的客户端不一定由同一团队维护,也不意味着都使用同一个内核。判断项目状态时,应查看它自己的发布记录、问题讨论和文档,而不是只比较名称。
mihomo 代码以 GPL-3.0 许可发布,仓库提供源代码、问题跟踪和发布记录。这些资料可以用于理解功能变动、定位已知问题以及确认配置语法。内核的开源许可不自动代表每个图形客户端、商店应用或订阅服务采用相同授权方式。使用、修改或分发代码时,应阅读相关项目的许可条款;普通使用者则可把公开文档作为排错依据,不需要先自行编译。
图形客户端负责把操作转成配置,并展示日志、连接和策略选择;内核执行实际流量处理;订阅服务提供节点与相关参数。客户端安装成功不代表订阅已经有效,节点测试通过也不保证某个业务一定可用。遇到问题时,先确定失败发生在配置下载、配置解析、网络接入还是远端连接这一层。这样可以避免把账户过期、目标站限制与本机设置混为一谈。
客户端更新、内核更新、订阅更新和规则数据库更新是不同操作。更新前保存当前可用配置与自定义覆写,阅读变更说明,再验证原有规则和常用应用。若新配置载入失败,先恢复上一份能工作的配置;若只有某个网站异常,先查看命中规则,不必立即重装整个客户端。长期保留的自定义设置应放在客户端明确支持的覆写入口,避免在订阅刷新时被覆盖。
先完成基础连接,再按问题查阅专题。延迟数值、系统代理状态与规则命中记录分别描述不同环节,不能用单一指标判断整条连接是否正常。
拆解 URL Test 的握手过程、测试地址选择与超时机制。说明低延迟不等于高带宽,以及如何结合网页请求、文件传输和实际业务判断节点质量。
阅读文章 →从安装包选择、服务模式授权到系统代理生效逐步说明。整理安全软件拦截、端口占用与 UWP 回环等情况,按故障发生位置缩小检查范围。
阅读文章 →介绍 geodata 文件来源、自动更新配置项与手动替换步骤。结合 GEOIP、GEOSITE 的匹配用途,说明数据库载入与规则顺序需要分别确认。
阅读文章 →