01 / OVERVIEW
ClashFX 是什么？
ClashFX 是一款基于 mihomo 内核、面向 macOS 的开源规则代理客户端。它支持 HTTP/HTTPS、SOCKS、VMess、VLESS、Trojan、Shadowsocks 和 Hysteria2 等协议，并按照配置规则决定每条连接的处理方式。
系统要求支持 macOS 10.14 及以上版本，并为 Apple Silicon 提供原生支持。
核心能力
- Enhanced Mode (TUN) 系统级全局流量捕获
- 域名、IP-CIDR、GeoIP 与进程规则路由
- Fake-IP 模式与 DNS 安全策略
- gVisor 用户态网络栈
- Stable 与 Lab 双更新通道
02 / INSTALL
安装 ClashFX
- 前往官方 GitHub Releases 下载最新版本。
- 打开安装包，将 ClashFX 拖入“应用程序”文件夹。
- 首次运行时，按 macOS 提示确认打开。
安全提示只从 Clash-FX 官方 GitHub 仓库下载，请勿使用来源不明的重新打包版本。
03 / CONFIGURATION
配置文件
默认配置目录如下。默认文件名为 config.yaml，也可以使用自定义名称并在应用内切换。
$HOME/.config/clashfx导入远程配置
在应用内进入配置导入，粘贴服务提供方给出的订阅地址。ClashFX 是客户端，不提供节点或订阅服务。
04 / ENHANCED MODE
接管系统流量
Enhanced Mode 通过 TUN 虚拟网卡捕获应用的 TCP/UDP 流量，不仅限于支持系统代理的浏览器或应用。
- 点击菜单栏中的 ClashFX 图标。
- 找到 Enhanced Mode 并选择启用。
- 首次使用时授予管理员权限。
可随时恢复退出应用或关闭 Enhanced Mode 会停止接管系统流量。
05 / ROUTING
让连接走正确的路
ClashFX 使用 mihomo 规则系统，可按域名、IP 地址段、地理位置和进程名称匹配。规则从上到下执行，首个匹配项生效。
国内常用 App 直连
内置开关使用社区维护的 cn-apps-direct 进程清单，列表每 24 小时更新。阅读完整说明。
06 / RELEASE CHANNELS
Stable 与 Lab
Stable 是默认且推荐的通道，修复经过积累和验证后集中发布。Lab 更快推送最新修复，也可能包含实验性功能。
切换路径
ClashFX → 设置 → 调试 → 更新通道07 / 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-config08 / BUILD
从源码构建
需要 macOS 10.14+、Xcode 15.0+、Python 3 与 Golang 1.21+。
brew install golang
bash install_dependency.sh
open ClashFX.xcworkspace在 Xcode 中选择目标后按 Cmd + R 构建运行。