ClashMax
原生 macOS Mihomo 代理控制台。把配置、代理组、连接、规则、日志和系统代理/TUN 收进一个安静、可扫描的 SwiftUI 工作面。
SwiftUI
native macOS 26+
Mihomo v1.19.24
bundled sidecar core
GPL-3.0
open source boundary
running
127.0.0.1 controller / bearer auth
Runtime snapshot
Profile
default.yaml
Mode
Rule
System proxy
managed
TUN
helper path
Controller secret
per run
proxy provider health check completed
rule GEOIP matched direct
conn closed stale tcp session
tun macOS runtime without auto-redirect
Route surface
Proxy groups
switchable
Connections
inspectable
Logs
streaming
原始 profile 保持不动,运行态配置由 ClashMax 托管。
日常使用不应该把订阅文件改得面目全非。ClashMax 在启动前生成 runtime YAML,用来注入端口、controller、secret、DNS、TUN 和运行模式。
Input profile
profiles/
default.yaml
work.yaml
lab.yaml
subscription url -> Keychain
source yaml -> local storage
Managed runtime
external-controller: 127.0.0.1:<port>
secret: generated per run
tun: helper-owned path on macOS
system proxy: snapshot -> set -> restore
controller access: Bearer auth
第一屏就是代理客户端,不绕到营销页。
ClashMax 的界面方向是密度适中、状态明确、可快速操作。常用页面围绕 Mihomo 控制面展开。
01
Dashboard
启动、停止、运行模式、系统代理和 TUN 状态。
02
Profiles
导入本地 YAML,管理订阅,更新、重命名和删除。
03
Proxies
代理组切换、延迟测试、provider health check。
04
Connections
查看连接、目标地址、规则命中和实时流量。
05
Rules
检查运行时规则列表,定位配置命中路径。
06
Logs
观察 Mihomo 日志,排查配置和网络异常。
07
Settings
管理 core、helper、更新源和运行参数。
08
Menu Bar
从菜单栏快速查看状态和执行轻量操作。
安全边界写清楚,权限路径尽量窄。
代理客户端会触碰系统网络设置,所以默认行为必须具体、可检查、可恢复。
Local controller
Mihomo controller 默认监听 127.0.0.1,不会把控制面暴露给局域网。
Per-run secret
每次启动生成新的 controller secret,访问 Mihomo REST/WebSocket 控制面时使用 Bearer auth。
Helper boundary
普通系统代理走用户态 core;TUN 相关能力交给 privileged helper,并校验 app-owned core/config paths。
开源、早期、欢迎直接挑问题。
ClashMax 使用 GPL-3.0 发布。遇到复现稳定的问题,直接发 Issue;如果这个方向对你有用,也欢迎给项目一个 Star。