从0到1部署LaunchStack：Docker Compose与PostgreSQL+pgvector配置教程

从0到1部署LaunchStackDocker Compose与PostgreSQLpgvector配置教程【免费下载链接】LaunchStackAI-powered StartUp Accelerator Engine built with Next.js, LangChain, PostgreSQL pgvector. Upload, organize, and chat with documents. Includes predictive missing-document detection, role-based workflows, and page-level insight extraction.项目地址: https://gitcode.com/gh_mirrors/pd/LaunchStackLaunchStack是一款基于Next.js、LangChain、PostgreSQL和pgvector构建的AI驱动创业加速引擎支持文档上传、组织和智能对话具备预测性缺失文档检测、基于角色的工作流和页面级洞察提取功能。本教程将详细介绍如何使用Docker Compose快速部署LaunchStack并正确配置PostgreSQL与pgvector扩展以实现高效的语义检索。准备工作环境与依赖检查在开始部署前请确保您的系统满足以下要求Docker Engine 20.10 和 Docker Compose v2Git 版本控制工具至少4GB可用内存推荐8GB以上以支持AI服务网络连接用于拉取Docker镜像和项目代码首先克隆项目仓库git clone https://gitcode.com/gh_mirrors/pd/LaunchStack cd LaunchStack项目的Docker配置文件位于根目录主要包括docker-compose.yml- 主部署配置docker-compose.ocr.yml- OCR服务扩展配置docker-compose.test.yml- 测试环境配置核心架构解析Docker Compose服务组成LaunchStack的Docker Compose配置包含多个协同工作的服务其中核心组件包括LaunchStack服务架构示意图展示各组件协同工作流程关键服务组件说明PostgreSQL pgvector(db服务)镜像pgvector/pgvector:pg16已预安装pgvector扩展端口映射5433:5432避免与本地PostgreSQL冲突数据持久化通过postgres_data卷保存数据库文件初始化脚本./docker/init-db.sql自动启用pgvector扩展应用服务(app服务)基于Next.js构建的主应用依赖数据库、迁移服务、Sidecar服务等端口3000Web访问端口数据库迁移(migrate服务)自动执行数据库模式迁移依赖PostgreSQL服务健康检查通过文件存储(seaweedfs服务)轻量级分布式文件系统用于存储上传的文档和媒体文件AI辅助服务(sidecar服务)提供嵌入、重新排序和转录等AI功能健康检查通过/health端点监控服务状态快速部署使用Docker Compose一键启动基础部署不含OCR功能执行以下命令启动核心服务docker compose up -d该命令会启动PostgreSQL数据库含pgvectorNext.js应用服务器SeaweedFS文件存储Inngest工作流引擎必要的辅助服务完整部署含OCR功能如需启用文档OCR处理能力支持DOCX、PPTX等格式添加ocr配置文件docker compose -f docker-compose.yml -f docker-compose.ocr.yml up -d完整部署会额外启动docling-serve文档解析服务ocr-workerOCR处理工作节点ocr-routerOCR请求路由服务验证部署状态检查所有服务是否正常运行docker compose ps正常情况下所有服务应显示为running或healthy状态。PostgreSQL与pgvector配置详解数据库连接配置应用通过环境变量DATABASE_URL连接PostgreSQL默认配置为postgresql://postgres:passworddb:5432/pdr_ai_v2如需自定义数据库凭据创建.env文件设置POSTGRES_PASSWORDyour_secure_password DATABASE_URLpostgresql://postgres:your_secure_passworddb:5432/pdr_ai_v2pgvector扩展验证pgvector扩展在数据库初始化时自动启用可通过以下步骤验证进入PostgreSQL容器docker exec -it pdr_ai_v2-postgres psql -U postgres -d pdr_ai_v2在PostgreSQL终端执行SELECT * FROM pg_extension WHERE extname vector;若返回结果包含vector扩展则表示配置成功。向量索引优化项目已预设高效的向量索引定义在以下文件中apps/web/drizzle/0009_embeddings_hnsw_indexes.sql该文件创建了HNSW索引使用默认参数m16, ef_construction64平衡检索速度和精度-- 示例索引定义来自0009_embeddings_hnsw_indexes.sql CREATE INDEX IF NOT EXISTS document_embeddings_hnsw_idx ON document_embeddings USING hnsw (embedding vector_cosine_ops);环境变量配置解锁全部功能LaunchStack需要一些关键环境变量才能启用完整功能主要配置在docker-compose.yml的app服务部分LaunchStack环境变量配置示意图展示关键AI服务参数必要环境变量变量名说明示例值OPENAI_API_KEYOpenAI API密钥sk-xxxxCLERK_SECRET_KEYClerk身份验证密钥sk_test_xxxxNEXT_PUBLIC_CLERK_PUBLISHABLE_KEYClerk客户端密钥pk_test_xxxx配置方法创建项目根目录下的.env文件添加所需变量# AI服务配置 OPENAI_API_KEYsk-your_openai_key CHAT_MODELgpt-4o-mini EMBEDDING_MODELtext-embedding-3-small # 身份验证配置 CLERK_SECRET_KEYsk_test_your_clerk_key NEXT_PUBLIC_CLERK_PUBLISHABLE_KEYpk_test_your_clerk_key # 存储配置 S3_ACCESS_KEYyour_custom_access_key S3_SECRET_KEYyour_custom_secret_key修改后需重启服务使配置生效docker compose down docker compose up -d访问与验证确认部署成功访问Web界面在浏览器中访问以下地址http://localhost:3000您应该能看到LaunchStack的登录界面。首次使用需注册账号系统会自动创建管理员账户。验证核心功能文档上传测试导航至Documents页面上传一个PDF或DOCX文件确认文件状态变为Processed语义搜索测试在搜索框输入与上传文档相关的关键词验证系统返回相关文档片段向量检索验证 查看数据库中的嵌入向量docker exec -it pdr_ai_v2-postgres psql -U postgres -d pdr_ai_v2 -c SELECT id, embedding FROM document_embeddings LIMIT 1;常见问题解决数据库连接失败若应用无法连接PostgreSQL检查db服务是否健康运行docker compose logs db数据库凭据是否正确检查.env文件中的DATABASE_URL网络连通性使用docker network inspect launchstack_default确认网络配置pgvector扩展未加载若向量功能不工作执行以下命令手动启用扩展docker exec -it pdr_ai_v2-postgres psql -U postgres -d pdr_ai_v2 -c CREATE EXTENSION vector;内存不足问题若服务频繁崩溃可能是内存不足增加Docker可用内存推荐至少8GB禁用非必要服务如OCR相关组件进阶操作服务管理与维护查看服务日志查看特定服务日志# 查看应用日志 docker compose logs -f app # 查看数据库日志 docker compose logs -f db数据库备份执行以下命令备份PostgreSQL数据./scripts/backup-db.sh备份文件将保存至./backups目录。版本更新更新LaunchStack至最新版本git pull docker compose down docker compose up -d --build总结通过Docker Compose部署LaunchStack是快速搭建AI驱动文档管理系统的理想方式。本教程涵盖了从环境准备到完整部署的全过程重点介绍了PostgreSQL与pgvector的配置要点。现在您已拥有一个功能完备的创业加速引擎可用于文档管理、智能检索和团队协作。如需深入了解项目架构可参考官方文档docs/Architechture/Overall.md。对于生产环境部署建议查看详细部署指南docs/deployment.md。【免费下载链接】LaunchStackAI-powered StartUp Accelerator Engine built with Next.js, LangChain, PostgreSQL pgvector. Upload, organize, and chat with documents. Includes predictive missing-document detection, role-based workflows, and page-level insight extraction.项目地址: https://gitcode.com/gh_mirrors/pd/LaunchStack创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考