配置与连接 / 问题索引

Clash 常见问题

按基础认知、安装配置、使用技巧和故障排查查找。先确认客户端与内核,再区分配置是否加载、流量是否进入内核、节点是否可用。

点击问题展开答案。排查时每次只改变一项设置,保留原配置;分享日志前移除订阅地址、节点凭据与个人网络信息。

基础认知

区分内核、客户端和订阅,避免把连接问题归到错误的环节。

Clash、mihomo 和图形客户端分别负责什么?

Clash 通常指代理内核及其配置生态;mihomo 是延续这一配置生态的内核项目。图形客户端负责订阅导入、策略选择和系统代理等操作,实际连接由所使用的内核处理。因此,相同界面不代表支持相同配置字段,相同内核也不代表设置入口一致。查找教程时先确认客户端名称,再在关于页面或运行日志中确认内核,避免把旧版 Clash 的限制套到 mihomo 上。

安装客户端后还需要准备什么?

客户端只是配置和使用代理连接的工具,安装完成不会自动生成可用节点。需要准备有权使用的订阅链接,或包含代理节点、策略组和规则的配置文件。订阅通常由服务提供方或自行搭建的服务生成,本站下载入口不等于订阅服务。导入前确认订阅适用的客户端格式,并保护链接中的身份信息;不要把完整订阅地址粘贴到公开讨论区,也不要导入来源不明的远程配置。

规则、全局和直连模式有什么区别?

规则模式按照配置中的规则顺序,为连接选择直连、代理或拒绝等处理方式。全局模式将进入内核的连接交给全局策略,但仍需选择可用节点。直连模式让进入内核的连接直接访问目标。三者改变的是内核收到连接后的处理方式,不决定应用是否把流量交给内核。因此,切换全局模式不能替代系统代理或 TUN 设置,也不保证所有应用流量都经过代理。

Clash 官网、客户端官网与下载中心怎样区分?

Clash 生态包含多个独立维护的内核与图形客户端,不能仅凭页面写着官网就认定它代表整个生态。应按具体客户端核对项目名称、维护说明和发行渠道。本站集中整理下载入口与中文配置说明,不把不同项目视为同一维护团队。寻找 Clash for Windows 替代客户端时,先看维护状态、平台支持和配置兼容性,再比较界面;旧教程里的安装包与设置名称可能已经变化。

桌面客户端与 Android、iOS 客户端能共用配置吗?

是否能共用配置,取决于内核与字段支持,不只取决于系统名称。基础规则和常见代理字段可能兼容,但桌面系统代理、TUN、文件路径及脚本相关配置不能直接照搬到移动端。移动端通常通过系统 VPN 接口接管流量,权限入口也与桌面不同。跨设备导入时先使用服务提供方标明适配的配置,再检查导入日志;遇到不支持的字段,应查当前客户端说明,而不是随意删除整个配置段。

选型参考:客户端对比;术语查阅:名词解释。

安装配置

先加载有效配置,再处理监听端口与系统授权。

订阅应该怎样导入,怎样确认已生效?

在客户端的配置或订阅页面新增远程配置,粘贴完整地址并保存,然后执行更新。列表出现新配置后还要将它设为当前配置,不能只停留在下载成功这一步。打开代理页面,确认预期策略组已经出现,再选择可用节点并启用系统代理或移动端 VPN。最后访问实际需要的站点,结合连接记录确认命中的策略;界面显示订阅已保存,只能说明地址保存成功,不代表配置已加载或连接已接管。

Clash 订阅更新失败或订阅失效怎么处理?

先查看更新错误属于网络超时、HTTP 状态错误还是配置解析失败。检查链接是否完整、订阅是否到期,以及服务提供方是否更换入口;401 或 403 可能与授权或访问限制有关,404 可能表示地址已变更。若当前代理不可用,尝试切换可用节点,或在客户端支持时改用直连更新。下载到登录页、验证页等 HTML 内容也会导致解析失败。不要反复重装客户端,应先确认订阅端返回了有效配置。

配置导入提示 YAML 解析错误怎么办?

先按日志给出的行号检查前后几行,重点看缩进、冒号后的空格和列表项前的短横线。YAML 缩进应使用空格,复制时混入制表符或中文标点容易破坏结构。若文件来自订阅,先重新下载原始配置,不要直接在订阅链接末尾追加未经说明的参数。语法正确后仍然报错,可能是字段不受当前内核支持。修改前保留副本,每次只改一处,确保能分辨是格式错误还是字段兼容问题。

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

先停止 TUN,再检查客户端要求的服务组件、管理员授权或系统网络扩展是否已经安装并获准运行。Windows 常需要安装并启动客户端的服务模式;macOS 可能需要在系统设置中允许相关网络扩展,具体以客户端提示为准。移动端则要允许创建 VPN 连接。不要把长期提升整个客户端权限作为唯一方案。授权完成后重新启动内核;若仍失败,检查其他 VPN 是否占用网络接口,并保留日志中的具体错误。

mixed-port 是什么,端口被占用时怎么改?

mixed-port 是可同时接受 HTTP 与 SOCKS 代理连接的本地监听端口,实际值以当前生效配置为准,不能假定始终是 7890。启动时若提示地址已被占用,先检查是否重复运行了其他客户端或内核进程。可以关闭重复进程,也可以换成未被占用的端口。改动后同步更新浏览器、终端及手动配置的应用代理地址,并重新启动内核;只修改配置文件而未重新加载,旧监听端口可能仍在使用。

完整操作顺序见快速上手;字段结构见YAML 手册。

使用技巧

用连接记录验证设置,不只看开关是否打开。

日常使用选规则模式,还是 Clash 全局模式?

日常使用通常先选规则模式,让配置按目标地址决定路径。某个站点访问异常时,可临时切到全局模式做对照,并确认全局策略选中了可用节点。若全局正常而规则异常,应查看该连接命中了哪条规则,再调整对应策略或规则顺序。排查结束后恢复原模式,避免其他连接也走同一出口。全局测试只能帮助缩小范围,不能单独证明问题一定在规则,也需要比较两种模式实际选择的节点是否相同。

怎样让指定网站直连,其他网站按原规则处理?

为目标域名添加精确域名或域名后缀规则,并放在可能先命中的宽泛规则与 MATCH 兜底之前。需要匹配主域及其子域时可使用 DOMAIN-SUFFIX,只有单个主机名时可考虑 DOMAIN。修改订阅配置前,优先找客户端的覆写或自定义规则入口,避免下次更新覆盖改动。保存并重新加载后,新建连接查看命中记录;旧连接可能继续使用原路径。网站依赖多个域名时,还需逐项确认资源请求的处理方式。

开启系统代理后,为什么终端仍然不走代理?

系统代理主要影响愿意读取系统代理设置的应用,部分命令行工具只读取自己的参数或代理环境变量。先查目标工具支持的代理方式,再按当前监听地址与端口设置 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY,具体变量名及优先级以工具文档为准。已有终端可能需要重新打开,某些工具也可能被自身配置覆盖。排查时检查实际连接记录;测试结束后清理临时环境变量,避免停用客户端后终端仍指向失效的本地端口。

DNS 与 Fake-IP 应该怎样选择?

Fake-IP 会为域名返回虚拟地址,再由内核将连接关联回原域名,有助于按域名分流,但依赖应用查询经过内核管理的 DNS。是否启用,应以客户端默认配置与当前网络兼容性为起点,而不是只改一个开关。局域网设备、部分游戏或依赖真实解析地址的应用可能需要例外处理。遇到特定域名异常时,先核对日志,再按当前内核支持的 fake-ip-filter 语法设置例外;改动后清理相关缓存并重新连接。

更换节点或更新配置后,需要关闭已有连接吗?

已有 TCP 连接通常不会因为策略选择改变而自动迁移到新出口,应用也可能复用连接池,所以切换后短时间内看起来仍走旧节点。先关闭目标应用的相关连接,或在客户端连接页面断开对应连接,再重新发起请求。更新规则或 DNS 设置后,也可能需要重启应用、清理 DNS 缓存或重载内核。不要仅凭已打开网页的表现判断修改无效;应观察新连接的策略记录,并避免一次清空所有连接打断正在进行的任务。

延伸查阅:代理模式设置、Fake-IP 配置。

故障排查

按流量入口、规则命中、节点出口、DNS 解析逐项检查。

Clash 系统代理不生效,浏览器打不开怎么排查?

先确认内核已经启动且当前配置有效,再核对系统代理地址是否指向正在监听的本地端口。检查浏览器扩展、浏览器独立代理设置和其他代理软件是否覆盖了系统设置。然后在连接页面发起一次新请求:没有记录时先排查流量入口,有记录时再看命中的策略与错误。可临时用另一个浏览器对照,区分浏览器设置和网络问题。不要同时修改 DNS、规则和节点,按入口、策略、出口的顺序逐项验证更容易定位。

节点测试超时,但其他节点正常怎么办?

先切换其他节点访问同一目标,确认故障是否只发生在单个节点。测试超时可能来自节点不可达、测试地址异常、协议不兼容或当前网络限制,不能只凭一次测试认定订阅整体失效。检查订阅是否更新、设备时间是否准确,并阅读该节点连接时的日志。若仅测试失败但实际访问正常,可核对测试 URL;若实际访问也失败,先使用可用节点,再向服务提供方反馈时间、网络类型与去除敏感信息后的错误摘要。

Windows 的 UWP 应用不走本地代理,回环设置怎么查?

部分受应用容器隔离限制的 UWP 应用,不能直接访问本机回环代理地址。若浏览器正常而某个 UWP 应用失败,先确认它确实受此限制,再使用客户端提供的回环豁免工具,只为需要的应用授权。没有工具时,可按 Windows 的 CheckNetIsolation 文档检查对应包的豁免状态。该操作可能需要管理员权限,也不适用于所有商店应用。授权后重启目标应用;若它本身不读取系统代理,还需另查流量接管方式。

怎样检查 Clash DNS 泄漏,浏览器安全 DNS 会影响吗?

先确认应用的 DNS 查询由谁处理,再比较内核 DNS 配置、系统 DNS 和浏览器安全 DNS 设置。浏览器自带的加密 DNS 可能走独立解析路径,不一定遵循内核的解析策略。泄漏测试显示的解析服务位置,只是线索,不能单凭地区判断是否泄漏。应结合 DNS 日志与流量路径,核对查询是否按预期发送。切换 TUN 或 DNS 设置后重新发起查询,必要时清理缓存;同时注意 IPv6 查询和局域网设备的解析路径是否也已纳入配置。

关闭客户端后断网,或开启 TUN 后局域网不可用怎么办?

关闭客户端后断网,先检查系统是否还保留指向本地端口的手动代理,再检查 DNS 与 VPN 连接状态,优先通过客户端正常关闭系统代理和 TUN。开启 TUN 后只有打印机、路由器或局域网服务异常时,应检查私有网段的路由排除与直连规则,而不是直接关闭全部防火墙。不同客户端的自动路由实现不同,修改前记录原设置。恢复正常网络后再逐项启用功能;持续失败时保留路由与日志信息,避免盲目重置所有网络设置。

DNS 字段与示例见YAML 手册:DNS 设置。需要重新选择适配客户端时,可查看下载中心。