CLASH FAQ
Clash 常见问题与排查步骤
从客户端与内核的关系开始，逐步处理订阅导入、TUN 权限、系统代理、UWP 回环、节点超时和 YAML 配置错误。遇到问题时，先只改变一个设置，再观察日志和联网结果。
BASIC
基础认知
先分清客户端、内核、订阅与策略组，再决定使用规则模式、系统代理还是 TUN。理解这些边界，可以减少重复切换设置造成的干扰。
Clash、客户端和 mihomo 内核是什么关系？
mihomo 是负责读取配置、匹配规则和转发流量的内核；Clash Verge Rev、FlClash 等图形客户端负责订阅管理、开关设置和日志展示。安装桌面或移动客户端时通常已经包含可用内核，不需要普通用户另外启动命令行程序。
规则、全局和直连模式应该怎么选？
日常使用优先选择规则模式，流量会按照配置中的规则分别走代理或直连。全局模式会把大多数可接管流量交给当前策略组，适合临时验证节点；直连模式不使用代理，适合排查问题或暂时恢复本地网络。
策略组、节点和订阅有什么区别？
订阅是一份可更新的远程配置，里面可能包含节点、策略组和规则。节点描述具体的连接入口，策略组则决定从多个节点或动作中选择哪一个。切换策略组不会修改订阅地址，更新订阅也可能重置由配置提供方定义的组结构。
Clash for Windows 停止维护后还能继续使用吗？
已有安装可以继续运行，但停止维护意味着兼容性问题和已知缺陷不会持续修复。建议先导出或记下订阅地址，再迁移到仍在维护的客户端。不要直接覆盖原目录，先并行完成导入、节点选择和联网验证，再移除旧客户端。
系统代理和 TUN 模式有什么区别？
系统代理依赖应用主动读取操作系统的代理设置，浏览器和多数桌面应用通常支持。TUN 模式通过虚拟网卡在 IP 层接管更广泛的流量，能覆盖部分不读取系统代理的程序，但需要更高权限，也更容易受到防火墙、虚拟网卡和安全软件影响。
SETUP
安装配置
安装后的主线是导入有效配置、选择模式、启用一种流量接管方式并验证结果。权限与系统限制问题应在基础连接正常后单独处理。
第一次安装 Clash 客户端后应该做什么？
先从配置页导入有效订阅并完成更新，再回到代理页选择规则模式以及需要使用的策略组。随后开启系统代理，访问一个常用网站确认连接。只有确实需要接管游戏、命令行工具或特殊应用时，再配置 TUN 模式，避免一开始同时改变过多网络设置。
订阅链接导入失败或提示格式错误怎么办？
先在浏览器中打开订阅链接，确认它仍可访问且没有跳到登录页、验证页或普通网页。检查复制时是否带入空格、换行或末尾标点。如果返回内容存在但客户端仍报错，可能是订阅格式与当前内核不兼容，应向配置提供方获取 Clash 或 mihomo 格式的地址。
TUN 模式提示权限不足或无法启动怎么处理？
桌面系统先以管理员权限启动客户端，并确认虚拟网卡驱动或服务已经正确安装。macOS 还需要在系统设置中批准网络扩展。若仍失败，关闭其他 VPN、虚拟网卡和同类代理程序后重试，再从日志中查找 permission、service 或 interface 相关错误。
已经开启系统代理但浏览器仍然直连怎么办？
先确认客户端内核处于运行状态，并检查系统代理地址是否指向本机以及正确端口。关闭浏览器内单独设置的代理扩展或固定代理配置，然后完全退出并重新打开浏览器。企业策略、其他网络工具和残留的 PAC 设置也可能覆盖系统代理，需要逐项停用后验证。
Windows 应用商店应用无法联网，需要设置 UWP 回环吗？
部分 UWP 应用受到回环访问限制，无法连接运行在本机地址上的代理端口。可以使用客户端提供的 UWP 回环工具，为确实需要代理的应用启用回环豁免，保存后重新启动应用。不要一次勾选全部项目，按需设置更便于后续定位网络问题。
USAGE
使用技巧
订阅更新、规则覆写与策略组选择分别解决不同问题。调整之前先确认配置来源和当前模式，修改后通过日志核对实际命中结果。
订阅应该多久更新一次？
更新频率取决于配置提供方的变更节奏。遇到节点不可用、策略组缺失或规则长期未变化时，可以先手动更新一次。自动更新不宜设置得过于频繁，通常按客户端支持的小时级周期即可；更新后应查看是否成功，并确认当前策略组仍指向预期选项。
怎样添加 Clash 自定义规则？
优先使用客户端提供的覆写、合并或脚本功能，把自定义规则放在独立配置中，而不是直接修改每次更新都会被替换的订阅文件。规则按从上到下的顺序匹配，具体域名规则应放在宽泛规则之前。修改后先执行配置检查，再重载配置并观察日志命中结果。
自动选择策略组为什么没有选到预期节点？
自动选择通常依据配置中设定的测试地址、间隔和容差工作，不等同于任何场景下都选择最快节点。测试结果还会受到本地网络和目标站点影响。可以先手动选择稳定节点；需要长期调整时，再修改策略组的测试参数或使用配置覆写保留设置。
开启 TUN 后还需要同时开启系统代理吗？
多数情况下，正确工作的 TUN 模式已经能够接管主要流量，不必依赖系统代理。是否同时开启取决于客户端实现和使用场景。排查故障时建议一次只启用一种接管方式：先验证系统代理，再单独验证 TUN，这样更容易判断问题来自应用代理设置还是虚拟网卡。
日志级别应该选择 debug、info 还是 warning？
日常使用选择 info 通常足够，warning 适合只关注异常。debug 会记录更细的匹配与连接过程，适合短时间排查规则、DNS 或连接问题，但内容增长较快。复现问题前切到 debug，记录关键时间点，完成排查后再恢复 info，便于阅读后续日志。
TROUBLESHOOTING
故障排查
先判断问题属于基础网络、配置、节点还是流量接管。恢复到最小可运行状态，再逐步加入系统代理、TUN 和自定义规则，通常比同时改动多项设置更快。
所有节点都显示超时应该从哪里排查？
先确认本机直连网络正常，再更新订阅并检查系统时间是否准确。随后关闭 TUN 和系统代理，仅在客户端内执行节点测试。如果全部超时，检查防火墙、DNS、配置有效期和网络环境；如果只有部分节点超时，通常是对应线路状态问题，可先切换其他节点。
关闭或退出客户端后电脑无法联网怎么办？
常见原因是系统代理没有随客户端退出而恢复。进入操作系统网络设置，关闭手动代理和不再使用的自动代理脚本，然后重新打开网络连接。若此前启用了 TUN，确认虚拟网卡和相关服务已经停止；必要时重启系统，以清理残留路由和 DNS 状态。
启动时提示端口被占用怎么处理？
先退出其他代理客户端，并检查旧的 Clash 或 mihomo 进程是否仍在后台运行。若端口仍被占用，可以在配置中更换 mixed-port、port 或 socks-port，但要同步更新系统代理所使用的端口。不要让两个程序同时监听同一个本地地址和端口。
配置文件提示 YAML 解析错误怎么定位？
先根据错误信息中的行号查看附近内容，重点检查缩进、冒号后的空格、列表短横线和引号是否成对。YAML 通常使用空格缩进，不应混入制表符。可以暂时撤回最近添加的规则或覆写段，确认基础配置能加载后，再分段恢复修改以定位问题。
Android 客户端切到后台后连接中断怎么办？
在系统应用设置中允许客户端后台运行，并把电池策略调整为不受限制或允许后台活动。确认 VPN 权限仍然有效，状态栏中的 VPN 标识没有消失。部分系统会主动清理后台服务，还需要在自启动或后台保护列表中允许该客户端，并避免同时运行其他 VPN 应用。