Windows
优先从 Clash Plus 开始,也可比较 Clash Verge Rev、FlClash 等客户端。先在系统“关于”中确认设备架构,再按下载页说明选择安装包。旧版 Clash for Windows 已停止维护,保留配置用于迁移比长期依赖归档程序更合适。
系统代理适合浏览器等常用应用。开启 TUN 前先确认服务组件已经安装;若同时运行其他网络接管工具,先关闭其中一个,再检查路由与连接记录。
前往下载 Windows 客户端CONFIG.YAML / 配置批注
先看配置解决什么问题,再决定是否开启。以下片段用于解释字段,不是可以直接连接的完整配置;节点、策略组和解析器仍需按订阅与网络环境补齐。
mixed-port: 7890allow-lan: falsemode: rulelog-level: info
规则模式按配置中的匹配条件决定直连或代理,适合同时访问本地资源和远程服务。在客户端的模式菜单选择“规则”,并确认使用的订阅带有规则与策略组。全局模式会把已接管的流量交给全局策略,适合临时对照排查,但不能代替系统代理或 TUN 开关。若某个网站走错线路,先在连接记录中查看命中项,再修改规则;频繁切换模式只会掩盖真正原因。不同客户端的按钮名称可能不同,内核的这层分流逻辑相同。
tun: enable: true stack: mixed auto-route: true auto-detect-interface: true
TUN 通过虚拟网卡与路由接管流量,适合游戏、命令行工具等不读取系统代理的程序。桌面客户端通常需要安装服务或授予管理员权限,手机端则需要批准系统 VPN 请求。建议先用系统代理验证订阅可用,再单独测试 TUN,避免把权限问题误当成节点故障。它不是速度增强开关,也不能保证所有流量都被接管;其他 VPN、虚拟机网卡和自定义路由可能影响结果。开启后若局域网设备无法访问,应检查路由排除项,而不是直接删除全部规则。
dns: enable: true enhanced-mode: fake-ip fake-ip-range: 198.18.0.1/16
fake-ip 为域名分配虚拟地址,便于内核在连接阶段保留域名信息并执行分流。它需要与实际 DNS 接管方式配合,不能只改这一行就认定解析请求全部进入客户端。可先检查客户端是否启用 DNS,再核对 TUN 的 DNS 劫持、浏览器安全 DNS 和系统私有 DNS。少数局域网服务或依赖真实地址的应用可能需要加入过滤列表。看到虚拟地址不等于解析出错;出现兼容问题时,应针对域名添加例外,并在修改后清理缓存重新测试。
proxy-providers: service: type: http url: "https://example.com/proxies.yaml" path: ./providers/service.yaml interval: 86400
代理集合可以定时拉取节点列表,让本地规则不必随着节点更新反复重写。示例地址仅解释结构,实际使用要填入服务提供方支持的代理集合地址,并在策略组中通过 use 引用。这里的更新间隔以秒计,过于频繁通常没有必要。客户端的“订阅配置更新”与内核的代理集合更新不是同一件事,完整配置订阅也不一定能直接作为集合使用。遇到失败先看返回内容、地址有效期与下载路径权限,再调整网络访问方式,避免反复重装客户端。
rules: - DOMAIN-SUFFIX,example.com,DIRECT - GEOIP,CN,DIRECT - MATCH,DIRECT
规则按顺序检查,较具体的域名条件应放在较宽泛的条件之前,最后再放兜底规则。示例使用直连目标演示语法;如需代理,应换成配置中已存在的策略组名称,名称和大小写都要对应。订阅更新可能覆盖直接写入的规则,长期修改更适合放在客户端的覆写或合并配置里。排查时查看连接记录中的域名、命中规则和最终出口,不能只凭网页是否打开判断分流是否正确。规则集下载失败与节点不可用也属于不同问题,应分别确认。
CLIENTS / 按设备选择
先选系统,再核对处理器架构和客户端要求。桌面端、手机端可以使用同一服务提供方的订阅,但界面操作、支持字段和系统接管方式不一定相同,不建议直接复制整套本机设置。
优先从 Clash Plus 开始,也可比较 Clash Verge Rev、FlClash 等客户端。先在系统“关于”中确认设备架构,再按下载页说明选择安装包。旧版 Clash for Windows 已停止维护,保留配置用于迁移比长期依赖归档程序更合适。
系统代理适合浏览器等常用应用。开启 TUN 前先确认服务组件已经安装;若同时运行其他网络接管工具,先关闭其中一个,再检查路由与连接记录。
前往下载 Windows 客户端下载前通过“关于本机”区分 Apple Silicon 与 Intel。Clash Plus、Clash Verge Rev 和 FlClash 的操作方式各有侧重;已有旧配置的用户,应重点核对覆写规则、代理端口和登录后启动设置,而不是只看菜单栏外观。
首次运行需要按系统提示处理应用权限。系统代理与网络扩展的授权是不同环节,安装完成不代表流量已经接管。操作路径见完整文档的平台章节。
前往下载 macOS 客户端可从 Clash Plus、Clash Meta for Android、FlClash 等选项中按习惯选择。安装包架构要与设备匹配,常见新设备使用 ARM64,但仍应以系统信息为准。导入后先确认配置已选中,再批准系统 VPN 连接请求。
如果切到后台后连接中断,检查系统电池管理和后台限制。不要为了保活直接打开所有常驻功能;频繁测速、过短的更新间隔也会增加耗电。
前往下载 Android 客户端Clash Plus 通过 App Store 安装,官网为 clashplus.io。在应用内导入订阅、选择配置并允许添加 VPN 配置。桌面端配置中与系统服务有关的字段,不应直接照搬到手机端。
连接由系统网络扩展管理,后台行为与桌面不同。连接异常时先检查配置是否有效,再查看应用日志;是否使用按需连接,应结合实际网络切换习惯决定。
前往下载 iOS 客户端桌面用户可优先比较 Clash Verge Rev 与 FlClash,按发行版选择适合的包格式。服务器和路由器用户则更适合阅读 mihomo 内核说明,单独配置启动服务、文件目录及运行权限,不必安装图形界面。
桌面环境的系统代理不一定作用于终端程序。先确定应用使用环境变量、显式代理参数还是 TUN,再观察请求是否进入内核;远程操作时尤其要保留原有管理连接。
前往下载 Linux 客户端查看全部客户端 → 系统要求、架构选项与归档说明集中在下载页。
QUICK START / 三步预览
客户端只是处理配置和网络请求的工具,不会自动提供节点。开始前准备服务提供方给出的有效订阅链接,并确认设备时间正确、当前网络能够访问订阅地址。订阅链接可能包含访问凭据,不要粘贴到公开讨论区或截图中。
在客户端找到“配置”“订阅”或“Profiles”,选择从链接导入,粘贴完整地址后执行更新。导入成功后还要选中这份配置,检查策略组是否出现。只有一个订阅名称但没有节点时,先阅读更新日志,区分地址失效、返回格式错误和网络请求失败,不要立刻开启全局模式反复尝试。
如果提供方给出多个格式入口,选择与当前内核兼容的 Clash 或 mihomo 配置。手动编辑前先备份原文件,尤其注意 YAML 的缩进与冒号后空格;节点密码等敏感字段不应发给他人排查。查看订阅导入步骤 →
初次使用先选规则模式,在策略组中选择一个可用节点,再开启系统代理。手机端按系统提示允许 VPN 连接。确有应用不遵循系统代理时,再测试 TUN,并确认权限已授予。已有 VPN、加速器或其他代理工具可能争用路由,排查阶段先让一种接管方式工作,减少变量。
全局模式描述的是流量进入客户端之后如何选出口,并不等于全设备所有请求都会自动进入代理。规则模式下的直连也不代表客户端失效;要结合访问目标和命中记录判断。查看模式选择说明 →
打开一个需要测试的网站,同时查看客户端连接记录,确认有新请求进入、命中预期规则并采用正确策略。随后测试本地网站、局域网设备和常用应用,确认分流没有影响正常访问。延迟测试只反映某次探测,不能代表实际下载带宽,也不能证明所有网站均可访问。
若只有浏览器可用而终端不通,先检查终端的代理参数;若所有应用都不通,回到订阅、节点和接管开关逐层核对。确认稳定后再启用开机启动和自动更新,并记录改过的项目,方便下一次定位问题。
OPEN SOURCE / 项目与维护
选择客户端时,把图形界面、代理内核和订阅服务分开看。三者分别负责操作入口、流量处理和节点来源,任何一层发生问题,都不应简单归因于“Clash 不能用”。
Clash 最初以规则分流和 YAML 配置被广泛使用,随后形成了多个桌面与移动端客户端。原版项目及部分旧客户端停止维护后,生态并没有只剩一条路线。Clash.Meta 延续了相关功能开发,后来采用 mihomo 名称;阅读较早教程时,会遇到这些名称并存的情况。
名称相近不代表配置完全通用。较新的协议、规则语法或 DNS 参数可能只在特定内核中支持,迁移时需要核对字段,而不是仅把文件扩展名改成 YAML。原有配置能导入,也不等于所有设置都被识别。
mihomo 负责解析配置、建立连接和执行规则;图形客户端负责订阅管理、节点选择、系统代理开关及日志展示。客户端还可能增加自己的覆写、合并或配置模板,因此界面显示的选项与最终交给内核的文件未必一一对应。
排查时优先看运行中的配置与实际日志。某个设置在界面中关闭,却在订阅中开启,或者本地修改被更新覆盖,都可能造成“已经改过但没有效果”的情况。跨客户端迁移时,订阅地址和自定义规则应分别保存。
mihomo 采用 GPL-3.0 协议,源码、提交记录与问题讨论可在项目仓库查阅。开源意味着能够阅读实现及许可条件,不代表第三方服务的节点质量,也不能代替具体网络环境中的测试。本站整理配置说明与下载入口,不是内核项目或所有客户端的官方运营方。
遇到疑似软件缺陷,先用尽量小的配置复现,记录系统、客户端、内核信息与报错。提交问题前删除订阅地址、节点凭据和个人网络信息,比直接上传整份配置更适合公开协作。
客户端更新、内核更新、订阅刷新和规则数据更新解决的是不同问题。界面更新不保证内核同时变化,订阅刷新也不会自动修复系统权限。升级前保留正在工作的配置,并阅读项目的变更说明;有不兼容调整时,先核对配置再切换日常使用环境。
GeoIP 或规则集下载失败时,检查资源路径、访问条件和日志中的具体错误;只有某个节点慢时,先换节点进行对照。按层定位通常比同时升级、重装和改 DNS 更容易保留有效线索。相关概念可在 术语表 中逐项查阅。
仓库:MetaCubeX/mihomo。以下命令下载源码,不会安装图形客户端;只需要日常使用时,直接从下载页选择客户端即可。
git clone https://github.com/MetaCubeX/mihomo.git
FIELD NOTES / 配置记录
基础连接完成后,再按实际问题阅读专题。迁移客户端先保留现有配置,调整 DNS 先确认请求路径,比较内核先看功能需求;每次只改变一个条件,才能知道是哪一步带来了变化。
教你用检测页判断 DNS 是否泄漏,并逐段配置 fake-ip、nameserver-policy 与 TUN 劫持,堵住解析请求外溢。
旧客户端停止维护后的迁移路线:导出订阅与自定义规则,按平台挑选仍在更新的替代客户端并完成平滑切换。
梳理三代内核的演进关系,对比协议支持、规则语法与 DNS 能力差异,说明旧配置迁到 mihomo 要改哪些字段。
订阅拉取出现错误,可先看 Clash 订阅更新失败;测试结果波动较大,可对照 Clash 节点延迟 的解释。平台安装与配置常见问题集中在 完整文档的常见问题章节,无需从头阅读全部设置。