clashsdk / clash
Public版本发布时间线 · 内核 mihomo,悬停查看版本号
clashsdk / clash / README.md
MIT
内核 mihomo
五平台客户端
永久免费
Clash 全平台客户端下载与中文文档
Clash 是一款开源的网络代理客户端,以规则分流为核心设计,支持 TUN 模式与订阅管理。本站收录 Windows、macOS、Android、iOS、Linux 五个平台的安装包,配套中文教程与故障排查文档,版本跟随上游公开发布渠道更新。
$ mihomo -d ~/.config/mihomo
INFO[0000] Start initial configuration in progress
INFO[0000] RESTful API listening at: 127.0.0.1:9090
INFO[0000] HTTP(S) proxy listening at: 127.0.0.1:7890
核心特性
docs/features/
点击左侧文件名,右侧面板展示该特性的说明文档,像在仓库里逐个点开 markdown 文件阅读。
clash / docs / features / rules.md
规则分流
规则分流解决的问题是「哪些流量走代理、哪些直连」。Clash 使用 DOMAIN-SUFFIX、DOMAIN-KEYWORD、IP-CIDR、GEOIP 等规则类型,按配置文件里从上到下的顺序逐条匹配,命中即执行对应策略——直连、走某个代理分组,或直接拒绝。
日常用法是订阅一份社区维护的规则集,再针对个别站点补几条自定义规则;客户端界面里也能一键切换规则 / 全局 / 直连三种工作模式。与只有全局开关的简单代理工具相比,规则分流让本地流量不绕路、跨境流量走节点,速度与兼容性都更稳。规则写法详见使用指南。
clash / docs / features / tun-mode.md
TUN 模式
TUN 模式在系统里创建一块虚拟网卡,把设备上所有 TCP / UDP 流量交给 Clash 处理,不依赖应用是否遵守系统代理设置。命令行工具、游戏客户端、以及不读系统代理的软件,都能被 TUN 模式接管。
开启时需要授予相应权限:Windows 上安装服务组件,macOS 上批准系统扩展,Android / iOS 走系统 VPN 接口。与传统 HTTP 代理模式相比,TUN 的覆盖面更完整;代价是排查问题时要多留意 DNS 劫持与路由表设置,对应章节见故障排查。
clash / docs / features / subscription.md
订阅管理
订阅把服务商或自建服务器的节点列表打包成一条 URL,客户端定期拉取即可同步节点变更,不需要手工逐个录入服务器地址。Clash 客户端原生支持标准 YAML 订阅,配合订阅转换工具也能导入 Base64 节点列表等其他格式。
导入方式通常是复制链接后在配置页粘贴,或使用 clash:// 一键导入协议。订阅还能携带分流规则与代理分组,一次导入即得到完整可用的配置;更新周期与到期信息也会显示在客户端配置页里。格式差异与转换方法见订阅格式科普。
clash / docs / features / multi-platform.md
多平台一致
Windows、macOS、Android、iOS、Linux 五个平台都有基于同一内核 mihomo 的客户端可选,配置文件格式完全一致,一份 YAML 在五端通用。桌面端首推 Clash Plus 与 Clash Verge Rev,移动端有 Clash Plus 与 Clash Meta for Android,iOS 通过 App Store 安装。
换设备时只需把订阅链接重新导入,代理分组、规则与策略保持一致,不需要重新学习一套界面。各平台安装包、系统要求与架构说明集中在下载页。
clash / docs / features / open-source.md
开源生态
Clash 生态的内核与主流客户端均在公开仓库开发:内核 mihomo 延续了原 Clash 核心的配置格式并持续扩充协议支持,GUI 客户端由不同社区团队维护,代码任何人都可以阅读、编译与审计。
版本发布走公开的 release 流程,更新日志逐条可查。本站提供的安装包均指向各项目的公开发布渠道,并跟随上游版本更新;想了解各客户端的维护状态与差异,可以查看选型指南。
开源生态与更新机制
docs/project/
项目历史
Clash 于 2018 年首次发布,以 Go 语言编写,规则分流是它区别于同类工具的核心设计。原仓库在 2023 年停止维护并归档后,社区分支 Clash.Meta 接手了内核开发,并更名为 mihomo 持续迭代至今——协议支持、规则类型与 API 都在原有基础上继续扩充。
内核与客户端的关系
内核负责协议实现、规则匹配与流量转发,GUI 客户端负责界面、订阅管理与系统集成——两者是分层关系。本站收录的 Clash Plus、Clash Verge Rev、FlClash 等客户端均内置 mihomo 内核,所以配置格式互通;换客户端不需要改配置文件。
安装包来源与更新
本站不修改任何安装包,下载链接指向各项目公开发布的原始版本;下载页的版本号自动跟随上游最新 release,不需要人工比对。上游发布新版本后,客户端内的更新提示与本站下载页会同步刷新,老版本用户直接覆盖安装即可保留配置。
社区协作
除内核与客户端外,规则集、订阅转换、GeoIP 数据库等周边工具同样由社区开源维护,构成完整的工具链。遇到功能问题可以在对应项目的公开仓库提交 issue;本站文档聚焦中文场景的安装、配置与排错,与上游文档互为补充。
$ git clone https://github.com/MetaCubeX/mihomo.git
$ cd mihomo && go build
常见问题精选
docs/faq.md
订阅链接导入后看不到节点?
先确认链接是 Clash / YAML 格式,再检查是否需要经订阅转换工具处理,完整步骤见使用指南。
开了代理还是打不开网页?
按「系统代理开关 → 节点可用性 → DNS 设置」的顺序逐层排查,分章流程见故障排查。
iPhone / iPad 上怎么安装?
通过 App Store 安装 Clash Plus 即可,商店链接与说明见下载页 iOS 区。
这么多客户端该选哪个?
桌面与移动端首推 Clash Plus,追求折腾空间可选 Clash Verge Rev,逐项对比见选型指南。
换客户端要重新配置一遍吗?
不需要。本站收录的客户端都基于 mihomo 内核,读的是同一套 YAML 配置格式,订阅链接与自定义规则可以直接搬过去。只有界面上的开关位置、系统代理接管方式与托盘菜单会有差别,规则、分组、DNS 段落原样生效;真正需要留意的是各客户端默认的混合端口号是否一致,若你在浏览器插件或终端里写死过端口,换客户端后把端口调回原值即可。
规则分流和全局代理有什么区别?
全局代理把所有流量无差别送进节点,速度受单节点带宽限制,国内站点也要绕一圈,反而更慢;规则分流则按域名、IP 归属地、进程名把流量分派到不同出口,国内直连、境外走代理、广告域名直接拒绝。规则模式是 Clash 的设计初衷,也是长期使用更省流量、更稳定的用法,具体规则写法见技术文档的规则章节。
节点延迟测出来很低,为什么看视频还是卡?
延迟测的是一次握手往返耗时,反映的是响应快慢,而看视频吃的是持续带宽与丢包率,两者并不等价。一条延迟 60ms 但被限速或跨境拥塞的线路,播放 4K 时依然会反复缓冲;判断线路好坏应结合实际下载速率、长时间连接的稳定性以及高峰时段表现,不要只盯着延迟数字。
适用场景与使用边界
docs/usage/
开发与调试
开发者常把 Clash 当作本地流量网关:混合端口同时提供 HTTP 与 SOCKS5 入口,终端里导出 http_proxy 环境变量后,包管理器、构建脚本与容器拉取镜像都能复用同一条出口;日志页按连接列出请求的域名、匹配到的规则与所选节点,排查「某个依赖装不上」这类问题比抓包更直观。配合按进程分流的规则,还能只让指定的命令行工具走代理,不影响其他本地服务。
多设备与家庭网络
在一台常开的电脑或路由器上启用允许局域网连接,同一网段内的手机、平板、电视盒子把网关或代理指向这台设备,就能共用一份配置,不必每台设备各装一次客户端。此时要特别注意 DNS 与 Fake-IP 的取舍:局域网内的 NAS、打印机、投屏设备应写入直连规则或 DNS 例外,否则假地址会让内网服务无法访问。
配置管理习惯
建议把订阅配置与自己手写的规则分开维护:订阅由机场定期更新,自定义部分放进单独的规则文件或覆写段落,升级订阅时才不会被覆盖。改动前先备份一份可用配置,改完用客户端自带的配置校验或重载功能确认语法无误;养成给每次改动写一行注释的习惯,几个月后回看也能明白某条规则当初为什么加。
合规与安全提示
Clash 只是流量转发与规则匹配工具,本身不提供任何线路或账号,能连到哪里完全取决于你自己填入的节点信息。请在所在地法律法规允许的范围内使用,不要在公共渠道分享含账号密码的订阅链接,也不要导入来源不明的第三方配置——配置文件里可以写入任意 DNS 与规则,来源不可信等于把解析与出口交给陌生人。
Fake-IP 模式原理详解:DNS 解析怎么被接管,哪些场景该开哪些该关
从 DNS 查询流程讲起,解释 Fake-IP 如何用保留网段假地址加速匹配、减少 DNS 泄漏,对比 Redir-Host 的差异,并列出局域网服务、游戏联机等需要关闭或加例外的典型场景。
Clash 客户端界面速览:代理页、配置页、日志页分别管什么
按区块走一遍客户端主界面:代理页的分组与节点切换、配置页的订阅管理与规则加载、日志页的连接记录排错用法,帮助新用户建立对整个界面的功能地图。
Clash 订阅格式科普:YAML、Base64 节点列表与通用格式的区别及转换方法
梳理常见订阅格式的结构差异:Clash YAML 配置、Base64 编码节点列表与各客户端专有格式,说明为什么有的链接导入失败,以及用转换工具在格式之间安全互转的注意事项。