Clash 生态 · 配置文档

Clash 代理客户端

按系统选择客户端,查阅 mihomo 内核与 YAML 配置,从导入订阅到验证规则分流。

内核代码开源中文配置参考

客户端配置特性

整份订阅由客户端导入;节点供应源由内核按配置读取。

订阅与节点供应源

在配置列表中粘贴兼容的订阅地址,等待下载和解析完成,再将该配置设为当前项。与手动录入不同,远程订阅可以刷新,节点改名也可能影响已有选择。若手里只有节点供应源,可用 proxy-providers 单独加载,再由策略组引用。两类链接即使都返回 YAML,也不一定能互换。更新成功却没有节点时,先确认下发内容的类型,再核对策略组是否引用了正确的供应源。

providers.yaml
proxy-providers:  office:    type: file    path: ./providers/office.yamlproxy-groups:  - name: PROXY    type: select    use: [office]

查阅 YAML 配置参考 →

按平台选择安装包

先按操作系统筛选,再核对处理器架构、安装方式和维护状态。若从旧客户端迁移,优先导入订阅或配置文件,不要直接覆盖新客户端的应用数据目录。

Windows

在系统信息中确认设备架构。初次使用可先启用系统代理,检查浏览器是否产生连接记录;需要接入不读取系统代理的应用时,再查看客户端的 TUN 支持及权限提示。迁移旧配置前,先退出原程序,避免两个客户端同时改写代理设置或争用监听端口。

前往下载

macOS

通过“关于本机”区分 Apple Silicon 和 Intel,再选择对应安装包。首次启用代理后,可在系统网络设置中核对当前网络服务是否采用了相应配置。若客户端退出后应用仍尝试访问本地代理端口,检查系统代理是否已恢复,而不是反复重新导入订阅。

前往下载

Android

根据系统支持的 ABI 选择安装包;处理器支持某种指令集,不等于当前系统就能安装对应的包。首次连接按系统提示授权 VPN。若锁屏后连接中断,记录通知栏状态,检查应用后台运行限制,以及是否有另一项 VPN 服务接管了连接。

前往下载

iOS

从 App Store 查看客户端与系统兼容要求。导入配置并授权添加 VPN 配置后,回到客户端确认所选配置和策略组。若状态栏显示 VPN 已连接但目标应用仍不可用,先用浏览器验证同一目标,再检查该应用的连接记录,区分隧道启动和请求转发。

前往下载

Linux

桌面环境可按发行版选择包格式,例如用于 Debian 系的 DEB 或适用于相应发行版的 RPM。部署到无桌面的设备时,内核可以独立运行,但需要自行管理配置目录、服务权限和日志。启动成功后,还要确认应用通过系统设置、环境变量或其他接入方式向内核发送了请求。

前往下载

查看全部客户端 →

首次连接三步

  1. 导入并启用配置

    在订阅或配置页面添加提供方给出的兼容链接,也可选择本地 YAML。看到文件出现在列表后,还要将它设为当前配置。若导入报错,先检查响应是否为配置正文,而不是登录页或服务提示页。不要在截图、日志或问题报告中公开订阅地址。

  2. 选规则模式并接入流量

    选择规则模式,在策略组里确认要使用的出口。桌面端先使用系统代理,移动端按提示授权 VPN。先验证一种接入方式,再考虑是否需要 TUN。内核正在运行只表示它已启动,不表示应用流量已经进入内核;两种状态要分别确认。

  3. 用连接记录验证分流

    选一个预期直连的目标和一个预期代理的目标,依次访问并查看连接记录。对照目标域名、命中规则和最终出口。如果没有记录,先查代理接入;如果有记录但出口错误,再查规则顺序;只有命中与出口都符合预期时,才继续排查远端连通性。

查看完整教程 →

开源内核与维护来源

原版 Clash 与后续项目

原版 Clash 的配置以代理节点、策略组和规则为主要结构。后来不同项目延续或扩展了这套写法,项目名称相近并不代表共享发布渠道或维护周期。旧教程中的界面入口可能已经变化;阅读时先辨认它讨论的是内核字段、客户端操作,还是某个订阅提供方的转换规则。

界面、内核与订阅分工

客户端负责配置管理、系统接入和连接视图;内核负责解析配置、匹配规则并建立连接;订阅提供方维护下发内容。同一份订阅在两款客户端上的结果可能不同,例如其中一款额外注入了 DNS 或监听设置。排查时分别保留订阅原文和最终生效配置,比较差异比只看界面开关更可靠。

mihomo 与字段兼容性

mihomo 延续 Clash Meta 内核的发展,在代理协议、规则集与网络栈配置上增加了选项。原版配置中常见的基础字段仍可作为迁移起点,但同名字段的取值范围与关联条件应以目标内核为准。出现解析失败时,先根据报错定位首个字段,再查配置参考;术语不清时可对照名词解释。

发布记录与升级回退

客户端发布记录和内核变更记录应分别阅读。升级前保留可用配置与必要的本地覆写;升级后先确认配置可载入,再检查系统代理、解析路径和规则命中。提交可复现的问题时,说明使用的平台、接入方式和最小复现配置,并去除个人域名、订阅参数及节点凭据。先描述实际结果,再给出预期结果,方便维护者判断问题所属层级。

获取 mihomo 源码

内核按 GPL-3.0 发布。以下命令用于检出源码,不是桌面客户端安装命令。需要安装图形客户端时,回到安装包页按系统选择。

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

客户端资讯

查看全部文章 →