Windows
适合桌面浏览器与日常应用。先在系统信息中确认处理器类型,安装后导入配置,再开启系统代理。需要接管不读取系统代理的应用时,再按教程配置 TUN;不要在首次连接前同时修改多项网络设置。
前往下载先确认操作系统,再确认处理器架构。下载页集中列出客户端选择、安装方式与系统要求;这里的入口会直接打开对应平台,不需要重新寻找标签。
适合桌面浏览器与日常应用。先在系统信息中确认处理器类型,安装后导入配置,再开启系统代理。需要接管不读取系统代理的应用时,再按教程配置 TUN;不要在首次连接前同时修改多项网络设置。
前往下载按 Apple Silicon 或 Intel 选择安装包。在系统的“关于本机”中查看芯片信息,安装后按提示授权网络功能。切换客户端前,先关闭旧客户端的系统代理,避免后台进程继续占用端口或改变网络设置。
前往下载适合手机与平板。根据设备架构选择安装包,导入订阅后允许建立 VPN 连接。系统通常只允许一个应用占用 VPN 通道;若连接启动失败,先检查其他 VPN 应用。后台连接容易中断时,再检查电池优化与后台运行权限。
前往下载适合 iPhone 与 iPad。下载页提供 Clash Plus 的 App Store 入口,官网为 clashplus.io。安装后导入配置并完成 VPN 授权,再回到客户端启动连接。使用前确认订阅格式与客户端支持范围。
前往下载桌面用户可选择图形客户端,按发行版的包管理方式安装。服务器、路由器用户可在下载页查看内核入口,但需要自行管理配置、服务权限和路由。图形界面启动成功不等于网络已接管,仍需确认代理入口与规则命中情况。
前往下载从分流规则到网络接管,五项配置分别解决不同问题。先理解每一层的职责,再决定是否启用。以下为 mihomo 配置示意,客户端入口名称与可用选项可能不同,片段不能直接当作完整配置导入。
规则模式按配置中的顺序检查连接,命中后交给对应策略处理。具体域名规则应放在宽泛规则之前,最后用 MATCH 承接剩余连接。策略组决定可选出口,规则决定哪些连接进入该组,两者不能互相替代。与统一使用一个出口的全局模式相比,规则模式能保留直连路径,并按用途组织代理流量。修改后先查看连接记录中的命中规则,再判断是否需要调整顺序。
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT
规则自上而下匹配,MATCH 放在末尾。
配置管理用于保存不同来源的订阅与本地 YAML 文件。导入后先给配置起一个容易辨认的名称,再确认当前启用的条目;下载成功不代表内核已经切换。远程订阅更新会刷新其内容,本地文件则适合保留可控的实验配置。与把所有修改写进订阅原文相比,客户端支持的覆写机制更便于保留个人设置。多份配置切换通常是整份替换,并不会自动合并策略组与规则。
更新前保留本地覆写,切换后确认当前条目。
TUN 通过虚拟网卡与路由设置把连接送入内核,适合不读取系统代理的应用。它不同于浏览器的代理设置,也不等于开启后所有连接都会走代理;进入内核的连接仍然按模式与规则选择出口。首次启用通常需要服务组件或系统权限。建议先验证普通代理可用,再开启 TUN,并检查局域网访问和 DNS 解析。遇到其他 VPN 冲突时,先停用其中一个,而不是反复叠加路由设置。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
自动路由需要平台支持与相应权限。
DNS 决定域名如何解析,Fake-IP 则用映射地址关联域名与后续连接,帮助内核按域名规则处理流量。它不是公共 DNS 地址,也不能单独修复失效的订阅。与直接返回真实地址的处理方式相比,Fake-IP 依赖内核维护映射,部分局域网服务需要按实际情况加入过滤。修改前先确认 DNS 请求是否进入内核,以及解析上游是否可达。排查时逐项调整,避免同时更换模式、上游与接管方式。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
nameserver:
- 1.1.1.1
映射地址由内核处理;上游需按网络环境选择。
外部控制接口让兼容面板读取内核状态、查看连接与切换策略。它与提供代理服务的监听端口用途不同,填错端口会造成面板连接失败。图形客户端通常已集成相关管理功能,服务器用户才更常需要单独部署面板。相比直接编辑运行中的配置,控制面板适合观察与临时操作,但设置是否持久保存取决于实现。默认优先绑定本机地址,并配置访问密钥,不要把控制接口直接暴露到公共网络。
external-controller: 127.0.0.1:9090
secret: "your-password"
仅绑定本机;示例密码需在本地替换。
先用客户端默认选项建立稳定基线,再逐项扩展功能。需要完整参数、策略组类型与规则集管理时,阅读配置进阶;遇到不熟悉的字段,可先在术语表中查阅其职责。
首次使用先完成一条最短的验证路径:配置能加载、连接能进入客户端、目标请求能按预期处理。下面三步只保留主线,不要求先掌握全部参数。不同客户端的按钮位置可能不同,但配置、模式和网络入口的关系一致。
打开配置管理页,将订阅地址粘贴到链接输入框,点击导入。待配置条目出现后,选择它作为当前配置。若使用本地文件,则选择文件导入,并确认文件内容是客户端支持的 YAML,而不是网页文本或错误提示。
接着查看是否有解析错误。只有条目名称出现还不够,还要确认内核已加载该配置。导入失败时先检查链接是否完整、订阅是否有效,以及系统时间是否准确;暂时不要修改 DNS 或 TUN,以免混淆问题来源。
日常使用通常从规则模式开始,再在代理页面选择配置中的策略组与出口。桌面端先开启系统代理;移动端按提示完成 VPN 授权。需要 TUN 时,等基础连接验证成功后再启用,并按客户端要求安装服务或授予权限。
全局模式可用于临时区分规则问题与连接问题,直连模式则不会按代理策略转发请求。模式切换不应替代配置检查。若应用自行设置了代理,或已有其他 VPN 运行,先理清请求究竟进入哪一个网络入口。
打开需要访问的页面,再回到客户端查看连接记录。确认请求出现、命中规则符合预期、选择的策略与出口正确。还应检查一个需要直连的页面或局域网服务,避免只验证单一网站而忽略正常网络访问。
页面打不开时,先区分“没有连接记录”与“有记录但连接失败”。前者通常应检查系统代理、VPN 授权或应用设置,后者再检查出口、订阅与解析。保存错误提示并逐项复测,比一次改变多个开关更容易定位原因。
Clash 生态包含内核、图形客户端、配置工具和控制面板,名称相近并不意味着它们属于同一个项目。原始 Clash 项目与后续社区实现需要分别看待;mihomo 延续了 Clash Meta 相关技术路线,是当前许多客户端采用的开源内核。旧教程中的截图、菜单或字段可能来自已经停止维护的客户端,操作时应以正在使用的项目文档为准。
下载页对归档客户端单独标注,方便需要兼容旧环境的用户识别。选择时优先考虑仍在维护、适配当前系统的实现,不应只根据名称是否熟悉作决定。首页不展示具体发布编号,客户端发布信息集中留在下载页,避免将内核发布与图形界面发布混为一谈。
内核负责解析配置、建立连接、匹配规则并执行 DNS 与网络接管逻辑;图形客户端提供订阅管理、模式切换、系统代理、日志查看等操作入口。因此,相同内核能力在不同客户端里可能有不同的开关名称,甚至由服务组件代为管理。使用某个字段之前,既要确认内核支持,也要确认客户端是否允许直接编辑或覆写。
客户端更新与内核更新不是一回事。更新界面后,某项网络行为不一定改变;替换内核后,配置的兼容性也可能变化。排查时记录客户端名称、系统环境、启用模式和错误提示,比只描述“已经更新”更有帮助。需要重现问题时,尽量使用最小配置,并先去除与问题无关的规则和覆写。
mihomo 的公开仓库提供源码、许可证、问题讨论与发布说明,许可证采用 GPL-3.0。开源意味着实现可以被查阅,维护状态也能通过公开记录判断,而不是由下载页面上的宣传决定。协议支持、字段行为与已知问题应参考内核文档及发布说明;某个客户端的界面功能则应查阅该客户端自己的说明。
向社区提交问题前,先搜索是否已有相同现象,并整理复现步骤。日志中的订阅地址、访问密钥、出口地址和个人访问记录可能包含敏感信息,不应直接公开完整原文。分享经过整理的错误片段、相关配置字段与实际观察结果,更有利于讨论。本站提供中文导航与操作说明,具体项目的维护责任和许可证以各自仓库为准。
软件更新改变客户端或内核实现,订阅更新刷新连接信息、策略与规则,两者应分别处理。更新订阅前,确认个人修改是否保存为本地覆写;更新软件前,备份当前配置和必要设置,并阅读与网络行为有关的变更。不要把远程订阅原文当作永久保存个人设置的地方,因为下一次更新可能覆盖这些编辑。
升级后若出现异常,先检查内核是否成功加载、覆写是否仍生效,以及系统代理或 TUN 是否重新启用。网络可用时不必为了追逐某个编号频繁改变配置;需要新增能力或解决已知问题时,再依据发布说明安排更新。任何一次修改都应留有可恢复的基线,便于判断变化来自软件、配置还是当前网络环境。
基础连接完成后,再按具体症状深入排查。以下文章分别从证书验证、启动日志与连接路径入手,先解释现象发生在哪一层,再给出检查顺序;阅读时可保留当前配置,按单一变量逐项复测。
解释证书报错的常见成因,分清哪些与代理有关、哪些来自系统时间或网络劫持,并给出按情况处理的思路。
阅读文章 →从配置语法错误、内核文件缺失、权限不足、残留进程四个方向定位启动闪退,介绍各平台日志位置与重置配置的步骤。
阅读文章 →按订阅有效性、系统时间、端口占用、DNS 解析、规则命中的顺序逐项排查节点超时,每一步都给出判断依据和处理办法。
阅读文章 →