Windows
优先从 Clash Plus 等持续维护的图形客户端开始。安装后导入订阅，启用系统代理，再检查浏览器连接。需要接管游戏或商店应用时，继续了解 TUN 与回环限制。
从 Clash for Windows 迁移时，先备份订阅、自定义规则和覆写内容。新客户端的配置目录与服务模式可能不同，不宜直接覆盖整个旧目录。系统代理端口也应以新客户端实际显示的值为准。
前往下载Clash 配置块
从配置项理解连接路径。选择一个主题，查看用途、启用方式和 YAML 片段。示例用于说明局部结构，需合并到已有配置；代理组名称与规则目标必须一致。
按顺序匹配，按策略出站
规则模式按 rules 从上到下检查连接，命中后使用对应策略，不再继续匹配。域名后缀适合覆盖同一服务的子域，IP 规则适合已知地址范围，MATCH 则承接剩余连接。先把需要单独处理的规则放在前面，再加入区域规则和最终策略。mihomo 延续常用 Clash 规则写法，同时扩展了规则能力；从旧配置迁移时，应检查所用规则类型与数据文件是否仍适配。下例的 PROXY 是代理组名称，必须先在配置中定义，不能仅复制规则后直接启动。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY用代理组集中管理出口
代理组把规则目标与具体出口分开，换出口时不必逐条改写规则。select 用于手动选择，url-test 按探测结果选择出口，fallback 则按顺序寻找可用项。先明确需要手动控制还是自动切换，再配置组类型和候选列表。mihomo 兼容常见的旧版代理组结构，但新增字段不一定能被旧内核识别，迁移时应以实际内核文档为准。下例先用 DIRECT 建立可解析的最小组；导入订阅后，再通过 proxies 或 use 接入真实出口，规则中的 PROXY 才会承担代理选择。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT保留域名映射，检查解析路径
fake-ip 为域名分配虚拟地址，让内核在后续连接中保留域名信息，以便完成域名规则匹配。启用 dns 后，还要确认应用的 DNS 请求确实进入内核；只改 enhanced-mode 并不会自动接管所有系统解析。与旧内核相比，mihomo 的 DNS 策略选项更丰富，迁移时不宜整段沿用来源不明的组合配置。遇到局域网服务或特定应用不兼容，可针对域名设置 fake-ip-filter，并检查缓存。下例只展示基础结构，上游解析器应按所在网络的实际可达性选择。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- '*.lan'
nameserver:
- https://dns.alidns.com/dns-query接管不读取系统代理的连接
TUN 通过虚拟网络接口处理流量，适合不读取系统代理设置的程序。桌面端通常需要管理员权限或客户端服务模式，手机端则由系统 VPN 接口承载。开启前先确认普通代理能够连接，再逐步启用自动路由与 DNS 劫持，避免把出口故障误判为路由问题。旧内核、不同客户端与不同操作系统的 TUN 实现存在差异，配置文件中写有 tun 不代表当前程序一定能加载。若启动后局域网访问异常，应检查路由、网卡与其他 VPN 冲突，而不是反复重装客户端。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53把订阅出口与规则集合分开更新
完整配置订阅、proxy-providers 和 rule-providers 不是同一种内容。完整订阅可能覆盖代理、分组与规则；代理集合只提供出口；规则集合只提供匹配条件。分开管理后，可以保留本地策略，仅更新需要变化的数据。mihomo 支持多种规则集合格式，旧内核未必识别所有格式与字段，迁移前应核对 behavior 和 format。下例使用本地 classical 规则文件，并通过 RULE-SET 引用；文件需事先存在且具有 payload 列表。远程订阅地址包含访问权限信息，分享日志或配置前应将其移除。
rule-providers:
local-direct:
type: file
behavior: classical
format: yaml
path: ./rules/local-direct.yaml
rules:
- RULE-SET,local-direct,DIRECT
- MATCH,PROXY通过本机接口检查连接与策略
外部控制接口供面板读取连接、切换策略和调整运行状态，它不是浏览器使用的代理端口。开启 external-controller 后，面板需填写对应地址；external-ui 指向已放入配置目录的面板文件夹。mihomo 保留常见控制接口的使用方式，但面板对新增功能的支持程度取决于面板自身。建议先绑定回环地址，只让本机访问；确需远程管理时，再配置认证与网络访问边界。部分图形客户端会自行管理控制地址和认证参数，应优先使用客户端设置，避免手写配置与运行时覆写互相冲突。
external-controller: 127.0.0.1:9090
external-ui: ./ui
log-level: info按系统选择客户端
图形客户端负责订阅管理、系统代理和日常操作；内核负责协议、解析与规则执行。先选适合设备的客户端，再核对处理器架构、系统要求和配置支持范围。
macOS
先区分 Apple Silicon 与 Intel 处理器，再选择对应安装包。Clash Plus、Clash Verge Rev 等客户端可管理订阅与规则，安装后的网络权限以系统提示为准。
系统代理与 TUN 的授权方式不同。浏览器能联网而终端不能时，先检查命令行程序是否读取代理环境变量；只有明确需要透明接管时再启用 TUN，避免与已有 VPN 同时修改默认路由。
前往下载Android
可选择 Clash Plus、Clash Meta for Android 等客户端。导入配置后允许建立 VPN 连接，再检查应用访问。安装包架构需与设备匹配，不确定时先查看设备的处理器信息。
后台断连不一定由订阅失效引起。先检查系统电池优化、后台运行与自动启动权限，再观察切换无线网络后是否恢复。每次只调整一项设置，更容易判断是系统回收还是连接路径变化。
前往下载iOS
下载页提供 Clash Plus 的 App Store 入口，并列出官网 clashplus.io。安装后按客户端支持的格式导入订阅，允许添加 VPN 配置，再在系统设置中确认连接状态。
同一份订阅在不同客户端中的字段支持可能不同。导入失败时，先核对链接返回的是完整配置还是代理集合，再查看具体报错。不要把桌面端的监听地址、文件路径与 TUN 参数原样搬到手机端。
前往下载Linux
桌面环境可选 Clash Verge Rev 或 FlClash；服务器与路由器用户可查看 mihomo 内核包。安装前确认发行版包格式与 CPU 架构，随后设置配置目录和运行权限。
命令行运行时应先以前台方式检查日志，确认配置能够加载后再交给服务管理器。普通用户监听端口、创建 TUN 设备与修改路由所需权限不同，排查时应把配置错误和权限错误分别处理。
前往下载mihomo 内核与开源生态
把内核、客户端和配置来源分开理解。项目源码说明实现方式，发行说明记录变更，客户端界面则决定具体操作路径。
Clash Meta 与 mihomo 的关系
Clash Meta 是这一内核项目早期使用的名称，项目现以 mihomo 名称持续开发。搜索教程时仍会遇到旧名称、旧仓库路径和不同客户端的截图。判断配置是否适用，应看实际运行的内核及其文档，而不是仅凭客户端名称中是否包含 Meta。图形界面的更新和内核的更新也不一定同时发生。
客户端不是订阅服务
mihomo 负责执行代理协议、DNS 解析与分流规则，图形客户端在其上提供配置管理、系统集成和交互界面。订阅则来自用户自行选择的服务或自建配置。安装客户端不会自动生成可用出口，代码开源也不等于订阅内容公开。本站提供下载索引与中文使用资料，具体项目的开发、发布和问题处理由各自维护者负责。
从源码和发行说明核对变更
内核源码可在 MetaCubeX/mihomo 仓库查阅，许可证以仓库中的 LICENSE 文件为准。提交记录、议题讨论与发行说明有助于确认某个字段是否受支持、某项行为是否发生变化。复制下面的命令可以获取源码用于阅读；这一步不是普通用户安装图形客户端的必要步骤，也不会替代订阅导入和网络配置。
更新前记录配置，更新后验证路径
更新客户端或内核前，备份当前配置与本地覆写，并阅读变更说明。更新后先确认配置加载成功，再分别检查 DNS、规则命中和出口连接。遇到问题时记录操作系统、客户端名称、内核信息与最小复现步骤；分享日志前移除订阅地址、认证信息和私人域名。清晰的复现材料比整份配置截图更方便定位问题。
源码公开
MetaCubeX / mihomo
查阅内核实现、配置变更和社区讨论。桌面与移动客户端的功能支持仍需分别确认。
打开内核源码仓库 ↗git clone https://github.com/MetaCubeX/mihomo.git按问题继续查阅
首次使用时，按“导入订阅、选择规则模式、启用代理、验证连接”的顺序操作，不必同时开启所有网络功能。浏览器可用后，再处理终端、商店应用或局域网设备的需求。
订阅、模式与端口入门 →无法上网时，先区分订阅获取失败、配置加载失败和出口连接失败。三种问题涉及的链路不同，系统性排查应从日志中的第一条有效错误开始。
按症状查看故障排查 →规则与全局模式、系统代理与 TUN、HTTP 端口与控制端口容易混淆。修改前先确认配置项负责哪一层，避免用扩大接管范围的方法掩盖原有问题。
查看疑难解答 →配置与排查记录
从常见使用场景进入：新手配置、旧客户端迁移，以及 Windows 应用的回环限制。文章按操作路径说明设置，同时交代适用条件。
Windows 商店应用连不上代理：用 CheckNetIsolation 解除 UWP 回环限制
解释 UWP 应用默认禁止访问本机回环地址的原因，演示图形化豁免工具与 CheckNetIsolation 命令两种解除方式，并对比 TUN 模式的替代方案。
阅读排查步骤 →原客户端停更之后：迁移到 mihomo 内核客户端的选型与配置搬家步骤
梳理停更客户端的现状与风险，按平台列出可替代的 mihomo 内核客户端，并分步说明订阅、自定义规则与覆写脚本如何完整迁移。
阅读迁移步骤 →Clash Meta 新手十问：订阅导入、代理模式、端口与内核一次讲清
集中解答初次使用最常卡住的十个问题：订阅从哪来、规则与全局模式怎么选、7890 端口作用、mihomo 与旧内核关系等，每题附操作位置。
阅读新手十问 →