使用文档

从安装到精细分流。

了解 ClashFX 的安装要求、配置路径、Enhanced Mode 与系统集成方式。

概览

ClashFX 是什么?

ClashFX 是一款基于 mihomo 内核、面向 macOS 的开源规则代理客户端。它支持 HTTP/HTTPS、SOCKS、VMess、VLESS、Trojan、Shadowsocks 和 Hysteria2 等协议,并通过规则决定每条连接的处理方式。

ClashFX 支持 macOS 10.14 及以上版本,并为 Apple Silicon 提供原生支持。

核心能力

  • Enhanced Mode (TUN) 系统级全局流量捕获
  • 域名、IP-CIDR、GeoIP 与进程规则路由
  • Fake-IP 模式与 DNS 安全策略
  • gVisor 用户态网络栈
  • Stable 与 Lab 双更新通道
安装

安装 ClashFX

  1. 前往 GitHub Releases 下载最新版本。
  2. 打开下载的安装包,将 ClashFX 拖入“应用程序”文件夹。
  3. 首次运行时,按 macOS 提示确认打开。
只从 Clash-FX 官方 GitHub 仓库下载。请勿使用来源不明的重新打包版本。
配置

配置文件

默认配置目录如下:

$HOME/.config/clashfx

默认配置文件名为 config.yaml。你也可以使用自定义文件名,并在 ClashFX 的“配置”菜单中切换。

导入远程配置

在应用内选择配置导入入口,粘贴服务提供方给出的订阅地址。ClashFX 不提供节点或订阅服务。

Enhanced Mode

全局流量接管

Enhanced Mode 通过 TUN 虚拟网卡捕获所有应用的 TCP/UDP 流量,不仅限于支持系统代理的浏览器或应用。

  1. 在菜单栏打开“Enhanced Mode”。
  2. 选择“启用”。
  3. 首次使用时授予管理员权限。
启用后,所有流量将按照当前配置的规则路由。退出应用或关闭 Enhanced Mode 会停止接管。
规则路由

让连接走正确的路

ClashFX 使用 mihomo 规则系统,可按域名、IP 地址段、地理位置和进程名称进行匹配。规则按配置中的顺序执行,首个匹配项生效。

国内常用 App 直连

“国内 App 直连”开关使用社区维护的 cn-apps-direct 进程清单。列表每 24 小时自动更新,无需等待 ClashFX 发版。

更新

Stable 与 Lab

Stable 是默认且推荐的通道,通常每 2–7 天在修复积累后发布。Lab 会在修复落地后尽快推送,也可能包含实验性功能。

切换路径:ClashFX → 设置 → 调试 → 更新通道。Lab 版应用图标右上角会显示橙色圆点。

系统集成

URL Schemes

导入远程配置

clashfx://install-config?url=http%3A%2F%2Fexample.com&name=example clash://install-config?url=http%3A%2F%2Fexample.com&name=example

重新加载当前配置

clash://update-config
开发者

从源码构建

需要 macOS 10.14+、Xcode 15.0+、Python 3 与 Golang 1.21+。

brew install golang bash install_dependency.sh open ClashFX.xcworkspace

在 Xcode 中选择目标后按 Cmd + R 构建运行。