如何部署Banana Slides：Docker Compose与源码部署的详细教程

Banana Slides是一款基于原生AI的智能PPT生成应用，支持一句话生成幻灯片、智能解析素材、口头修改指定区域，并能一键导出可编辑的PPT文件。本文将详细介绍两种部署方式：Docker Compose快速部署和源码手动部署，帮助您快速搭建这个强大的AI演示文稿工具。

🚀 快速开始：Docker Compose部署

Docker Compose是最简单快捷的部署方式，适合大多数用户。只需几个命令即可完成完整的环境搭建。

环境要求

• Docker 20.10+
• Docker Compose 2.0+
• 至少4GB可用内存

部署步骤

1. 克隆项目代码

   git clone https://gitcode.com/gh_mirrors/ba/banana-slides
   cd banana-slides
   

2. 启动服务

   docker-compose up -d
   

3. 访问应用 在浏览器中打开 http://localhost:3000 即可使用Banana Slides

Banana Slides商务演示界面

验证部署

部署完成后，可以通过以下命令检查服务状态：

docker-compose ps

所有容器都应显示为"Up"状态。如果遇到问题，可以查看日志：

docker-compose logs

🔧 源码部署：完全控制环境

源码部署适合开发者和需要自定义配置的用户，提供更高的灵活性和控制权。

前端部署

前端使用Vite + React技术栈：

1. 安装依赖

   cd frontend
   npm install
   

2. 启动开发服务器

   npm run dev
   

3. 构建生产版本

   npm run build
   

后端部署

后端基于Python Flask框架：

1. 安装Python依赖

   cd backend
   pip install -r requirements.txt
   

2. 初始化数据库

   flask db upgrade
   

3. 启动后端服务

   python app.py
   

Banana Slides学术演示界面

⚙️ 环境配置详解

数据库配置

Banana Slides使用SQLite作为默认数据库，配置文件位于 backend/config.py。如需使用其他数据库，可在此文件中修改连接配置。

AI服务配置

项目支持多种AI提供商：

• OpenAI GPT系列
• Google Gemini
• 百度文心一言
• 火山引擎

配置示例：

# 在backend/config.py中配置AI服务
OPENAI_API_KEY = "your-api-key"
GEMINI_API_KEY = "your-gemini-key"

🔍 常见问题解决

端口冲突

如果3000端口被占用，可以修改 docker-compose.yml 中的端口映射配置。

内存不足

AI服务需要较多内存，建议分配至少4GB内存给Docker。

API密钥配置

确保正确配置AI服务的API密钥，否则部分功能可能无法正常使用。

Banana Slides创意演示界面

📊 部署方式对比

部署方式	优点	缺点	适用场景
Docker Compose	快速简单、环境隔离	资源占用稍高	生产环境、快速体验
源码部署	完全控制、灵活配置	依赖环境复杂	开发调试、定制需求

🎯 部署成功验证

部署完成后，您应该能够：

• 访问Web界面（默认端口3000）
• 上传模板图片
• 使用AI生成幻灯片内容
• 导出可编辑的PPT文件

💡 最佳实践建议

1. 备份配置：定期备份数据库和配置文件
2. 监控资源：关注内存和CPU使用情况
3. 版本管理：使用Git管理自定义修改

Banana Slides技术演示界面

通过本文的详细教程，您现在应该能够成功部署Banana Slides，无论是使用Docker Compose快速部署还是源码手动部署。选择适合您需求的部署方式，开始体验这个强大的AI原生PPT生成工具吧！

无论您是选择简单快捷的Docker Compose部署，还是需要完全控制的源码部署，Banana Slides都能为您提供出色的AI驱动演示文稿生成体验。