项目简介 (Description)
通过本项目,您可以配置 Dify 使用 OceanBase 的轻量化版本 seekdb,同时作为向量数据库(用于 RAG 检索)和元数据库,从而实现底层存储架构的统一与简化。
前置要求 (Prerequisites)
在开始部署之前,请确保您的环境满足以下要求:
- Python: version ≥ 3.12
- Container Runtime: Docker & Docker Compose
- Git: Version control tool
- Hardware: macOS (Homebrew recommended) or Linux
步骤 :部署 Dify
本部分将指导您基于 mysql-adapt 分支部署 Dify,并应用本仓库中的特定配置以适配 OceanBase。
1. 克隆代码与切换分支 (Clone & Checkout)
首先,克隆官方 Dify 仓库并切换到支持 MySQL/OceanBase 协议的特定分支:
git clone https://github.com/langgenius/dify.git
cd dify
cd docker
git checkout main
2. 应用 OceanBase 适配配置 (Apply Configuration)
假设您已将本仓库下载到 ../dify-x-oceanbase 目录:
# Copy the environment configuration optimized for OceanBase
cd dify
cd docker
# 复制环境变量模板
cp .env.example .env
# 设置数据库类型为 mysql, 并且修改元数据库连接信息
DB_TYPE=mysql
DB_USERNAME=root
DB_HOST=seekdb
DB_PORT=2881
DB_DATABASE=test
# 设置向量存储为 OceanBase
VECTOR_STORE=oceanbase
# 修改OCEANBASE的连接信息为seekdb的对应连接信息
OCEANBASE_VECTOR_HOST=seekdb
OCEANBASE_VECTOR_USER=root
# 修改 COMPOSE_PROFILES 为 seekdb
COMPOSE_PROFILES=seekdb
3. 启动服务 (Start Dify)
使用 Docker Compose 构建并启动 Dify 服务:
docker compose up --build -d

验证安装 (Verification)
-
访问 Dify 控制台: 打开浏览器访问
http://localhost(或您的服务器 IP)。 - 创建账号: 注册管理员账号并登录。
- 测试向量能力: 创建一个知识库 (Knowledge Base),上传文档并观察切片与索引过程。如果能够成功嵌入 (Embedding) 并检索,说明 seekdb 向量存储配置成功。
积分悬赏课后题,最先截图附上结果的小伙伴,每人送积分30分。
请提供元数据+向量数据都使用 seekdb 的 Dify 截图
PPT
2025年度发布会 Dify 郑立.pdf (5.1 MB)