Clash / mihomo
Clash 常见问题
先区分配置加载、流量接管和规则匹配。按症状选择章节,再用更新日志或连接列表确认故障发生在哪一环。
基础认知
区分客户端、内核、配置和流量入口。界面上的模式选择,不等于流量已经进入内核。
Clash 客户端和 mihomo 内核是什么关系?
客户端负责导入配置、切换策略和显示连接;mihomo 内核负责接收流量、匹配规则和处理 DNS。两者的版本号各自独立。遇到菜单缺失,优先查客户端文档;遇到配置字段无法识别,先看启动日志,再核对实际加载的内核版本。部分客户端会单独更新内核,排查时应分别记录两个版本。若更换客户端,先确认订阅格式和所用协议受支持,再迁移配置。
订阅链接、config.yaml 和节点有什么区别?
订阅链接是获取配置或节点列表的地址。完整的 config.yaml 还可以包含端口、DNS、规则和策略组。节点则是一条可选的出站连接,不能代替整份配置。若导入后只出现节点而没有预期规则,先确认链接返回的是完整 Clash 配置还是节点列表,再决定使用服务方提供的配置,还是把节点加入已有配置。订阅地址通常包含账户标识,不要贴到截图或公开日志里。
规则、全局和直连模式怎么选?
日常使用先选规则模式,内核按配置中的规则顺序选择出口。全局模式把进入内核的流量交给 GLOBAL 策略组,适合短时间对照测试;切换后还需要确认该组当前选中了哪个出口。直连模式让进入内核的流量不经代理出口,但并不关闭流量接管。若要比较启用和停用客户端时的行为,应关闭对应的系统代理或 TUN,再重新发起连接。
系统代理和 TUN 有什么区别,需要一起开吗?
系统代理通过操作系统的代理设置把请求交给客户端,只覆盖遵循该设置的应用。TUN 通过虚拟网卡和路由接管流量,适合不读取系统代理的应用,但依赖系统权限和路由设置。初次配置建议只开一种,并在连接列表中确认目标请求是否进入内核。若两种方式同时启用后出现故障,先关掉其中一种做对照,不要同时修改 DNS、出口和分流规则。
订阅更新提示 401、403 或 404,怎么判断是否失效?
先查看更新日志中的请求结果。401 通常表示需要认证或凭据未被接受;403 表示请求被拒绝,也可能是服务方限制了来源;404 可能是地址已更换。先在服务方的账户页面确认订阅状态和适用格式,再复制新的 Clash 或 mihomo 订阅地址。新配置验证成功前保留旧配置。若日志只有超时而没有 HTTP 状态码,应先排查网络连通性,而不是重置订阅。
配置导入成功后,为什么节点列表仍然是空的?
先确认导入的配置已被设为当前配置。再检查启动日志是否显示 YAML 解析失败、字段不受支持或策略组引用不存在。如果使用 proxy-providers,导入成功只代表主配置已读取,远程节点仍需另行拉取。到客户端的提供者页面查看更新结果,确认返回的不是登录页或错误页。节点已拉取但策略组仍为空时,再核对组的 use 引用与筛选条件。
开启 TUN 时提示权限不足,应该检查什么?
在 Windows 上,先确认客户端文档是否要求安装并启用服务模式,再检查服务是否正在运行;如果需要提权,只对明确的安装或启动步骤授权。在 Android 上,到系统 VPN 设置确认已授权该客户端,并检查是否已有其他 VPN 占用连接。开启后仍失败时,记录日志中的设备或路由错误,在客户端支持的范围内检查对应设置,不要先关闭系统安全功能。
启动时提示 mixed-port 已被占用,能直接换端口吗?
可以,但先确认端口是否被另一实例占用。常见情况是旧客户端仍在托盘运行,或者系统上同时启动了图形客户端和独立内核。若重复实例应退出,正常退出后重新启动即可。确需并存时,为两个实例分配不同的本地端口,并同步修改手动设置了代理地址的应用。最后检查系统代理指向当前实例,避免界面显示运行正常但请求仍被送到旧端口。
Clash 节点测速显示超时,就一定不能用吗?
不一定。测速记录的是通过该节点访问指定测试地址的结果,并不代表所有目标。先对照同组其他节点,再用实际需要访问的站点测试,并在连接列表中确认使用的出口。仅一个测试地址失败时,先检查该地址是否可达;单节点对多个目标持续失败时,再查该节点或查看服务方公告。不要只凭一次测速就删除配置,同一网络下重测更容易定位问题。
规则模式为什么把预期走代理的站点分到 DIRECT?
规则按顺序匹配,第一次命中后便确定目标策略。在连接列表打开该请求,记录命中的规则和最终出口:命中宽泛的直连规则,应把更具体的规则移到它前面;命中预期规则却仍然直连,则查对应策略组是否选中了 DIRECT。若日志中只有 IP 而没有域名,先确认内核能否获得域名信息,不要直接扩大匹配范围。修改后关闭旧连接,再发起一次请求。
更新订阅后,本地修改的规则为什么消失了?
客户端刷新订阅时可能用新内容替换远程配置的本地副本,直接改副本就会丢失。把自定义规则保存为独立的覆写或合并配置,再按客户端文档将它绑定到目标订阅。需要优先匹配的规则应插到规则列表前面,而不是写到 MATCH 之后。保存后查看运行配置,确认新规则存在、位置正确、引用的策略组有效,再手动刷新一次订阅验证修改会保留。
TUN 开启后无法访问打印机或 NAS,怎么恢复?
先关闭 TUN 验证局域网访问能否恢复,再记录设备的实际 IP 和网段。重新开启后,用 IP 直接访问一次:如果 IP 能访问但设备名称不行,优先检查局域网 DNS 或设备发现;如果 IP 也不通,再核对是否有重叠路由,并按客户端支持的方式排除实际使用的局域网网段。修改后分别测试本地设备和外部站点,不要一次排除所有私有地址段。
系统代理已开启,但应用没有走 Clash,怎么定位?
先新开一个浏览器页面,查看客户端连接列表。浏览器有记录而目标应用没有记录,通常意味着后者不读取系统代理或使用独立设置,可以检查应用的代理选项,或对照测试 TUN。两者均没有记录时,核对系统代理地址、监听端口和内核运行状态,并检查系统是否仍使用旧的自动代理配置。若连接已有记录但走了直连,则转查命中的规则和策略组。
浏览器正常,但 Windows UWP 应用使用本地代理失败,怎么办?
如果应用使用的是指向 127.0.0.1 的系统代理,先确认普通桌面应用能使用同一端口。仅个别 UWP 应用失败时,才考虑 AppContainer 的本地回环限制。客户端若提供 UWP 回环设置,可按其说明只为出现问题的应用启用豁免,再完全退出并重启该应用。不确定是否应修改时,先在系统允许的范围内测试 TUN;受组织管理的设备应遵循管理员策略。
怎样排查 Clash DNS 泄漏或 DNS 解析路径不符?
先明确预期使用哪个上游解析器,以及哪些域名本来就应由本地 DNS 解析。临时只保留一种流量接管方式,记录问题域名和测试时间,再对照客户端日志与系统 DNS 设置。浏览器启用的安全 DNS 可能走不同路径,测试时可在同一网络下分别对比其开启与关闭的结果。测试页显示的解析器所在地不能单独证明泄漏;判断时以实际请求路径和配置预期为准。
退出 Clash 后仍然不能上网,如何恢复?
先重新打开客户端,在界面中关闭系统代理和 TUN,再正常退出。如果客户端无法启动,到系统网络设置检查代理是否仍指向已停止监听的本地端口;只撤销本次启用的设置,原来由单位或学校配置的代理应保留。若曾手动更改 DNS,也应还原到原先值,再重新连接网络验证。不要直接重置所有网络配置,否则可能丢失原有的静态地址或内部网络设置。