科技熊工作室科技熊工作室 · 攻略

FlClash 配置教程:订阅导入、规则模式与连接排查

更新于 2026-10-25 · kjxclub.shop

简答: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 或单独的本地配置中。

安全方面,订阅链接通常等同于访问凭据,不要放进公开截图、工单或代码仓库。若无法确认链接来源、返回格式或权限范围,不要直接导入。

三种导入方式:链接、文件和二维码

  1. 链接导入:打开 Profiles 或配置列表,选择新增,选择 URL、Link 或类似入口,粘贴订阅链接并保存。随后点击该 Profile 使其成为当前配置,再到 Proxies 页面确认代理组和节点。
  2. 文件导入:选择 File 或本地文件入口,导入 YAML 配置。文件必须保持缩进和键名结构,建议先复制一份备份,不要在原文件上直接试错。
  3. 二维码导入:使用扫描入口读取配置二维码。二维码内容能否被识别,取决于其编码格式和当前版本支持情况;扫描成功后仍要回到 Profile 列表确认配置已激活。

若链接导入后列表为空,先用浏览器或命令行确认服务端确实返回内容。macOS/Linux 可用:

curl -L -A "FlClash" -o /tmp/flclash-profile.txt "你的订阅链接"
head -n 20 /tmp/flclash-profile.txt

Windows 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 的接入方式对照

平台入口与适用方式授权或注意事项
WindowsDashboard 或 Settings 中查找 System Proxy;需要更广泛接管时再查找 TUN系统代理通常只影响读取系统代理的应用;TUN 可能需要管理员权限、驱动或防火墙确认
macOS在 Dashboard 或 Settings 查找 System Proxy;TUN 入口以当前版本为准系统可能要求允许网络扩展或相关权限;不要同时启用多个 VPN 类工具
Linux使用 System Proxy,或按当前桌面环境配置 TUNAppImage、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 或线路因素。先记录同一时间、同一目标、同一节点下的结果,再分别切换网络、节点和接入方式。

如果只有目标服务异常,仍应先保留日志、连接记录和请求时间。网络诊断的目的,是定位故障边界,而不是通过改变地区规避限制;任何配置和网络使用都应遵守当地法律、服务条款与单位安全政策。

常见问题

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 状态和发生时间。

相关阅读

参考资料

  1. FlClash 官方 GitHub 仓库与功能说明
  2. FlClash 官方发布页
  3. mihomo 官方入站与 TUN 配置文档