+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
#75增强模式还是本身bug?32 comments · 2026-05-13#236[Bug] 测速又出问题了15 comments · 2026-09-16#219[Bug] 代理端口自行改变、设置界面文本截断及重启后状态栏图标位置重置11 comments · 2026-08-27#221[Bug] UI 面板颜色渲染异常、主题切换延迟与优化建议10 comments · 2026-08-28#166[Feature]MacOS中“设置为系统代理”快捷键⌘S冲突10 comments · 2026-07-13#85[Feature]希望可以默认自带开启增强模式(TUN),微信,QQ等能直接分流,直连系统代理7 comments · 2026-05-24#276[Bug][Lab 1.1.11.16] 退出 ClashFX 时若系统网络偏好被占用,退出流程永久卡死(core success=false,App 无法退出)6 comments · 2026-11-10#115[Bug] 控制台修改后无法长期保存6 comments · 2026-06-02
Latest release
1.1.11 1.1.11 2026-09-14Bug 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 也会把两种错