Windows
从 Clash Plus 等图形客户端开始。首次连接先验证系统代理，再按应用需要启用 TUN；遇到端口占用或服务权限提示，先处理本机环境，不要连续更换订阅。
前往下载CONFIGURATION INSPECTOR
mihomo 配置检查器
一份配置依次决定入口、解析、规则与出站。先确认请求进入内核，再看命中的规则和策略组；把问题拆到对应配置段，比同时修改多个开关更容易定位原因。
先命中，先执行
规则从上往下求值，命中后交给指定策略处理。域名后缀适合表达明确的网站集合，地理地址规则用于地址归属判断，末尾的 MATCH 接住剩余请求。排查网站走错出口时，先在连接记录里核对域名、命中规则和最终策略，不要只看当前选中的节点。规则模式读取这份列表，全局模式则采用全局策略；切换模式不等于修复规则。示例引用的 PROXY 策略组须先定义，GEOIP 规则还依赖可用的地理地址数据。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY通过虚拟网卡接管请求
TUN 把符合路由条件的流量送入虚拟网卡，适合不读取系统代理的应用，以及需要进一步处理的 UDP 请求。启用前先确认客户端具备服务权限或管理员权限，再检查虚拟网卡与路由是否建立。它扩大的是流量接管范围，不会自动改善远端线路，也不能让所有节点突然支持 UDP。与其他 VPN 同时运行可能改变默认路由，首次配置宜只保留一个接管工具。示例仅展示接管段，DNS 劫持仍需配合已启用的内核 DNS 使用。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53按服务端参数填写协议
mihomo 能处理多种代理协议，但协议名称相同不代表所有字段都能互换。导入配置时，应保留提供方给出的服务器、端口、认证信息与传输设置；涉及 TLS 时还要核对证书验证与服务器名称。不要用关闭证书验证代替排查时间、域名和证书链。图形界面是否开放某个选项，取决于客户端与其内核支持情况。下方仅用保留示例域名说明 SOCKS5 条目的字段结构，地址和认证信息不是实际线路，不能直接用于连接。
proxies:
- name: example-socks
type: socks5
server: proxy.example.com
port: 1080
username: your-username
password: your-password规则指向策略，策略选择出口
策略组把规则与具体节点分开。规则保持指向稳定的组名，组内再决定手动选择、定期测试或按可用性回退。select 适合首次连接时明确指定出口；url-test 根据测试结果评估候选；fallback 按配置顺序选择可用项。测试目标、网络状态和检测间隔都会影响自动选择，数值不能直接等同于下载速度。下面以手动组连接一个已有代理，example-socks 必须在 proxies 中定义；组名大小写与规则引用也要一致，否则配置无法按预期加载。
proxy-groups:
- name: PROXY
type: select
proxies:
- example-socks
- DIRECT让域名与连接记录对应
fake-ip 为查询返回合成地址，内核保留地址到域名的映射，以便后续请求继续按域名匹配规则。它不是把真实服务器地址永久替换成另一个出口，最终访问仍取决于策略。配置时需要同时考虑 DNS 上游可达性、接管方式与本地应用兼容性；少数局域网发现或自定义解析场景可能需要过滤。示例使用回环监听地址，适合解释本机解析入口，不应直接开放给外部网络。启用该段后，还要确认系统或 TUN 确实把查询交给内核。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 1.1.1.1区分完整配置与节点集合
客户端的配置订阅通常加载整份 YAML，而 proxy-providers 用于载入可被策略组引用的代理集合，两者不能不加判断地交换。更新失败时，先检查链接是否过期、返回内容是否符合预期，再看下载请求的网络路径。订阅地址常包含账户标识，应按凭据管理，截图、日志与公开仓库都不应包含真实地址。下面使用保留示例域名，展示更新间隔和本地缓存路径；提供方内容必须符合 provider 格式，并由策略组通过 use 引用才会参与选择。
proxy-providers:
remote:
type: http
url: "https://subscription.example.com/proxies.yaml"
path: ./providers/remote.yaml
interval: 3600CLIENT ENTRY POINTS
Clash 客户端平台入口
先选系统，再选处理器架构。图形客户端负责配置管理和系统接管，内核负责解析规则与转发请求。安装包能否运行、TUN 需要什么权限、配置格式是否兼容，应分别确认，不能只凭客户端名称判断。
macOS
按 Apple Silicon 或 Intel 选择安装包。系统代理与网络扩展的授权位置不同，安装后核对系统提示；休眠恢复或切换网络后，应重新检查出口与解析是否正常。
前往下载Android
核对设备架构与安装权限，导入订阅后允许建立 VPN 连接。后台省电策略可能中断服务，出现锁屏后断连时，应检查电池限制以及其他 VPN 应用是否占用接管入口。
前往下载iOS
通过下载页进入 Clash Plus 的 App Store 页面，官网为 clashplus.io。导入前确认配置格式兼容，首次启动按系统提示授权 VPN，再验证规则与出口。
前往下载Linux
桌面环境可选择图形客户端，服务器与路由器用户可查阅内核入口。安装前分清发行版包格式、处理器架构与服务运行身份，避免把桌面代理设置误当作整机流量接管。
前往下载下载页按平台列出客户端、架构和系统要求。已经在使用其他客户端时，迁移前先导出配置，并记录本地规则、覆写项和策略选择；同一条订阅在不同工具中可能经过不同的转换流程，界面相近不代表配置处理完全一致。
Clash for Windows 停更后，旧安装包仍可能出现在教程截图中。新部署应优先评估仍在维护的方案，归档客户端只用于明确的兼容需求。迁移完成后关闭旧工具的开机启动和系统代理，防止两个进程争用端口或反复改写系统设置。
FIRST CONNECTION
订阅导入与首次连接
客户端安装完成并不代表流量已经经过代理。按“加载配置 → 选择策略 → 接管并验证”的顺序操作，能把订阅下载问题、节点连接问题与本地接管问题分开。以下界面仅示意设置项，具体入口名称以所用客户端为准。
导入订阅配置
打开配置或订阅页面，新建远程配置并粘贴已有链接。下载成功后选中该配置，确认出现策略组；仅保存地址但未激活配置，不会改变当前连接。
若返回网页、登录提示或空内容，先向订阅提供方确认链接与账户状态。不要把含账户标识的地址提交到公开转换站点，也不要把订阅内容粘贴到公开问题讨论中。
选择规则与出口
首次使用选择 Rule 规则模式，在实际被规则引用的策略组中指定节点并执行测试。延迟测试反映特定目标的探测结果，不等同于所有网站的访问速度。
测试超时不一定表示节点完全不可用，也可能是测试目标或解析路径异常。应结合实际网站访问与日志判断，且先固定一个出口完成验证，再考虑自动测试和回退策略。
接管流量并验证
浏览器先使用系统代理完成验证；不遵循代理设置的应用，再按需启用 TUN。打开目标网站，在连接记录中检查命中规则、策略组与最终出口是否一致。
验证时区分浏览器、终端和其他应用。终端工具可能需要单独设置代理环境变量；IP 查询也只说明该次查询的出口，不能据此认定所有请求都经过同一路径。
SOURCE & MAINTENANCE
开源内核与客户端边界
Clash Meta 与 mihomo 的关系
Clash Meta 是这一内核分支在早期使用的名称，当前内核项目以 mihomo 名称维护。搜索结果、配置教程和部分客户端名称仍会保留 Meta 字样。判断文档是否适用时，应关注实际运行的内核及其支持字段，而不是只看窗口标题；旧截图里的按钮名称也可能已经迁移。
mihomo 提供配置解析、协议处理、规则判断和 DNS 等能力。图形客户端在它之外提供订阅管理、托盘菜单、系统代理和服务管理。客户端更新与内核更新并不是同一件事，遇到某个配置键不被识别时，应先查看实际内核信息和加载日志，再决定更新哪一层。
从源码与文档确认行为
公开仓库的代码、许可证、问题记录与发布说明，是核对行为的重要依据。遇到教程与实际界面不一致，应回到对应项目的文档和发布记录，确认设置项是否改名、默认值是否调整，以及是否需要新的运行权限。本站提供中文操作索引，不替代上游项目对功能范围的说明。
配置与服务来源分开管理
代理内核和客户端不等于代理服务。订阅中的节点、线路状态、流量额度和账户有效期由提供方决定；下载新的客户端不会补足已经失效的订阅。所谓 Clash 机场订阅通常是服务方交付的配置入口，使用前仍需确认来源、协议支持和服务约定，不应把它误认为内核项目自带的网络资源。
规则列表、地理数据和代理订阅也有各自的更新周期。进行 Clash GeoIP 更新时，先确认配置使用哪种数据格式与文件位置；更新订阅时则检查节点集合和本地覆写是否保留。把这些动作分开执行，出错后才容易回退到明确的已知状态。
更新前记录，更新后验证
保留当前可用配置、重要覆写和启动参数，阅读变更说明后再更新。更新结束先检查能否启动与加载 YAML，再验证 DNS、常用网站和需要接管的应用。若出现差异，保留经过脱敏的错误信息；反馈时说明系统、架构、客户端与内核环境，不要附带真实订阅地址、密码或完整账户资料。
SOURCE / GIT CLONE
拉取源码用于阅读实现与跟踪变更。clone 只获取仓库内容，不会自动安装客户端；普通桌面用户可直接使用下载页的安装入口。
git clone https://github.com/MetaCubeX/mihomo.gitCONFIGURATION NOTES
连接验证与故障排查文章
基础配置完成后，再按具体症状阅读专题。系统代理不生效、规则命中错误与节点不可用属于不同层级的问题；每次排查先保留现状，找出请求在哪一步偏离预期，然后只调整相关设置。
Clash 系统代理开了却不生效：浏览器与命令行终端分开排查
按浏览器和终端两条线定位系统代理失效原因：浏览器扩展接管、PAC 与端口冲突，以及终端需要手动设置 http_proxy 环境变量等问题。
阅读排查步骤 →mihomo 规则分流写法实战：GEOSITE、GEOIP 与 MATCH 实现国内外分流
用真实 rules 片段讲解规则匹配顺序、GEOSITE 与 GEOIP 的分工、rule-providers 引用方式，搭建中国大陆直连、境外走代理的分流配置。
阅读配置说明 →Clash Meta 首次连接教程：选择节点、延迟测试与代理生效验证
导入订阅后的第一次连接怎么做：在策略组里挑选节点、理解延迟测试结果的含义，再用浏览器与 IP 查询确认代理已真正生效。
阅读连接步骤 →