从零开始部署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的完整运行环境。后端服务负责数据处理与存储,前端界面提供直观的操作界面。


参考文档:

相关推荐
AIGC_北苏11 小时前
Windows安装Docker部署dify,接入阿里云api-key进行rag测试
docker·容器·qwen·dify
AIGC_北苏11 小时前
Dify案例实战之智能体应用构建(一)
agent·workflow·dify
浪淘沙jkp1 天前
AI大模型学习三十、ubuntu安装comfyui,安装插件,修改返回405 bug,值得一看喔
人工智能·学习·ubuntu·comfyui·dify
摘星编程4 天前
华为云Flexus+DeepSeek征文 | DeepSeek-V3/R1商用服务开通体验全流程及使用评测
华为云·ai大模型·dify·deepseek·modelarts
ZHOU_WUYI5 天前
使用Docker Compose部署Dify
docker·容器·dify
Think Spatial 空间思维6 天前
【SSL部署与优化】OCSP Stapling配置指南:减少证书验证延迟
网络·网络协议·https·部署·ssl·优化
无声旅者8 天前
低代码AI开发新趋势:Dify平台化开发实战
人工智能·低代码·agent·dify
肖祥8 天前
ComfyUI+通义万相 Wan2.1系列生成视频教程
dify
susu10830189119 天前
dify基于文本模型实现微调Fine-tune语料构造工作流
dify
小胡说人工智能9 天前
深度剖析:Dify+Sanic+Vue+ECharts 搭建 Text2SQL 项目 sanic-web 的 Debug 实战
人工智能·python·llm·text2sql·dify·vllm·ollama