Windows
日常桌面使用可先查看 Clash Plus,也可对比 Clash Verge Rev、FlClash 等客户端。安装前到系统的“设置 → 系统 → 系统信息”确认处理器类型,不要只凭电脑品牌判断架构。首次运行后,先导入配置,再在客户端打开系统代理;需要接管更多应用时,再阅读 TUN 的权限要求。
Clash for Windows 已停止维护,下载页将其列入归档。准备从旧客户端迁移时,先导出配置并记录端口和策略组选择,不要把旧程序目录整体覆盖到新客户端。
前往下载CONFIG / 配置笔记
从流量入口到规则出口,按字段理解客户端如何处理连接。
Clash 是一套以规则分流为核心的代理工具生态,不同客户端负责安装、配置管理和系统集成,内核负责实际处理连接。使用时不必一次读完全部配置:先确认配置能加载、策略组能选择,再逐项了解模式、DNS 和规则。下方示例展示独立的字段片段,适合对照现有配置阅读,并不是可以直接代替订阅的完整连接方案。
规则模式下,内核从上到下检查每一条规则,首次命中就交给指定策略。需要单独处理的网站应放在通用规则前面,最后用 MATCH 接住剩余连接。下面的 Proxy 是策略组名称,必须与配置中的定义完全一致。修改后可在客户端连接页查看目标域名、命中规则和实际出口;如果结果不符合预期,先检查规则顺序,而不是反复更换整个订阅。
rules:
- DOMAIN-SUFFIX,example.com,Proxy
- GEOIP,CN,DIRECT
- MATCH,Proxy
查看规则语法 →
rule 按规则选择出口,global 把进入内核的连接交给全局策略,direct 则直接连接目标。模式不会替代系统代理或 TUN 设置,也不代表所有应用已经接入内核。初次配置建议保留规则模式,遇到单个网站的问题再短暂切换全局模式对比。若两种模式都无法访问,应继续检查配置、策略组和网络,而不是把全局模式当成通用修复开关。客户端界面切换后的结果,以当前运行配置为准。
# 规则模式
mode: rule
# 其他可选值:global、direct
# mode: global
比较三种代理模式 →
Fake-IP 会为 DNS 查询返回用于映射的地址,内核据此把后续连接关联到原始域名,便于执行域名规则。它需要配合正确的流量接管和 DNS 路径,单独填写字段不等于系统查询已经进入客户端。遇到局域网设备或特定应用不兼容时,可针对域名设置过滤,再查看查询与连接记录。优先沿用客户端或订阅中已经适配的 DNS 方案,避免同时修改多个解析选项后无法判断问题来源。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
fake-ip-filter:
- "*.lan"
查阅 DNS 字段 →
策略组把规则和具体出口分开管理。select 组允许在界面中手动选择条目,规则只需指向组名,不必随着选择变化逐条修改。下面仅用内置 DIRECT 演示结构,因此所有选项仍然直连,不会产生远程代理能力。实际使用时,应从合法获取的配置导入可用节点,再把准确名称加入组中。若客户端提示找不到代理,先核对名称、大小写与引用关系,确认修改的确是当前启用的配置。
proxy-groups:
- name: Proxy
type: select
proxies:
- DIRECT
rules:
- MATCH,Proxy
查看策略组字段 →
YAML 通过缩进表示层级,列表前的短横线和冒号后的空格都影响解析。修改前先导出副本,每次只改一类字段并重新加载。订阅更新可能重新生成原始文件,需要长期保留的端口或规则,优先放进客户端支持的覆写或合并功能。不同客户端对数组替换、追加顺序的处理并不一致,保存后应查看运行配置确认结果。不要只根据编辑器中的文本判断内核已经采用了修改。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
# 缩进使用空格,不使用制表符
dns:
enable: true
打开配置字段参考 →
只想先完成连接?可以先看快速上手;需要解释某个名词时,打开术语表。上方窗口中的示例仅包含直连出口,目的是说明配置结构。
CLIENTS / 平台入口
先确认操作系统和处理器架构,再选择对应客户端。安装包与系统要求集中在下载页。
日常桌面使用可先查看 Clash Plus,也可对比 Clash Verge Rev、FlClash 等客户端。安装前到系统的“设置 → 系统 → 系统信息”确认处理器类型,不要只凭电脑品牌判断架构。首次运行后,先导入配置,再在客户端打开系统代理;需要接管更多应用时,再阅读 TUN 的权限要求。
Clash for Windows 已停止维护,下载页将其列入归档。准备从旧客户端迁移时,先导出配置并记录端口和策略组选择,不要把旧程序目录整体覆盖到新客户端。
前往下载在苹果菜单中打开“关于本机”,根据芯片信息选择 Apple Silicon 或 Intel 安装包。下载页提供 Clash Plus、Clash Verge Rev 和 FlClash 等选择。把应用移入“应用程序”后再启动,按实际弹窗完成系统代理或网络扩展授权;不同客户端需要的权限并不完全相同。
如果反复弹出钥匙串提示,先确认请求来自刚启动的客户端,再按教程检查授权记录。退出客户端后若网页仍不能打开,可到系统网络设置检查代理是否已经恢复。
前往下载下载页按顺序整理 Clash Plus、Clash Meta for Android、FlClash 与 Surfboard。选择安装包时留意设备架构;导入配置并启动后,系统会要求建立 VPN 连接,确认授权后状态栏通常会出现相应标识。该标识表示网络通道已建立,不等于配置中的每一个出口都可用。
需要后台持续运行时,检查系统的电池管理与后台限制。若使用 Surfboard,还应确认配置格式兼容,不能仅凭文件扩展名判断可以直接导入。
前往下载iPhone 与 iPad 用户可前往下载页打开 Clash Plus 的 App Store 入口,并查看官网 clashplus.io。安装后按客户端提供的入口导入订阅或配置,首次启用连接时同意系统添加 VPN 配置。授权完成后,再检查当前配置和策略组,避免把“允许添加配置”误认为已经完成全部连接设置。
移动网络和无线网络可能采用不同的 DNS 与网络限制。切换网络后若出现访问异常,先查看连接记录和配置状态,再按排查指南逐项验证。
前往下载桌面环境可选择 Clash Verge Rev 或 FlClash,按发行版的软件包格式查看安装入口。安装成功后,还要确认桌面环境中的系统代理设置是否生效;终端工具往往需要单独配置代理环境变量,不能仅凭浏览器能访问就判断所有程序都已经接入。
服务器与路由器用户可在下载页内核区查阅 mihomo。直接运行内核需要自行管理配置路径、服务权限和日志,初次接触时优先使用图形客户端理解配置关系。
前往下载QUICKSTART / 三步入门
先完成一个可验证的连接流程,再调整进阶选项。
打开客户端的“配置”或“Profiles”页面,选择通过链接导入,粘贴合法获取的订阅地址;已有 YAML 文件时,选择本地文件导入。等待下载与解析结束,再点选这份配置。界面通常会显示配置名称或更新时间;如果提示解析失败,应先检查链接是否返回配置文本,而不是账户登录页面。
订阅地址可能包含账户访问凭据,不要把完整地址发到公开讨论区。导入成功只说明文件能被识别,接下来仍要确认里面的策略组和出口可用。初次操作时保留原始文件,避免边导入边修改后难以回退。
进入“代理”或“策略组”页面,先选择规则模式,再在主要策略组里选定一个可用出口。有些配置包含多层策略组,需要继续展开查看最终选择;组名只是配置作者定义的标签,并不能直接说明连接是否正常。先保持原有规则和 DNS 设置,减少同时变化的因素。
桌面端随后开启系统代理,移动端按提示建立 VPN 连接。TUN 适合需要更完整接管流量的场景,但会涉及权限和路由设置;如果浏览器已经能按规则访问,不必为了“开全功能”同时打开所有接管选项。
在浏览器中访问一个已知可用的网站,再打开客户端的“连接”或“日志”页面,查看是否出现对应请求、命中哪条规则、最后使用哪个策略。能够看到请求但访问失败,应继续检查出口和 DNS;完全看不到请求,则先检查应用是否使用系统代理以及端口是否一致。
验证时每次只改一项,重新访问后比较结果。完成后记住暂停连接和恢复系统代理的位置,方便网络异常时退回原始状态。完整教程会进一步说明配置更新、模式切换与常见错误的处理顺序。
OPEN SOURCE / 项目关系
区分项目来源、客户端维护与配置更新,比只看一个名称更有帮助。
Clash 最初围绕规则代理和 YAML 配置形成使用生态。原版项目停止维护后,社区继续发展相关内核与图形客户端。Clash Meta 后来更名为 mihomo,因此在教程、配置说明和客户端设置里可能同时遇到这些名称。名称具有传承关系,但不能据此推断所有旧字段、新协议和客户端功能都完全兼容。
遇到某个字段不生效时,先在客户端的关于或内核页面确认实际使用的内核,再查看对应文档。旧教程可以帮助理解基本概念,却不应直接用来判断当前功能支持范围。尤其是 DNS、TUN 和规则提供器等部分,配置方式可能随内核能力与客户端集成方式而变化。
Clash Verge Rev、FlClash 等图形客户端主要负责配置管理、界面展示、系统代理与权限集成;mihomo 负责解析配置、匹配规则和建立连接。客户端项目与内核项目有各自的维护节奏,应用界面的变化不一定意味着内核行为同时改变。下载时应结合平台和具体需要选择,不必只因为名称里带有 Clash 就认定功能相同。
开源许可证说明的是代码使用、修改与分发的条件,不代表不同项目之间存在统一的发布方。本站品牌用于整理下载与中文说明,各客户端的维护主体以其项目资料为准。需要了解项目分工时,可以阅读Clash、Clash Meta 与 mihomo 关系梳理,再决定迁移或保留哪些配置。
更新客户端通常影响界面、系统集成或随附内核;更新订阅则主要改变节点、策略组和规则内容。连接问题出现在订阅更新之后时,应先比较配置变化,而不是直接重装应用。升级客户端前,导出当前配置、记录覆写内容和代理端口,确认新环境能够加载后再清理旧文件。
订阅管理涉及服务地址与账户权限。客户端能够读取某种协议,不等于任何来源的链接都可信。只导入了解来源且有权使用的配置,公开求助时遮去订阅地址中的访问参数、账户信息与节点凭据。本站提供字段与操作参考,不分发所谓的通用免费节点,也不承诺第三方服务的连通性。
mihomo 项目采用 GPL-3.0 许可证,可以在公开仓库查看实现、问题讨论和发布说明。准备自行编译或分发修改后的程序时,应完整阅读许可证及相关依赖说明;仅希望日常使用的用户,则可从图形客户端入手,不需要先搭建编译环境。
右侧命令只会把公开源码下载到本地目录,不会安装客户端、建立代理连接或修改系统网络。复制后可在已安装 Git 的终端中执行。若只是查找字段含义,直接打开本站的配置字段参考或术语表会更直接;如果需要确认实现细节,再结合源码与项目文档阅读。
NOTES / 最近更新
从实际操作中的报错出发,按顺序检查设置,保留能够解释问题的连接记录。
连接状态不等于请求已经成功到达目标。按系统代理、端口占用、策略组选择、规则命中、DNS 与 Fake-IP 的顺序排查,区分请求未进入内核和进入后连接失败,减少反复重装带来的干扰。
阅读排查清单 →订阅拉取超时、解析失败和证书错误需要分别处理。先确认网络请求是否成功,再判断返回内容能否作为配置读取;同时了解自动更新间隔与本地覆写的关系,避免更新之后丢失手动调整。
查看更新设置 →遇到“无法打开”、网络扩展授权或反复出现的钥匙串提示时,先辨认弹窗来源与具体权限,再到对应系统设置处理。文章逐步说明查看位置,并区分应用启动、代理授权与连接验证三个阶段。
阅读权限说明 →尚未安装客户端时,从平台下载入口开始;已经能够连接但个别网站异常时,优先阅读与现象一致的排查文章。需要调整配置结构时,再对照字段参考逐项修改,不要一次替换整套网络设置。
查看全部文章 →