使用指南 / 首次配置

Clash 使用指南

导入订阅 → 选择代理模式 → 连接 → 验证生效。已有有效订阅时,可按约十分钟的首次配置流程操作;下载与网络问题另行排查。

第一步:导入订阅

先准备服务提供方给出的 Clash 订阅链接,或一份与当前内核兼容的 YAML 配置文件。客户端是加载配置、执行规则和建立代理连接的工具,安装完成并不代表已经具有可用的代理出口。开始导入前,确认设备在关闭代理时能够访问普通网页,并检查订阅是否仍在有效期内。这样后续出现问题时,可以区分原有网络故障与配置问题。

从 URL 导入配置

打开客户端的“配置”或“订阅”页面,选择“新增”“导入”或带加号的入口,再选择“从 URL 导入”。把完整链接粘贴到地址栏,给这条配置取一个容易识别的名称,然后点击保存或下载。名称只用于本地管理,不改变订阅内容。粘贴后检查首尾是否多出空格、换行或聊天软件附带的文字;不要手工删掉链接问号之后的参数,这些参数可能用于识别订阅。

等待下载和解析完成。成功后,列表中应出现新的配置条目,部分客户端还会显示更新时间或流量信息。点选这条配置,使用“启用”“使用”或“设为当前配置”,直到看到选中标记。仅把订阅保存在列表里还不够,内核需要加载它才能使用其中的节点和规则。接着进入“代理”页面,确认能看到策略组及其候选项,再继续下一步。

如果下载失败,先返回服务提供方的订阅管理页面确认链接状态,不要连续重复点击更新。浏览器能打开的网页地址不一定是订阅地址;登录页面、购买页面和个人中心都不能直接当作配置导入。报错为格式不兼容时,应选择服务提供方明确标注的 Clash 或 mihomo 格式。不要随意把含个人标识的订阅链接提交给不熟悉的在线转换服务。

从文件或二维码导入

已有本地配置时,在同一页面选择“从文件导入”,选中扩展名为 .yaml 或 .yml 的文件,等待客户端完成解析,再将其设为当前配置。文件扩展名只是线索,实际内容仍必须符合配置语法。普通文本节点列表、网页另存文件,不能只通过改名变成 Clash 配置。若文件依赖远程规则集或代理提供者,首次加载还可能需要联网获取这些资源。

客户端支持扫码时,也可以使用“扫描二维码”入口。扫描后先看识别结果:二维码可能保存订阅 URL,也可能只保存一个节点的分享链接,二者不能当作同一种完整配置。确认导入结果中有需要的节点和规则,再启用配置。订阅链接通常关联个人使用权限,截图、日志和求助信息中应遮住完整地址及其参数。

首次连接阶段先使用原始订阅,不急于编辑规则或添加覆写。确认能够正常访问后,再设置订阅自动更新;本地静态文件通常不会因为经过一段时间就自动获得新的节点。若需要理解订阅与配置文件的区别,可查阅术语手册。此时只需确认“当前配置已选中、策略组可以展开”,随后进入模式选择。

第二步:选择代理模式

回到客户端首页或“设置”,找到“运行模式”“代理模式”或 Mode。首次使用建议选 Rule,中文界面通常显示为“规则”。模式决定流量交给哪个出口,但不会替代上一阶段的订阅加载,也不会自动打开系统代理。先把模式和策略组设置好,再接管系统流量,能够减少连接过程中反复切换造成的判断混乱。

模式 出口选择方式 首次配置建议
Rule 规则 按当前配置中的规则,从上到下匹配策略组或直连出口。 作为日常使用的起点,并检查实际匹配结果。
Global 全局 进入内核的流量使用全局策略所选的出口。 用于临时对照测试,测试后切回规则模式。
Direct 直连 进入内核的流量使用直连出口。 用于临时比较直连表现,不等于关闭系统代理。

在策略组中选择节点

进入“代理”或“策略组”页面,找到订阅规则使用的主要出口组。它可能叫“代理”“节点选择”或 PROXY,具体名称由配置决定。展开后选择一个实际节点;如果列表里还有“自动选择”“故障转移”等子组,也可以进入子组确认候选节点。组名不代表固定功能,仅凭名称不能断定它当前一定会走代理,要看选中项和后续连接记录。

若主要出口组当前选中的是 DIRECT,即使某条规则指向这个组,最后仍可能直接连接。若选中的是另一个策略组,继续查看该组的选择,直到确认最终出口。部分订阅会分别设置网页、流媒体或其他用途的组;首次配置不必逐个调整,先找到目标网站实际使用的组并确认出口,避免把所有组一律改成同一个节点。

点击“测试延迟”或组旁的测试入口,等待本次结果完成。可用结果可以辅助筛选节点,但测试地址、协议和节点负载会影响读数,不能只按数值大小判断实际访问质量。出现超时的节点先跳过,选一个能完成测试的候选项,再做网页访问验证。即使测试成功,也仍需经过第四步确认目标网站能否打开。

先保留原有规则

规则模式按照配置顺序进行匹配,前面的规则通常优先,末尾的兜底规则接住尚未匹配的连接。因此,“打开规则模式”不等于“所有外部网站都自动使用代理”,实际行为取决于订阅规则。首次连接先保留原有规则,遇到个别网站异常时再根据连接详情判断。规则顺序、域名匹配与策略组引用的原理可继续阅读策略组说明,复杂修改留到连接验证完成之后。

第三步:启用连接

当前配置、运行模式和出口选择确认后,再启用流量接管。先检查客户端是否显示内核正在运行,日志中是否出现监听端口或配置加载成功的信息。如果一启动就出现配置解析错误、端口绑定失败,先处理该错误,不要仅反复切换系统代理开关。内核尚未正常运行时,把系统流量指向它会造成网页无法访问。

桌面端先使用系统代理

在桌面客户端的首页、设置或托盘菜单中打开“系统代理”。它通常会把系统 HTTP、HTTPS 代理指向本机监听地址。支持并遵循这项设置的浏览器和应用,随后才会把连接交给客户端。若页面显示 mixed-port 为 7890,常见的本机入口是 127.0.0.1:7890;但应以当前配置和设置页显示的值为准,不能照抄端口覆盖现有配置。

首次验证只保留一个代理客户端运行,并暂时关闭浏览器中会独立指定代理的扩展。旧客户端留下的代理地址可能与新客户端不同,导致系统仍把连接送往没有服务监听的端口。如果客户端提示端口占用,先退出另一个占用程序,或按客户端支持的方式调整监听端口,并确认系统代理随之更新。控制接口的端口用于管理内核,不应填进浏览器的 HTTP 代理栏;详细区别见端口设置说明。

启用系统代理后,先不同时开启 TUN。多数浏览器验证可以从系统代理开始,这样连接路径更容易检查。某些命令行工具、游戏和自带网络栈的应用可能不遵循系统代理,它们没有被接管并不必然意味着客户端故障。等浏览器验证通过后,再针对这些应用选择单独代理设置或 TUN。

移动端允许 VPN 连接

移动端回到客户端主页,点击“连接”或启动按钮。系统第一次询问是否允许添加 VPN 配置、建立 VPN 连接时,核对请求来自刚安装的客户端后再允许。完成授权后,回到客户端查看连接状态,并留意系统的 VPN 标识。这里的标识只表示系统隧道已建立,不代表订阅节点一定能访问目标网站,仍需继续验证。

若设备已经运行其他 VPN、网络过滤或抓包工具,先停止它们再连接。移动系统通常会限制此类服务同时接管网络,反复争用可能表现为刚连接就断开。若只有切到后台后容易断线,先完成前台测试,再查看系统电池管理及后台运行限制。不要为了排查网络问题关闭与此无关的系统安全功能。

第四步:验证是否生效

保持客户端运行,打开新的浏览器窗口,访问一个按当前规则应当经过代理的 HTTPS 网站,同时再访问一个预期直连的网站。不要只刷新已经打开很久的页面,已有长连接或缓存可能使本次观察不准确。网站能打开是第一层结果,接下来还要看对应连接是否进入客户端,以及最终选择了什么出口。

对照连接详情与日志

切回客户端的“连接”页面,在访问网页的同时查找对应域名或目标地址。打开连接详情,查看匹配规则、策略组链和最终节点。若页面显示这条连接命中了预期规则,并经过选定代理出口,且网页正常加载,才能确认这次访问按预期工作。直连网站在记录中使用 DIRECT 也是规则分流的正常结果,不需要为了让所有记录都显示代理而切换全局模式。

部分客户端默认只展示活动连接,短请求结束后可能很快从列表消失。可以先打开连接页再发起访问,或在日志页查找同一时间段的记录。日志里出现本地监听成功,只能证明内核已开始提供入口;出现节点连接错误,则应进一步看目标、错误类型和所用出口。临时提高日志详细程度可辅助排查,完成后恢复常用级别,分享截图前遮住订阅地址和个人网络信息。

出口 IP 查询可以作为补充,但不能单独证明所有应用都已使用代理。查询网站本身也受规则影响,可能被分配为直连;同一设备上的另一个应用也可能完全绕过系统代理。优先验证实际需要使用的网站或应用,再对照它自己的连接记录,不要把一次查询结果推广成整台设备所有流量的状态。

按现象逐项回查

网页无法打开且客户端没有新连接时,先检查浏览器是否遵循系统代理、接管开关是否打开、本机代理端口是否一致;移动端则检查 VPN 是否仍连接。若接管的是系统范围流量,但只有某个应用没有记录,应查看该应用独立的代理设置。此阶段不要先改 DNS 或规则,因为流量可能还没有进入内核。

有连接记录但最终走了直连,回到第二步检查模式、命中的规则和策略组当前选项。若记录已经使用预期代理节点却连接超时,先在同一策略组换一个候选节点,再重复访问同一网站。若换节点仍失败,且日志明确指向域名解析问题,再检查 DNS 设置。每次只改变一项并重复相同测试,才能知道哪项修改真正影响了结果。

首次测试也可以短暂使用全局模式进行对照,但必须同时确认全局策略选中了实际代理节点。若全局可用、规则模式不可用,应优先检查规则及其引用的策略组,而不是直接判定订阅整体失效。测试完成切回规则模式,保留有效出口选择。更多具体报错可查阅疑难解答,无需在首次连接阶段重写整份配置。

退出前恢复接管设置

确认连接有效后,记住当前配置名称、模式和主要出口组,日后更新订阅时先检查这三项是否保持预期。准备停止使用时,桌面端先关闭系统代理或 TUN,再退出客户端;移动端使用客户端的断开按钮结束 VPN。若退出后普通网页也打不开,检查系统是否仍保留指向本机的代理设置,并恢复到启用前的状态,不必立即卸载软件或重置整个网络。

到这里,首次配置的完成标准是:订阅已启用,规则模式下能选择出口,流量进入预期接管路径,目标网站访问与连接记录相互印证。自动更新、持久化覆写和更细的应用分流可以之后逐项添加;需要按平台长期维护配置时,再查阅全平台安装配置大全。