Refly项目私有化部署指南：从零开始搭建AI对话平台

Refly项目私有化部署指南：从零开始搭建AI对话平台

refly 🎨 Refly is an open-source AI-native creation engine. Its intuitive free-form canvas interface combines multi-threaded dialogues, artifacts, AI knowledge base integration, chrome extension clip & save, contextual memory, intelligent search, WYSIWYG AI editor and more, empowering you to effortlessly transform ideas into production-ready content. 项目地址: https://gitcode.com/gh_mirrors/re/refly

前言

Refly是一款开源的AI对话平台，支持知识库检索、多模型切换等高级功能。本文将详细介绍如何将Refly项目部署到本地环境或私有服务器上，让开发者能够完全掌控自己的AI应用。

环境准备

在开始部署前，请确保您的系统满足以下要求：

1. Docker环境：需要安装Docker 20.10.0或更高版本
2. 可选工具：
   • PostgreSQL客户端（用于管理可用的LLM模型）
   • Kubernetes集群（如需容器编排）

技术提示：未来版本将提供原生应用安装包，简化安装流程并增强隐私保护。

详细部署步骤

第一步：获取项目代码

使用Git工具获取Refly项目的最新代码：

git clone https://github.com/refly-ai/refly.git

优化建议：如果仅需Docker部署，可添加--depth 1参数减少下载时间和磁盘占用。

第二步：配置环境变量

进入项目目录并准备环境配置文件：

cd refly/deploy/docker
cp ../../apps/api/.env.example .env

关键说明：.env文件包含了应用运行所需的所有配置参数，包括数据库连接、API密钥等重要信息。

第三步：启动Docker容器

使用Docker Compose启动所有服务：

docker compose up -d

版本选择建议：

• latest标签：稳定版本，适合生产环境
• nightly标签：每日构建版本，包含最新功能

第四步：验证服务状态

检查容器运行状态：

docker ps

预期输出应显示所有容器状态为"Up"和"healthy"，包括以下核心服务：

• API服务
• Qdrant向量数据库
• Redis缓存
• Web前端
• 搜索引擎
• 对象存储
• PostgreSQL数据库

Kubernetes集群部署（高级）

如需在Kubernetes集群中部署：

cd refly/deploy/kubernetes
kubectl apply -f refly-deployment.yaml

访问应用

部署完成后，通过浏览器访问：

• Docker部署：http://服务器IP:5700
• Kubernetes部署：http://服务器IP:30001

常见访问问题排查：

1. 确认服务器IP地址正确
2. 检查应用容器是否正常运行
3. 确保防火墙未阻止相关端口

初始配置指南

1. 用户注册

首次使用需创建管理员账户：

• 提供有效的电子邮箱
• 设置安全密码

2. 模型配置

进入设置界面配置AI模型：

1. 添加模型提供商（如OpenAI、Anthropic等）
2. 配置API密钥和端点
3. 添加聊天模型
4. 设置嵌入模型（知识库必需）
5. 可选配置重排序模型

3. 开始使用

完成配置后即可：

• 创建新对话
• 上传文档构建知识库
• 切换不同AI模型

系统升级指南

升级到最新稳定版本：

docker compose pull
docker compose down
docker compose up -d --remove-orphans

故障排除

常见问题解决方法：

1. 容器健康检查失败：

   docker ps --filter name=refly_ | grep -v 'healthy'
   

2. 查看日志定位问题：

   docker logs <容器ID>
   

3. API服务异常：

   docker restart refly_api
   

4. 持久性问题：

   • 检查数据库连接配置
   • 验证存储卷挂载是否正确

结语

通过本文的详细指导，您应该已经成功完成了Refly项目的私有化部署。这个开源AI平台为您提供了完全可控的对话AI解决方案，无论是用于个人学习、企业应用还是二次开发，都能满足您的需求。如果在部署过程中遇到任何技术问题，建议查阅详细的日志信息或寻求社区支持。

refly 🎨 Refly is an open-source AI-native creation engine. Its intuitive free-form canvas interface combines multi-threaded dialogues, artifacts, AI knowledge base integration, chrome extension clip & save, contextual memory, intelligent search, WYSIWYG AI editor and more, empowering you to effortlessly transform ideas into production-ready content. 项目地址: https://gitcode.com/gh_mirrors/re/refly