从零开始部署Dify:后端与前端服务完整指南

从零开始部署Dify:后端与前端服务完整指南

在AI应用开发中,Dify作为一款功能强大的工具,其部署过程涉及多个技术栈的整合。本文将详细讲解如何从零开始搭建Dify的完整环境,包括后端服务和前端界面的配置与启动。


一、环境准备

1. 系统要求

  • 操作系统:Windows Subsystem for Linux (WSL) 或 Ubuntu 22.04+
  • Docker:版本24.0+
  • Python:3.12(通过Poetry管理)
  • Node.js:v18.x LTS(NPM/Yarn)

2. 项目结构

复制代码
dify/
├── docker/
│   ├── docker-compose.middleware.yaml
│   └── middleware.env
├── api/
│   ├── .env
│   └── requirements.txt
└── web/
    ├── package.json
    └── .env.local

二、后端服务部署

1. 中间件启动(Docker Compose)

bash 复制代码
# 进入docker目录
cd ../docker

# 复制环境变量模板
cp middleware.env.example middleware.env

# 启动Weaviate配置的中间件栈
docker compose -f docker-compose.middleware.yaml \
  --profile weaviate \
  -p dify \
  up -d

注意 :在WSL环境中,不能使用/mnt路径,否则dify-db-1容器报错initdb: error: could not change permissions of directory "/var/lib/postgresql/data/pgdata": Operation not permitted,无法启动。

2. 后端环境配置

bash 复制代码
# 进入API目录
cd ../api

# 生成随机密钥
sed -i "/^SECRET_KEY=/c\SECRET_KEY=$(openssl rand -base64 42)" .env

3. 依赖安装与数据库迁移

bash 复制代码
# 激活Poetry环境
poetry env use 3.12
poetry lock
poetry install

# 数据库迁移
poetry run python -m flask db upgrade

4. 服务启动

bash 复制代码
# 后台启动API服务
poetry run python -m flask run \
  --host 0.0.0.0 \
  --port=5001 \
  --debug

# 启动Celery异步任务队列
poetry run python -m celery \
  -A app.celery worker \
  -P gevent \
  -c 1 \
  --loglevel INFO \
  -Q dataset,generation,mail,ops_trace,app_deletion

三、前端界面搭建

1. 环境配置

bash 复制代码
# 安装Node.js依赖
npm install

# 配置环境变量
cp .env.example .env.local

# 示例配置(根据实际环境调整)
NEXT_PUBLIC_API_PREFIX=http://localhost:5001/console/api
NEXT_PUBLIC_PUBLIC_API_PREFIX=http://localhost:5001/api

2. 服务启动

bash 复制代码
# 开发模式启动
npm run dev

# 访问地址
http://localhost:3000

四、常见问题排查

  1. 端口冲突 :检查50013000端口是否被占用
  2. 环境变量错误 :确保.env文件无语法错误

五、总结

通过以上步骤,我们成功搭建了Dify的完整运行环境。后端服务负责数据处理与存储,前端界面提供直观的操作界面。


参考文档:

相关推荐
肖祥1 天前
DeepSeek 多模态模型 Janus-Pro 本地部署
dify
肖祥2 天前
windows11 安装WSL2详细过程
dify
Silence4Allen3 天前
Dify 完全指南(一):从零搭建开源大模型应用平台(Ollama/VLLM本地模型接入实战)》
ai·大模型·dify·rag
engchina5 天前
如何在Dify沙盒中安装运行pandas、numpy
numpy·pandas·dify·代码节点
梁萌8 天前
dify升级最新版本(保留已创建内容)
docker·升级·dify
肖祥9 天前
LM Studio本地使用
dify
engchina10 天前
Dify 使用 excel 或者 csv 文件创建知识库
excel·dify
小草cys10 天前
AI工作流自动化与智能应用开发平台
运维·人工智能·自动化·dify
肖祥11 天前
ragflow k8s部署详细过程
dify
q_q王11 天前
dify对接飞书云文档,并且将图片传入飞书文档
python·大模型·飞书·dify·智能体·图片展示