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克隆完成后，进入项目目录：
cddify1.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 restartdocker1.4 访问与初始化
等待所有容器启动完成后（可通过docker compose ps查看状态），在浏览器中访问：
http://<你的服务器IP地址>:3000首次访问将进入安装向导页面，按照提示完成管理员账号注册和基础配置即可。
添加模型
2.1 进入模型管理
登录 Dify 控制台后，点击左侧导航栏的「模型管理」，进入模型配置页面。
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