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

- 一、环境准备
- - [1. 系统要求](#1. 系统要求)
  - [2. 项目结构](#2. 项目结构)
- 二、后端服务部署
- - [1. 中间件启动（Docker Compose）](#1. 中间件启动（Docker Compose）)
  - [2. 后端环境配置](#2. 后端环境配置)
  - [3. 依赖安装与数据库迁移](#3. 依赖安装与数据库迁移)
  - [4. 服务启动](#4. 服务启动)
- 三、前端界面搭建
- - [1. 环境配置](#1. 环境配置)
  - [2. 服务启动](#2. 服务启动)
- 四、常见问题排查
- 五、总结

在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

四、常见问题排查

端口冲突 ：检查5001和3000端口是否被占用
环境变量错误 ：确保.env文件无语法错误

五、总结

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

参考文档：