ClashFX 常见问题与解决方案

发布于 2026-03-01 · 最后更新 2026-03-01

排查思路

遇到问题时，按以下思路逐步定位：

1. 关闭 ClashFX 代理，确认基础网络是否正常
2. 如果基础网络正常，问题在 ClashFX 配置层面
3. 检查节点是否可用（延迟测试）
4. 检查配置文件是否有语法错误
5. 查看日志获取详细错误信息

记住这个排查优先级：网络 → 节点 → 配置 → 应用。

无法连接 / 完全没有网络

这是最常见的问题。按以下步骤排查：

步骤一：确认基础网络

1. 点击菜单栏 ClashFX 图标
2. 取消勾选「设置为系统代理」
3. 如果开启了增强模式，也关闭它
4. 尝试打开浏览器访问任意网站

如果关闭代理后 能正常上网，说明问题在 ClashFX 的配置或节点上，继续步骤二。

如果关闭代理后 仍然不能上网，说明是你的基础网络有问题，与 ClashFX 无关。检查 Wi-Fi 连接、路由器等。

步骤二：检查节点可用性

1. 重新开启系统代理
2. 在菜单 → 代理 中进行 延迟测试
3. 观察节点延迟数据

如果所有节点都显示超时或失败：

• 更新订阅：配置 → 远程配置管理 → 选中订阅 → 更新
• 检查系统时间：VMess 协议对时间敏感，系统时间偏差超过 90 秒会导致认证失败。打开「系统设置 → 通用 → 日期与时间」确认已开启自动设置
• 联系服务商：确认你的账户和订阅是否有效

如果部分节点正常、部分超时，切换到可用节点即可。

步骤三：检查代理模式

确认代理模式设置正确：

• 规则模式（推荐）：根据规则分流
• 全局模式：所有流量走代理，如果节点不可用则完全无法上网
• 直连模式：不走代理，等于没有开 ClashFX

如果你在全局模式下无法上网，先切换到 规则模式 试试。

开启增强模式后没网

增强模式相关的网络问题通常由 DNS 配置引起。

快速恢复

1. 立即关闭增强模式（菜单 → 增强模式 → 取消勾选）
2. 网络应立即恢复

修复 DNS 配置

打开配置编辑器（菜单 → 配置 → 编辑当前配置），检查 dns 部分：

dns:
  enable: true           # 必须为 true
  enhanced-mode: fake-ip # 推荐 fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - 223.5.5.5          # 国内 DNS
    - 119.29.29.29
  fallback:
    - tls://1.1.1.1:853  # 国外 DNS
    - tls://8.8.8.8:853

常见错误：

• dns.enable 未设置或为 false
• nameserver 列表为空
• DNS 服务器地址错误或不可达
• enhanced-mode 拼写错误

修改后保存，ClashFX 会自动重新加载配置。然后再尝试开启增强模式。

增强模式权限问题

如果增强模式开启时报错：

1. 确认你的账户有管理员权限
2. 前往「系统设置 → 隐私与安全性」，检查是否有 ClashFX 相关的待授权项
3. 尝试重启 Mac 后再开启
4. 如果之前安装过 ClashX Pro，可能存在系统扩展冲突，需要先移除旧扩展

部分网站打不开

如果大部分网站正常，但某些特定网站打不开：

检查规则匹配

问题可能是路由规则把该网站分配到了错误的代理组。你可以在日志中查看该域名匹配了哪条规则。

添加自定义规则

在配置文件的 rules: 部分添加针对该域名的规则：

rules:
  # 强制某个域名走代理
  - DOMAIN-SUFFIX,blocked-site.com,代理选择

  # 或者强制直连
  - DOMAIN-SUFFIX,local-site.com,DIRECT

  # ... 其他规则
  - MATCH,代理选择

记得将新规则添加在 MATCH 兜底规则之前。

节点全部超时

更新订阅

最常见的原因是节点信息过时。更新远程订阅获取最新节点：

1. 打开 配置 → 远程配置管理
2. 选中你的订阅
3. 点击 更新

校准系统时间

VMess 协议对系统时间敏感。确保：

1. 打开 系统设置 → 通用 → 日期与时间
2. 开启 「自动设置日期与时间」

切换协议

如果你的网络环境对特定协议有限制，尝试切换到其他协议的节点（如 Trojan、Hysteria2）。

检查防火墙

确保 macOS 防火墙没有阻止 ClashFX：

1. 打开 系统设置 → 网络 → 防火墙
2. 如果防火墙已开启，点击 选项
3. 确认 ClashFX 在允许列表中

配置文件解析错误

检查 YAML 语法

YAML 格式对缩进非常敏感。常见错误：

• 使用了 Tab 缩进（必须用空格）
• 缩进层级不一致
• 特殊字符未用引号包裹
• 键名冒号后缺少空格

使用编辑器检查

ClashFX 内置编辑器会在保存时检查格式。如果保存后提示错误，根据错误信息定位到对应行号修复。

重新下载配置

如果手动修复困难，最简单的方法是重新下载远程订阅覆盖当前配置。

应用无法启动

macOS 安全限制

首次启动被拦截：

1. 前往 系统设置 → 隐私与安全性
2. 找到 ClashFX 相关的安全提示
3. 点击 「仍要打开」

文件损坏提示

在终端执行：

xattr -cr /Applications/ClashFX.app

版本过旧

确保使用最新版本。前往 GitHub Releases 下载最新版覆盖安装。

端口冲突

如果 ClashFX 启动时提示端口被占用（默认 7890/7891）：

查找占用进程

lsof -i:7890

解决方法

1. 关闭占用端口的应用
2. 或者修改 ClashFX 配置文件中的端口号：

port: 7892        # 改为其他未占用的端口
socks-port: 7893

查看日志

日志是排查问题的重要信息来源。查看日志的方法：

1. 在配置中将 log-level 设为 debug 获取最详细的日志
2. Pro 用户可以在面板模式的日志查看器中查看
3. 免费用户可以通过 yacd Dashboard（http://127.0.0.1:9090/ui）查看

提交 Bug 报告

如果以上方法都无法解决，在 GitHub Issues 提交报告。请附上：

• macOS 版本和芯片型号（Intel / Apple Silicon）
• ClashFX 版本号
• 问题的详细描述和复现步骤
• 相关日志信息（隐去敏感信息如服务器地址）
• 配置文件的 DNS 部分（如果与增强模式相关）