版本、权限、PATH
常见根因是两套环境：图形终端是登录 shell；ssh host cmd、launchd、CI 常为非登录 shell，PATH 缺 nvm/fnm 或 /opt/homebrew/bin，Node 从 LTS 退回系统旧版。另一类是 npm -g 属主错误致 EACCES。顺序：node -v、which node、npm -v → 对比 ssh host 'echo $PATH' → 查端口与属主。装法路径差异见
安装路径排错。
Node LTS 锁定
以 Active LTS 为基线；放 .nvmrc，非交互用绝对路径调 Node，或在 launchd 写死环境块。corepack enable 须与运行用户一致。远端跑 node -p "process.version+' '+process.arch" 与 command -v node，不一致先对齐 Node。
nvm use 不作用于 SSH；需 profile 或包装脚本 source。
权限与 PATH
| 场景 | 症状 | 命令 |
|---|---|---|
| SSH | 无 node | bash -lc 'which node' |
| launchd | 任务偶败 | launchctl print gui/$(id -u) |
| npm -g | EACCES | npm config get prefix |
prefix 属主与运行用户一致，勿混装 /usr/local 与 /opt/homebrew；安装与运行同一用户。
区域验证
区域影响 DNS/TLS/出口。跑：curl -I https://registry.npmjs.org、dig +short registry.npmjs.org、sntp time.apple.com、lsof -nP -iTCP -sTCP:LISTEN | grep LISTEN，连 RTT 存档。
内存与 M4 Pro 并发
16GB 单 Gateway；24GB 加并行装依赖；M4 Pro 多 Worker 要队列限峰。租期见 租机与延迟矩阵。 每台机留快照：Node 绝对路径、PATH、属主、端口。
速记
SSH 无 node：bash -lc 或脚本先 source profile。美日主备看协作地与 API，用第 4 节同时段对比。
在 Mac mini 上把环境钉死
macOS 前缀与权限一致，Gatekeeper、SIP、FileVault 叠用更安全；M4 待机约 4W、静音，适合长期 Gateway；统一内存利好多进程，TCO 优于自组机。
若你要少重装、少踩 PATH，Mac mini M4 仍是 2026 年高性价比起点：先跑通上文命令再扩并发；可入手或租用上线。