config.yaml / 首次配置

Clash 使用教程

从导入订阅到核对第一条连接。先用规则模式跑通一个测试请求,再按需要调整端口或启用 TUN。

01 / profiles

导入订阅并启用配置

先准备一条由服务方或管理员提供、适用于当前客户端的订阅链接。订阅链接是客户端用来拉取配置的地址,不是浏览器代理设置里要填的服务器地址。链接有时带有账户凭据,复制时要保留完整内容,也别把它贴到公开截图或排查帖子里。如果收到的是本地 YAML 文件,直接选「从文件导入」,不用先把它上传到别处生成链接。

添加配置并等待下载完成

打开客户端的「订阅」或「配置」页,新建一条远程配置。有的界面先让你选来源类型,再显示 URL 输入框;也有的直接提供「从 URL 导入」。把链接粘贴到地址栏,检查末尾有没有随手复制进去的空格或标点,再保存。名称可以写成便于区分的备注。列表出现新条目后,等下载完成;如果界面提供「更新」按钮,可以手动更新一次,看是否出现成功状态或新的更新时间。

如果保存后提示格式错误,先确认复制的是订阅接口,而不是账户登录页或使用说明页。能在浏览器打开一个地址,不代表它返回的是客户端能解析的配置。遇到授权失败,回提供方的管理界面确认链接是否仍有效;遇到超时,先确认当前网络能访问订阅来源。导入还没成功时,不必反复切换代理模式,因为模式并不负责把这份配置下载下来。

确认新配置正在使用

导入成功只说明文件拿到了。回配置列表,点选刚导入的条目,或打开菜单里的「设为当前配置」,看到勾选或「使用中」再离开。接着打开「代理」页,看看能否找到这份配置里的组名和可选节点。如果列表仍是之前那一套,先回去核对当前配置,而不是先换节点。确认客户端加载的是这份配置后,再决定它该按什么方式分配连接。

02 / mode

选择代理模式与策略组出口

在「代理」页或首页的模式菜单中,找到「规则」「全局」「直连」。首次配置建议先选「规则」:流量进入客户端后,客户端会按顺序检查规则,命中后使用该条指定的目标。这个目标可能是直接连接,也可能是拒绝,或者交给某个策略组。切换后确认界面当前高亮的是规则模式,不要把旁边节点列表里的勾选当作模式已经切换。

看清规则指向哪个组

如果客户端提供规则列表,先找一条看得懂的域名规则,记下它指向的组,再回代理页展开那个组。假如规则指向「手动选择」,就查看该组当前选中了哪个节点,而不是随手在别的组里切一个。若选项本身还是另一个组,可以继续查看下一层。自动选择组通常按自己的测试结果选出口,界面可能只显示当前结果;不用为了首次验证就把自动组改写成手动组。

如果某条规则的目标写着 DIRECT,这条请求按配置直接连接,旁边的代理节点即使可用也不会处理它。目标是 REJECT 则表示按规则拒绝。准备验证时,挑一个去向明确的测试域名:如果想确认代理出口,别拿原本就该直连的域名来测。看不清规则顺序或兜底项时,先翻配置字段手册,不用急着编辑订阅文件。

全局和直连留作对照

全局模式把已进入客户端的流量交给全局策略,适合临时对照规则分流结果;切换后也要确认全局策略选了哪个出口。直连模式则让已接管的流量直接发出,它和关闭系统代理或断开 VPN 不是一回事。三种模式都不能单靠切换按钮接管原本没进入客户端的应用。选好规则模式和出口后,下一步才是让系统或应用把请求送进来。

03 / mixed-port

开启系统代理或客户端连接

桌面端先从系统代理开始

保持客户端运行,在首页、托盘菜单或设置页找到「系统代理」,打开后确认开关没有立即回弹。这个开关负责让遵循系统代理设置的应用把请求交给本机代理。首次验证先用这样的浏览器,把终端、游戏和设有独立代理的应用留到后面。如果浏览器装了会修改代理设置的扩展,先确认它是否覆盖了系统设置,否则客户端开关虽亮,浏览器也可能走的是另一条线路。

如果桌面客户端没有系统代理开关,或者系统环境不接受它自动设置,可以在支持手动代理的测试应用中填写地址和端口。先看客户端的实际监听地址、端口与协议:在仅供本机使用、且监听本机回环地址的情况下,地址可填 127.0.0.1;只有确认混合端口是 7890 时才填这个数字。混合端口可接受 HTTP 与 SOCKS 代理连接;若客户端把两种端口分开,就按应用选择的代理类型填写。字段用途见通用字段。

移动端确认系统授权

回客户端首页点「连接」或启动按钮。首次启动时,系统可能询问是否允许建立 VPN 连接,确认弹窗来自刚打开的客户端,再按系统提示授权。回到客户端确认状态显示为已连接;系统也可能在状态栏或 VPN 设置里给出提示。授权只代表系统允许建立连接,若客户端仍显示未连接,先看当前配置有没有启用、是否有其他 VPN 占用了连接,以及系统有没有拦下本次启动。

初次测试不必同时打开系统代理和 TUN。部分应用不读取系统代理设置,如果浏览器已经跑通而这些应用没有记录,再查看客户端是否支持 TUN,以及启用时需要哪些系统权限。排查时一次只改一项:保留当前配置和模式,先看一次接管方式改变后的结果,避免把接管问题与规则、端口或节点问题混在一起。

04 / DIRECT

验证请求是否按预期分流

把一次网页请求和一条连接记录对上

保持客户端的「连接」或「日志」页可查看,然后用测试浏览器打开一个你知道该走哪条规则的域名。尽量用新开的标签页发起请求;如果只看见缓存页面或找不到新记录,关闭对应标签页再重试,也可以换一个同类测试域名。回到客户端按域名和时间找记录,别只看请求总数。页面往往会加载图片、字体和接口,附带域名各自匹配规则,不能拿其中任意一条代表主页面。

找到对应记录后,先看目标对不对,再看匹配的规则和实际出口。如果预期走代理,应看到连接交给指定策略组,并最终走到预期节点;如果预期直连,看到 DIRECT 就符合配置。不同客户端显示的细节不一样,连接列表没有规则列时可以换看日志。只看网页能不能打开不足以判断分流是否正确,只看节点测速也不足以证明当前浏览器已经使用这个出口。

按记录判断下一处该查哪里

如果客户端完全没看到这次请求,先查应用有没有进入代理:桌面端核对系统代理、浏览器自己的代理设置和实际监听端口,移动端核对 VPN 状态与应用范围。若有记录但走错目标,回「代理」页核对模式,再回头看匹配到的具体规则和组内选择。若规则和出口都对却打不开,先记下日志里是解析失败、连接超时,还是目标拒绝连接,再按故障排查对应处理。此时不用把四步全部重来。

复测前先记下当前模式、策略组和测试时间,再重复打开同一页面。对照两次记录时,先确认比较的是同一个目标域名;如果网页跳转到了另一个地址,就分别检查跳转前后的连接,不要把两条记录当成一次规则匹配。

验证结束后,把临时切换的模式恢复到日常使用的设置;如果只手动改过测试应用的代理,也记得按需还原。准备关闭客户端时,先关闭它开启的系统代理或断开 VPN,避免系统继续向已经停止监听的本机端口发请求。下次更新订阅后,可以用同一个域名复测。需要请人协助时,提供客户端名、当前模式、测试目标与不含敏感信息的报错即可,不要附上订阅地址或完整配置。