Windows
在系统信息中确认设备架构。初次使用可先启用系统代理,检查浏览器是否产生连接记录;需要接入不读取系统代理的应用时,再查看客户端的 TUN 支持及权限提示。迁移旧配置前,先退出原程序,避免两个客户端同时改写代理设置或争用监听端口。
前往下载整份订阅由客户端导入;节点供应源由内核按配置读取。
在配置列表中粘贴兼容的订阅地址,等待下载和解析完成,再将该配置设为当前项。与手动录入不同,远程订阅可以刷新,节点改名也可能影响已有选择。若手里只有节点供应源,可用 proxy-providers 单独加载,再由策略组引用。两类链接即使都返回 YAML,也不一定能互换。更新成功却没有节点时,先确认下发内容的类型,再核对策略组是否引用了正确的供应源。
proxy-providers: office: type: file path: ./providers/office.yamlproxy-groups: - name: PROXY type: select use: [office]具体规则在前,兜底规则放在末尾。
规则模式按列表顺序检查请求,通常采用第一条命中的规则。域名后缀规则适合归类一组子域,地址段规则适合描述已知网段。不同于全局模式,规则模式可以给不同目标指定不同出口。配置时先写范围较窄的例外,再写范围较广的规则,最后用 MATCH 兜底。出现走错出口时,先在连接记录里核对实际命中的条目和策略组当前选择,不必先替换节点。
mode: rulerules: - DOMAIN,docs.example.com,DIRECT - DOMAIN-SUFFIX,example.com,PROXY - MATCH,DIRECTDNS 接入方式决定解析请求是否经过内核。
fake-ip 模式可以先给应用返回虚拟地址,再由内核根据映射识别目标域名。不同于直接返回真实地址的方式,这要求后续连接也经过能够识别映射的内核。配置时核对系统和应用使用的解析入口;依赖真实地址的局域网服务可按需加入 fake-ip-filter。改动后用同一应用重新发起连接,避免把旧解析缓存或应用自带解析造成的差异误判成规则失效。
dns: enable: true enhanced-mode: fake-ip fake-ip-filter: - '+.lan' nameserver: - system订阅保留上游内容,本机差异放在独立覆写中。
直接编辑远程订阅生成的副本,刷新后可能丢失修改。支持覆写的客户端可将端口、日志级别或本地例外单独保存,并在启动前合并。客户端对映射和列表的处理不完全相同:映射可能按键更新,列表可能整体替换,也可能支持前插或追加。不要把一种客户端的合并语法直接搬到另一种。保存后打开最终配置,检查规则顺序、策略组引用和监听地址是否仍符合预期。
mixed-port: 7890allow-lan: falselog-level: info切换内核须由客户端支持,配置字段不会自动变得兼容。
安装界面与执行配置的内核可能独立更新。支持切换的客户端应先保留旧配置,再用目标内核载入副本,查看是否有协议、规则集或 DNS 字段无法识别。固定内核的客户端则需要更新应用或选择另一款客户端。右侧是便于区分启动问题与订阅问题的最小直连片段。先确认内核能读取配置并监听端口,再逐段恢复代理组和规则,可更快定位不兼容的部分。
mixed-port: 7890mode: rulerules: - MATCH,DIRECT先按操作系统筛选,再核对处理器架构、安装方式和维护状态。若从旧客户端迁移,优先导入订阅或配置文件,不要直接覆盖新客户端的应用数据目录。
在系统信息中确认设备架构。初次使用可先启用系统代理,检查浏览器是否产生连接记录;需要接入不读取系统代理的应用时,再查看客户端的 TUN 支持及权限提示。迁移旧配置前,先退出原程序,避免两个客户端同时改写代理设置或争用监听端口。
前往下载通过“关于本机”区分 Apple Silicon 和 Intel,再选择对应安装包。首次启用代理后,可在系统网络设置中核对当前网络服务是否采用了相应配置。若客户端退出后应用仍尝试访问本地代理端口,检查系统代理是否已恢复,而不是反复重新导入订阅。
前往下载根据系统支持的 ABI 选择安装包;处理器支持某种指令集,不等于当前系统就能安装对应的包。首次连接按系统提示授权 VPN。若锁屏后连接中断,记录通知栏状态,检查应用后台运行限制,以及是否有另一项 VPN 服务接管了连接。
前往下载从 App Store 查看客户端与系统兼容要求。导入配置并授权添加 VPN 配置后,回到客户端确认所选配置和策略组。若状态栏显示 VPN 已连接但目标应用仍不可用,先用浏览器验证同一目标,再检查该应用的连接记录,区分隧道启动和请求转发。
前往下载桌面环境可按发行版选择包格式,例如用于 Debian 系的 DEB 或适用于相应发行版的 RPM。部署到无桌面的设备时,内核可以独立运行,但需要自行管理配置目录、服务权限和日志。启动成功后,还要确认应用通过系统设置、环境变量或其他接入方式向内核发送了请求。
前往下载在订阅或配置页面添加提供方给出的兼容链接,也可选择本地 YAML。看到文件出现在列表后,还要将它设为当前配置。若导入报错,先检查响应是否为配置正文,而不是登录页或服务提示页。不要在截图、日志或问题报告中公开订阅地址。
选择规则模式,在策略组里确认要使用的出口。桌面端先使用系统代理,移动端按提示授权 VPN。先验证一种接入方式,再考虑是否需要 TUN。内核正在运行只表示它已启动,不表示应用流量已经进入内核;两种状态要分别确认。
选一个预期直连的目标和一个预期代理的目标,依次访问并查看连接记录。对照目标域名、命中规则和最终出口。如果没有记录,先查代理接入;如果有记录但出口错误,再查规则顺序;只有命中与出口都符合预期时,才继续排查远端连通性。
原版 Clash 的配置以代理节点、策略组和规则为主要结构。后来不同项目延续或扩展了这套写法,项目名称相近并不代表共享发布渠道或维护周期。旧教程中的界面入口可能已经变化;阅读时先辨认它讨论的是内核字段、客户端操作,还是某个订阅提供方的转换规则。
客户端负责配置管理、系统接入和连接视图;内核负责解析配置、匹配规则并建立连接;订阅提供方维护下发内容。同一份订阅在两款客户端上的结果可能不同,例如其中一款额外注入了 DNS 或监听设置。排查时分别保留订阅原文和最终生效配置,比较差异比只看界面开关更可靠。
mihomo 延续 Clash Meta 内核的发展,在代理协议、规则集与网络栈配置上增加了选项。原版配置中常见的基础字段仍可作为迁移起点,但同名字段的取值范围与关联条件应以目标内核为准。出现解析失败时,先根据报错定位首个字段,再查配置参考;术语不清时可对照名词解释。
客户端发布记录和内核变更记录应分别阅读。升级前保留可用配置与必要的本地覆写;升级后先确认配置可载入,再检查系统代理、解析路径和规则命中。提交可复现的问题时,说明使用的平台、接入方式和最小复现配置,并去除个人域名、订阅参数及节点凭据。先描述实际结果,再给出预期结果,方便维护者判断问题所属层级。
内核按 GPL-3.0 发布。以下命令用于检出源码,不是桌面客户端安装命令。需要安装图形客户端时,回到安装包页按系统选择。
git clone https://github.com/MetaCubeX/mihomo.git
从平台覆盖、内核版本、界面操作、TUN 支持与配置覆写能力几方面对比主流 Clash 客户端,按不同使用场景给出选型建议。
节点全部超时或单个节点连不上时,按订阅有效性、本地端口、DNS 解析、系统时间与规则匹配逐项定位原因,并给出对应的修正方法。
按顺序完成 Windows 版 Clash 客户端的安装、订阅导入、系统代理与 TUN 模式设置,汇总防火墙拦截、端口冲突和服务模式授权等常见问题。