Windows
从 Clash Plus、Clash Verge Rev 等客户端中选择。桌面使用可先启用系统代理,确认浏览器连接正常后,再按应用需要考虑 TUN。安装前检查系统要求与处理器类型,升级时保留订阅来源和本地覆写规则。
前往下载CONFIGURATION / 配置能力
从流量接管到策略匹配,按用途查看配置片段。示例为局部字段,需要与有效节点和策略组组合使用。
规则模式按列表从上到下匹配,命中后使用对应策略,不再继续尝试后面的规则。域名后缀适合覆盖某项服务,关键词用于较宽泛的域名匹配,地理数据库规则则补充地址判断。相较于把所有连接交给同一个出口,规则分流可以为开发服务、局域网资源和日常网站分别安排路径。具体域名放在前面,兜底规则放在最后;示例中的 PROXY 必须是配置中已存在的节点或策略组名称。
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- DOMAIN-KEYWORD,google,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
系统代理需要应用主动遵循代理设置,部分命令行工具与网络程序不会读取这些设置。TUN 模式通过虚拟网络接口与路由接管连接,适合需要扩大接管范围的场景。开启前先完成普通代理连接测试,再按客户端要求安装服务或授予权限。自动路由、接口识别和 DNS 接管应配套检查;其他 VPN、虚拟机网卡或企业网络策略可能影响结果。TUN 解决的是流量如何进入内核,不会替代节点选择与分流规则。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
图形客户端通常在配置页提供订阅地址导入入口,下载内容可能是完整 YAML,也可能只是需要转换的节点集合。导入后应确认策略组、规则和节点都已加载,再启用系统代理。与逐个手填服务器参数相比,订阅便于集中更新;但更新也可能覆盖直接写在远程配置里的修改。需要长期保留的本地规则,应优先使用客户端的覆写或合并能力。下方展示本地文件型节点提供器,不是可以直接粘贴到订阅输入框的地址。
proxy-providers:
local-nodes:
type: file
path: ./providers/nodes.yaml
health-check:
enable: false
mihomo 支持 Shadowsocks、VMess、Trojan、VLESS、Hysteria2、TUIC 等代理类型,具体可用字段取决于内核实现和服务端设置。同样显示为节点,底层传输、认证参数与 UDP 行为也可能不同。选择协议时先检查客户端支持,再核对服务端参数,不宜仅凭名称判断速度。与只支持单一订阅格式的工具相比,多协议内核便于统一组织策略组;但把节点类型改名并不能完成协议转换。示例使用保留域名与教学口令,不能用于实际连接。
proxies:
- name: trojan-example
type: trojan
server: proxy.example.com
port: 443
password: "your-password"
sni: proxy.example.com
udp: true
Fake-IP 使用保留地址与域名建立映射,让内核在连接到来时保留域名信息,便于执行域名规则。它不是目标服务器的真实地址,也不是一份可分享给其他设备的解析结果。相较于依赖真实地址再判断目标的方式,映射可减少部分解析等待,但局域网发现、打印设备或特殊应用可能需要例外。遇到兼容问题时先确认 DNS 是否确实进入内核,再针对具体域名设置过滤,不要把整个过滤列表清空或不断切换模式来掩盖配置错误。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "*.local"
nameserver:
- 223.5.5.5
外部控制接口供面板读取策略组、连接、规则与日志,也可用于切换策略。它与接收浏览器请求的混合端口用途不同,不能互相替代。桌面客户端往往已经管理该接口,通常不必手动新增一组配置;独立运行内核时才需要按部署方式设置。相较于仅编辑文件,面板适合核对实际生效状态。建议先绑定本机回环地址,避免直接暴露到公共网络;确需远程访问时,再配置认证与访问控制。示例只演示本机监听字段。
external-controller: 127.0.0.1:9090
log-level: info
mode: rule
# 图形客户端用户优先使用内置面板
# 远程管理前另行配置认证与访问控制
OPEN SOURCE / 内核与客户端
客户端负责交互,内核负责连接。理解两者的边界,再选择安装包、排查问题与安排更新。
Clash 最初以规则驱动的代理内核为基础,围绕它形成了图形客户端、配置编辑器和控制面板等工具。原版项目停止维护后,社区分支继续演进。Clash Meta 后来采用 mihomo 名称,因此旧教程里的 Meta 内核与新资料里的 mihomo 存在沿革关系,但不能据此认为所有旧配置都与当前字段完全一致。
安装包的名称也不等于内核名称。Clash Verge Rev、FlClash 等客户端各自组织界面、系统代理、服务安装与配置管理;底层连接能力仍需结合它们实际使用的内核判断。阅读旧文章时,先辨认讨论的是图形界面还是内核参数,再决定操作是否适用,能减少在不同客户端里寻找同名按钮的困惑。
mihomo 仓库公开源代码,并采用 GPL-3.0 协议。源码、议题记录与发布说明提供了理解实现和定位兼容问题的依据。不同图形客户端拥有各自的许可证与维护节奏,不能把内核的许可条件直接当成所有安装包的统一声明。重新分发或修改软件前,应阅读对应项目的许可证文件与相关说明。
本站提供安装包导航与中文技术内容,不替代上游项目的发布说明,也不代表各客户端的维护组织。涉及某个字段是否支持、某项系统权限为何需要时,应以对应客户端和内核文档为准。问题报告应保留系统类型、复现步骤和必要日志,同时移除订阅地址、口令与其他私人参数。
图形客户端更新、内核更新、订阅更新与规则集更新属于不同操作。界面更新可能改变服务安装方式;内核更新可能调整字段行为;订阅更新则主要替换配置内容。一次只改变一个环节,保留原配置副本,再验证连接与分流,通常比同时更新所有组件更容易确认故障来源。
远程订阅的内容也需要与本地设置区分。直接修改订阅下载后的文件,可能在下一次刷新时被覆盖。对固定的局域网直连规则、个人策略组或 DNS 例外,优先使用客户端提供的覆写机制,并记录修改原因。迁移客户端时先导入原配置,再核对混合端口、DNS 和 TUN 行为,不要把旧界面的开关位置当作配置标准。
代理开关处于开启状态,只能说明某项接管设置已启用,不能直接证明所有应用都已使用代理。验证时应检查实际连接是否进入内核、命中了哪条规则、最终选择了哪个策略。浏览器与终端可能采用不同的代理来源,局域网应用也可能绕过系统代理,因此应按应用分别核对。
排查优先顺序是配置能否加载、节点参数是否正确、DNS 是否正常、流量是否进入内核,最后再检查规则和 TUN 路由。不要仅凭一次连接结果判断整个客户端。有关协议差异和内核兼容性的细节,可继续阅读协议与内核技术参考;字段名称不熟悉时,可先查阅概念速查。
git clone https://github.com/MetaCubeX/mihomo.git
PACKAGES / 按平台选择
先确定操作系统,再核对处理器架构和软件维护状态。以下入口跳转到下载页的对应平台,不会直接开始下载。
从 Clash Plus、Clash Verge Rev 等客户端中选择。桌面使用可先启用系统代理,确认浏览器连接正常后,再按应用需要考虑 TUN。安装前检查系统要求与处理器类型,升级时保留订阅来源和本地覆写规则。
前往下载区分 Apple Silicon 与 Intel 安装包。首次打开时按系统提示处理应用权限;需要网络扩展或后台服务的功能,应结合客户端说明操作。选择归档客户端前,先确认它是否仍适合当前系统与订阅配置。
前往下载按设备架构选择安装包,并在首次连接时确认系统 VPN 授权。移动端后台限制可能影响持续连接,需检查电池管理设置。导入前确认订阅格式与客户端兼容,切换网络后再验证 DNS 和应用访问情况。
前往下载下载页提供 Clash Plus 的 App Store 入口及官网 clashplus.io。安装后按照客户端引导导入配置并授权 VPN。移动系统的网络接管方式与桌面系统代理不同,迁移时应重新核对策略组和连接设置。
前往下载桌面用户可选择 Clash Verge Rev 或 FlClash,安装包格式应与发行版匹配。服务器和路由器用户可在下载页查看内核区,另行管理服务、权限与配置文件。图形客户端的安装步骤不能直接替代服务器部署流程。
前往下载安装包只提供客户端程序,不会自动生成可用节点。连接前还需要合法取得的节点参数或订阅配置,并确认其协议类型受当前内核支持。
初次使用优先阅读上手教程。已有配置但准备更换客户端时,先比较平台支持、配置管理与网络接管方式,再导入原文件。
查看客户端对比 →完成安装后,先进入配置管理页导入订阅或本地 YAML,等待客户端下载并解析内容。确认策略组中出现可选择的节点,再启用适合当前场景的接管方式。只打开系统代理而没有有效配置,或只有节点列表却没有相应策略组,都可能导致请求无法按预期处理。具体按钮名称以所选客户端为准,完整操作见Clash 配置教程。
首次验证建议保留配置原有的规则模式,分别测试需要代理的服务与本地资源。若某个应用未进入内核,先检查它是否遵循系统代理,而不是立即修改节点参数。只有确认需要接管此类连接时,再启用 TUN 并处理权限与路由。全局模式适合临时判断出口是否可用,不宜用来代替对规则匹配结果的检查。
客户端提供订阅管理、系统设置与界面交互,内核承担代理连接、DNS 与规则匹配。同一类界面不代表内核能力相同,排查时应同时确认二者。可在概念速查中了解内核与客户端的区别。
订阅描述节点、策略和规则,策略组决定匹配到某个规则后实际使用哪个出口。部分配置使用手动选择组,导入成功后仍需选定可用节点。先检查组内选择,再查看连接记录,避免只反复刷新订阅。
不一定。接管方式取决于应用行为与客户端实现。初次使用先验证系统代理;只有需要接管不遵循系统代理的程序时,再评估 TUN。两者同时开启时应注意重复接管与其他 VPN 的路由冲突,相关名词见网络栈术语说明。
远程更新可能重新生成配置文件,覆盖直接写入文件的内容。将需要长期保留的规则迁移到客户端支持的覆写配置中,并检查合并后的实际规则顺序。备份原文件后再调整,每次只修改一项,便于确认效果。
TECH NOTES / 技术笔记
按内核差异、日志定位与配置能力整理。先确认适用范围,再将文章中的局部配置合并到自己的文件。
按时间线理清三代内核的来历与命名变化,对照配置字段、协议支持与客户端适配情况,帮助判断旧配置能否直接沿用。
阅读内核差异 →按日志级别拆解客户端输出,逐条解释连接超时、解析失败、端口占用、配置解析错误等常见报错,给出从日志定位到具体配置项的排查步骤。
阅读日志排查 →梳理 mihomo 在原版基础上扩展的能力:规则集远程加载、流量嗅探、VLESS 与 Hysteria2 支持,以及对应的配置写法。
阅读配置能力 →