生产环境部署
目录
简介
本指南详细说明了从开发到生产环境的配置演进过程，重点介绍基于 docker-compose.prod.yml 的生产级服务配置。内容涵盖后端使用Gunicorn多工作进程部署、前端生产镜像构建、MySQL性能优化参数（如InnoDB缓冲池、最大连接数）、Redis持久化与内存策略，以及Nginx生产配置（包括反向代理规则、静态资源缓存策略、Gzip压缩和安全头）。同时，指南还说明了如何通过环境变量注入敏感信息，并指导配置HTTPS（可结合Let's Encrypt），最后提供部署验证步骤以确保高可用性和性能优化措施生效。
项目结构
本项目采用前后端分离架构，使用Docker进行容器化部署。核心结构包括后端服务（FastAPI）、前端应用（Vue 3）、MySQL数据库、Redis缓存和Nginx反向代理。
图示来源
本节来源
核心组件
本系统的核心组件包括使用Gunicorn部署的FastAPI后端、基于Vue 3的前端应用、MySQL数据库、Redis缓存和Nginx反向代理服务器。生产环境通过Docker Compose进行编排，确保各服务的高可用性和性能优化。
本节来源
架构概述
系统采用现代化的微服务架构，前端通过Nginx反向代理与后端API通信。后端使用Gunicorn作为WSGI服务器，管理多个Uvicorn工作进程，实现高并发处理能力。数据存储层由MySQL和Redis组成，分别负责持久化数据和缓存。
图示来源
详细组件分析
后端服务分析
后端服务采用Gunicorn多工作进程模式部署，每个工作进程运行一个Uvicorn Worker，实现异步高性能处理。
图示来源
本节来源
前端服务分析
前端服务采用多阶段Docker构建，首先在构建阶段安装依赖并构建生产版本，然后在运行阶段使用轻量级Nginx容器提供服务。
图示来源
本节来源
数据库服务分析
MySQL和Redis服务在生产环境中进行了专门的性能优化配置。
图示来源
本节来源
Nginx配置分析
Nginx配置包含了反向代理、静态资源缓存、Gzip压缩和安全头等生产环境关键配置。
图示来源
本节来源
依赖分析
系统各组件之间的依赖关系清晰，通过Docker Compose进行编排管理。
图示来源
本节来源
性能考虑
生产环境的性能优化主要体现在以下几个方面：
- 后端性能：使用Gunicorn管理4个Uvicorn工作进程，充分利用多核CPU，提高并发处理能力。
- 数据库性能：MySQL配置了1GB的InnoDB缓冲池和1000的最大连接数，Redis配置了512MB的最大内存和LRU淘汰策略。
- 前端性能：Nginx配置了静态资源的长期缓存（1年）和Gzip压缩，减少网络传输量。
- 安全性能：Nginx配置了X-Frame-Options、X-Content-Type-Options等安全头，提高应用安全性。
本节来源
故障排除指南
当部署出现问题时，可以按照以下步骤进行排查：
本节来源
结论
本指南详细介绍了AgentChat系统的生产环境部署方案。通过docker-compose.prod.yml文件，我们实现了后端Gunicorn多工作进程部署、前端生产镜像构建、MySQL和Redis的性能优化配置。Nginx配置文件提供了反向代理、静态资源缓存、Gzip压缩和安全头等关键生产环境特性。通过环境变量注入敏感信息，确保了配置的安全性。建议在生产环境中结合Let's Encrypt配置HTTPS，以提供更安全的通信。部署后，应通过提供的验证步骤确保所有高可用性和性能优化措施均已生效。