使用文档 / 首次连接
Clash 使用教程:订阅导入与连接验证
先让一份配置、一条线路和一个应用正常工作,再考虑 TUN、DNS 与复杂分流。下面按首次使用的顺序操作,基础设置通常可以在约十分钟内完成;订阅或网络异常则需要另外排查。
第一步:导入订阅并启用配置
结论先说:安装客户端不等于已经有可用线路。开始前准备好服务提供方给出的 Clash 兼容订阅地址,或者一份可用的 YAML 配置文件。订阅通常包含节点、代理组和分流规则,客户端负责读取与执行。不要把服务商登录页、订单页或普通分享网页的地址当成订阅,它们返回的可能只是网页内容,导入时自然会报格式错误。
新增远程订阅
打开客户端,进入“配置”“订阅”或“Profiles”,寻找“新增”“导入”或带加号的入口,选择“远程订阅 / URL”。把完整链接粘贴到地址栏,名称可以填写方便识别的文字,再点“保存”“导入”或“下载”。如果界面把“保存”和“更新”分开,保存后还要执行一次更新,等下载结束再继续。
粘贴时检查链接前后是否多了空格、换行或聊天软件附带的标点。部分客户端支持从剪贴板导入,但识别成功后仍应核对地址。订阅里的令牌相当于访问凭据,不要把完整订阅链接发到公开评论或截图中。下方地址只展示链接的形态,不提供线路,也不需要尝试访问。
https://example.com/sub?token=xxxx
若服务提供方同时给出多种订阅格式,选择其标明适配当前 Clash 或 mihomo 内核的格式。不要只因为地址能在浏览器打开,就认定返回内容一定可用。出现“解析失败”“unsupported”或找不到代理节点时,先回到订阅页面核对格式;不要随意将私人订阅提交给陌生在线转换网站。相关原因可在疑难解答中继续查阅。
检查导入结果并设为当前配置
更新成功后,配置列表里通常会出现名称、更新时间或状态提示。点击该配置的“使用”“激活”按钮,或选中对应卡片。随后打开“代理”页面,确认已经出现代理组和节点。这里最常见的误区是只完成下载,却仍在使用旧配置;列表中存在配置,不代表它已经生效。以当前选中标记和代理页内容为准,而不是只看下载成功的通知。
如果拿到的是本地 YAML 文件,使用“从文件导入”,选中实际配置文件,不要选择压缩包。首次操作保留原文件,暂时不手动重写内容。配置能正常加载、代理组能够显示,就可以进入第二步;若连这一步都无法完成,先解决导入问题,不必继续调整系统代理或 DNS。
后续节点变化时,在同一条订阅上点击“更新”即可,通常不需要重复新增。更新可能覆盖直接改在订阅文件里的设置,所以本教程不要求修改订阅原文。需要保留自定义规则时,再阅读 YAML 手册中的覆写与合并说明,不要在首次连接阶段同时引入这些变量。
第二步:选择规则模式与代理节点
配置启用以后,进入“代理 / Proxies”页面,找到“规则、全局、直连”三个模式选项,先选择规则 / Rule。模式决定进入内核的请求怎样选择出口,不负责让所有应用自动接入代理。现在先完成分流选择,下一步才开启系统代理或 VPN 连接,两者不要混为一谈。
日常使用先选规则模式
规则模式按当前配置里的规则逐条匹配,请求可能直连,也可能交给某个代理组。全局模式则把进入内核的请求交给全局出口;它不意味着每个应用的所有流量都已经被接管。直连模式用于让进入内核的请求直接访问目标,并不等同于关闭系统代理。初次使用没有特殊要求,保留规则模式即可,不需要反复切换。
“全局一定更快”是常见误解。速度还取决于线路质量、目标服务、网络拥塞与本地连接,切换模式不会凭空改善这些条件。遇到某个网站异常,可以临时用全局模式对照,但完成测试后应恢复原来的规则模式,否则原本应该直连的服务也可能改变出口。更详细的差异见规则、全局与直连模式说明。
在实际使用的代理组里选节点
模式选好后,展开主代理组,点击一条准备使用的节点。组名由订阅决定,可能叫“节点选择”“代理”或其他名称,不一定都是 PROXY。某些配置把不同服务分配给不同代理组,选择了总入口之外的另一个组,不一定会改变当前网站的出口。首次连接先找到配置默认使用的主组,避免同时修改所有组。
可以点一次“延迟测试”或“连接测试”,观察结果是否超时。测试使用的是客户端指定的目标地址,延迟数值不等于下载速度;测试成功也不能保证所有网站都正常。若一条节点超时,换另一条再测试;若全部失败,先检查订阅有效期、本地网络和客户端日志,不要立刻修改整个配置。关于测速差异,可继续查看节点延迟与连接故障问答。
采用自动选择组时,客户端可能根据测试结果调整出口;采用手动选择组时,当前点击的节点通常会保持选中。为了便于排查,首次验证可以先固定一条可用节点,并记住它的名称。到这里应当已经明确三件事:正在使用哪份配置、处于什么模式、请求预期交给哪个代理组。确认后再开启连接。
第三步:开启系统代理或 VPN 连接
现在要让应用的请求进入客户端。内核运行与流量接入是两回事:有的桌面客户端启动时就会运行内核,但浏览器尚未使用它;移动端导入配置后,也通常需要再点一次连接。初次操作请退出其他代理客户端,避免互相修改系统设置。不要同时开启多个 VPN 连接来试图叠加效果。
桌面端:确认内核,再开启系统代理
在客户端主页或“设置”中确认内核处于运行状态,随后打开“系统代理 / System Proxy”。如果客户端需要安装辅助服务或请求修改网络设置的权限,先核对提示来源,再按客户端流程确认。系统代理打开后,遵循系统代理设置的浏览器和应用才会把请求发送到本地监听端口;有些终端工具、游戏或自带网络设置的应用不会自动跟随。
首次连接建议保留客户端默认端口,不主动打开“允许局域网连接”。下面是本地监听字段的示例,只用于识别设置,不需要把它粘贴覆盖整份订阅。实际端口以客户端当前配置为准,不能因为教程写了 7890,就把系统里所有地方都强行改成这个值。
config.yaml · 本地监听示例
mixed-port: 7890
allow-lan: false
mode: rule
mixed-port 表示 HTTP 与 SOCKS 共用的监听端口;allow-lan: false 用于限制局域网访问。若日志提示端口已被占用,先确认是否还开着另一个客户端或旧实例。不要随便结束无法识别的系统进程。确实需要改端口时,通过客户端设置修改,并重新应用系统代理,让两边一致,具体步骤见端口占用排查。
Linux 桌面环境对系统代理的支持并不完全一致。如果客户端已开启系统代理,而浏览器仍未接入,应检查桌面环境和浏览器的网络设置。TUN 可以用于不同于系统代理的流量接入需求,但可能涉及权限、路由与 DNS。先验证浏览器基础连接,再根据需求阅读 YAML 手册,不要在这一步同时开启 TUN、改 DNS 和改路由。
移动端:确认系统 VPN 授权
Android 用户点击主页的启动或连接按钮,首次通常会出现系统 VPN 连接请求。确认后,等待客户端显示已连接,并留意系统状态栏标识与常驻通知。此处 VPN 是系统提供的流量接入接口,并不意味着客户端另外提供了一条线路;实际出口仍取决于刚才导入的配置和选中的节点。
iOS 用户点击连接后,可能需要允许添加 VPN 配置,并通过系统要求的身份验证。完成后回到客户端,确认连接状态。若授权被拒绝,返回系统设置检查该客户端的 VPN 权限,再重新连接,不要靠反复导入订阅解决权限问题。Android 若只在锁屏后断开,优先检查后台运行与电池限制,参见后台断连与省电设置说明。
第四步:验证实际请求与分流结果
连接图标亮起,只能说明某个开关或连接状态已经建立。真正的完成标准是:目标页面能够访问,请求走向符合预期。保留当前配置与节点不变,先进行一次简单的浏览器测试,再对照连接记录;不要一遇到打不开就同时换节点、改模式和改 DNS,那样很难知道哪一项真正起了作用。
用两个页面和连接记录交叉确认
先刷新一个平时就能访问的普通网站,确认本地网络仍然正常;再打开一个预期需要通过代理访问的网站。为了减少缓存干扰,可以使用新的无痕窗口重新请求,但无痕窗口并不能绕过所有 DNS 或系统缓存。页面若能加载,再回到客户端的“连接 / Connections”页面,查看刚才请求对应的域名、命中规则与出口策略。
不同客户端展示的字段略有区别,有的显示完整策略链,有的只显示目标和出口。重点核对该请求是 DIRECT,还是经过选中的代理组与节点。规则模式下,部分网站直连是正常结果;不是所有连接都必须标成代理。只观察到某一条直连记录,也不能据此判断整个客户端未生效,页面还可能请求多个不同域名的资源。
IP 查询页面只能反映访问该页面时的出口,不能代表所有应用和域名的流量。某个查询网站可能被配置为直连,浏览器与其他应用也可能使用不同的接入方式。因此不要仅凭 IP 没变化就重装客户端,也不要仅凭 IP 变化就认为所有程序都已接管。实际目标访问和对应连接记录一起看,结论才可靠。
按现象缩小问题范围
如果客户端里完全看不到浏览器的新请求,先查系统代理是否打开、浏览器是否设置了独立代理、监听端口是否一致。移动端则查 VPN 是否真正建立、是否启用了应用排除规则。如果请求已经出现但连接超时,先换一条节点复测;如果只有一个域名失败,再检查该域名的命中规则与日志。不要为了单个网站异常直接切换所有网络设置。
若关闭代理后普通网站也打不开,先在客户端关闭系统代理或断开 VPN,再检查系统是否遗留了指向本地端口的代理设置。只有确认本地网络恢复,才能继续比较代理连接的差异。出现解析错误、证书错误或频繁断流时,记录错误原文与发生时间,转到疑难解答按现象排查;需要理解字段再查 YAML 配置参考,无需在入门阶段读完全部参数。
验证完成后的日常操作
连接正常后,保持规则模式,按需更新订阅即可。更新后若节点名称或代理组变化,重新检查选中项,不要默认旧选择一定保留。准备结束使用时,桌面端先关闭系统代理,再退出客户端;移动端先断开 VPN 连接。这样可以避免客户端已经停止监听,应用却仍然向本地代理端口发送请求。
最后记住这条顺序:配置有效 → 出口选定 → 流量接入 → 实际验证。每次只改变一项,并立即复测,比反复重装更容易找到原因。需要向他人描述问题时,提供客户端名称、系统类型、失败步骤和经过脱敏的错误信息即可,不要附带订阅令牌、账户信息或完整的私人配置。