使用文档 · 初次配置
Clash 使用教程:
订阅导入与连接验证
操作路径:导入订阅 → 选择代理模式 → 建立连接 → 验证分流。本教程按约十分钟的初次配置流程组织;提前准备好客户端和可用订阅,跟着页面顺序操作即可。下载、授权或网络排查所需时间取决于设备环境。
开始前:准备客户端与订阅
先确认客户端能够正常打开,并能进入配置页面。客户端负责读取配置、匹配规则和建立连接,不会因为安装完成就自动获得可用节点。接下来需要一条服务提供方给出的订阅链接,或者一份已经包含代理节点、策略组和规则的本地 YAML 配置。仅有空白配置或内核程序,通常不足以完成下面的操作。
订阅链接常带有个人访问凭据,应按账号信息保管。复制时使用服务提供方页面上的订阅复制按钮,不要把账户登录页、订单页地址当成订阅地址。排查时也不要把完整链接贴到公开评论或截图中;确实需要分享报错时,隐藏链接中的个人参数,仅保留错误类型和客户端名称。
初次操作前,暂时退出其他正在接管网络的代理或 VPN 客户端,避免多个程序同时修改系统代理、路由或 DNS。先用一款客户端完成闭环,确认可用后再研究多客户端并存。已有配置的用户可以先导出备份,并记下当前启用的配置名称,以便操作失误时切回原状态。
第一步:导入并启用订阅
打开客户端侧边栏或底部导航中的“配置”“订阅”或 Profiles 页面,找到“添加”“新建”或“从 URL 导入”。如果弹窗让你选择配置类型,使用远程订阅或 URL 配置;本地文件入口用于导入已经保存的 YAML 文件,两者不要混选。给配置填写便于辨认的名称,例如“日常配置”,以后有多份订阅时就能快速区分。
把订阅链接完整粘贴到地址栏,检查首尾是否多出空格或换行,再点击导入、下载或保存。等待客户端完成拉取,不要连续点击创建多份相同配置。成功后通常会出现一张配置卡片、更新时间或启用按钮。仅看到名称不一定表示内容已下载,若仍有错误提示,应先展开错误信息确认拉取结果。
接着点击这份配置的“启用”“使用”按钮,或选中对应配置卡片。某些客户端在选中后自动重载,另一些需要点击应用。完成后进入“代理”页面:应能看到配置定义的策略组和节点条目。配置列表里存在文件、但代理页仍为空时,先检查是否真正启用了刚导入的配置,而不是停留在另一份空白配置上。
如果拿到的是本地文件,使用“从文件导入”,在系统文件选择器里选中对应的 .yaml 或 .yml 文件,再按相同流程启用。不要只修改文件扩展名来转换内容:网页、JSON 或单条节点分享链接不会因为改名而变成完整配置。配置文件的基本组成可在YAML 结构说明中查看。
导入时出现超时,先确认当前网络能访问订阅来源;出现解析失败,则检查服务提供方是否另有 Clash 或 mihomo 格式入口。返回内容可能是登录页面或错误页面,此时反复重试不会修正格式。需要订阅转换时,先阅读订阅转换说明,不要把个人订阅随意提交给陌生转换服务。
第二步:选择规则模式与策略组
回到客户端首页、概览或代理页面,找到“运行模式”。初次使用选择“规则”或 Rule,对应配置字段 mode: rule。该模式按配置中的 rules 从上向下判断连接,命中后交给指定策略处理。这样可以保留订阅原本安排的直连、代理和拦截路径,不必让所有访问都使用同一种出站。
不要把“全局”理解成连接必需的总开关。全局模式会让进入内核的流量统一交给全局策略,不再按普通规则逐条分流;直连模式则让进入内核的连接走直连,常用于临时对照。它们都不会自动让所有应用进入客户端。运行模式与系统代理、TUN 分别解决不同问题,下一步还要设置流量如何接入。
选好规则模式后,打开“代理”或 Proxies 页面,找到负责通用代理流量的策略组。名称可能是 Proxy、节点选择或其他订阅自定义名称,不能只按固定文字寻找。点击策略组后,从已有节点中选一个,或者选择订阅已配置好的自动选择组。手动选择组通常对应 type: select,自动测试组常见 type: url-test。
策略组里若有 DIRECT,它表示直连,不代表一个代理节点;REJECT 表示拒绝连接,也不是可用于浏览网页的线路。初次验证时,先选一个明确的节点,避免选中直连、拒绝或尚未配置完整的嵌套组。若客户端提供连通性测试,可以执行一次作为参考,但测试成功只说明测试目标可达,不等于目标网站或所有应用都已正常。
确认当前选择标记已经移动到目标条目,再返回概览页面。若切换配置后发现选择恢复,先确认新配置是否使用了不同的策略组名称。规则、策略组与节点的关系无需在本次上手时全部展开;需要自定义时再查看策略组字段与规则语法,避免一边学习一边修改导致无法判断问题来源。
第三步:启动连接并接入流量
现在配置与出站已经就绪,接下来让应用流量进入客户端。先确认概览页的内核处于运行状态;有独立启动按钮的客户端,应先启动内核。仅打开客户端窗口并不一定表示代理已经工作,托盘图标存在也不能代替状态确认。如果内核启动时报端口占用,先退出其他代理程序,不要立刻改动多个端口。
Windows、macOS 与 Linux:先开系统代理
在客户端概览或设置页找到“系统代理”“设置为系统代理”或 System Proxy,开启后保留客户端运行,再打开浏览器测试。此操作一般让遵循系统代理设置的应用把连接交给本机监听端口。不同桌面环境与应用对系统代理的支持不同,尤其在 Linux 上,开启开关后仍应通过连接页面确认流量是否进入。
首次验证不建议同时开启多个接管选项。先用系统代理完成浏览器测试,之后发现某个应用不遵循系统代理,再考虑 TUN。TUN 通常需要服务模式、管理员权限或系统网络授权;按客户端提示安装服务并授权,不要仅因开关无法启用就反复重装。系统代理与 TUN 可以在部分配置中配合使用,但具体组合应以客户端说明为准。
Android 与 iOS:确认系统 VPN 授权
在移动客户端主页点击连接、启动或电源形按钮。首次连接时,系统通常会提示建立 VPN 连接或添加 VPN 配置,核对发起应用后确认。这里的 VPN 是系统提供的流量接入机制,不表示需要再安装另一个 VPN 应用。授权完成后回到客户端,确认状态已变为运行或已连接,再打开浏览器进行下一步验证。
如果手机上已有其他 VPN 正在运行,先断开再测试;设备管理策略或工作资料环境也可能限制连接权限。Android 若启用了分应用代理,要确认测试用浏览器包含在接管范围内。iOS 若授权后仍未连接,返回客户端检查启动错误,不要仅凭系统设置里保存了一条 VPN 配置就判断已连接。
连接后暂时不要调整 DNS、嗅探或复杂路由规则。先观察基础流程是否完成:配置可读取、内核能启动、系统授权成功、流量有入口。出现权限或网络接管错误时,可到疑难解答按报错类型继续排查,保留当前可工作的部分,只修改一个变量后再测试。
第四步:验证访问结果与规则出站
打开浏览器访问一个你预期走代理的站点,例如配置中明确安排代理访问的开发站点。等待页面加载后,切回客户端的“连接”“活动连接”或 Connections 页面,按域名搜索对应请求。浏览器打开一个页面时可能访问多个域名,应优先观察主域名,再检查图片、脚本等资源,不要把某一条后台请求当成整页结果。
点开连接详情,查看目标域名、命中规则、策略组和实际出站。若规则指向代理组,并最终落到刚才选择的节点,说明这条请求已经按预期分流。组名称与实际节点是两层信息:只看到 Proxy 不一定知道最终使用哪条线路;自动选择组还可能调整节点,应以该条连接记录显示的路径为准。
接着访问一个你预期直连的站点,使用同样方法检查。若规则命中 DIRECT,且访问正常,便完成了一次代理与直连对照。外网出口地址查询可以作为辅助,但查询站点自身也可能被规则分到不同出站,所以单个 IP 页面不能证明所有流量都走代理,更不能代替规则记录。
如果页面打不开,先把问题分成三层。第一层是连接是否进入内核:连接页完全看不到相关请求时,检查系统代理、移动端连接状态和分应用范围;第二层是分流是否正确:请求存在却走错策略时,确认规则模式与当前启用配置;第三层是出站是否可用:规则正确但连接失败时,再换一个已有节点重试,并查看日志里的解析、超时或握手错误。
已经建立的长连接不一定随节点切换立即迁移,浏览器也可能复用旧连接。切换策略后先重新加载目标页面;需要更明确的对照时,可在客户端关闭相关活动连接后再发起请求。关闭全部连接会中断正在进行的下载、会议或传输,应在没有重要任务时操作。
完成验证后记住三项结果:正在使用哪份配置、通用代理组选择了什么、哪种接管方式已经成功。以后遇到故障,先回到这三个已知状态,再逐层排查,而不是同时重置订阅、DNS 和模式。若访问正常但特定应用异常,继续查看故障排查问题;若想改变某个域名的出站,再进入自定义规则参考。
连接成功后:自启、更新与退出
基础验证通过后,再打开客户端设置中的“开机启动”或“登录时启动”。桌面客户端的“启动程序”“启动后连接”“自动设置系统代理”可能是三个独立选项,开启其中一项不代表另外两项也会开启。按实际需要设置后,重新登录或重启设备,检查配置、内核与接管状态是否都恢复,再复做一次网页验证。
移动端的后台运行与桌面开机启动不同。Android 若频繁被系统回收,可检查电池优化、后台运行和系统允许的自启动设置;这些入口由设备系统决定,不必为了后台常驻开放与联网无关的权限。iOS 是否支持按需连接取决于客户端与系统能力,应以应用内现有选项为准,不套用桌面端路径。
订阅需要更新时,回到配置页,对当前订阅点击刷新或更新,完成后确认仍然启用同一份配置。如果客户端支持自动更新,可按服务提供方建议设置周期,不必把间隔压得很短。远程订阅更新可能覆盖对原文件的直接编辑;确实需要长期保留自定义内容时,先了解客户端的覆写功能,再查阅配置字段文档。
最后测试一次退出流程。桌面端准备退出客户端时,先关闭系统代理或使用客户端提供的正常退出入口,避免系统仍指向已经停止监听的本地端口。若退出后浏览器无法联网,检查系统代理设置是否残留。移动端则先在客户端断开连接,确认系统 VPN 状态同步关闭。掌握启动和退出两条路径,日常使用才能保持状态清楚。