Windows
适合浏览器与桌面工具共用代理。下载页依次列出 Clash Plus、Clash Verge Rev 等选项;首次运行先确认配置已启用,再打开系统代理。
若程序提示端口占用,先退出其他代理工具。不要一开始就同时开启多个客户端和 TUN,否则很难判断请求由谁接管。
前往下载功能与配置
浏览器、开发工具和本地服务不一定需要相同出口。规则模式读取配置中的 rules,从第一条向下匹配,命中后就使用对应策略。在客户端的「代理」页选规则模式,再到「规则」页核对匹配顺序。与全局模式相比,它能保留局域网和指定网站直连,但结果取决于规则本身。下面的 Proxy 必须对应已有策略组,兜底 MATCH 放在最后,避免前面的细分条件失去作用。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,Proxy
- GEOIP,CN,DIRECT
- MATCH,Proxy订阅把远程配置拉到本地,省去逐条录入代理参数。在「配置」页选择「从 URL 导入」,粘贴服务提供方给出的配置地址;导入成功后,还要选中并启用该配置。与直接编辑单个 YAML 文件相比,订阅适合持续更新,但远程内容可能覆盖本地改动。需要保留自定义规则时,优先使用客户端的覆写或合并功能。下面仅展示远程代理集合的配置结构,示例地址不能用于实际连接,也不等于完整订阅文件。
proxy-providers:
remote:
type: http
url: "https://example.com/proxies.yaml"
path: ./providers/remote.yaml
interval: 3600「规则」「全局」「直连」决定已经进入内核的请求如何处理,不决定哪些应用会进入内核。日常使用一般选规则;临时排查规则是否误命中,可以切到全局,再检查全局策略组的选择;需要直接访问时切到直连。全局模式不等于接管全部应用,未遵循系统代理的程序仍可能绕过客户端。与反复修改规则文件相比,切换模式便于对照测试,但测试结束应恢复原设置,避免影响本地网络资源。
# rule / global / direct
mode: rule部分游戏、命令行工具或后台服务不会读取系统代理,TUN 可通过虚拟网络接口接管更多连接。在桌面客户端「设置」中安装所需服务,再开启「TUN 模式」,具体权限以客户端提示为准。与系统代理相比,TUN 更接近网络层接管,也更容易与其他 VPN、虚拟网卡或企业路由冲突。首次启用前先确认普通代理可用,再检查路由和 DNS。下面是 mihomo 配置片段,不适用于所有移动端界面,也不应整段覆盖现有配置。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53网页打不开时,先在「连接」页确认是否出现目标请求,再到「日志」页找同一时间的报错。连接详情通常能显示命中的规则与策略链;日志则帮助区分域名解析、建立连接和配置加载问题。相比只看测速结果,失败请求的完整上下文更有用。日常保持 info,需要复现问题时短暂切到 debug,完成后恢复。分享日志前删去订阅地址、认证信息和个人访问记录,不能只遮住代理名称就直接公开整段输出。
# 临时诊断时可改为 debug
log-level: info桌面端、手机和路由器可以采用相近的规则结构,但客户端按钮、内核能力和系统权限不同。先到下载页按设备选择,再核对配置支持范围;不要仅凭文件能导入就认定所有字段都生效。与直接运行内核相比,图形客户端集中管理配置与开关,更适合日常使用。跨设备迁移时检查本地文件路径、监听端口及 TUN 参数。下面把控制接口限制在本机,局域网访问默认关闭,避免把桌面环境设置原样带到其他网络。
mixed-port: 7890
allow-lan: false
external-controller: 127.0.0.1:9090Clash 是一类规则代理工具的生态名称,不是一个在所有系统上界面完全相同的软件。下载前先确认设备系统,再区分图形客户端与内核:前者提供配置页、代理页和系统开关;后者主要负责读取配置与处理连接。第一次使用选图形客户端即可,不需要先学习服务管理或命令行启动参数。
安装包名称中的处理器标识也要对应设备。系统相同不代表包能通用,尤其是桌面端的不同架构。更新时先退出正在运行的客户端,保留原配置和必要设置;如果迁移到另一个客户端,优先重新导入订阅,而不是直接复制整个程序数据目录。
适合浏览器与桌面工具共用代理。下载页依次列出 Clash Plus、Clash Verge Rev 等选项;首次运行先确认配置已启用,再打开系统代理。
若程序提示端口占用,先退出其他代理工具。不要一开始就同时开启多个客户端和 TUN,否则很难判断请求由谁接管。
前往下载先在「关于本机」确认 Apple Silicon 或 Intel,再选对应安装包。Clash Plus、Clash Verge Rev 与 FlClash 等客户端入口集中在下载页。
安装后按系统提示处理必要权限。遇到网络扩展或钥匙串弹窗,先核对应用来源与操作场景,不要通过批量关闭系统保护来绕过提示。
前往下载Clash Plus、Clash Meta for Android、FlClash 与 Surfboard 分别有自己的界面及配置支持范围。先确认订阅格式,再选客户端,不要假设同一个链接处处通用。
首次连接需同意系统 VPN 请求。若锁屏后断连,再检查后台运行和电池限制;分应用代理设置也会影响哪些程序进入代理通道。
前往下载下载页提供 Clash Plus 的 App Store 入口,官网为 clashplus.io。安装后导入配置,再按提示允许添加 VPN 配置。
连接开关亮起只说明通道已建立,还需访问目标网站确认实际结果。更换无线网络或蜂窝网络后若出现异常,先重新连接并查看日志。
前往下载桌面用户可从 Clash Verge Rev、FlClash 开始;服务器和路由器用户再考虑直接运行 mihomo。软件包格式要与发行版的包管理方式对应。
图形界面的系统代理通常只影响遵循桌面代理设置的应用。终端工具可能还需单独设置代理环境变量,不能用浏览器能否打开网页替代验证。
前往下载第一次配置只做必要操作:导入订阅、选中当前配置、选择规则模式、开启适合当前系统的连接入口。随后打开一个明确的目标网站,并在连接页核对它命中的策略。先验证这一条链路,再尝试 TUN、开机自启和局域网共享,能减少多个变量同时变化造成的误判。
Clash 节点测速只能说明某个测试目标在当时的连通情况,不代表所有网站的实际体验。若测速正常而业务请求失败,应继续检查目标域名、规则命中和日志原文;若仅某个应用失败,应先确认该应用是否读取系统代理。连接问题的入口在问题诊断,不必靠反复卸载来试错。
系统代理是把代理地址告知愿意遵循它的应用;全局模式是内核收到请求后选择出口的方式;TUN 则改变更多请求进入内核的路径。三者分别处理不同环节,不能互相替代。需要了解模式差异时,先看模式选择;需要给单个工具填写代理地址时,再看端口设置。
Clash 生态经历了原项目、后续内核与不同图形客户端并行发展的过程。今天搜索到的教程可能对应不同年代的界面,也可能使用相同的按钮名称却依赖不同内核。本站把安装入口、上手步骤与故障查阅分开组织:下载页处理设备和客户端选择,教程页处理第一次配置,问题诊断页处理已有配置为什么没有按预期工作。
旧截图可以帮助理解概念,却不应当作为当前按钮位置或字段支持范围的唯一依据。看到配置报错时,先确认运行中的内核和客户端,再核对字段是否受支持。尤其不要为了照着旧教程操作而直接换回已经停止维护的程序;确需使用归档客户端时,应理解其兼容性与维护状态。
mihomo 是 Clash 生态中持续发展的内核项目之一,负责规则匹配、代理连接与相关网络处理;图形客户端在其上提供订阅管理、策略组选择、日志查看和系统集成。客户端更新与内核更新不是同一件事:界面变化不一定改变规则语法,内核能力变化也不一定立刻出现在界面中。具体支持情况应回到对应项目的发布说明和文档确认。
这也是配置示例需要注明使用环境的原因。一个能在桌面 mihomo 上工作的片段,不代表能直接导入所有手机应用。更换客户端前,先保留订阅来源、覆写规则和必要的本地参数,再逐项迁移。只复制能够理解的配置段,比把整份旧文件直接覆盖到新环境更容易排查。
公开源码可以用来理解配置字段、查阅问题讨论或参与开发。下面的命令从 mihomo 项目仓库获取源码,需要设备已经安装 Git,并能访问仓库。它不是安装客户端的命令,也不会自动生成可直接使用的图形程序。普通使用者前往下载页选择安装包即可;只有准备阅读源码或按项目文档构建时,才需要执行克隆。
git clone https://github.com/MetaCubeX/mihomo.git
客户端、内核和订阅有各自的更新来源。更新客户端主要改变程序与集成能力,更新订阅则会改变代理集合、策略组或规则内容。遇到「昨天可用,今天失败」时,先回顾哪一项发生变化,再找对应日志。保留一份可恢复的配置副本,并记录本地覆写内容,能避免在恢复连接时把自己的规则一起丢掉。
更新后至少复查当前配置是否仍被选中、规则模式是否符合预期、策略组是否仍有可用选项,以及本地端口是否发生变化。配置页面显示更新成功,只能证明获取和解析流程走通,不能代替实际目标请求的验证。涉及规则数据库时,可继续阅读GeoIP 相关问题;看到连接超时,转到超时排查按顺序检查。
策略组不是代理协议。 它负责把多个候选出口组织成选择、测速或故障转移逻辑,组内实际代理才有各自的协议参数。手动切换组内选项,可能改变后续连接的出口,但已经建立的长连接不一定立即重连。看不懂组名与嵌套关系时,先查Clash 策略组,不要随意删除被规则引用的组。
订阅更新不是规则必然更新。 有些订阅只提供代理集合,有些提供完整配置,还有些规则来自独立的规则集合。更新按钮作用于哪部分,要看客户端和配置结构。若更换代理后某个网站仍直连,应检查命中规则,而不是连续刷新订阅。配置层级的解释可在名词解释中按分类查找。
开机启动不等于自动连接。 启动程序、恢复上次配置和启用系统代理可能是不同选项,系统权限也会影响恢复结果。需要开机后可用时,先手动验证完整连接流程,再设置自启并重启测试。若只出现界面但网络没有接管,可到开机自启问题核对设置,不要把它当成订阅失效。
近期使用资料
先完成基础连接,再按当前问题读对应文章。配置结构、订阅格式与系统权限分别影响不同环节,不需要一次修改全部设置。
按配置文件的书写顺序逐段解释各字段的作用与常见写法,帮助看懂并安全修改自己的 config.yaml。
阅读文章从复制订阅地址到更新生效的完整步骤,并对比几种常见订阅格式,解释导入失败时应先检查哪一项。
阅读文章梳理 macOS 上首次运行时的「已损坏」提示、网络扩展允许步骤与钥匙串反复弹窗的成因和处理办法。
阅读文章