Windows
日常桌面使用先查看 Clash Plus,也可比较 Clash Verge Rev 与 FlClash。安装前核对系统支持范围;启用系统代理后,浏览器通常可以读取设置,部分游戏或商店应用则需要另查 TUN、回环访问与防火墙条件。
前往下载CONFIGURATION INDEX
Clash 配置中的节点、策略组与规则分别承担出口定义、出口选择和连接匹配。先确认配置能被当前内核解析,再调整系统接管方式,能把“配置错误”与“权限不足”分开排查。苹果平台还需要核对客户端支持范围,不能仅凭相似的界面名称判断字段兼容性。
RULES / FIRST MATCH
规则从上到下检查,命中后交给指定策略,因此特定域名应放在兜底规则之前。先在客户端选择规则模式,再通过连接记录核对命中的条目;只修改文件而未重新加载,不会改变正在运行的配置。苹果平台的分流结果还取决于连接是否进入客户端,系统代理未接管的应用不会参与这套匹配。相比全局模式,规则模式可以为局域网和指定站点保留直连;已有订阅规则时,宜通过客户端覆写入口追加,避免下次更新覆盖。
# 此片段只使用内置策略
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,REJECT
示例用 REJECT 拦截其余连接,仅用于解释兜底顺序;实际使用时应替换为已定义的代理策略组。
PROXY GROUPS / SELECTION
策略组把节点组织成可切换的出口。手动组适合固定使用某条线路,自动测试组则根据指定网址的探测结果选择候选项;测试耗时不等于所有网站的实际访问速度。在苹果客户端的代理页面展开策略组后,可以查看当前选择并触发测试,字段支持仍以所用内核为准。与单纯逐个选择节点相比,嵌套策略组便于在手动和自动之间切换。修改组名时必须同步检查规则引用,避免配置加载时出现找不到策略的错误。
# DIRECT 为内置策略;配置实际节点后再加入候选列表
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
rules:
- MATCH,PROXY
TUN / NETWORK STACK
系统代理主要服务于遵循代理设置的应用,TUN 则通过虚拟网络接口接收更多连接,适合应用不读取系统代理的情况。macOS 客户端可能要求安装服务或批准网络扩展,具体取决于其实现;iOS 通常通过系统 VPN 配置建立隧道,并不等于可以直接套用桌面端的全部 TUN 字段。切换前先停用其他接管网络的工具,保留原配置。若开启后局域网访问异常,应检查路由与排除项,而不是反复更换节点。
# 需要客户端支持与相应系统权限
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
DNS / RESOLUTION
域名无法解析和代理连接超时是两类问题。先查看日志是否获得目标地址,再核对解析请求经过哪个网络出口;只看到浏览器报错不足以定位节点故障。mihomo 可在支持的客户端中启用独立 DNS 配置,苹果移动端是否开放对应字段需要查阅客户端说明。与直接沿用系统解析相比,独立配置有助于控制解析路径,但同时涉及上游可达性、缓存与规则匹配。修改后应重新加载配置并建立新连接,避免旧缓存干扰验证。
# 上游应按当前网络可达性选择
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://1.1.1.1/dns-query
SUBSCRIPTION / LIFECYCLE
客户端订阅通常导入完整配置,节点提供器则只补充节点集合,两者不是同一种文件入口。在配置页面粘贴链接后,先确认下载成功、配置已选中,再检查策略组是否出现。苹果平台的导入按钮名称可能不同,但检查顺序相同。相比直接编辑远程配置,独立覆写更适合保存个人规则;更新订阅前还应记录自定义内容。订阅地址可能含有访问凭据,应保存在可信客户端中,分享日志或截图时隐藏完整链接。
proxy-providers:
local-nodes:
type: file
path: ./providers/local.yaml
proxy-groups:
- name: PROXY
type: select
use:
- local-nodes
rules:
- MATCH,PROXY
先准备包含有效 proxies 列表的本地文件;此片段本身不提供代理节点。
CLIENT SHELF
先确认操作系统,再确认处理器架构,最后核对客户端所用内核及配置格式。相同的订阅地址可以在多个设备导入,但系统权限、代理端口与网络接管选项不能照搬。下载页按平台集中列出安装入口、归档状态和适用条件,版本信息也在客户端明细中查看。
日常桌面使用先查看 Clash Plus,也可比较 Clash Verge Rev 与 FlClash。安装前核对系统支持范围;启用系统代理后,浏览器通常可以读取设置,部分游戏或商店应用则需要另查 TUN、回环访问与防火墙条件。
前往下载在“关于本机”中辨认 Apple Silicon 或 Intel,选择对应安装文件。首次运行后按客户端提示批准必要权限;系统代理、后台服务与网络扩展各有用途,不应把每个授权弹窗都理解为同一种网络开关。
前往下载从 Clash Plus、Clash Meta for Android 等客户端中按配置需求选择,下载时区分 ARM64 与其他架构。建立 VPN 连接后,再检查后台运行和电池限制;息屏后断连不一定是订阅失效,也可能与系统后台策略有关。
前往下载优先查看 Clash Plus 的 App Store 入口,产品信息可在 clashplus.io 核对。导入受支持的订阅后按系统提示添加 VPN 配置,再回到客户端连接;桌面端字段是否可用,应以移动端实际支持为准。
前往下载桌面环境可选 Clash Verge Rev 或 FlClash,先核对发行版的软件包格式。服务器和路由器用户再考虑独立 mihomo 内核;命令行运行、服务管理与防火墙路由需要分别配置,安装图形客户端不等于终端已自动使用代理。
前往下载QUICKSTART / THREE CHECKPOINTS
首次配置建议保持客户端默认网络选项,沿着“配置有效→出口可用→应用进入代理”的顺序检查。每次只改变一个条件,并观察日志结果,比同时修改 DNS、规则和 TUN 更容易定位问题。开始前应准备受支持的配置文件或订阅链接;下载客户端本身不会生成可用的代理服务。
01 / IMPORT
打开配置或订阅页面,新建远程配置并粘贴完整链接,等待客户端提示更新成功,再将它设为当前使用项。随后进入代理页,核对策略组及候选节点是否出现。若导入失败,先检查链接是否过期、返回内容是否为支持的配置格式,以及当前网络能否访问订阅地址;不要把网页地址或登录页面当作订阅导入。
02 / CONNECT
在策略组中选择可用节点,再启用系统代理或客户端提供的 VPN 连接。macOS 首次启用服务、iOS 首次添加 VPN 配置时,完成系统授权后返回客户端确认连接状态。已有其他 VPN 或代理工具运行时,先停用其中一个,避免路由与端口相互影响。规则模式便于保留直连需求,全局模式仅适合短时对照测试。
03 / VERIFY
打开一个允许访问的目标页面,同时查看客户端连接记录,核对目标域名、命中规则和实际出口。能看到连接但请求失败,应继续检查节点和解析;完全看不到连接,则先确认应用是否读取系统代理或进入隧道。验证时重新打开页面或重建连接,已有的长连接可能继续沿用切换前的出口,不能据此判断新设置是否生效。
OPEN SOURCE / PROJECT BOUNDARIES
Clash 原版项目停止维护后,生态中的配置格式与使用习惯仍被不同社区项目沿用。判断一个客户端是否适合继续使用,应查看它自身的维护状态、所用内核和当前系统兼容说明,而不是只看名称中是否带有 Clash。归档客户端可以帮助理解旧配置,但遇到新协议或系统网络变化时,不应预期它能自动获得支持。
mihomo 由 Clash Meta 分支演进而来,主要负责协议处理、规则匹配、策略组和网络栈等能力。图形客户端则在此基础上提供配置管理、系统代理、权限提示和日志界面。内核能识别某个字段,不代表每个图形客户端都开放对应选项;客户端升级也不一定同步替换其内置内核。查阅配置说明时,应把这两个层次分开。
macOS 桌面客户端可以通过系统代理、后台服务或网络扩展完成不同范围的流量接管,iOS 则受系统应用与隧道接口约束。不同产品可能使用不同实现,不能把“支持 Clash 配置”直接等同于“使用 mihomo 内核”。选择客户端时,先确认订阅格式、所需协议和分流能力,再核对本机系统授权步骤,能减少导入成功但实际功能不一致的情况。
更新前保存可恢复的配置,并记下自行添加的规则、端口与网络设置。阅读客户端及内核的变更说明,关注字段废弃、默认行为和权限流程的变化;更新后用相同目标重新验证规则命中与出口。项目源码、发布记录和问题讨论可以用于核对实现,但不能代替对本机网络条件的测试,也不能证明任意第三方订阅的可用性。
git clone https://github.com/MetaCubeX/mihomo.git
此命令仅下载源码;编译和运行需要另行准备开发环境。
READING / RECENT NOTES
基础连接完成后,再按当前遇到的问题查阅专题。界面操作文章用于定位设置入口,生态说明用于确认功能归属,平台排查则处理系统自身的网络限制。修改前记录当前状态,按照文章中的适用条件逐项检查,避免把其他平台的解决步骤直接套用到本机。
按界面区块说明策略组切换、订阅管理与日志级别筛选。首次使用时可先找到配置选择入口,再回到代理页检查当前出口,最后使用日志核对加载与连接错误。
阅读全文 →区分原版内核、Meta 分支与 mihomo,说明图形界面和内核之间的依赖关系。用于核对协议与配置能力,避免把客户端名称、支持格式及实际内核实现混为一谈。
阅读全文 →说明 UWP 应用的本机回环访问限制,以及 CheckNetIsolation 命令和客户端工具的处理方式。先确认应用类型和本地代理监听,再按需设置豁免,并保留恢复方法。
阅读全文 →