- 首次配置 · 四步操作
- 订阅与本地 YAML
Clash 配置教程
订阅导入与连接验证
按“导入配置 → 选择模式 → 启用连接 → 验证流量”的顺序操作。先建立一条能验证的连接,再调整 DNS、TUN 与自定义规则。
开始前,准备一条支持当前内核的订阅链接,或一份可用的本地 YAML 配置。客户端负责读取配置、运行内核并接入系统流量;安装客户端本身不会生成代理节点。订阅的有效期、节点可用性与配置权限由提供方决定。暂时关闭其他代理客户端和 VPN,保留正常的网络连接,避免多个流量入口互相覆盖。
操作时一次只改一个设置。每步结束都有一个可以观察的结果;结果不符合预期时,停在当前步骤检查,不要靠连续切换开关碰运气。以下主线适合首次建立连接,配置语法与网络栈原理可留到连接成功后再查。
01 导入订阅或本地配置
启动客户端,进入侧栏或底部导航中的“配置”“订阅”页面。首次进入时列表可能为空,这是正常状态。找到“新建”“添加”或带加号的入口,选择通过 URL 导入。将提供方给出的完整订阅链接粘贴到地址栏,为配置填写一个便于识别的本地名称,再点击“保存”“下载”或“导入”。名称只用于区分本地条目,不会改变链接所包含的节点。
粘贴前检查链接首尾是否带空格、换行或聊天软件附加的标点。应使用提供方标注为 Clash 或兼容当前内核的订阅,而不是账户登录页、订单页或普通网页地址。订阅链接常包含访问凭据,不要把完整链接发到公开评论、截图或在线转换网站;需要求助时,先遮住链接参数和个人信息。
等解析完成,再启用配置
导入过程中,客户端通常先下载远程内容,再检查 YAML 结构。成功后,配置列表应出现新条目;如果客户端没有自动激活,点击该条目的“使用”“启用”或选择按钮。随后打开“代理”页面,查看是否出现配置定义的策略组。只有名称出现在列表中,还不能证明配置已经被内核加载,应以策略组能正常显示、日志没有持续报错为准。
通过本地文件导入时,在同一页面选择“从文件导入”,再选中保存好的 .yaml 或 .yml 文件。手机可先把文件保存到系统文件管理器,再通过文件选择器打开;是否支持分享菜单导入,取决于客户端。导入后的配置可能是文件副本,后续修改原文件不一定会同步,需要重新导入或编辑客户端中的本地配置。
导入失败时停在这一层检查
出现下载超时,先确认普通网络是否可用,再检查订阅是否过期、提供方服务是否正常。出现格式解析错误,优先确认拿到的是配置内容,而不是登录提示或网页文本;也要核对配置是否依赖当前内核不支持的字段。不要随意删掉不认识的键,删到能够保存并不代表配置仍然完整。
首次导入不要依赖尚未建立的代理连接。如果本地网络无法访问订阅地址,可使用提供方明确给出的备用入口,或在可信设备上取得本地配置后导入。订阅格式差异可查 术语手册中的配置与订阅说明;更新失败的进一步处理见 订阅更新失败排查清单。完成本步后,保留当前激活配置,继续选择出站方式。
02 选择代理模式与出站节点
进入“概览”或“代理”页面,找到“出站模式”或“模式”设置。首次使用建议选择“规则”,其内核配置值通常是 rule。该模式按配置里的规则顺序,为每条连接选择直连、代理策略组或其他动作。它不会让所有请求都走同一个节点,因此后续看到某些连接显示 DIRECT,并不意味着代理失效。
“全局”模式通常把普通出站连接统一交给全局策略选择,适合临时排查节点连通性或明确需要统一出口的场景,但仍受流量是否进入内核等条件限制。“直连”模式则以直接连接为主,不能用于确认代理节点可用。日常按配置分流时,先用规则模式,验证完成后再决定是否需要其他模式。
模式之外,还要选中策略组的出站
切到“代理”页面,展开主代理策略组。组名来自当前配置,可能是“代理”“节点选择”,也可能按用途命名;不要仅凭名称推断用途,应查看配置说明或组内选项。对于手动选择组,点击一个当前可用的节点,使选中标记落在该节点上。如果组内引用另一个组,还要展开下一级,确认最终出站不是意外选中的直连或拒绝选项。
如果配置提供自动选择组,可以先保留其默认策略,但要理解自动选择依据是配置指定的探测目标,并不保证任意网站都能访问。客户端里的“测试”“延迟测试”可用于初步排除明显不可达的节点;测试失败也可能来自探测地址或网络限制,不应只凭一个测试数字判断所有业务连接。
先保留订阅规则,避免改动互相抵消
首次配置时不必重写规则,也不必把每个用途分组都手动切一遍。先确认主代理组有可用出站,再检查经常使用的应用分组是否引用了预期策略。分组选择通常只影响后续新建连接,已经建立的长连接可能继续使用旧出站;切换后应新建请求验证,而不是盯着一个正在播放的页面判断。
不要同时在订阅配置和客户端覆写设置里修改同一组规则。不同客户端的合并方式不同,界面显示的选项也未必直接修改原始 YAML。需要理解策略组、DIRECT 与规则命中关系时,可查 规则与分流术语;需要自定义组类型、规则集和覆写时,再看 进阶配置手册。本步结束时,应能够指出当前模式、主代理组,以及该组实际选中的出站。
03 启用连接与流量入口
配置与节点选好后,返回概览页。如果客户端有独立的“启动内核”按钮,先启动内核,等待运行状态稳定,再开启流量接入。部分客户端会在启动应用时自动运行内核,另一些则把“连接”作为统一入口。关键是区分两件事:内核已经运行,表示它可以处理请求;系统或应用已把流量交给内核,才表示实际请求有机会经过代理。
桌面端:先开启系统代理
在 Windows、macOS 或支持桌面代理设置的 Linux 环境中,先开启客户端的“系统代理”。通常无需手动填写本机地址与端口,客户端会使用自身监听设置写入系统代理。首次连接先保持 TUN 关闭,也不要开启局域网连接;当前目标只是让本机浏览器通过已导入的配置建立请求,减少同时变化的因素。
开启后,新建浏览器标签页并发起请求。浏览器如果装有代理管理扩展,先切回遵循系统代理的模式;如果曾手动填写代理地址,也要确认没有固定到另一客户端的端口。部分 Linux 桌面环境或应用不读取系统代理,这种情况下界面开关开启也不代表所有应用已经接入,应先用明确支持系统代理的浏览器完成主线验证。
只有需要处理不遵循系统代理的应用时,再考虑 TUN。TUN 通常涉及服务组件、管理员权限或路由设置,开启前应阅读当前客户端提示。它不是“全局模式”的另一种叫法:TUN 决定哪些流量进入内核,规则或全局模式决定进入内核后的出站处理。详细设置见 进阶配置手册中的 TUN 与 Fake-IP 说明。
移动端:允许当前客户端建立 VPN
Android 与 iOS 通常在点击“连接”后弹出系统 VPN 授权窗口。核对应用名称与刚安装的客户端一致,再允许添加或建立 VPN 连接。返回客户端,等待状态变为已连接;系统状态栏或设置页面也可能显示 VPN 标识。这个标识只说明隧道入口已建立,节点是否连通、请求是否按规则出站,仍需下一步验证。
如果手机已经运行其他 VPN、基于 VPN 的过滤工具或工作配置,先检查是否与当前连接争用系统入口。切换应用后频繁断开时,再查看系统电池管理、后台运行权限或客户端的后台说明,不要一开始就批量修改所有系统权限。某些客户端还提供按应用接入设置,若浏览器被排除在外,即使连接显示正常,也不会经过该客户端。
完成后保持客户端运行,不要立即退出程序。此时已经具备配置、出站选择和流量入口三个条件,下一步检查真实请求,而不是仅根据开关颜色判断成功。
04 验证规则命中与连接结果
打开浏览器,新建标签页访问一个确定可用、且预期命中代理规则的网站。避免只刷新已经缓存的页面:缓存内容即使在网络异常时也可能显示。随后回到客户端的“连接”页面,查找刚才访问的域名或目标地址;如果界面支持搜索,可用域名筛选。确认对应记录的建立时间与这次操作一致,再查看命中规则、策略链和最终出站。
一次可靠的验证要同时观察两侧:浏览器能完成新请求,客户端也能显示符合预期的处理路径。如果规则指向代理组,最终出站应是刚才选中的节点或组内实际选中的节点;如果规则指向直连,显示 DIRECT 就是预期结果。不要把“出口地址必须变化”当作所有请求的通过条件,规则模式本来就允许不同目标使用不同路径。
按现象定位,不同时更改多个设置
如果客户端完全看不到浏览器的新连接,优先回到第三步检查流量入口:系统代理是否开启,浏览器扩展是否覆盖设置,移动端是否仍保持 VPN 连接,以及应用是否被排除。某些连接记录停留很短,可以在发起请求时同时观察日志。先确认流量有没有进入内核,再检查节点,排查顺序才不会反过来。
如果能看到连接但页面打不开,检查最终出站是否符合预期。选错组时,回到第二步修正;出站正确但出现超时,可换一个已知可用的节点,再发起新的请求。若日志明确提示域名解析失败,再检查 DNS 相关设置,不要直接抄入整段陌生配置。日志中的目标域名、订阅地址和连接信息可能涉及隐私,分享前应删去不必要的内容。
如果只有某个应用不生效,先检查它是否遵循系统代理、是否自带代理配置,以及是否存在旧连接。浏览器成功并不等于所有应用都已接入。确实需要更广的接管范围时,再按客户端文档单独配置 TUN,并重新执行同样的验证流程。规则优先级、DNS 和路由的深入排查可转到 高级用法,不必在首次连接阶段一次完成。
连接成功后,确认更新与退出行为
回到配置页面,找到订阅条目的更新入口,确认它更新的是当前正在使用的配置。远程订阅通常可手动刷新或按客户端设置自动更新;本地文件则不一定具备远程更新能力。更新后检查激活配置和主策略组选择是否保留,再发起一次新请求。需要长期保留的本地改动,应使用客户端支持的覆写机制,避免直接编辑远程订阅副本后被更新覆盖。
最后了解停止连接的方法。桌面端先关闭系统代理,再退出客户端;如果使用了 TUN,也要关闭对应入口。移动端点击断开,并确认系统 VPN 状态随之结束。托盘中的“关闭窗口”可能只是隐藏界面,不等于停止内核。若退出后普通网页也打不开,检查系统代理是否仍指向已经停止的本地监听端口,恢复原有设置后再测试。
后续需要解释某个字段,先查 术语手册;需要管理规则集、多订阅合并或外部控制面板,再进入 进阶配置手册。这能把日常连接操作与配置维护分开,出现问题时也更容易回到已验证的状态。