Windows
适合常规桌面使用。安装后重点确认系统代理、监听端口和 UWP 应用回环;需要接管更多应用时,再按权限要求配置 TUN。
前往下载从客户端选择开始,按顺序完成订阅导入、代理模式与规则分流。Windows、macOS、Linux 与移动端的入口和操作边界集中整理。
RULE ENGINE INDEX
客户端界面只是操作入口,实际行为由配置、策略组、匹配顺序与系统接管范围共同决定。下面按使用时最常遇到的五个环节拆开说明。
当前操作焦点
规则问题通常不是语法本身,而是更靠前的宽泛规则提前截获请求。打开连接页找到目标域名,记录命中的规则和策略组,再回到配置文件调整顺序。修改后应重新载入配置并建立新连接,旧连接不会自动重走完整匹配流程。
当前操作焦点
规则模式异常而全局模式正常,通常说明节点可用,问题集中在规则匹配或策略组选择;两种模式都失败时,应继续检查监听端口、订阅状态和节点连接。直连模式用于恢复原始网络路径,方便对照代理前后的差异。
当前操作焦点
订阅链接返回内容后,客户端仍需完成格式解析、文件保存、配置选中和内核重载。导入失败时先确认链接返回的是 Clash YAML,而不是网页、通用编码订阅或登录提示;导入成功后再核对当前启用配置的名称。
当前操作焦点
浏览器能通过系统代理访问,说明节点、端口与基础配置大体可用。随后再开启 TUN 并测试不读取系统代理的应用,可以把权限、虚拟网卡和路由问题从节点问题中分离出来。每次只改变一个设置,排查结果更清楚。
当前操作焦点
连接页完全没有目标请求,说明应用没有走到 Clash 的监听入口;出现请求但策略错误,应检查规则和代理组;策略正确却连接失败,再查看节点状态、DNS 结果与日志错误。按链路逐段确认,可以避免同时修改多个无关设置。
PLATFORM ENTRANCE
同一套 Clash 配置可以由不同界面的客户端加载。选择时重点看操作系统、处理器架构、TUN 支持与维护状态,不必把界面外观当作唯一判断标准。
适合常规桌面使用。安装后重点确认系统代理、监听端口和 UWP 应用回环;需要接管更多应用时,再按权限要求配置 TUN。
前往下载下载时区分 Apple Silicon 与 Intel 架构。首次运行可能需要确认网络扩展或系统权限,菜单栏状态与系统代理开关要分别核对。
前往下载适合手机和平板。导入订阅后由系统 VPN 接口接管应用流量,省电策略、后台限制和始终开启设置会直接影响持续连接。
前往下载通过系统网络扩展建立连接,配置、策略组和按需连接均在应用内管理。首次使用先允许添加 VPN 配置,再检查系统状态栏连接状态。
前往下载适合桌面、服务器和路由环境。GUI 客户端便于日常切换,直接运行 Mihomo 内核则需要自行管理配置文件、服务进程和权限。
前往下载QUICK START
初次配置不要同时调整规则、DNS、TUN 和系统代理。先建立一条最小可用路径,再逐项扩展接管范围,任何一步出错都能明确回退到上一个正常状态。
查看完整教程从下载页选择与系统及处理器架构匹配的客户端。首次启动后先查看日志或状态页,确认配置目录可写、监听端口已建立,系统中没有其他代理程序占用同一端口。
在配置页粘贴订阅地址并执行下载。看到配置条目后还要手动选中,使客户端重新载入内核;随后进入代理页,为可选择的策略组选定具体节点。
先开启系统代理,用浏览器访问测试目标并在连接页查找对应请求。浏览器正常后,再单独验证终端和其他应用;需要更广接管范围时,最后配置 TUN 与 DNS。
OPEN SOURCE CONTEXT
判断一个 Clash 客户端是否适合长期使用,需要把图形界面、代理内核、配置格式和订阅来源分开看。它们由不同项目或服务维护,更新节奏也不相同。
Clash 最初以规则驱动的跨平台代理内核形成广泛使用的配置语法和策略模型。原始项目停止更新后,既有配置格式、规则表达和客户端操作方式仍被生态延续。阅读较早教程时,需要先辨认内容讨论的是原始 Clash、后续内核,还是某个具体图形客户端,避免把不同阶段的字段和功能混在一起。
桌面端常见客户端通常由图形界面、配置管理、系统代理控制和内核进程几部分组成。界面项目负责安装体验、订阅更新、策略选择和系统集成;内核负责协议连接、DNS、规则匹配和流量转发。某个客户端界面停止维护,不代表配置语法立即失效,但系统兼容性和内核能力会逐渐拉开差距。
Mihomo 延续 Clash 配置体系,并补充协议、规则、DNS 与 TUN 等能力。多数现代桌面客户端把它作为可替换或内置的运行核心。配置文件能否加载,既取决于 YAML 语法,也取决于当前内核是否支持对应字段。遇到陌生配置项时,应优先核对内核文档,而不是只在客户端界面中寻找同名开关。
客户端更新、内核更新和订阅更新是三条独立链路。客户端更新解决界面与系统兼容问题,内核更新带来协议和网络处理变化,订阅更新则替换节点、策略组与远程规则。日常维护时应分别记录三者状态;出现故障后一次只回退一个环节,才能判断变化来自软件、配置还是订阅内容。
SOURCE COMMAND
下面的命令用于获取公开源码。编译内核需要独立的 Go 开发环境;只需要日常使用时,直接选择带图形界面的客户端更合适。
git clone https://github.com/MetaCubeX/mihomo.git
FIRST CHECKS
下面四类问题覆盖首次使用时最常见的断点。完整操作路径放在入门指南和使用手册中,这里只给出判断方向。
先确认链接返回的是 Clash 可读取的 YAML 配置,而不是网页内容或其他订阅格式;随后检查配置是否下载成功并被设为当前启用项。节点可能位于策略组中,不一定直接显示在首页。
查看订阅导入步骤 →部分终端程序不会读取操作系统代理设置,需要单独配置 HTTP、HTTPS 或 SOCKS 环境变量,也可以按需求使用 TUN。排查时应把浏览器与终端分开测试,分别确认请求是否出现在连接页。
查看系统代理与 TUN →日常使用通常采用规则模式,让本地服务、代理目标和拒绝项分别处理。全局模式适合短时间验证节点是否可连接,不适合代替完整规则。切换模式后应重新建立测试连接,避免旧会话影响判断。
查看代理模式说明 →直接写入远程订阅生成文件的内容,可能在下次更新时被整体替换。长期自定义应使用客户端提供的覆写、合并或脚本机制;修改前保留可启动副本,并确认规则最终插入位置与 MATCH 的先后关系。
查看规则维护方法 →LATEST NOTES
围绕系统代理、Windows 安装和客户端界面三个高频场景,按可复现的检查顺序整理操作细节。
系统代理开了却没走代理时,浏览器与终端不能混在一起判断。文章分别检查代理设置、扩展冲突、环境变量和监听端口。
阅读全文 →从安装包选择、系统提示、订阅导入到系统代理,逐步说明 Windows 上的操作顺序,并处理 UWP 回环、端口占用和开机启动问题。
阅读全文 →按操作目的区分代理页、配置页、连接页和日志页,说明节点选择、订阅管理、实时会话与故障记录之间的关系。
阅读全文 →