开源社区 · 全平台客户端

Clash 客户端下载与配置文件参考

从客户端选型到规则分流,把 config.yaml 常用字段与实际操作放在一起查。

代码开源YAML 配置中文文档
config.yaml YAML

config.yaml

Clash开源社区 · 配置工作区

端口与模式

mixed-port: 7890allow-lan: falsemode: rulelog-level: info

DNS

enable: trueenhanced-mode: fake-ipnameserver:- 223.5.5.5- 119.29.29.29

代理节点

name: 示例节点type: ssserver: example.comport: 443udp: true

策略组

select url-test fallback load-balance

规则

DOMAIN-SUFFIXDOMAIN-KEYWORDGEOIP,CN,DIRECTMATCH,PROXY

覆写与合并

prepend-rulesappend-proxies合并顺序

延伸入口

字段摘录,非完整配置;覆写键由客户端解释。

字段速查 / CONFIG

config.yaml 里
最常改的六段

先分清输入、出口和匹配顺序,再改参数。端口负责接收连接,节点负责提供出口,策略组把出口组织起来,规则决定流量交给谁。

这些片段用于理解字段,不应逐段拼接后直接启用。节点名称、策略组名称与规则目标必须对应;不同内核和客户端的扩展能力,也要分别确认。

浏览器或其他应用需要一个本地代理入口,mixed-port 能在同一端口接受 HTTP 与 SOCKS 代理连接。先查看客户端显示的实际监听端口,再填写到应用设置中;端口不是节点服务器的端口。若启动日志提示地址已被占用,先退出另一个代理进程,再决定是否换号。仅在本机使用时保持局域网访问关闭。这里的 rule 表示按规则分流,并不代表系统已经把流量送进内核,系统代理或 TUN 仍需单独设置。

mixed-port: 7890
allow-lan: false
bind-address: "127.0.0.1"
mode: rule
log-level: info
ipv6: false
客户端下载 / PLATFORMS

按系统选择 Clash 客户端

先选操作系统,再确认处理器架构。图形客户端负责导入订阅、管理配置和控制内核;只有命令行内核时,还需要自行安排配置路径、启动参数和系统服务。日常桌面与手机使用,通常从图形客户端开始更容易定位问题。

Windows

适合需要托盘管理、系统代理和可视化规则面板的桌面用户。下载页按 Clash Plus、Clash Verge Rev、FlClash 等客户端列出入口,也保留 Clash for Windows 的归档说明。

从旧客户端迁移时,优先备份订阅地址与自定义规则,不要直接复制整个程序目录。若安装后能启动但应用不走代理,先检查系统代理开关、实际端口与应用自己的代理设置,再考虑启用 TUN。

前往下载 Windows 客户端

macOS

先在“关于本机”中确认是 Apple Silicon 还是 Intel,再选对应安装包。Clash Plus、Clash Verge Rev 与 FlClash 提供不同的界面和配置管理方式,具体系统要求以下载页说明为准。

系统代理与终端环境变量是两条不同的路径。浏览器连接正常,不代表命令行工具也已经使用代理;终端访问异常时,应核对该工具支持的代理参数。安装辅助服务涉及权限,按客户端提示逐项处理即可。

前往下载 macOS 客户端

Android

手机用户可从 Clash Plus、Clash Meta for Android、FlClash 与 Surfboard 中选择。注意客户端支持的订阅格式并不完全相同,文件能下载成功,只说明获取完成,不说明其中所有字段都能被识别。

首次启动连接时需要确认系统的 VPN 授权。若锁屏后连接中断,先检查系统电池管理和后台运行限制;同时运行另一个使用 VPN 通道的应用,也可能产生冲突。按应用分流时,记得核对被选应用属于包含还是排除列表。

前往下载 Android 客户端

iOS

下载页提供 Clash Plus 的 App Store 入口,并列出官网 clashplus.io。安装后按界面提示导入支持的配置,确认策略组中存在可选节点,再允许系统添加 VPN 配置。

切换无线网络和蜂窝网络后,解析环境与可用出口可能变化。遇到网页停留在加载状态,先区分是订阅无法刷新、节点连接失败,还是某个域名的规则不合适。不要把桌面客户端的扩展脚本默认视为手机端也能直接运行。

前往下载 iOS 客户端

Linux

桌面环境优先查看 Clash Verge Rev 与 FlClash,服务器或路由器用户再考虑 mihomo 内核。软件包格式、处理器架构和发行版运行环境需要一起确认,不能只看文件名里是否有 Linux。

命令行工具通常需要单独设置代理环境变量;系统服务也不会自动继承当前终端的设置。启用透明接管前,先用本地代理端口验证基本连接,再检查路由、DNS 与防火墙,避免把多层网络变化混在一次修改里。

前往下载 Linux 客户端

安装包解决的是运行环境,订阅解决的是连接参数。本站整理客户端与配置知识;安装软件后,仍需自行准备有效且获授权的节点或订阅。不要在公开截图、问题反馈和共享配置里暴露订阅地址或认证信息。

查看全部客户端 →
开源生态 / SOURCE

Clash、客户端与 mihomo

这三个名字经常一起出现,但不是同一个东西。选客户端看操作体验,查字段看内核文档,排故障看实际运行配置。把层次分开,许多“换软件就好了”的问题才能找到具体原因。

查看 mihomo 开源仓库 ↗

从 Clash 项目到持续发展的生态

Clash 以规则驱动的代理内核和 YAML 配置形成了广泛使用的工作方式。原 Clash 项目及部分早期图形客户端停止维护后,社区沿着不同方向继续发展:有的专注界面和订阅管理,有的继续扩展内核协议与规则能力。因此,“Clash 配置”更像一个生态中的常用说法,而不是保证所有软件都支持同一组字段的兼容承诺。

Clash for Windows 停更后,替代方案应按正在维护的客户端、系统支持与配置迁移成本选择,而不是只按界面是否熟悉来判断。旧教程里的菜单位置、辅助服务安装方式和字段默认值,可能已不适用于当前客户端。保留旧配置作为参考是有用的,但重新导入后仍要检查解析结果、策略组引用与系统接管方式。

图形界面和内核各管一段

图形客户端通常负责订阅下载、配置切换、托盘操作和日志展示;mihomo 等内核负责解释配置、匹配规则、解析域名及建立连接。界面上看得到某个开关,不代表配置文件里一定存在同名字段;反过来,内核支持的扩展参数,也不一定能在每个客户端界面中直接编辑。查阅时应同时确认客户端名称和内核类型。

mihomo 在 Clash 生态的配置方式上继续扩展,项目采用 GPL-3.0 许可,源码、变更与问题讨论可以在仓库查阅。这个许可描述的是相应开源项目,不应被直接套用到所有第三方界面、商店应用或配套服务上。本站以社区资料整理为定位,客户端发行、商店信息和功能边界仍由各自项目决定。

更新前看变化,更新后看结果

客户端更新、内核更新和订阅刷新是三件不同的事。更新客户端可能改变界面与系统集成,更新内核可能影响字段解析和连接行为,刷新订阅则主要改变节点与规则来源。遇到异常时,先记录最近改变的是哪一层,避免把订阅错误归因于安装包,也避免为了一个失效节点反复重装软件。

比较稳妥的做法是保留当前可用配置,一次只改一类设置,重新加载后查看日志是否报错,再验证目标应用的实际请求。测试节点时固定测试条件,连接失败时记录时间、目标域名和命中规则。分享日志前移除服务器认证信息与订阅参数;可复现的步骤通常比一张只有红色报错的截图更有帮助。

源码查阅 · 需要本机已安装 Git

git clone https://github.com/MetaCubeX/mihomo.git

克隆用于阅读源码与文档,不会自动安装客户端,也不会提供可用节点。只想日常使用时,选择下载页里的图形客户端即可。

近期文章 / NOTES

订阅导入与连接排查

先判断问题发生在获取配置、解析配置,还是建立连接的阶段。文章按具体场景展开,不要求先读完全部字段文档;带着报错和实际配置去查,通常更容易找到下一步。

下载客户端