首次配置 / 操作顺序

Clash 订阅导入与连接教程

按导入订阅、选择模式、启动连接、验证路径的顺序完成首次设置。已有安装包与可用订阅时,可按约十分钟的操作流程逐项检查;下载、订阅服务和网络故障的处理时间另计。

开始前:确认客户端与配置来源

打开已经安装的客户端,确认主窗口能够正常显示。如果系统询问是否允许客户端访问网络,按实际使用范围授权;如果安装服务或创建虚拟网卡需要管理员权限,先保留提示,等到连接步骤再处理。首次设置期间先关闭其他正在接管网络的代理或 VPN 客户端,避免两个产品同时修改系统代理、路由和 DNS,导致后面的测试无法判断是哪一项设置生效。

接着准备订阅链接或完整的 YAML 配置文件。客户端负责读取配置和处理流量,安装客户端本身不会自动产生可用节点。订阅地址通常由所使用的服务提供方给出,应选择与当前内核兼容的 Clash 或 Mihomo 配置格式,而不是把服务商网站首页、账户登录地址直接粘贴到导入框。只有节点列表的文件也可能缺少代理组与规则,不能直接等同于可运行的完整配置。

订阅链接可能包含账户识别信息。复制时保留完整地址,排查时不要把完整链接、二维码或含认证信息的配置公开发布。已有配置需要修改时,先导出或另存一份副本。下方流程只完成日常连接所需的设置,不要求先理解每一个 YAML 字段;字段含义与平台安装细节可在配置文件章节继续查阅。

第一步:导入订阅并启用配置

进入客户端左侧或底部的“配置”页面,找到“新建”“添加订阅”或“从链接导入”。选择链接类型后,将订阅地址粘贴进 URL 输入框;如果还有名称输入框,可以填写便于识别的本地名称。保存前检查地址前后是否多出空格、换行或聊天工具附带的标点。不要为追求地址简短而删除问号后面的参数,这些参数可能决定身份认证和返回格式。

点击“导入”或“保存”,等待客户端下载内容并完成解析。正常情况下,配置列表会增加一个条目,条目中可能显示名称、更新时间或启用状态。添加成功与正在使用是两个状态。如果新配置没有自动启用,还需要点击该条目,或打开条目菜单选择“使用”“激活”“设为当前配置”。随后回到“代理”页面,应能看到该配置定义的代理组与可选出站。

如果拿到的是本地文件,则在同一页面选择“导入文件”或“从文件新建”,打开扩展名为 .yaml 或 .yml 的完整配置。手机端可能需要先把文件保存到系统文件管理器,再从文件选择器中打开。文件导入之后同样需要确认当前启用项;只在下载目录里保存了文件,而没有在客户端内导入,并不会改变客户端正在使用的配置。

若出现“配置解析失败”,先停在这一步,不要通过反复切换系统代理来处理。链接导入时,检查订阅是否过期、是否需要登录、提供方是否返回了网页而非配置;文件导入时,检查是否复制不完整、缩进是否被编辑器修改,以及字段是否超出当前内核的支持范围。可先查看日志中第一条明确的错误信息,再到FAQ 的安装配置与故障排查分类寻找对应原因。

确认配置可用后,再尝试一次手动“更新订阅”,理解日后更新入口所在位置。远程订阅更新时可能替换原有内容,因此不要把重要的长期修改直接写进会被覆盖的下载副本。客户端若提供覆写或合并功能,可在熟悉后再使用。当前阶段只需确认配置已启用、代理组可见,接着进入出站模式设置。

第二步:选择规则模式与代理组

在主页、“代理”页面或设置中的“出站模式”区域,找到“规则 / 全局 / 直连”选项。首次使用建议先选择规则模式。该模式按当前配置中的规则为请求选择出站:部分请求直连,部分请求进入指定代理组,也可能按规则被拒绝。规则模式是否符合预期,取决于导入的配置,不能只凭模式名称判断某个网站一定走代理。

切换到“全局”后,进入内核的常规代理请求会使用全局选择的出站;切换到“直连”后,常规请求会直接访问目标。这里调整的是内核收到请求之后如何转发,并不是控制哪些应用把请求交给内核。因此,终端原本没有使用系统代理时,单独切换全局模式并不能让终端流量自动进入客户端。先完成规则模式验证,确有排查需要时再短暂切换全局。

保持规则模式,进入“代理”页面展开配置中的选择组。组名由配置定义,可能是中文,也可能是英文,不必寻找某个固定名称。查看该组的候选项:如果它是手动选择组,点击一个当前可用的节点;如果候选项里还有另一个组,应继续确认被选中的下级组如何选择出站。选择了 DIRECT 表示直连,选择了 REJECT 表示拒绝连接,都不等同于选中代理节点。

有“延迟测试”或“连接测试”按钮时,可以运行一次,用于排除明显不可连接的候选项。测试数字只反映客户端对指定测试目标的一次测量,不等于下载速度,也不能保证所有网站均可访问。“超时”可能来自节点不可用、测试目标不可达或本地网络限制。不要一次反复测试大量节点;先选择一个能通过测试的出站,实际访问效果留到第四步确认。

自动选择组通常按配置的测试地址、间隔和策略选择出站,不一定允许直接固定某一个节点。如果需要手动控制,应选择配置中支持手动选择的组,而不是修改不熟悉的组类型。完成后记住当前使用的组名与出站,后面查看连接记录时用它们作对照。更深入的规则顺序和代理组嵌套解释见全平台指南,此处无需先修改规则。

第三步:启动内核并开启连接

先回到主页检查内核状态。部分客户端打开后会自动启动内核,另一些需要点击“启动”或“连接”。应以界面显示的运行状态和日志为准,不能只看托盘图标是否存在。如果启动失败,打开“日志”查看是否存在端口占用、配置加载失败或权限不足。先解决启动错误,再开启系统代理,否则系统可能把请求交给一个尚未监听的本地端口。

桌面端:先用系统代理测试浏览器

在 Windows、macOS 或 Linux 桌面环境中,进入客户端的设置或托盘菜单,打开“系统代理”。客户端会把系统代理指向本机监听地址。对于遵循系统代理的浏览器,这通常已足够完成第一次访问测试。Linux 的桌面环境和应用对系统代理的支持存在差异,如果开关不可用,应按具体客户端说明检查桌面代理设置,不要直接套用其他平台的菜单路径。

随后检查“混合端口”或“Mixed Port”是否已成功监听。常见示例值为 7890,但应以当前客户端实际显示为准;若为了避开占用修改过端口,手动设置代理的应用也要跟着更新。首次使用保留本机监听即可,通常不需要开启“允许局域网连接”。外部控制地址用于管理内核,不是浏览器应填写的上网代理端口。

手机端:允许系统 VPN 配置

Android 与 iOS 通常通过系统 VPN 接口承接流量。点击客户端的“连接”或启动按钮后,系统可能弹出 VPN 配置请求,确认来源为当前客户端后允许。返回客户端,检查连接状态是否持续保持。系统显示 VPN 标识说明隧道已建立,但不能单凭这一标识判断远端出站可用;是否能访问目标仍需要下一步测试。

如果系统已有其他 VPN 正在运行,先断开后再启动当前客户端;实际能否共存取决于系统能力和产品实现。Android 若在锁屏后频繁断开,可在完成首次验证后检查电池优化与后台运行权限。iOS 则先确认系统设置里的 VPN 状态与客户端显示一致,不要在多个客户端之间反复连接,以免把权限问题与节点问题混在一起。

TUN:按需要再启用

当浏览器已经正常,但某些不遵循系统代理的应用仍需接管时,再考虑 TUN 模式。该模式通常需要虚拟网卡、服务或管理员权限,按客户端提示完成授权后再开启。首次验证不要同时修改系统代理、TUN、DNS 和路由设置;一次只调整一项,才能判断变化来源。TUN 的平台支持、权限与路由排查较长,可转到全平台指南继续操作。

第四步:验证访问与规则命中

保持客户端运行,在浏览器中新开一个页面,访问已知可用且符合当前配置使用范围的网站。尽量不要只刷新已打开很久的页面,因为缓存、连接复用或浏览器自身的代理扩展可能干扰判断。若装有代理切换扩展,先检查它是否覆盖系统设置;可以暂时停用扩展,用浏览器默认网络设置做一次对照。

页面能打开后,回到客户端的“连接”或“活动连接”页面,寻找刚才访问的目标域名。查看记录里的命中规则、代理组或出站链,确认它是否与第二步的选择一致。记录字段和保留时间因客户端而异,短连接可能很快消失,可以在保持连接页面打开时重新发起访问。若使用日志辅助判断,只保留必要信息,分享截图前遮盖个人域名、订阅和认证内容。

验证应分成两个问题:请求有没有进入客户端,以及进入之后走了哪个出站。没有任何对应记录时,先检查浏览器是否使用系统代理、监听端口是否一致、是否有其他扩展或 VPN 接管。已经出现记录但访问失败时,再检查所选节点、规则目标和日志错误。若记录显示 DIRECT,而配置本来就要求该目标直连,这不是代理失效;需要使用一个按配置应走代理的目标继续验证。

浏览器正常、终端或某个应用失败时,先确认该应用是否读取系统代理。很多命令行程序需要单独设置代理环境变量,另一些应用有自己的代理配置入口。不要把浏览器的成功直接推断为所有应用都已接管,也不要仅因终端失败就重新导入订阅。可到连接故障排查按应用类型检查,或阅读浏览器与终端分开排查的操作说明。

如果页面可以访问,但需要确认出口,可使用自己信任的出口查询服务作为补充观察,并同时查看该查询请求的命中规则。查询服务只反映那一次请求的路径,不能代表全部应用;规则把它设为直连时,显示本地网络出口也可能完全符合配置。最终判断应以预期目标能否访问、连接记录是否匹配规则以及所用应用是否接入为准。

测试结束后可以保持已验证的设置。以后需要停止代理时,先在客户端中关闭系统代理或断开 VPN,再退出客户端;客户端是否自动恢复系统设置因产品而异,退出后应确认网络仍正常。若需要迁移设备、编写规则或调整 DNS,继续阅读全平台安装配置指南。本页流程到此结束,不必为了完成首次连接而提前调整所有高级选项。