开源内核 · 配置文档持续整理

Clash 客户端下载与配置文件百科

按系统选择兼容客户端,用 YAML 示例理解 mihomo 的端口、DNS 与分流规则。

代码开源 中文文档

01 Downloads

按平台下载 Clash 客户端

先核对操作系统,再选安装包架构。桌面端还要区分图形客户端与独立内核;首次使用从图形客户端开始即可。

Windows

在系统的设备规格中核对处理器架构。常见的英特尔和 AMD 电脑使用 x64 包,采用 ARM 处理器的设备则要确认所选客户端是否提供对应构建。安装后先导入配置,再开启系统代理。若测试正常但只有个别应用不走代理,检查应用是否继承系统设置,不要先替换订阅。

前往下载

macOS

在「关于本机」查看芯片或处理器,再选择 Apple Silicon 或 Intel 对应的包。菜单栏状态可以说明客户端是否在运行,但不能说明每个应用的连接都已接管。切换配置后,从连接记录核对当前请求;退出测试时,确认系统的代理设置已恢复。

前往下载

Android

按设备支持的应用架构选择安装包,别只凭处理器是否为六十四位判断。初次启动通常需要确认系统 VPN 请求。若切到后台后连接中断,先查看客户端运行状态与系统电池管理;若设备已有工作资料或其他 VPN,还要确认当前连接由哪个应用管理。

前往下载

iOS

从下载页进入 App Store 查看兼容客户端和系统要求。完成配置导入后,按系统提示允许添加 VPN 配置,再返回客户端核对当前选中的配置。桌面端保存的 YAML 可作为迁移起点,但本地文件路径、代理模式名称和进阶字段不一定能原样沿用。

前往下载

Linux

桌面客户端按发行版支持的包格式及处理器架构选择。安装前分清系统包管理器使用的格式,不要把同一架构的不同格式视作可互换。终端命令与桌面应用的代理设置可能各自独立;如果只在终端里发起请求,优先检查该程序实际读取的代理配置。

前往下载

02 Config Reference

Clash 配置字段与 YAML 示例

先分清入站、出站与匹配条件。点击字段查看可对照的片段;片段用于解释一层配置,不等同于包含订阅和节点的完整文件。

混合代理端口

混合端口同时接受本机应用发来的 HTTP 和 SOCKS 代理连接。它是应用接入内核的端口,不是远端节点使用的端口。只在当前设备使用时,可先关闭局域网接入,再核对应用填写的地址和端口。遇到端口已被占用,先找出占用的进程,再同步修改内核和应用的设置。如果只改了其中一处,请求可能根本没有进入内核,连接日志里也就看不到规则命中。

DNS 解析模式

先确认请求是否进入内核的 DNS 模块,再判断解析模式是否合适。fake-ip 可以先返回映射地址,让内核在后续连接中识别域名;这不等于把系统里所有 DNS 查询自动交给内核。排查时区分浏览器的安全 DNS、系统解析和内核解析。只有特定域名对映射地址不兼容时,再按域名检查过滤项,避免为一个服务改动整套解析设置。

config.yaml
mixed-port: 7890
allow-lan: false
dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16

读配置的顺序:先找 mixed-port、mode 这样的顶层字段,再看 proxies 定义了哪些出站,最后检查 proxy-groups 与 rules 如何引用这些名字。策略组名称是引用关系的一部分。改名时,组内嵌套引用和规则末尾的目标都要一起改,否则 YAML 即使能解析,内核也可能拒绝加载。

修改的落点:订阅源、本地覆写与客户端生成的最终配置不是同一份文件。更新后修改消失,应先确认正在编辑哪一层。需要长期保留的局部修改,放在客户端支持的覆写层,并核对列表是追加还是替换。特别是 rules:替换整段可能删掉原有例外,追加到 MATCH 后又可能永远不命中。完整语法见配置字段参考。

03 Quick Start

Clash 配置导入与连接验证

初次使用只做三件事:导入并选中配置、打开流量入口、用一次请求验证。先跑通主线,再改 DNS 或规则。

  1. 01

    导入并启用配置

    打开客户端的配置页,按已有资料选择订阅链接或本地 YAML。更新成功后点选这份配置,到代理页确认策略组可以展开。能看到文件名只代表配置条目已保存,能看到组和成员才更接近加载成功。若导入报错,先读错误所在行、字段名或下载提示,不必连续添加相同订阅。

    config.yaml · 配置导入

  2. 02

    选择模式并接入流量

    需要按域名或地址分流时,先选规则模式,在策略组里确认当前出站。桌面端按客户端说明启用系统代理,移动端按提示建立 VPN 连接。不要同时改接入方式和策略组:如果结果变了,会难以判断是哪一层起作用。已经有其他代理在运行时,先确认本次要使用的入口。

    mode: rule · 系统代理

  3. 03

    核对一条真实连接

    用常用应用重新打开一个页面,到连接记录查找对应域名、命中规则和出站。没有记录就检查应用是否走了当前入口;有记录但请求失败,再看 DNS、策略与节点状态。页面缓存和已有连接可能干扰判断,可重新发起请求。看到一次成功的测试后,再逐项恢复自定义设置。

    请求目标 → 命中规则 → 实际出站

常见问题速查

为什么代理页有节点,连接列表却没有请求?
节点已加载不代表流量已接入;先核对系统代理或 VPN 状态,再确认发起请求的应用使用该入口。
为什么切换策略后,正在打开的页面没有变化?
应用可能复用已经建立的连接;重新请求并观察新连接,不要用旧记录判断切换是否生效。
为什么只改一条规则却影响了多个站点?
后缀匹配覆盖所属子域名,提前命中也会跳过后续规则;到规则语法对照检查匹配范围和顺序。

更多安装和连接问题见 Clash 常见问题。

04 Project Sources

mihomo 开源内核与配置来源

源代码、客户端和订阅由不同项目或服务提供。遇到问题时先确认归属,再核对对应的文档、发布说明或问题记录。

项目沿革:Clash、Clash.Meta 与 mihomo

Clash 生态的配置文件沿用若干共同概念,例如声明节点、组成策略组、按规则选择出站。mihomo 延续 Clash.Meta 的开发脉络,并在这一结构上增加了功能。旧教程里的通用写法还可以作为阅读入口,但遇到具体协议、DNS 字段或规则类型时,应以正在运行的内核为准。看到相同的界面名称,也不应据此断定两个客户端对同一字段有相同解释。迁移旧文件时可先测试最小配置,再逐段恢复进阶选项。

开源生态:按问题查找上游

mihomo 的源码仓库公开,采用 GPL-3.0 许可证。讨论字段含义和实现行为时,可先查该仓库的对应代码、变更记录与已知问题。若问题涉及托盘入口、订阅更新按钮或设备权限,则通常要查对应客户端,而不是到内核仓库寻找界面实现。许可证和源码记录说明的是各项目自身的发布与授权,不能代替订阅服务说明,也不能用一个项目的许可推断其他客户端或规则数据的授权。

内核关系:区分导入和执行

客户端下载并整理配置,由内核读取最终配置,随后处理实际连接。订阅拉取失败发生在获取阶段,字段不受支持发生在加载阶段,而规则命中却连不上属于运行阶段。排查时先定位停在哪一段,再决定查看订阅响应、加载错误还是连接日志。分享复现过程时,可保留字段结构和报错类型,用文档地址替代真实节点地址;这样既能说明问题,也不必交出能够访问订阅的链接。

更新机制:安装包、订阅和规则数据分别核对

升级客户端可能改变界面与随包内核;刷新订阅通常只重新获取配置;更新地理数据库或规则集又是另一条路径。排查变化时记录最近执行的是哪一种更新,并保留更新前可用的本地配置。若问题只在更新订阅后出现,比较最终规则顺序或节点字段;若地区匹配变化,则核对当前数据来源、更新时间和是否成功加载。尽量一次只动一类内容,再用同一应用重试同一目标。

05 Field Notes

Clash 使用心得

配置参考按字段查阅,使用心得按任务查阅。下列文章分别对应跨设备同步、移动端导入和客户端界面。

Clash下载