+0
Daily
306
stars
27
forks
0
watchers
173
prs
104
issues
124
releases
README
ClashFX
A rule-based macOS proxy client with Enhanced Mode (TUN) — powered by mihomo core.
English | 简体中文 | 繁體中文 | 日本語 | Русский
---
✨ Features
- Enhanced Mode (TUN) — Global traffic capture via TUN device, one-click setup
- HTTP/HTTPS and SOCKS protocol support
- Rule-based routing (Domain, IP-CIDR, GeoIP, Process)
- Support for VMess/VLESS/Trojan/Shadowsocks/Hysteria2 protocols
- DNS security with Fake-IP mode
- gVisor userspace network stack
- Apple Silicon native support
- macOS 10.14+ compatibility (including macOS 15 Sequoia)
📥 Installation
Download from the Releases page.
🧪 Update Channels: Stable & Lab
The Lab channel has been live since v1.1.0. Stable remains the default and recommended choice; opt into Lab in Settings → Debug → Update Channel → Lab (Experimental) if you're on v1.1.0+.
ClashFX ships through two update channels. You can choose either — both are first-class.
| | 🟢 Stable | 🟠 Lab |
|---|---|---|
| Default | ✅ | — |
| Release cadence | Every 2–7 days, when fixes accumulate | As soon as a fix lands — sometimes daily |
| What you get | Tested fixes only | Latest fixes + occasional experimental features |
| Visual badge | None | Small orange dot on the top-right of the Dock / Applications icon |
Opt into Lab: open ClashFX → Settings → Debug → Update Channel → Lab (Experimental) and confirm. The orange dot appears immediately. You can switch back to Stable from the same place at any time.
Found a Lab bug? Use Help → Send Feedback… to open a pre-filled GitHub issue (diagnostic info auto-attached and redacted), or Help → Copy Diagnostic Info… to copy the report manually.
Stable users: you're already on the recommended channel — nothing to change.
🔨 Build from Source
Prerequisites
- macOS 10.14 or later
- Xcode 15.0+
- Python 3
- Golang 1.21+
Build Steps
1. Install Golang
bash
brew install golang
2. Install dependencies
bash
bash install_dependency.sh
3. Open and build
bash
open ClashFX.xcworkspace
Build in Xcode (Cmd+R)
⚙️ Configuration
Default Paths
The default configuration directory is $HOME/.config/clashfx
The default configuration file name is config.yaml. You can use custom config names and switch between them in the Config menu.
Enhanced Mode
ClashFX's core feature — TUN-based global proxy that captures all TCP/UDP traffic from every application, not just browsers.
How to enable:
1. Menu Bar → Enhanced Mode → Enable
2. Grant administrator privileges on first use
3. All traffic is now routed through ClashFX
Claude Proxy Lock
Pin Claude Desktop, Claude Code, and Anthropic web traffic to one concrete node with fail-closed protection. See Claude Proxy Lock usage and limits.
URL Schemes
- Import remote config:
clashfx://install-config?url=http%3A%2F%2Fexample.com&name=example
clash://install-config?url=http%3A%2F%2Fexample.com&name=example
- Reload current config:
clash://update-config
🤝 Companion Repo: cn-apps-direct
The 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 也会把两种错