Windows
优先查看 Clash Plus,也可比较 Clash Verge Rev、FlClash 与 Clash Nyanpasu。日常桌面使用先配置系统代理;需要覆盖不读取系统代理的应用时,再检查 TUN 服务与权限。不要在首次安装时同时开启多个客户端的接管功能。
下载前在系统信息中确认处理器类型,安装后先导入配置、选择规则模式并检查连接页。若浏览器可用而终端工具失败,应查看工具自己的代理设置或环境变量,不必立即更换订阅。已有旧客户端时,先导出配置与覆写,再安排迁移。
前往下载先确认配置来源与内核能力,再决定流量怎样进入内核、匹配哪条规则。以下窗口是语法与设置示意,不代表当前设备的运行状态。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxies: []
proxy-groups:
- name: 出口
type: select
proxies:
- DIRECT
rules:
- MATCH,出口
结构示例仅使用 DIRECT,未配置远程代理。需要代理连接时,应导入自己的有效配置。
覆写入口与合并规则属于客户端功能,不同客户端可能采用不同实现。
rules:
- DOMAIN-SUFFIX,github.com,代理
- IP-CIDR,192.168.0.0/16,DIRECT
- GEOIP,CN,DIRECT
- MATCH,代理
这里的「代理」必须是已存在的策略组或代理名称。IP 类规则是否触发解析,还取决于规则参数与连接信息。
连接进入内核后,按 rules 顺序决定策略组。
让遵循系统代理设置的应用使用本地代理端口。
检查顺序:应用请求 → 内核连接页 → 命中规则 → 策略组出口。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
- 119.29.29.29
fake-ip-filter:
- "*.lan"
- "localhost"
示例用于说明字段关系。解析服务器的可达性与适用范围需要在当前网络中确认。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
需配合客户端权限、内核支持和已启用的 DNS 模块。加密 DNS 不一定经过传统的 53 端口。
目标域名、测试应用、网络环境、选定代理出口。
规则与全局模式,或系统代理与 TUN 接管。
记录实际差异,再检查对应的配置层,不把一次成功当作持续可用的结论。
进一步查阅 进阶配置手册,按主题核对参数与前提。
首次配置建议沿着「导入配置 → 选择策略组 → 规则模式 → 开启流量入口 → 查看连接」这条路径完成。配置能保存,只能说明客户端接受了当前输入,不代表远程出口、DNS 与系统路由都已工作。验证时打开一个确定的目标页面,在连接页确认域名、命中规则和出口,再测试需要代理的其他应用。与只检查开关状态相比,这种检查能区分请求根本没有进入内核,还是已经进入内核却走错策略。
这里的 YAML 都是局部语法说明,不能将多个片段不加检查地拼在文件末尾。相同顶层键应合并到原有配置中,列表的顺序也可能影响实际行为。订阅由客户端管理时,先确认本地修改是否会被下一次更新替换。需要照着完成首次连接,可使用 Clash 安装与配置教程;已经能够连接、准备细化策略时,再查阅 策略组、规则集与 DNS 的高级用法。
先选操作系统,再选客户端与处理器架构。桌面端、移动端和纯内核的安装方式不同,同一份配置也需要核对字段支持范围。
优先查看 Clash Plus,也可比较 Clash Verge Rev、FlClash 与 Clash Nyanpasu。日常桌面使用先配置系统代理;需要覆盖不读取系统代理的应用时,再检查 TUN 服务与权限。不要在首次安装时同时开启多个客户端的接管功能。
下载前在系统信息中确认处理器类型,安装后先导入配置、选择规则模式并检查连接页。若浏览器可用而终端工具失败,应查看工具自己的代理设置或环境变量,不必立即更换订阅。已有旧客户端时,先导出配置与覆写,再安排迁移。
前往下载按 Apple Silicon 或 Intel 选择安装包,首选 Clash Plus,再根据界面和配置管理需求比较其他客户端。首次启用系统代理、后台服务或网络扩展时,应阅读系统提示,确认授权对象与刚安装的客户端一致。
macOS 的不同网络服务可能保留各自的代理设置,切换有线网络与无线网络后,建议重新确认当前服务的设置。需要 TUN 时先检查服务安装状态,再查看 DNS 和路由。退出客户端后若网络异常,优先检查代理是否恢复,而不是删除整份配置重新开始。
前往下载优先查看 Clash Plus,也可选择 Clash Meta for Android、FlClash 或 Surfboard。安装包要与设备架构匹配;应用首次建立连接时通常需要系统 VPN 授权,这与订阅是否有效是两件事,应分别确认。
移动设备在后台运行时,省电策略可能影响客户端持续工作。若锁屏后连接中断,先查看后台运行限制与 VPN 状态,再排查出口。其他 VPN 应用也可能占用同一系统入口。切换无线网络与移动数据后,使用同一目标复测,有助于判断问题是否只发生在某一种网络。
前往下载iPhone 与 iPad 通过 App Store 获取 Clash Plus,产品官网为 clashplus.io。安装后按客户端支持的入口导入配置,首次连接时根据系统提示允许添加 VPN 配置,再返回应用确认连接状态。
移动端的系统网络接口与桌面端不同,不宜直接照搬桌面客户端的服务安装步骤。导入后先核对策略组与规则,再测试目标应用;如果使用其他网络扩展,应检查是否存在同时启用造成的冲突。订阅更新失败与 VPN 授权失败也应分开排查,前者先看链接与返回内容,后者先看系统设置。
前往下载桌面用户可选 Clash Verge Rev 或 FlClash,按发行版的软件包格式与处理器架构下载。桌面环境的系统代理设置不一定覆盖所有终端程序;需要更广的流量接管范围时,再检查 TUN 权限、路由与 DNS 管理方式。
服务器或路由器用户通常直接部署 Mihomo 内核,并自行管理配置路径、启动参数与进程服务。图形客户端和内核包的用途不同:前者提供配置管理界面,后者需要手工维护运行环境。先确定设备是否有桌面环境,再选择安装形式,可以避免装好内核后找不到界面的误解。
前往下载Clash 客户端、代理服务与订阅提供方属于不同环节。客户端下载完成后,仍需准备有效的配置来源;已有 Clash 机场订阅时,应确认其输出格式与目标客户端兼容。配置中包含扩展协议、规则集或特定 DNS 字段时,客户端名称相近并不能保证可以直接迁移,实际解析能力由内核与客户端实现共同决定。
下载页集中列出安装包、平台要求与维护状态。归档客户端可用于既有环境的兼容需求,新配置应优先使用仍在维护且满足功能要求的实现。安装包、订阅内容和本地覆写分开保存,后续迁移时才能明确哪些内容需要重新获取,哪些内容属于自己的设置。
查看全部客户端 → 查看客户端选型指南 →判断一个客户端是否适合当前环境,需要区分图形界面、实际运行的内核,以及远程订阅提供的内容。项目名称不能代替这三项检查。
Clash 的规则式代理配置形成了广泛使用的客户端生态。原始项目与部分早期客户端停止维护后,社区继续发展兼容实现,Mihomo 是其中持续演进的内核之一。不同客户端可能沿用相近的界面术语,却采用不同内核与配置处理方式。查文档时应先确认当前运行的内核名称,再寻找对应字段说明,尤其不要把旧教程中的限制当作所有现有客户端的共同限制。
历史配置能导入,不代表每个扩展字段都已生效。遇到未知字段、协议不支持或规则集加载失败,应把报错与当前内核文档对照,而不是仅按客户端图标判断兼容性。维护状态同样属于选型条件:归档软件适合特定旧环境的复现,不宜默认承担不断变化的新配置需求。
内核负责接收连接、处理 DNS、执行规则并建立出站连接;图形客户端负责配置导入、策略组操作、系统代理开关、服务安装与日志展示。某个开关是否存在,往往取决于客户端封装;某个配置字段是否支持,则需要看内核能力。出现问题时,先明确故障属于界面操作、配置生成还是内核运行,可以避免在错误的层级反复调整。
同一内核被不同客户端使用时,生成的最终配置仍可能不同。端口、外部控制接口和 TUN 字段可能由客户端注入,远程订阅只是输入的一部分。需要核对实际行为时,查看最终生效配置与日志比只阅读订阅原文更准确。高级用户部署纯内核时,则需要自行承担服务启动、权限管理与配置更新的工作。
Mihomo 的代码、议题和发布记录可在公开仓库查阅。源码与文档能够帮助确认字段的实际含义、问题是否已被讨论,以及某项功能的支持前提。检索议题时附上操作系统、内核信息、最小配置和可重复的操作步骤,比只描述「不能连接」更便于定位。公开提交前,应删除订阅地址、认证参数和不必要的个人访问记录。
仓库克隆命令适合需要阅读源码或研究实现的用户,普通用户安装图形客户端不需要先编译内核。下方命令只下载代码,不会自动安装代理服务,也不会改变系统网络设置。访问开源资料时,以仓库自己的许可证、文档和发布说明为准,避免将第三方界面说明混用为内核接口规范。
更新客户端主要涉及界面、系统集成与内核打包;更新内核可能影响协议支持、规则行为和 DNS 处理;更新订阅则会改变远程代理资源与配置内容。这三种更新不应被当作同一个操作。升级前保留可用配置与本地覆写,升级后使用固定目标检查解析、规则命中和连接出口,再恢复平时的使用方式。
自定义配置较多时,建议记录每次修改的目的,例如为某个局域网域名加入 Fake-IP 排除项,或把某条直连规则移动到兜底规则之前。出现回归后按变更记录回滚,比一次性重置全部设置更容易找到原因。客户端显示更新完成,也不代表运行中的内核与配置已经重新加载,必要时应在客户端内确认实际生效状态。
按具体问题查阅操作步骤。先保留当前可用配置,再对照文章逐项调整;涉及系统权限、DNS 接管与路由的设置,不建议同时修改。
解释虚拟网卡接管流量的原理,对比系统代理与 TUN 的覆盖范围差异,并给出各平台开启 TUN、配合 Fake-IP 与 auto-route 的具体设置。
阅读 TUN 配置说明 →针对 Windows、macOS 与 Android 上客户端启动即退出的情况,说明从日志定位、配置回滚、端口冲突到重装内核的处理顺序。
阅读启动故障清单 →从链接过期、格式不兼容、User-Agent 限制到本地网络拦截,列出订阅拉取失败与 YAML 解析报错的典型提示,并给出按顺序排查的清单。
阅读订阅排查步骤 →