使用文档 / 首次配置

Clash 订阅导入与连接教程

按订阅、模式、连接、验证的顺序完成首次设置。已有有效配置时,可按约十分钟的操作流程逐步检查。

开始前,先安装与设备匹配的客户端,并准备服务提供方给出的订阅链接或兼容配置文件。尚未安装可前往客户端下载页。客户端负责读取配置和转发请求,安装软件本身不会自动生成代理节点,也不代表已经获得可用线路。

首次配置先保留默认设置,仅完成下面四步。这样遇到问题时容易定位到具体环节,不必同时检查 DNS、虚拟网卡和自定义规则。本文解决首次连通;配置语法、规则优先级及网络接管原理见Clash 系统教程。

1. 导入订阅并启用配置

打开客户端后,先进入「配置」或「订阅」页面。首次启动时这里可能为空,这是尚未添加配置的正常状态。点击「新增」「添加订阅」或带加号的按钮,选择远程链接方式。将服务提供方页面中的完整订阅地址复制到链接输入框,给配置填写便于识别的名称,例如「日常配置」,再点击「保存」「导入」或「下载」。

粘贴后先检查链接开头和结尾,避免复制进空格、换行或说明文字。订阅地址通常包含访问凭据,应按账号信息保管,不要发到公开评论区,也不要将完整链接截图用于求助。服务提供方若提供多种客户端格式,应选择明确支持当前客户端内核的 Clash 或 Mihomo 配置格式,而不是把任意节点分享链接直接当作完整订阅导入。

保存后等待客户端完成下载和解析。成功时通常会出现一张配置卡片,显示你填写的名称;部分客户端还会提供更新时间或更新按钮。出现配置卡片不一定表示已经启用。点击卡片,或使用卡片菜单里的「使用」「启用」选项,直到出现选中标记。随后进入代理页面,确认能看到配置中的策略组和可选线路,再继续下一步。

使用本地配置文件

如果拿到的是文件,在配置页面选择「从文件导入」,选取服务提供方给出的 YAML 文件。导入后同样需要选中并启用。不要只根据扩展名判断内容是否正确:网页另存为的登录页面即使改名为配置文件,也不能被内核识别。若客户端提示解析失败,先重新获取原始文件,不要在不熟悉格式时随意删除报错附近的行。

本地文件和远程订阅的后续维护方式不同。远程订阅一般可以点击更新重新获取内容,本地文件则通常需要重新导入或手动替换。首次使用任选一种明确可用的来源即可,不必将同一份配置重复添加多次,否则后续容易选中旧配置,误以为新订阅没有生效。

导入失败时先检查来源

如果提示下载失败,回到服务提供方页面确认订阅是否有效、是否需要登录,以及是否复制了正确的客户端专用地址。若提示格式不支持,应区分「下载到了内容」与「内容能够解析」这两件事。此时切换全局模式通常不能解决格式错误,也没有必要立即修改系统 DNS。先让配置成功载入,再处理连接问题。

本步完成的判断标准是:配置页面有明确的当前配置,代理页面能够显示其策略组,并且没有持续出现配置解析错误。达到这个状态后,下一步只需要确定请求应按什么方式分流,以及代理组实际选择哪条线路。

2. 选择规则模式与代理策略

进入「代理」页面,或在首页寻找模式切换控件。常见选项是「规则 / 全局 / 直连」,对应英文 Rule、Global、Direct。首次使用先选择规则模式。它会按当前配置判断请求应直连、走代理还是被拒绝,适合日常访问,也便于后续通过命中记录解释某个网站为什么使用了特定出口。

选择模式后,还要检查策略组。模式决定如何作出路由判断,策略组则决定规则指向代理时具体使用什么。点击配置中的主要代理组,查看当前选中项。组名由配置作者定义,可能是「Proxy」「节点选择」或其他名称,因此不能仅凭组名认定它一定负责所有请求;优先参考服务提供方的配置说明。

若主要代理组选中了 DIRECT,请先确认这是否符合预期。DIRECT 表示直连,不是代理节点。对于需要代理的目标,通常应选择一条可用线路,或者选择配置已经提供的自动选择组。手动选择适合首次排查,因为出口明确;自动选择适合配置已验证可用后使用,具体切换逻辑取决于配置内容。

首次配置中的三种模式
模式 实际作用 首次使用建议
规则 依据配置中的规则选择直连、代理或其他策略。 作为默认起点,验证时检查命中的规则与策略组。
全局 将已进入内核的请求交给全局策略处理。 用于短时间对照,仍需选择有效的全局策略。
直连 让已进入内核的请求直接连接目标。 用于直连对照,不用于验证代理出口。

全局模式不等于接管所有应用

全局模式只改变已经到达代理内核的流量如何路由,不会自动让原本绕过系统代理的应用进入内核。如果浏览器可以使用代理,而某个桌面应用没有请求记录,反复切换规则和全局通常没有帮助。先完成下一步的流量接管,再判断是否需要 TUN。

客户端若提供测速按钮,可以对当前策略组执行一次测试。测试成功说明该检测目标在当时能够通过对应线路访问,但不保证所有网站和应用都可用;测试超时也可能与检测地址有关。首次操作不用反复追求最低数字,先选一条能完成实际网页访问的线路即可。

本步结束前,记住两个当前值:模式为「规则」,主要代理组选择了哪条线路或哪个自动组。后续出现异常时,这两个值能帮助复现问题。关于规则顺序、嵌套策略组与自动选择机制的深入说明,可继续阅读系统教程,首次连接不必先修改它们。

3. 开启连接与系统流量接管

配置和策略选好后,回到首页启动连接。部分桌面客户端启动应用时内核已经运行,部分需要点击「启动」或电源按钮。先确认没有内核启动失败的提示,再开启系统代理。这里要区分「内核运行」和「应用请求已经进入内核」:前者只是本机服务准备好,后者才决定浏览器访问能否使用刚才选定的策略。

桌面端先使用系统代理

在 Windows、macOS 的常见桌面客户端中,打开「设置」或「网络设置」,找到「系统代理」并开启。有些客户端也在托盘或菜单栏右键菜单中提供同名入口。首次测试使用这一方式即可,浏览器通常会遵守系统代理设置。Linux 桌面环境的代理设置方式存在差异,若客户端不能自动写入,请先查看当前客户端说明,不要照抄其他系统的菜单路径。

如果浏览器此前安装过代理切换扩展,先将扩展设为使用系统代理,或暂时停用其独立代理规则;如果浏览器自身设置了其他代理地址,也应先恢复到与系统一致的状态。否则客户端显示已开启系统代理,浏览器却仍可能连接另一个端口,造成订阅和线路都正确但网页无法打开的情况。

首次连接不需要手动修改混合端口。只有日志明确提示端口被占用,或者其他应用必须手动填写代理地址时,再核对客户端实际监听的本机地址和端口。不要从其他教程照抄一个数字后直接填进浏览器;不同客户端、不同安装历史可能使用不同设置。

移动端按系统提示授权连接

在 Android 或 iOS 客户端中,点击首页的「连接」或电源按钮。首次连接时,系统通常会请求建立 VPN 连接或添加 VPN 配置,确认来源是当前安装的客户端后按提示允许。返回应用,等待连接状态稳定。系统中的 VPN 标识表示网络隧道已建立,但线路是否可用,还需要下一步的实际访问验证。

如果点击连接后立刻断开,先查看应用内错误信息,并检查是否有另一款 VPN 正在占用连接。首次测试时只保留一个负责接管网络的客户端,避免多套代理工具相互覆盖。不要在状态还未稳定时连续点击连接按钮,这会让启动和停止记录交错,增加判断难度。

何时再考虑 TUN 模式

当浏览器验证正常,而某个不遵守系统代理的应用仍需要代理时,再考虑 TUN。它通过虚拟网络接口接管流量,通常需要服务模式、管理员权限或系统授权;具体要求以客户端提示为准。TUN 的覆盖范围仍受路由、排除项及系统限制影响,并非开启后所有异常都会自动消失。

本教程首次测试先不叠加 TUN,减少变量。确需开启时,先记住现有设置,按客户端说明完成权限授权,再重新验证。若开启后整个设备无法联网,应先关闭 TUN、恢复到刚才可用的系统代理方案,再查阅系统教程中的网络接管说明,不要同时更改 DNS 和路由。

4. 验证请求与代理出口

连接状态稳定后,重新打开浏览器,先访问一个平时能够直连的普通网页,确认基础网络仍然正常。接着打开你实际需要代理的目标页面,观察内容是否完整加载。不要仅刷新已经缓存的旧标签页,也不要只看网页标题是否出现;页面正文、图片和后续请求能否完成,更能反映实际访问状态。

保持目标页面打开,切回客户端的「连接」或「日志」页面。再次刷新网页,寻找此时产生的新请求,核对目标域名、命中规则和最终策略。有些客户端的连接记录结束后会立即消失,可以在刷新前先打开记录页面,或改看近期日志。看不到记录时,也要先确认日志筛选条件没有隐藏相关请求。

把网页结果与路由记录放在一起判断

在规则模式下,部分网站显示 DIRECT 是预期行为,不代表代理失败。真正需要核对的是:应当走代理的目标是否命中了预期策略组,该策略组是否最终选择了代理线路,以及页面是否能正常加载。如果主要策略组内部又指向其他组,需要查看客户端展示的完整选择链,而不是只看最外层名称。

如需进一步确认出口,可以使用可信的出口地址查询页面进行连接前后对照,但要注意该查询页面本身也受规则分流控制。如果查询请求走直连,它显示的仍会是本地网络出口;不能据此推断其他网站没有使用代理。出口地址、请求记录和实际网页结果应互相印证,不要只依赖其中一项。

网页打不开时,按顺序回查

如果客户端没有出现对应请求,先回到第三步检查系统代理是否开启、浏览器是否使用系统设置,以及是否存在其他代理扩展或 VPN。此时优先解决请求入口,不要急着换订阅。如果请求已经进入内核但连接失败,再检查当前策略组是否选错、线路是否可用,以及日志中是否存在明确错误。

若规则模式失败,可短暂切到全局模式作为对照,并确认全局策略也选中了有效线路。全局可用而规则不可用,说明应重点检查规则命中或策略组选择;两种模式都失败,则继续检查订阅有效性、线路和本地网络。对照结束后切回规则模式,避免把临时测试状态长期保留。

若只有一个网站或一个应用失败,不要立即重置整份配置。先验证其他目标,再记录失败时间、目标域名、所用模式和相关错误摘要。需要求助时隐藏订阅链接、账号信息与私人访问记录。更细的 DNS、证书、规则和端口排查应转到Clash 系统教程,避免在首次上手过程中一次改动过多设置。

最后保留一份简单的使用习惯:订阅失效时先更新配置,访问异常时先看当前策略,退出桌面客户端前先确认系统代理已关闭或能够由客户端正确恢复。若关闭应用后无法联网,回到系统网络设置检查是否仍残留指向本机的代理地址。下次启动时沿着相同的四步核对,通常比反复卸载重装更容易找到原因。