FAQ / 常见问题
Clash 常见问题
订阅导入、模式选择与连接排查。按问题发生的环节查阅,先确认当前配置,再检查代理接管与实际出口。
- 4 类问题
- 16 项解答
- 配置与网络排查
基础认知
客户端、内核与代理模式
先区分配置来源、连接接管与规则处理的职责。
Clash、客户端与 mihomo 内核是什么关系?
Clash 指向规则代理工具及其配置生态;客户端通常负责订阅导入、策略选择、系统代理和日志界面,内核负责处理连接、DNS 与规则匹配。mihomo 是这一生态中持续发展的内核,不同客户端使用的内核和支持字段可能不同。排查问题时,先在关于或内核信息中记录两者的名称与版本,再查对应说明;界面上存在某个开关,并不代表当前加载的内核支持所有相关配置。
下载安装 Clash 后,还需要准备什么?
安装完成只代表客户端可以运行,还需要有效的代理配置。配置可以来自服务提供方的 Clash 订阅,也可以是自行维护的 YAML 文件,其中应包含可用节点、策略组及规则。网站提供的教程和配置片段用于说明字段关系,不能代替真实服务。导入前确认订阅格式与内核兼容,导入后检查节点是否出现,再选择策略并启用系统代理。订阅地址常带访问凭据,应按账户密码的方式妥善保存。
规则、全局和直连模式应该怎样选择?
规则模式按 rules 的先后顺序匹配连接,命中后使用指定策略,适合日常按站点分流。全局模式将进入内核的连接交给全局策略,适合临时判断问题是否来自规则;它不等于所有应用都已被接管。直连模式让进入内核的连接直接访问目标,仍可能经过内核的 DNS 处理。切换模式后应新建连接再验证,已有的长连接可能继续使用原来的出口,不能只观察旧标签页判断切换结果。
Clash for Windows 停更后,旧配置还能使用吗?
旧配置中的通用字段通常可作为迁移基础,但需要由新客户端所用的内核实际检查。迁移前导出配置并记录策略组选择、系统代理端口、TUN 与 DNS 设置;导入后先确认语法通过,再测试连接。旧客户端的界面设置、脚本和覆写机制不一定能直接迁移。建议从下载页选择持续维护的客户端,并按报错逐项调整字段。确认新客户端工作正常后,再停用旧客户端的自启动与代理服务,避免同时接管网络。
相关资料:Clash 术语表 →
安装配置
订阅、YAML 与 TUN 权限
从配置获取、加载检查到系统授权,逐项确认。
订阅链接怎样导入,导入后为什么看不到节点?
在客户端的配置或订阅页面选择从 URL 导入,粘贴完整地址,下载成功后将该配置设为当前使用项。只有添加记录而未激活配置时,节点页可能仍显示旧内容。若列表为空,检查返回内容是否为 Clash YAML,而不是登录网页、错误提示或面向其他工具的编码列表。随后确认配置中存在 proxies,或 proxy-providers 已成功获取节点。不要把订阅地址贴到公开转换网站,优先使用服务提供方说明的兼容链接。
订阅更新失败或提示链接失效,应该检查哪些项目?
先查看更新日志中的 HTTP 状态与错误类型。401 或 403 可能与凭据、权限或服务方限制有关,404 可能是地址变化,超时则需要继续检查网络与域名解析。返回服务提供方后台重新复制链接,核对账户状态及订阅是否被重置。若更新必须经过代理,而当前代理节点已经不可用,可按客户端支持的方式切换直连下载或临时使用可用配置。更新前保留本地副本;删除配置并不能修复远端链接,反而可能失去原本可用的节点。
YAML 导入报错时,怎样定位配置问题?
先读取日志中给出的行号与字段名,并检查该行前后几行;解析器标出的行有时只是发现问题的位置。YAML 使用空格缩进,同一层级保持一致,不能用 Tab 代替。重点检查冒号后空格、列表短横线、引号是否闭合,以及策略名与节点名是否完全一致。带特殊字符的名称可使用成对引号。每次只修改一个问题并重新检查配置,出错时回退最近的改动。订阅生成的文件优先通过覆写调整,避免下次更新覆盖修复内容。
TUN 模式提示权限不足或无法创建网卡怎么办?
先确认客户端所用内核支持 TUN,再按照该客户端说明安装服务或完成系统授权。Windows 常需要管理员权限或服务模式,macOS 可能需要批准辅助组件或相关网络权限,Linux 则需要合适的网络管理能力与可用的 TUN 设备。完成授权后重新启动内核,查看是否仍报路由或设备创建错误。同时停用其他 VPN 的网络接管功能,避免路由冲突。不要反复叠加提权命令;应根据日志区分权限不足、设备缺失与地址冲突,再处理对应原因。
相关资料:订阅导入与首次连接指南 →
使用技巧
策略组、规则与配置管理
明确修改的作用范围,保留能回退的配置副本。
策略组里的 select、url-test 和 fallback 有什么区别?
select 由用户手动选择节点或其他策略,适合需要固定出口的场景。url-test 根据配置的探测地址与周期比较候选项,按内核支持的容差等设置选择出口;探测结果只反映该目标的连通表现。fallback 侧重按候选顺序选择可用项,用于主要出口失效后的切换。三者都需要规则引用才能影响对应连接。修改策略后,用新连接检查命中的组与最终节点,不要将某次探测结果直接等同于所有网站的实际访问速度。
Clash 自定义规则怎样添加,才不会被订阅更新覆盖?
优先使用客户端提供的本地覆写、规则追加或合并功能,并确认该功能的执行顺序。规则通常从上到下匹配,针对域名的精确规则应放在宽泛规则与末尾 MATCH 之前;引用的策略名必须存在且大小写一致。例如将某个域名交给指定策略时,需要同时确认策略组中有可用出口。保存后重新加载配置,在连接记录中检查实际命中的规则。直接编辑订阅缓存文件容易被更新替换,应将自定义部分单独保存,并在更新后验证一次合并结果。
多个 Profile 怎样切换和备份,才不容易混淆?
为每份配置使用能区分来源与用途的名称,并记录它属于本地文件还是远程订阅。切换 Profile 后,确认当前激活标记、策略组与 DNS 设置都已变化;系统代理和 TUN 开关可能属于客户端全局设置,不一定随配置一起切换。备份时同时保存原始配置、本地覆写和必要的客户端设置,不能只备份节点列表。远程订阅更新通常替换其内容,本地文件则由用户维护。更换设备时先导入一份配置验证,再逐项恢复附加设置,便于发现不兼容项。
允许局域网连接后,其他设备怎样使用代理?
先确认主机与其他设备处于可互通的局域网,客户端已允许局域网访问,并监听合适的接口地址。随后在另一台设备的网络代理设置中填写主机的局域网 IP 与客户端实际的 HTTP 或混合端口;不要填写 127.0.0.1,它指向设备自身。若仍无法连接,检查主机防火墙、访客网络隔离及端口占用。只在可信网络中开放,按需要设置代理认证与防火墙范围。外部控制器用于管理接口,不是供其他设备上网的代理端口,也不应直接暴露到公网。
相关资料:策略组与本地覆写进阶配置 →
故障排查
连接、系统代理与 DNS
结合日志和连接记录判断故障位置,避免同时修改多个网络设置。
节点测试超时,怎样判断是节点问题还是本地网络问题?
先确认普通直连网站可访问,再检查配置是否成功加载、订阅账户是否有效。对比多个节点:只有单个节点失败时,优先检查该节点服务状态;全部失败时,再检查本机时间、DNS、网络限制及客户端日志。探测地址本身不可达也会导致超时,因此应结合真实目标的新连接验证,不能只看测试按钮。可临时更换网络进行对照,每次只改变一个条件。若日志提示认证失败或协议不支持,应处理凭据与兼容性,而不是持续提高测试超时值。
系统代理已开启,但浏览器或其他应用仍未经过 Clash,怎么办?
系统代理主要影响遵循系统代理设置的应用,并不自动接管所有连接。先检查系统中的代理地址和端口是否与客户端实际监听值一致,再停用浏览器中的独立代理扩展,使用新连接观察客户端连接记录。命令行工具、游戏和部分应用可能需要单独配置代理,或在明确路由需求后使用 TUN。若连接记录中已有请求,却命中 DIRECT,应检查规则与策略选择,而不是继续修改系统代理。退出其他代理工具,避免它们反复覆盖系统设置。
Windows 的 UWP 应用无法连接,是否需要设置回环豁免?
部分受应用容器限制的 Windows 应用无法访问本机回环代理,而普通桌面浏览器仍可正常使用,这时可以检查回环限制。确认客户端监听的是本地地址,并根据客户端提供的 UWP 回环工具或 Windows 的 CheckNetIsolation 工具,为确有需要的应用包设置豁免;操作可能要求管理员权限。不同应用的打包方式与网络行为不同,并非所有商店应用都属于这一情况。完成后重启目标应用并观察连接记录。若使用 TUN,则还需检查路由与 DNS,回环豁免不能代替这些排查。
开启 Fake-IP 后网站打不开,或退出客户端后仍无法联网怎么办?
Fake-IP 会让域名先返回映射地址,再由内核关联真实目标;DNS 与连接路径不一致时可能出现访问失败。先检查是否有其他工具接管 DNS、浏览器加密 DNS 是否绕过预期路径,以及相关域名是否需要加入 fake-ip-filter。若退出客户端后断网,先关闭残留系统代理,再检查系统 DNS 是否仍指向已停止的本地服务,恢复原来的自动或指定设置,并清理 DNS 缓存后重试。保留修改前的网络参数,逐项恢复;分享排查日志前,应遮盖订阅链接、凭据和敏感域名。