部署前准备:
- 已完成开发环境搭建(参考快速开始文档)
- 服务器满足最低硬件要求:8GB内存、50GB硬盘、4核CPU
- 已安装JDK 17、MySQL 8.x、Redis 6.x
- 已配置向量数据库和对象存储服务
- 重要: 确保Nginx配置支持流式消息传输,这对AI对话体验至关重要
部署架构
LangChat Pro采用前后端分离部署架构,支持单机部署和集群部署。后端部署
Step 1: 项目打包
编译打包
进入项目根目录,执行Maven打包命令:打包完成后,在
langchat-bootstrap/target/ 目录下会生成以下文件:langchat-bootstrap-bin.tar.gz- 完整的部署包langchat-bootstrap.jar- 可执行JAR文件
服务管理
启动服务
启动服务
- 检查Java环境
- 设置JVM参数(内存、GC等)
- 启动Spring Boot应用
- 记录PID到
langchat-bootstrap.pid文件
停止服务
停止服务
- 读取PID文件
- 优雅关闭应用
- 清理PID文件
重启服务
重启服务
- 先停止服务
- 等待进程完全退出
- 再启动服务
查看状态
查看状态
- 检查PID文件
- 验证进程是否运行
- 显示服务状态信息
前端部署
Step 1: 构建前端
流式消息配置说明
关键配置项说明
关键配置项说明
流式消息核心配置:
chunked_transfer_encoding on- 启用分块传输编码,支持流式数据传输proxy_cache off- 关闭代理缓存,避免缓存影响实时数据proxy_buffering off- 关闭代理缓冲,确保数据立即转发tcp_nopush on- 启用TCP_NOPUSH,优化网络传输tcp_nodelay on- 启用TCP_NODELAY,减少延迟
超时设置
超时设置
流式消息超时配置:
proxy_connect_timeout 15s- 连接超时时间proxy_send_timeout 15s- 发送超时时间proxy_read_timeout 15s- 读取超时时间
性能优化
性能优化
流式消息性能优化:
- 使用
location ^~ /api/确保API请求优先匹配 - 使用
rewrite规则简化URL路径 - 设置合适的
worker_connections支持并发连接
监控和日志
日志管理
应用日志
应用日志
系统监控
系统监控
性能优化
JVM优化
根据服务器配置调整JVM参数:数据库优化
MySQL优化
MySQL优化
Redis优化
Redis优化
安全配置
网络安全
防火墙配置
防火墙配置
SSL证书配置
SSL证书配置
备份策略
数据备份
数据库备份
数据库备份
应用备份
应用备份
故障排查
常见问题
服务启动失败
服务启动失败
数据库连接失败
数据库连接失败
内存不足
内存不足
流式消息问题
流式消息问题

