Dify 部署与配置全攻略：从安装到智能客服搭建-三亩地-编程学习日记

1.1 环境准备

在开始安装 Dify 之前，请确保您的服务器满足以下最低要求：

操作系统：Ubuntu 20.04/22.04 LTS、CentOS 7/8 或兼容的 Linux 发行版
Docker：版本 20.10.0 或更高
Docker Compose：版本 2.0.0 或更高
硬件：至少 2 核 CPU、4 GB 内存、20 GB 可用磁盘空间
网络：可访问 GitHub 和 Docker Hub

1.2 下载源码

使用 Git 克隆 Dify 官方仓库到本地：

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

克隆完成后，进入项目目录：

cddify

1.3 使用 Docker 启动

Dify 官方推荐使用 Docker Compose 进行一键部署，这是最简单快捷的方式。

进入 Docker 配置目录：
```
cddocker
```
复制环境变量配置文件：
```
cp.env.example .env
```
您可以根据需要编辑.env文件，修改数据库密码、API 密钥等配置。
启动所有服务：
```
dockercompose up-d
```
此命令将在后台启动 Dify 所需的所有容器（包括后端 API、前端界面、数据库等）。

镜像加速配置（可选）

如果 Docker 镜像下载缓慢或失败，可以配置国内镜像加速器。

对于 Docker Desktop（Windows/macOS）：
在设置中直接添加镜像地址。

对于 Linux 系统：
编辑或创建/etc/docker/daemon.json文件：

{"registry-mirrors":["https://docker.1ms.run","https://docker.1panel.live","https://docker.nju.edu.cn"]}

保存后重启 Docker 服务：

sudosystemctl restartdocker

1.4 访问与初始化

等待所有容器启动完成后（可通过docker compose ps查看状态），在浏览器中访问：

http://<你的服务器IP地址>:3000

首次访问将进入安装向导页面，按照提示完成管理员账号注册和基础配置即可。

添加模型

2.1 进入模型管理

2.2 支持的主流模型

Dify 支持多种大语言模型提供商，包括：

OpenAI：GPT-3.5/4/4o 系列
Anthropic：Claude 系列
国内模型：通义千问、DeepSeek、智谱 GLM、月之暗面 Kimi 等
开源模型：Llama、Qwen、ChatGLM 等（通过 OpenAI 兼容接口）

2.3 配置 API 密钥

以添加 OpenAI 模型为例：

点击「添加模型提供商」，选择「OpenAI」
在配置页面填写：
- 模型名称：自定义名称（如 “GPT-4”）
- API 密钥：您的 OpenAI API Key
- API 地址：默认使用官方地址，也可配置代理地址
- 模型列表：选择可用的模型（如 gpt-4、gpt-3.5-turbo）
点击「测试连接」验证配置是否正确
保存后，该模型即可在应用构建中使用

2.4 模型配额与计费

在「模型管理」中可以查看各模型的使用情况，设置用量限制和预算告警，避免意外费用。

知识库

3.1 创建知识库

知识库是 Dify 的核心功能之一，允许您上传文档并基于其内容进行智能问答。

点击左侧「知识库」菜单，选择「创建知识库」
填写知识库名称和描述
选择索引方式：
- 高精度：检索准确率高，适合对准确性要求高的场景
- 高召回：检索范围更广，适合需要覆盖更多相关内容的场景

3.2 上传文档

支持多种格式的文档上传：

文本文件：TXT、Markdown
办公文档：PDF、Word、Excel、PowerPoint
网页：直接输入 URL 抓取内容
代码仓库：连接 GitHub 仓库索引代码文档

上传后，Dify 会自动进行文本提取、分块和向量化处理，构建可检索的知识索引。

3.3 文档处理配置

在上传时可以调整以下参数：

分块大小：控制每个文本块的长度（默认 500 字符）
分块重叠：相邻块之间的重叠字符数，保证上下文连贯
预处理规则：是否移除页眉页脚、代码注释等

3.4 知识库测试与应用

构建完成后，您可以在知识库页面直接测试检索效果，查看系统返回的相关文档片段。创建应用时，选择「知识库检索」能力，即可将知识库接入对话流程。

智能客服聊天

4.1 创建聊天型应用

点击「创建应用」，选择「对话型应用」
填写应用名称和描述
选择对话模型（在「添加模型」中配置的模型）

4.2 配置提示词与上下文

在应用编排页面，您可以：

系统提示词：定义 AI 助手的角色、能力和行为规范

你是一个专业的客服助手，负责回答用户关于产品使用、技术问题和服务咨询。 请保持友好、专业的语气，准确回答用户问题。 如果遇到不确定的问题，可以引导用户联系人工客服。

上下文设置：

上下文长度：控制对话历史保留的轮数
知识库关联：选择已创建的知识库，让 AI 基于文档内容回答
联网搜索：开启后 AI 可以实时搜索最新信息

4.3 添加工具与插件

Dify 支持丰富的工具扩展：

内部系统连接：通过 API 连接 CRM、工单系统等
外部服务：天气查询、股票信息、翻译服务等
自定义函数：编写 Python 代码实现特定业务逻辑

4.4 测试与发布

在右侧预览窗口测试对话效果
调整提示词和参数直到满意
点击「发布」将应用部署到生产环境

4.5 集成到网站/应用

Dify 提供多种集成方式：

嵌入代码：获取 JavaScript 代码片段，嵌入到网站中
API 接口：通过 REST API 或 WebSocket 接入自有系统
聊天插件：支持 WordPress、Discord、Slack 等平台

坑

邀请用户注册需要配置邮箱
修改配置文件,添加邮箱配置
vim .env

MAIL_DEFAULT_SEND_FROM= # QQ企业邮箱 SMTP_SERVER=smtp.exmail.qq.com SMTP_PORT=465 # 用户名必须完整邮箱 SMTP_USERNAME= # ⚠️重点！这里不要填网页登录密码，填【客户端专用密码】 SMTP_PASSWORD= SMTP_USE_TLS=true SMTP_OPPORTUNISTIC_TLS=false

邮箱中注册链接缺少http://x.x.x.x/地址，修复：
vim .env 修改配置文件，修改CONSOLE_WEB_URL变量

CONSOLE_WEB_URL=http://x.x.x.x

修改ngin映射端口时也要同步修改配置文件中变量

APP_API_URL=http://x.x.x.x APP_WEB_URL=http://x.x.x.x

日记详情

Dify 部署与配置全攻略：从安装到智能客服搭建