FlClash 配置教程:订阅导入、规则模式与连接排查
简答:FlClash 配置不要只看“开关是否打开”:先导入并激活 Profile,再确认节点和代理组,最后按平台开启系统代理、Android VPN 或 TUN。若仍不能用,依次看连接记录、日志、DNS 和规则命中情况。菜单名称以当前版本为准。
定义:FlClash 配置,是把订阅或 YAML 文件加载为 Profile,再由代理组、规则、DNS 和系统代理、Android VPN 或 TUN 共同决定流量如何进入并经过 mihomo 核心。
先完成这 5 步:导入、激活、选节点、接入、验证
如果你刚安装 FlClash,最快的排查顺序不是反复切换模式,而是确认五个状态:Profile 是否导入、是否处于激活状态、代理组是否有节点、平台接入是否打开、浏览器或目标应用是否真的发出了请求。FlClash 官方仓库说明,它支持 Android、Windows、macOS 和 Linux,并使用 mihomo(Clash.Meta)核心处理规则、代理组、延迟测试、系统代理和 TUN。
FlClash 官方仓库列出的功能包括链接或文件导入 Profile、覆盖脚本、自定义规则与代理组,以及连接、请求、DNS 查询和日志查看。
| 检查项 | 你应看到的结果 | 没有结果时先做什么 |
|---|---|---|
| Profile | 配置列表中出现订阅或本地文件,并且已选中 | 重新复制链接;检查链接是否过期、是否需要登录 |
| 代理组 | 组内有节点或代理提供者已加载 | 打开配置内容或更新 Profile,确认返回的确实是 Clash/Mihomo 格式 |
| 节点 | 能看到节点并可执行延迟测试 | 先换另一个节点;若全部为空,优先查订阅内容 |
| 流量接入 | 桌面显示 System Proxy,Android 显示 VPN,或 TUN 已获得授权 | 先关闭其他 VPN、系统代理和网络过滤工具,再只启用一种接入方式 |
| 验证 | 连接记录中出现目标应用或域名请求 | 确认应用是否读取系统代理;不读取时再考虑 TUN |
修改任何端口、DNS、模式或 TUN 选项前,先记录原值和当前 Profile 名称。这样回退时不会把订阅问题和本地改动混在一起。
FlClash 配置前要准备什么:Profile、订阅与 YAML 的区别
订阅链接是配置来源,通常由服务端返回节点和规则等内容;Profile是 FlClash 中被管理、激活和更新的配置条目;YAML 文件是可以直接导入的本地配置;Override则用于把本地修改与远程 Profile 分开保存。四者不是同一个概念。
FlClash 官方仓库给出的用法是从链接导入 Profile,也支持文件导入;当前菜单可能因版本和平台变化,实际入口以当前版本为准。若使用远程 Profile,更新时服务端返回的内容可能改变,因此不要直接把唯一配置改得面目全非。需要保留的本地规则、代理组或字段,优先记录在 Override 或单独的本地配置中。
安全方面,订阅链接通常等同于访问凭据,不要放进公开截图、工单或代码仓库。若无法确认链接来源、返回格式或权限范围,不要直接导入。
三种导入方式:链接、文件和二维码
- 链接导入:打开 Profiles 或配置列表,选择新增,选择 URL、Link 或类似入口,粘贴订阅链接并保存。随后点击该 Profile 使其成为当前配置,再到 Proxies 页面确认代理组和节点。
- 文件导入:选择 File 或本地文件入口,导入 YAML 配置。文件必须保持缩进和键名结构,建议先复制一份备份,不要在原文件上直接试错。
- 二维码导入:使用扫描入口读取配置二维码。二维码内容能否被识别,取决于其编码格式和当前版本支持情况;扫描成功后仍要回到 Profile 列表确认配置已激活。
若链接导入后列表为空,先用浏览器或命令行确认服务端确实返回内容。macOS/Linux 可用:
curl -L -A "FlClash" -o /tmp/flclash-profile.txt "你的订阅链接"
head -n 20 /tmp/flclash-profile.txtWindows PowerShell 可用:
Invoke-WebRequest -Headers @{"User-Agent"="FlClash"} -Uri "你的订阅链接" -OutFile "$env:TEMP\flclash-profile.txt"
Get-Content "$env:TEMP\flclash-profile.txt" -TotalCount 20这里使用 User-Agent 是为了减少误判:部分服务端会根据客户端标识返回不同内容,所以 curl 默认拿到的结果可能与 FlClash 实际收到的内容不同。命令输出仅用于核对格式,不要把订阅内容公开。
节点、代理组与 Rule、Global、Direct 怎么选
导入成功不等于已经有可用节点。先进入 Proxies 页面,找到当前 Profile 提供的代理组,再选择一个具体节点。代理组的类型和成员由配置决定,mihomo 官方文档将 Select、Url-Test、Fallback、Load-Balance 等列为不同的代理组类型,不能把所有组都当成手动选择列表。
| 模式 | 适合做什么 | 排查时的用法 |
|---|---|---|
| Rule | 按照配置中的规则,把请求分配到代理、直连或其他策略 | 日常使用优先检查该模式下的规则命中和代理组选择 |
| Global | 让已进入客户端的请求统一使用全局策略 | 用于测试节点或代理路径,不能解决应用没有进入客户端的问题 |
| Direct | 让已进入客户端的请求直连 | 用于对照测试 DNS、目标服务和本地网络,不等于关闭系统代理或 VPN |
mihomo 官方规则文档说明了 DOMAIN、DOMAIN-SUFFIX、IP-CIDR、GEOIP、PROCESS-NAME 和 MATCH 等规则类型及优先级。若 Rule 模式下某个域名表现异常,先看 Connections 或日志中实际命中的规则,再决定是否修改规则,不要先盲目切换节点。
代理组字段可以对照mihomo 代理组配置文档。推荐使用官方示例中的字段拼写和小写类型;未确认当前核心支持情况前,不要复制其他客户端的自定义字段。
Windows、macOS、Linux、Android 的接入方式对照
| 平台 | 入口与适用方式 | 授权或注意事项 |
|---|---|---|
| Windows | Dashboard 或 Settings 中查找 System Proxy;需要更广泛接管时再查找 TUN | 系统代理通常只影响读取系统代理的应用;TUN 可能需要管理员权限、驱动或防火墙确认 |
| macOS | 在 Dashboard 或 Settings 查找 System Proxy;TUN 入口以当前版本为准 | 系统可能要求允许网络扩展或相关权限;不要同时启用多个 VPN 类工具 |
| Linux | 使用 System Proxy,或按当前桌面环境配置 TUN | AppImage、RPM 等安装方式的托盘依赖可能不同;权限和桌面环境会影响菜单显示 |
| Android | 打开 Dashboard 中的 VPN 或连接开关,并确认系统 VPN 请求 | Android 同一时间通常只能由一个 VPN 服务接管;电池优化、分应用代理和系统网络策略也可能影响结果 |
FlClash 官方仓库列出了桌面和移动平台的安装包类型与架构;下载时应以当前发布页为准,不在文章中固定某个版本号。菜单名称、系统要求和 TUN 入口也以当前版本为准。
mihomo 官方入站配置文档区分了代理端口、TUN 和 listeners。TUN 用于捕获系统流量、DNS 劫持或按应用路由,但它属于更复杂的接入方式;遇到断网时,应先关闭 TUN 回到系统代理或 Android VPN,确认基础链路正常后再逐项恢复。
最小 YAML 配置:先用能加载的结构回退
如果本地 YAML 导入失败,先不要把完整订阅内容全部重写。可以用下面这个仅用于结构核对的最小示例检查缩进、端口和模式。示例中的节点字段是占位内容,不能直接连接真实服务。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxies:
- name: demo
type: socks5
server: 127.0.0.1
port: 1080
proxy-groups:
- name: proxy
type: select
proxies:
- demo
- DIRECT
rules:
- MATCH,proxy常见错误写法是把列表项写成同一层,或把含冒号的值直接写成未加引号的文本。例如:
proxy-groups:
- name: proxy
type: select
proxies:
- demo修正重点不是增加字段,而是统一缩进:
proxy-groups:
- name: proxy
type: select
proxies:
- demo“found character that cannot start”或“mapping values are not allowed”等属于常见 YAML 解析报错,FlClash 界面实际提示可能不同。遇到这类问题,先检查 Tab 与空格混用、冒号后缺空格、列表缩进、重复键和引号是否闭合。配置加载成功后,再逐步恢复 DNS、规则提供者、TUN 等复杂字段。
错误关键词→原因→处理:FlClash 配置排查表
| 现象或关键词 | 更可能的原因 | 处理顺序 |
|---|---|---|
| Profile 导入失败、列表为空 | 链接失效、权限过期、服务端按 User-Agent 返回异常内容 | 记录原链接;用带 User-Agent 的命令核对响应;重新导入并查看日志 |
| 导入成功但没有节点 | 返回的不是预期格式,或代理提供者未加载 | 检查 Profile 内容、更新状态和代理组;不要先改 TUN |
| 有节点但网页打不开 | 未选节点、代理组为空、规则命中 DIRECT,或应用没有进入客户端 | 选具体节点;临时用 Global 对照;查看 Connections 和规则命中 |
| 浏览器能用,某应用不能用 | 该应用不读取系统代理,或使用独立网络栈 | 查看应用自身代理设置;确认是否需要 TUN,并先关闭其他 VPN |
| 开启 TUN 后断网 | 权限、路由、DNS、虚拟网卡或 VPN 冲突 | 关闭 TUN回退;记录权限提示和日志;只保留一个 VPN/网络接管工具 |
| 订阅更新后本地修改消失 | 直接改了远程 Profile,更新时被服务端内容覆盖 | 恢复原值;把持久修改迁移到 Override 或独立本地配置 |
| 节点延迟低但实际失败 | 延迟测试只代表测试请求可达,不等于目标应用完整可用 | 查看目标域名的连接记录、DNS 和规则;换节点做对照 |
日志查看入口通常在 Logs、日志或调试页面,连接记录通常在 Connections、Requests 或类似页面;菜单以当前版本为准。提交问题时应导出日志和配置摘要,先删除订阅链接、密码、令牌、内网地址和个人信息,再提供发生时间、平台、客户端版本、当前模式、是否启用 TUN 以及错误关键词。
命令行只能帮助核对服务端响应,不能替代 FlClash 内部日志。若需要查看本地 HTTP 或 SOCKS 端口,先以界面显示的实际端口为准,再执行:
curl -I -x http://127.0.0.1:7890 https://example.com这里的端口只是示例,若当前配置不是 7890,请替换为实际值;Windows 用户也可以使用 PowerShell 的 curl.exe,避免与 PowerShell 别名行为混淆。
什么时候应判断为网络或线路问题
只有在多网络、多设备对照后,其他网站正常,而目标服务仍持续慢、超时或丢包,才适合进一步判断网络路径、DNS、MTU 或线路因素。先记录同一时间、同一目标、同一节点下的结果,再分别切换网络、节点和接入方式。
- 多网络:在 Wi-Fi、移动网络或另一条宽带下重复测试。
- 多设备:用另一台设备验证,排除单机权限、DNS 缓存和本地防火墙。
- 多节点:至少对照两个节点,记录连接记录和失败时间。
- 多接入方式:先用系统代理或 Android VPN,再单独测试 TUN。
- DNS 与 MTU:只修改一个变量,并记录原值;不要同时更换 DNS、MTU、规则和节点。
如果只有目标服务异常,仍应先保留日志、连接记录和请求时间。网络诊断的目的,是定位故障边界,而不是通过改变地区规避限制;任何配置和网络使用都应遵守当地法律、服务条款与单位安全政策。
常见问题
FlClash 配置导入订阅后为什么没有节点?
先确认 Profile 已被选中,再检查订阅响应是否为空、是否需要登录、是否因 User-Agent 返回了不同内容。若代理组也为空,优先检查订阅格式和更新日志,不要先启用 TUN。
FlClash 的 Rule、Global、Direct 有什么区别?
Rule 按规则和代理组分流,适合日常使用;Global 让已进入客户端的请求统一使用全局策略,适合测试;Direct 让已进入客户端的请求直连,适合对照 DNS、规则和代理路径。它们都不能解决应用没有进入客户端的问题。
FlClash 开启系统代理后,为什么有些软件仍然不走代理?
系统代理只对读取系统代理设置的应用有效。若目标应用使用独立网络栈、内置代理或其他网络服务,可能需要在应用内设置代理,或在确认权限和 VPN 没有冲突后测试 TUN。
FlClash 配置更新后,自己改的规则为什么消失?
如果直接修改的是远程 Profile,更新时可能被服务端内容覆盖。修改前应记录原值,把需要长期保留的规则、代理组或字段放入 Override 或独立本地配置。
FlClash 开启 TUN 后断网怎么办?
立即关闭 TUN,回到系统代理或 Android VPN验证基础链路;随后检查系统授权、虚拟网卡、DNS、路由和其他 VPN 工具。一次只恢复一个变量,并查看日志中的错误关键词。
YAML 配置导入失败,应该先改哪些地方?
先检查 Tab 与空格混用、列表缩进、冒号后的空格、引号是否闭合、重复键和字段拼写。建议用最小 YAML 验证结构,再逐步恢复 DNS、规则提供者和 TUN 等复杂内容。
FlClash 如何查看并提交日志?
在当前版本的 Logs、日志或调试入口查看运行日志,在 Connections、Requests 或类似入口查看请求记录;导出前删除订阅链接、令牌、密码和个人信息,并附上平台、模式、TUN 状态和发生时间。
