Windows 客户端
优先查看 Clash Plus,也可比较 Clash Verge Rev、FlClash 与 Clash Nyanpasu。安装后先导入配置,再开启系统代理;需要接管游戏或命令行连接时,再检查 TUN 授权。已有软件占用监听端口时,应先处理冲突,再做连接测试。
前往下载 →CLIENT DOWNLOADS
先确认系统和处理器,再选择客户端。桌面与移动端的授权方式不同,订阅配置也需要与客户端支持的格式对应。
优先查看 Clash Plus,也可比较 Clash Verge Rev、FlClash 与 Clash Nyanpasu。安装后先导入配置,再开启系统代理;需要接管游戏或命令行连接时,再检查 TUN 授权。已有软件占用监听端口时,应先处理冲突,再做连接测试。
前往下载 →在苹果菜单中打开「关于本机」,看到 Apple 芯片名称就选择 Apple 芯片安装包,看到 Intel 则选择 Intel 安装包。下载页首推 Clash Plus,并列出 Clash Verge Rev 与 FlClash;ClashX Meta 作为归档选项保留。
将应用移入「应用程序」后启动,按系统提示确认网络相关授权。先用系统代理验证浏览器连接,再按应用需求开启 TUN。切换网络后若无法访问,优先检查配置是否启用、代理模式是否正确,以及系统中是否还有其他代理工具运行。
前往下载 →可从 Clash Plus、Clash Meta for Android、FlClash 与 Surfboard 中选择。安装包架构要与设备匹配,首次连接时确认系统 VPN 授权。后台断连还应检查电池优化设置;不同客户端的订阅格式支持范围需要分别确认。
前往下载 →通过下载页进入 Clash Plus 的 App Store 页面,产品官网为 clashplus.io。导入订阅并选择配置后,按提示添加 VPN 配置。遇到某个应用无法连接,先查看所选策略及规则命中,再决定是否调整分流。
前往下载 →桌面环境可选择 Clash Verge Rev 或 FlClash,按发行版选择软件包格式。系统代理是否被应用读取,取决于应用自身实现;服务器与路由器用户可到内核区查看 mihomo,并自行管理服务权限、配置路径与监听范围。
前往下载 →MIHOMO CONFIGURATION
以 macOS 窗口示意阅读常用配置。界面名称随客户端有所差异,字段含义以正在使用的 mihomo 内核文档为准。
proxy-groups:
- name: Proxy
type: select
proxies:
- Auto
- DIRECT
- name: Auto
type: url-test
use:
- subscription
url: https://www.gstatic.com/generate_204
interval: 300
tolerance: 50打开客户端的代理页,先确认规则使用的是哪个策略组,再选择手动策略或自动测试组。select 用于保留明确选择,url-test 按指定地址的测试结果在候选项中选优,适合网络环境经常变化的设备。两者可以嵌套:外层控制使用哪种方式,内层负责周期测试。测试结果只反映当时到测试地址的表现,不等于所有网站的实际体验。示例中的订阅提供器需要在完整配置里定义,不能仅复制这一段就开始连接。
rule-providers:
local:
type: file
behavior: classical
format: yaml
path: ./rules/local.yaml
rules:
- DOMAIN-SUFFIX,apple.com,DIRECT
- RULE-SET,local,DIRECT
- GEOIP,CN,DIRECT
- MATCH,Proxy在规则页查看匹配顺序,把需要优先处理的域名放到兜底规则之前。规则集通过 rule-providers 管理来源,再由 RULE-SET 引用,适合将工作服务、直连域名与公共分类分开维护。本地文件和远程订阅是不同来源类型;切换为远程来源时,还要设置地址与更新间隔。与逐行追加规则相比,订阅化管理便于独立更新,但仍需核对规则集的行为类型和内容格式。排查时应以连接详情中的命中记录为准,避免只看规则名称推断结果。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
先在设置里开启系统代理,用浏览器访问目标站点验证配置。系统代理适用于遵循系统网络设置的应用;需要接管其他连接时,再启用 TUN,并完成客户端要求的服务安装或系统授权。TUN 通过虚拟网卡和路由处理流量,涉及 DNS、默认出口以及其他 VPN 的兼容性,排查范围比系统代理更广。两种入口都不会替代规则模式本身。若开启后网络异常,先关闭 TUN 恢复原路径,再逐项检查路由与解析,避免同时修改多个开关造成原因难以定位。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "localhost.ptlogin2.qq.com"
nameserver:
- https://dns.alidns.com/dns-query在配置页确认 DNS 已启用,再检查解析请求是否确实进入内核。Fake-IP 为域名返回映射地址,连接进入内核后再还原域名,有助于按域名规则处理流量;它不是目标服务器的真实地址。遇到局域网服务或依赖真实解析结果的应用,可按具体域名添加过滤项,再清理相关缓存重新验证。与只更换 DNS 服务器相比,这里还要关注应用自带的加密 DNS、TUN 的请求接管和解析出口。示例仅展示字段关系,解析服务应结合所处网络的可达性选择。
初次使用时,按「配置已启用、策略可用、规则模式、系统代理」的顺序逐项确认。先让浏览器完成一次连接,再到连接页检查目标域名、命中规则与出口策略。若记录没有出现,说明流量可能尚未进入客户端;若记录已经出现却连接失败,则继续检查策略选择、解析结果与上游可达性。这样能把入口问题和出口问题分开,避免反复重装应用。
需要自己的分流逻辑时,优先使用客户端提供的本地覆写功能,将工作域名、局域网例外和固定策略单独保存。直接改订阅下载得到的配置,更新后可能被覆盖。每次只修改一类参数,并保留能够连接的配置副本;出现问题即可回退,对比修改前后的行为。字段含义、组合限制和更完整的 YAML 示例见 mihomo 进阶配置手册,第一次导入则从 订阅导入教程 开始。
OPEN SOURCE CONTEXT
把客户端、内核和订阅分开理解,更新、迁移与排错都有明确的检查位置。
在客户端中点击导入、切换策略、查看连接,操作的是图形界面;实际解析配置、处理规则和建立代理连接的工作由内核承担。mihomo 延续并发展了 Clash Meta 的相关工作,因此教程中会同时遇到 Clash、Clash Meta 与 mihomo 这些名称。名称接近不代表每个客户端拥有相同的功能入口,也不代表较早的内核能够读取当前文档中的所有字段。遇到配置报错,应先核对正在运行的内核,再查看客户端如何传入配置。
选择客户端时,重点比较系统兼容性、配置管理方式、覆写能力与授权流程。相同内核的两个客户端,默认设置、菜单组织和服务安装方式仍可能不同。迁移时可以复用兼容的订阅,但系统代理、开机启动、TUN 权限和本地覆写需要在新客户端中重新确认。将旧客户端退出后再测试新客户端,可以减少监听端口、系统代理和虚拟网卡之间的相互干扰。
Clash 生态中既有仍在演进的内核与界面,也有停止维护的历史客户端。早期教程的截图仍有参考价值,但其中的下载位置、配置字段和系统权限说明可能已经变化。下载页将归档客户端与当前可选客户端分别标注,便于已有配置的用户做兼容性判断。新安装设备应优先从持续维护的选项开始,旧配置迁移则先保留原文件,再逐段检查端口、DNS、策略组和规则引用。
旧界面能够启动,并不等于它能处理新的配置语法;同样,新内核支持某个字段,也不代表客户端界面已经提供对应开关。配置载入失败时,先读日志中的字段名和行号,检查 YAML 缩进、策略组名称以及提供器引用是否对应,再考虑功能兼容性。将问题缩小到一个字段或一个最小片段,比一次替换完整配置更容易确认原因。
mihomo 源码在 MetaCubeX 的公开仓库中维护,内核采用 GPL-3.0 许可。仓库中的文档、提交记录和问题讨论可以帮助确认功能变化;不同图形客户端的代码与许可应分别查看对应项目。站点整理下载入口与中文操作路径,客户端、内核和订阅服务则由各自的维护方提供。准备报告问题时,需要区分是界面按钮无法操作、配置没有正确传递,还是内核已经接收连接却处理失败。
提交日志前,先移除订阅地址中的凭据、服务器信息和能够关联个人身份的内容。可以保留系统类型、处理器架构、操作步骤、报错文本以及经过脱敏的最小配置,让问题具有可复现性。若准备阅读或构建内核,可复制旁边的命令取得源码;普通使用者直接选择图形客户端即可,源码获取不属于安装客户端的必需步骤。
应用更新通常涉及界面、系统集成或随附内核;订阅更新则重新获取连接参数、策略或规则,两者是独立过程。更新应用之后,应确认原配置仍被启用,并检查权限与服务是否正常。更新订阅之后,则应关注自选策略是否仍然存在、本地覆写是否继续生效,以及规则集是否成功加载。将两种更新分开验证,便于发现是哪一次变化影响了连接。
建议先保存可用配置和本地覆写,再进行影响范围较大的调整。网络环境、订阅内容与客户端设置同时变化时,单看能否打开一个网页很难定位问题。保留一条固定的验证路径:打开目标站点、查看连接记录、核对规则命中、确认出口策略。测试结束后恢复日常模式,避免把临时全局设置带入后续使用。
打开客户端的配置页,选择新建或导入,粘贴兼容的订阅 URL,等待下载完成后启用该配置;再进入代理页确认策略组。按钮名称可能略有区别,按 订阅导入步骤 核对操作顺序。
先用系统代理验证遵循系统设置的应用。其他应用需要接管时,再按客户端说明配置 TUN,并检查权限、路由和 DNS。两种入口的作用范围有差异,具体排查方法见 进阶配置手册。
优先把规则写入客户端的本地覆写或合并配置,而不是直接修改订阅生成的文件。更新后在连接页验证规则命中,确认自定义项仍位于兜底规则之前。常见配置问题可到 帮助中心 继续查阅。
先观察该应用的连接是否进入客户端。有记录就检查命中规则、所选策略与 DNS;没有记录则检查应用代理设置或接管方式。命令行工具可能需要单独设置代理环境变量,更多分支见 故障排查问答。
CONFIGURATION NOTES
从看懂配置字段到检查分流结果,按具体问题继续阅读。
以 GEOIP、GEOSITE 与规则集为基础,搭建直连、代理和广告拦截的组合。通过连接记录核对命中规则,区分规则顺序问题与出口连接问题,再按站点需求补充例外。
阅读分流实战 →从域名后缀、地址段到规则集引用,逐项说明常用语法与 no-resolve 参数。理解自上而下的匹配顺序,再决定自定义规则应插在哪里,避免例外规则被前面的宽泛条件覆盖。
阅读规则语法 →沿配置文件的书写顺序,理解通用设置、DNS、代理定义、策略组与规则集的关系。先找字段负责的环节,再检查相邻段落中的名称引用,让日志报错能对应到具体配置位置。
阅读配置说明 →