# 前后端服务器启动和停止说明

## 一、使用 Docker Compose（推荐）

本项目前后端及依赖服务均通过 `docker-compose.dev.yml` 管理，需在项目根目录执行以下命令。

### 1. 启动所有服务（前端 + 后端 + Redis + Celery）

```bash
cd /home/renjianbo/aiagent
docker-compose -f docker-compose.dev.yml up -d
```

### 2. 停止所有服务

```bash
cd /home/renjianbo/aiagent
docker-compose -f docker-compose.dev.yml down
```

### 3. 重启所有服务

```bash
cd /home/renjianbo/aiagent
docker-compose -f docker-compose.dev.yml restart
```

### 4. 仅重启前端或后端

```bash
# 仅重启前端
docker-compose -f docker-compose.dev.yml restart frontend

# 仅重启后端
docker-compose -f docker-compose.dev.yml restart backend
```

---

## 二、查看服务状态与日志

### 查看运行状态

```bash
docker-compose -f docker-compose.dev.yml ps
```

### 查看日志

```bash
# 所有服务
docker-compose -f docker-compose.dev.yml logs -f

# 仅前端
docker-compose -f docker-compose.dev.yml logs -f frontend

# 仅后端
docker-compose -f docker-compose.dev.yml logs -f backend

# 仅 Celery
docker-compose -f docker-compose.dev.yml logs -f celery

# 仅 Redis
docker-compose -f docker-compose.dev.yml logs -f redis
```

---

## 三、服务与端口说明

| 服务   | 宿主机端口 | 说明           |
|--------|------------|----------------|
| 前端   | 8038       | 低代码智能体平台页面 |
| 后端   | 8037       | API 服务       |
| Redis  | 6380       | 缓存/队列（避免与宿主机 6379 冲突） |
| Celery | —          | 仅内网，无宿主机端口映射 |

---

## 四、访问地址

- **前端页面**: http://localhost:8038 或 http://101.43.95.130:8038  
- **后端 API**: http://localhost:8037 或 http://101.43.95.130:8037  
- **API 文档**: http://localhost:8037/docs  
- **健康检查**: http://localhost:8037/health  

---

## 五、注意事项

1. 所有 `docker-compose` 命令均需指定 `-f docker-compose.dev.yml`，且建议在项目根目录 `/home/renjianbo/aiagent` 下执行。  
2. 停止服务使用 `down`，不会删除镜像和已创建的卷（如 Redis 数据卷）。  
3. 若宿主机 6379 已被占用，Redis 已改为使用宿主机端口 **6380**，无需再改配置。  
4. 云服务器部署时，需在安全组中放行 **8038**（前端）和 **8037**（后端）端口。  

---

## 六、常见问题

| 现象           | 处理建议 |
|----------------|----------|
| 端口被占用     | 检查 8037、8038、6380 是否被占用；必要时修改 `docker-compose.dev.yml` 中端口映射。 |
| 前端能开、登录报错 | 检查后端是否启动、8037 是否放行；在服务器上执行 `curl http://127.0.0.1:8037/health` 验证。 |
| 容器反复退出   | 使用 `docker-compose -f docker-compose.dev.yml logs backend`（或对应服务名）查看报错并排查。 |