Windows
适合在桌面端管理订阅、系统代理与开机启动。可先比较 Clash Plus、Clash Verge Rev 等客户端的界面与内核支持,再按系统要求安装。
首次运行先导入配置并验证浏览器请求;确有需要时再配置服务权限与 TUN。保留旧客户端时,避免两个程序同时设置系统代理或占用同一端口。
前往下载从配置来源到连接去向,按问题查找对应设置。
在客户端的配置页粘贴订阅 URL,导入成功后还要选为当前配置。远程配置更新会重新获取 YAML,代理提供者与规则提供者则可以按各自的间隔刷新;这三类更新不能混为一谈。本地文件便于离线备份,但通常不会自动跟随远端变化。直接修改下载后的配置可能在下次刷新时被覆盖,持久调整应使用客户端的覆写或合并功能。遇到更新失败,先确认 URL 是否仍有效,再检查请求日志与获取订阅时使用的网络路径。
查看订阅导入步骤 →# 配置文件中的代理提供者片段
# interval 的单位为秒
proxy-providers:
remote:
type: http
url: "https://example.com/proxies.yaml"
path: ./providers/remote.yaml
interval: 86400
规则模式按配置列表自上而下查找,首次命中后便交给对应策略处理,因此具体域名规则应放在宽泛规则之前,兜底规则放在末尾。规则指向的可以是直连、拒绝或已定义的策略组,而不是任意文字。与全局模式相比,分流允许不同应用请求走不同路径,但效果取决于域名识别、解析方式与规则资源是否可用。调整后应新建连接并在连接页查看命中项,不要只根据网页是否打开判断规则是否生效。订阅自带的规则与本地覆写也需要核对最终合并顺序。
查阅规则与覆写说明 →mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- DOMAIN-SUFFIX,example.org,REJECT
- MATCH,DIRECT
规则模式根据规则列表分流,全局模式把已进入内核的连接交给全局策略处理,直连模式则让这些连接直接访问目标。三者决定的是连接进入内核之后如何处理,不决定应用是否使用客户端。系统代理主要影响遵循系统代理设置的程序,TUN 则通过虚拟网卡接管更多流量。网页打不开时,先检查应用请求有没有出现在连接页,再判断模式与策略组;反复切换全局模式并不能修复没有进入内核的请求。测试完成后恢复日常使用的规则模式,避免把临时排查设置长期保留。
区分代理模式与接管方式 →# 三种模式择一配置
mode: rule
# 系统代理与 TUN 为客户端中的独立设置
# 全局模式对应 mode: global
# 直连模式对应 mode: direct
部分游戏、命令行工具或后台服务不读取系统代理,TUN 可以通过虚拟网卡与路由配置让这些请求进入内核。启用前先确认客户端具有所需权限,且没有其他 VPN 同时修改默认路由。自动路由与 DNS 接管相互关联,单独打开开关不代表所有协议都已正常工作。与手动给应用填写代理端口相比,TUN 的覆盖范围更广,也更容易受到网卡、局域网路由与安全软件影响。建议先验证普通网页连接,再启用 TUN 逐项测试;发生冲突时先关闭接管恢复网络,再根据日志定位原因。
阅读 TUN 配置与排查顺序 →# mihomo 配置片段,需相应系统权限
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
DNS 负责将域名映射到地址,解析路径也会影响内核能否正确识别域名并匹配规则。Fake-IP 使用保留地址建立域名映射,并不是提供新的网络出口;它需要与流量接管方式配合使用。与返回真实地址的解析方式相比,Fake-IP 有利于保留域名关联,但部分局域网服务与特殊应用需要过滤。发现解析异常时,先检查 DNS 请求是否进入内核、上游服务器是否可达,再处理应用缓存与系统加密 DNS 设置。不要同时更换上游、切换模式和修改过滤列表,否则难以判断是哪项调整产生了效果。
查阅 DNS 设置说明 →dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "localhost"
先按操作系统筛选,再确认处理器架构和安装包格式。客户端负责界面、系统集成与配置管理,内核负责协议处理和规则执行;界面相似,不代表支持的配置字段完全一致。迁移之前建议保留订阅来源与覆写文件,不直接覆盖原来的工作配置。
适合在桌面端管理订阅、系统代理与开机启动。可先比较 Clash Plus、Clash Verge Rev 等客户端的界面与内核支持,再按系统要求安装。
首次运行先导入配置并验证浏览器请求;确有需要时再配置服务权限与 TUN。保留旧客户端时,避免两个程序同时设置系统代理或占用同一端口。
前往下载下载前区分 Apple Silicon 与 Intel 处理器。系统代理、菜单栏操作和后台服务的实现因客户端而异,安装包应与设备架构匹配。
更换客户端后重新检查系统网络代理,不要假设旧设置已经清除。需要接管终端或其他应用时,应单独确认该程序的代理环境或 TUN 状态。
前往下载按处理器架构选择安装包,并留意客户端使用的 VPN 接管方式。首次连接时按系统提示授权,然后检查配置是否已选中,而不只是完成导入。
后台更新受到电池优化、后台网络权限和进程状态影响。订阅无法定时刷新时,先测试前台手动更新,再检查系统是否限制了客户端后台运行。
前往下载查看 Clash Plus 的 App Store 入口与官网资料。移动系统的网络扩展由客户端管理,订阅导入方式、更新选项和配置兼容性应以应用内说明为准。
导入后先选择配置,再按系统提示允许建立 VPN 连接。网络切换后若访问异常,先检查扩展连接状态与配置资源更新结果,再调整分流设置。
前往下载桌面环境可比较 Clash Verge Rev 与 FlClash,按发行版选择 DEB 或 RPM 等包格式。无桌面的服务器和路由器通常直接部署内核,另行配置服务与权限。
安装成功只说明程序可以运行,还需要检查依赖、端口监听与系统代理是否接入。服务方式启动时,应核对工作目录、配置路径与资源文件写入权限。
前往下载平台图标:Windows、Apple、Android 采用 Simple Icons 矢量;Linux Tux 采用 Font Awesome,CC BY 4.0 矢量。
客户端安装、配置导入和流量接管是三个独立环节。按照下面的顺序验证,能够把订阅获取问题与应用连接问题分开,不必一开始就改动所有高级选项。
打开配置或订阅页,粘贴由配置提供方给出的 URL;若只有本地 YAML 文件,则使用文件导入。等待客户端完成解析后选中该配置,检查是否存在语法错误或不支持的字段。导入成功并不等于已激活,最终应在当前配置标记与日志中确认加载结果。
保留配置中已有的策略组结构,先使用规则模式。桌面端可从系统代理开始,手机端按提示允许 VPN 连接。对于不读取系统代理的应用,再考虑 TUN 或应用自身的代理设置。每次只调整一项,记录调整前的状态,便于异常时恢复。
重新打开目标网页或应用,在连接页确认请求进入内核,并查看命中的规则与策略。随后手动更新一次订阅,确认获取路径正常,再启用客户端支持的自动更新。界面里的分钟与配置字段里的秒需要分别核对,避免把资源更新时间设置得过于频繁。
原版 Clash 为这一生态建立了常见的 YAML 配置与规则表达方式。Clash Meta 在此基础上扩展协议、规则和网络栈能力,后续以 mihomo 名称继续维护。教程中的旧名称有时仍会出现,但判断字段是否可用,应以实际运行的内核文档为准,而不是只看客户端名称。
图形客户端通常将内核与平台功能组合在一起:前者处理请求,后者管理订阅、系统代理、日志和权限。同一份配置在不同客户端中的导入体验可能不同,部分客户端还会生成或合并运行配置。因此排查时需要同时记录客户端名称、内核类型与最终生效的字段。
Clash资源网整理下载入口、操作步骤与术语关系,不代表各客户端的开发团队。程序的功能变更与平台限制应结合上游说明判断,下载目录用于帮助选择系统与包格式,教程则解释配置字段及常见操作之间的联系,不把所有生态应用视为同一款软件。
客户端更新可能改变界面、系统集成或内置内核;内核更新影响协议解析与配置兼容性;订阅更新则重新取得配置或资源内容。升级程序不会自动延长订阅有效期,刷新订阅也不会让旧内核获得新的协议能力。处理问题时先确定出错的是哪一层,再选择对应操作。
更新前备份本地覆写与已验证可用的设置,阅读更新说明中涉及的配置变化。更新后先检查启动日志,再验证 DNS、规则命中与应用连接。出现异常时,可以回到原来的配置对照,而不是继续叠加临时修改。对规则资源的调整也应保留来源,避免只剩下无法解释的最终配置。
需要进一步理解原版内核、Meta 与 mihomo 的关系,可阅读内核演进与功能对照;准备部署路由器或服务器时,再结合运行平台的网络与权限说明。
源码、发行说明与问题讨论可在 MetaCubeX/mihomo 查阅。克隆仓库用于阅读或参与开发,并不等于完成客户端安装;只需要图形界面时,直接按平台选择安装包。
git clone https://github.com/MetaCubeX/mihomo.git
基础操作完成后,再按具体问题阅读专题。速度异常先做对照测试,路由器部署先明确流量入口,新手问题则从系统代理、模式与端口检查开始;不同问题需要不同证据,不宜使用同一套设置反复尝试。
按节点、线路、本地设置三层拆解速度慢的原因,介绍测速对比、换线路验证、规则与 DNS 检查、系统代理和 TUN 设置复核的顺序与判断方法。
阅读文章 →概览在主路由与旁路由上运行 mihomo 内核的几种方式,涵盖架构选择、透明代理与 TUN 取舍、DNS 接管和局域网设备网关设置的要点。
阅读文章 →集中解答新手最常卡住的十个问题:客户端怎么选、系统代理与 TUN 的区别、规则模式含义、端口冲突、网页打不开等,每条给出直接可操作的答案。
阅读文章 →订阅更新失败:先确认链接是否返回配置,再检查获取请求的日志,按照订阅更新排查说明区分访问错误、解析错误和资源更新错误。
DNS 与 Fake-IP:先弄清解析请求从哪里发出,再决定是否调整接管与过滤列表;概念不明确时,可先查看Fake-IP 术语解释,再进入完整手册修改配置。