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

原创已于 2025-03-01 07:37:13 修改

· 6.1k 阅读

11 ·

版权

文章标签：

#Dify #部署

于 2025-02-03 22:56:10 首次发布

LINUX 专栏收录该内容

914 篇文章

订阅专栏

从零开始部署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）
pnpm：版本9.12.2（用于前端依赖管理）

2. 项目结构

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

二、后端服务部署

1. 中间件启动（Docker Compose）

# 进入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. 后端环境配置

# 进入API目录
cd ../api

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

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

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

# 激活Poetry环境
poetry self update
poetry self add poetry-plugin-shell
poetry shell

# 安装依赖
poetry env use 3.12
poetry install

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

4. 服务启动

# 后台启动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. 环境配置

# 安装Node.js依赖
pnpm install

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

# 示例配置（根据实际环境调整）
NEXT_PUBLIC_DEPLOY_ENV=DEVELOPMENT
NEXT_PUBLIC_EDITION=SELF_HOSTED
NEXT_PUBLIC_API_PREFIX=http://localhost:5001/console/api
NEXT_PUBLIC_PUBLIC_API_PREFIX=http://localhost:5001/api
NEXT_PUBLIC_SENTRY_DSN=

2. 服务启动

# 开发模式启动
pnpm run dev

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

3. 生产环境部署

# 构建生产环境应用
pnpm run build

# 启动生产环境服务
pnpm run start

# 自定义端口和主机
pnpm run start --port=3001 --host=0.0.0.0

四、测试

1. 后端测试

# 安装测试依赖
poetry install -C api --with dev

# 运行测试
poetry run -P api bash dev/pytest/pytest_all_tests.sh

2. 前端测试

# 运行单元测试
pnpm run test

五、常见问题排查

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

六、总结

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

参考文档：