ClashMax icon

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
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
Proxy groups switchable
Connections inspectable
Logs streaming

原始 profile 保持不动,运行态配置由 ClashMax 托管。

日常使用不应该把订阅文件改得面目全非。ClashMax 在启动前生成 runtime YAML,用来注入端口、controller、secret、DNS、TUN 和运行模式。

profiles/ default.yaml work.yaml lab.yaml subscription url -> Keychain source yaml -> local storage
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。