---
name: server_frontend_build_oom
description: 当服务器执行前端构建失败、OOM、或需要部署前端时，应该索引本记忆
---

# 服务器前端构建 OOM

## 问题
服务器（2G 内存 Linux）执行 `npm run build` 时因内存不足导致 OOM，进程被 kill，服务器可能 SSH 超时无响应。

## 解决方案
**不在服务器上构建前端。** 在本地（macOS，充足内存）构建，然后 scp 上传 `static/dist/`。

## 操作步骤
```bash
# 本地构建
cd agents && npm run build

# 打包上传
tar czf /tmp/static_dist.tar.gz static/dist/
scp /tmp/static_dist.tar.gz root@59.110.19.30:/tmp/
ssh root@59.110.19.30 "cd /opt/agent/agents && tar xzf /tmp/static_dist.tar.gz"
```

## 已落实到脚本
- `deploy_agents.sh`（本地）：自动本地 build + 上传
- `refresh_agents.sh`（服务器）：已移除 npm build 步骤，注释说明原因