入门指南
导入订阅、选择模式、验证连接
跟着教程配置 浏览常见问题 →连接失败时分层验证,比同时切换节点、模式与 DNS 更容易保留线索。
先让配置可用,再谈节点选择。安装客户端之后,先导入已有订阅或本地配置,确认配置列表中出现条目,并将它设为当前使用项。订阅地址是配置来源,不是软件安装包,也不等于公开分享链接。若导入失败,先区分下载失败、内容格式错误和内核不支持的字段;保留错误提示,避免反复粘贴地址却没有改变排查条件。截图或发日志前,应遮住订阅地址里的访问凭据。
界面显示运行,不代表应用已经走代理。在配置加载成功后开启系统代理,再从浏览器发起一次新请求,并检查客户端的连接记录。部分终端、游戏与自行实现网络连接的应用不会读取系统代理,不能仅凭网页可用就推断全部流量已被接管。先用同一个应用、同一个目标反复验证;确实需要覆盖更多程序时,再了解 TUN 的权限与路由设置,不必在首次启动时同时开启所有功能。
连接验证要看路径,也要看结果。在策略组里选定一个节点后,访问测试目标,核对连接详情中的目标域名、命中规则和实际出口。延迟测试只反映该测试地址在当时的响应情况,不能单独证明所有网站或 UDP 业务都正常。若切换节点才恢复,继续比较节点本身;若日志里始终没有请求,优先检查接管设置。先定位问题所在层级,再决定是否更换配置或调整规则。
规则决定去哪里,策略组决定选谁。Rule 模式下,内核按配置顺序检查规则,通常在首条匹配后采用对应动作。域名后缀、精确域名与目标 IP 的匹配条件不同,不能把某个域名写进任意位置就期待生效。添加 Clash 自定义规则时,先明确匹配目标,再把更具体的条件放在宽泛条件之前,同时确认规则引用的策略组名称确实存在。保存后重新加载配置,并用一次新连接验证命中结果。
自动选择不是相同的选路逻辑。select 用于手动指定出口,url-test 根据测试结果选择节点,fallback 更重视配置顺序与可用性,load-balance 则按所设策略分配连接。首次配置可先保留一个手动选择组,确认单个节点可用后,再叠加自动组。遇到出口频繁变化时,检查测试目标、间隔与组内成员,不要把组名里的“自动”当作连接稳定的保证。
订阅更新和本地修改需要分开管理。直接修改下载得到的配置,可能在下一次更新时被覆盖;更适合长期保留的做法,是使用客户端支持的覆写、合并或独立规则集功能。具体合并顺序由客户端实现决定,不能假设所有界面都一致。修改前导出一份可恢复配置,一次只增加一组条件,更新订阅后再检查最终生效内容。多订阅合并还要检查同名策略组和重复节点,避免引用指向错误对象。
域名无法访问,不一定是节点故障。从应用发起请求到建立连接,中间还包含域名解析、规则匹配和出口选择。先检查报错是解析超时、连接被拒绝还是握手失败,再对照日志中的域名与目标地址。如果浏览器启用了自己的安全 DNS,它的解析路径可能与系统不同;修改内核 DNS 前,应确认请求究竟交给谁处理。只看系统解析工具的结果,无法完整解释浏览器实际访问时经过的全部链路。
Fake-IP 是域名映射机制,不是实际出口。启用后,内核可以向应用返回保留地址段中的虚拟地址,后续再根据映射找到原域名并进行分流。工具显示这类地址时,不能直接认定解析错误。对依赖真实地址的局域网服务,应结合实际兼容性设置过滤条件,而不是把全部域名排除。切换解析模式后,应用或系统里的旧缓存仍可能存在,需要关闭旧连接并清理相应缓存,再比较新请求的行为。
TUN 排查需要同时看路由和权限。虚拟网卡扩大了可接管的流量范围,也引入权限、DNS 劫持与路由冲突等变量。若开启后局域网设备失联,先核对排除路由及其他 VPN 软件,再检查默认路由是否符合预期。保留能正常工作的系统代理配置作为对照,不要同时改动网络栈和规则集。排查完成后将日志级别调回日常设置,分享日志时仅保留必要片段,隐藏订阅、控制接口凭据与个人访问记录。
下面只演示本地混合端口、手动策略组与规则顺序。示例组仅含内置直连动作,没有提供代理节点,不是完整可联网的代理配置。实际使用时,需要将已有节点或订阅提供器接入策略组,并确保每条规则引用的名称与组名一致。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxy-groups:
- name: 手动选择
type: select
proxies:
- DIRECT
rules:
- DOMAIN-SUFFIX,example.com,手动选择
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,手动选择
先匹配的规则
先决定去向
先确定设备类型,再比较客户端。已有可用配置时,优先保留原文件,避免迁移时同时更换订阅与网络设置。
可从 Clash Plus、Clash Verge Rev 等图形客户端开始。安装前在系统设置中确认架构,启动后分别检查内核运行状态与系统代理。寻找 Clash for Windows 替代方案时,重点比较配置导入、覆写方式和后台服务权限;旧客户端的设置目录不宜直接覆盖到新客户端。
前往下载 Windows 客户端Clash macOS 下载需要区分 Apple Silicon 与 Intel 安装包,可在“关于本机”查看芯片信息。首次打开应用时按系统提示处理权限,并检查是否与已有网络扩展冲突。需要 TUN 时,再阅读客户端对应的服务安装说明;普通浏览器访问可先用系统代理建立对照。
前往下载 macOS 客户端选择 Clash Android 客户端时,先确认设备架构与应用兼容范围,再导入已有订阅。首次连接通常需要授权创建 VPN 连接,其他占用同一系统通道的应用可能需要先停止。若切到后台后断开,检查电池优化与后台运行限制,再判断是否为节点问题,避免只在前台重复测速。
前往下载 Android 客户端下载页提供 Clash Plus 的 App Store 入口,并列出官网 clashplus.io。安装后按应用提示导入配置并授权 VPN 连接。不同客户端支持的字段可能不同,桌面配置迁移到手机时,应先看导入提示与运行日志;涉及脚本、覆写或特殊规则的部分,需要逐项确认,而不是默认原样适用。
前往下载 iOS 客户端桌面用户可比较 Clash Verge Rev 与 FlClash,并根据发行版选择软件包。命令行程序不一定读取桌面环境的系统代理,需要单独检查环境变量或应用参数。服务器、路由器用户可查看下载页内核区,另外配置服务管理、文件权限与监听范围,不要把桌面安装步骤直接套到远程主机。
前往下载 Linux 客户端Linux 企鹅图形:Font Awesome Tux,CC BY 4.0;仅使用内联矢量。
本站整理下载入口与排查笔记,不代表所有客户端的开发者。软件能力应以所用项目的说明和实际运行结果为准。
Clash 是规则代理生态中广泛使用的名称,现有教程可能同时涉及原始 Clash、Clash Meta 与 mihomo。mihomo 延续了 Clash Meta 的技术路线,提供代理协议、策略组、规则匹配和 DNS 等内核能力。客户端则在此基础上加入图形界面、订阅管理、系统代理开关与服务管理。看到相近名称时,应先确认实际使用的内核,而不是仅凭应用外观判断配置是否兼容。
历史教程中的字段与界面名称不一定适用于当前客户端。遇到未知字段、协议不支持或配置加载失败时,应记录客户端名称、内核信息和原始错误提示,再对照项目文档。复制一段旧配置后能够保存,并不意味着内核采用了其中每项设置;最终应以加载结果与连接行为共同判断。
开源仓库可以用来查看许可证、配置实现、问题讨论和发布说明。下方命令指向 mihomo 项目的公开仓库,适合需要阅读源码或追踪特定行为的用户;日常使用图形客户端不需要先编译内核。排查某项行为变化时,先阅读发布说明及相关问题记录,通常比从头替换整个配置更容易确定影响范围。
开源内核也不等于所有外围服务都由同一项目提供。节点连接质量、订阅内容和账户状态取决于对应服务来源,客户端无法代替服务方修复失效节点。提交问题前,应先用最小配置复现,说明系统环境与具体操作,去掉个人凭据和无关规则;这样才能区分内核缺陷、客户端集成差异与订阅本身的问题。
客户端、内核和订阅可以分别更新,三者并不总是同步变化。升级前先导出配置与本地覆写,记下当前正常工作的代理模式及 DNS 设置。升级后先用同一目标测试,确认系统代理、TUN 权限、规则集加载与订阅刷新均符合预期,再恢复自动更新或复杂策略。若出现回归,保留前后差异比反复重装更有定位价值。
连接日志记录的是请求过程,不是对故障原因的完整判决。超时可能发生在解析、出口连接或目标响应阶段,同样一句报错需要结合上下文解释。本站内容采用“操作、现象、验证”的顺序,尽量让每次修改都有可观察结果;遇到未覆盖的情况,可先查常见问题,再按入门指南回到最小可用链路。
按问题选读,先确定流量有没有进入内核,再讨论进入之后怎样选路。
从网络栈层级解释系统代理与 TUN 虚拟网卡如何接管流量,比较对 UDP、游戏和命令行程序的覆盖差异与开启注意事项。
阅读接管机制对比 →对比三种自动策略组的选路逻辑、测速参数与适用场景,附可直接改用的 YAML 写法和嵌套 select 组的组合思路。
阅读策略组配置笔记 →系统代理已开启但网页或命令行仍直连时,分别检查浏览器扩展与代理设置、终端环境变量和 PAC 规则,逐项定位原因。
阅读系统代理排查清单 →