QUICK START / 首次配置

Clash 配置教程

导入订阅 → 选择代理模式 → 开启连接 → 验证生效。按顺序完成一次基础连接,再调整 TUN、DNS 与分流规则。

开始前准备好已安装的客户端,以及服务提供方给出的订阅链接或 YAML 配置文件。客户端负责读取配置和转发连接,安装完成本身不代表已有可用出口。首次操作建议预留约十分钟;如果缺少订阅、账号权限或网络条件,应先解决这些前提,而不是反复更改客户端参数。

先关闭其他正在接管网络的代理或 VPN 工具,避免代理地址、虚拟网卡和路由相互覆盖。保留原配置的副本,记住系统原来的代理状态。以下步骤每次只改一类设置,并在进入下一步前确认结果,这样出现异常时可以明确回退到哪一步。

01 · 导入订阅并启用配置

打开客户端,进入「配置」「订阅」或 Profiles 页面,选择「新建」「添加」或「从 URL 导入」。如果弹窗要求选择类型,使用远程订阅或远程配置,而不是新建单个代理。给配置起一个便于辨认的本地名称,再把服务提供方给出的完整链接粘贴到 URL 输入框。名称只影响本机显示,不决定连接到哪个出口。

粘贴后先检查链接的开头和结尾。聊天软件复制的内容有时包含说明文字、换行或末尾标点;只保留链接本身,但不要删改问号后面的参数。订阅地址可能包含访问凭据,不要把完整链接提交到公开讨论区,也不要发送带有链接的未遮挡截图。需要求助时,保留错误文本,隐藏地址中的敏感部分。

点击保存、导入或下载,等待客户端结束请求。正常结果通常是配置列表中出现新条目,附有名称、更新时间或下载状态。随后点击该条目的「使用」「激活」或选择标记,让它成为当前配置。部分客户端保存后不会自动切换;仅看到条目已经加入列表,还不能说明运行中的内核已读取它。

确认代理组已经出现

切换到「代理」或 Proxies 页面,检查是否出现可选择的代理组及其成员。代理名称由配置提供方定义,不一定叫 PROXY。若这里只出现 DIRECT、REJECT 等内置项,先回到配置页确认当前选中项,再查看导入提示。远程代理提供者也可能需要额外下载,主配置导入成功并不保证所有远程资源都已加载。

如果手里是本地文件,在同一页面选择「导入文件」,定位到实际的 .yaml 或 .yml 文件,再启用它。不要只把文件扩展名改成 YAML:网页、登录提示和报错页面不会因此变成有效配置。文件应包含实际代理信息,或能够加载代理的 proxy-providers 定义;只有端口和规则的片段通常不足以建立代理连接。

导入失败时先读错误类别。连接超时说明请求没有顺利完成;认证失败需要确认订阅权限;解析错误则要检查提供方是否给出了兼容当前内核的配置格式。不要直接把私人订阅提交到不熟悉的在线转换页面。有关链接格式和转换的边界,可先阅读术语表中的订阅与配置文件说明,具体失败处理见帮助中心。

02 · 选择规则模式与出口

保持刚才的配置处于启用状态,进入「代理」或「模式」页面,找到「规则 / 全局 / 直连」选项。首次配置选择「规则」,对应内核字段 mode: rule。它会按照配置中的规则决定连接是直连、交给某个策略组,还是拒绝。模式选项只负责分流决策,不负责把其他应用的流量送入客户端。

接着找到配置中承担出口选择的策略组。它可能以「代理选择」「节点选择」或其他名称显示。展开该组,在成员中选定一个可用代理;如果成员仍是另一策略组,就继续检查它当前选择的出口。首次验证尽量使用一个明确的手动选择,便于把测试结果与出口对应起来,不要同时修改多个业务分流组。

某些配置默认选择自动测试组。可以保留它,但要理解测试结果只是客户端到指定测试地址的观测,并不保证目标网站一定可访问。若客户端提供连通性测试按钮,可执行一次,观察是否有超时或明确错误。测试完成后仍需继续后面的实际访问验证,不要把一个测试数值当作全部应用已经接管的证据。

区分模式与接管开关

模式 连接处理方式 首次使用建议
规则 rule 按配置中的规则匹配策略。 作为日常使用与本教程的起点。
全局 global 进入内核的连接交给全局策略。 仅在需要对照规则影响时短暂使用。
直连 direct 进入内核的连接直接连接目标。 用于特定对照,不等同于关闭接管。

「全局」也不会让原本绕过客户端的应用自动进入内核。如果浏览器没有使用系统代理,单独切换全局模式通常不能解决它的流量接管问题。同样,选择「直连」不代表系统代理设置或虚拟网卡已经移除;需要完全退出接管时,应关闭相应开关,而不是只切模式。

如果规则模式下某个目标走向与预期不同,先记录现象,不要立即删除规则。后面的连接页会显示匹配信息,可以据此判断是规则选择还是流量接管的问题。现在只需确认规则模式已选中、出口组有明确选择,然后进入连接步骤。规则顺序、策略组嵌套和 MATCH 的详细行为留到完整文档的配置章节查阅。

03 · 开启系统代理或 VPN 连接

先回到客户端首页或概览页,确认配置加载后内核已启动。如果界面把「启动内核」和「系统代理」分成两个开关,先启动内核,再启用系统代理;如果只有一个连接按钮,则按客户端提示操作,并在日志中确认没有启动失败。此时不要同时开启多个网络接管工具,也不要为了排查而关闭系统防火墙。

桌面端:先验证系统代理

Windows、macOS 和带桌面环境的 Linux 客户端通常提供「系统代理」开关。打开后,遵守操作系统代理设置的应用会把请求交给本地监听端口。查看客户端设置里的实际地址与端口,例如 127.0.0.1:7890;这里只是常见配置,最终以当前客户端显示的值为准,不要为了与教程数字一致而随意改端口。

若客户端提示端口已占用,先退出其他代理客户端,再重新启动内核。启动日志出现 address already in use 时,系统代理开关即使看似打开,也不代表本地代理服务已经可用。确认监听成功后,再重新打开一个浏览器窗口测试。部分应用会保留已有连接,必要时完全退出该应用再启动,而不是只刷新旧页面。

Linux 的桌面代理设置是否被应用采用,取决于桌面环境与应用实现;终端程序也不一定读取系统代理。首次验证先选择一个支持代理设置的浏览器,不要立刻拿所有终端工具的表现作判断。服务器、路由器或 systemd 服务的部署不属于这条图形界面上手路径,相关设置见Linux 安装与部署章节。

移动端:批准系统 VPN 授权

Android 与 iOS 上,点击客户端的启动或连接按钮后,系统通常会请求创建 VPN 连接或添加 VPN 配置。确认请求来自刚安装并正在使用的客户端,再按系统提示批准。返回客户端后检查连接状态;如果授权被取消,客户端中已选好配置也不会开始接管网络。系统状态栏标记只能证明隧道处于启用状态,不能证明远端出口可用。

如果系统已有其他 VPN 正在运行,先断开它,再尝试启动当前客户端,避免两个工具争用系统 VPN 通道。首次测试时把客户端保留在前台,完成一次访问验证;只有前台正常、切到后台才断开时,再检查电池管理与后台运行权限。不要把这类后台限制误当成订阅失效而反复重新导入。

什么时候再开启 TUN

桌面端先用系统代理建立可重复的测试结果。需要接管不遵守系统代理设置的应用或特定类型流量时,再考虑 TUN。它通常涉及虚拟网络接口、路由与 DNS 处理,可能要求管理员权限或客户端服务支持。按客户端的服务安装提示操作,不要仅凭开关颜色判断安装已完成。

初次启用 TUN 时记录原来的系统代理状态,并遵循该客户端对两者配合的说明;不要一次更改 TUN、DNS、路由和模式。若启用后基础网络中断,先关闭 TUN,回到已经验证过的系统代理路径。桌面 TUN 与移动端 VPN 授权界面名称相近,具体实现仍有差异,进一步原理可查网络接管模式术语。

04 · 验证访问与连接记录

验证要同时观察应用端和客户端端。先确认在关闭接管时,当前网络可以访问一个平时正常使用的站点;如果基础网络本来就异常,应先处理 Wi-Fi、移动数据或网络登录。随后恢复刚才的代理连接,打开一个需要检查的目标页面。使用新的请求进行测试,避免仅凭已经缓存的页面内容判断是否成功。

页面加载后立即回到客户端的「连接」或 Connections 页面,查找刚才访问的目标域名。新请求可能很快结束,必要时再次刷新页面,并打开日志辅助观察。检查三个信息:目标是否出现、命中了哪条规则、最终交给哪个策略或出口。规则模式下,部分站点命中 DIRECT 是正常分流结果,并不表示整个客户端未工作。

按现象缩小检查范围

如果目标完全没有连接记录,先检查应用是否采用系统代理、内核是否真的监听,以及移动端 VPN 是否仍处于连接状态。不要在这时优先更换出口,因为请求可能根本没有进入客户端。若能看到记录但走向与预期不同,应检查当前模式、命中规则和策略组选择,而不是重新安装软件。

如果已经命中预期策略,却出现超时、拒绝连接或握手错误,再检查选定出口是否可用、订阅权限是否有效,以及设备时间是否准确。一次只换一个出口并重试同一目标,保留前后结果。只有特定网站异常时,还应考虑目标站自身状态;不要用单个网站的成功或失败概括全部网络连接。

可选:显式指定本地代理测试

桌面端可以用下面的命令辅助区分本地代理服务与应用代理设置。它显式使用本地 HTTP 代理,不依赖浏览器是否读取系统设置。执行前把端口改成客户端实际的 HTTP 或 mixed 监听端口;如果仅启用了 SOCKS 监听,不要照用这个 HTTP 代理参数。

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

Windows PowerShell 中建议把命令开头写成 curl.exe,避免旧环境里的同名别名改变参数含义。返回 HTTP 响应头说明这一次通过所指定本地代理的请求收到了目标响应,但具体是否使用远端出口仍要看客户端连接记录;规则也可能让该目标直连。出现无法连接本地地址时,先检查监听端口,而不是直接修改 DNS。

命令成功而浏览器失败时,重点检查浏览器自身的代理扩展、独立代理设置以及旧连接。浏览器成功而其他应用失败时,重点确认该应用是否支持系统代理,必要时再评估 TUN。外部 IP 查询只能作为辅助:规则分流下,不同查询站点可能走不同出口,因此 IP 未变化不能单独证明代理失效。

保存可重复的工作状态

当测试页面可以访问,连接记录也符合预期,就保留当前模式与接管方式。记录正在使用的配置名称、实际监听端口和选中的策略组,后续排查会更直接。需要退出时先关闭系统代理或 VPN 连接,再退出客户端;尤其是手工配置过系统代理地址的设备,应确认没有留下指向已停止端口的设置。

订阅内容发生变动时,在配置页执行更新,更新完成后确认当前配置仍处于启用状态,再重复本节的验证。不要在尚未完成基础测试时叠加复杂规则。遇到更新失败、UWP 应用不走代理或只有部分程序无法上网,转到帮助中心按现象排查;需要长期维护配置时,再继续阅读完整文档。

Clash最新版下载