带你看看Dify的原生数据库中有什么？——深入PostgreSQL

深入Dify底层数据库，揭秘PostgreSQL如何支撑AI应用开发。

核心内容：
Dify三大数据库组件解析：PostgreSQL、Redis与向量数据库的分工协作
PostgreSQL实战指南：从环境配置到端口映射的完整连接流程
数据库操作安全提示与典型应用场景说明

说在前面

dify 提供了拖拉拽的可视化界面，使用起来确实非常方便。

但如果你希望进行深度开发或二次开发，仅仅停留在界面上是远远不够的。

很多关键数据和配置信息其实都存储在数据库中，直接访问数据库将帮助你更好地理解 Dify 的底层逻辑。

本文将以Dify使用的核心关系型数据库PostgreSQL为例，带你看到 Dify 背后的数据库服务。
Dify 使用了哪些数据库？

根据.env配置文件中的设置，Dify 当前使用了以下三类数据库服务，分别承担不同的功能角色：
PostgreSQL（主关系型数据库）
•作用：作为核心数据库，用于存储用户、应用、工作流等结构化数据
•主要配置项：用户名、密码、主机地址、端口、数据库名
•连接池配置：最大连接数为 30，连接回收时间为 3600 秒
Redis（缓存与消息中间件）
•作用：用于缓存数据、处理实时对话的发布/订阅机制
•配置参数：主机地址、端口、密码、数据库编号
•支持模式：哨兵模式和集群模式（当前默认未启用）
向量数据库（默认为 Weaviate）
•作用：用于向量数据的存储与相似性检索
•配置内容：服务端点 URL 和 API 密钥
•扩展能力：支持多种向量数据库选项，如 Qdrant、Milvus、PGVector 等

这些数据库共同构成了 Dify 的数据基础设施，分别负责结构化数据管理、缓存加速和语义级搜索功能。
以PostgreSQL为例：如何进入数据库查看数据？

⚠️ 本文默认你已成功安装并运行 Dify。

如果尚未安装，建议先参考以下教程：

Dify-v1.1.3的安装与配置

Dify 1.5.0 在线Debug的工作流你用上了吗？

如果你要查看或操作PostgreSQL数据库，可以按照下面三个步骤操作：找到DB配置，新增端口映射，连接DB

2.1 找到DB配置

.env的文件路径：dify/docker/.env

DBUSERNAME=postgres # PostgreSQL数据库用户名DBPASSWORD=difyai123456 # PostgreSQL数据库密码DBHOST=db # PostgreSQL数据库主机地址DBPORT=5432 # PostgreSQL数据库端口号DB_DATABASE=dify # PostgreSQL数据库名称
拉取dify仓库后，如果不是很必要，这里就保持默认配置。

2.2 新增DB服务的端口映射

文件路径：dify/docker/docker-compose.yaml

在docker-compose.yaml的 "db" 服务下，新增 5432 端口映射。

注意：主机端口可以修改，内容端口要跟.env的DB_PORT保持一致。

services: api: worker: web: db: image: postgres:15-alpine restart: always ports: – "5432:5432" # 新增db服务的端口映射(主机端口5432:容器端口5432)
命令解释：
1. 端口映射（Port Mapping）是指将容器内部的端口绑定到宿主机的端口
2. 格式为主机端口:容器端口，意思是：将容器内部的5432端口映射到主机的5432端口
3. 这种配置允许外部通过宿主机的端口访问容器内部服务

带你看看Dify的原生数据库中有什么？——深入PostgreSQL