QUICK START / 配置到验证

Clash 使用教程

导入订阅 → 选择代理模式 → 连接 → 验证是否生效。已备好客户端和有效订阅时,可按约十分钟安排首次配置;遇到错误先停在当前步骤确认原因。

开始前:确认配置来源与当前网络

客户端负责读取配置、执行规则和建立代理连接,本身不等于一份可用订阅。开始前需要准备由可信服务方或自建服务提供的配置地址,确认其输出格式适用于 Clash 或 mihomo。一个网页登录地址、付款页面地址或单条协议分享链接,不一定能直接粘贴到订阅输入框。若服务方提供多个格式选项,应先选择与当前客户端内核匹配的格式。

先在未连接代理时打开一个平时可访问的网站,确认本机已有正常网络,并检查系统时间是否准确。随后退出其他正在接管网络的代理客户端或 VPN,记录已有的手动代理设置。多个程序同时改写系统代理或路由时,界面显示“已开启”也未必代表请求进入了当前客户端。首次操作保留默认端口、DNS 和入站设置,先完成最短连接路径,再逐项调整。

订阅地址经常包含访问凭据,应按账号信息保管。需要求助时,描述客户端名称、内核、操作系统和报错类型即可;发送截图前隐藏完整订阅地址、节点认证字段以及个人账号。不要把私人配置上传到不熟悉的在线转换页面。协议支持和订阅格式的进一步差异,见协议与内核技术参考。

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

填写地址,等待配置下载完成

打开客户端的“订阅”或“配置”页面,找到“新建”“添加”或“从 URL 导入”。选择远程订阅类型,填写便于识别的名称,然后粘贴完整订阅地址。粘贴后检查开头和结尾,去掉误带的空格、换行或聊天软件附加的标点,但不要删改地址中的查询参数。若界面提供更新间隔,首次可保留默认值,手动确认能成功下载后再设置自动更新。

点击“导入”或“下载”后,等待当前操作结束。成功时通常会出现一张配置卡片,显示配置名称、更新时间或可用操作。配置卡片存在不等于已被使用:继续点击“启用”“使用”或对应的选中按钮,确认当前配置标记已经切换。再进入“代理”页面,查看是否出现该配置定义的代理组;若仍只有默认直连项,先返回检查当前启用的是哪份配置。

持有本地 YAML 文件时,可使用“从文件导入”选择文件。导入前保留原始副本,避免之后的编辑覆盖唯一配置。本地文件通常不会因为远程服务变更而自行更新;远程订阅则可能在下一次刷新时替换下载内容。因此,首次上手不建议直接在订阅正文中追加大量规则,后续需要固定自定义项时,再了解客户端的配置覆写或合并功能。

导入失败时,先区分下载错误与解析错误

若提示超时或连接失败,先确认地址仍有效,以及当前网络能否访问订阅服务。订阅更新请求走直连、系统代理还是客户端内核,取决于具体实现和更新选项;不要假定节点切换后更新请求就一定换了路径。如果订阅需要一条已经可用的代理才能下载,而当前尚无可用配置,应联系提供方获取可用的初始导入方式,不要盲目开启尚未配置完成的系统代理。

若出现 HTTP 401、403 或 404,分别检查授权、服务端限制和地址是否失效;具体含义仍以服务方说明为准。若提示 YAML 解析失败、未知协议或字段不支持,说明问题可能已经进入配置内容或内核兼容层。此时复制不含凭据的错误片段,确认格式选项与内核类型。只有订阅成功启用、代理组能够显示后,再进入下一步,避免把导入问题误判成节点故障。

步骤二:选择规则模式与代理节点

配置启用后,进入“代理”或“概览”页面,找到运行模式选项。初次使用选择“规则”,英文界面通常显示为 Rule。在该模式下,请求先匹配配置中的规则,再进入规则指定的直连、拒绝或代理组。它不会让所有网站都经过同一个节点,也不要求每次访问前手动切换模式,适合作为日常使用的起点。

“全局”模式通常让请求进入全局代理组,仍需在该组内选择具体出站;它不是让所有应用自动接入客户端的开关。“直连”模式通常让请求使用直接出站,也不等于关闭系统代理或停止内核。不同模式改变的是内核如何选择出站,系统代理和 TUN 改变的则是流量如何进入内核。这两层应分开理解,后续排查时才能知道该检查哪个设置。

接着查看代理组列表。手动选择型代理组允许点选一个节点;自动测速、故障转移或负载均衡组则按配置策略工作,未必支持同样的手动固定操作。找到规则实际使用的选择型组,展开后点击一个可用节点,确认选中标记已经移动。组名可能是“代理选择”“PROXY”或服务方自定义名称,不必为了与教程一致而重命名。若组内选项仍指向另一个代理组,需要继续查看下一层的实际选择。

可以执行一次客户端提供的可用性或延迟测试,帮助排除明显无法连接的选项。测试结果只代表客户端到指定测试目标的一次探测,不能等同于下载速度、持续吞吐或所有网站的访问质量。超时也可能与测试地址或测试路径有关,因此先选一个探测正常的节点,等连接后用真实请求验证,不要只比较毫秒数就反复切换。

选择完成后先保持“规则”模式,不同时修改规则顺序、DNS 和代理组结构。如果某个网站最终走直连,也不一定是连接失败,可能正是配置的预期行为。下一步只负责让应用流量进入客户端,最后再通过连接记录确认它命中了哪条规则。需要理解各协议的特点、规则匹配方式与内核兼容性时,可转到技术参考,无需在首次连接前改写整份配置。

步骤三:启动内核并接入应用流量

桌面端:先使用系统代理

返回客户端“概览”或“设置”页面,确认内核处于运行状态,没有配置加载错误。如果界面有“启动”按钮,先启动内核;有些客户端在配置启用后会自动启动。随后找到“系统代理”并开启。该开关通常会把操作系统的 HTTP 代理地址指向本机监听端口,让读取系统代理设置的应用把请求交给客户端。开启后重新发起浏览器请求,必要时重启浏览器,避免旧连接继续沿用原路径。

到“网络”“端口与入站”或类似页面,核对实际监听地址与混合端口。常见示例为 127.0.0.1:7890,但实际值以当前客户端为准;mixed-port 表示同一端口接收 HTTP 与 SOCKS 代理请求。若启动日志提示端口已占用,应先检查旧客户端或其他监听程序。确需改端口时,客户端入站和应用中的手动代理设置必须一起更新,不能只改其中一处。

首次连接不必开启“允许局域网连接”。这一选项面向其他设备访问本机代理的场景,与本机浏览器是否能用系统代理没有直接关系。保持关闭可以减少需要处理的监听地址、防火墙与访问控制问题。外部控制地址用于管理内核,也不是浏览器的代理端口,不应把 127.0.0.1:9090 之类的控制地址填入浏览器代理设置。

移动端:确认系统 VPN 授权

在移动端启用配置并选好节点后,返回主页点击“连接”或启动开关。首次连接时,系统可能弹出添加 VPN 配置或建立 VPN 连接的授权窗口,确认来源是正在使用的客户端后再允许。成功后通常能在客户端看到已连接状态,并在系统网络设置或状态区域看到相应标记。这里的 VPN 接口是应用接入流量的系统机制,实际出站仍取决于配置规则和代理组。

如果授权后立即断开,先查看日志中是否有配置、权限或网络接口错误。若系统已有另一个 VPN 连接,先断开再重试;部分系统无法让两者同时接管流量。还需留意按应用代理、排除应用以及后台运行限制:被排除的应用可能不会进入客户端,系统回收后台进程也可能导致连接中断。先在前台验证浏览器访问,再按需调整这些选项。

步骤四:分别验证浏览器与终端

从连接记录确认请求去向

保持客户端运行,在浏览器中打开一个日常使用的 HTTPS 网站,同时进入客户端的“连接”页面。观察新请求是否出现,查看目标域名、命中规则以及出站链路。使用规则模式时,同一页面的不同资源可能分别走直连与代理,因此不要只凭“网页能打开”就判断所有请求都已经使用节点,也不要把直连记录直接当作异常。

如果页面能打开,但连接列表没有新记录,先确认连接页是否启用了过滤条件,是否只显示仍然存活的连接;也可以查看同期日志辅助判断。然后检查系统代理是否仍开启、浏览器是否被扩展或独立代理设置接管。缓存页面和旧连接都会干扰判断,可打开新标签并发起新的请求。仅查看出口地址也不充分:规则模式可能让查询地址本身走直连,需要结合规则与出站记录一起判断。

终端不一定读取系统代理

浏览器访问正常而命令行失败时,先单独验证终端。许多命令行工具不会自动读取桌面系统代理,可以用下面的显式代理参数做一次 HTTPS 请求测试。示例使用本机混合端口 7890,执行前替换为设置页显示的实际端口;在 Windows PowerShell 中使用 curl.exe,可避免部分环境里同名命令别名的差异。

curl --proxy http://127.0.0.1:7890 --head https://example.com

命令返回有效的 HTTP 响应,并且客户端出现对应请求,说明这一次命令已通过指定代理完成访问。响应状态仍取决于目标站点,不能要求所有网站都返回同一个状态码。若提示无法连接本机端口,优先检查内核是否运行、端口是否一致;若已进入客户端但出站失败,再检查节点、目标连接和日志。终端的长期代理设置需按具体工具配置,不要把一次命令测试的成功扩大为所有终端程序都已接管。

Windows UWP 应用:单独检查回环访问

当普通浏览器正常,而某个 UWP 应用或受应用容器限制的程序无法使用本机代理时,再考虑回环访问限制。先确认该应用确实读取当前代理设置,且问题只出现在它身上。如果客户端提供“UWP 回环”“回环豁免”或类似工具,以所需权限打开,找到对应应用并仅为需要的应用启用豁免,然后完全退出该应用再重启测试。

回环豁免解决的是特定应用访问本机监听地址的权限问题,不会修复订阅解析失败、节点不可用或所有程序断网。不要把所有应用批量勾选当成通用修复,也不必为了普通浏览器启用这一操作。客户端未提供工具时,可先确认应用包身份,再查阅 Windows 对应用容器回环的说明,避免照抄与本机应用不符的命令。

最后验证关闭与恢复

测试完成后,桌面端先关闭“系统代理”,再退出客户端;移动端使用“断开”停止连接。重新打开一个原本可以直接访问的网站,确认网络恢复。如果客户端异常退出后浏览器仍尝试访问失效的本机端口,进入系统代理设置,移除本次留下的手动代理;若设备原本使用单位或校园提供的代理,则恢复之前记录的值,不要直接清空组织要求的设置。

至此应能回答三个问题:哪份配置正在运行、请求命中了哪条规则、最后由哪个出站处理。后续遇到故障时,按“订阅是否有效 → 内核是否启动 → 应用是否接入 → 出站是否成功”的顺序回查,每次只改一项并重新验证。需要调整协议、DNS、TUN 或配置覆写时,继续阅读协议与内核技术参考;需要更换客户端时,前往客户端下载页按系统和架构选择安装包。