Clash 常见问题

按配置加载、流量接管、规则匹配的顺序检查。先保留可用配置,每次只修改一个变量,再用连接记录验证结果。

提交问题前先记录

记录操作系统、客户端与内核名称、接管方式、报错时间及最早一条错误日志。分享日志前移除订阅地址、账户凭据与代理认证信息。首次配置可先看上手教程,字段与平台细节见完整文档。

CLIENT / CORE / ROUTING

基础认知

先区分客户端、内核和服务,再判断模式与接管范围。

Clash 客户端、mihomo 内核与订阅有什么关系?

客户端提供订阅管理、模式选择和系统代理等界面;mihomo 内核读取配置,负责建立代理连接、执行规则与处理 DNS;订阅则是服务提供方交付配置或代理信息的入口。三者不是同一项服务。安装客户端不会自动获得可用代理,换客户端也不会修复服务方已经停用的订阅。排查时先确认当前配置是否加载,再确认内核是否启动,最后检查订阅对应的服务状态,避免把账户问题当成安装问题。

规则、全局、直连三种模式分别做什么?

规则模式按 rules 自上而下匹配连接,命中后采用对应策略;全局模式把进入内核的连接交给全局策略组,仍需在该组中选择可用出口;直连模式让进入内核的连接直接访问目标。模式只决定已接管流量的去向,不能让未使用代理的应用自动进入内核。日常使用先选规则模式;临时切全局可辅助判断分流问题,但测试后应恢复。直连也不等于关闭 TUN,虚拟接口仍可能参与路由与 DNS 处理。

系统代理与 TUN 应该先开哪一个?

首次配置建议先启用系统代理,用遵守系统代理设置的浏览器验证订阅、出口和规则是否可用。系统代理主要影响愿意读取该设置的应用,不代表接管所有进程。需要处理游戏、部分命令行工具或不遵守代理设置的应用时,再启用 TUN,并检查服务权限、虚拟接口和 DNS。排查阶段一次只更改一个开关;若两种方式都开着,应分别关闭其中一种做对照,避免接管路径重叠后难以判断故障来自哪一层。

延迟测试成功,为什么网页仍然打不开?

延迟测试通常只说明某个出口能访问配置指定的测试地址,不保证目标网站、所有协议或所有应用都可用。先查看连接记录,确认浏览器请求进入内核,再核对命中的规则、策略组与实际出口。如果没有记录,优先检查流量接管;如果已有记录却连接失败,再查目标域名解析、出口限制与服务状态。还要区分测试的是单个代理还是自动策略组,组内最终选择可能与刚才手动测试的代理不同。

查阅内核、规则与接管术语 →

PROFILES / YAML / PERMISSIONS

安装配置

从订阅响应和配置解析开始,再检查 TUN 所需的系统权限。

Clash 订阅链接应该从哪里导入?

在客户端的配置、订阅或 Profiles 页面找到从 URL 导入的入口,粘贴服务方提供的完整订阅地址,保存并执行更新,再把该配置设为当前配置。不要把订阅地址填进 external-controller,也不要把网页控制台地址当成订阅。导入后检查是否出现可用策略组,并查看日志是否提示解析失败。订阅链接通常带有账户凭据,不要发到公开群聊、截图或在线转换网站;若已泄露,应先到服务方后台重置链接。

订阅提示失效或更新失败,应该按什么顺序检查?

先到服务方后台确认账户有效、额度可用且订阅地址没有重置,再从后台重新复制链接,排除缺字符、尾部空格和过期入口。查看更新日志:401 或 403 通常要检查授权与访问限制,404 要检查地址,超时则先检查网络路径。若当前网络无法直连订阅域名,可在客户端支持时启用通过代理更新,并确保已有可用配置。返回 HTML 或登录页时不要反复导入,应向服务方确认正确的 Clash 或 mihomo 配置入口。

导入 YAML 后报错,如何定位配置问题?

先保留原文件,按日志给出的行号及其上一行检查缩进、冒号和列表结构。YAML 缩进使用空格,不混用制表符;策略组引用的代理名称需要实际存在,规则引用的策略名称也要一致。若内核支持,可在配置所在目录执行 mihomo -t -f config.yaml 检查配置,并以当前内核返回的错误为准。语法通过只表示配置可以解析,不表示出口一定可连。若报未知字段或协议不支持,再核对内核类型和订阅格式,不要直接删除整段配置。

TUN 提示权限不足或虚拟接口创建失败怎么办?

桌面端先确认客户端要求的服务模式已安装并运行,必要时按客户端说明授权管理员或系统网络扩展权限。Android 需要同意系统 VPN 连接请求,并先停止其他占用 VPN 通道的应用。Linux 应结合启动方式检查 /dev/net/tun、服务账户及所需网络权限,不要直接把所有文件设为可写。查看日志中最早出现的权限或接口错误;若接口创建成功但流量不通,应转查路由与 DNS,而不是持续重复提权或重装客户端。

按步骤完成导入与首次连接 →

TERMINAL / REFRESH / RULES

使用技巧

明确设置的作用范围,保留修改前的配置与恢复路径。

如何让命令行工具使用本地代理?

先确认实际 mixed-port 与监听地址,再在支持代理参数的工具中显式指定代理。例如端口为 7890 时,可用 curl -I --proxy http://127.0.0.1:7890 https://example.com 检查请求,并与不带代理参数的结果对照。需要为终端设置 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY 时,应按当前 shell 的语法操作,并确认具体工具读取哪些变量。环境变量通常只影响当前进程及其子进程;测试结束后撤销临时设置,避免停用客户端后终端仍指向本地端口。

订阅自动更新间隔怎么设置才合适?

优先采用服务方建议的更新频率,在客户端当前订阅的编辑页查找自动更新或更新间隔,先核对单位是分钟还是小时。不要用很短的间隔持续重试失效链接,这可能触发服务端限流。需要区分整份配置更新与 proxy-providers 的 interval:前者由客户端管理,后者由内核按提供器设置获取内容。更新后确认当前生效配置和策略组仍正确;客户端完全退出或被移动系统限制后台运行时,计划更新也可能不会按时执行。

修改分流规则后没有效果,应该检查哪里?

先确认当前模式是规则,再确认编辑的是正在使用的配置,而不是未激活的副本。rules 按顺序匹配,更具体的规则通常应放在通用规则之前,MATCH 应位于末尾;规则指向的策略组必须存在。保存后执行客户端要求的重载,并新建连接观察命中结果,已有长连接可能继续沿用原来的路径。若订阅更新会覆盖本地修改,应使用客户端提供的覆写或合并功能保存规则,同时检查最终生成的配置,避免重复规则或缩进错误。

订阅转换前需要确认哪些事项?

先向服务方确认是否已有适配当前内核的配置入口,能直接导入时不必额外转换。只有代理信息列表的订阅与包含规则、DNS、策略组的完整配置并不等价,转换后要检查最终文件是否包含所需结构。转换服务能够接触原始订阅地址及其中的凭据,应优先使用可信服务或自行部署的工具,不把链接提交给来源不明的网站。转换也不能让旧内核自动支持新协议;若日志提示协议不兼容,应更换匹配的内核或让服务方调整输出格式。

继续查阅配置文件说明 →

TIMEOUT / PROXY / LOOPBACK

故障排查

先恢复基础网络,再逐层验证,不用连续切换多个设置代替定位。

所有节点都超时,如何区分本地故障与服务故障?

先关闭代理接管,确认本地网络本身能够访问常规网站,再检查系统时间、账户状态和订阅更新结果。选择一个明确的代理手动测试,并查看失败发生在域名解析、TCP 连接还是握手阶段。全部超时也可能是测试地址不可达,不能仅凭测试列表判定全部出口失效。可在另一条可信网络上做一次对照;若只有当前网络失败,重点查网络限制与 DNS。若多条网络都在同一阶段失败,再把脱敏日志和发生时间提交给服务方。

系统代理已开启,但浏览器或应用仍然直连怎么办?

在系统网络设置中确认代理地址与客户端实际监听一致,常见本机地址是 127.0.0.1,端口以当前配置为准,不能默认永远是 7890。随后检查浏览器扩展、应用自带代理设置和绕过列表,它们可能覆盖或跳过系统设置。若连接记录中没有该应用请求,可用显式代理参数做对照;参数代理可用而系统代理无效,通常应继续检查应用如何读取代理。部分程序启动时才读取设置,修改后需要重启;不遵守系统代理的应用再评估 TUN。

Windows UWP 应用无法使用本地代理,如何处理回环限制?

先确认普通桌面浏览器可以通过同一代理访问网络,再判断受影响的是否为受回环隔离约束的应用。可使用客户端提供的 UWP 回环工具,为确有需要的应用添加豁免;也可在管理员终端执行 CheckNetIsolation LoopbackExempt -s 查看现有列表,再按目标应用的包系列名称定向配置,不要给全部应用批量放行。操作后重启目标应用并查看连接记录。回环豁免仅解决访问本机代理的限制,不会替代订阅、规则或 DNS 配置。

开启 TUN 后断网,关闭后仍无法访问网络怎么办?

先在客户端关闭 TUN 和系统代理,再正常退出,检查系统代理是否仍指向已停止监听的本地端口。若恢复直连,重新启动时只启用一种接管方式,观察最早的路由或 DNS 错误。若仍断网,检查活动网卡的 DNS 是否被手动改为已不可达的地址,并排查其他 VPN、虚拟网卡或安全软件的路由冲突。先记录原值再恢复网络设置,不要直接删除全部网卡。必要时重启系统清理残留状态;网络恢复后再逐项启用功能,保留可复现的最小配置。

查看 UWP 回环豁免操作笔记 →
Clash最新版下载