DESKTOP / 01
Windows
适合日常桌面环境。下载前先在“设置 → 系统 → 系统信息”确认 x64 架构，再从 Clash Plus、Clash Verge Rev、FlClash 等图形客户端中选择。安装完成后，需要在配置页导入订阅，并单独开启系统代理或 TUN 模式，客户端处于运行状态并不等于流量已经接管。
前往下载SUBSCRIPTION CONFIG MANUAL
Clash订阅教程
客户端配置与订阅导入
按设备选择客户端，依次完成订阅链接导入、策略组检查与流量接管。每一步都对应客户端中的实际入口和可核对状态。
配置链路可检查
永久免费
代码开源
多平台客户端
中文操作文档
订阅地址只负责交付配置。导入后仍需确认当前配置、策略组、代理模式和系统接管状态。遇到连接问题时，按这条链路逐段检查，比反复重装客户端更容易定位原因。
PLATFORM OUTPUT
按设备进入客户端下载页
先确认操作系统，再选择仍在维护且适合当前设备架构的客户端。首页入口只负责切换到对应平台，安装包、系统要求和客户端差异统一在下载页核对。
DESKTOP / 02
macOS
先通过“关于本机”区分 Apple 芯片和 Intel 处理器，两类安装包不能混用。首次启动时，系统可能要求确认应用打开、网络扩展或管理员权限。订阅导入成功后，先使用系统代理验证浏览器流量，再根据终端、开发工具和其他应用的覆盖需求决定是否启用 TUN。
前往下载MOBILE / 03
Android
多数近年设备可使用 ARM64 安装包；无法确认架构时，可在下载页查看通用包和其他架构说明。Android 客户端通常通过系统 VPN 接口接管流量，首次连接会出现 VPN 授权提示。导入订阅后应检查当前配置、策略组选择和后台运行权限，避免系统省电策略提前结束连接。
前往下载MOBILE / 04
iOS
iPhone 与 iPad 通过 App Store 安装 Clash Plus。导入订阅时可复制完整链接后在应用内添加，也可使用提供方给出的跳转入口。首次连接需要允许添加 VPN 配置。若配置已更新但策略没有变化，应返回应用确认当前使用的配置文件和策略组，而不是只查看系统状态栏中的 VPN 标记。
前往下载DESKTOP / 05
Linux
桌面环境可选择 Clash Verge Rev 或 FlClash，服务器、软路由和自动化环境则更适合直接运行 Mihomo 内核。使用图形客户端时仍要确认软件包格式与发行版匹配；使用内核时还需自行管理配置文件路径、启动参数、服务权限和日志。两种使用方式的操作入口不同，不应混用教程步骤。
前往下载SELECTION CHECK
平台相同，客户端也需要按维护状态与使用方式选择
图形客户端适合需要托盘菜单、策略组选择、系统代理开关和配置更新界面的桌面用户；内核程序更适合熟悉命令行、服务管理和 YAML 配置的服务器或路由器环境。旧客户端仍可能可以启动，但停更后不会继续适配新的内核字段和操作系统变化。迁移时应优先保留订阅地址、覆写内容和自定义规则，再在新客户端中重新检查接管方式。
设备架构是另一个独立条件。Windows 常见为 x64，macOS 需要区分 Apple Silicon 与 Intel，Android 则可能出现 ARM64、ARM 或通用包。安装包名称中的架构标记必须与设备对应。若下载后无法安装，先核对架构和系统版本，不要连续尝试不同来源的同名安装包。
查看全部客户端与系统要求 →RECEIVE CHAIN
从订阅输入到流量输出
Clash 配置不是单一开关。订阅解析、策略分流、DNS 处理和自动更新依次作用于同一条链路。左侧频道用于切换检查项目，朱红标记表示当前说明位置。
CONFIG INPUT / CHANNEL 01
订阅链接先被转换为本地配置
客户端访问订阅地址后，读取其中的代理节点、策略组、规则和可能附带的 DNS 字段，再保存为本地配置。导入成功只表示内容已经写入客户端，不代表该配置已经被设为当前配置，也不代表流量已经进入代理链路。操作时应核对配置名称、更新时间和当前选中状态，然后打开策略组确认节点条目是否正常出现。
如果导入后内容为空，优先检查链接是否复制完整、订阅是否仍然有效，以及客户端是否能访问订阅地址。网页中能打开一段文本不等于客户端一定完成解析；返回格式、重定向方式和字段兼容性都会影响结果。重新导入前可先执行一次手动更新，并查看客户端日志中的配置加载提示。
- 确认订阅地址没有缺失参数或多余空格
- 确认新配置已经切换为当前使用项
- 确认节点、策略组与规则段都已载入
RULE PROCESS / CHANNEL 02
策略组决定规则命中后的实际出口
规则负责判断域名、IP、进程或网络类型应进入哪个策略组，策略组再决定使用指定节点、自动选择、故障转移、直连或拒绝。节点测试结果只用于辅助选择，不会替代规则匹配。排查某个网站的连接问题时，应先确认当前模式，再查看请求命中了哪条规则、进入哪个策略组以及该组当前选择了什么出口。
全局模式会把大部分连接交给统一出口，规则模式按规则列表从上到下匹配，直连模式则跳过代理节点。日常使用通常从规则模式开始。自定义规则需要放在正确位置，因为前面的宽泛规则可能提前命中，使后面的精确规则失效。切换节点后还应等待已有连接结束，再重新发起请求进行验证。
- 先检查运行模式，再检查规则命中结果
- 确认策略组不是误选为直连或拒绝
- 修改规则后重新加载配置并建立新连接
NAME RESOLUTION / CHANNEL 03
DNS 设置影响域名解析与规则判断
Clash 可以接管 DNS 查询，并把解析结果交给规则系统继续处理。Fake-IP 模式通过虚拟地址建立域名映射，便于在连接阶段保留域名信息；Redir-Host 模式更接近返回真实解析结果。两种模式没有固定的通用答案，应根据系统环境、局域网服务、游戏程序和特殊应用的兼容情况选择。
出现网页域名打不开但直接访问 IP 正常、局域网设备名称失效或应用反复重连时，需要把 DNS 纳入排查范围。先确认 DNS 功能是否启用、监听端口是否冲突、上游服务器是否可达，再检查 Fake-IP 排除列表。系统、浏览器和客户端可能各自缓存解析结果，修改设置后应清理缓存或重启相关应用再验证。
- 确认 DNS 监听端口没有被其他程序占用
- 局域网域名和特殊域名按需加入排除项
- 修改解析模式后清理旧连接与 DNS 缓存
CONFIG REFRESH / CHANNEL 04
自动更新只刷新订阅，不替代配置检查
支持订阅更新的客户端可以按设定间隔重新获取配置。更新可能带来节点增减、策略组调整和规则变化，因此更新完成后应确认当前配置仍然有效，常用策略组的选择没有被重置。若客户端支持配置覆写，应明确覆写发生在订阅内容之前还是之后，避免本地修改在下一次更新时被替换。
自动更新失败时，先执行手动更新并观察错误信息。常见检查顺序是订阅地址、网络可达性、系统时间、配置格式和存储权限。频繁缩短更新间隔不会改善连接质量，反而可能制造重复请求。合理做法是使用客户端支持的常规间隔，并在服务提供方通知配置变化后执行一次手动刷新。
- 保留原始订阅地址并记录必要的本地覆写
- 更新完成后重新检查策略组当前选择
- 失败时查看日志，不连续重复点击更新
OPEN SOURCE RECORD
开源内核、配置边界与更新依据
Clash 生态由内核、图形客户端、配置格式和社区维护项目共同组成。判断客户端是否适合继续使用，应查看代码、发布记录、内核兼容情况和操作系统支持，而不是只看界面名称。
HISTORY / 01
项目演进：客户端名称相近，维护状态并不相同
Clash 最初形成了规则匹配、策略组和 YAML 配置等常用操作方式，随后出现了面向不同平台的图形客户端。原有部分项目停止维护后，社区继续围绕兼容内核和新客户端推进功能。现在搜索“Clash 客户端”会看到多个名称相近的程序，它们可能使用不同内核、不同界面层和不同发布渠道。
选择时需要分别确认三个问题：客户端最近是否仍有维护活动、所带内核是否支持当前订阅字段、安装包是否对应设备系统与架构。旧教程中的菜单名称也可能与新客户端不同，但配置链路仍可按“导入配置—选择策略—启用接管—检查日志”的顺序理解。
ECOSYSTEM / 02
开源生态：内核与图形界面承担不同职责
Mihomo 等兼容内核负责解析配置、建立连接、执行规则、处理 DNS 和提供控制接口；Clash Plus、Clash Verge Rev、FlClash 等客户端则在内核外提供安装、配置管理、托盘操作、系统代理开关和可视化日志。图形客户端是否易用，与内核是否支持某项配置是两个不同问题。
排查故障时也应区分边界。安装失败通常属于系统与客户端层；YAML 报错属于配置解析层；网站被错误分流属于规则或策略层；部分应用没有进入代理则多与系统代理、TUN 路由或应用自身网络实现有关。明确问题所在层级，可以减少无关设置的改动。
CORE RELATION / 03
内核关系：界面设置最终会转换为配置与启动参数
客户端中的“规则模式”“允许局域网”“TUN 模式”“DNS 增强模式”等开关，最终会写入配置字段或转换为内核启动参数。界面隐藏了字段细节，但不会改变底层作用。需要迁移客户端时，订阅地址通常可以重新导入，自定义覆写、脚本、规则提供器和本地 DNS 例外则需要单独整理。
直接使用内核的用户需要自行维护配置路径、控制端口、服务启动和日志轮转；图形客户端会代管其中一部分。两种方式都使用相同或相近的配置概念，但操作路径不能照搬。本站的入门教程以图形客户端为主，配置字段页则按 YAML 层级解释内核实际读取的内容。
UPDATE POLICY / 04
更新机制：分别处理客户端、内核与订阅配置
客户端更新用于修复界面、安装和系统适配问题；内核更新用于增加协议、规则、DNS 与路由能力；订阅更新只负责刷新服务提供方交付的配置。这三种更新互不替代。连接正常时不必为了追逐版本频繁改动全部组件，遇到兼容问题时则应先确定变化发生在哪一层。
执行客户端升级前，建议记录当前订阅地址、策略组选择和本地覆写。升级后先检查配置能否加载，再检查系统代理或 TUN 权限是否保留。订阅自动更新后若出现策略变化，应对照更新时间和配置内容，而不是直接回退客户端。日志中的字段错误、权限错误和网络错误应分别处理。
SOURCE CHECKOUT
读取 Mihomo 源代码与提交记录
需要核对内核行为时，可从公开仓库查看配置实现、问题记录和发布说明。克隆命令只用于获取源代码，不会安装图形客户端，也不会自动生成可用订阅。普通用户应从客户端下载页选择安装包；开发者和路由器维护者可结合构建文档继续处理。
git clone https://github.com/MetaCubeX/mihomo.git
QUICK DIAGNOSIS
常见问题精选
以下问题用于快速判断检查方向。完整操作步骤、平台差异和故障处理可继续进入帮助中心。
订阅导入成功，为什么浏览器仍然直连？
先确认导入的配置已经设为当前配置，再检查客户端是否开启系统代理。仅启动客户端或选中节点不会自动修改所有应用的网络入口。若浏览器使用独立代理设置、扩展或安全 DNS，还需要检查这些设置是否覆盖了系统代理。
系统代理和 TUN 模式应该先用哪个？
桌面环境建议先使用系统代理验证浏览器和遵循系统设置的应用。只有当游戏、终端、商店或其他程序不读取系统代理时，再评估 TUN 模式。TUN 覆盖范围更广，但需要额外权限，并可能与虚拟机、其他 VPN 或安全软件的网络驱动发生冲突。
更新订阅后，原来选择的节点为什么变化了？
订阅更新可能重建策略组或修改节点名称，原选择项不存在时，客户端会回到策略组默认值。更新后应打开常用策略组重新确认出口。若客户端支持覆写，可以在了解合并顺序后固定部分本地设置，但不要直接修改会被下一次更新覆盖的订阅文件。
只有部分应用无法连接，应先检查什么？
先判断这些应用是否读取系统代理，再查看请求是否进入客户端日志。日志中没有记录时，问题通常在流量入口；有记录但规则不符时，检查规则和策略组；域名解析异常时，再检查 DNS 模式、缓存与排除项。按入口、规则、出口、DNS 的顺序定位。
CONFIG NOTES
近期配置文章
文章按配置结构、接管方式和客户端迁移分别展开。需要处理单一问题时，可直接进入对应主题，不必从头阅读完整入门流程。
Clash 配置文件 YAML 结构解析：从基础字段到规则段的完整顺序
按实际加载顺序拆解端口、DNS、代理节点、策略组与规则字段，并说明缩进、引用和字段覆盖关系。
适合已经完成订阅导入、准备读取或修改配置文件的用户。文章重点说明各段之间的引用关系，以及为什么字段存在但仍可能没有进入实际运行配置。
Clash TUN 模式和系统代理区别：流量入口、覆盖范围与选择方法
从工作层级、应用兼容性、DNS 处理和权限要求比较两种接管方式，给出常见设备环境下的选择依据。
适合处理“浏览器正常但其他应用没有连接”或“TUN 开启后网络异常”等问题。文章按流量入口解释差异，并列出切换前需要核对的权限、路由和冲突项。
Clash for Windows 停更后怎么迁移：客户端替代与配置转移步骤
梳理可继续使用的客户端，说明订阅、覆写规则和系统代理设置如何迁移，并列出切换前后的检查项目。
迁移重点不是复制旧程序目录，而是分离可复用配置与客户端专属状态。文章说明订阅、覆写、自定义规则和接管设置分别应如何记录与重新建立。