Clash Meta for Android · 开源 mihomo 内核

Clash安卓版Android 客户端下载与配置

按设备选择客户端,再完成订阅导入、VPN 授权与规则分流设置。

  • YAML 规则示例
  • 中文配置文档
阅读配置文档

按系统下载 Clash 客户端

先选设备系统,再看处理器架构和安装格式。换客户端前,保留订阅地址或配置文件,便于重新导入。

安装包怎么选

手机处理器支持六十四位,不代表系统一定能安装所有六十四位应用。下载页同时提供不同架构的包时,以系统实际支持的应用架构为准。无法确认时,可优先查看该客户端是否提供通用包;不要仅凭手机型号里的数字推断。若系统提示应用与已安装的同名应用冲突,先备份配置,再确认两者是否来自同一发布渠道。

旧客户端怎么迁移

从已停止维护的 Clash for Windows 迁出时,先记下当前启用的配置和手动选择的策略组,再将原订阅或本地文件导入新客户端。不要直接复制整个应用数据目录。旧客户端留下的系统代理可能还指向原端口;切换前先关闭旧客户端的接管,再用同一浏览器发起新请求,确认新客户端的连接记录能收到它。

客户端分流与配置特性

先区分系统接管、规则匹配和出站选择。一个环节正常,不代表下一环节也正常。

先确认流量进入客户端

首次启动连接时,在 Android 的系统弹窗确认 VPN 请求。授权后,符合接管范围的应用流量才会进入客户端,不必逐个应用填写代理地址。系统有时已把 VPN 交给另一个应用,工作资料也可能有独立限制。遇到部分应用不生效,先检查客户端的应用接管范围,再看连接记录。全局接管说的是流量入口,不等于必须使用全局代理模式;规则模式下,流量仍可按规则直连。

查看首次授权步骤 →
分流异常时,按入口、规则、出站的顺序检查
观察结果先检查什么如何复测
连接记录里找不到请求系统是否已授权,目标应用是否在接管范围内。桌面端还要确认应用是否读取系统代理。关掉应用里正在访问的页面,再重新打开。比较前后两次日志,确认是否出现对应的目标地址。
有记录,但规则不符当前运行模式是不是规则模式。检查具体规则是否被前面的通用规则覆盖,以及配置是否已经重新载入。用原应用访问同一个目标,不改变网络和策略组,核对新连接记录中的规则名。
规则命中正确,但连接失败区分域名解析、出站建立失败和应用响应超时。命中规则只表示选定了出站,不表示数据已送达。保留接管方式和规则不变,只替换该策略组的出站,观察错误是否变化。

开源项目与配置资料

从上游源码、变更记录和客户端文档核对功能。下载入口、内核支持和订阅服务是三件不同的事。

原 Clash、Clash.Meta 与 mihomo

早期 Clash 定下了许多现在仍能看到的配置习惯:节点集中定义,策略组负责组织出站,规则按顺序引用策略。Clash.Meta 在这一体系上继续扩展,后续以 mihomo 名称维护。旧教程里仍会出现前两个名称。读到同一个配置键时,可以借用旧教程理解基本用途,但不要假定默认值、支持范围和触发条件也完全相同。排查时先确认当前客户端使用哪一类内核,再找对应项目的资料。

客户端与内核的职责

Clash Meta for Android 提供配置管理和 Android 侧的 VPN 接入,mihomo 负责解析配置、匹配规则并建立出站。能保存一份配置,只说明文件到了客户端;能否加载、规则是否命中,还要看内核运行记录。反过来,系统没有授权或省电策略终止了后台服务,改 YAML 里的出站通常无济于事。提交问题前先区分这两层:安装、系统弹窗和界面问题优先看客户端项目;字段、规则和连接解析问题再对照内核资料。

如何核对社区资料

上游仓库可以查看源码和提交记录,也能在问题区查找相同的报错。搜索时保留具体字段名和错误类型,先看讨论所用的平台和运行方式;例如桌面端系统代理正常,并不能用来证明 Android 的 VPN 接管设置也正确。复现时保留最小配置、操作顺序和脱敏后的错误片段。公开记录前删掉订阅地址、代理凭据和私人域名;连接日志中的目标也可能暴露实际访问内容。

更新前保留可用配置

客户端安装包、内核变更和订阅内容各有更新节奏。客户端更新可能带来内核变化,订阅刷新则可能改动节点名称、策略组或规则顺序。若更新后分流不同,先备份当前文件并保留上一个可用副本;对照变更说明和配置差异,避免同时重装客户端、刷新订阅和更改 DNS。一次只变更一项,再用相同网络、相同应用和相同目标重测,即可缩小问题范围。

安装与配置常见问题

安装完成后,为什么策略组里还是空的?
安装包提供客户端,策略组来自正在使用的配置。先确认订阅导入成功并已启用;只把文件导入列表,还不会替换当前运行的配置。
已经显示 VPN 图标,为什么有些请求仍然直连?
VPN 图标说明系统建立了 VPN 连接。进入客户端的请求如果命中 DIRECT,仍会直连。先看连接是否出现,再核对命中的策略。
只在切换无线网络后出错,先查哪里?
先检查新网络是否需要认证、是否能正常解析域名,再看客户端有没有重建连接。保留原规则复测,可以把网络变化和配置变化分开。
端口已经修改,为什么终端还在用旧地址?
已打开的终端可能仍持有旧的代理环境变量。检查该终端会话和命令自身的代理设置;系统代理里的新端口不一定会同步过去。

技术笔记

按实际症状查阅:退到后台后断开、桌面应用不走代理、域名解析路径和预期不一致。

Clash Meta for Android 后台常驻:VpnService 授权与省电白名单设置

讲清 VpnService 授权弹窗的含义、各品牌系统省电策略为何会杀掉后台连接,以及电池优化白名单与自启动的逐项设置方法。

阅读后台常驻设置 →

系统代理开了却不生效:浏览器与命令行终端分开排查

浏览器扩展抢占、终端不读系统代理、端口不一致是三大常见原因。本文按浏览器与终端两条线给出逐项检查顺序与环境变量写法。

阅读系统代理排查 →

Clash DNS 泄漏检测方法与 fake-ip、nameserver-policy 防泄漏配置

先用检测页确认 DNS 请求走向,再从 enhanced-mode、fallback 与 nameserver-policy 三处调整配置,附可直接对照的 YAML 片段。

阅读 DNS 配置排查 →