FAQ / 使用与排查
Clash 常见问题
从订阅导入、代理接管到节点超时。先确定问题发生在哪一步,再查对应设置和日志。
Clash 客户端和 mihomo 内核有什么区别?
客户端提供界面和系统集成,内核负责读取配置、匹配规则并建立连接。安装包通常由客户端项目发布,支持哪些字段则取决于它实际运行的内核及版本。遇到“未知字段”时,先从客户端的关于页或启动日志确认内核,再查对应版本的文档。只更新界面不一定会更新内核;两台设备使用同一份配置,也可能因为内核版本不同而表现不同。
规则、全局和直连三种模式怎么选?
日常使用优先选规则模式。内核按配置顺序匹配流量,命中第一条适用规则后交给指定策略。全局模式可以用来短时对照:为全局策略选定一个已知可用的出口,再重试同一个请求。直连模式让已进入内核的流量直接出站,但不会替你关闭系统代理或 TUN。若要验证应用绕开内核后是否能联网,应单独关闭对应接管入口,再建立新连接。
mixed-port 是远端节点的端口吗?
不是。mixed-port 是内核在本机监听的混合端口,可接收 HTTP 和 SOCKS 代理连接;节点配置里的 port 才是远端服务器的端口。手动设置本机应用时,常用地址是 127.0.0.1,端口以当前配置或客户端实际显示的监听值为准,不要默认所有配置都是 7890。只在本机使用时保持局域网访问关闭,避免把代理入口暴露给同一网络里的其他设备。
订阅链接、YAML 文件和节点链接可以互换吗?
三者用途不同。订阅链接指向可重新获取的远程内容,客户端可按需刷新;本地 YAML 是一份独立文件,导入后通常不会随原订阅同步。单条节点链接一般只描述一个出站连接,不包含完整的本地端口、策略组和规则。若手里只有节点链接,先确认客户端是否支持单节点导入,不要直接粘进只接收完整配置的入口。订阅地址可能包含访问凭据,不应贴到公开截图或工单里。
安装客户端前要核对哪些系统要求?
先核对操作系统版本、处理器架构和包格式。桌面系统可在系统信息页查看是 x64 还是 ARM64;Mac 可从“关于本机”确认使用 Intel 处理器还是 Apple 芯片。Linux 还要核对发行版的包管理格式,不能仅凭扩展名之外的相似文件名判断兼容。更新前确认安装包来自对应客户端的发布渠道。若系统报告不支持或拒绝启动,先查最低系统版本与架构,不要关闭全局安全设置。
导入订阅后怎样确认配置已经启用?
导入成功不等于启用成功。在客户端的配置页选择“从链接导入”或同类入口,保存后等待拉取完成,再明确选中这份配置。切到代理页,检查显示的策略组是否来自新配置,并观察日志里是否出现解析或启动错误。如果列表里有文件而代理页仍显示旧分组,先确认当前活动配置,再检查新文件是否加载失败。最后打开一个可访问的站点,在连接或日志页确认请求确实进入内核。
TUN 打不开,提示权限不足怎么办?
先确认客户端是否支持当前系统上的 TUN,再检查它采用哪种授权方式。桌面客户端可能要求安装并启动代理服务,或在首次启用时请求管理员权限;Linux 上还可能涉及设备访问与网络管理权限,应按发行版和客户端说明授予。使用系统 VPN 接口的移动客户端,通常需要在系统弹窗里确认连接请求。若授权后仍失败,先看服务状态和第一条启动错误,再检查是否有其他 VPN 或虚拟网卡正在接管路由。
升级客户端前怎样保留本地配置和覆写?
先备份配置和覆写,再更换客户端版本。用客户端的导出功能保存本地 YAML、覆写文件和需要保留的设置;若没有导出功能,按该客户端文档确认配置目录。备份应保存在只有自己可访问的位置,远程订阅地址也按凭据处理。更新后先选中原配置,检查策略组和规则是否仍符合预期,再开启流量接管。如果更新后出现解析错误,保留报错信息,对照新旧内核对相关字段的支持情况。
系统代理和 TUN 应该先开哪个?
只需要让遵循系统代理的浏览器或应用走代理时,先用系统代理。它向支持这项设置的软件提供本机代理地址,但不会把所有程序的流量都导入内核。应用不读取系统代理时,再考虑它自己的代理设置,或在客户端支持的情况下使用 TUN。TUN 会在路由层接管配置范围内的流量,可能影响局域网、公司 VPN 和 DNS。首次排查只开一种入口,确认同一个请求能在日志中找到,再决定是否调整接管范围。
为什么只有 UWP 应用需要做回环豁免?
部分运行在 Windows 应用容器里的应用默认受回环限制,可能无法连接 127.0.0.1 上的代理。常见表现是普通桌面浏览器经同一端口可用,而某个容器应用始终连不上。如果客户端提供“UWP 回环”管理入口,可以按系统授权提示,仅为出现问题且确实需要本机代理的应用设置豁免。关闭该应用后重新打开并测试,不要批量放开整个列表。若仍失败,再确认应用自身是否采用系统代理。
规则已经写进配置,为什么没有命中?
先确认当前是规则模式,并查看连接实际命中的规则。内核按顺序检查规则,宽泛规则放得过早,可能让后面的具体规则没有机会生效;MATCH 通常放在末尾兜底。核对日志里的目标与配置填写的域名是否一致,同时检查策略组名称是否完全相同。若日志只出现目标 IP,先确认当前接管方式是否能向内核提供域名信息。每次只改一项,保存并重载配置后,用新连接验证,不沿用浏览器已有的连接。
开启配置中的 DNS 后,所有应用都用它解析吗?
不一定。启用内核 DNS 只意味着相关解析功能可用,不代表系统中的所有查询都会进入它。先确认测试应用采用哪种解析路径:系统解析器、浏览器自己的加密 DNS,还是客户端在 TUN 下接管的查询。测试时记录客户端模式和浏览器设置,每次改一处,用新查询重试并观察日志。不要仅凭一次解析测试或返回的 IP 就判断是否漏用了系统 DNS,因为浏览器缓存和不同域名的解析策略也会影响结果。
订阅刷新失败怎样判断是链接失效还是网络问题?
先看更新日志中请求在哪一步失败。收到 401 或 403 时,核对账户状态、链接权限及获取渠道是否更换地址;404 则先确认是否仍在使用旧链接。若日志是域名无法解析、连接超时或证书错误,应先排查当前网络、系统时间和客户端的订阅更新路径,不能据此断定订阅已过期。如果已收到内容,却提示无法解析 YAML,还要确认返回的是否是登录页或错误页。保留现有可用配置,直到新订阅成功加载。
Clash 节点全部超时和个别超时怎么分别排查?
全部超时先查共同环节,个别超时再查对应节点。先确认设备本身能联网、活动配置已加载,以及测速目标没有在当前网络下失效。若网页仍能通过某个节点打开,测速超时不能直接说明节点不可用。若测速和实际请求都失败,查看首条连接错误,区分域名解析失败、远端连接超时和握手失败。只有少数节点异常时,用同一设备和目标对照可用节点,再决定刷新配置还是向提供方反馈。
系统代理已开启,为什么应用流量还是没有走代理?
用连接页或日志先区分两种情况:请求没进入内核,还是进入后被规则判为直连。没有记录时,检查系统代理地址和端口是否与内核监听一致,再检查应用是否使用独立代理、是否命中系统的绕过列表,以及其他软件有没有覆盖代理设置。有记录却显示 DIRECT 时,应查模式和规则,而不是反复切换系统代理开关。改完设置后重启测试应用或发起新连接,避免已有连接让测试结果看起来没变化。
启动时提示端口被占用,应该怎么处理?
先从启动日志确认冲突的是混合端口、控制端口还是其他监听端口,再通过系统的网络监视工具确认占用进程。常见原因是旧客户端仍在后台运行,或两个客户端同时使用同一个端口。不确定进程用途时,不要强制结束。可以退出已确认的旧实例,也可以给当前客户端改一个未被占用的端口。修改混合端口后,要同步更新系统代理和手动设置过代理的应用,再重启内核确认监听成功。