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 Hub1.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 DesktopWindows/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 支持多种大语言模型提供商包括OpenAIGPT-3.5/4/4o 系列AnthropicClaude 系列国内模型通义千问、DeepSeek、智谱 GLM、月之暗面 Kimi 等开源模型Llama、Qwen、ChatGLM 等通过 OpenAI 兼容接口2.3 配置 API 密钥以添加 OpenAI 模型为例点击「添加模型提供商」选择「OpenAI」在配置页面填写模型名称自定义名称如 “GPT-4”API 密钥您的 OpenAI API KeyAPI 地址默认使用官方地址也可配置代理地址模型列表选择可用的模型如 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 .envMAIL_DEFAULT_SEND_FROM # QQ企业邮箱 SMTP_SERVERsmtp.exmail.qq.com SMTP_PORT465 # 用户名必须完整邮箱 SMTP_USERNAME # ⚠️重点这里不要填网页登录密码填【客户端专用密码】 SMTP_PASSWORD SMTP_USE_TLStrue SMTP_OPPORTUNISTIC_TLSfalse邮箱中注册链接缺少http://x.x.x.x/地址修复vim .env 修改配置文件修改CONSOLE_WEB_URL变量CONSOLE_WEB_URLhttp://x.x.x.x修改ngin映射端口时也要同步修改配置文件中变量APP_API_URLhttp://x.x.x.x APP_WEB_URLhttp://x.x.x.x