Windows
从 Clash Plus、Clash Verge Rev 等图形客户端开始。安装前在系统设置中确认设备架构；启动后先导入配置，再启用系统代理验证浏览器连接。需要接管游戏、命令行或其他不读取代理设置的应用时，再检查服务模式与 TUN 权限。
应用商店应用单独异常时，检查 UWP 回环限制。切换客户端前先退出旧程序，避免两个进程同时修改系统代理或争用监听端口。
前往下载Clash 全平台下载入口
先确认系统与处理器架构，再选择客户端。安装包负责提供界面和运行环境；实际连接还需要可用的订阅或配置文件。已有配置时，优先检查其中的协议、策略组与规则是否被目标客户端支持，不要仅根据软件名称判断兼容性。
macOS
根据“关于本机”中显示的芯片，选择 Apple Silicon 或 Intel 对应安装包。图形客户端可管理订阅、策略组和菜单栏开关；系统代理适合先验证网页访问，TUN 则需要额外的网络接管权限，具体授权流程以客户端提示为准。
如果终端请求与浏览器结果不同，先检查终端代理环境变量。系统代理开关不会保证每个命令行工具都自动使用相同出口。
前往下载Android
可选择 Clash Plus、Clash Meta for Android、FlClash 等客户端。大多数较新的手机使用 ARM64，但仍应按设备信息确认。导入订阅并选择配置后，首次启动通常需要允许系统 VPN 连接请求；这项授权用于建立本地流量接管通道。
后台断连先检查电池优化与后台运行限制。按应用分流时核对应用名单，并留意其他 VPN 应用是否正在占用系统连接。
前往下载iOS
通过下载页进入 Clash Plus 的 App Store 页面，并可查阅官网 clashplus.io。安装后导入与客户端兼容的订阅，确认配置已选中，再按系统提示允许添加 VPN 配置，随后启动连接并验证目标应用。
订阅能够下载与其中的代理能够连接是两件事。导入失败先检查链接和格式；连接建立后仅部分网站异常，再检查规则、DNS 与出口服务状态。
前往下载Linux
桌面环境可选择 Clash Verge Rev 或 FlClash，安装时区分发行版所使用的 DEB、RPM 等包格式。服务器、容器或路由器用户可直接部署 mihomo 内核，由配置文件和服务管理器控制运行。命令行部署需要自行处理配置目录、文件权限、日志和开机启动，不等同于图形客户端的一键开关。
首次运行先在前台检查配置能否载入，确认监听地址后再交给 systemd。远程机器启用 TUN 或修改默认路由前，应保留独立的管理连接，避免代理路由影响 SSH 会话。普通桌面用户通常先用图形客户端更便于定位配置问题。
前往下载规则、策略组与流量接管
配置负责描述连接的去向，客户端负责管理与应用配置。以下片段展示字段关系，不是可以直接联网的完整订阅。示例中的 PROXY 是策略组名称，必须与实际配置中的定义一致；TUN 与 DNS 参数也需要按运行平台调整。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY规则分流
rules 从上到下匹配，先命中的规则决定连接去向。域名后缀规则适合明确的站点范围，GEOIP 用于按目标地址地区分流，MATCH 放在末尾接住其余连接。PROXY 必须对应已定义的代理或策略组。与全局模式相比，规则模式可以让不同请求走不同出口。调整前先确认应用流量已经进入内核，再在连接记录中核对命中项；如果请求根本没有出现，应先排查系统代理或 TUN，而不是继续追加规则。
查阅配置字段与规则 →proxy-groups:
- name: PROXY
type: select
proxies:
- AUTO
- DIRECT
- name: AUTO
type: url-test
use:
- provider-main
url: https://www.gstatic.com/generate_204
interval: 300策略组选择
proxy-groups 将规则目标与具体代理分开。select 允许手动选择，url-test 根据指定测试地址的结果选择可用出口。示例中的 provider-main 需要在 proxy-providers 中另行定义，不能仅复制这段就启动。与逐条修改规则相比，策略组可以保持规则名称稳定，只替换组内选择。测试结果只代表到测试目标的连接表现，不等于所有网站的体验，也不包含流量倍率、账号额度或目标服务的地区限制。
了解节点与策略组取舍 →tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53TUN 模式
TUN 通过虚拟网络接口接管被路由到该接口的流量，适合不读取系统代理设置的应用。auto-route 与接口识别会影响路由，因此需要匹配系统权限及客户端实现。与系统代理相比，TUN 的接管范围通常更广，但也更依赖 DNS、路由和其他 VPN 的状态。建议先用系统代理验证订阅，再启用 TUN，并检查日志中的适配器与路由信息。若远程连接或局域网访问受影响，应先检查路由排除，而不是直接切换全局模式。
对照 TUN 与系统代理原理 →订阅链接
↓ 客户端「配置」中新建远程配置
获取与解析 YAML
↓ 选中配置，检查载入日志
查看策略组
↓ 启用系统代理或平台 VPN
验证目标请求与命中规则订阅导入
订阅链接用于获取配置，安装客户端本身不会生成可用代理。通常在配置页新建远程配置，粘贴链接并下载，然后选中该配置查看策略组。与手工编辑本地 YAML 相比，远程配置便于同步服务方变更，但直接修改下载内容可能在下次更新时被覆盖。需要长期保留的规则应使用客户端支持的覆写机制。链接含有账号访问凭据时应妥善保存；更新失败先检查链接有效性、网络访问与格式，再考虑转换，避免把敏感链接交给陌生转换服务。
按步骤导入订阅 →开源背景与内核关系
区分客户端、内核和配置来源，才能判断更新影响了哪一层。Clash指南整理下载入口与中文配置说明，不代替各客户端的项目公告，也不提供代理订阅服务。项目状态、功能边界与许可证应以相应项目的公开资料为准。
Clash 与 mihomo 的关系
Clash 最初以规则驱动的代理内核形成配置生态。原项目的公开维护停止后，社区延续出不同的内核与客户端路线。mihomo 延续了 Clash Meta 的开发方向，提供代理协议处理、规则匹配、DNS 与流量接管等能力。名称相近并不表示所有项目由同一团队维护，也不表示所有配置字段可以在不同实现之间直接通用。
图形客户端通常将内核封装在界面后面，承担配置管理、订阅更新、系统代理开关与日志展示。遇到协议不支持、字段无法识别或运行异常时，需要同时记录客户端名称与实际使用的内核信息。仅说“Clash 不能连接”往往不足以复现问题；同一份配置在不同内核上的行为也可能有差异。
区分内核与客户端术语 →公开代码与问题定位
mihomo 的源代码、许可证、发布说明和问题讨论可在公开仓库中查阅。公开代码让字段实现与行为变更有可追溯的依据，但不能代替本机配置检查。提交问题时应先阅读已有讨论，并说明操作系统、启动方式、出错步骤与必要日志，避免只附一张开关截图。
日志和配置可能包含订阅地址、代理认证信息与访问记录。分享前应删除账号信息，仅保留能复现问题的最小配置。排查时可以将故障拆成配置解析、端口监听、流量接管、规则选择和目标连接几个阶段。先定位失败阶段，再阅读相关实现或提交反馈，比一次性修改多个参数更容易得到可靠结论。
查看 mihomo 开源仓库 ↗获取 mihomo 源代码
命令需要本机已安装 Git。克隆得到的是源代码，不是图形客户端安装包；普通安装直接使用下载页。
git clone https://github.com/MetaCubeX/mihomo.git客户端更新与订阅更新
客户端更新改变界面、系统集成或内核组件，订阅更新则重新获取配置内容，两者是独立操作。订阅更新成功不意味着软件本身已更新；更换安装包也不会自动修复过期订阅。升级前保留能正常工作的配置与必要的覆写规则，升级后先查看载入日志，再验证系统代理和 TUN 的实际行为。
远程配置中的规则、代理组和提供器可能由服务方管理，直接编辑下载文件容易在刷新后丢失。计划添加自定义规则时，先确认客户端支持何种覆写或合并机制，并检查最终生效配置。自动更新间隔应根据服务方说明设置，不应把频繁请求当成修复订阅失效的方法。
查看订阅更新检查顺序 →从基础检查到平台排障
首次配置建议保留单一客户端运行，导入后先确认配置能够解析，再确认本地端口已经监听。随后启用系统代理或平台提供的 VPN 接管，访问目标地址并查看连接记录。若浏览器可用而其他应用不可用，优先检查应用是否遵守系统代理设置，不要立即认定代理服务器失效。
只有开启 TUN 才出错时，重点检查权限、DNS 与路由；所有模式都失败时，再检查订阅状态和代理可达性。修改参数应一次只改一项，并记录修改前后的日志差异。需要重置配置时先导出备份，避免把可复现的故障现场和原有规则一起清除。完整文档按平台整理了安装、授权与常见冲突的检查路径。
查阅全平台安装配置文档 →配置前的三个判断
已有订阅，仍无法导入？
先确认链接返回的是兼容配置，而不是登录页面或错误提示。保留原始链接，检查有效期和网络访问；确实存在格式差异时再评估订阅转换。转换会涉及配置内容与凭据流转，应先了解接收方与处理方式。
查看导入问题 →系统代理还是 TUN？
先用接管范围较明确的系统代理验证基础连接。只有目标应用不读取代理设置，或确实需要更广的流量接管时，再启用 TUN。增加接管范围也增加了路由与 DNS 检查项，不应仅因开关存在就全部打开。
理解网络接管术语 →下载客户端后还缺什么？
还需要合法可用的配置来源、与客户端兼容的协议，以及系统要求的网络授权。客户端是流量管理工具，安装完成不等于已有代理服务。准备好这些条件后，再按教程完成导入、选择策略组与连接验证。
查看首次配置步骤 →Clash 技术笔记
围绕具体配置问题展开：先说明现象与原理，再给出检查位置和参数。以下为最新三篇笔记；基础操作从教程开始，平台差异与命令行部署可结合完整文档查阅。
Clash 订阅更新失败排查与自动更新间隔设置
梳理链接失效、更新请求受阻、请求未走代理与格式不兼容的差异。结合客户端更新入口，说明如何检查自动更新间隔与更新时使用的网络路径，避免将配置下载失败与代理连接失败混为一谈。
阅读笔记 →Linux 部署 mihomo：桌面图形客户端与命令行 systemd 服务两种方式
分别说明桌面客户端安装与无界面环境的内核部署。围绕配置目录、运行权限、终端代理变量和 systemd 服务组织步骤，帮助区分前台测试成功与长期后台运行所需的额外设置。
阅读笔记 →Clash TUN 模式与系统代理的区别：流量接管原理与适用场景
比较应用主动遵守代理设置与虚拟接口接管的差别。说明 DNS 处理、stack 选项与权限要求，并给出两种方式的使用判断，便于排查浏览器可用、其他应用仍然直连的情况。
阅读笔记 →