CLASH / HELP REFERENCE

Clash 常见问题

订阅、代理接管与连接故障的分类检查。

先区分配置是否载入、流量是否进入内核、规则是否选对出口,再检查节点与目标服务。下列问答按这一顺序整理;不同客户端的菜单名称可能略有差异。

CONCEPTS

基础认知

明确内核、客户端与服务来源的边界,再决定安装与迁移方案。

Clash 内核、图形客户端与订阅分别负责什么?

内核负责建立连接、解析域名与执行分流规则;图形客户端负责配置导入、系统代理开关、服务管理和日志展示;订阅则是远程提供的节点或配置数据。mihomo 属于内核,使用它的客户端仍可能有不同的界面和覆写机制。安装客户端不会自动获得可用节点。排查问题时应分别记录客户端名称、内核信息和配置来源,避免把界面功能差异误判为协议故障。

Clash之家是 Clash 官网吗?

Clash之家是客户端与配置资料站,不代表原版 Clash 或各图形客户端的开发团队。Clash 生态由多个独立项目组成,不能仅凭名称相近就认定维护者相同。下载时应确认具体客户端、目标系统和处理器架构;需要核对项目行为时,以对应项目的说明、发布记录和许可文件为准。本站的教程用于解释通用操作,不代替订阅提供方的账户支持或软件开发者的问题反馈渠道。

规则、全局与直连模式应该怎样选择?

日常使用通常从规则模式开始:连接按规则顺序匹配,并交给指定策略处理。全局模式将进入内核的连接交给全局策略,适合临时判断问题是否出在分流规则;它不等于所有设备流量都已被接管。直连模式通常让进入内核的连接直接访问目标,但内核的解析与监听过程仍可能存在。测试结束后恢复原模式,并在连接页核对实际命中的规则和出口,而不是只观察开关状态。

Clash 免费节点与客户端免费是否是一回事?

两者不是同一个概念。客户端的软件许可与节点服务的获取方式彼此独立,软件可免费使用不代表远程服务器也免费提供。公开节点的可用性、运营者身份和日志政策通常难以确认,不宜用于传输敏感资料。导入陌生配置前,还应检查远程规则、DNS、脚本或覆写内容,以及是否开放了本地控制接口。已经泄露的订阅地址应由提供方重置,不能只在客户端删除后继续使用原地址。

Clash for Windows 替代客户端应该如何选择?

先按操作系统选择候选客户端,再确认配置兼容性、内核支持、服务安装方式和本地覆写功能。Windows 用户可先查看 Clash Plus,再比较 Clash Verge Rev、FlClash 与 Clash Nyanpasu;Clash for Windows 已停止维护,宜作为历史迁移对象而非新配置的默认起点。迁移前备份订阅来源、规则和策略组选择,不要直接覆盖旧程序目录。新旧客户端应分开测试,避免同时修改系统代理或占用同一监听端口。

查看概念速查 · 比较客户端功能与平台


INSTALLATION & PROFILES

安装配置

导入成功、配置启用与流量接管是三个不同环节,需要分别确认。

首次导入订阅后,还需要完成哪些设置?

在配置页添加订阅地址并更新成功后,先选中该配置,使其成为当前运行配置。随后进入代理页,为实际使用的策略组选择一个节点,再启用系统代理或按需要启用 TUN。最后打开连接页和日志页,访问一个明确的测试目标,确认连接进入内核并命中预期策略。配置列表出现条目只表示数据已经保存,不代表配置已启用;节点测速有结果也不代表浏览器流量已经交给客户端处理。

订阅更新失败、失效或返回空内容怎么办?

先查看更新错误:认证失败或访问被拒绝时,检查订阅是否过期、是否被重置以及地址是否复制完整;返回网页或空内容时,确认复制的是订阅地址而不是账户管理页面。超时则先检查本地网络,并留意更新请求是否依赖当前已经失效的代理。不要把完整订阅地址提交给公共转换服务或公开论坛。若旧配置仍能使用,可先保留它,再向提供方确认格式与账户状态,避免删除后失去可用配置。

YAML 导入报错,应该先检查哪些位置?

先按日志提示定位行号及其前后几行,检查缩进是否混用了制表符、列表项前的短横线是否缺失、冒号后是否留有空格。接着确认文件内容确实是 Clash 或 mihomo 可识别的 YAML,而不是网页、Base64 节点集合或其他内核的 JSON。语法解析通过后,还要检查策略组引用的节点名、规则引用的策略名是否存在。修改前保留原文件,每次只修正一处,再重新载入,便于区分语法错误与字段兼容问题。

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

TUN 需要创建虚拟网络接口并调整路由,权限要求高于普通系统代理。先依照客户端说明安装服务或辅助组件,并确认服务正在运行;桌面系统可能需要管理员授权,Android 则需要批准系统的 VPN 连接请求。若授权后仍失败,检查是否已有其他 VPN、虚拟网卡工具或安全软件拦截。不要连续反复安装驱动。先关闭冲突程序、重启相关服务,再结合日志定位权限、接口创建或路由写入中的具体失败环节。

Clash Android 客户端连接后,部分应用仍不经过代理怎么办?

先确认系统的 VPN 授权仍然有效,再检查客户端的按应用分流设置:允许列表只接管选中的应用,排除列表则会绕过指定应用。同时检查策略规则是否将该应用访问的域名设为直连。Android 通常只能同时维持一个普通 VPN 服务,其他 VPN 或本地过滤工具可能替换当前连接。若锁屏后断开,再检查电池优化、后台运行与自启动权限。每次调整后重新建立连接,并用日志判断请求是否进入内核。

按步骤完成首次配置 · 查看各平台客户端


RULES & DAILY USE

使用技巧

用连接记录验证配置效果,保留本地改动,并限制代理入口的开放范围。

怎样确认规则命中了预期策略组?

打开客户端连接页,发起一次新的目标访问,查看该连接对应的域名、匹配规则与代理链。规则通常按顺序执行,前面的宽泛规则可能提前覆盖后面的精细规则;MATCH 是兜底规则,应放在列表末尾。修改规则或策略选择后,已有长连接可能继续使用原出口,需要关闭相关连接或重启目标应用后再测。若连接页只显示目标 IP,应继续检查域名解析与嗅探条件,不要仅凭网站显示的出口地址反推某一条规则已生效。

怎样在更新订阅后保留自定义规则和 DNS 设置?

优先使用客户端提供的独立覆写、合并配置或扩展配置功能,不要直接编辑会被订阅更新替换的缓存文件。先确认合并顺序,以及列表字段是追加、前置还是整体替换;这些行为由客户端实现决定,不能假定所有软件一致。保存后查看最终运行配置,核对自定义规则的位置、策略组引用和 DNS 字段是否保留。更换客户端时应重新验证覆写机制,原客户端的脚本与扩展文件不一定能直接迁移。

电脑和手机可以共用同一条订阅吗?

是否允许共用取决于订阅提供方的设备数、并发连接与使用条款,客户端本身不能改变这些限制。即使地址相同,不同平台支持的协议、TUN 参数和覆写方式也可能不同。比较稳妥的做法是共用节点来源,把系统相关字段保存在各设备的本地覆写中。同步时仅传递必要配置,不把带有访问凭据的订阅地址放入公开仓库。出现一端可用、一端失败时,先比较内核能力与最终配置,再判断是否为设备限制。

允许局域网连接后,其他设备应如何设置?

先确认主机与目标设备处于可互通的局域网,并在主机客户端中启用允许局域网连接,核对监听地址与实际 HTTP 或混合代理端口。其他设备填写主机的局域网 IP,而不是 127.0.0.1;该地址在每台设备上都指向设备自身。主机防火墙只应按需允许可信局域网访问,必要时启用代理认证。不要将代理端口或控制接口映射到公网。主机休眠、地址变化或客户端退出后,其他设备也会失去该代理入口。

Clash DNS 泄漏应该怎样检查?

先明确预期:哪些域名应由哪组解析器处理,哪些连接应通过代理发出。测试网站列出的解析器可能是递归服务的出口,不能单凭所在地判断泄漏。结合客户端 DNS 日志、系统解析设置、浏览器安全 DNS 与 TUN 的 DNS 接管设置逐项核对。浏览器自带的加密解析可能绕开预设的内核 DNS 路径,也可能仍通过代理连接,需分别确认。每次只改变一个设置,并同时观察解析请求与目标连接的实际路由。

查阅规则语法 · 查阅 DNS 字段 · 查阅覆写与合并


DIAGNOSTICS

故障排查

先保留错误信息,再逐层缩小范围。一次只改变一个条件,测试结果才便于比较。

节点测速超时与网站打不开,应该按什么顺序排查?

先暂停代理,确认本地网络、系统时间和基础域名解析正常,再恢复客户端并检查配置是否成功载入。随后核对节点地址、端口、认证参数与协议支持,换一个已知可用节点和测试目标交叉验证。测速超时也可能由测试地址不可达或超时阈值过短造成,并不必然表示节点完全离线。若所有节点同时失败,优先查本机服务与网络;若仅单个节点失败,再联系提供方。保留错误类型和发生时间,比反复点击测速更有诊断价值。

系统代理已经开启,浏览器或终端为什么仍未生效?

先检查内核是否运行,以及系统代理记录的地址、端口是否与客户端监听值一致。再查看目标应用是否遵循系统代理:部分浏览器扩展会覆盖代理设置,终端工具则常需单独配置代理参数或环境变量。访问时若连接页完全没有新记录,问题通常发生在流量进入内核之前。若已有记录但出口不符,则检查规则与策略组。排查期间只保留一个程序管理系统代理,避免其他客户端、扩展或 VPN 在后台反复改写设置。

Windows UWP 应用无法连接,本地回环应该怎样处理?

部分 Windows 打包应用受网络隔离限制,无法直接访问回环地址上的代理,而普通桌面浏览器可能正常。先确认故障应用确实受此限制,再使用客户端提供的 UWP 回环工具,仅为需要的应用添加豁免,随后重启应用测试。不要直接为全部应用开放权限。系统自带的 CheckNetIsolation 工具也可用于查看与管理豁免,但操作前需确认准确的应用包标识。回环豁免只处理本地访问限制,不能修复节点、DNS 或远程服务故障。

日志提示端口占用,或退出客户端后无法联网怎么办?

端口占用时,先关闭其他代理客户端或残留的内核进程,再确认系统中哪个进程正在监听目标端口;不要直接结束身份不明的系统进程。也可在当前客户端中改用空闲端口,但需同步更新系统代理和手动配置的应用。退出后无法联网时,先到系统网络设置检查是否仍保留指向本地端口的手动代理。若曾启用 TUN,再检查相关服务和路由是否正常恢复。恢复网络后再启动单个客户端,避免多实例造成重复故障。

反馈问题时应提供什么信息,哪些内容需要隐藏?

建议提供操作系统、处理器架构、客户端名称、内核信息、当前模式、复现步骤,以及故障前后的一小段日志。说明问题影响全部连接还是特定应用,是否仅在 TUN、某个网络或某条规则下出现。提交前删除订阅完整地址、认证密码、访问令牌、节点账户和不必要的个人域名;截图也需检查地址栏和配置侧栏。优先制作去除敏感内容的最小配置,不要上传整个配置目录。日志中仍能识别身份的信息应进一步删减后再公开。

返回快速上手核对操作 · 查阅 YAML 配置字段参考