开源客户端mihomo 内核 · Flutter 构建

FlClash 下载与配置入门

基于 mihomo 内核的桌面与手机客户端,通过订阅导入管理配置,使用规则分流区分直连与代理请求。

  • 永久免费
  • 代码开源
  • 中文文档
按系统选择安装包 · iOS 提供其他客户端选择

安装包与平台选择

按系统查找 Clash 客户端

FlClash 覆盖桌面与 Android。下载页同时列出其他 Clash 生态客户端,按处理器架构与使用习惯选择;iOS 入口提供 Clash Plus 的商店链接。

选安装包时,平台、架构和包格式需要同时对应。电脑能运行某个系统,不代表所有同名安装包都适合;Android 也应以设备实际支持的架构为准。下载页按平台保留客户端清单,包含维护状态与安装注意事项,便于在 FlClash、Clash Plus、Clash Verge Rev 等选项之间比较。

查看全部客户端 →

配置与网络设置

FlClash 核心功能

先明确配置来源,再决定流量如何进入客户端、由哪条规则选择出站。下面的切片用于解释设置关系,实际菜单以当前客户端界面为准。点击任一分类后停止自动切换,可按自己的节奏阅读。

订阅导入与当前配置

订阅地址是获取配置的入口,导入成功后仍要选中当前配置。先确认返回内容属于 Clash 配置,再检查代理组与规则是否完整。远程订阅适合持续更新,本地文件适合保留自定义内容,两者的修改方式不同。直接改写订阅生成的文件,下一次更新时可能被覆盖。建议把订阅来源与本地调整分开记录,更新后检查策略组引用是否还存在。桌面与手机可分别导入同一来源,但客户端设置和权限需要在每台设备上单独确认。

查看订阅导入步骤 →

首次连接

订阅导入到连接验证

安装客户端只是开始。准备可用的订阅或本地配置,按顺序检查配置、模式和系统权限,比同时改动多个网络设置更容易定位问题。客户端不附带可直接使用的代理服务。

  1. 导入并选中配置

    打开配置页面,按界面提供的入口添加订阅地址或本地文件。远程地址应来自可信的配置提供方,不要把用于登录网页的地址当作订阅。导入后确认该条目已被选为当前配置,再进入代理页面查看是否存在可用的策略组。只看到配置名称,不代表内容已完整加载。

    如果导入失败,先读错误提示,区分地址不可访问、返回登录页面与配置格式不兼容。不要反复切换出站模式来解决下载订阅的问题;这些设置属于不同环节。订阅地址可能包含访问凭据,截图或求助时应遮住完整地址。

  2. 选择规则模式与出口

    日常使用可先选规则模式,再打开配置所提供的策略组选择合适的出口。规则组与节点名称由配置决定,界面上的名称不一定与教程示意相同。全局模式可以用于对照测试,但它不会修复失效订阅、错误凭据或不可用的服务。

    桌面端先启用系统代理,Android 按提示授权 VPN 连接。若已有其他代理软件运行,先停止其中一项再测试,避免本地端口与路由同时被修改。需要 TUN 时,在基础连接正常后再开启,并保留改动前的设置记录。

  3. 验证请求与规则命中

    分别访问一个预期直连的网站和一个预期走代理的服务,在连接或日志页面检查请求是否进入客户端、匹配了什么规则、最终选择了哪个策略组。连接按钮显示已启动,只能说明相关服务已启动,不能单凭这个状态判断所有应用都已使用代理。

    若浏览器可用而其他应用不可用,优先检查该应用是否遵循系统代理。若所有请求都失败,回到当前配置、策略组和服务可用性逐层确认。一次只改一个设置,测试后记下结果,再决定是否继续处理 DNS、权限或防火墙。

完整教程继续说明导入失败、权限提示与连接验证的具体处理位置。复杂网络环境的诊断流程放在问题诊断页,避免打断首次配置的操作顺序。

查看完整教程 →

项目与开源生态

FlClash、mihomo 与配置来源

理解客户端、内核和代理服务的分工,可以减少选型和排查时的混淆。开源仓库用于阅读代码、发布说明与已知问题,连接质量仍取决于配置、服务与本地网络。

  • Flutter 界面
  • mihomo 内核
  • GPL-3.0

获取项目源代码

已安装 Git 的开发者可复制命令,在终端获取仓库。普通使用者直接选择安装包,不需要编译源代码。

git clone https://github.com/chen08209/FlClash.git
查看项目仓库 ↗

内核负责网络,客户端负责操作入口

mihomo 承担协议处理、规则匹配与连接转发等工作,FlClash 提供配置管理、开关、策略选择与日志查看界面。旧资料中常见的 Clash Meta 与 mihomo 名称存在项目沿革关系,但某篇旧教程的菜单位置和参数支持范围,不应直接当作当前客户端的界面说明。遇到功能差异时,需要同时确认客户端实现与所用内核能力。

Flutter 是构建图形界面的技术,不是代理协议。更换界面主题不会改变服务端支持的协议,切换客户端也不会自动修复服务端过期或凭据错误。先确定故障发生在界面设置、内核配置还是服务连接层,再选择相应文档,能够避免围绕软件名称反复重装。

开源许可与社区资料的阅读方式

FlClash 项目采用 GPL-3.0 许可,可在仓库中查阅源代码与许可文本。需要修改、分发或将代码用于其他项目时,应先理解许可要求,而不是把“代码可见”理解成可以任意移除原有许可说明。对于普通使用者,仓库中的发布记录、问题讨论与文档,是确认功能变化和已知限制的主要参考。

阅读社区问题时,优先寻找与操作系统、安装方式和故障现象接近的记录。相同的“无法上网”可能来自完全不同的原因。提交问题前准备复现步骤、脱敏后的错误日志和已尝试的操作,比仅提供一张连接按钮截图更有助于定位;订阅地址、账户信息与完整配置中的敏感字段不要直接公开。

程序更新与订阅更新是两个过程

客户端更新主要涉及界面、内核集成和兼容性修复;订阅更新则是重新获取代理、策略组与规则内容。GeoIP、GeoSite 等数据还可能有各自的更新入口。某个域名分流不符合预期时,应分别检查规则内容、数据是否可用以及匹配顺序,不能仅凭安装包较新就认定配置一定正确。

更新前保留必要的本地配置记录,阅读发布说明中涉及权限、配置迁移或系统要求的变化。更新后先检查当前配置是否仍被选中,再验证常用应用。若出现异常,记录更新前后的差异并按症状排查,不要在尚未确认原因时同时更换订阅、修改 DNS 和重置所有设置。

配置可以共用,设备环境需要分别检查

同一份订阅可以在兼容客户端中分别导入,但配置提供方可能限制同时连接的设备数量或服务使用方式。手机与电脑所在网络不同,即使导入同一配置,DNS、路由和防火墙环境也可能不同。因此,一端可用是定位线索,不是另一端必然可用的保证。

需要进一步选择客户端时,可查看客户端对比;已经完成安装但遇到连接问题,可按问题诊断中的症状进入对应流程。基础概念与常见安装疑问收录在 FAQ,适合先确认术语和设置含义,再决定是否调整网络参数。

技术笔记

规则、数据与局域网共享

围绕具体设置展开的补充说明。完成首次连接后,再按实际需要阅读数据更新、客户端关系与共享代理步骤。文章中的参数示例需要结合当前配置使用,尤其要注意策略组名称、监听地址和权限差异。

技术笔记补充单项功能的原理与操作细节;如果尚未成功导入配置,建议先完成入门指南,再回到这些专题逐项调整。

查看全部文章 →