131 lines
4.7 KiB
Markdown
131 lines
4.7 KiB
Markdown
# 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
|