OpenGPTs私有化部署终极指南：无网络环境AI解决方案

🔥【免费下载链接】opengpts 项目地址: https://gitcode.com/gh_mirrors/op/opengpts

还在为网络限制无法使用AI助手而烦恼？OpenGPTs让你在完全离线的环境中部署私有的AI助手！本文将手把手教你如何快速部署这个开源AI平台，享受完全掌控的AI体验。

通过本文你将获得：

• ✅ 完整的OpenGPTs私有化部署方案
• ✅ Docker一键部署和手动部署两种方式
• ✅ 无网络环境下的AI解决方案
• ✅ 三种AI架构的配置和使用

项目概览

OpenGPTs是一个开源项目，旨在提供类似于OpenAI GPTs的体验，基于LangGraph、LangChain等强大框架构建。它让你完全掌控AI的每一个环节：

• 🧠 AI模型选择：支持60+语言模型
• 🛠️ 工具自定义：100+预置工具或自定义开发
• 💾 向量数据库：60+数据库集成选项
• 🔧 认知架构：三种AI工作模式可选

快速Docker部署

这是最简单的部署方式，适合大多数用户：

1. 环境准备

确保系统已安装Docker和docker-compose：Docker安装指南

2. 克隆项目

git clone https://gitcode.com/gh_mirrors/op/opengpts
cd opengpts

3. 配置环境变量

复制环境模板并配置关键参数：.env.example

cp .env.example .env

编辑.env文件，至少配置：

OPENAI_API_KEY=你的API密钥
POSTGRES_PASSWORD=你的数据库密码

4. 启动服务

docker compose up

等待所有服务启动完成后，访问：

• 前端界面：http://localhost:5173
• 后端API：http://localhost:8100

手动部署方案

如果需要更多自定义控制，可以选择手动部署：

后端部署

进入后端目录：backend/

cd backend
poetry install
make migrate
make start

前端部署

进入前端目录：frontend/

cd frontend
npm install
npm run dev

核心配置说明

数据库配置

项目使用PostgreSQL作为主要数据库：migrations/

POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DB=opengpts
POSTGRES_USER=postgres
POSTGRES_PASSWORD=你的密码

AI模型配置

支持多种AI模型提供商：llms.py

• OpenAI：需要OPENAI_API_KEY
• Anthropic：需要ANTHROPIC_API_KEY
• Azure OpenAI：需要Azure相关配置

三种AI架构模式

1. Assistant模式（智能助手）

最灵活的模式，AI自主决定工具使用：agent_types/tools_agent.py

2. RAG模式（知识检索）

专注于文档检索和知识问答：retrieval.py

3. Chatbot模式（纯聊天）

最简单的对话模式，基于系统提示词：chatbot.py

高级功能配置

自定义工具开发

参考tools.py创建自己的AI工具

文件上传处理

支持多种文档格式解析：upload.py

数据迁移工具

从Redis迁移到PostgreSQL：redis_to_postgres/

部署验证

服务启动后，通过以下方式验证：

1. 前端访问：打开 http://localhost:5173
2. API测试：调用后端接口 http://localhost:8100/docs
3. 数据库检查：确认PostgreSQL连接正常

常见问题解决

端口冲突

修改docker-compose.yml中的端口映射

依赖安装失败

检查Python版本（需要3.11+）和Node.js版本

数据库连接问题

确认PostgreSQL服务正常运行，环境变量配置正确

总结

OpenGPTs为企业提供了完整的私有化AI解决方案，特别适合：

• 🏢 企业内部AI助手部署
• 🔒 数据安全要求高的场景
• 🌐 无外网环境的AI应用
• 🎯 高度自定义的AI需求

通过本文的部署指南，你现在可以轻松搭建属于自己的AI平台，享受完全掌控的AI体验！

点赞/收藏/关注三连，下期我们将深入讲解OpenGPTs的高级功能和二次开发技巧。

🔥【免费下载链接】opengpts 项目地址: https://gitcode.com/gh_mirrors/op/opengpts