QUICK START / 10 MIN

Clash 订阅导入与连接配置

从空白客户端开始,依次完成导入订阅、选择代理模式、启动连接、核对结果。本页只处理首次使用的主线步骤,配置语法、DNS 路径与系统级排障放在专项文档中。

PRECHECK / 00

开始前检查

先确认客户端能正常启动、订阅来源可用,并记录当前系统代理状态。这样出现问题时能快速判断卡在哪一层。

CLIENT

客户端已安装

首次启动后应能看到配置、代理或设置页面。若系统阻止运行,先完成系统安全确认和必要权限授权,不要同时改动代理、DNS 与 TUN。

PROFILE

订阅链接完整

复制时保留链接中的全部字符。聊天工具或网页可能把长链接折叠显示,应使用复制功能取得原始地址,而不是手动抄录省略后的文字。

NETWORK

基础网络可用

导入前先关闭旧代理并测试普通网页。基础网络本身中断时,客户端无法更新订阅,也不能据此判断代理节点是否可用。

Windows 界面定位

配置入口通常位于侧边栏的“订阅”“配置”或 Profiles。连接阶段先打开系统代理;只有需要接管不遵循系统代理的程序时,才进入服务模式或 TUN 设置。首次授权可能触发系统确认窗口。

STEP 01
PROFILE INPUT

导入订阅

目标是让客户端取得一份可以解析、可以更新并且已被选中的配置。只看到订阅名称还不够,配置内部还应包含策略组、规则和节点信息。

打开配置管理入口

启动客户端后,先在侧边栏、底部导航或菜单栏中找到“配置”“订阅”“Profiles”或“配置文件”。进入后通常会看到远程订阅输入框、本地文件导入按钮以及已经保存的配置列表。首次使用时列表可能为空,这是正常状态。

选择通过 URL 添加远程配置,把完整订阅链接粘贴到输入框。若界面要求填写名称,可以使用便于识别的名称,例如服务名称或使用场景;名称只影响本地显示,不改变订阅内容。随后点击“导入”“下载”“添加”或“更新”。

客户端会先请求订阅地址,再解析返回的配置。等待操作完成,不要在下载过程中连续点击多次。成功后,列表中通常会出现配置名称、更新时间或节点数量等信息;如果客户端提供解析错误提示,应先处理错误,不要直接进入连接步骤。

把新配置设为当前配置

导入成功并不一定代表已经启用。部分客户端会自动选中新配置,另一些客户端仍然保留之前使用的配置。点击新配置对应的“使用”“选择”或单选标记,确认它成为当前配置。然后进入代理页面,检查是否出现“自动选择”“节点选择”“故障转移”之类的策略组,以及组内是否有可选节点。

如果只有配置名称,没有任何策略组或节点,先执行一次手动更新。仍为空时,应检查订阅响应是否有效、链接是否完整以及客户端日志是否报告 YAML 解析错误。配置文件字段与规则语法的详细解释可查阅名词解释;涉及响应异常、解析失败和更新超时的系统排查放在疑难手册

STEP 02
ROUTING MODE

选择代理模式

模式决定请求如何匹配规则。首次配置优先使用规则模式,再为主要策略组选定节点,避免把模式问题和节点问题混在一起。

首次使用选择规则模式

进入客户端的“模式”“运行模式”或 Mode 设置,通常能看到规则、全局和直连三种选项。首次使用选择“规则”或 Rule。此模式会按照配置中的规则顺序判断域名、IP、进程或规则集,并把连接交给对应策略组。常见网站可以直连,需要代理的请求则进入代理策略,日常使用更容易保持稳定。

全局模式会把大多数请求交给同一个代理策略,适合短时间判断某个站点是否因规则未命中而无法访问,但不建议在首次配置时长期保持。直连模式会绕过代理,主要用于暂停代理或对照测试。切换模式后不必重新导入订阅,但应重新发起测试请求,避免把旧连接结果当作新模式的结果。

为策略组指定节点

模式选定后,进入“代理”“策略组”或 Proxies 页面。找到承担主要代理流量的策略组,名称可能是“节点选择”“Proxy”“手动选择”或由配置提供方自定义。展开该策略组,从列表中选择一个状态正常的节点。若配置包含自动选择组,可以先使用自动选择,但仍需确认该组内至少有一个节点能够完成测试。

多个策略组之间可能存在引用关系。例如“国外网站”策略组引用“节点选择”,而“节点选择”再指向具体节点。此时只改最外层策略未必能改变实际出口。点击进入下一级,直到看到具体节点名称,并确认选择标记已经更新。策略组、规则匹配和回退关系的术语说明见名词解释

系统代理与 TUN 不属于同一层

规则、全局和直连决定内核如何分流;系统代理和 TUN 决定哪些流量能进入内核。首次操作先保留规则模式,并在下一步启用系统代理。只有当目标程序不遵循系统代理、需要接管更多应用或需要处理特定 DNS 路径时,再考虑 TUN。两项同时改动会增加定位难度。

STEP 03
TRAFFIC HANDOFF

启动连接

这一阶段把系统或应用流量交给客户端。桌面端通常先启用系统代理,移动端则通过系统 VPN 接口建立连接。

桌面端先开启系统代理

返回客户端主界面,找到“系统代理”“设置为系统代理”或 System Proxy 开关。点击后等待状态变化,确认开关保持开启,而不是立即回落。部分 Windows 客户端需要先启动内核服务,部分 macOS 客户端会请求修改系统网络设置;按系统提示完成授权,然后回到客户端检查状态。

系统代理开启后,遵循操作系统代理设置的浏览器和桌面应用会把请求发送到 Clash 的 HTTP 或 mixed 端口。此时不要急着打开 TUN,也不要手动修改系统代理地址。先完成下一步浏览器验证,能减少端口填写错误和多个接管方式冲突的可能。

移动端确认 VPN 授权

Android 或 iOS 客户端通常在主界面提供一个连接按钮。点击后,系统会显示 VPN 配置或连接请求。确认授权后,状态栏通常会出现 VPN 标记,客户端主界面也会从未连接变为已连接。这个标记只代表系统通道已经建立,节点是否真正可用仍要通过访问测试和日志判断。

如果系统没有弹出授权窗口,可以进入系统的 VPN 设置查看是否已有同类连接占用。移动系统通常只允许一个主要 VPN 通道同时工作,其他网络工具可能导致新连接无法建立。关闭冲突连接后回到 Clash 客户端重试。

需要时再启用 TUN

如果浏览器能够通过系统代理访问,而游戏、命令行工具或特定桌面程序没有进入客户端,可以再评估 TUN。桌面端开启 TUN 时可能要求管理员权限、安装服务组件或批准网络扩展。启用后先保持原有规则模式不变,只观察接管范围是否改善。

TUN 涉及虚拟网卡、路由和 DNS 路径,不适合在首次连接失败时直接作为通用修复。系统代理与 TUN 的工作边界、权限要求和冲突排查可继续阅读疑难手册的系统接管章节

STEP 04
RESULT CHECK

验证是否生效

验证不只看连接按钮。需要同时观察网页访问、连接记录、规则命中和节点结果,确认请求确实经过预期路径。

先做两组访问测试

保持客户端连接状态,先打开一个平时可以直接访问的网站,确认基础网络没有因为代理设置而中断。然后访问一个预期应由代理策略处理的目标。建议使用新建浏览器标签页并刷新一次,避免浏览器缓存、旧连接或 Service Worker 让结果看起来没有变化。

如果普通网站和目标网站都能正常打开,继续查看客户端的连接记录。若普通网站可用、目标网站失败,重点检查节点和规则策略;若全部网站都失败,应先检查系统代理端口、当前配置、内核运行状态和本地 DNS,而不是频繁更换订阅。

在连接记录中确认规则路径

打开“连接”“会话”“日志”或 Connections 页面,再刷新刚才的测试网页。列表中应出现新的域名、目标地址、规则名称和策略链。找到对应请求,确认它命中了预期规则,并最终落到刚才选择的节点。若记录显示 DIRECT,说明请求被直连规则处理;若显示 REJECT,则是配置中的拒绝规则生效。

连接记录里完全没有新请求,通常意味着应用流量没有进入 Clash。桌面端检查系统代理是否仍开启,命令行程序则检查是否读取系统代理;移动端检查 VPN 状态是否存在。记录出现但持续超时,说明接管路径已经建立,下一步应检查节点连通性、网络限制或 DNS 解析。

检查节点而不是只看延迟数值

客户端提供的延迟测试可以帮助初步筛选节点,但测试成功不等于所有目标都可访问。选择一个测试可用的节点后,应重新发起真实网页请求,并以连接日志中的建立结果为准。如果节点列表全部超时,先确认订阅刚刚更新成功,再切换基础网络进行对照。

完成测试后,保留规则模式和当前可用节点即可。此时基础配置已经结束。后续若要调整 DNS、细化规则、配置开机启动或处理特定应用,应逐项修改,每改一项都重复本节的访问与日志验证,避免多个变量同时变化。

QUICK DIAG / 05

首次配置快速排查

只处理最常见的起步问题。复杂的 DNS、TUN、系统服务和移动端故障转到疑难手册继续检查。

粘贴订阅后提示下载失败怎么办?

先关闭系统代理,确认当前基础网络能打开普通网页;随后重新复制完整订阅地址,检查链接前后是否带入空格。若浏览器打开该地址也没有返回配置内容,问题位于订阅响应或当前网络,不应继续调整代理模式。若浏览器有响应而客户端失败,查看日志中的连接错误并确认系统时间准确。

订阅导入成功但代理页面没有节点怎么办?

先确认新配置已经设为当前配置,再执行一次更新。查看日志是否出现配置解析、字段格式或规则引用错误。只有订阅名称而没有策略组,通常表示响应内容不完整或解析失败。不要通过反复启动系统代理解决配置层问题。

系统代理开启后所有网站都无法访问怎么办?

先关闭系统代理恢复基础网络,然后检查客户端内核是否运行、当前配置是否选中、主要策略组是否指定节点。重新开启后查看连接记录:没有请求表示流量未进入客户端;有请求但全部超时则检查节点;出现 DNS 错误则进入疑难手册的 DNS 章节继续处理。

浏览器能访问,其他软件仍然直连怎么办?

这通常是应用没有读取系统代理,而不是规则模式失效。先检查应用自身是否提供代理设置;命令行工具可按其文档配置 HTTP 或 SOCKS 代理。需要统一接管更多应用时,再评估 TUN 模式,并在启用后通过连接记录确认流量路径。

REFERENCE

术语与配置概念

需要理解策略组、规则分流、系统代理、TUN、DNS 与订阅之间的关系时,查阅按分类整理的名词解释。

查看名词解释
TROUBLESHOOTING

系统化故障排查

遇到节点超时、订阅失败、速度异常、DNS 问题、系统代理不生效或客户端崩溃时,按症状进入完整排查流程。

打开疑难手册