# 基础结构示例，流量默认直连mixed-port: 7890allow-lan: falsemode: rulelog-level: infodns: enable: true enhanced-mode: fake-ip nameserver: - https://dns.alidns.com/dns-queryrules: - MATCH,DIRECT# 手动选择组，可加入已有节点名称proxy-groups: - name: 出口选择 type: select proxies: - DIRECT - REJECT # 规则目标与组名保持一致rules: - MATCH,出口选择# 此示例不包含代理服务# 从上到下匹配，首条命中即采用rules: - DOMAIN,example.com,DIRECT - DOMAIN-SUFFIX,example.org,DIRECT - IP-CIDR,127.0.0.0/8,DIRECT,no-resolve - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve - MATCH,DIRECT # DOMAIN 是精确域名匹配# DOMAIN-SUFFIX 包含子域名# no-resolve 避免为 IP 规则触发解析# 按实际需求替换规则目标CONFIGURATION / MIHOMO
客户端负责导入配置、展示连接和调用系统接口；内核负责解析字段、处理 DNS 并执行路由。排查问题时，先区分流量是否进入内核，再检查命中的规则与最终出口。下面五类配置覆盖日常最常调整的部分，示例用于解释结构，不包含可用的代理节点。
规则路由决定一条连接使用哪个出口。内核按列表顺序匹配，先命中的规则先执行，因此精确域名应放在宽泛规则之前，最终兜底放在末尾。配置中可以直接写规则，也可以通过规则集集中维护。与只切换全局出口的方式相比，规则模式允许不同目标采用不同策略。修改后应在连接页查看目标域名、命中规则与策略链，避免仅凭浏览器能否打开网页判断分流结果。
# 具体规则优先，兜底规则最后
rules:
- DOMAIN,example.com,DIRECT
- DOMAIN-SUFFIX,example.org,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT策略组把规则目标与具体节点分开。规则指向固定组名，组内再选择节点，日常换出口时就不必逐条修改规则。手动选择使用 select，自动按探测结果选择通常使用 url-test，按可用性回退可考虑 fallback。与节点平铺列表相比，策略组能表达不同业务的出口偏好，但组名必须与引用完全一致，组之间也不能循环引用。延迟测试只反映探测地址的请求情况，不代表所有网站的吞吐和稳定性。
# 将实际节点名称加入 proxies 列表
proxy-groups:
- name: 出口选择
type: select
proxies:
- DIRECT
- REJECT
rules:
- MATCH,出口选择DNS 配置控制域名如何解析，以及内核如何保留域名与连接的关联。fake-ip 为请求返回映射地址，再由内核关联真实目标；它不是上游服务器返回的公网地址。与单纯替换系统 DNS 相比，这种方式更便于域名规则参与路由，但要求相关流量确实经过内核。遇到局域网设备或特定应用兼容问题时，应先检查解析路径，再按需设置过滤，避免一开始就堆叠多个上游。调整后还要清理旧缓存并重新建立连接。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-query
fake-ip-filter:
- '*.lan'
- localhostTUN 通过虚拟网络接口接收流量，适合不读取系统代理设置的程序。它改变的是流量进入内核的方式，并不自动把所有连接改为代理，出口仍由当前模式和规则决定。与系统代理相比，TUN 更依赖服务权限、路由与 DNS 接管，也更容易与其他 VPN 或虚拟网卡产生冲突。首次使用应先确认普通代理连接正常，再单独开启 TUN。若出现断网，先关闭 TUN 恢复基线，再检查服务状态、路由与日志，不要同时修改多个字段。
# 需客户端支持并具备相应权限
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
# 同时检查 DNS 配置及系统路由覆写用于把本地偏好与远程配置分开保存，例如固定监听端口、调整日志等级或补充规则。直接编辑订阅生成的文件，可能在下次更新时失去改动；通过客户端支持的覆写入口维护更便于追踪。需要注意，覆写不是所有客户端通用的一套内核字段，合并顺序、列表追加与替换行为都由具体实现决定。应用前先备份，应用后查看最终配置，而不是只看编辑框。涉及规则列表时尤其要确认新增条目没有落在兜底规则之后。
# 本地片段示意，导入方式依客户端而定
mixed-port: 7890
allow-lan: false
log-level: info
# 这不是名为 override 的顶层字段
# 列表合并行为请查客户端说明
# 应用后检查最终生成的配置OPEN SOURCE / PROJECT BOUNDARIES
先认清项目层次，再选择安装与配置路径。开源仓库提供可查阅的代码、发布记录和问题讨论；客户端的界面名称相似，不代表内置内核、系统集成和配置合并行为完全相同。
原版 Clash 项目的维护状态已经发生变化，当前生态由多个独立项目延续。mihomo 由 Clash.Meta 演进而来，是持续发展的内核分支之一。搜索结果中仍会出现旧教程、旧客户端和旧配置截图，阅读时应先确认文章讨论的内核与当前使用的软件是否一致。名称里包含 Clash，并不足以判断某个字段是否可用，也不能证明不同项目之间存在官方隶属关系。
迁移旧配置时，优先保留节点、策略组与规则的逻辑，再逐项检查内核支持情况。不要把“文件能被导入”当成“所有字段已生效”。部分客户端会在启动前重写端口、控制接口或 TUN 设置，最终运行内容可能与订阅原文不同。发生差异时，以客户端导出的运行配置和内核日志作为排查依据。
Clash Verge Rev、FlClash 等图形客户端提供配置管理、策略选择、连接列表及系统代理入口。mihomo 则处理协议连接、规则匹配与 DNS 等底层任务。客户端可能随安装包附带内核，也可能提供独立更新入口；更新界面与更新内核不一定是同一件事。查看项目说明时，应同时关注客户端发布记录与内核变更，尤其是新字段、默认值调整和平台服务相关变化。
代码公开让实现可以被查阅，问题讨论也能帮助定位特定系统环境下的兼容差异，但这不等于每个设备都能采用同一套配置。本站整理客户端入口与中文操作说明，不代替项目维护者发布结论，也不提供代理节点或订阅服务。软件获取、配置来源与网络服务是三个独立环节，出现问题时应分别确认。
一条连接通常先经过系统代理或虚拟网卡进入内核，再根据目标信息与 DNS 结果参与规则匹配，最后由策略组选择出口。节点协议由代理配置描述，策略组负责组织候选出口，规则负责决定流量交给谁。理解这三层关系后，更换节点不必重写全部规则，调整规则也不必重装客户端。节点服务是否可用，则需要结合认证、服务端状态与本地网络单独判断。
配置卡中的直连示例只展示 YAML 结构，不会建立代理线路。正式使用时，需要从可信来源导入包含实际节点的配置，并确认规则引用的组名存在。YAML 缩进使用空格，列表项之间保持层级一致；域名、节点名与策略组名要注意拼写。编辑后先使用客户端提供的配置检查，再重新加载，能减少语法错误与网络故障混在一起排查的情况。
升级前保存当前配置与必要的本地覆写，阅读相关项目的变更说明。订阅更新通常负责刷新节点和远程规则，客户端更新负责界面与系统集成，内核更新负责底层行为；三种更新的范围不同。若升级后出现连接问题，先确认运行配置是否变化，再检查权限、服务状态与日志。不要一边升级一边更换 DNS 和路由模式，否则很难判断是哪一步引入了差异。
验证时使用新的连接请求，查看实际命中规则、策略链和出口，而不是只观察托盘图标。旧连接可能仍沿用建立时的出口，浏览器缓存也可能掩盖配置变化。日志分享前应删除订阅地址、认证字段及个人网络信息；讨论问题只需提供必要的字段片段、系统环境和复现步骤，完整私有配置不适合公开发布。
已安装 Git 的设备可复制下面的命令获取仓库。克隆源码不会安装客户端，也不会自动配置系统代理；普通使用直接从下载页选择图形客户端即可。
git clone https://github.com/MetaCubeX/mihomo.gitCLIENTS / PLATFORM SELECTION
先确认设备系统与处理器架构，再进入对应平台查看安装包。桌面设备的 AMD64 通常对应 x64，不是仅限某一家处理器品牌；ARM64 与它不是同一种架构。下载页集中列出客户端选项、系统要求与安装说明，本页入口只负责带到正确的平台。
可先查看 Clash Plus，也可按功能偏好比较 Clash Verge Rev 与 FlClash。安装前在系统设置中确认架构；首次连接先使用系统代理验证，再决定是否启用 TUN 服务。浏览器正常而某个应用失败时，先检查该应用是否读取系统代理，UWP 应用还可能涉及回环限制。
前往下载 →Apple Silicon 与 Intel 设备应分别选择对应安装包。客户端界面、菜单栏控制与后台网络服务的权限并不相同，安装后按系统提示完成授权。若设备已有其他 VPN 或网络过滤工具，先确认各自的接管范围，避免多个程序同时修改默认路由。
前往下载 →按设备架构选择安装包，导入配置后授予系统 VPN 连接权限。需要长期保持连接时，再检查电池优化与后台运行设置。Clash Android 客户端的分应用选项与规则路由作用不同：前者决定哪些应用进入接管范围，后者决定进入内核后的连接去向。
前往下载 →下载页提供 Clash Plus 的 App Store 入口及官网 clashplus.io。完成安装后导入配置，并根据系统提示允许添加 VPN 配置。不同客户端对配置格式与字段的支持范围可能不同，已有 YAML 文件应先确认兼容性，再检查策略组和规则是否正确导入。
前往下载 →桌面用户可查看 Clash Verge Rev 与 FlClash，并按发行版选择适用包格式。服务器或路由器用户可在下载页内核区查看 mihomo。命令行启动内核后，还需要自行安排配置路径、权限与服务管理；图形客户端的系统代理开关不能直接等同于整个系统的流量接管。
前往下载 →READING / PRACTICAL NOTES
使用心得按具体任务展开：先建立可重复的验证方法，再理解测试数字与系统集成的边界。遇到 Clash 无法上网时，带着连接记录定位入口、解析或出口，比反复更换客户端更容易缩小范围。
导入配置后的第一次连接：如何在策略组里挑节点、批量测延迟，再通过出口 IP 查询与连接日志确认流量确实经过代理，而不是直连。
阅读文章 →拆解延迟测试请求的完整路径与测速地址的影响，解释低延迟节点也可能卡顿的原因，以及 url-test 策略组 interval 与 tolerance 的取值思路。
阅读文章 →覆盖安装包选择、首次启动、服务模式安装与 TUN 开启，并逐条排查系统代理不生效、UWP 应用无法联网、防火墙拦截等 Windows 高频问题。
阅读文章 →