Windows
适合桌面浏览器、开发工具与日常办公。可从 Clash Plus、Clash Verge Rev 或 FlClash 开始，安装前在系统信息中确认架构。系统代理适合遵循代理设置的应用；需要接管更多应用时，再查阅 TUN 的服务与权限要求。
安装后先导入配置并选择代理组，确认本地监听端口，再开启系统代理。若同时运行其他网络工具，应检查是否存在相同端口占用，避免多个程序反复改写系统设置。
客户端入口 / 按设备选择
Clash 全平台客户端
先确认操作系统与处理器架构，再选择客户端。图形客户端负责配置管理、系统代理与日志查看，内核负责协议连接和分流执行；两者不是同一个安装包。第一次使用建议从图形客户端开始，服务器和路由器部署再考虑独立内核。
macOS
按 Apple Silicon 与 Intel 区分安装包。Clash Plus、Clash Verge Rev 和 FlClash 提供图形操作入口，归档客户端则需要额外留意系统兼容性。拖入应用程序目录后，按系统提示授予客户端所需权限。
菜单栏的连接状态与系统代理开关应分别确认。退出客户端前恢复代理设置，可减少浏览器继续连接已关闭本地端口的情况；启用虚拟网卡时，还要检查相应后台服务是否正常运行。
Android
手机和平板可比较 Clash Plus、Clash Meta for Android、FlClash 与 Surfboard 的配置支持范围。安装包需要匹配设备架构，配置格式也应与客户端对应，不能仅凭订阅链接能够导入就认定所有字段均已生效。
首次启动连接会出现系统 VPN 授权提示。后台省电限制可能影响持续连接，可按设备设置允许必要的后台活动。通常同一时间只能由一个应用占用系统 VPN 通道，切换工具前先停止现有连接。
iOS
通过 App Store 查看 Clash Plus，客户端官网为 clashplus.io。导入配置后，按系统提示添加 VPN 配置，再在客户端内选择策略。安装应用、导入订阅与启动连接是三个独立步骤。
桌面配置中的文件路径、外部控制接口与虚拟网卡参数不一定适用于移动系统。迁移配置时先核对支持字段，保留必要的代理与规则部分，再使用客户端提供的连接记录确认实际出口。
Linux
桌面环境可选择 Clash Verge Rev 或 FlClash，并按发行版的软件包格式安装。服务器、容器或路由器可直接运行 mihomo，但需要自行处理配置路径、进程管理、服务权限和网络路由。
安装包格式与处理器架构需要同时匹配。独立内核不会自动提供完整桌面界面，也不等同于已启用系统代理；应先检查日志与监听地址，再按应用或系统的要求配置代理入口。
客户端名称相近，不代表维护状态、内核能力和订阅格式相同。下载页按平台列出可选项目、安装包类型及系统要求；协议能力和内核家族的差异则集中在协议手册中，便于先选界面，再核对功能。
查看全部客户端 →config.yaml / 配置块索引
代理组、规则与网络设置
配置文件把节点来源、策略选择、规则匹配和流量接管分成不同层。遇到问题时先确定属于哪一层，再修改对应字段。以下片段用于理解结构，不是包含订阅与远端节点的完整配置；使用前应核对当前客户端和内核支持范围。
把出口选择与分流规则分开
代理组把多个出口组织为一个可被规则引用的名称。手动选择组使用 select，自动检测类策略则需要对应的探测参数。规则写组名，客户端界面决定组内实际选项，因此切换出口时通常不用重写规则。下面以直连作为最小示例；加入远端节点后，节点名必须真实存在。订阅更新后若原选项被删除，应重新检查组内选择，而不是只确认更新成功。
proxy-groups:
- name: 节点选择
type: select
proxies:
- DIRECT让规则内容独立于主配置维护
规则提供器将匹配条目放在单独文件中，主配置通过 RULE-SET 引用。规则文件的内容格式必须与 behavior 对应，域名列表不能直接当作经典规则列表使用。下面展示本地域名规则集的声明，路径相对内核工作目录解析；实际使用还需要准备文件并添加引用规则。与直接堆叠 rules 相比，这种方式更便于分组维护，但必须同时检查来源、格式和引用名称。
rule-providers:
local-domains:
type: file
behavior: domain
path: ./rules/local-domains.yaml区分解析失败与代理连接失败
DNS 设置负责域名到地址的解析，不直接决定代理组里的出口。启用 fake-ip 后，内核可以借助映射记录处理域名流量，但部分应用可能需要额外兼容设置。下面只展示基础解析结构，不能替代完整的解析路由设计。网页打不开时，应先查看解析日志，再检查上游解析器的可达性；把所有问题归结为节点故障，容易忽略本地 DNS 接管或缓存造成的差异。
dns:
enable: true
enhanced-mode: fake-ip
nameserver:
- 1.1.1.1接管不遵循系统代理的应用
TUN 通过虚拟网卡与系统路由接收流量，覆盖范围不同于浏览器使用的系统代理。开启前应确认客户端已安装必要服务，并具有创建网卡和修改路由的权限。下面是 mihomo 常用字段的结构示例，实际效果仍取决于操作系统与客户端实现。初次配置建议先验证系统代理，再单独启用 TUN；同时改变 DNS、路由和代理模式，会增加定位问题的难度。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true读取配置时先看缩进和字段所属层级，再看具体取值。YAML 中同名字段重复、列表层级错误或引用名称不一致，都可能让配置无法载入。客户端能成功打开文件，只说明通过了相应阶段的处理，不代表每条规则都符合预期；仍应通过连接记录查看命中规则与最终策略。
从订阅导入开始阅读 →开源生态 / 来源与边界
Clash 与 mihomo 内核关系
判断客户端是否适合使用，重点是项目维护状态、实际搭载的内核，以及配置与协议的支持范围。本站是资源整理与文档站，不代表各客户端开发团队，也不提供远端代理服务。应用、内核、配置来源需要分别识别，不能用一个项目的名称替代全部生态。
项目历史与维护状态
Clash 建立了以 YAML 描述代理、策略组和分流规则的配置方式，随后出现了面向不同系统的图形客户端。原版项目停止更新后，旧安装包仍可能运行，但运行成功不等于持续获得协议适配和问题修复。选择客户端时，优先查看仍有维护的项目及其发行说明；保留旧客户端应当有明确的兼容需求，而不是只因名称熟悉。
维护状态也不应仅凭界面样式判断。界面调整、内核升级与系统兼容修复属于不同工作，某次发布可能只更新其中一项。遇到升级后行为变化，先记录客户端名称、所用内核和具体设置，再对照项目说明缩小范围，比直接替换整套配置更容易复现问题。
图形客户端与内核分工
mihomo 延续了 Clash Meta 的发展路线，承担协议处理、规则匹配、DNS 和网络栈等核心能力。图形客户端在其上提供订阅管理、策略选择、系统服务和日志界面。两个客户端即使使用相同内核，也可能有不同的配置合并方式、默认选项与权限管理流程，因此不能把一款客户端的菜单路径原样套用到另一款。
选择协议前，应同时核对服务端要求与客户端内核支持。配置中写入某个协议名称，并不会为旧内核自动增加能力；TLS、UDP 与传输层设置也需要两端匹配。协议手册按设计取舍解释常见协议与内核差异，适合在更换客户端或迁移订阅之前查阅。
订阅、节点与规则的来源
订阅链接用于取得配置或节点信息，不是客户端本身。配置可能同时包含代理组、远程规则和解析设置，也可能只有节点列表；导入后应先确认其格式，再决定是否需要补充策略。对于来源不明的 Clash 免费节点或公开配置，应审视其服务提供方与配置内容，不应把导入成功视为服务可靠性的证明。
Clash 机场订阅通常带有独立的访问地址，地址中的参数可能关联账户权限。分享问题截图或提交日志前，移除订阅地址、身份参数与节点凭据。排查时保留错误类型、相关字段名和必要的网络环境信息即可，避免把完整私人配置放进公开讨论。
更新机制与迁移顺序
应用更新、内核更新、订阅更新和规则数据更新相互独立。订阅刷新不会自动更新应用，更新应用也不代表节点列表已经刷新。Clash GeoIP 更新影响相关地理规则的数据来源，而不是所有域名规则；是否生效仍要看配置使用的数据格式、文件位置与规则类型。
迁移前保留可用配置，记录代理端口、选中的代理组和接管方式。完成应用升级后，先以原有模式验证连接，再逐项恢复自定义 DNS、规则覆盖或 TUN 设置。Clash 节点延迟测试只反映指定测试目标和测试方式下的响应，不能单独代表视频传输、下载速度或全部站点的可用性。
首次使用的验证顺序
先完成安装与订阅导入，确认配置可以载入；再检查代理组内是否存在可用出口，并切换到规则模式。随后核对系统代理设置或移动端 VPN 授权，打开一个明确的测试目标，查看连接记录中的规则与策略。如果应用显示已连接却无法访问，应先区分解析、规则、出口和本地接管环节，而不是同时更改所有开关。
系统代理与 TUN 也不是必须同时开启。只需让浏览器与遵循代理设置的应用使用代理时，可先从系统代理验证；应用自行建立连接且不读取系统设置时，再考虑虚拟网卡方案。关闭客户端后若浏览器异常，检查系统是否还保留本地代理地址。完整操作路径见Clash 使用教程，复杂协议与内核兼容问题见协议手册。
技术笔记 / 最近整理
部署与连接配置笔记
围绕具体使用场景记录配置路径、权限要求与检查顺序。先按教程完成基础连接，再根据实际问题阅读对应笔记；路由器部署与虚拟网卡接管涉及系统网络设置，应保留修改前的状态，便于逐项验证和恢复。
Clash TUN 模式详解：虚拟网卡接管全局流量的原理与各平台开启方法
从虚拟网卡与系统路由表讲起，说明 TUN 模式与系统代理的区别、stack 选项含义，以及在 Windows、macOS、Android 上开启 TUN 的步骤和权限要求。
阅读笔记 →OpenWrt 路由器与旁路由运行 mihomo 内核：部署方式与硬件资源概览
概览在路由器或旁路由上直接运行 mihomo 内核的几种方式，对比主路由与旁路由的网络拓扑，说明架构选择、内存需求与网关设置要点。
阅读笔记 →Clash 订阅链接更新失败的常见原因与自动更新间隔设置方法
解析订阅更新报错的几类根源：链接失效、格式不兼容、更新请求走错代理，并说明各客户端中自动更新间隔与更新时是否经代理的设置位置。
阅读笔记 →