Dify 本地部署指南

一、前置条件

Clone Dify 代码:

复制代码
git clone https://github.com/langgenius/dify.git

在启用业务服务之前,我们需要先部署 PostgresSQL / Redis / Weaviate(如果本地没有的话),可以通过以下命令启动:

复制代码
cd docker
cp middleware.env.example middleware.env
docker compose -f docker-compose.middleware.yaml up -d

二、后端启动(源码启动)

1.进入后端目录api

复制代码
cd api

2.复制环境变量配置文件

复制代码
cp .env.example .env

3.生成随机密钥,并替换 .envSECRET_KEY 的值

复制代码
awk -v key="$(openssl rand -base64 42)" '/^SECRET_KEY=/ {sub(/=.*/, "=" key)} 1' .env > temp_env && mv temp_env .env

4.安装依赖包

Dify API 服务使用 Poetry 来管理依赖。您可以执行 poetry shell 来激活环境。

复制代码
poetry env use 3.10
poetry install

5.执行数据库迁移,将数据库结构迁移至最新版本

复制代码
poetry shell
flask db upgrade

6.启动 API 服务

复制代码
flask run --host 0.0.0.0 --port=5001 --debug

三、后端启动(docker)

1、进入api目录运行docker构建脚本

复制代码
docker build -t dify-api . 

2、运行docker镜像

复制代码
docker run --name dify-api -p 5001:5001 -d dify-api

四、前端启动(源码启动)

1、进入web目录

2、运行npm install

3、运行npm run start

五、前端启动(docker启动)

1、与源码步骤一致

2、运行npm run build

3、运行docker构建命令

复制代码
docker build -t dify-web . 

4、运行docker镜像

复制代码
docker run --name dify-web -p 3000:3000 -d dify-web

以上流程完成后,Dify 的后端 API 将在 http://localhost:5001 提供服务,前端界面则在 http://localhost:3000 可访问。

总结

完成以上步骤后,Dify 的部署分为后端 API 服务和前端界面两部分:

  • 后端 API :在 http://localhost:5001 提供数据和业务逻辑支持。
  • 前端界面 :在 http://localhost:3000 提供用户交互界面。

可根据实际需求选择源码或 Docker 启动方式。通过本地启动的中间件服务(PostgresSQL、Redis 和 Weaviate)支持,确保系统的持久存储、缓存和向量数据库的完整功能。

相关推荐
●VON12 小时前
【AI工具】本地部署 Dify + Ollama 实现无限 Token 智能体搭建
人工智能·学习·dify·智能体·本地·von
内卷焦虑人士1 天前
LightRAG 接入 Dify
工作流·dify·lightrag
LAM LAB4 天前
【无标题】 Dify上传文件API实现失败;已经有upload_file_id但是请求数据返回为空;
dify·文件上传请求
rising start6 天前
Dify在Windows上的部署
大模型·agent·dify
dtsola9 天前
小遥搜索v1.7.0版本更新【飞书文档+知识库支持】
程序员·飞书·dify·ai智能体·独立开发者·vibecoding·一人公司
Arvin_Rong10 天前
Dify Http节点 Text size is too large max size is 1.00 MB错误
dify
handsomestWei11 天前
dify使用简介
工作流·dify·智能体
程序员柒叔12 天前
Dify 一周动态-2026-W14
人工智能·大模型·github·工作流·dify
YoanAILab12 天前
从 CoT、RAG 到 Dify、Deep Research:一篇讲清 AI 问答系统的两条进化路线
人工智能·cot·dify·rag·deepresearch
冷色系里的一抹暖调14 天前
Dify 插件离线打包完整指南(Windows + Docker 版)
docker·ai·dify