FAQ / 配置与排查

Clash 常见问题

先确认配置已经启用,再检查流量有没有进入客户端。订阅能导入、节点能测速、应用能联网,是三个不同的检查环节。按下面的分类查找问题,每次只改一项设置,验证后再继续。

第一次配置可先看使用文档;需要逐平台查阅安装与网络设置时,转到完整文档。本页点击问题即可展开答案。

基础认知

先分清客户端、订阅、运行模式与系统授权,避免在错误的环节反复尝试。

安装 Clash 后,为什么还需要订阅链接?

客户端负责读取配置、匹配规则和转发流量,不会在安装后自动生成可用的代理线路。订阅链接是用于获取配置的地址,通常包含节点、策略组和规则,也可能只包含节点。先向配置提供方确认订阅支持 Clash 或 mihomo,再导入客户端。导入成功只说明配置能够读取,还要检查服务是否有效、策略组是否已选出口,以及系统流量是否交给客户端。本站提供客户端入口与配置说明,不分配订阅或节点。

手机端与桌面端应该怎样选择客户端?

先按操作系统选择,再看配置兼容性。可优先从 Clash Plus 开始了解;Android 还要确认安装包架构与系统要求,iOS 通过 App Store 安装。桌面端可结合规则编辑、服务模式和 TUN 设置需求选择客户端。图形界面相似不代表内核功能相同,含有特定协议或规则字段的订阅,要核对客户端使用的内核与支持范围。已有配置时先备份,迁移后逐项验证,不要只凭界面名称判断能否直接沿用。

规则、全局和直连模式有什么区别?

规则模式按配置中的规则逐项选择出口,适合日常使用;全局模式通常把已进入内核的连接交给全局策略组;直连模式则让这些连接直接访问目标。全局不等于自动接管手机或电脑上的全部流量,是否接管仍取决于系统代理、TUN 或移动端 VPN 通道。排查时可以短暂切到全局,并选定一个可用节点,判断问题是否来自规则;验证后切回规则模式,避免把临时测试设置长期保留。

Android 的 VpnService 授权是不是远程 VPN 账号?

不是。VpnService 是 Android 提供的系统接口,客户端用它建立本地虚拟网络通道,再按配置处理进入通道的流量。首次启动时出现系统 VPN 授权提示,属于流量接管所需的权限,不表示系统已经提供远程线路。授权后仍需有效配置和可用出口。同一用户或工作资料下,普通 VPN 通道通常不能同时由两个应用占用;若刚启动就被断开,先检查其他 VPN、加速器或使用本地 VPN 的过滤工具。

排查问题时,哪些信息不能直接公开?

订阅链接、节点密码、访问令牌和控制接口密钥都应隐藏。订阅地址即使看起来只是普通网址,也可能通过路径或参数携带访问凭据。分享日志前,还要检查其中的完整请求地址、账号信息和内网地址;截图应遮住配置详情与二维码。求助时通常只需提供系统版本、客户端名称、内核信息、出错时间和经过处理的错误片段。若链接已经公开,应到配置提供方重置凭据,仅删除帖子不能撤销已被复制的链接。

查看客户端选型指南 →

安装配置

按导入配置、选定出口、完成权限、启动连接的顺序检查。不同客户端的菜单名称可能略有区别。

Clash 订阅链接导入后,怎样确认配置已经启用?

打开客户端的配置或订阅页面,选择从 URL 导入,粘贴完整链接并保存。等待下载和解析完成后,点选这份配置,将它设为当前使用项;仅出现在列表里不代表已启用。接着打开代理或策略组页面,确认能够看到节点,并为手动选择组指定出口。最后启动连接,按系统提示完成授权,再访问测试页面。若导入的是只有节点的订阅,还需按客户端支持的方式补齐策略组与规则,不能把节点列表当成完整配置。

订阅更新提示失效、401 或 403,应该怎么处理?

先检查链接是否完整,有没有多余空格、换行,或复制到网页分享地址。401 通常与认证有关,403 可能涉及权限或访问限制,但最终原因要以提供方说明为准。登录服务后台确认有效期、流量状态和订阅地址是否已重置,再复制新链接到原配置项更新。若返回内容是登录页、验证页或错误网页,客户端无法按 YAML 配置解析。不要反复提交给陌生的在线转换服务;确需转换时,先了解链接会被交给谁处理。

TUN 模式打不开,是否一定需要 root 或管理员权限?

要按平台区分。Android 客户端通常通过 VpnService 接管流量,不应把桌面端的管理员步骤直接套用,也不一定需要 root。Windows 的 TUN 往往依赖客户端服务或提升权限,macOS 可能需要安装并授权辅助组件。先关闭连接,按客户端说明安装服务,再重新开启并查看启动日志。若仍失败,检查虚拟网卡、其他 VPN 和安全软件的冲突。不要为了消除报错就关闭全部系统防护,应先找到权限、驱动或路由相关的具体错误。

iOS 弹出添加 VPN 配置提示,应该检查什么?

使用网络扩展的客户端首次连接时,iOS 会要求允许添加 VPN 配置,并可能要求通过设备验证。确认提示由刚安装的客户端触发,再按系统流程授权。应用创建的 VPN 配置与另行下载的设备管理描述文件不是同一回事;不要把安装未知管理描述文件当成通用连接步骤。授权后若无法连接,回到客户端检查订阅、策略组和日志。设备受单位管理时,相关权限可能由管理策略限制,应先向设备管理员确认。

打开系统代理后,为什么有些应用仍然直连?

系统代理只是向应用提供代理地址,并不保证所有程序都会遵循它。先确认客户端内核正在运行,系统代理指向本机正确的监听端口,再检查浏览器或应用是否设置了独立代理。部分程序使用自有网络栈或直接发起连接,需要应用内配置代理,或在了解路由影响后使用 TUN。退出客户端前应正常关闭系统代理;如果客户端已停止而系统仍指向它,遵循代理的应用反而会无法联网。公司设备还需留意受管理的代理设置。

按步骤完成首次连接 →

使用技巧

连接成功后,再调整节点选择、规则和应用兼容性。以实际访问结果为准,不只看测速显示。

Clash 节点延迟测试正常,为什么网页还是打不开?

延迟测试只反映节点访问指定测试地址时的结果,不等于所有网站、协议和下载都正常。先确认目标请求实际命中了哪个策略组,再看该组当前选中的节点,避免测试的是一个节点,使用的却是另一个。随后检查目标域名的解析结果、连接日志与规则命中记录。测试地址本身不可达也会造成误判,因此应同时用实际目标服务验证。不要只追求最小延迟;连接稳定性、目标可达性和服务剩余流量同样影响使用。

url-test、fallback 和手动策略组该怎么选?

想固定使用某个出口时,选 select 手动策略组;希望按测试结果选择延迟较低的出口时,可使用 url-test;希望优先使用列表前面的可用出口、故障后再切换时,可使用 fallback。它们依赖测试地址和检测间隔,切换并非实时完成。先确认订阅已经定义对应策略组,再在客户端选择,不要只改组名就期待行为改变。修改配置前保留副本,更新订阅后检查本地改动是否被覆盖;保持会话稳定的服务尤其要谨慎使用自动切换。

Clash 自定义规则应该放在哪里,怎样避免更新后丢失?

规则通常从上往下匹配,具体的域名规则应放在宽泛规则和末尾兜底规则之前。先确认规则引用的策略名称真实存在,再使用客户端提供的覆写、合并或持久化规则功能保存修改;直接编辑订阅下载后的文件,可能在下次更新时被替换。规则加好后重新载入配置,查看日志中的命中结果。访问应用时往往会连接多个域名,仅补一条首页域名不一定够用,应根据实际连接逐步调整,不要一次添加大量无法解释的条目。

允许局域网连接打开后,其他设备怎样使用代理?

两台设备先连接到可互通的局域网,再在提供代理的客户端开启允许局域网连接,核对监听地址与代理端口。其他设备的代理服务器应填写这台主机的局域网 IP,而不是它们自己的回环地址。连不上时,检查主机防火墙、访客网络隔离和无线接入点隔离。只在可信网络中开启,并按客户端能力设置访问控制或认证;不要把监听端口直接暴露到公网。手机热点和部分校园网络可能限制设备互访,需要单独验证。

Windows 商店应用遇到 UWP 回环限制怎么办?

当部分 UWP 或 AppContainer 应用通过系统代理访问本机代理端口时,可能受到回环隔离限制,但不是所有商店应用都属于这种情况。先确认普通浏览器能通过同一代理联网,再定位具体受影响的应用。若客户端提供回环豁免工具,以所需权限运行,只为目标应用添加豁免,然后彻底退出并重开该应用。也可评估 TUN 接管方式,但仍需实际验证。不要把所有应用批量加入豁免,也不要把远端节点故障误当作本机回环问题。

查阅规则与网络栈术语 →

故障排查

先记录出错时间与第一条相关日志。保留当前配置,逐项排除基础网络、权限、解析和接管问题。

全部节点都显示超时,应该按什么顺序检查?

先关闭代理确认基础网络能正常联网,完成无线网络的登录认证,并检查设备时间是否准确。再确认订阅仍有效、节点列表不是旧缓存,同时检查是否有其他 VPN 占用通道。重新启动客户端内核,选一个节点访问实际目标,并查看第一条相关错误。若只是测速超时,换用可信且可达的测试地址复查;若日志显示服务器连接失败,再切换移动数据或其他网络比较。不要一开始就重装或删除配置,否则会丢失有助于定位问题的状态。

Android 锁屏后掉线,省电白名单应该怎样设置?

先在系统应用设置中找到客户端,把电池使用调整为允许后台运行或不受限制,并按手机厂商的设置开启必要的自启动权限。部分系统还需要在最近任务中锁定应用,但这不能替代电池设置。随后锁屏几分钟,再解锁查看 VPN 图标、通知和日志是否仍在。始终开启 VPN 可按需要启用;阻止未使用 VPN 的连接会在客户端断开时阻断网络,应理解后再开启。若进程仍被清理,继续检查系统省电模式和厂商的后台管理规则。

日志出现 DNS 解析失败或 fake-ip 相关错误怎么办?

DNS 用于把域名解析为地址。先确认订阅原有的 DNS 设置,检查上游解析服务能否通过当前网络访问,以及是否存在需要先解析自身域名的循环依赖。fake-ip 是用虚拟地址配合内核映射处理域名的方式,不能仅凭地址看起来陌生就判断异常。若某个局域网服务或应用不兼容,可根据内核说明调整排除项,并在修改后按客户端功能清理相关缓存。还要检查系统私人 DNS、浏览器安全 DNS 与客户端设置是否形成了不同的解析路径。

Wi-Fi 能用、移动数据不能用,是否与 IPv6 有关?

有可能,但不能直接下结论。两种网络可能在 IPv6、DNS、UDP 支持和路由限制上不同。先保持同一节点、同一目标和同一模式,只切换接入网络进行比较,再检查日志中的解析地址与连接错误。若怀疑 IPv6,可按客户端支持的设置临时关闭相关选项并重连验证;同时留意 DNS 中的 IPv6 设置与系统流量接管范围。验证后再决定是否保留修改,不要把关闭 IPv6 当成所有故障的固定答案,也不要同时修改多个参数。

迁移客户端或重置配置前,要备份哪些内容?

先记录订阅来源、当前启用配置、手动规则、覆写内容、策略组选择和 DNS 设置,必要时导出客户端支持的备份文件。备份可能含有凭据,应存放在受保护的位置。迁移时先关闭旧客户端的连接与系统代理,再导入新客户端,避免两个程序争用端口或 VPN 通道。不要把旧客户端全部私有字段直接复制过去,应先确认新内核是否支持。连接恢复后,依次验证网页、常用应用、局域网访问和锁屏后的状态,再清理旧配置。