Windows
在「设置 → 系统 → 关于」查看系统类型。先对照下载页提供的架构,再选安装包。换客户端前先退出旧程序,确认托盘里的后台进程也已结束,避免两个实例都在尝试监听同一个端口。
INSTALL / PLATFORM
先确认操作系统和处理器,再挑客户端。同一项目可能分别提供不同架构的安装包,名称相近也不能混装。初次使用建议选图形客户端:导入配置、查看连接和切换策略都能在界面里完成。已经在路由器或服务器上管理网络服务,再考虑单独部署内核。
在「设置 → 系统 → 关于」查看系统类型。先对照下载页提供的架构,再选安装包。换客户端前先退出旧程序,确认托盘里的后台进程也已结束,避免两个实例都在尝试监听同一个端口。
在「关于本机」看芯片或处理器一栏,分别选 Apple 芯片或 Intel 安装包。客户端出现在菜单栏,通常只说明程序正在运行。导入配置后,还要确认当前配置已启用,并按需开启系统代理。
选择与设备应用架构匹配的安装包,不能仅凭手机型号里写着「六十四位」就下结论。首次连接时留意系统 VPN 授权提示。如果设备原先启用了另一个本地 VPN,先确认是否需要断开它,再启动新客户端。
从下载页进入 Clash Plus 的 App Store 页面,查看应用详情中的系统要求。安装后先核对客户端支持的导入格式。建立连接时按系统提示添加 VPN 配置,之后回到客户端确认当前使用的是哪份配置。
先看发行版支持哪种包格式,再核对架构。桌面环境可考虑图形客户端;纯命令行环境则要自行安排配置目录、进程启动与日志保存。迁移到另一台机器时,记得核对规则集和本地文件引用,不只复制主配置。
旧教程里出现的同名按钮,在新客户端里可能被移到不同位置。尤其是从已停止维护的 Clash for Windows 迁移时,先保留自己添加的规则与覆写,在新客户端重新导入配置。不要直接搬整个旧工作目录:除了配置文件,目录里还可能有缓存和只对旧界面有效的设置。
CONFIG / INSPECTION
排查时把三个问题分开:请求有没有进内核,进来后命中了什么规则,最后走了哪个出站。下面的片段分别说明一个字段,不是整份可直接替换的配置;需要查字段取值和依赖关系,可翻完整配置字段参考。
规则模式按列表从上往下判断,命中后就不再检查后续条目。要让某个子域名走与主域不同的路线,先写精确域名,再写覆盖面更广的后缀规则,最后用兜底规则收口。与全局模式不同,规则模式可以在同一份配置里指定不同出站。修改后用连接记录核对实际命中项;如果规则指向自定义策略组,还要确认规则里的名称与组名完全一致。
mode: rule
rules:
- DOMAIN,blocked.example.com,REJECT
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,DIRECT
策略组把规则和具体出站分开。规则写组名,组负责决定实际出口。手选组适合固定出口或临时对照测试;自动测速组按探测地址及测得的延迟选择候选项。下面示例里的两个节点名需要在同一份配置中定义。给组改名时要同步更新引用它的规则。测速结果只反映到探测地址的表现,排查下载慢或连接中断时,还要测试实际业务地址。
proxy-groups:
- name: 手动出口
type: select
proxies:
- 节点甲
- 节点乙
- DIRECT
域名还没解析成功时,切换节点通常不能直接解释故障。先检查客户端日志有没有解析超时,再确认发出查询的是浏览器、操作系统还是内核。开启内核的解析功能,并不意味着所有应用都改用这套解析设置。示例使用返回真实地址的模式,便于对照结果;实际要使用的解析服务,应按本机网络环境及配置需要选择,每次只调整一项再复测。
dns:
enable: true
enhanced-mode: redir-host
nameserver:
- 223.5.5.5
系统代理依赖应用读取并遵守代理设置,TUN 则通过虚拟网卡和路由引入流量,适合处理不读取系统代理的应用。能否正常启用取决于权限、平台和已有路由。首次测试时先记录原来的接管方式,只开启一种方式,再分别检查外部站点和局域网设备。若开启后公司内网或打印机失联,先恢复原设置,确认路由变化,再决定怎样处理例外流量。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
混合端口能在同一个监听口接收 HTTP 和 SOCKS 代理请求。应用配置里的地址和端口指向本地监听器,不是远程节点的地址。本机自用时保持回环监听;出现端口占用,就先确认哪个进程已经在监听。改端口后,浏览器或终端里手动填写的代理地址也要一并更新。否则客户端仍能启动,但这些应用会继续连到旧端口,甚至错连另一个代理进程。
mixed-port: 7890
allow-lan: false
SETUP / FIRST RUN
首次测试用一个平时能访问的网站,先记下未开启代理时的表现。接下来一次只改一个设置;遇到问题,可以回到上一步,看故障在哪次改动后出现。
进入客户端的「配置」或「订阅」,选择从文件导入,或输入来源可信的订阅地址。导入后选中该配置,查看规则和策略组是否加载。列表里已有一条记录,不等于内核正在用它。遇到解析错误,先记下提示指出的字段或行号;现有文件保留一份,再改副本里的缩进、列表层级或字段类型。
用规则模式测试,再在相关策略组里选定一个出站。桌面端可先用系统代理测试会读取系统设置的应用;移动端按客户端提示建立系统 VPN。暂时不要同时换模式、节点和接管方式。如果只是想让一个终端工具通过代理连接,可以先按它自己的文档配置代理地址,不必立即改整机路由。
打开测试页面,然后到客户端的连接列表找目标域名,核对规则与出站。如果连记录都没有,先检查应用有没有接入;如果有记录,但命中了兜底,回头看规则的顺序与域名写法;如果命中正确仍然超时,再查目标站点和所选出站的连通性。报错时记录时间、模式和错误信息,分享日志前删去订阅地址及鉴权信息。
测速请求与网页请求可能走不同规则,目标地址也不同。先看网页请求是否进入连接列表,再核对实际出站。读数只能说明那一次探测的结果。相关名词见术语手册。
先保留可用配置。查看更新报错是请求超时、授权失败,还是格式解析失败,再按具体原因处理;远端内容无法读取时,反复重装客户端通常不能解决。可先在术语手册区分订阅与本地配置。
命令行程序不一定读取系统代理。有的读取环境变量,有的需要单独设置;先查该工具的说明,再到客户端看有没有入站记录。网络接管方式可参照术语手册。
SOURCE / MAINTENANCE
项目名、客户端名和订阅来源是三件事。查一个字段时,先看真正加载配置的是哪个内核;查安装、更新或界面问题时,再回到具体客户端的说明。
Clash 生态长期使用 YAML 描述入站、出站和规则。mihomo 延续了原来称作 Clash.Meta 的内核项目。旧资料沿用早期命名很常见,遇到旧文档里的界面截图或参数时,先确认对应的是哪个项目。相似的名字只能作为检索线索,不能用来判断某个字段仍然可用,也不能据此认定两个安装包来自同一个维护方。
mihomo 源码仓库采用 GPL-3.0 开源协议,可在上游仓库查阅代码、变更记录和问题讨论。该协议对应的是内核项目,不能据此推定每个图形客户端都采用相同协议。提供 GUI 的项目各自维护交互、系统集成与发行包;订阅则由配置提供方维护,更新订阅不会替换客户端或给系统安装新内核。
内核负责处理入站、按规则选出站并执行连接。图形客户端除了展示这些信息,还可能合并订阅、覆写和全局设置,再把结果交给内核。遇到配置文件里写了规则、界面里却没生效的情况,先确认活动配置,接着查覆写的应用顺序,最后对照连接记录。只看编辑器里的原始文件,容易遗漏客户端后来加上的设置。
更换安装包先看客户端的发布说明;涉及规则语法、DNS 行为或虚拟网卡支持,再查所用内核的变更。更新前记录当前配置和接管方式,保存本地规则及覆写副本,更新后用同一个目标测试。若只是新增一条规则,单独保存和测试规则比同时更新程序、规则集和订阅更容易定位变化。
NOTES / LATEST
找不到连接记录,先看代理有没有接管请求;有记录但路线不对,再查模式。准备换客户端时,先核对必须保留的功能和配置迁移方式。
分两条线排查:浏览器侧检查代理插件与系统设置是否被覆盖,终端侧检查 http_proxy 环境变量与命令行工具的代理读取方式。
按平台覆盖、内核版本、界面操作、TUN 支持与订阅管理逐项比较主流客户端,按不同使用场景给出选型建议。
用流量走向图解释 rule、global、direct 三种模式的判定逻辑,给出日常使用、临时排查与测速时各自的切换建议。