Windows
适合需要桌面图形界面、系统代理控制和开机运行管理的用户。下载页会依次列出 Clash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu 与归档客户端,并说明各自适用范围。
Platform entries
首页只负责定位平台。具体客户端、处理器架构、系统要求和安装包入口统一放在下载页,避免在多个位置维护重复文件链接。
适合需要桌面图形界面、系统代理控制和开机运行管理的用户。下载页会依次列出 Clash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu 与归档客户端,并说明各自适用范围。
安装前先在“关于本机”确认 Intel 或 Apple Silicon 芯片。相同客户端的两种构建不能混用,下载页将架构入口分开列出,并补充首次启动、系统代理和权限确认时需要注意的步骤。
移动设备通常优先选择 ARM64 构建;无法确认架构时,可根据下载页的通用包说明进行判断。客户端需要通过系统 VPN 接口接管流量,连接状态、后台限制和省电策略会直接影响持续运行。
iPhone 与 iPad 通过 Clash Plus 使用对应配置,下载入口指向 App Store,官网信息以 clashplus.io 为准。首次连接时系统会请求添加 VPN 配置,完成授权后再回到客户端选择策略组。
桌面环境可选择带图形界面的客户端,服务器、软路由或容器环境则更适合直接运行 mihomo 内核。两类方案的配置格式相近,但服务管理、权限、日志位置与流量转发路径明显不同。
Configuration lanes
把常见能力拆成五条配置泳道。选择左侧项目后,右侧说明对应问题、使用方法和需要留意的边界。
Clash 会按配置中从上到下的规则匹配域名、目标 IP、进程或规则集,再把连接交给直连、拒绝或指定策略组。它解决的是“不同流量采用不同处理方式”的问题,而不是让所有请求固定经过同一出口。使用时应先确认当前模式为规则模式,再检查命中的规则和策略组选择。
与只有单一开关的代理工具相比,规则体系的优势在于可以持续维护分类逻辑,但也要求规则顺序清晰。过宽的规则放在前面会遮蔽后续条目,因此排查时应查看实际命中结果,而不是反复切换节点。需要临时统一处理流量时可使用全局模式,问题定位完成后再恢复规则模式。
桌面或移动客户端主要负责配置导入、策略切换、系统接口控制和日志展示,真正解析配置并处理连接的是内核。原版 Clash 奠定了配置结构,Clash Meta 在此基础上扩展协议和规则能力,后续项目以 mihomo 名称继续维护。选择客户端时,需要同时确认界面程序包含或支持哪一种内核。
多数基础字段可以在同一配置体系内使用,但新内核扩展字段不一定能被旧客户端识别。迁移配置时应先保留原文件,再检查客户端日志中的字段解析提示。服务器或路由器用户可以直接运行 mihomo;普通桌面用户通常使用集成内核的 GUI 客户端更容易管理系统代理与更新。
Windows 与 macOS 桌面客户端通常通过系统代理接管支持代理设置的应用,也可以在内核和权限允许时使用 TUN 模式覆盖更多连接。Android 与 iOS 依赖系统 VPN 接口,因此首次连接会出现系统授权提示;Linux 则可能使用桌面代理、环境变量、透明转发或服务级部署。
平台差异会直接影响故障表现。例如浏览器可访问而命令行工具无法连接,常见原因是命令行没有继承系统代理;移动端锁屏后连接中断,则应检查后台运行和省电限制。选型时不能只比较界面外观,还要确认系统版本、处理器架构、网络接管方式和日常维护成本。
订阅地址用于获取配置内容,客户端会解析其中的代理项、策略组、规则和 DNS 设置。直接修改订阅生成的配置虽然快捷,但下次更新可能覆盖本地改动。更稳定的做法是保留原始订阅,把长期调整放入客户端支持的覆写、脚本或独立配置副本,并记录修改目的。
订阅更新失败时,应依次检查地址是否完整、当前网络是否能访问来源、返回内容是否为有效配置,以及缓存文件是否损坏。不要在一次排查中同时更换地址、内核、规则和 DNS;每次只改变一个条件,才能确认问题来自下载、解析还是运行阶段。
DNS 不只是把域名转换为 IP。Clash 的增强模式、nameserver、fallback、域名规则和系统 DNS 接管会共同影响解析结果与规则命中。出现网页打不开、部分域名异常或连接反复超时时,应先确认请求是否进入 Clash,再查看使用了哪个解析器以及返回结果是否符合预期。
排查时可从简化配置开始:保留一组明确可访问的主解析器,暂时减少复杂过滤条件,然后逐项恢复 fallback 与规则。只更换节点往往无法解决解析路径问题。移动端还要注意系统私有 DNS,桌面端则需检查浏览器安全 DNS和客户端 DNS 接管是否形成两条不同路径。
Quick start
先完成最短可运行路径,再处理规则、DNS 和自动更新。这样可以把安装问题与配置问题分开判断。
进入下载页后先选操作系统,再确认处理器架构。Windows 用户通常选择 x64 桌面客户端;macOS 必须区分 Intel 与 Apple Silicon;Android 设备以 ARM64 最常见;Linux 用户还要决定使用图形界面还是直接部署 mihomo 内核。
安装完成后先启动客户端并查看内核是否正常加载,不要立刻修改大量高级选项。如果系统提示网络、VPN 或防火墙权限,应根据当前平台完成授权,否则客户端界面虽然能打开,流量仍可能没有进入内核。
在配置或订阅页面粘贴有效地址,等待客户端下载并解析内容。成功后应看到配置名称、策略组与规则信息;若导入后列表为空,应先查看解析日志,不要把同一地址反复添加成多个配置。涉及敏感信息的订阅地址不应公开分享。
启用配置后进入策略组,根据配置提供的选项完成选择。初次使用建议保持规则模式,让域名和 IP 规则决定流量去向。全局模式适合短时间定位问题,但它会绕过原有分类逻辑,不适合作为所有故障的固定处理方式。
打开系统代理或按平台建立 VPN 连接后,先访问一个稳定站点,再检查客户端日志是否出现请求记录。能够看到请求但连接失败,说明流量已经进入内核,应继续检查策略和连接配置;完全没有日志,则优先检查系统代理、VPN 授权或应用自身代理设置。
确认基础连接可用后,再设置订阅更新周期、启动行为和 DNS 选项。每次调整只改变一项,并保留可回退的配置副本。这样在更新后出现异常时,可以快速判断是订阅内容变化、客户端升级还是本地设置造成的差异。
Open source context
理解项目之间的继承关系,比只看客户端名称更有助于判断配置兼容性、更新来源和问题归属。
Clash 建立了以 YAML 配置、策略组和规则分流为核心的使用方式,随后形成了覆盖桌面端、移动端和路由部署的客户端生态。不同客户端可能采用不同的界面框架和发布周期,但常见的配置结构、规则概念与策略操作来自同一技术脉络。原版项目停止持续维护后,既有客户端仍可运行,生态中的维护重点则逐步转向后续内核与新客户端。
开源仓库公开记录代码变化、问题讨论和发布说明,适合用于确认功能边界与版本变化。下载客户端时仍应区分“界面项目”“内核项目”和“配置提供方”:界面负责操作入口,内核负责网络处理,配置内容则来自用户选择的来源。三者并非同一个项目,出现问题时需要根据日志和行为判断应检查哪一层。
Clash Meta 扩展了原版 Clash 的协议、规则与 DNS 能力,后来以 mihomo 名称继续维护。许多新客户端把 mihomo 作为内置内核,因此能够读取常见 Clash 配置,并支持一部分扩展字段。兼容不代表所有字段在任意版本中都完全一致;使用新协议或高级 DNS 配置前,应确认客户端实际加载的内核及其支持范围。
客户端版本、内核版本和订阅内容各自独立更新。界面升级可能替换内置内核,订阅更新可能改变策略组与规则,本地覆写则可能继续作用于新配置。稳定维护的关键是记录这三类变化,不在发生异常时一次性全部更新。下载页读取发布清单提供当前安装入口,技术文章则按主题解释迁移与排查方法。
Selected questions
先确认平台、内核和流量接管方式,可以减少安装后反复更换客户端的成本。
需要常规桌面图形界面时,可先从下载页的首推客户端开始;如果现有配置依赖 mihomo 扩展字段,应确认客户端集成的内核类型。选型时同时考虑系统版本、处理器架构、更新状态和配置迁移方式,不要仅按界面截图判断。
查看完整客户端对比先查看客户端日志中是否出现应用请求。没有请求时检查系统代理、VPN 权限或 TUN 状态;有请求但连接失败时检查当前策略组、配置有效性和 DNS 解析路径。排查期间每次只修改一个条件,避免无法确认真正原因。
查看故障排查问答规则模式会按域名、IP 和规则集把请求分配到不同策略,适合日常使用;全局模式把大多数请求交给同一个策略,适合短时间验证某个出口是否可用。全局模式不能代替规则排查,测试完成后应根据配置目的恢复原模式。
查看模式设置步骤通常不需要。先确认订阅地址完整且仍可访问,再查看响应内容能否被当前内核解析,并检查本地缓存和系统时间。只有明确定位到客户端自身文件损坏或版本不兼容时,才需要考虑重新安装或更换版本。
阅读订阅更新排查顺序Latest references
从 DNS、启动故障和路由部署三个方向继续阅读。文章按排查顺序说明条件与边界,不用单一设置覆盖所有场景。
梳理 Clash DNS 请求路径、主备解析器分工、fallback 过滤条件及常见异常的排查顺序。
从损坏配置、权限限制、内核文件和系统组件四个方向定位客户端无法启动的问题。
比较主路由与旁路由方案,说明架构选择、设备资源、转发路径和日常维护边界。