Clash 使用指南

订阅导入 → 模式选择 → 启用连接 → 验证分流

本页以首次完成一次可验证的连接为目标,按顺序操作即可。已经安装客户端、持有有效配置时,可按约十分钟安排操作;订阅下载和网络排查所需时间取决于实际环境。尚未安装时,先到Clash 下载页按设备选择客户端,再回到本页继续。

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

先准备配置来源提供的订阅地址或本地 YAML 文件。客户端负责读取配置、运行内核和接管流量,不会因为安装完成就自动获得可用代理节点。订阅地址也不是网站首页地址:它应当返回客户端能识别的配置内容。若来源提供多个格式入口,选择明确支持当前 Clash 客户端或 mihomo 内核的格式;不要把适用于其他软件的原始文本直接改名后导入。

打开客户端,进入“配置”或“订阅”页面,找到“新增”“导入”或带加号的入口。选择从 URL 导入,将地址完整粘贴到订阅链接输入框。名称只用于本地识别,可以填写便于区分来源的短名称。检查链接前后是否夹带空格、换行或聊天软件附加的标点,再点击下载或保存。此时等待导入结果,不要连续重复提交,以免生成多份难以区分的配置。

下载成功后,配置列表通常会增加一项记录。点击该记录,或使用记录旁的“启用”“使用”操作,让它成为当前配置。有些客户端导入后会自动启用,有些只保存文件;应当观察当前选中标记,而不是仅凭“下载成功”提示判断。随后进入“代理”页面,确认能看到配置定义的策略组。只有一条文件记录、却没有预期策略组时,先回到配置页核对启用项与错误信息。

如果使用本地文件,在同一页面选择“从文件导入”,定位到已保存的 .yaml 或 .yml 文件并打开。文件导入通常保存的是本地副本,不等于建立了远程更新关系。后续来源修改节点时,需要重新导入文件,或改用来源提供的订阅入口。不要把文件内容中的单个节点段落当成完整配置;初次使用应优先使用来源提供的完整兼容配置。

导入失败时,先检查返回内容

出现下载超时、格式错误或加载失败时,先保留具体错误文字。检查设备在未启用代理时是否能正常联网,再核对订阅地址是否过期、是否需要重新从来源页面复制。返回登录页、错误提示页或不支持的格式,都可能表现为解析失败。若客户端提供“通过代理更新”选项,而当前尚未建立可用连接,先按实际网络情况使用直接更新,避免更新请求依赖尚未运行的代理。

订阅链接可能包含账户识别信息,应当像访问凭据一样保管。排查问题时,不要把完整地址、二维码或配置全文发到公开评论区。需要记录错误时,只保留错误类型和经过遮盖的截图。更详细的订阅格式与更新问题可查阅常见问题,本页先继续完成连接主线。

确认更新不会覆盖本地调整

第一次导入完成后,可手动执行一次“更新”,确认来源能够再次获取。暂时不要在下载来的配置正文中做大量修改,因为下次更新可能替换这些内容。确需调整 DNS、规则或端口时,应先了解客户端的覆写机制;相关内容放在mihomo 进阶配置手册中。当前只需确认配置已启用、策略组可见,再进入模式选择。

第二步:选择代理模式与策略组

配置加载完成后,回到客户端首页或代理设置,找到模式选择入口。界面常见名称为“规则”“全局”“直连”,对应内核中的 rule、global、direct。初次使用先选择规则模式,让配置中的规则决定请求交给哪个策略。不要为了让连接看起来更彻底而同时开启多个网络开关;模式只决定进入内核后的处理方式,并不负责让应用流量进入内核。

规则模式会按配置中的规则顺序匹配连接,首个命中项决定目标策略。例如某个域名可以交给代理策略组,另一些请求可以交给 DIRECT。这些安排来自当前配置,不是所有订阅都采用同一套分流逻辑。因此,选择规则模式之后仍需要打开“代理”或“策略组”页面,检查规则使用的主要策略组指向哪里。

在手动选择组中,点击一个来源提供、当前可用的节点,或选择配置预设的自动选择组。组名由配置定义,可能叫“代理”“节点选择”或其他名称,不必寻找一个固定名字。若一个组内列出的仍是其他组,需要继续确认下层选择;上层组指向直连时,仅更换另一个未被使用的组中的节点,不会改变这条请求的实际出口。

客户端提供连通性测试时,可以执行一次测试辅助筛选。测试成功说明该测试条件下连接可建立,不代表所有网站、所有协议都能正常使用;测试超时也可能受测试地址影响。先选一个能完成基本访问的节点即可,最终是否生效要在第四步结合实际请求检查,而不是只看测试结果或某个数字。

三种模式的作用与适用操作
模式 进入内核后的处理 本次教程中的用途
规则 rule 按规则匹配目标策略 作为日常使用与验证的起点
全局 global 通常统一交给全局策略选择 临时对照,检查是否为规则选择问题
直连 direct 让进入内核的连接尝试直接访问 对照原有网络,不等于关闭流量接管

全局模式用于对照,不代替接管设置

当某个站点在规则模式下失败,可以临时切换全局模式,并检查全局策略实际选择的节点,再重新发起请求。如果全局可用、规则不可用,下一步应检查命中规则和策略组,而不是立即改 DNS。测试结束后切回规则模式,避免把本来适合直接访问的请求也交给代理出口。

全局模式不等于“整台设备的全部流量都已代理”。不遵循系统代理的应用,仍可能绕过内核;需要更广的接管范围时才考虑 TUN。直连模式也不等于退出客户端,系统代理或 VPN 接管仍可能处于开启状态。理解这一区别后,保持规则模式与选定策略,接下来只处理“怎样让应用请求进入内核”。有关规则与组类型的细节,可继续查阅策略组配置章节。

第三步:启用系统代理或移动端 VPN

先确认客户端没有配置加载错误,首页显示内核正在运行,或连接按钮处于可启动状态。配置启用、内核运行、流量接管是三个不同环节:有配置但内核未启动,请求无法被处理;内核已运行但没有接管,浏览器也可能继续沿原来的网络访问。此时先不要同时开启系统代理、TUN 和另一款 VPN,采用一种接管方式更容易判断结果。

桌面端:先使用系统代理

在 Windows、macOS 或 Linux 客户端中,找到“系统代理”开关并开启。部分客户端会先请求系统授权,按设备提示确认后,再检查开关是否保持开启。通常不需要在浏览器里另填节点服务器地址;系统代理指向的是本机内核监听端口,内核再根据配置决定使用哪个远端出口。

若需要核对系统设置,查看系统代理使用的地址和端口是否与客户端一致。常见本机地址是 127.0.0.1,本站示例混合端口为 mixed-port: 7890,但你的客户端可能采用其他端口,应以当前生效设置为准。已有浏览器代理扩展时,先让浏览器使用系统代理,避免扩展继续把请求发往旧端口。首次操作不需要打开允许局域网连接。

看到端口被占用或内核启动失败时,不要只反复切换系统代理。先退出其他可能监听同一端口的代理客户端,再尝试启动;如果需要修改监听端口,系统代理所用端口也必须同步。Linux 桌面环境与具体应用对系统代理的支持存在差异,浏览器可用而终端程序不可用,并不一定代表内核故障。本次先用明确支持系统代理的浏览器完成验证。

移动端:确认 VPN 授权与连接状态

在 Android 或 iOS 客户端首页点击“连接”或启动按钮。系统首次弹出添加 VPN 配置、建立 VPN 连接等提示时,确认请求来自当前使用的客户端,再按提示授权;设备可能要求解锁。返回客户端后等待连接状态更新,并查看系统的 VPN 状态。授权完成只说明接管配置被允许,还需要用实际请求验证节点是否可用。

如果设备已有另一项普通 VPN 连接,先断开它,再启动当前客户端,避免系统替换连接后造成判断混乱。Android 客户端若配置了按应用代理或绕过列表,还要确认测试浏览器被纳入接管范围。初次测试可先沿用客户端默认范围,待基本连接确认后再缩小;不要在未看懂列表含义时批量排除应用。

完成上述操作后,保持客户端运行,在浏览器中新建标签页。不要只观察客户端首页的“已连接”文字:这一步只建立了接管路径,下一步才检查请求经过哪个规则和出口。

第四步:用连接记录验证分流

准备两个自己熟悉、当前能够用于测试的站点:一个按配置预期直接访问,另一个按配置预期经过代理。先在新标签页发起访问,再切回客户端的“连接”“活动连接”或日志页面。观察目标域名或目标地址是否出现,以及记录中的命中规则、策略链和最终出口。不同客户端展示字段不完全相同,但目标是把浏览器中的这次访问与内核中的处理记录对应起来。

如果站点打开且能找到对应连接,继续检查它是否使用了预期策略。记录为 DIRECT 说明内核对该连接选择了直连,不是客户端没有工作;记录指向代理组时,还要展开或查看最终节点,避免只看到上层组名就下结论。测试代理规则时,应当选择确实会命中该规则的域名,不能因为任意网页能打开,就认定代理出口已经使用。

然后访问预期直连的站点,确认规则模式下两类请求都能得到合理处理。可选的出口 IP 查询只能作为辅助证据:查询站点自身也可能命中直连规则,浏览器缓存和旧连接也会干扰观察。若刚更换节点,先新建请求;必要时只关闭相关活动连接后重试。不要为了验证而导出整个浏览历史或公开上传连接列表。

结果不符时,按路径顺序排查

浏览器有请求、客户端却完全看不到相关连接时,优先检查接管:系统代理是否开启、地址与端口是否一致、浏览器扩展是否覆盖设置,或移动端是否把浏览器排除在外。部分客户端的连接列表只保留活动连接,短请求可能很快消失,可结合日志观察。此时直接更换节点或修改分流规则,通常不能解决请求根本没有进入内核的问题。

能看到连接但选错策略时,回到第二步,检查当前模式、上层组选择和命中规则。目标已交给预期节点却连接失败,再尝试同一配置中的另一个可用节点,并比较具体错误。只有出现域名解析失败等迹象时,再检查 DNS。不要同时修改模式、节点、DNS 和 TUN;每次只改一个条件,重新访问同一目标,才能判断是哪项改动产生影响。

如果只有某一个应用失败,而浏览器已经能够按规则访问,先检查该应用是否遵循系统代理、是否使用独立代理设置,以及当前接管范围。DNS 与 Fake-IP 的机制不需要在首次连接时全部展开;遇到明确相关的问题,再读Fake-IP 配置章节。更多异常现象与处理入口集中在常见问题页,可按当前错误继续定位。

停止使用与恢复原有网络

完成验证后,若准备停止使用,桌面端先关闭客户端里的系统代理,再退出客户端;移动端先断开客户端连接,并确认系统 VPN 状态已结束。只退出进程但留下指向本机端口的系统代理,可能让浏览器继续请求一个已经不存在的监听服务。若退出后网页无法打开,先到系统网络设置检查代理状态,恢复之前记录的设置;受组织管理的设备应遵循管理要求。

下次启动时,按“当前配置 → 规则模式与策略 → 接管开关 → 实际请求”的顺序快速复查即可。订阅更新后也建议做一次简短验证,因为来源可能调整组名或分流规则。到这里,已完成从配置导入到连接记录核对的基本闭环;后续需要规则集、本地覆写或外部控制时,再进入进阶手册逐项配置,不必在第一次使用时一次性开启所有功能。