故障排查
Clash 节点超时无法连接怎么排查:从订阅、端口到协议的检查顺序
节点全部超时不等于节点失效。按订阅有效性、本地端口占用、系统代理开关、协议与内核匹配、DNS 污染五层逐一排查,定位到底是配置问题还是链路问题。
阅读全文 →FEATURES
核心特性
左侧选择设置项,右侧查看该特性的用途、用法与对应的配置片段。所有片段均为可直接使用的真实语法。
规则分流:按域名与地区决定流量去向
规则是 Clash 的核心。配置文件中的 rules 列表自上而下匹配:命中 DOMAIN-SUFFIX、DOMAIN-KEYWORD 或 GEOIP 等条件的请求,按规则指定的策略走代理或直连;都未命中时由 MATCH 兜底。中国大陆域名与 IP 走直连、其余流量交给代理,不需要来回手动切换开关。相比只有全局与直连两档的传统代理工具,规则分流对每一条连接单独决策,直连流量不绕路,代理流量不遗漏。规则可以订阅托管,也可以在客户端里自行追加覆写。
rules:
- DOMAIN-SUFFIX,github.com,节点选择
- DOMAIN-SUFFIX,bilibili.com,DIRECT
- GEOIP,CN,DIRECT
- MATCH,节点选择
TUN 模式:接管不走系统代理的程序
部分程序(命令行工具、游戏、部分客户端软件)不读取系统代理设置,常规 HTTP/SOCKS 端口对它们不生效。TUN 模式在系统里创建一块虚拟网卡,把设备的全部出站流量引入 Clash 内核,再按同一套规则分流,等于在网络层补齐了系统代理覆盖不到的盲区。开启需要管理员权限(Windows)或网络扩展授权(macOS),配合 dns-hijack 可同时接管 DNS 查询,避免解析结果被污染。日常建议先用系统代理,遇到不走代理的程序再启用 TUN。
tun:
enable: true
stack: system
auto-route: true
dns-hijack:
- any:53
订阅管理:节点列表自动保持最新
订阅是一条指向远程配置的 URL。客户端按 proxy-providers 中的 interval 周期拉取,节点增删、地址变更都会自动同步到本地,不需要手工逐个维护服务器信息。多条订阅可以并存,各自独立更新,再通过策略组统一编排。订阅拉取失败时沿用上一次的缓存,不影响已有连接。导入方式各客户端一致:复制订阅链接,在配置或订阅页面粘贴即可;URL 格式的订阅还可以经订阅转换服务生成带完整规则的 Clash 配置。
proxy-providers:
main:
type: http
url: "https://example.com/sub.yaml"
interval: 86400
path: ./providers/main.yaml
策略组:自动测速、故障转移与手动兜底
策略组把多个节点编成一个可被规则引用的整体。url-test 按周期对全部成员测速并自动选用延迟最低的一个;fallback 按列表顺序保证可用性,首选节点故障时自动切到下一个;load-balance 把连接分摊到多个节点;select 保留手动挑选的入口。四种类型可以互相嵌套,例如让手动组的候选项是几个自动测速组,兼顾省心与可控。tolerance 参数可避免延迟接近的节点来回抖动切换。
proxy-groups:
- name: 自动选择
type: url-test
url: http://www.gstatic.com/generate_204
interval: 300
tolerance: 50
QUICKSTART
三步开始使用
从安装到验证代理生效,完整流程通常在十分钟内完成。以下是入门指南的精简版。
1
下载并安装客户端
在下载页选择设备对应平台的客户端,按向导完成安装。Windows 与 macOS 首次启动时按系统提示授予网络权限;Android 安装 APK 后允许创建 VPN 连接;iOS 直接从 App Store 获取。
2
导入订阅或配置文件
复制服务商提供的订阅链接,在客户端的「配置」或「订阅」页面粘贴导入;也可以直接导入本地 config.yaml 文件。导入成功后,节点列表与规则会一并加载。
3
开启代理并验证
打开「系统代理」开关,在代理页选定策略组的节点,访问一个境外站点确认连通;若个别程序不生效,再启用 TUN 模式接管全局流量。连接页可实时查看每条请求命中的规则。
OPEN SOURCE
开源生态背书
Clash 不是一款封闭软件,而是一个由内核、规则与多个客户端组成的开源生态。代码公开可查,任何人都能审阅与构建。
项目历史
Clash 于 2018 年前后以开源项目形式出现,凭借 YAML 配置与规则分流设计迅速成为该领域的事实标准。原始内核仓库归档后,社区接力维护,配置语法与规则格式保持兼容,多年积累的订阅与规则资源可以继续使用。
内核与协议
当前活跃的内核是 MetaCubeX 团队维护的 mihomo(即 Clash Meta 内核),以 GPL 开源协议发布,在兼容原有配置的基础上扩展了更多代理协议、DNS 策略与 TUN 栈实现。桌面与移动端主流客户端均内置该内核。
客户端生态
Clash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu 等客户端由不同团队独立开发,共享同一套内核与配置格式。换客户端不需要换配置,订阅与规则可以直接迁移,选型只影响界面与平台支持,不影响分流行为。
更新机制
本站跟踪各客户端与内核的发布渠道,下载页链接指向当前发行版本,页面上的版本号随发布动态刷新。已停止维护的客户端(如 Clash for Windows、ClashX Meta)会明确标注,并给出仍在活跃维护的替代选择。
git clone https://github.com/MetaCubeX/mihomo.git
FAQ
常见问题精选
四个高频问题的一句话答案。完整解释与更多条目见概念速查与完整文档。
配置文件放在哪里?
各客户端在设置页都提供「打开配置目录」入口;手动查找时,Windows 一般在用户目录的客户端数据文件夹,macOS 在 ~/.config 或应用支持目录。
BLOG
使用心得
排查记录、平台指南与进阶配置写法,按主题持续更新。
平台指南
macOS 安装 Clash 客户端权限全解:网络扩展授权与钥匙串弹窗处理
macOS 上首次启动 Clash 客户端会连续弹出网络扩展、钥匙串访问与辅助功能授权。逐个说明每个弹窗的作用、正确的允许方式与授权失败后的补救路径。
阅读全文 →
进阶配置
Clash 策略组 url-test、fallback、load-balance 区别与配置写法
三种自动策略组各解决什么问题:url-test 选最快、fallback 保可用、load-balance 分摊流量。逐一拆解参数含义,并给出可直接套用的 YAML 配置示例。
阅读全文 →