适合桌面办公与需要图形化设置的用户。下载前到系统「关于」确认设备信息，并在安装后检查服务模式与系统代理。
Clash Plus、Clash Verge Rev 等客户端的入口集中在同一平台页。遇到窗口闪退，先记录报错，再检查运行环境与端口占用；反复覆盖安装通常不能说明故障原因。首次测试只开启一个代理客户端，避免多个程序相互修改系统代理。
前往下载Clash 配置文件与常用功能
从一个设置项开始，分清订阅、内核与系统网络各自负责什么。
网页能打开，某个应用却一直连接失败，通常需要先确认该应用的流量是否进入客户端。订阅能导入，但启用时报错，则应先检查配置字段与内核支持。下面按五类功能整理操作入口；示例只展示局部配置，不能代替包含代理与策略组的完整文件。
规则分流
按目标匹配，不必反复切全局
需要让内网地址直连、其他请求按策略处理时，先将代理模式设为「规则」。内核从上到下检查规则，命中第一条后停止，因此具体域名应放在宽泛规则之前，MATCH 放在末尾。与仅靠全局开关的做法相比，规则能保留不同业务的出站路径。修改后到「连接」查看命中的规则与策略；若订阅更新会覆盖本地改动，优先使用客户端的覆写功能保存自定义内容。
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT此片段只演示语法，三条规则均直连；实际代理策略需引用配置中已有的策略组。
查看规则顺序与 MATCH 说明 →mihomo 内核
先核对内核，再判断字段支持
配置提示不支持协议或出现 unknown field 时，先查看客户端使用的内核。mihomo 延续 Clash Meta 项目，扩展了协议、规则集与流量嗅探等能力；桌面窗口只是操作入口，不代表所有客户端都支持同一套字段。与原版内核配置相比，迁移时需要逐项核对增强字段，而不是只更换文件名。先运行最小可用配置，再逐步启用扩展功能，可以缩小报错范围，也便于恢复。
mode: rule
log-level: info
ipv6: false基础字段示例。是否需要 IPv6，应结合当前网络与订阅情况判断。
查看 mihomo 与原版内核差异 →订阅管理
区分下载成功与配置启用成功
导入链接后，先确认订阅卡片已经出现，再选中它作为当前配置。列表里能看到订阅，不等于内核已经加载；还应检查日志是否存在解析错误。与直接编辑下载文件相比，客户端覆写更适合保留端口、规则等本地设置，避免更新后丢失。遇到更新失败，先核对链接有效期、返回内容与拉取路径，再判断是否需要通过代理更新。订阅地址可能包含访问凭据，不要将完整链接发到公开讨论区。
profile:
store-selected: true
store-fake-ip: true此设置用于保存策略选择与 Fake-IP 映射，不负责下载订阅，也不包含订阅地址。
查看订阅导入操作 →TUN 模式
处理不遵循系统代理的应用
浏览器正常，终端或其他应用却无法连接时，可先检查应用是否支持手动代理。系统代理只影响遵循相关设置的程序，TUN 则通过虚拟网络接口接管符合路由条件的流量。启用前确认客户端的服务模式或管理员权限，并暂停其他 VPN，避免路由冲突。它不是连接故障的通用修复开关：如果节点本身不可用，启用后仍会失败。修改后同时检查 DNS、连接记录与局域网访问。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: truemihomo 局部配置示例，实际权限与 DNS 接管方式由平台和客户端决定。
查看 TUN 与系统代理排查 →跨平台配置
复用规则，单独处理系统设置
同一份订阅在电脑可用、手机却加载失败时，不要直接认定链接失效。先比较两端内核、协议支持与配置格式，再检查本地文件路径等平台相关字段。规则和策略组通常更容易复用，TUN、系统代理与启动服务则需要按设备配置。与复制整个客户端数据目录相比，迁移订阅并重新设置本地选项更容易排错。注意 YAML 缩进使用空格；导入后先验证基础访问，再恢复自定义规则。
mixed-port: 7897
allow-lan: false
mode: rule
log-level: info端口仅作示例，客户端实际监听端口可能由界面设置覆盖。
查看配置迁移与连接验证 →Clash 全平台下载入口
先看操作系统与处理器架构，再选客户端。
Clash 是一个客户端生态，不是所有设备都安装同一个程序。下载页按系统列出可选客户端，并标明推荐项与停止维护的归档项目。首次使用可从 Clash Plus 开始；已经熟悉某个客户端的用户，可按配置兼容性继续选择。安装客户端并不会自动生成订阅，连接所需的配置应由你有权使用的服务提供。
先在苹果菜单「关于本机」确认是 Apple Silicon 还是 Intel，再下载对应架构的安装包，避免装错后无法启动。
Clash Plus、Clash Verge Rev 与 FlClash 提供不同操作界面。首次打开时按系统提示完成授权，涉及网络扩展或辅助服务时先阅读说明。若浏览器仍使用旧代理，检查系统网络设置，而不是同时打开多个客户端。迁移配置时也要重新确认本地路径。
前往下载手机与平板用户先确认处理器架构，再选择适配包。首次建立连接时，系统会要求确认 VPN 连接授权。
Clash Plus、Clash Meta for Android、FlClash 与 Surfboard 的配置支持存在差别，不能只凭文件扩展名判断兼容。若熄屏后断开，检查电池优化、后台运行权限与网络切换记录。应用分流还可能决定哪些程序进入代理，应结合当前客户端的设置检查。
前往下载iPhone 与 iPad 用户可在下载页进入 Clash Plus 的 App Store 页面，安装后按应用提示添加配置并授权 VPN。
首次使用前核对商店页面的系统要求，再确认订阅格式是否受支持。Clash Plus 官网为 clashplus.io，可用于查阅产品信息。若切换网络后出现连接异常，先看应用状态与系统 VPN 状态是否一致，再重新测试，避免同时修改订阅、DNS 和路由。
前往下载桌面用户按发行版选择适合的包格式。下载页提供 Clash Verge Rev 与 FlClash，使用前确认桌面环境和所需依赖。
服务器或路由器用户可另行查看内核区，但命令行内核不包含图形界面，也不会自动替所有进程设置代理。终端程序可能需要单独指定代理参数。使用服务托管时，留意运行用户、工作目录与配置读取权限；先在前台确认启动成功，再设置后台运行。
前往下载Linux 企鹅图形：Font Awesome，CC BY 4.0。
安装前后常见问题
先判断问题发生在安装、配置加载还是实际请求阶段。同一条排查路径只改一个设置，测试后记录结果，比同时切换所有开关更容易找到原因。
安装完成后，为什么仍然不能上网？
先确认原有网络在关闭代理时可以访问，再检查客户端是否已经选中并成功加载订阅。接着确认代理模式、策略组选择与系统代理状态。如果只有某个应用失败，查看它是否遵循系统代理；若所有请求都失败，再到日志定位具体错误。不要把安装完成等同于连接建立，安装包、订阅配置和可用出站是不同环节。具体操作见订阅配置教程。
Clash 订阅更新失败，需要重新安装吗？
通常先检查链接是否过期、是否复制完整，以及服务端返回的是配置还是网页。能下载但不能加载时，应转向检查配置格式与协议支持。重装不能修复失效的订阅链接；保留当前可用配置，记录更新时的错误，再按照故障排查说明区分网络请求与解析失败。
系统代理和 TUN 模式应该同时开启吗？
不必把同时开启当作默认要求。先用系统代理验证浏览器访问；需要接管其他应用时，再根据客户端说明启用 TUN。两者处理流量的入口不同，是否组合使用取决于平台实现与实际需求。启用 TUN 后要检查路由、DNS 和其他 VPN 是否冲突，不能只看开关显示。可从基础设置步骤逐项验证。
开机自启后，为什么代理没有自动恢复？
开机自启通常只决定客户端是否启动，不保证订阅加载、服务启动与系统代理恢复都成功。先登录系统，查看客户端状态与日志，再检查启动项是否被系统阻止。涉及 TUN 时还要确认服务运行情况。先手动完成一次正常连接，再排查自动启动链路，避免把订阅错误与启动权限问题混在一起。设置入口见客户端使用教程。
项目来源与维护边界
Clash、Clash Meta 与 mihomo 的关系
区分客户端界面、代理内核和订阅来源，再判断该更新哪一部分。
本站整理安装入口与中文操作资料，不是所有客户端的开发者，也不提供代理节点。下载与故障说明需要结合上游项目和设备环境使用。遇到不支持的字段、无法启动的服务或订阅返回错误时，先确定负责这一环节的组件，才有明确的处理方向。
项目历史：名称相近，维护路径不同
原版 Clash 形成了以 YAML 配置、策略组与规则分流为核心的使用方式。此后出现多个衍生内核与图形客户端。mihomo 延续 Clash Meta 的开发路线，因此旧教程中的 Clash Meta 与当前文档中的 mihomo 往往指向同一条演进脉络，但具体字段仍要以正在使用的内核文档为准。
一些旧客户端已经停止维护，安装入口会保留归档标识。归档程序能启动，不代表能处理新协议或适配新的系统环境。新装设备优先考虑仍在维护的客户端；旧设备迁移时先备份配置，再验证协议与规则兼容性，不要仅按熟悉的名称选择。
开源生态：从源码与文档核对行为
mihomo 的源码、问题讨论与发布记录可在公开仓库查阅，项目采用 GPL-3.0 许可证。公开代码可以帮助理解配置与运行行为，但并不意味着不同图形客户端有完全相同的菜单、授权方式或更新节奏。客户端本身的许可证与使用说明，应分别查看对应项目。
遇到疑似缺陷时，先保存能够复现问题的最小配置、系统信息与相关日志。分享前移除订阅地址、认证信息和其他私人数据。清晰的复现步骤比只描述「连接失败」更有助于讨论，也能避免把服务端故障误报为客户端缺陷。
内核关系：界面负责操作，内核执行配置
Clash Verge Rev、FlClash 等图形客户端提供订阅管理、开关与日志窗口，内核负责解析配置、匹配规则和建立出站连接。客户端可能对配置做合并或覆写，因此编辑本地文件后，需要确认最终生效内容，而不能只看原始订阅中的某一行。
如果界面显示已连接，但请求仍然失败，应查看连接记录是否出现目标请求、命中了哪条规则、最终使用什么策略。若请求根本没有进入内核，就先查系统代理或 TUN 路由；若已经进入，再检查 DNS 与出站错误。这能把排查范围缩小到具体链路。
更新机制：安装包与订阅分别维护
客户端更新通常涉及界面、系统集成与内核能力，订阅更新则改变配置中的代理、策略或规则来源。两者不是同一操作。订阅刷新成功并不代表客户端已更新，安装新客户端也不会使失效订阅恢复可用。更新前先阅读说明，并保留一份可用配置。
升级后先验证基本网页访问、局域网访问与常用应用，再恢复复杂覆写。出现新问题时，记录改动前后的行为，必要时回到已知可用设置。长期使用建议保留简短的修改记录，特别是 DNS、TUN 与自定义规则，避免多次更新后无法还原原有逻辑。
查看 mihomo 上游源码
下面的命令只用于获取源码，不会安装客户端，也不会自动启用代理。普通用户可直接使用上方安装入口；需要研究配置实现或提交问题时，再查阅仓库文档。
打开 MetaCubeX / mihomo 仓库 →git clone https://github.com/MetaCubeX/mihomo.git需先安装 Git；复制后在终端执行。
Clash 排障与规则相关文章
按症状找入口，保留报错原文再继续排查。
日志、规则与启动故障属于不同问题链路。客户端无法启动时，先解决运行环境；窗口可以打开但访问失败时，再检查配置和请求日志；只有某些网站走错路径时，优先核对规则顺序。下列文章分别展开说明，便于在完成基础配置后继续查阅，而不是每次都从重装开始。
Clash Verge 打开就闪退：启动崩溃的排查顺序与修复办法
双击后窗口一闪即关，或卡在启动界面无响应？本文按排查顺序依次检查 WebView2 运行库、端口占用、损坏的配置文件、服务模式残留和杀毒拦截，并给出各平台的清理重装步骤。
查看启动崩溃处理 →Clash 规则写法详解：DOMAIN-SUFFIX、IP-CIDR 匹配顺序与 MATCH 兜底
规则按书写顺序自上而下匹配，命中第一条即停止。本文拆解 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、IP-CIDR、GEOIP、MATCH 的语法，并说明 no-resolve 的作用与规则排序原则。
查看自定义规则说明 →mihomo 内核与原版 Clash 有何不同：协议支持、规则集与配置字段对照
mihomo（原 Clash Meta）在原版内核基础上扩展了 VLESS、Hysteria2、TUIC 等协议，并增加 rule-providers 增强写法和 sniffer 等字段。本文逐项对照两者差异，并整理迁移配置时的注意事项。
查看内核与字段对照 →