帮助中心 / 操作与排查
Clash 常见问题
与故障排查
先确认配置已启用，再检查流量入口，最后查看规则与日志。按问题所在环节展开答案，每次只改一项设置。
概念与选择
基础认知
分清客户端、内核与流量入口，再选择适合的工作方式。
Clash 客户端、mihomo 内核和订阅分别负责什么？
先在客户端的配置页导入订阅，再启用配置并选择策略组。客户端提供窗口、菜单栏与系统集成；mihomo 内核负责接收连接、解析 DNS、匹配规则及转发流量；订阅则提供服务器参数，有时还包含策略组与规则。安装客户端本身不会生成可用的代理服务。排查时先区分是窗口设置问题、内核启动问题，还是订阅内容问题，避免把三者混在一起反复重装。
规则、全局、直连模式应该怎样选？
日常使用先选规则模式，再到连接页检查实际命中的规则与出口。规则模式按配置逐条决定直连或代理；全局模式把进入内核的连接交给全局策略，仍需选择可用出口；直连模式则直接连接目标。全局模式适合短时对照测试，不能替代应用流量接管。如果应用根本没有进入内核，切换模式也不会改变结果。测试结束后切回规则模式，并重新建立连接，避免旧连接干扰判断。
系统代理与 TUN 模式有什么区别，需要一起开启吗？
浏览器等遵循系统代理设置的应用，先用系统代理即可；需要接管不读取系统代理的应用或部分 UDP 流量时，再考虑 TUN。系统代理修改操作系统的代理入口，TUN 通过虚拟网络接口和路由接收流量，并需要相应权限。两者同时启用的效果取决于客户端实现与路由设置。排查时一次只验证一种入口，确认连接记录出现后再调整组合，同时留意其他 VPN 是否正在接管默认路由。
下载 Clash 时，怎样确认芯片和客户端兼容性？
macOS 打开苹果菜单中的关于本机，看到 Apple 芯片时选 Apple 芯片安装包，看到 Intel 处理器时选 Intel 安装包。Windows 在设置的系统信息中查看系统类型，Android 按设备架构与客户端要求选包。下载页的客户端说明和发布方要求应一起核对，尤其注意最低系统版本。mihomo 内核包主要面向命令行、服务器和路由器场景；需要图形界面时，选择带窗口与配置管理功能的客户端。
导入与授权
安装配置
沿着订阅导入、配置加载、权限授权和端口监听逐项检查。
订阅链接应在哪里粘贴，本地 YAML 又怎样导入？
打开客户端的配置页，选择新建或导入配置，将完整订阅 URL 粘贴到链接输入框，下载成功后把该配置设为当前使用项。本地文件则选择文件导入，或在客户端支持时拖入 config.yaml。导入后先看配置名称与错误提示，再到代理页选择策略组。不同客户端的按钮名称可能略有差异，但导入、启用配置、选择出口这三个动作需要依次完成。订阅 URL 中的访问凭据应完整保留，也不要把它贴到公开讨论区。
导入订阅提示格式错误或 YAML 解析失败，怎么处理？
先查看错误提示是否带行号，再确认下载到的是 Clash 或 mihomo 可识别的 YAML，而不是登录页、错误网页或其他客户端专用格式。YAML 缩进使用空格，同级字段应对齐；手工编辑时尤其注意冒号后的空格与列表层级。普通 Base64 节点集合不一定能直接作为完整配置启用，应向服务提供方取得匹配的订阅格式。保留原文件副本后再修改，修正后重新加载配置；不要把含凭据的完整配置交给陌生转换网站。
TUN 提示权限不足、服务未安装或虚拟网卡创建失败怎么办？
先关闭 TUN，在客户端设置中找到服务模式、辅助服务或权限安装入口，按提示完成系统授权，再重新开启 TUN。Windows 通常需要安装并启动具有管理员权限的后台服务；macOS 可能需要授权特权辅助程序，具体以客户端提示为准。若仍失败，查看日志中的权限、设备或路由错误，并暂时退出其他 VPN 后重试。不要仅为解决权限提示而长期以高权限运行所有应用；受单位管理的设备应先确认网络与安全策略允许相关操作。
Clash 端口冲突，或者终端没有走代理，该改哪里？
先在客户端设置中确认实际监听的 mixed-port，以及监听地址是否为本机回环地址。提示端口占用时，退出另一个代理进程，或把监听端口改为空闲端口，再同步修改使用该端口的应用。终端工具可能不读取系统代理，可用 curl -x http://127.0.0.1:7890 https://example.com 做一次显式代理测试，其中端口应替换为当前实际值。需要环境变量时只在所需终端会话设置，结束测试后清除；不要为了本机访问而随意开放局域网监听。
策略与验证
使用技巧
把自定义设置放在可保留的位置，用连接记录验证实际效果。
策略组里的 select、url-test 和 fallback 怎样使用？
先看策略组类型，再决定是手动选择还是等待自动检测。select 保留手动选择结果，适合固定出口；url-test 按配置的探测地址与检测周期选择候选项；fallback 则按顺序选择检测可用的候选项，更侧重故障切换。探测结果只反映对指定测试地址的连通情况，不能代表所有业务。遇到某个网站打不开时，先手动固定一个出口做对照，再检查规则命中的策略组，避免自动切换使测试条件不断变化。
自定义规则为什么会在订阅更新后消失？
先到客户端的覆写、合并配置或扩展规则入口保存自定义项，而不是直接编辑每次都会重新下载的订阅文件。订阅更新通常会替换远程内容，客户端是否保留本地修改取决于具体实现。需要优先匹配的自定义规则一般应放在相关通用规则之前，并确认引用的策略组名称真实存在。保存后查看最终生效配置，再在连接页验证命中结果。更换客户端时，覆写入口与合并语法可能不同，应按新客户端的说明迁移。
怎样确认某个网站走了代理，而不是只看开关状态？
打开客户端的连接页，重新访问目标网站，找到对应域名或目标地址，查看命中规则、策略组与最终出口。看不到新记录时，先检查系统代理或 TUN 的接管入口，而不是继续改分流规则。修改规则后应关闭目标应用的旧连接再测试，因为已建立的连接通常不会立刻改道。浏览器缓存、应用内置代理以及加密 DNS 都可能影响观察结果；必要时使用单独的测试请求，并结合 DNS 日志判断域名是否被正确识别。
Fake-IP 导致局域网设备或特定应用异常，怎样排除？
先确认异常只发生在 Fake-IP 模式，再根据日志找到受影响的实际域名，将确有需要的域名加入 fake-ip-filter，保存后重新加载配置并重建应用连接。过滤规则的行为还受 fake-ip-filter-mode 等设置影响，应结合当前配置检查。局域网设备也要确认私有地址路由与直连规则是否正确。切换 DNS 模式后可能残留旧解析缓存，可重启相关应用并刷新系统 DNS；不要直接把大量公共域名全部排除，否则会改变域名识别与分流效果。
错误与恢复
故障排查
先保留可用配置与错误记录，再判断故障发生在哪一层。
订阅突然失效、更新失败或返回 401、403，怎样定位？
先检查设备时间、网络连通性与服务提供方账户状态，再看更新日志里的 HTTP 状态和错误内容。401 常与凭据缺失或失效有关；403 还可能涉及访问限制，具体原因应以提供方说明为准。超时则需要区分订阅地址本身不可达，还是当前代理路径影响下载。若客户端支持选择更新所用的网络路径，可分别测试直连与代理。保留最后可用配置，不要先删除全部内容；分享日志前遮盖订阅 URL、访问凭据和服务器认证信息。
节点检测超时，但其他网络功能正常，下一步查什么？
先固定一个候选出口，查看日志是 DNS 解析失败、连接拒绝、握手失败还是单纯超时，再尝试不同网络作对照。客户端的检测地址不可达时，也可能出现检测失败而部分业务可用的情况，因此需要同时测试实际目标网站。确认订阅仍有效、设备时间正确，并检查安全软件与防火墙是否拦截内核进程。如果所有候选项在同一网络都失败，应先排查本机和网络路径；只有个别候选项失败时，再向服务提供方反馈脱敏后的错误时间与日志。
系统代理已开启，浏览器仍然直连，退出后又无法联网怎么办？
先核对操作系统当前网络连接的代理设置，确认地址和端口对应正在运行的客户端，再检查浏览器是否有扩展或独立代理设置覆盖系统值。使用显式代理请求能够成功而浏览器没有连接记录时，优先查应用入口。退出客户端后无法联网，常见原因是系统仍保留指向已停止监听端口的代理设置，可在系统网络设置中关闭残留代理再重试。macOS 要检查正在使用的网络服务，Windows 要区分用户代理与 WinHTTP 设置，避免修改不相关的入口。
Windows 的 UWP 应用无法使用本机代理，怎样处理回环限制？
先确认受影响应用确实运行在 AppContainer 中，并且使用指向本机回环地址的系统代理。若客户端提供 UWP 回环豁免工具，可在授权后只勾选需要访问代理的应用，再完全退出并重开该应用。也可用管理员终端中的 CheckNetIsolation LoopbackExempt -s 查看已有豁免，添加时需要准确的包系列名称。回环豁免只解决应用访问本机代理的限制，不能修复订阅或 DNS 故障；TUN 是另一种接管路径，也应单独验证，单位设备需遵循管理策略。