openclaw-monitor/DEPLOY.md

# 🦀 龙虾监控中心 - 部署指南

## 📋 服务架构

```
前端 (React)     后端 (Django)
   ↓                 ↓
端口 4000        端口 9000
   ↓                 ↓
build/静态文件    API 服务
```

## 🚀 快速启动

### 1. 启动后端

```bash
cd code/backend
source venv/bin/activate
python manage.py runserver 0.0.0.0:9000
```

### 2. 构建并启动前端

```bash
cd code/frontend
npm run build
cd build
python3 -m http.server 4000 --bind 127.0.0.1
```

### 3. 访问

- 前端：http://localhost:4000/
- 后端 API: http://localhost:9000/api/

## ⚠️ 常见问题

### Q: 前端显示"加载中..."
**A**: 检查后端是否在 9000 端口运行
```bash
curl http://localhost:9000/api/agents/
```

### Q: API 返回 404
**A**: 确认前端 API 配置正确
- 检查 `src/pages/Dashboard/index.js` 中的 `API_BASE`
- 应该是 `http://localhost:9000/api`

### Q: 代码改了但不生效
**A**: 需要重新 build 前端
```bash
cd code/frontend
npm run build  # 重新构建
# 然后重启前端服务
```

## 🔧 配置文件

### 前端 API 配置
文件：`code/frontend/src/pages/Dashboard/index.js`
```javascript
const API_BASE = 'http://localhost:9000/api';
```

### 后端端口
文件：`code/backend/backend/settings.py`
```bash
# 启动时指定端口
python manage.py runserver 0.0.0.0:9000
```

## 📦 依赖安装

### 后端
```bash
cd code/backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```

### 前端
```bash
cd code/frontend
npm install
```

## 🎯 最佳实践

1. **启动前先 git pull**
   ```bash
   git pull origin main
   ```

2. **前端修改后重新 build**
   ```bash
   npm run build
   ```

3. **后端修改后重启服务**
   ```bash
   # Ctrl+C 停止
   # 重新启动
   ```

4. **检查服务状态**
   ```bash
   # 检查后端
   curl http://localhost:9000/api/agents/
   
   # 检查前端
   curl http://localhost:4000/
   ```

---

*最后更新：2026-04-04*