Paper2Slides部署指南：Docker容器化与生产环境配置

Paper2Slides部署指南Docker容器化与生产环境配置【免费下载链接】Paper2SlidesPaper2Slides: From Paper to Presentation in One Click项目地址: https://gitcode.com/gh_mirrors/pap/Paper2SlidesPaper2Slides是一款能够一键将学术论文转换为演示文稿的强大工具通过Docker容器化部署可以快速搭建稳定的生产环境。本文将详细介绍如何使用Docker Compose实现Paper2Slides的完整部署流程包括环境准备、配置调整和系统维护等关键步骤。 环境准备与依赖检查在开始部署前请确保您的系统满足以下要求Docker Engine (20.10.0)Docker Compose (v2.0)至少2GB可用内存网络连接用于拉取镜像和依赖您可以通过以下命令验证Docker环境docker --version docker-compose --version项目获取首先克隆Paper2Slides仓库到本地git clone https://gitcode.com/gh_mirrors/pap/Paper2Slides cd Paper2Slides Docker容器化部署流程目录结构解析项目的Docker相关文件位于docker/目录下包含以下关键文件docker-compose.yml定义服务组合与网络配置Dockerfile.backend后端服务构建配置Dockerfile.frontend前端应用构建配置nginx.conf前端Web服务器配置核心配置文件详解docker-compose.yml配置该文件定义了整个应用的服务架构包括后端API服务和前端Web服务version: 3.8 services: backend: build: context: .. dockerfile: docker/Dockerfile.backend container_name: paper2slides-backend ports: - 8000:8000 volumes: - ../outputs:/app/outputs - ../paper2slides/.env:/app/paper2slides/.env environment: - PYTHONUNBUFFERED1 # API密钥等敏感信息通过环境变量注入 restart: unless-stopped frontend: build: context: .. dockerfile: docker/Dockerfile.frontend container_name: paper2slides-frontend ports: - 5173:80 depends_on: - backend restart: unless-stopped后端Dockerfile解析后端基于Python 3.12构建包含系统依赖安装、Python包管理和服务启动命令FROM python:3.12-slim # 安装系统依赖OpenCV等 RUN apt-get update apt-get install -y --no-install-recommends \ build-essential libglib2.0-0 libsm6 libxext6 libgl1 WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY paper2slides/ ./paper2slides/ COPY api/ ./api/ EXPOSE 8000 CMD [uvicorn, api.server:app, --host, 0.0.0.0, --port, 8000]环境变量配置复制环境变量示例文件创建实际配置cp paper2slides/.env.example paper2slides/.env编辑.env文件配置必要的API密钥和服务地址# 图像生成API配置 IMAGE_GEN_API_KEYyour_api_key_here IMAGE_GEN_BASE_URLhttps://api.example.com # LLM模型配置 RAG_LLM_API_KEYyour_llm_key_here RAG_LLM_BASE_URLhttps://llm-api.example.com LLM_MODELgpt-3.5-turbo 一键启动服务完成配置后使用以下命令启动整个系统cd docker docker-compose up -d首次启动会自动构建镜像可能需要几分钟时间。启动成功后您可以通过以下地址访问服务前端Web界面http://localhost:5173后端API接口http://localhost:8000/docsPaper2Slides的主界面支持PDF、DOCX等多种格式的文档上传⚙️ 生产环境优化配置性能调优建议资源限制设置在docker-compose.yml中添加资源限制避免容器过度占用系统资源services: backend: # ... 其他配置 deploy: resources: limits: cpus: 2 memory: 4G持久化存储确保outputs目录正确挂载保存生成的演示文稿volumes: - ../outputs:/app/outputs日志管理配置日志轮转防止磁盘空间耗尽# 创建日志轮转配置 sudo nano /etc/logrotate.d/paper2slides添加以下内容/var/lib/docker/containers/*/*.log { daily rotate 7 compress delaycompress missingok copytruncate }安全加固措施非root用户运行修改Dockerfile创建专用用户运行应用RUN adduser --disabled-password --gecos appuser USER appuserAPI密钥管理考虑使用Docker Secrets或环境变量注入工具管理敏感信息 服务监控与维护状态检查命令# 查看服务状态 docker-compose ps # 查看日志 docker-compose logs -f # 重启服务 docker-compose restart # 停止服务 docker-compose down自动启动配置设置系统启动时自动启动服务# 创建systemd服务文件 sudo nano /etc/systemd/system/paper2slides.service添加以下内容[Unit] DescriptionPaper2Slides Service Afterdocker.service [Service] WorkingDirectory/path/to/Paper2Slides/docker ExecStart/usr/bin/docker-compose up -d ExecStop/usr/bin/docker-compose down Restartalways [Install] WantedBymulti-user.target启用并启动服务sudo systemctl enable paper2slides sudo systemctl start paper2slides✨ 使用演示成功部署后您可以通过Web界面轻松将论文转换为演示文稿访问http://localhost:5173打开Paper2Slides界面点击Upload按钮上传论文文件支持PDF、DOCX等格式选择生成类型Slides或Poster点击Generate按钮开始转换等待处理完成后下载生成的演示文稿Paper2Slides生成的演示文稿预览界面支持多次生成和下载️ 常见问题解决服务启动失败检查端口是否被占用netstat -tulpn | grep 8000查看详细日志docker-compose logs backend生成速度慢检查网络连接是否正常考虑增加后端服务的CPU/内存资源确认LLM API响应时间是否正常前端无法连接后端检查后端服务是否正常运行确认防火墙设置是否允许端口访问检查前端环境配置中的API地址是否正确通过以上步骤您已经成功部署了Paper2Slides的Docker容器化生产环境。如需进一步定制或扩展功能请参考项目中的docker/README.md文档获取更多信息。【免费下载链接】Paper2SlidesPaper2Slides: From Paper to Presentation in One Click项目地址: https://gitcode.com/gh_mirrors/pap/Paper2Slides创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考