故障分诊台 / FAQ

Clash 常见问题
配置与连接排查

先分清是配置没载入、流量没接入,还是出口不可达。按症状查工单,一次只改一个设置,日志比反复重装更有用。

20 条检修问答 订阅 / 规则 / DNS 系统代理 / TUN

分诊范围 / 概念与兼容

基础认知

客户端是操作台,内核负责处理连接,订阅提供配置。先把这三段线分清,再决定该检查哪一段。

Clash 客户端、mihomo 内核和订阅分别负责什么?

客户端提供导入配置、切换代理组和查看日志的界面;内核负责读取配置、处理连接并执行分流,mihomo 是 Clash 生态中持续发展的内核之一;订阅则是提供配置或节点信息的地址。安装客户端不等于已经获得可用连接,还需要有效配置及相应服务。排查时先确认配置已启用、内核已启动,再检查代理组选择,避免把订阅问题误判成安装问题。

规则、全局与直连模式应该怎样选?

日常使用通常先选规则模式,让连接按配置中的规则决定出口。全局模式将受内核处理的连接交给全局策略选择,适合短时间判断规则是否导致异常;直连模式则让这些连接直接访问目标。全局并不代表系统全部应用都被接管,接入范围仍取决于系统代理或 TUN。测试后切回规则模式,并检查实际连接记录,不要只看模式按钮是否亮起。

Clash 配置文件和 Base64 节点订阅可以直接互换吗?

不能仅凭链接外观判断兼容性。Clash YAML 通常包含代理、代理组和规则等结构,Base64 内容可能只是其他客户端使用的节点列表,缺少完整分流配置。优先向订阅提供方选择明确标注 Clash 或 mihomo 的格式;如果客户端支持格式转换,再按其说明操作。订阅地址可能带访问凭据,不要提交给不熟悉的在线转换站,也不要公开完整链接。

旧版 Clash 配置能否直接交给 mihomo 使用?

许多基础字段可以沿用,但不能据此认定所有配置双向兼容。mihomo 支持的部分协议、DNS 选项及扩展规则在旧内核中可能无法识别,第三方客户端也可能对配置进行合并或覆写。迁移前备份现有文件,先通过客户端的配置检查,再查看启动日志中的字段或协议错误。出现未知类型时应核对内核支持范围,不要直接删除报错字段后继续使用。

本站和客户端项目、订阅服务是什么关系?

Clash教程网整理客户端入口与中文配置资料,不等同于各客户端项目,也不提供订阅账号或节点服务。客户端下载、内核功能与订阅服务属于不同环节:安装问题看平台与权限,配置问题看格式与日志,账号到期或额度问题则需要联系实际服务提供方。查询客户端来源时应核对项目名称和发布渠道,不能只凭页面标题中的 Clash 官网等搜索词判断归属。

分诊范围 / 导入与权限

安装配置

从配置启用到系统授权,先跑通最小链路。不同客户端的菜单名称可能不同,检查目标保持一致。

第一次安装后,怎样确认订阅已经真正启用?

在客户端的配置或订阅页面添加地址,完成下载后,明确选中该配置并设为当前配置;列表里出现一条记录不一定代表已启用。随后检查内核运行状态,打开代理组确认存在可选策略,再开启系统代理进行浏览器访问测试。如果界面只有默认直连策略,先看订阅下载结果与配置解析日志。首次设置建议先完成系统代理验证,再按需要启用 TUN,便于定位故障发生在哪一步。

导入时报 YAML 解析错误或出现 HTML 内容怎么办?

先判断下载到的是配置还是网页。日志若出现 HTML 标签,常见原因是地址指向登录页、错误页或需要验证的分享页,应重新复制服务方提供的订阅地址。若返回的是 YAML,再检查缩进、冒号后的空格以及是否混入制表符;报错行附近的上一行也值得检查。优先重新获取原始配置,手动编辑前保存副本,修复后使用客户端的配置检查功能再重新加载。

mixed-port 被占用,应该改端口还是重装客户端?

先退出其他代理客户端和残留内核,确认是否有进程占用相同监听端口,通常不需要重装。可以停止冲突进程,或把 mixed-port 改为未使用的端口,然后重新加载配置。端口变更后,手动设置过代理的浏览器、终端和其他应用也要同步修改;客户端自动维护的系统代理则应重新关闭再开启。不要只改配置文件而保留应用里的旧端口,否则内核正常启动也可能无法访问。

TUN 提示权限不足或虚拟网卡创建失败怎么处理?

先关闭 TUN,确认普通系统代理能够工作,再按照客户端说明安装或修复服务组件。Windows 通常需要管理员授权,macOS 可能需要批准辅助程序,Linux 则取决于运行方式及网络管理权限。完成授权后重启相关服务,再打开 TUN 并查看路由与网卡日志。同时退出其他 VPN 或同类接管工具,避免路由冲突;不要为了消除提示而长期关闭系统安全机制。

Android 和 iOS 安装后还需要哪些系统授权?

移动端首次建立隧道时通常会请求 VPN 配置授权,需要在系统确认框中允许。Android 如果出现锁屏后断开,可检查电池优化、后台运行和自启动限制;先观察是否确有后台被终止,再调整对应应用设置。iOS 应检查 VPN 配置是否启用,以及是否有其他 VPN 正在切换连接。系统的 VPN 标志只说明隧道状态,不代表订阅有效或所有目标都能访问,仍需结合客户端日志验证。

分诊范围 / 测试与分流

使用技巧

测速、选组和规则命中回答的是不同问题。用实际连接验证效果,别让一个测试结果替整条链路下结论。

节点测速显示超时,是否就代表节点完全不可用?

不一定。客户端测速通常访问指定测试地址,超时可能来自测试站不可达、DNS 异常、握手失败或节点本身不可用。先选择该节点实际访问需要的服务,再查看连接日志;必要时换一个明确可达的测试地址,并保持各节点使用相同条件。测速数值也不等于下载速度或所有网站的体验。若多个节点同时失败,应优先检查本机网络、系统时间和订阅状态,而不是反复点击测速。

手动选择、自动选择和故障转移代理组有什么区别?

select 由用户手动指定出口,适合需要稳定保持同一节点的场景;url-test 根据测试结果自动选择候选项,测试地址与间隔会影响判断;fallback 则按候选顺序选择可用项,更重视预设优先级。它们都只能在配置列出的候选范围内工作,不会自动补充新节点。更换策略通常影响新建连接,已有长连接可能继续使用原出口,验证时可重新建立测试连接。

怎样添加自定义规则,避免订阅更新后被覆盖?

优先使用客户端提供的覆写、扩展规则或合并配置功能,不要直接修改会被订阅更新替换的远程文件。规则按从上到下的顺序匹配,具体域名规则应放在宽泛规则和 MATCH 之前,目标代理组名称必须与实际配置完全一致。添加后重新加载,并在连接详情中核对命中的规则及出口。不同客户端的合并顺序可能不同,保存成功只是第一步,还要确认规则已进入最终生效配置。

Fake-IP 返回 198.18 开头的地址,需要立刻关闭吗?

在 Fake-IP 模式下,看到保留网段中的映射地址通常是预期行为,内核通过映射关系关联域名与连接,不代表真实服务器位于该地址。若局域网设备、特定游戏或依赖真实解析结果的应用异常,可把必要域名加入 fake-ip-filter,再按客户端能力清理相关 DNS 缓存并重试。不要仅因地址看起来陌生就切换全部 DNS 设置,应先确认异常应用及其请求是否经过内核。

怎样分享日志,既方便排查又保护订阅信息?

复现问题时记录客户端名称、内核信息、系统类型、使用模式以及发生时间,并截取故障前后相关日志。分享前遮盖完整订阅地址、访问凭据、节点密码、账号标识及不希望公开的域名或地址;截图里的二维码也可能包含订阅。优先提供解析错误、连接失败原因和命中规则等必要片段,避免整份上传配置目录。若完整订阅已公开,应联系服务方更换地址或撤销旧凭据。

分诊范围 / 异常与恢复

故障排查

先找出故障边界:全部应用还是个别应用,直连还是代理,TCP 还是 UDP。缩小范围后再动设置。

订阅昨天还能更新,今天提示失效或下载失败怎么办?

先区分服务端拒绝与本地连接失败。401、403 可能与凭据、权限或服务方策略有关,404 常见于地址变更;连接超时则还要检查当前网络、DNS 和更新请求使用的出口。登录服务方页面核对有效期、额度与最新地址,复制时避免漏掉查询参数或带入空格。若更新必须依赖当前已失效节点,可尝试切换直连或其他可用网络后更新,不要连续高频重试触发额外限制。

系统代理已开启,但浏览器或部分应用仍不生效怎么办?

先查看内核是否监听预期的本地地址与端口,再核对系统代理设置是否被其他程序改写。浏览器扩展、应用内代理和终端环境变量可能覆盖系统设置,部分应用也根本不读取系统代理。使用浏览器产生一个新请求,观察客户端连接列表是否出现对应记录;没有记录就先查流量接入,有记录再查规则和节点。确需接管不遵循系统代理的应用时,再考虑配置 TUN。

Windows 的 UWP 应用无法通过本地代理,如何检查回环限制?

部分 UWP 应用受网络隔离限制,可能无法访问本机回环代理。先确认普通桌面浏览器能通过相同代理访问,再检查客户端是否提供 UWP 回环豁免工具;如果提供,只为确有需要的目标应用添加豁免。也可以使用 Windows 的 CheckNetIsolation 工具查看和管理规则,操作前确认应用包标识。不要把所有商店应用一并豁免,也不要把任何商店连接故障都归因于回环限制。

网页能打开,但游戏、视频或语音应用连接异常怎么办?

先检查目标应用是否进入客户端连接列表,再确认它使用的 TCP 或 UDP 流量是否被接管,以及所选节点是否支持所需传输。浏览器正常只能证明一部分链路可用,不能证明游戏与语音的 UDP 路径正常。若启用 TUN 后才异常,可临时关闭作对照,并检查路由、DNS 和其他 VPN 冲突。每次只改一个设置并记录结果,必要时在获授权的其他网络上复测。

退出客户端后整机无法上网,怎样恢复连接?

先打开系统网络设置,检查是否残留指向本地地址的手动代理;内核退出后,这个监听端口可能已不可用。关闭残留代理,再确认 TUN 或 VPN 连接已正常断开,必要时重启客户端并按先关闭接管、再退出的顺序操作。若仍失败,检查 DNS 是否保留了仅在客户端运行时可用的地址,并按原网络设置恢复。不要一开始就重置全部网络,先保留日志和原有配置便于定位。

需要核对术语含义?查阅概念速查。需要确认客户端支持范围?查看选型指南与客户端页面。