105 lines
2.9 KiB
Markdown
105 lines
2.9 KiB
Markdown
# 前后端服务器启动和停止说明
|
||
|
||
## 一、使用 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`（或对应服务名）查看报错并排查。 |
|