CLIENT ROUTES
先确认系统与处理器架构，再查看安装包和使用说明。
平台相同不代表安装包可以互换。桌面设备需要核对处理器架构，移动设备需要确认系统要求；安装包格式还应与系统的软件安装方式对应。首次使用可以先选择图形界面客户端，通过配置页导入订阅、通过代理页选择策略，再查看日志确认连接结果。只下载独立内核并不会同时得到配置编辑器、托盘菜单或系统代理开关。
客户端负责读取配置并处理连接，订阅内容则由配置提供方维护。安装完成后，仍需准备可用的订阅链接或本地配置文件。不要把任意网页地址当作订阅地址，也不要反复安装多个客户端来处理同一个配置错误。原有配置能否迁移，取决于目标内核支持的字段、协议和客户端的覆写机制，而不是软件名称是否相近。
系统代理、移动端 VPN 与 TUN 是不同的流量接管方式。桌面系统代理通常只影响遵循该设置的应用，终端工具可能还要单独设置代理环境变量；TUN 涉及虚拟网卡、路由与权限，适合在基础连接正常后再启用。下载页将平台入口与安装说明集中排列，具体选型差异可继续查阅选型指南。
查看全部客户端 →CONFIG ROUTEBOOK
从流量去向回看字段关系，按需查阅配置片段。
规则模式按文件顺序检查连接，命中后采用对应策略，不会继续寻找更靠后的规则。域名规则适合明确的网站需求，地址规则适合已知网段；两者混用时，应注意解析行为与覆盖范围。先放需要优先处理的具体条件，再安排较宽泛的地域规则，最后使用 MATCH 兜底。规则目标既可以是 DIRECT、REJECT，也可以是已经定义的策略组名称。排查时结合连接记录看命中项，比只反复切换节点更容易定位问题。
配置侧栏rules:
- DOMAIN-SUFFIX,local,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- DOMAIN-KEYWORD,github,Proxy
- GEOIP,CN,DIRECT
- MATCH,Proxy策略组将节点或其他策略组织为可引用的目标，让规则保持稳定，出口选择可以单独调整。select 用于手动选择，url-test 可按配置的测试条件选择可用代理，二者解决的问题不同。示例中的 Proxy 是自定义名称，规则引用必须与其完全一致，大小写或空格差异都可能造成配置加载失败。下面仅用内置策略展示引用结构；实际连接代理时，需要把配置中真实存在的节点或代理提供器接入策略组，不能只复制组名就视为完成配置。
proxy-groups:
- name: Proxy
type: select
proxies:
- DIRECT
- REJECT
rules:
- DOMAIN-KEYWORD,github,Proxy
- MATCH,ProxyDNS 负责把域名关联到地址，分流规则负责决定连接的处理目标，这两个过程相互影响但并不等同。Fake-IP 使用映射地址保留域名关联，Redir-Host 则围绕真实解析地址工作。选择方式时要结合客户端能力、接管方式与局域网设备兼容性，不宜照搬整段设置。nameserver 是上游解析配置的一部分，不代表所有解析请求必然采用同一出口。遇到仅域名访问失败的情况，应先看解析日志，再区分上游可达性、过滤列表和路由问题。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "*.local"
nameserver:
- 1.1.1.1
- 8.8.8.8上方示例分别展示规则、策略组与 DNS 的局部结构，没有包含实际代理服务器。把片段放入已有配置前，先检查文件中是否已经存在同名顶层字段：重复写入两段 rules 或 dns，可能产生解析差异，也可能让前一段内容被后面的内容覆盖。YAML 使用空格缩进，同一层级应保持一致，列表项与父级字段的关系也需要保留。
客户端界面里的开关不一定直接改写原始订阅文件。有的设置会在运行时合并，有的通过覆写文件生效，因此应以当前运行配置和日志为准。需要长期保留的规则，优先使用客户端明确支持的覆写入口；直接编辑自动更新的订阅文件，下一次拉取时可能被替换。完整字段关系与合并边界见配置大全。
SOURCE & MAINTENANCE
区分内核、客户端与配置来源，判断资料是否适用于当前环境。
Clash 最初作为基于规则的代理项目被广泛使用，随后形成了围绕配置格式、图形界面和不同内核的生态。原始项目与部分早期客户端停止维护后，社区仍沿着各自路线继续开发。搜索结果中的旧教程可能对应历史界面、旧内核或已经归档的安装包，不能只凭标题里的 Clash 判断适用性。查阅时应同时确认客户端名称、使用的内核与说明涉及的功能。
本站将历史客户端与当前可选路线分开说明，不以下载次数、评分或未经核实的社区规模替代选型依据。已停止维护的客户端适合用于理解旧环境或迁移数据；日常安装应优先关注仍在维护、符合系统要求的选择。迁移前保留原配置和覆写内容，再检查代理协议、策略组引用、规则集路径与启动设置，避免只迁移订阅链接却遗漏本地定制。
mihomo 是 Clash 生态中持续发展的开源代理内核，项目沿袭 Clash Meta 的发展路线。内核承担协议处理、规则匹配、DNS 与网络连接等工作；图形客户端则提供订阅管理、策略选择、日志查看、系统代理与服务管理等操作入口。两者更新节奏不一定一致，某个字段是否可用，应查当前内核文档及客户端集成方式，而不是推测所有带 Clash 名称的客户端都支持。
界面中的同一个功能也可能采用不同实现。例如开机自启可以只启动界面，也可能同时启动后台服务；关闭主窗口可能只是收起窗口，并不等于停止代理。需要确认的不是开关名称，而是实际运行状态。移动端还应区分系统 VPN 状态与节点连接结果：系统显示 VPN 已建立，只能说明接管通道存在，不能单独证明目标网站已经可达。
mihomo 的代码与许可可在公开仓库中查阅，GPL-3.0 描述的是该项目的开源许可条件，不应据此推断所有图形客户端或订阅服务采用相同条款。阅读源代码、发行说明和问题讨论，可以帮助理解功能边界与已知问题；使用软件仍需要遵守当地法律、所在网络的管理要求以及相关服务条款。公开代码与实际运行设置是两个层面，仍应仔细确认配置来源。
本站提供客户端与文档导航，不代表所有列出的项目，也不提供代理服务器账号或订阅服务。订阅链接可能包含访问凭据，分享日志或截图时应遮去链接参数、账号、服务器地址等敏感信息。遇到问题可以描述系统、客户端名称、操作步骤和报错片段，尽量保留诊断信息，但不要把完整订阅公开粘贴到讨论区。
客户端更新通常涉及界面和集成组件，内核更新可能改变协议支持或字段行为，订阅更新则替换配置提供方发布的节点与规则内容。这三类操作应分别理解。订阅更新成功并不表示客户端已经更新；安装了新的客户端，也不代表旧订阅自动具备新功能。升级前阅读变更说明，备份当前可用配置，并记录本地覆写位置，出现差异时才能逐项对照。
排查更新后的异常时，先看配置是否成功加载，再确认规则目标与策略组引用，最后比较 DNS、端口和接管方式的变化。不要同时修改所有设置，否则很难判断是哪一步改变了结果。下载页集中提供客户端入口，教程页处理首次连接流程，配置大全解释字段；这样的查阅顺序能把安装问题、配置问题与网络问题分开。
git clone https://github.com/MetaCubeX/mihomo.git首先在配置页确认订阅已经下载并被选为当前配置，不能只停留在列表中存在一条记录。随后在代理页确认规则引用的策略组有可用目标，再选择规则模式并启用适合当前设备的接管方式。打开一个明确的目标网站，观察连接记录中的域名、命中规则和最终出口；如果日志中根本没有这条连接，应先排查应用是否经过客户端，而不是直接判定节点失效。
如果只能访问部分网站，可以比较失败请求与成功请求的区别：是解析阶段报错，还是已经建立连接后超时；是同一策略组失败，还是只有某条规则指向了错误目标。测试延迟也只是一次特定条件下的连通性参考，不能替代真实业务请求。按照快速上手完成基础流程后，再逐项启用 TUN、自定义 DNS、开机自启等功能，更容易保留清晰的排查路径。
先确认配置已启用，再检查策略组选项、运行模式与系统代理；导入成功仅表示配置已被读取。查看首次连接步骤 →
先判断请求是否进入客户端，再区分解析失败与连接失败，避免同时改动多个字段。查看故障排查问答 →
规则模式按规则选择去向，全局模式使用全局策略，直连模式则直接连接；切换模式不等同于切换接管方式。阅读模式对照 →
使用客户端支持的覆写或合并机制，并检查生成后的运行配置；不要仅修改自动下载的原始文件。查阅覆写与合并 →
READING NOTES
从配置结构、界面入口和代理模式继续查阅。
按文件自上而下的顺序拆解通用字段、dns、proxies、proxy-groups、rules 五大段，说明缩进规则与段间引用关系。
阅读配置结构 →逐区块认识客户端主界面：代理页选节点与测速，配置页管理订阅与更新，日志页按级别查看连接记录与报错。
阅读界面导览 →从 mode 字段讲起，说明三种模式下流量如何走向、何时切换，以及规则模式里 MATCH 兜底规则的作用。
阅读模式说明 →