CLASH · IPV4 · 开源客户端

Clash开源网客户端下载与配置

按设备选客户端,用中文教程导入配置,再查端口和规则如何生效。

  • 内核Mihomo
  • 协议GPL-3.0
  • 规则目标DIRECT

127.0.0.1 / 客户端入口

按操作系统下载 Clash 客户端

先确认系统和处理器架构,再选安装包。图形客户端通常把导入配置、切换策略组和查看日志放在同一个界面里,适合第一次安装。已经在使用命令行内核的读者,可以在下载页单独查看内核入口,避免把内核包当作桌面安装程序。

Windows

在系统的「关于」页面确认系统类型,再核对客户端标注的处理器架构。首次安装可以先用系统代理验证浏览器连接,不必同时开启虚拟网卡。如果安装器或系统弹出权限提示,先看提示涉及的是安装、服务还是网络接入,不用为了一条提示把防火墙整项关掉。替换旧客户端前,先退出旧进程并保留原配置。

前往下载

macOS

从「关于本机」区分 Intel 处理器与 Apple 芯片,再选对应安装包。若启动时出现系统安全提示,回到项目的发布说明确认安装要求;如果能启动却不能接管流量,再检查系统代理状态和客户端的网络权限。换到另一台机器时,优先迁移配置,别直接复制旧应用的数据目录。

前往下载

Android

选包时看设备上运行的系统所支持的架构,不只看手机芯片的宣传参数。首次连接通常会弹出系统的 VPN 授权提示,确认后再看客户端是否进入已连接状态。若问题只在锁屏后出现,先检查系统是否暂停了应用的后台运行;若一连接就断开,则先看有没有另一个应用占用 VPN。

前往下载

iOS

从下载页进入商店详情,先看系统要求,再决定是否安装。首次连接时按系统提示允许添加 VPN 配置;导入成功和连接成功是两个不同状态,不能只凭配置列表里出现名称判断。已有工作用的 VPN 配置时,先确认能否切换,尤其是在单位管理的设备上。

前往下载

Linux

桌面用户先核对发行版、包格式和处理器架构,再决定使用哪个图形客户端。不同桌面环境对系统代理的处理并不相同:浏览器能走代理,不代表终端命令会读取同一组设置。只在服务器上运行内核时,应另外确认配置路径和服务权限,让监听范围与实际用途一致。

前往下载

如果两款客户端都支持当前设备,优先比较导入方式、维护状态和日志入口。用到局域网访问、虚拟网卡或配置覆写时,还要确认界面有没有对应选项、内核是否读取这些字段。只是为了打开一份旧配置而考虑归档客户端,可以先用仍在维护的客户端测试副本,避免在原文件上反复改动。

查看全部客户端 → 对照客户端选型

DIRECT / 配置门牌

Clash 配置字段与流量走向

本地监听、流量接管和规则分流是三件事:端口决定应用把请求交到哪里,接管方式决定哪些请求能进内核,规则才决定进入内核的请求往哪走。记住这三个位置,排查时就能区分请求是没进来,还是进来后走错了路径。

规则匹配顺序与兜底目标

规则模式会从上到下检查每条规则,命中后便使用该条指定的目标,并不会再往下找更精确的规则。示例按私网地址、示例域名、其余流量三个层次分别处理:第一条让指定地址段直连,第二条用来观察域名匹配和拒绝结果,最后一条负责兜底。它不依赖任何远程节点,适合先在测试配置里看日志,再把同样的顺序用到自己的配置中。实际编辑时,别把拒绝规则误写成范围太广的域名后缀。

  • 具体条件放前面,MATCH 放最后。
  • no-resolve 避免为这条地址规则主动把域名解析成 IP。
mode: rule
rules:
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN,example.org,REJECT
  - MATCH,DIRECT

便签上的 mixed-port: 7890 是示例,不是每款客户端的固定端口。127.0.0.1 指向当前设备;手机里的同一个地址不会指到电脑。只供本机使用时,保持 allow-lan: false,然后以客户端实际显示的监听端口为准。遇到端口冲突,在确认当前端口被占用后再换端口,并把手动填写过旧端口的应用一并改掉。

查阅端口、模式及其他通用字段 →

mixed-port / 初次连接

导入配置、选择模式与验证连接

第一次尽量保留能正常联网的原始状态,一次只改一个设置。先确认配置能读入,再看请求能不能进入内核,最后才看规则分到哪里。这样即使第二步不通,也不用回头把订阅重新导入一遍。

  1. 01 / config.yaml

    导入并启用配置

    在配置或订阅页面添加已有的本地文件或订阅地址。导入完成后先检查策略组和规则是否出现,再选中该档案并确认它是当前生效项。若界面只显示下载成功,却没有加载内容,先看导入日志有没有格式或网络报错。订阅地址可能含有访问凭据,分享报错时不要截图带出完整地址。

  2. 02 / mode: rule

    选择规则模式与接管方式

    日常使用先选规则模式;确认需要转发的规则指向正确的策略组,再到组内检查所选出口。桌面上可先通过系统代理测试遵循该设置的应用,手机则按客户端的连接操作完成系统授权。不要把规则模式和系统代理当作二选一:前者决定怎么分流,后者决定请求怎么进入。

  3. 03 / 127.0.0.1

    看连接记录和匹配结果

    新开一个网页请求,再到客户端的连接记录中对照域名、命中规则和出口。完全没有新记录,先查应用是否使用代理入口;有记录却失败,再检查策略组、解析和连接报错。需要测试命令行时,单独确认终端程序读到的代理设置,不用浏览器的结果替它下结论。

需要恢复网络时,先关闭刚才开启的接管方式,再检查系统代理是否已恢复到原来的状态。直接结束客户端进程,可能留下仍指向本地端口的系统代理设置。恢复后记下是哪一个开关改变了故障现象,下次从那一步继续,不必重装。

查看完整教程 → 按现象查找排查步骤

config.yaml / 项目来源

Clash 开源生态与 Mihomo 内核

Clash开源网是独立的资料站,整理客户端入口、配置示例和排查方法。客户端的发布说明、维护状态和功能边界以各项目为准。读源码时,先分清看到的是负责网络处理的内核,还是控制它的客户端界面。

项目沿革:同一个名称下的不同项目

早期 Clash 项目把代理节点、策略组和分流规则组织进同一份配置。原项目后来停止维护,但这套配置结构和围绕它形成的使用习惯仍由社区中的其他项目延续。旧教程里的界面、菜单路径和字段,不能直接当成现有客户端的操作说明;老截图可以用来理解概念,具体操作仍要看当前项目。

迁移旧档案时,先保留一份原文件,另存副本,再对照通用字段、节点类型和规则目标。旧档案能被读入,也不一定意味着每项设置都以原来的方式处理。先确认基本连接,再逐项恢复依赖较多的功能,比在迁移时整份重写容易定位问题。

社区分工:界面功能与接管方式

图形客户端通常管理配置档案、系统集成和日志展示。即使两个客户端采用相近的内核,它们的托盘操作、开机启动、后台服务和覆写入口仍可能不同。系统授权或安装界面的问题,可以先从客户端项目的说明找答案;规则判断和协议能力则更适合对照内核文档。

查阅公开的问题记录时,先看记录描述的操作系统和复现条件。相同的报错文字,可能来自文件权限、系统网络服务或配置语法。提交问题时,可以提供精简后的字段片段、错误出现的步骤和相关日志,先去掉节点信息、订阅地址及日志里的个人数据。

内核关系:从 Clash.Meta 到 Mihomo

Mihomo 是 Clash.Meta 延续发展后的项目名,其公开仓库在 MetaCubeX 名下,采用 GPL-3.0 许可证。支持相关功能的客户端可以把用户选定的配置交给内核,由内核负责监听、规则匹配和连接转发。客户端可能还会把界面设置合并到最终配置,因此导入的文件与内核实际加载的内容不一定完全相同。

确认一个字段有无生效时,先比对保存的配置与客户端提供的生效配置,再看内核日志。不要只根据按钮名称推断底层状态。例如,看到系统代理已打开,并不能推断虚拟网卡已经启用;两者改变的是不同的入口。

更新机制:程序、内核和订阅分别检查

程序升级更新的是客户端本身,内核是否随安装包更新由该项目决定;订阅刷新则更新配置内容,规则集也可能另有刷新周期。界面上这些动作往往都叫「更新」,但它们修改的对象不同。出现异常时,先记住最近一次更新的是哪一项,再对照对应项目的变更记录。

改动前保留一个以前能用的配置副本,改动后优先复测原来正常的请求。订阅一刷新就出现问题,先看策略组和规则引用有没有变;升级应用后才出现问题,先看系统权限和启动日志。不要为了恢复一次连接,同时刷新订阅、覆盖配置和替换内核。

查看 Mihomo 源码

在 MetaCubeX/mihomo 仓库可以查看源代码、许可证和发布记录。下面的命令需要先安装 Git,只将源码取到当前目录下的 mihomo 子目录,不会安装客户端或修改系统代理。如果只是想取得可运行的程序,仍应从下载页按系统选包。

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

127.0.0.1 / 排查记录

Clash 安装与故障排查文章

排查文章按现象分开写。打不开程序,先看启动记录;能打开却没有流量,先检查应用与本地端口的连接;只有一种应用不通时,就从那种应用使用的代理设置查起。先选和当前现象最接近的一篇。

问题排查

Clash 系统代理开了却不生效:浏览器与命令行终端分开排查

浏览器插件抢占、终端不读系统代理、环境变量缺失是常见原因,按浏览器和终端两条线逐一定位。

适合网页与命令行表现不一致的情况。对照两个应用有没有使用同一个本地端口,再判断问题是在应用入口还是分流规则。

查看全部文章 →