1. Dify概述
1.1. Dify简介
Dify是一款开源的大模型应用开发平台（LLMOps），旨在让开发者、产品经理甚至非技术人员都能通过零代码或低代码的方式，快速搭建和部署基于大语言模型（LLM）的企业级AI应用。
它就像一个AI应用的“操作系统”，集成了从模型接入、知识库构建、应用编排到运营监控的全流程能力。无论你是想创建一个智能客服、一个内部知识库问答机器人，还是一个复杂的AI工作流，Dify都能通过其可视化的界面轻松实现。
1.2. 核心特点
- 可视化编排：通过拖拽组件的方式构建应用，无需编写复杂代码。
- 内置知识库：支持上传多种格式的文档（PDF、Word、TXT等），自动进行切片和向量化，实现检索增强生成（RAG）。
- 模型兼容性强：原生支持接入OpenAI、通义千问、DeepSeek、Gemini等主流大模型，也支持通过Ollama等方式接入本地模型。
- 私有化部署：支持在本地服务器或私有云进行部署，确保数据安全可控。
- 开源免费：遵循MIT协议，可以免费用于商业项目或进行二次开发。
1.3. 相关地址
官方网站：dify.ai
GitHub仓库：github.com/langgenius/…
官方文档：docs.dify.ai
2. Windows系统安装Dify
在Windows上安装Dify，最推荐的方式是使用Docker Desktop，它为我们提供了一个简单、隔离的运行环境。
2.1. 环境准备
- 安装Docker Desktop：前往Docker官网下载并安装适用于Windows的Docker Desktop。安装完成后，启动程序并确保其后台服务正在运行。
- 安装Git（可选）：为了方便下载源码，建议安装Git for Windows。
2.2. 安装步骤
2.2.1. 下载Dify源码
你可以直接通过Git命令下载，或者在GitHub仓库页面手动下载ZIP压缩包并解压。
git clone https://github.com/langgenius/dify.git
2.2.2. 配置环境变量
进入下载好的dify目录，找到其中的docker子目录。在该目录下，复制.env.example文件，并将副本重命名为.env。这个文件包含了Dify运行所需的各种配置，初次使用通常无需修改。
2.2.3. 启动Dify
在docker目录下，打开命令行窗口（可以在文件夹地址栏输入cmd并回车），执行以下命令来启动所有Dify服务。
docker compose up -d
该命令会在后台拉取并启动Dify所需的全部容器。首次运行需要一些时间，请耐心等待。
可以看到Docker Desktop中启动了许多容器。
2.2.4. 访问Dify
当命令行显示所有容器都已成功启动后，打开浏览器，访问：http://localhost 。你将看到Dify的初始化页面，按照提示设置管理员账号和密码，即可开始使用。
2.2.5. 常见问题
- 端口被占用：如果启动时提示端口（如80、5003）被占用，可以尝试修改
.env文件中的端口配置，或关闭占用该端口的其他程序，或者可以尝试重启一下电脑。 - Docker镜像拉取失败：这通常是由于网络问题。可以为Docker配置国内镜像加速器，例如阿里云、网易云等提供的镜像源。
3. Linux系统安装Dify
Linux环境下的安装流程与Windows类似，同样依赖于Docker。
3.1. 环境准备
确保你的Linux服务器或虚拟机上已经安装了Docker和Docker Compose。
3.2. 安装步骤
3.2.1. 下载源码
通过git下载Dify源码。
git clone https://github.com/langgenius/dify.git
3.2.2. 配置环境变量
进入到Dify的dify/docker/目录下。
cd dify/docker
修改文件名。
cp .env.example .env
3.2.3. 启动Dify
docker compose up -d
3.2.4. 访问Dify
打开浏览器，访问http://localhost 即可。
4. Dify接入阿里百炼平台大模型
Dify本身不生产模型，而是作为一个平台来接入和管理各种大模型。接入阿里云百炼的通义千问模型是一个非常实用的选择。
4.1. 前提条件
首先，你需要拥有一个阿里百炼平台的账号，并且创建一个API Key。
阿里百炼官网地址：www.aliyun.com/product/bai…
4.2. 接入步骤
4.2.1. 安装插件
使用浏览器登录Dify，点击右上角头像进入【设置】，选择【模型供应商】。
通过上面搜索，输入“通义千问”进行搜索，在下面市场中，找到“通义千问”插件，并安装。
4.2.2. 配置APIKey
在【模型供应商】页面找到“通义千问”卡片，点击【添加API密钥】。
在弹框中，填入阿里百炼的API Key。
注意：如果是国内使用的话，“使用国际端点”选择【否】即可。
到此，配置就结束，接下来就可以创建第一个聊天助手应用了。
5. 创建第一个聊天助手
5.1. 创建应用
进入到Dify首页，点击【创建空白应用】。
在弹框中，选择“聊天助手”，并为应用起个名称和描述，点击【创建】按钮即可创建出一个应用。
5.2. 选择模型
应用创建完成后，直接进入到编排调试页面，选择我们要使用的模型。
在下拉菜单中，选择我们需要的模型，这里我们使用“qwen3-max”模型。
5.3. 调试与预览
设置完成后，就可以直接在右侧【调试与预览】中，对大模型进行提问，他会给出输出。
注意：界面左侧还有很多功能，这里不过多讲解，后续慢慢就会使用到。
5.4. 发布应用
在调试满意后，点击右上角的【发布】按钮就可以发布该应用。Dify会生成一个独立的Web访问链接和一个API接口，你可以将链接分享给他人，或者将API集成到自己的系统中。
6. 总结
到此，我们就已经成功完成了Dify的入门，并拥有了一个自己的第一个AI聊天助手。接下来，还可以探索更高级的功能，比如为助手添加知识库，或者使用工作流来构建更复杂的AI应用。
