help / questions

Clash 常见问题

订阅导入、代理设置与连接排查

先按现象选分类,再展开对应答案。排查时每次只改一项,保留原配置与错误日志,便于对照恢复。

检查顺序

基础网络 → 内核运行 → 流量入口 → 规则与出口

基础认知

先分清内核、订阅与流量入口。

Clash、mihomo 内核和图形客户端有什么区别?

先区分内核与界面。内核负责读取配置、匹配规则和转发连接;图形客户端负责订阅管理、模式切换及系统设置。mihomo 是由 Clash Meta 更名而来的内核项目,不等于某一个桌面应用。排查时同时记录客户端名称和内核版本;界面能打开,只代表客户端启动,不代表内核已经正常监听端口。

安装客户端后,为什么还需要订阅链接?

先准备服务提供方给出的有效订阅。订阅链接通常用于获取服务器地址、连接参数及策略组,客户端本身不附带可用的代理服务。导入前确认服务有效期、流量额度与格式支持情况。链接常包含访问凭据,应按密码管理;求助时遮住完整链接、账户信息和服务器认证字段,不要把订阅粘贴到公开评论区。

规则、全局和直连模式分别适合什么时候用?

日常先选规则模式,让请求按配置中的规则选择代理或直连。全局模式把流量交给全局策略选择的出口,适合短暂对照测试,但只影响已经进入内核的流量,也不保证所选出口一定是代理。直连模式让进入内核的请求直接连接目标。模式切换不会自动开启系统代理;测试完成后恢复原设置,避免把临时选项当成长期配置。

系统代理和 TUN 模式应该先开哪一个?

先开启系统代理,确认浏览器能够连接。系统代理是向操作系统登记代理地址,应用是否使用它取决于自身实现。TUN 是虚拟网络接口,可结合路由接管更多应用流量,但需要权限,并可能与其他 VPN、路由和 DNS 设置相互影响。没有明确需求时先保持 TUN 关闭;需要接管不读取系统代理的应用时,再单独测试。

客户端、本地端口和代理服务器之间是什么关系?

先把本地入口与远端出口分开看。应用连接本机监听端口,内核再根据规则把请求直连到目标,或转交给代理服务器。mixed-port 是同时接受 HTTP 与 SOCKS 代理请求的混合端口,7890 只是常见配置值,应以当前客户端为准。127.0.0.1 表示本机;手机中填写这个地址,指向的是手机本身,不是电脑。

查阅代理与配置术语 ›

安装配置

从订阅返回内容、系统权限和生效配置入手。

Clash 订阅链接导入后没有节点,应该检查什么?

先打开订阅更新日志,确认获取成功,再检查是否已选中并启用这份配置。复制链接时去掉首尾空格,避免误用账户后台页面地址。获取成功却没有节点,可能是返回了登录页面、格式不兼容或服务方未分配内容。不要把网页 HTML 当作 YAML 配置导入;向服务方确认适配 mihomo 的订阅格式,并保留原配置用于恢复。

订阅更新提示 401、403 或链接失效怎么办?

先检查服务账户是否到期、订阅是否被重置,再从服务方后台重新复制链接。401 通常与认证有关,403 可能涉及访问限制,也可能由网站防护返回,不能仅凭状态码认定欠费。若浏览器能获取而客户端失败,核对更新时间、请求方式和服务方要求的客户端标识。不要反复公开测试完整链接,也不要把认证信息提交给陌生转换服务。

开启 TUN 提示权限不足或虚拟网卡创建失败怎么办?

先按客户端说明安装服务组件或批准系统网络权限,再重新开启 TUN。Windows 检查服务是否安装并运行;macOS 检查系统是否有待批准的网络扩展或 VPN 请求;Android 确认已同意 VPN 连接。随后检查其他 VPN 是否占用了网络接管通道。不要直接关闭系统防护或反复删除网卡;保留日志中的具体错误,再判断是权限、驱动还是路由冲突。

出现 YAML 解析错误或端口被占用,怎样恢复启动?

先备份当前配置,再回滚到最后一次可用版本。YAML 是依靠缩进表达层级的配置格式,应使用空格,不要混入制表符,并结合日志中的行号检查冒号和列表缩进。若日志提示 address already in use,检查是否启动了另一份代理程序,再停止冲突进程或修改本地监听端口。修改端口后,同步更新系统代理与应用中的代理地址。

为什么修改配置后,更新订阅又恢复了原样?

先确认修改的是订阅原文件,还是客户端提供的覆写层。订阅更新通常会重新下载配置,直接编辑下载文件可能被覆盖。需要保留端口、DNS 或自定义规则时,优先使用客户端支持的覆写、合并或扩展配置功能,并查清规则插入顺序。不同客户端合并方式不同,保存后检查实际生效配置和内核日志,不要只看编辑器里的内容。

按顺序完成首次配置 ›

使用技巧

用连接记录确认结果,而不是只看开关。

怎样确认请求真的经过代理,而不是只看开关状态?

先打开客户端的连接列表,再访问一个需要测试的目标,核对目标域名、命中的规则和最终出口。系统代理开关显示开启,不等于每个应用都在使用代理;连接列表出现请求,也不代表请求一定走代理出口。可用 curl -I -x http://127.0.0.1:7890 https://example.com 测试本地 HTTP 入口,端口按实际设置替换;结果只代表该次请求。

浏览器能连接,终端命令却失败,应该怎样设置?

先给单条命令显式指定代理,确认本地端口能够使用,再考虑设置环境变量。许多命令行工具不读取系统代理,curl 可通过 -x 指定地址;其他工具应查阅各自的代理参数。环境变量的写法和读取规则因 shell、工具而异,HTTP_PROXY、HTTPS_PROXY 与 ALL_PROXY 不能视为处处通用。退出客户端或更改端口后,清理旧变量并重新打开终端。

自定义规则放在哪里,为什么添加后没有命中?

先检查规则顺序。规则通常从上到下匹配,较早命中后就不会继续执行后面的条目,因此具体域名规则应放在相关宽泛规则和 MATCH 兜底之前。再核对策略组名称是否存在、大小写是否一致,以及请求是否携带可匹配的域名。若连接列表只显示 IP,应进一步检查 DNS 与域名识别;保存后重新加载配置,并新建连接验证。

Clash GeoIP 与 GeoSite 数据需要怎样更新?

先确认配置确实使用了 GEOIP 或 GEOSITE 规则,再通过客户端的数据更新入口操作。GeoIP 用于 IP 地理分类,GeoSite 用于域名集合分类,两者不能互相替代。需要手动配置时,检查 mihomo 支持的 geox-url、自动更新选项与当前数据格式是否一致。下载失败应看具体日志;更新后重新加载相关数据或重启内核,再用连接记录确认规则命中。

电脑开启代理后,怎样让同一局域网的设备使用?

先在可信网络中开启允许局域网连接,并检查绑定地址、防火墙和代理认证。其他设备应填写电脑的局域网 IP 与实际监听端口,不能填写 127.0.0.1。两台设备还需要能够互相访问,访客网络或无线隔离可能阻断连接。不要将监听端口暴露到公网;使用结束后关闭共享。局域网设备是否支持 HTTP 或 SOCKS 代理,也需要分别确认。

查看 GeoIP 与 GeoSite 更新示例 ›

故障排查

先定位失败环节,再调整对应设置。

系统代理已经开启,浏览器仍然不走代理怎么办?

先确认内核正在运行且本地端口与系统设置一致,再检查浏览器是否被扩展、独立代理设置或组织策略覆盖。临时停用代理类扩展,用新的浏览器窗口测试,并观察连接列表是否出现请求。没有记录时,优先查流量入口;出现记录但走直连时,检查模式、规则与策略组。不要一开始同时改 DNS、订阅和 TUN,否则难以判断是哪项改动生效。

所有节点都超时,是订阅失效还是本地网络问题?

先关闭代理,确认基础网络能访问正常网站,并检查是否存在需要登录的公共 Wi-Fi。随后看服务账户状态、系统时间及客户端日志,再换一个网络做对照。超时只说明测试未在期限内完成,不能单独证明订阅失效;测试地址不可达也会影响结果。若只有某个节点失败,优先检查该服务器;若所有节点都失败,再查 DNS、网络限制和防火墙。

日志出现 DNS 解析失败,为什么切换节点也没有用?

先找出失败的是目标网站域名,还是代理服务器域名。DNS 负责把域名解析成 IP,若代理服务器自身无法解析,更换同类节点未必解决问题。检查日志中的超时、连接拒绝和解析循环,核对上游解析服务是否可达;TUN 下还要检查 DNS 接管是否生效。不要同时开启多个应用的 DNS 接管。修改前备份,每次只调整一项,并按客户端方式清理缓存后复测。

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

先确认出问题的确实是受应用容器限制的应用,而不是所有商店安装的软件。部分 UWP 应用受到回环限制,不能访问本机代理端口。若客户端提供回环豁免工具,仅为需要的应用授权;也可用系统的 CheckNetIsolation LoopbackExempt 工具查询,并依据准确的包系列名称添加豁免。通常需要管理员权限。操作后重启目标应用,不要批量豁免所有应用。

移动端切换网络后断连,或退出客户端后不能上网怎么办?

先区分连接残留与网络切换问题。Android 检查 VPN 状态、后台运行限制及始终开启 VPN 的设置;iOS 检查系统 VPN 状态,并重新建立连接。切换 Wi-Fi 与移动网络后,等待网络稳定再重连。电脑退出客户端后无法上网,则检查系统代理是否仍指向已停止的本地端口。恢复网络后再启动客户端逐项测试,不要直接重置整套网络配置。

进入按症状组织的问题诊断 ›