# 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）持续可用：

```bash
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（可远程唤醒）
```

临时方案：
```bash
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