帮助中心 / 常见问题
Clash 常见问题
按问题类型查看检查步骤。先确认当前配置、代理接管方式与日志报错,再调整设置;每次只改一项,便于验证和回退。
基础认知
分清客户端、内核、订阅与代理模式,再选择适合当前设备的安装方式。
Clash、Clash Meta 和 mihomo 是什么关系?
Clash 最初指代理内核及其配置生态,Clash Meta 是在此基础上发展的内核分支,后续以 mihomo 名称继续维护。日常安装的图形客户端负责展示订阅、代理组和设置,内核负责实际处理连接。客户端名称相近,不代表内核与支持字段完全相同。遇到协议或配置不兼容时,先在关于页面确认客户端及内核信息,再对照订阅要求判断,不要仅凭名称选择配置。
Clash 客户端安装后就能直接连接吗?
客户端负责读取配置和转发流量,安装程序本身通常不包含可直接使用的代理服务。需要准备自己有权使用的订阅链接或配置文件,导入后选择代理组,再启用系统代理或按需启用 TUN。看到配置名称只说明导入已完成,还要检查代理组是否有可选节点、配置是否处于启用状态,以及目标应用的流量是否进入客户端。订阅到期或流量额度用尽,应向订阅提供方确认。
Windows、macOS 和手机应该选择哪个客户端?
先按操作系统筛选,再核对处理器架构和最低系统要求。Windows、macOS、Android 与 iOS 可优先查看 Clash Plus;Linux 可先查看 Clash Verge Rev。需要迁移旧配置时,还要确认客户端内核支持所用协议、规则和 DNS 字段。Apple Silicon 与 Intel 安装包不能随意混选,Android 也应核对 ARM64 或 ARM 架构。具体可选软件、安装入口和归档状态以下载中心各平台列表为准。
规则、全局和直连模式分别适合什么情况?
规则模式按当前配置中的规则决定连接走代理还是直连,适合日常使用。全局模式将进入内核的普通连接交给全局代理组,适合短暂对照排查,但仍需选择可用节点。直连模式让进入内核的连接直接访问目标,不等于关闭系统代理或退出客户端。三种模式只影响已被客户端接管的流量;应用没有进入代理时,切换模式也不会改变它的访问路径。
订阅链接可以发给别人协助排查吗?
订阅链接经常带有用于识别账户的访问凭据,不应直接发布到论坛、群聊或公开截图中。排查时可提供报错文字、客户端和内核信息,以及隐藏敏感内容后的配置片段。隐藏订阅地址之外,还要检查节点密码、授权请求头和日志中的完整 URL。如果链接已被公开,应通过提供方后台重置或撤销,再更新客户端里的地址;仅删除聊天记录不能确保旧链接停止使用。
安装配置
导入配置与接管流量是两个步骤。先确认配置有效,再处理系统权限与代理入口。
Clash 订阅链接导入后没有节点,应该检查什么?
先确认复制的是订阅地址,而不是账户登录页或订阅管理页面。检查地址前后是否带空格、换行或遗漏参数,再查看导入结果和日志。若返回登录页面、访问拒绝或空内容,应先处理账户授权和网络访问问题。若提示格式不支持,向提供方确认是否有适配当前内核的 Clash 配置。导入成功后还需启用该配置,并检查代理组是否引用了正确的节点或代理提供器。
开启 TUN 模式时提示权限不足怎么办?
TUN 需要创建虚拟网络接口并调整路由,通常比系统代理需要更多权限。Windows 先按客户端说明安装服务组件,确认服务正在运行;必要时以管理员权限进行一次验证。macOS 检查系统弹出的网络扩展或辅助组件授权,Linux 检查服务权限及 TUN 设备是否可用。不要反复点击开关替代授权。完成授权后重新启动客户端,再查看日志中接口创建和路由设置是否成功。
开启系统代理后,浏览器仍然不走 Clash 怎么办?
先在系统网络设置中确认代理地址指向本机,端口与客户端当前监听端口一致,不要默认所有客户端都使用同一个端口。退出其他代理工具,并暂时停用浏览器中接管代理的扩展。Firefox 等浏览器还可能使用独立代理设置,应核对是否选择跟随系统。随后打开一个新页面,观察客户端连接记录;完全没有记录时先查接管入口,有记录但失败时再查规则、节点和 DNS。
Android 开启 Clash 时提示 VPN 冲突如何处理?
Android 通常同一时间只允许一个应用占用系统 VPN 通道。先关闭其他 VPN 应用,以及使用本地 VPN 实现的防火墙或网络过滤工具,再重新授权 Clash 建立连接。若系统设置了始终开启的 VPN 或禁止不经过 VPN 的连接,也要核对它们绑定的应用。连接成功后检查客户端的分应用名单,确认目标应用未被排除。不要为了处理冲突而直接清空所有配置,先保留订阅和必要设置。
config.yaml 提示 YAML 格式错误怎么修改?
先备份配置,再根据报错中的行号检查附近内容。YAML 层级依赖空格缩进,不要用 Tab;列表项、冒号后的空格和成对引号也要保持正确。行号有时指向错误被发现的位置,真正缺失的引号可能在上一行。格式通过后若仍提示未知字段,应核对内核是否支持该字段。订阅生成的配置通常会在更新时被覆盖,长期调整应使用客户端提供的覆写或合并功能。
操作入口:系统代理设置 · TUN 模式设置 · config.yaml 排查
使用技巧
用连接记录验证分流结果。更新订阅、共享代理或调整 DNS 前,保留一份可回退配置。
怎样确认某个应用确实经过 Clash?
在客户端打开连接记录,再从目标应用发起一次新的网络请求,核对目标域名、命中的规则和所选代理链。已有长连接可能继续沿用旧路径,因此切换设置后应重新建立连接。只看网页显示的出口地址不能解释所有分流结果,规则模式下不同网站可能采用不同路径。若没有记录,检查应用是否遵循系统代理,或是否被 TUN 的分应用设置排除;不要仅凭开关颜色判断接管成功。
TUN 模式和系统代理需要同时开启吗?
不必固定同时开启。系统代理适合遵循系统代理设置的浏览器和常见应用;TUN 可接管更多不主动使用代理的程序,但涉及路由、DNS 和权限配置。初次排查建议只保留一种接管方式,先确认它能正常工作,再按客户端说明组合使用。两个开关同时开启并不代表速度更快,也不能自动修复失效节点。若开启 TUN 后异常,应检查接口、路由和 DNS 日志,而不是继续叠加其他代理工具。
怎样设置订阅自动更新,避免覆盖自己的修改?
在订阅或配置管理页面找到自动更新间隔,按实际需要设置,并确认客户端运行时才会执行更新还是由后台服务执行。更换订阅地址后先手动刷新一次,检查更新时间与报错信息。个人规则、代理组调整和 DNS 设置应尽量通过客户端支持的覆写或合并功能保存,不要只修改下载下来的订阅正文。更新后核对当前启用配置,原节点被移除时还应重新选择代理组中的节点。
允许局域网连接后,手机怎样共用电脑代理?
让电脑和手机处于可互访的可信局域网,在客户端开启允许局域网连接,并确认监听地址接受局域网请求。手机 Wi-Fi 的手动代理服务器应填写电脑的局域网地址,端口填写客户端实际的 HTTP 或混合端口,而不是手机自己的回环地址。电脑防火墙只对必要的本地网段放行;不要将代理端口映射到公网。手动 HTTP 代理也不会覆盖手机所有应用,应用是否采用该设置需要单独确认。
Clash GeoIP 更新失败会影响哪些规则?
GeoIP 数据用于按 IP 所属地区匹配规则,更新失败可能造成基于地区的判断不准确,但不会直接让所有域名规则失效。先检查日志中的数据文件路径和更新地址是否可访问,再确认配置采用的是 MMDB 还是其他地理数据格式,以及对应文件是否存在。不要把不同格式的文件改名后互换。更新完成后按客户端要求重载配置或重启内核,并用连接记录确认相关规则实际命中情况。
继续查阅:规则分流排查 · GeoIP 数据检查
故障排查
先区分本地网络、配置下载、节点连接与应用接管问题,避免把不同症状都归因于订阅。
订阅突然失效或提示解析失败,按什么顺序排查?
先区分下载失败与内容解析失败。下载失败时检查订阅是否到期、地址是否重置、系统时间是否正确,以及当前网络能否访问订阅服务。解析失败时查看响应是否实际为网页或错误提示,再核对配置格式和内核支持情况。不要连续高频刷新,部分服务会限制请求频率。如果旧配置仍能使用,可先保留它并暂停覆盖;向提供方反馈时提交状态码和脱敏报错,不要公开完整订阅地址。
节点测试全部超时,是订阅坏了吗?
全部超时不一定代表订阅失效,也可能是测试地址不可达、本地 DNS 异常、防火墙拦截或节点服务故障。先确认设备不经过代理时能正常联网,再选一个节点实际访问目标,并对照连接日志判断。测试结果只是对特定测试地址的探测,不能替代真实请求。若更换可信网络后恢复,应继续检查原网络限制;若只有某个节点失败,换其他节点验证,再向提供方反馈该节点和发生时间。
开启 Clash 后完全无法上网,怎样恢复并定位?
先在客户端关闭系统代理与 TUN,再退出程序,确认系统网络设置没有残留指向本机的代理。基础网络恢复后重新启动客户端,只启用一种接管方式并选择已知可用的节点。观察失败发生在域名解析、节点连接还是规则匹配阶段;必要时短暂切到全局模式对照。若退出后仍无法联网,继续检查系统 DNS、路由和其他 VPN 设置。不要在尚未确认原因时同时修改多个网络参数。
浏览器能联网,Microsoft Store 等 UWP 应用却失败怎么办?
部分使用 AppContainer 沙箱的 Windows 应用默认不能访问本机回环代理,因此会出现浏览器正常、应用连接失败的差异。先确认该应用确实使用本机代理,再使用客户端提供的 UWP 回环工具,仅为需要的应用添加回环豁免;相关操作可能需要管理员权限。不是所有商店应用都受同一种限制,缺少应用条目时不要随意套用其他包名。也可按客户端文档评估 TUN,并通过连接记录验证效果。
出现 DNS 解析失败或网站打开很慢,先查哪里?
先查看日志是否有解析超时、解析失败或解析器连接错误,再检查配置中的 DNS 上游能否通过预期路径访问。加密 DNS 地址正确也不代表当前网络可达,其服务器域名可能还需要引导解析。若采用 fake-ip,应确认相关流量由客户端接管,并检查与其他 DNS 工具的冲突。修改 DNS 后重建连接,必要时清理系统缓存。不要一次替换全部解析设置,保留可回退配置,逐项验证解析与实际访问。