Windows
在系统的设备规格中核对处理器架构。常见的英特尔和 AMD 电脑使用 x64 包,采用 ARM 处理器的设备则要确认所选客户端是否提供对应构建。安装后先导入配置,再开启系统代理。若测试正常但只有个别应用不走代理,检查应用是否继承系统设置,不要先替换订阅。
前往下载01 Downloads
先核对操作系统,再选安装包架构。桌面端还要区分图形客户端与独立内核;首次使用从图形客户端开始即可。
在系统的设备规格中核对处理器架构。常见的英特尔和 AMD 电脑使用 x64 包,采用 ARM 处理器的设备则要确认所选客户端是否提供对应构建。安装后先导入配置,再开启系统代理。若测试正常但只有个别应用不走代理,检查应用是否继承系统设置,不要先替换订阅。
前往下载在「关于本机」查看芯片或处理器,再选择 Apple Silicon 或 Intel 对应的包。菜单栏状态可以说明客户端是否在运行,但不能说明每个应用的连接都已接管。切换配置后,从连接记录核对当前请求;退出测试时,确认系统的代理设置已恢复。
前往下载按设备支持的应用架构选择安装包,别只凭处理器是否为六十四位判断。初次启动通常需要确认系统 VPN 请求。若切到后台后连接中断,先查看客户端运行状态与系统电池管理;若设备已有工作资料或其他 VPN,还要确认当前连接由哪个应用管理。
前往下载从下载页进入 App Store 查看兼容客户端和系统要求。完成配置导入后,按系统提示允许添加 VPN 配置,再返回客户端核对当前选中的配置。桌面端保存的 YAML 可作为迁移起点,但本地文件路径、代理模式名称和进阶字段不一定能原样沿用。
前往下载桌面客户端按发行版支持的包格式及处理器架构选择。安装前分清系统包管理器使用的格式,不要把同一架构的不同格式视作可互换。终端命令与桌面应用的代理设置可能各自独立;如果只在终端里发起请求,优先检查该程序实际读取的代理配置。
前往下载02 Config Reference
先分清入站、出站与匹配条件。点击字段查看可对照的片段;片段用于解释一层配置,不等同于包含订阅和节点的完整文件。
混合端口同时接受本机应用发来的 HTTP 和 SOCKS 代理连接。它是应用接入内核的端口,不是远端节点使用的端口。只在当前设备使用时,可先关闭局域网接入,再核对应用填写的地址和端口。遇到端口已被占用,先找出占用的进程,再同步修改内核和应用的设置。如果只改了其中一处,请求可能根本没有进入内核,连接日志里也就看不到规则命中。
先确认请求是否进入内核的 DNS 模块,再判断解析模式是否合适。fake-ip 可以先返回映射地址,让内核在后续连接中识别域名;这不等于把系统里所有 DNS 查询自动交给内核。排查时区分浏览器的安全 DNS、系统解析和内核解析。只有特定域名对映射地址不兼容时,再按域名检查过滤项,避免为一个服务改动整套解析设置。
mixed-port: 7890
allow-lan: false
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
规则模式下从上到下匹配,先命中有效规则的请求按该规则指定的出站处理。域名后缀规则用于一组同后缀域名,地区规则需要相应的地理数据。把具体例外放在覆盖面更宽的规则之前,并把无条件的 MATCH 放在末尾。流量走错时,先在连接记录里看实际命中的规则,再核对规则目标和当前策略;即使规则写对,组内选错出站也会得到不同结果。
url-test 按测试地址的连通性与耗时选择候选出站,并可用容差降低频繁切换。它测的是一条测试路径,不代表所有业务都经过同样的网络路径。fallback 更适合按既定优先级选可用项;load-balance 关注连接分配。示例中的两个节点名必须在同一份配置中已有定义,测试地址也应换成经过验证且适合该网络的地址。
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- GEOIP,LAN,DIRECT,no-resolve
- MATCH,DIRECT
proxy-groups:
- name: 自动测速
type: url-test
proxies: [节点甲, 节点乙]
url: https://example.com/
interval: 300
tolerance: 50
proxies 描述内核怎样连接远端节点,节点的 type 决定其余字段怎么解释。以下用 SOCKS5 举例,地址取自文档保留网段,不能作为可用节点。不要把远端 port 填到系统的本地代理端口,也不要把一种协议的传输选项直接搬到另一种协议。导入报未知字段时,核对正在运行的内核与节点协议,而不只是查看客户端名称。
先用常规日志观察启动、加载配置和连接处理,再决定是否短时开启调试日志。编辑保存不代表内核已重新加载,客户端还可能通过覆写层修改日志级别。复现前记下当前配置名称,随后用同一应用发起一次请求,对照连接记录与实际时间。发给他人排查前,移除订阅地址、节点凭据和不宜公开的域名;确认问题后恢复原有级别。
proxies:
- name: 文档示例
type: socks5
server: 192.0.2.10
port: 1080
log-level: info
读配置的顺序:先找 mixed-port、mode 这样的顶层字段,再看 proxies 定义了哪些出站,最后检查 proxy-groups 与 rules 如何引用这些名字。策略组名称是引用关系的一部分。改名时,组内嵌套引用和规则末尾的目标都要一起改,否则 YAML 即使能解析,内核也可能拒绝加载。
修改的落点:订阅源、本地覆写与客户端生成的最终配置不是同一份文件。更新后修改消失,应先确认正在编辑哪一层。需要长期保留的局部修改,放在客户端支持的覆写层,并核对列表是追加还是替换。特别是 rules:替换整段可能删掉原有例外,追加到 MATCH 后又可能永远不命中。完整语法见配置字段参考。
03 Quick Start
初次使用只做三件事:导入并选中配置、打开流量入口、用一次请求验证。先跑通主线,再改 DNS 或规则。
打开客户端的配置页,按已有资料选择订阅链接或本地 YAML。更新成功后点选这份配置,到代理页确认策略组可以展开。能看到文件名只代表配置条目已保存,能看到组和成员才更接近加载成功。若导入报错,先读错误所在行、字段名或下载提示,不必连续添加相同订阅。
config.yaml · 配置导入
需要按域名或地址分流时,先选规则模式,在策略组里确认当前出站。桌面端按客户端说明启用系统代理,移动端按提示建立 VPN 连接。不要同时改接入方式和策略组:如果结果变了,会难以判断是哪一层起作用。已经有其他代理在运行时,先确认本次要使用的入口。
mode: rule · 系统代理
用常用应用重新打开一个页面,到连接记录查找对应域名、命中规则和出站。没有记录就检查应用是否走了当前入口;有记录但请求失败,再看 DNS、策略与节点状态。页面缓存和已有连接可能干扰判断,可重新发起请求。看到一次成功的测试后,再逐项恢复自定义设置。
请求目标 → 命中规则 → 实际出站
更多安装和连接问题见 Clash 常见问题。
04 Project Sources
源代码、客户端和订阅由不同项目或服务提供。遇到问题时先确认归属,再核对对应的文档、发布说明或问题记录。
Clash 生态的配置文件沿用若干共同概念,例如声明节点、组成策略组、按规则选择出站。mihomo 延续 Clash.Meta 的开发脉络,并在这一结构上增加了功能。旧教程里的通用写法还可以作为阅读入口,但遇到具体协议、DNS 字段或规则类型时,应以正在运行的内核为准。看到相同的界面名称,也不应据此断定两个客户端对同一字段有相同解释。迁移旧文件时可先测试最小配置,再逐段恢复进阶选项。
mihomo 的源码仓库公开,采用 GPL-3.0 许可证。讨论字段含义和实现行为时,可先查该仓库的对应代码、变更记录与已知问题。若问题涉及托盘入口、订阅更新按钮或设备权限,则通常要查对应客户端,而不是到内核仓库寻找界面实现。许可证和源码记录说明的是各项目自身的发布与授权,不能代替订阅服务说明,也不能用一个项目的许可推断其他客户端或规则数据的授权。
客户端下载并整理配置,由内核读取最终配置,随后处理实际连接。订阅拉取失败发生在获取阶段,字段不受支持发生在加载阶段,而规则命中却连不上属于运行阶段。排查时先定位停在哪一段,再决定查看订阅响应、加载错误还是连接日志。分享复现过程时,可保留字段结构和报错类型,用文档地址替代真实节点地址;这样既能说明问题,也不必交出能够访问订阅的链接。
升级客户端可能改变界面与随包内核;刷新订阅通常只重新获取配置;更新地理数据库或规则集又是另一条路径。排查变化时记录最近执行的是哪一种更新,并保留更新前可用的本地配置。若问题只在更新订阅后出现,比较最终规则顺序或节点字段;若地区匹配变化,则核对当前数据来源、更新时间和是否成功加载。尽量一次只动一类内容,再用同一应用重试同一目标。
05 Field Notes
配置参考按字段查阅,使用心得按任务查阅。下列文章分别对应跨设备同步、移动端导入和客户端界面。
对比电脑、手机间同步 Clash 配置的几种做法,包括订阅链接直用、覆写文件、WebDAV 备份与私有 Git 仓库,并列出各自的维护成本与注意点。
说明 iOS 上兼容 Clash 配置的客户端如何从 App Store 获取,导入订阅链接或 YAML 文件,并开启 VPN 描述文件完成首次连接。
按界面顺序说明代理页的分组与测速、配置页的订阅与切换、日志页的级别筛选,帮助新手快速看懂每个按钮和状态标识的含义。