QUICKSTART / 首次连接
Clash 使用教程:
订阅导入与连接验证
按“导入订阅 → 选择代理模式 → 连接 → 验证”完成首次配置。预留约 10 分钟操作时间;安装包下载、订阅可用性与系统授权可能需要额外时间。
开始前:客户端与订阅链接
先从安装包页面选择与操作系统、处理器架构相符的客户端,完成安装并打开主窗口。本教程适用于常见 Clash 生态图形客户端,不要求先编辑 YAML 文件。如果还没有确定客户端,可先阅读选型指南;首次配置建议使用仍在维护、支持当前系统的客户端,归档客户端不作为入门默认选项。
接着准备一条由服务提供方给出的 Clash 或 mihomo 兼容订阅链接。客户端负责读取配置和转发请求,安装客户端本身不会自动生成可用节点。订阅链接通常可以在服务提供方的用户中心找到;应选择明确标注兼容格式的入口,而不是复制用户中心网页地址、订单地址或浏览器分享链接。
订阅地址可能包含账户识别信息,应当像密码一样保管。不要把完整链接放进公开截图、问题反馈或在线聊天记录;需要说明问题时,保留错误提示并遮住链接中的敏感部分即可。首次操作尽量保留原有配置,避免一边删除旧配置、一边调整网络入口,导致失败后难以恢复。
开始导入前,先用普通网络打开服务提供方页面,确认当前设备具备基础联网能力。如果设备正在运行另一款代理或 VPN 工具,先记录其设置并暂停,减少两个网络接管入口互相覆盖的情况。准备完成后,进入下面的订阅导入步骤。
01 导入订阅:下载并激活配置
在服务提供方页面复制订阅链接,回到客户端,打开“配置”“订阅”或“Profiles”页面。寻找“新建”“添加”或“从 URL 导入”入口,选择远程配置类型,再把完整地址粘贴到 URL 输入框。名称可以填写便于识别的短语,例如“日常配置”;名称只用于区分配置,不决定节点能否连接。
检查地址前后是否多出空格或换行,再点击“下载”“导入”或“保存”。客户端此时会请求订阅服务器,并解析返回的配置。正常情况下,列表中会出现一张新的配置卡片,可能同时显示更新时间、节点数量或下载状态。界面展示哪些字段取决于客户端,不需要为了寻找某一个固定字段反复重试导入。
配置已下载,不等于配置已启用。点击新卡片上的“使用”“激活”或选择标记,让它成为当前配置。然后转到“代理”页面,确认已经出现节点列表或策略组。部分客户端会保留上一次使用的配置,因此即使导入提示成功,也要完成这一步检查;否则后续切换节点时,看到的仍可能是旧订阅内容。
看到错误提示时,先区分下载与解析
如果提示请求超时、连接失败或 HTTP 状态错误,说明问题发生在订阅获取阶段。先检查链接是否完整、订阅是否有效,再尝试用当前网络重新更新一次。浏览器能打开服务商主页,不代表订阅接口一定可用;同样,某些订阅响应会因客户端请求信息而不同,不能只凭浏览器显示的内容下结论。
如果提示 YAML 解析失败、格式不支持,或导入后没有节点,检查复制的是否为 Clash 兼容入口。普通节点分享链接与完整 YAML 配置不是同一类内容,不能假定任意链接都能直接导入。订阅转换涉及服务信任与参数保留,首次配置优先向提供方取得兼容链接;格式差异可再阅读订阅格式与转换说明。
保留远程订阅,避免直接覆盖生成内容
有些客户端支持从本地文件导入配置,这适用于已经取得完整 YAML 文件的情况。选择文件后,同样需要激活配置并检查代理页面。若使用的是远程订阅,不建议在首次连接前直接修改下载生成的内容,因为下次更新可能覆盖修改。确认节点与策略组已经出现后,继续选择代理模式,不必此时调整 DNS、规则集或脚本。
02 选择代理模式:规则模式与节点策略
返回客户端主页或“代理”页面,找到“模式”选择器,首次使用选择规则模式(Rule)。规则模式会按照当前配置的匹配顺序,决定请求直连、经过某个策略组,还是被拒绝。它不会自动判断所有服务的最佳线路,实际结果仍取决于订阅里的规则和策略组设置。
常见的另外两个选项是“全局(Global)”和“直连(Direct)”。全局模式通常把进入内核的请求交给全局策略,适合短时间缩小排查范围;直连模式通常让请求直接连接目标,不适合用来验证代理节点。首次使用不要在这三个选项之间连续切换,先保持规则模式,后续才能根据连接记录判断问题发生在哪里。
进入代理策略组,选择实际出站
在代理页面找到配置用于代理出站的策略组。它可能叫“节点选择”“代理”或“PROXY”,也可能使用服务提供方自定义的名称。展开后选择一个明确的节点,或使用配置已有的自动选择组。一个策略组可以再指向另一个策略组,因此看到“自动选择”不一定表示已经选中了某条固定线路,需要继续查看它当前采用的节点。
如果页面有延迟测试按钮,可以运行一次,先排除明显超时的候选项。测试返回数值只说明客户端能否完成指定测试请求,不等于目标网站的实际速度,也不保证目标服务接受该出口。不要仅凭地区名称或某一次测试数值反复切换;先选一条可测试的节点完成全流程,验证阶段再按目标服务判断是否需要调整。
部分订阅会把视频、开发服务、消息应用等分别放进不同策略组。若准备访问的目标属于某个独立组,需要检查该组是否指向合适的代理策略,而不是误选了 DIRECT。此时只调整与测试目标有关的一组,其他保持订阅默认值,可以避免一次改动过多后失去对照。
代理模式与流量入口是两层设置
规则模式决定“请求进入内核后怎样处理”,系统代理或 TUN 决定“应用请求怎样进入内核”。因此,选中规则模式、节点测试也通过,仍不代表浏览器已经使用代理。完成当前步骤后,应当能确认两个状态:模式为 Rule,相关策略组已经选好出站。下一步再打开系统接入,不要把“全局模式”当成“所有应用都已接管”。
规则编写、策略组嵌套和自定义分流不属于首次连接的必需操作。需要增加域名规则或理解匹配顺序时,转到全平台配置文档查阅,先保留本教程的最短操作路径。
03 连接:启动内核与系统接入
保持刚才的配置与节点选择,回到主页查看运行状态。有些桌面客户端打开后就会启动内核,有些需要点击“启动”或“连接”。先确认页面没有内核启动失败、端口被占用等错误,再启用流量入口。若内核尚未运行就把系统代理指向本地端口,浏览器可能立即失去连接,这并不是订阅节点本身的故障。
桌面端:先用系统代理完成浏览器测试
Windows 与 macOS 用户通常可以在主页或托盘菜单找到“系统代理”,将其打开。Linux 用户还需留意桌面环境是否支持客户端自动写入代理设置;如果开关未能作用到系统,应按当前桌面环境检查网络代理页面。不要照搬其他设备上的端口,实际监听端口应以当前客户端设置为准。
开启后,使用默认跟随系统代理的浏览器进行首次测试。如果浏览器安装了单独管理代理的扩展,或曾设置独立代理地址,应暂时改为跟随系统,避免扩展覆盖系统设置。系统代理只对采用该设置的应用有效,终端工具、游戏和某些后台程序可能不会自动使用它;这些应用稍后再单独处理。
移动端:连接并确认系统 VPN 授权
Android 与 iOS 用户在客户端中点击连接,首次使用时按系统提示允许建立 VPN 连接或添加 VPN 配置。授权后回到客户端,检查状态是否保持已连接。系统出现 VPN 标识表示接入接口已经建立,不代表节点与目标网站都能正常通信,因此仍需完成下一步的实际访问验证。
如果一返回桌面连接就中断,先查看客户端状态与系统后台限制,再检查是否有其他 VPN 应用接替了连接。多数情况下,同一设备的常规 VPN 接口会受到系统并发限制,反复启动多个工具只会让结果更难判断。先保留一个客户端运行,把其他接管工具暂停后重新连接。
需要 TUN 时,再增加接管范围
如果浏览器通过系统代理已经正常,但某个不遵循系统代理的应用仍然直连,可以根据客户端支持情况启用 TUN。桌面端可能要求安装服务、提供管理员权限或批准网络扩展,按客户端和系统的明确提示操作即可。首次排查不建议同时更换节点、修改 DNS 并开启 TUN,否则无法确认是哪项设置改变了结果。
TUN 通过虚拟网络接口接管符合路由条件的流量,不应简单理解为任何请求都会强制走代理;最终出站仍由规则决定。若启用后局域网访问或网络连接异常,先关闭 TUN,回到已验证的系统代理路径,再对照配置文档中的对应平台章节检查权限与路由。此时保持连接,进入验证步骤。
04 验证生效:请求记录与实际访问
在浏览器中新建一个页面,访问一个明确希望经过代理的目标服务,例如配置中已安排代理规则的开发站点。不要只刷新已经打开很久的标签页,因为浏览器可能复用原有连接或读取缓存。若刚切换过节点,也可以关闭旧标签后重新打开,确保测试尽量使用新的连接。
随后切回客户端,打开“连接”“请求”或相近名称的页面,查找刚才产生的目标域名。核对三个信息:请求是否进入客户端、命中了哪条规则、最终采用哪个出站或策略链。客户端可能把多个策略层级合并显示,不必要求界面字段完全一致,但应当能解释这条请求为什么直连或使用代理。
如果页面成功加载,连接记录也显示符合预期的代理出站,首次代理链路就基本确认了。再访问一个根据当前配置应当直连的网站,查看其记录是否采用 DIRECT。规则模式下,一部分请求直连、一部分请求走代理是正常结果,不需要为了让全部记录都显示代理而切换全局模式。
没有请求记录:检查入口,不急着换节点
先确认系统代理或移动端 VPN 连接仍然开启,内核也保持运行。再检查浏览器是否跟随系统设置,是否使用了单独的代理扩展。如果只有某个应用没有记录,而浏览器测试正常,更可能是该应用没有采用系统代理;根据需要配置应用自身的代理入口,或按上一节评估 TUN,而不是重新导入同一条订阅。
有请求但失败:按记录缩小范围
如果请求已经进入内核,却显示连接超时,可在同一策略组切换另一条可用节点,再用同一目标页面复测。若出现认证失败,优先检查订阅有效性并执行更新;若提示域名解析失败,则需要检查当前网络和 DNS 配置。日志通常包含目标、阶段与错误原因,反馈时保留这些字段,遮住账户、订阅链接和其他敏感内容。
若普通网站可以访问,只有某个服务失败,不要直接认定整个代理失效。目标服务可能对出口地区、账户状态或访问频率有要求,也可能涉及独立策略组。先确认该目标的实际出站,再测试其他页面进行对照。节点延迟测试通过只能作为辅助信息,最终判断应结合真实访问和连接记录。
完成测试后,记录当前使用的配置名称、模式、策略组和系统接入方式。这几项就是之后排查的基准。遇到问题时每次只改一项,并重复同样的访问动作;比起一次重置全部设置,这样更容易定位具体变化。
日常使用:更新订阅与正常断开
后续打开客户端时,先确认仍在使用正确配置,再连接即可。服务提供方调整节点后,在订阅页面执行“更新”;更新完成后重新查看策略组,因为原先手动选择的节点可能已经被移除或改名。若客户端支持自动更新,可以按实际需要设置周期,但自动更新成功也不等于所有目标服务都已经通过验证。
准备退出时,优先在客户端中关闭系统代理或断开 VPN,再退出程序。桌面端如果异常结束后出现浏览器无法联网,先检查系统是否仍保留指向本地的代理设置;关闭残留入口后测试普通网络,不要先删除订阅。移动端则检查系统 VPN 状态是否已经断开。
至此已完成首次配置主线。更换设备、设置开机启动、处理权限或编写自定义规则时,查阅全平台安装配置文档;需要重新选择安装包时,返回Clash 下载页面。保留已验证的基础配置,再逐项增加功能。