aiagent/（红头）前后端服务器启动和停止.md

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

一、使用 Docker Compose（推荐）

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

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

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

2. 停止所有服务

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

3. 重启所有服务

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

4. 仅重启前端或后端

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

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

---

二、查看服务状态与日志

查看运行状态

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

查看日志

# 所有服务
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（或对应服务名）查看报错并排查。