nexus/wiki/entities/Mac-Mini-M4.md

Mac Mini M4

Apple Silicon Mac Mini M4，配备 Apple M4 芯片，作为家庭服务器运行各类服务。

Overview

Mac Mini M4 是 Apple 2024 年推出的迷你台式机，搭载 Apple M4 芯片，采用 ARM64 架构。作为 Home Server，它运行 FRP 客户端、N8n 工作流引擎、OpenClaw AI Agent 等服务。

Hardware Specifications

规格	Mac Mini M4
芯片	Apple M4（10核CPU/10核GPU）
内存	可选 16GB/24GB/32GB 统一内存
存储	可选 256GB-2TB SSD
架构	ARM64（Apple Silicon）
尺寸	5cm × 12.7cm × 12.7cm
功耗	约 30-150W（根据负载）

Home Server Use Cases

Core Services

	服务	用途	端口	公网访问
FRP 客户端	内网穿透，远程访问	frpc → VPS:7000	SSH:60026, vaultwarden:15151
OpenClaw	AI Agent（主运行环境）	8080	—
Hermes Agent	个人 AI 助手	Telegram Bot	—
vaultwarden	密码管理器	5151	✅ vaultwarden.ishenwei.online
STQ nginx	STQ 项目前端反向代理	7777	✅ stq-admin.ishenwei.online
STQ frontend	STQ 项目前端	5173	✅ stq.ishenwei.online
STQ web	STQ Web 服务	8000	—
STQ mariadb	STQ 数据库	3306	—
STQ n8n	STQ 专用 n8n	62000	✅ stq-n8n.ishenwei.online
Portainer	Docker 管理（历史版）	9000	已废弃，使用各服务器本地 Portainer

⚠️ 重要更新：n8n 工作流自动化平台已从 Mac Mini 迁移至 Ubuntu2（端口5678），Mac Mini 不再暴露 n8n 端口。

macOS-Specific Considerations

1. ARM64 架构：必须下载 ARM64 版本的软件（如 frp_0.65.0_darwin_arm64.tar.gz）
2. Gatekeeper：需使用 xattr -rd com.apple.quarantine 解除安全限制
3. launchd：使用 launchd + launchctl 管理服务开机自启
4. /opt 目录：需要手动创建并授权
5. Homebrew：macOS 包管理器，安装开发工具

Installation Paths

/opt/                          # 第三方软件安装目录（需手动创建）
├── frp/
│   ├── frp_0.65.0_darwin_arm64/
│   └── current -> frp_0.65.0_darwin_arm64/
└── n8n/
    └── data/

~/Library/LaunchAgents/        # 用户级服务配置
├── com.frpc.client.plist
└── com.n8n.service.plist

Advantages as Home Server

优势	说明
低功耗	空闲时仅 ~3W，负载时 ~150W
无噪音	无风扇设计（被动散热）
高性能	M4 芯片性能远超同功耗 x86
macOS 生态	原生支持 iOS/macOS 开发
ARM64 效率	统一内存架构，高效处理
小巧便携	12.7cm × 12.7cm × 5cm

Remote Access Architecture

[用户/客户端]
       │
       │ 公网（SSH 6000端口）
       ▼
[VPS: 192.227.222.142]
       │
       │ FRP 隧道
       ▼
[Mac Mini M4]
   frpc ←── 连接到 VPS:7000
   SSH:22 ← 远程访问
   N8n:5678
   OpenClaw:8080

Process Management

方法	适用场景	命令
launchd	开机自启（生产环境）	launchctl load/start/stop
tmux	开发调试	tmux new -s / attach
nohup	简单后台	nohup ./program &

Power & Sleep Configuration (Home Server)

作为 Headless 服务器运行，Mac Mini 必须禁用所有自动睡眠行为以确保远程访问工具（RustDesk/VNC）持续可用：

sudo pmset -a sleep 0           # 禁止系统睡眠
sudo pmset -a displaysleep 0    # 禁止显示器关闭
sudo pmset -a standby 0         # 禁止待机模式
sudo pmset -a hibernatemode 0   # 禁止休眠
sudo pmset -a womp 1            # 启用 Wake-on-LAN（可远程唤醒）

临时方案：

caffeinate -d -i -s             # 临时防止睡眠（按 Ctrl+C 停止）

相关概念：pmset | caffeinate | Wake-on-LAN | 系统睡眠管理

Related Concepts

• frp — 内网穿透工具
• launchd — macOS 服务管理器
• Gatekeeper — macOS 安全机制
• 软链接策略 — 版本管理策略
• 内网穿透 — 远程访问机制
• pmset — macOS 电源管理（防止自动睡眠的核心命令）
• caffeinate — macOS 临时防止睡眠
• Wake-on-LAN — 网络唤醒，支持远程唤醒关机状态的 Mac Mini
• 系统睡眠管理 — macOS/Linux 睡眠层级对比框架
• Headless 服务器 — 无显示器服务器模式，Mac Mini 的典型运行方式

Related Entities

• VPS — 内网穿透的公网中转站
• frps — FRP 服务端

References

• Apple: Mac Mini
• Apple Silicon: ARM64 Architecture