项目简介 (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
步骤 1：部署 OceanBase (SeekDB)
SeekDB 是 OceanBase 专为 AI 应用打造的轻量级嵌入式数据库。它在企业级数据库能力的基础上，融合了向量检索 (Vector Search)、全文检索 (Full-text Search) 和 JSON 支持等 AI 核心特性。
使用以下命令启动 SeekDB 容器：
docker run -d \ --name seekdb \ -p 2881:2881 \ -v ./data:/var/lib/oceanbase/store \ oceanbase/seekdb:latest
注意： 该命令将本地
./data目录挂载到容器内，以确保持久化存储数据。
步骤 2：部署 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 mysql-adapt
2. 应用 OceanBase 适配配置 (Apply Configuration)
将本仓库 (crazywoola/dify-x-oceanbase) 中的配置文件复制到 Dify 的 docker 目录下，覆盖默认配置。假设您已将本仓库下载到 ../dify-x-oceanbase 目录：
# Copy the environment configuration optimized for OceanBase
cp ../dify-x-oceanbase/.env.example .env
Copy the docker-compose file
cp ../dify-x-oceanbase/docker-compose.yaml docker-compose.yaml
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)
