SELF-HOSTED · MACOS FLEET MONITORING

多台 Mac,
一屏尽览。

MacMon 是一套自托管的 macOS 监控系统:每台 Mac 上的菜单栏客户端持续采样 CPU / 内存 / 磁盘 / GPU,浏览器里看实时曲线、开远程终端。 服务端跑在 Cloudflare Workers 上——没有服务器要维护。

macOS 13+ · Apple Silicon(arm64)· 免安装。下载解压拖进「应用程序」;首次打开如被 Gatekeeper 拦截,右键 → 打开,或执行 xattr -cr /Applications/MacMon.app

60s采样间隔
4 类核心指标
0 台需维护的服务器
2 端权限隔离
MACMON · TestMac
TestMacONLINE
CPU · Apple M412%
内存 · 16 GB72%
磁盘 /92%
GPU · 显存 12.7 GB12%
REMOTE SHELL — /ws/admin
● 密码已在本机校验,PTY 已建立
testmac ~ %
CPU 12%MEM 7.9/16 GBDISK 92%GPU 12%UPTIME 45hTUNNEL CONNECTED采样间隔 60sWS 心跳 25s历史桶 30min指标保留 30 天
01 — CAPABILITIES

为一个面板写不完的功能

采集、传输、终端、账户、权限——一套做完,而不是一堆脚本拼起来。

METRICS

原生级指标采样

Swift 客户端直接调用 Mach API 采样 CPU tick、内存、逐卷磁盘与 GPU 利用率,每分钟上报一次。

host_processor_info · statfs · ioreg IOAccelerator
TERMINAL

浏览器里的真终端

xterm.js 连接服务端隧道,落到客户端 forkpty 起的真实 zsh。CLI 密码只在客户本机校验,服务端永不接触明文。

xterm.js · forkpty · SHA-256 本地哈希
TUNNEL

按主机路由的 WS 隧道

每台主机一条常驻 WebSocket,Durable Object 按主机名分流,PTY 输入输出带会话前缀复用同一条隧道。

WS 心跳 25s · 断线自动重连
ACCOUNTS

邮箱即账户体系

邮箱注册、验证邮件、验证码免密登录(5 分钟有效、60 秒限频),SMTP 用你自己的邮箱发信。

PBKDF2-100k · 7-day sessions · OTP
ACCESS

双端权限隔离

常规端看主机、管个人账户;系统管理端走独立秘密地址、独立登录会话。用户管理 API 只认 admin 会话。

sessions.scope = user | admin
SERVERLESS

一条命令部署

Workers + Durable Object 内置 SQLite 存指标与用户,静态管理端随包发布,自定义域名自动签证书。

wrangler deploy → macmon.win
02 — ARCHITECTURE

三端,一条链路

CLIENT · SWIFT

每台 Mac

菜单栏 app,双击即用。采样上报 + 保持隧道。

  • macmon-gui / MacMon.app
  • CLI 密码仅存本机
  • launchd 开机自启
SERVER · CLOUDFLARE

公网服务端

Workers 路由 API 与 WS,两个 Durable Object 分管数据与隧道。

  • MacMonDB — 内置 SQLite
  • TunnelDO — 按主机分流
  • 指标保留 30 天
ADMIN · SPA

浏览器管理端

React 单页应用,同源托管,无需另起服务。

  • recharts 历史曲线
  • xterm.js 远程终端
  • 常规端 / 系统管理端分离
上报 /report · 60s
隧道 /ws/client
终端 /ws/admin
REST /api/*
03 — SECURITY

四类凭据,各管各的

ack_

API 密钥

脚本与程序化调用的 Bearer 凭证,可在系统管理端随时轮换,等价于管理员身份。

rmk_

上报密钥

client 上报指标、建立隧道的专用凭证,与服务端密钥分离。

SCOPE

双端会话隔离

常规端与系统管理端签发不同 scope 的会话,存储互不干扰,秘密入口只下发给管理员。

CLI

终端密码不出本机

远程终端密码加盐哈希后只存在 client 本地,服务端只转发、不存储、不可见。

04 — DEPLOY

从零到线上,两步

服务端绑定自定义域名后由 Cloudflare 签发证书;每台 Mac 上装一个 MacMon.app,填服务器地址和上报密钥,点开菜单栏图标就开始上报。

⬇ 下载 MacMon.app(Apple Silicon) 进入管理端 →
zsh — deploy
$ cd macmon/server-cf && npx wrangler deploy
Uploaded macmon-server
Deployed → macmon.win (custom domain)
$ cp -R client/build/MacMon.app /Applications/
$ open /Applications/MacMon.app
菜单栏出现 MAC —— 在面板里填服务器与密钥

你的 Mac 们,值得一块仪表盘

一台够用,两台起就会想看全局。注册、装 client、看曲线——十分钟跑完全流程。

现在开始 →