基于Mac mini的自动化机器人系统7×24小时部署指南

一、系统环境预处理（核心基础）
1.1 电源管理优化
为确保设备持续运行，需禁用所有休眠机制。通过终端执行以下命令：

# 禁用休眠模式（核心配置）
sudo pmset -a disablesleep 1
# 关闭内存转储功能（防止磁盘写入）
sudo pmset -a hibernatemode 0
# 验证配置（应返回disablesleep=1）
pmset -g | grep disablesleep

此配置可避免系统在空闲时进入休眠状态，同时防止内存数据写入磁盘导致的性能损耗。建议定期检查磁盘健康状态，长期运行设备建议配置SSD存储。

1.2 远程管理配置
开启SSH服务便于远程维护，执行命令：

sudo systemsetup -setremotelogin on
# 验证服务状态
systemsetup -getremotelogin

安全建议：修改默认SSH端口（22→非标准端口），配置密钥认证，禁用root登录。可结合防火墙规则限制访问IP范围，提升远程管理安全性。

1.3 运行时环境准备
自动化机器人依赖Node.js环境，建议使用版本管理工具nvm进行安装：

# 安装nvm（若未安装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
# 加载nvm环境
source ~/.zshrc
# 安装指定版本（示例为LTS版本）
nvm install 20.9.0
# 验证安装
node -v && npm -v

版本选择建议：优先使用LTS版本，确保长期支持。可通过nvm ls-remote查看可用版本，使用nvm alias default 20.9.0设置默认版本。

二、机器人程序部署方案
2.1 快速部署模式（推荐新手）
提供自动化安装脚本，执行单条命令即可完成全流程：

# 下载并执行安装脚本（建议先验证脚本来源）
curl -fsSL https://example.com/install.sh | bash -s -- --version=latest

脚本执行流程：

1. 环境检测（Node.js版本、磁盘空间）
2. 依赖安装（pnpm/yarn等包管理器）
3. 程序下载（从CDN获取最新版本）
4. 服务注册（创建systemd服务单元）
5. 权限配置（设置运行用户及目录权限）

2.2 开发者部署模式
适合需要定制开发的场景，完整流程如下：

# 依赖准备
brew install git pnpm
# 代码获取
git clone https://example.com/repo.git
cd repo
# 依赖管理
pnpm install --frozen-lockfile
# 构建生产版本
pnpm build
# 环境变量配置
cp .env.example .env
# 根据需求修改配置文件中的API密钥等参数

关键目录说明：

• /dist：构建输出目录
• /config：配置文件目录
• /logs：运行时日志目录
• /scripts：维护脚本目录

三、核心配置管理
3.1 服务启动配置
创建systemd服务单元文件（/etc/systemd/system/robot.service）：

[Unit]
Description=Automation Robot Service
After=network.target
[Service]
User=deploy
WorkingDirectory=/opt/robot
ExecStart=/usr/local/bin/node dist/main.js
Restart=always
RestartSec=10
EnvironmentFile=/opt/robot/.env
[Install]
WantedBy=multi-user.target

配置完成后执行：

sudo systemctl daemon-reload
sudo systemctl enable robot
sudo systemctl start robot

3.2 持久化配置
建议配置日志轮转（logrotate）和自动更新机制：

# 日志轮转配置示例
/opt/robot/logs/*.log {
    daily
    missingok
    rotate 7
    compress
    delaycompress
    notifempty
    create 640 deploy admin
    sharedscripts
    postrotate
        systemctl reload robot >/dev/null 2>&1 || true
    endscript
}

四、运维监控体系
4.1 基础监控指标
建议监控以下关键指标：

• 进程存活状态（systemctl is-active robot）
• 内存使用率（top -p $(pgrep -f main.js) -b -n 1）
• 日志错误率（grep -c “ERROR” /opt/robot/logs/error.log）
• API响应时间（结合Prometheus监控）

4.2 告警策略配置
示例告警规则（基于通用监控工具）：

- name: RobotProcessDown
  expr: systemctl_is_active{service="robot"} == 0
  for: 1m
  labels:
    severity: critical
  annotations:
    summary: "Robot service is down"
    description: "The automation robot service has been down for more than 1 minute"

4.3 维护最佳实践

1. 每月执行依赖更新：pnpm update --latest
2. 每季度进行安全审计：检查配置文件权限、依赖漏洞
3. 半年度硬件检查：清理风扇灰尘、检查SSD健康状态
4. 制定回滚方案：保留2个历史版本用于快速回退

五、常见问题处理
5.1 进程崩溃排查

1. 检查日志文件：journalctl -u robot -n 100 --no-pager
2. 验证环境变量：printenv | grep ROBOT_
3. 检查端口占用：lsof -i :3000
4. 捕获核心转储：ulimit -c unlimited后重现问题

5.2 性能优化建议

1. 内存泄漏检测：使用node --inspect配合Chrome DevTools
2. CPU占用分析：perf top -p $(pgrep -f main.js)
3. 网络优化：配置连接池参数，启用HTTP keep-alive

本方案通过标准化配置流程和完善的运维体系，确保机器人系统在Mac mini设备上的稳定运行。实际部署时建议先在测试环境验证所有配置，再迁移到生产环境。对于企业级部署，可考虑结合容器化技术实现更灵活的资源管理和故障隔离。