客户端安装 · 订阅配置 · 中文文档

Clash 客户端下载与配置

按系统选择客户端,完成订阅导入、系统代理与规则分流设置,再通过日志确认连接路径。

  • 中文文档
  • 开源内核
  • 多平台配置
代理内核mihomo规则与协议处理
开源协议GPL-3.0适用于 mihomo 内核
配置格式YAML导入前检查兼容性
配置结构

订阅、规则与连接出口

客户端提供设置界面,内核负责处理连接,订阅提供可用的配置内容。先区分这三个部分,再调整代理模式,能更快判断问题发生在哪一层。下面的设置示例用于理解字段关系;实际可用功能以所选客户端及其内核文档为准。

配置能力

Clash 规则与订阅管理

按匹配顺序决定出口

规则模式根据域名、目标地址等条件选择连接出口,首条匹配规则生效。相比把所有连接交给同一个出口,可以分别安排本地服务、开发工具与其他访问需求。修改时将更具体的条件放在前面,兜底规则放在最后,并确认规则引用的代理组已经定义。遇到访问异常,先在连接记录中查看命中项,再判断应该修改规则还是调整代理组;仅切换节点并不能修正规则顺序错误。

# PROXY 需是已定义的代理组
mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY
安装包入口

按系统选择 Clash 客户端

查看全部客户端

先确认操作系统与处理器架构,再比较客户端的配置管理方式。桌面端通常以系统代理作为起点;移动端需要理解系统 VPN 授权;服务器或路由器用户则可能直接使用内核。安装包名称相似不代表系统要求一致,旧设备尤其需要查看下载页中的兼容说明。客户端本身不提供可用的代理服务,安装完成后仍需准备合法取得、且与所选内核兼容的订阅或配置文件。

Windows

适合桌面浏览器、开发工具与日常软件。先按设备架构选择安装包,导入订阅后开启系统代理;需要接入更多应用时再配置 TUN 服务。遇到商店应用访问异常,要区分 UWP 回环限制与一般网络故障,不必立即重装客户端。

前往下载

macOS

安装前在系统信息中确认是 Apple Silicon 还是 Intel 处理器。首次启动按系统提示完成应用与网络权限设置,再检查当前网络服务的代理是否生效。切换无线网络或启用其他 VPN 后,应重新验证路由与 DNS,避免将网络切换问题归因于订阅。

前往下载

Android

根据手机架构选择安装包,首次启动连接时确认系统 VPN 授权。后台运行受系统电池策略影响,息屏后连接中断可先检查后台活动权限与省电设置。若同时安装了其他 VPN 类应用,应明确当前由哪一个应用接管网络,再判断连接结果。

前往下载

iOS

通过下载页进入 Clash Plus 的 App Store 页面,产品官网为 clashplus.io。安装后导入兼容配置,并按系统提示添加 VPN 配置。系统显示 VPN 状态只说明网络扩展已启用,是否经过预期出口仍需结合规则与访问记录确认。

前往下载

Linux

桌面用户可根据发行版的包管理方式选择图形客户端,命令行工具还需单独确认代理环境变量。图形桌面的系统代理设置未必会传递到终端或后台服务。准备使用 TUN 时,先核对服务权限、路由和已有网络管理工具,逐项启用更便于定位故障。

前往下载

下载页按平台列出客户端及系统要求;安装、服务权限和平台差异集中在 全平台指南,已有可用配置的用户可以直接进入下方的连接步骤。

快速上手

从订阅导入到连接验证

查看完整教程

首次配置建议保持变量尽可能少:只启动一个代理客户端,先使用一份已知可用的配置,不同时修改 DNS、规则与虚拟网卡。完成一次可复现的连接后,再逐步加入自动启动或个人覆写。每次只改一个设置,出错时就能回到上一个正常状态。

  1. 导入并选中订阅

    在配置管理中新增远程配置,粘贴服务提供方给出的完整地址,等待内容获取完成。随后选中这份配置,确认代理组与规则已加载。只有导入记录却没有激活配置时,主界面的开关可能已经打开,但内核仍未使用预期内容。若订阅更新失败,先核对地址是否包含多余空格、订阅是否过期,再查看客户端日志;不要反复删除所有设置。

    查看订阅导入步骤 →
  2. 选择规则模式与接入方式

    将代理模式设为规则,在需要手动选择的代理组中选定出口,再开启系统代理。全局模式适合短时对比排查,不应把它当作修复所有问题的开关。只有确认目标应用不遵循系统代理时,再考虑 TUN。启用 TUN 后仍然需要有效规则与可用出口,虚拟网卡只改变流量如何进入内核,不会替代订阅中的连接参数。

    查看系统代理设置 →
  3. 检查规则命中与实际访问

    打开一个预期经过代理的网站,在客户端的连接记录中核对域名、命中规则与出口。再访问本地网络服务,确认直连需求也得到保留。延迟测试成功只证明测试请求能够完成,不能代替真实网页、下载或应用场景验证。若浏览器正常而某个应用失败,应优先检查该应用的代理接入方式;若所有访问都失败,再从订阅、DNS 与本地端口逐项排查。

    查看规则与验证说明 →
开源生态

内核来源与更新边界

查看 Mihomo 项目

Clash、Meta 与 Mihomo 的关系

Clash 生态由规则代理内核及围绕内核构建的客户端组成。原 Clash 项目停止维护后,社区继续发展不同的兼容实现;Mihomo 承接了 Clash.Meta 的项目脉络,支持在兼容配置基础上扩展协议、规则和 DNS 能力。搜索结果里仍可能同时出现这些名称,因此判断兼容性应以客户端实际内核为准,而不是仅凭产品名称包含 Clash 就认定功能相同。

开源项目的仓库可以查阅代码、提交记录、议题与许可证,适合核对某个字段是否受到支持,或确认故障是否已有讨论。社区项目并非一个统一团队维护:内核、图形界面、订阅服务各有自己的更新节奏。本站整理下载入口与操作文档,品牌名称不代表对所有上游项目的共同维护关系;具体发布来源与授权范围应以对应项目说明为准。

客户端、内核与订阅分别更新

更新客户端通常改变界面、系统集成或打包的内核;更新订阅则重新获取服务提供方的配置内容,两者不能互相替代。某些客户端内置内核,另一些提供独立更新入口,执行前应阅读各自的发布说明。遇到配置无法解析时先确定是语法不兼容还是远程内容异常,再决定需要更新软件、修订配置或联系订阅提供方,避免在多个层面同时改动。

升级前保留当前能使用的配置与个人覆写,并记录代理模式、接入方式等关键设置。升级后先验证配置是否加载,再检查日常访问与局域网服务;必要时比较日志中的变化。旧客户端即使能够启动,也可能缺少新协议或系统兼容修复。已停止维护的应用适合用于理解历史配置,日常使用应优先考虑仍在维护、并与当前系统匹配的选择。

规则可复用,访问凭据需单独保护

开源指代码可以按许可证查阅和使用,不等于代理服务免费,也不表示订阅内容可以公开分享。订阅地址通常携带账户访问能力,配置文件还可能包含服务器认证信息。提交故障报告时可保留报错字段、规则顺序与运行环境,但应移除订阅地址和认证内容。只给出经过整理的最小复现片段,比发布完整配置更便于讨论,也更容易定位问题。

使用心得

连接验证与故障排查

查看全部文章

下面的文章分别处理首次连接、节点超时与延迟测试三个常见场景。先根据现象选择排查路径:尚未确认代理生效时,从连接验证开始;同一配置在多次请求中失败时,再排查超时原因;仅测试数字与体感不同,则需要区分往返耗时、吞吐量与丢包。保留问题发生时的日志,比频繁重新导入订阅更有帮助。