Clash-FX /ClashFX

ClashFX — macOS proxy tool with Enhanced Mode (TUN)

★ 306⑂ 27👁 0⑃ 173● 104▤ 124
SwiftAGPL-3.0Created 2026-03-19
下载:1.1.111.1.11 ↓1.1.112026-09-14
+0
日增长
306
stars
27
forks
0
watchers
173
prs
104
issues
124
releases

README

ClashFX
  


带增强模式 (TUN) 的 macOS 规则代理客户端 — 基于 mihomo 内核



English | 简体中文 | 繁體中文 | 日本語 | Русский



---

 ✨ 功能特性

- 增强模式 (TUN) — 通过 TUN 虚拟网卡全局流量捕获,一键开启
- 支持 HTTP/HTTPS 和 SOCKS 协议
- 规则路由(域名、IP-CIDR、GeoIP、进程匹配)
- 支持 VMess/VLESS/Trojan/Shadowsocks/Hysteria2 协议
- DNS 安全(Fake-IP 模式)
- gVisor 用户态网络栈
- Apple Silicon 原生支持
- 支持 macOS 10.14+(包括 macOS 15 Sequoia)

 📥 安装

从 Releases 页面下载。

 🧪 更新通道:正式版与实验室版

 实验室版(Lab)自 v1.1.0 起已上线。正式版(Stable)仍是默认选项与推荐通道;如果你在 v1.1.0+,可在 设置 → 调试 → 更新通道 → 实验室版(Lab) 中切换。

ClashFX 提供两条更新通道,你可以自由选择。

| | 🟢 正式版 (Stable) | 🟠 实验室版 (Lab) |
|---|---|---|
| 默认 | ✅ | — |
| 更新频率 | 通常每 2–7 天积累一批修复后发布 | 修复一落地就推送,可能每天都有 |
| 包含内容 | 经过测试的修复 | 最新修复 + 偶尔有实验性功能 |
| 视觉标识 | 无 | Dock / 应用程序里的 app 图标右上角有橙色小圆点 |

加入实验室版:打开 ClashFX → 设置 → 调试 → 更新通道 → 实验室版 (Lab) 并确认。橙色小圆点会立刻出现。任何时候都可以从同样的路径切回正式版。

实验室版遇到问题? 在 帮助 → 反馈问题… 中打开预填好的 GitHub Issue(诊断信息自动附上并脱敏),或 帮助 → 复制诊断信息… 手动复制报告。

正式版用户:你已经在推荐的通道上,无需任何操作。

 🔨 从源码构建

 环境要求

- macOS 10.14 或更高版本
- Xcode 15.0+
- Python 3
- Golang 1.21+

 构建步骤

1. 安装 Golang
   bash
   brew install golang
   

2. 安装依赖
   bash
   bash install_dependency.sh
   

3. 打开并构建
   bash
   open ClashFX.xcworkspace
    在 Xcode 中构建 (Cmd+R)
   

 ⚙️ 配置

 默认路径

默认配置目录为 $HOME/.config/clashfx

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

 增强模式

ClashFX 的核心功能 — 基于 TUN 的全局代理,捕获所有应用的 TCP/UDP 流量,不仅限于浏览器。

开启方法:
1. 菜单栏 → 增强模式 → 开启
2. 首次使用需要授予管理员权限
3. 所有流量现在都通过 ClashFX 路由

 Claude 专用代理锁定

可将 Claude 桌面版、Claude Code 和 Anthropic 网页流量固定到一个具体节点,并在故障时阻断回落。请查看 Claude 专用代理锁定的用法与保护边界。

 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
  

 🤝 配套仓库:cn-apps-direct

v1.0.38 新增的 "Bypass Common Chinese Apps"(增强模式 → 国内 App 直连) 开关从 Clash-FX/cn-apps-direct 拉取 PROCESS-NAME 规则清单,这是社区共同维护的国内高频 macOS 客户端可执行文件名列表(微信、QQ、钉钉、飞书、哔哩哔哩等)。清单通过 rule-provider 每 24 小时自动更新,与 ClashFX 发版周期解耦。

想加新 app 或修正错误的进程名? 欢迎提 PR——参考 CONTRIBUTING.md。加一个条目大约一分钟:

bash
ls /Applications/.app/Contents/MacOS/    验证实际可执行文件名
 把验证后的名字追加为: PROCESS-NAME,,DIRECT
 开 PR


 📄 许可证

AGPL-3.0

 🙏 致谢

- mihomo — 代理引擎内核
- ClashX — 原始 macOS 客户端
- Yacd-meta — Dashboard 面板

Top issues

Latest release

1.1.11 1.1.11 2026-09-14
Bug Fixes

- Invalid TUN Descriptors No Longer Trigger a Log Storm — The embedded core now treats Darwin bad file descriptor and socket operation on non-socket read failures as closed TUN devices instead of retrying forever. ClashFX also recognizes either signature as an immediate Enhanced Mode recovery signal and rate-limits the errors independently of unrelated traffic logs, preventing the CPU, memory, and UI lockup seen during some post-reboot starts.

---

 修复

- 无效 TUN 描述符不再引发日志风暴 — 内嵌核心现在会把 Darwin 的 bad file descriptor 和 socket operation on non-socket 读取错误视为 TUN 已关闭,不再无限重试。ClashFX 也会把两种错

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON