企业官网建设流程全解析

Dify 自托管部署指南

Dify 是一个开源的 LLM 应用开发平台，提供直观的界面和强大的 API，帮助开发者快速构建、部署和管理基于大语言模型的应用。

一、功能特性

• 对话应用：创建聊天机器人、客服系统等对话式应用
• 工作流：可视化编排复杂的 AI 工作流程
• 知识库：管理和检索文档、数据等知识资源
• 模型管理：支持多种大语言模型（GPT、Claude、文心一言等）
• API 接口：提供 RESTful API，方便集成到其他系统
• 用户管理：支持多租户、角色权限管理

二、系统要求

三、快速部署

1. 安装依赖

确保已安装以下工具：

• Docker：Windows/macOS 下载 Docker Desktop，Linux 使用系统包管理器安装
• Git：确保 Git 已安装

2. 克隆源码

gitclone https://github.com/langgenius/dify.gitcddify/docker

3. 复制配置文件

cp.env.example .env

4. 启动容器

dockercompose up-d

首次运行会自动拉取镜像，耗时约 5~20 分钟（取决于网络速度）。

5. 访问页面

浏览器打开http://localhost（或你修改的端口），首次进入需设置管理员账号。

四、配置说明

环境变量（.env）

修改端口

如果 80 端口被占用，修改.env文件：

EXPOSE_NGINX_PORT=8088

修改数据存储路径

默认 Docker 数据存放在系统盘（通常是 C 盘），建议修改到其他容量更大的磁盘：

• Docker Desktop：Settings → Resources → Advanced → 修改数据存储路径
• Linux：修改 Docker daemon 配置/etc/docker/daemon.json

五、国内环境优化

配置镜像加速

在 Docker Desktop 设置中添加国内镜像源：

{"registry-mirrors":["https://docker.mirrors.ustc.edu.cn","https://hub-mirror.c.163.com","https://mirror.baidubce.com"]}

插件安装

安装大模型插件时网络要求较高，建议开启代理等待插件日志显示Running后再关闭。

六、架构概述

Dify 包含以下核心组件：

七、常见问题排查

容器启动失败

查看容器日志：

dockercompose logs<container_name>

端口冲突

确认端口被哪个进程占用：

# Linux/macOSlsof-i:80# Windowsnetstat-ano|findstr":80"

数据库连接失败

检查.env文件中的数据库配置，确保POSTGRES_PASSWORD和REDIS_PASSWORD正确。

插件安装超时

开启网络代理后重试，或手动下载插件镜像。

八、Langfuse 集成

Dify 支持与 Langfuse 集成，实现调用追踪和性能分析：

1. 部署 Langfuse 并获取 API Key
2. 在 Dify 工作流中点击「监测」→ 选择「Langfuse」
3. 配置public_key、secret_key、host
4. 验证连接成功后，所有工作流调用将被追踪到 Langfuse

详情参考 Langfuse 说明文档。

九、参考链接

• Dify 官方文档
• Dify GitHub
• Langfuse 集成指南