本地源码启动
前置条件
安装 Dify 之前, 请确保你的机器已满足最低安装要求:
CPU >= 2 Core
RAM >= 4 GiB
操作系统 | 软件 | 说明 |
---|---|---|
macOS 10.14 or later | Docker Desktop | |
Linux platforms | Docker 19.03 or later Docker Compose 1.25.1 or later | |
Windows with WSL 2 enabled | Docker Desktop |
若需要使用 OpenAI TTS,需要在系统中安装 FFmpeg 才可正常使用,详情可参考:Link。
Clone Dify 代码:
在启用业务服务之前,我们需要先部署 PostgresSQL / Redis / Weaviate(如果本地没有的话),可以通过以下命令启动:
服务端部署
API 接口服务
Worker 异步队列消费服务
安装基础环境
服务器启动需要 Python 3.10.x。建议使用 pyenv 快速安装 Python 环境。
要安装其他 Python 版本,请使用 pyenv install
。
要切换到 "3.10" Python 环境,请使用以下命令:
启动步骤
进入 api 目录
复制环境变量配置文件
生成随机密钥,并替换
.env
中SECRET_KEY
的值执行数据库迁移
将数据库结构迁移至最新版本。
启动 API 服务
正确输出:
启动 Worker 服务
用于消费异步队列任务,如数据集文件导入、更新数据集文档等异步操作。 Linux / MacOS 启动:
如果使用 Windows 系统启动,请替换为该命令:
正确输出:
前端页面部署
Web 前端客户端页面服务
安装基础环境
Web 前端服务启动需要用到 Node.js v18.x (LTS) 、NPM 版本 8.x.x 或 Yarn。
安装 NodeJS + NPM
进入 https://nodejs.org/en/download,选择对应操作系统的 v18.x 以上的安装包下载并安装,建议 stable 版本,已自带 NPM。
启动步骤
进入 web 目录
安装依赖包
配置环境变量。在当前目录下创建文件
.env.local
,并复制.env.example
中的内容。根据需求修改这些环境变量的值:构建代码
启动 web 服务
正常启动后,终端会输出如下信息:
访问 Dify
最后,访问 http://127.0.0.1:3000 即可使用本地部署的 Dify。
Last updated