Dify本地部署教程：宝塔面板一键搭建AI应用平台

Dify是什么：开源的LLM应用开发平台

Dify是一款开源的大语言模型（LLM）应用开发平台，它融合了后端即服务（BaaS）与LLMOps的理念，让开发者能够更快速地搭建生产级的AI应用。更重要的是，Dify不仅面向技术人员，即便是非技术背景的用户，也能参与到AI应用的定义和数据运营中。

作为一个开发平台，Dify内置了构建LLM应用所需的关键技术栈，支持数百个主流模型的调用——国内的文心一言、豆包、智谱、百川、讯飞星火、通义千问，国外的OpenAI、Gemini、Claude等悉数在列。它提供直观的提示词编排界面，以及高质量的RAG（检索增强生成）引擎，用于挂载外部知识库。

Dify与LangChain的区别：脚手架与工具箱之别

很多开发者会将Dify与LangChain做对比。如果把LangChain比作一个装满锤子、钉子的"工具箱"（library），那么Dify更像是一整套"脚手架"——它不仅提供了工具，还包含完整的工程设计与软件测试。这意味着开发者无需从零"造轮子"，可以将更多精力投入到创新和业务逻辑本身。

从模型能力看Agent构建

在Dify的模型支持列表中，有两个值得关注的标识："锤子"图标表示该模型支持工具调用（Tool Use），"眼镜"图标表示支持视觉能力。如果你想构建一个能调用工具的Agent，就必须选择带"锤子"标识的模型。OpenAI同时支持工具调用和视觉；国内模型中，月之暗面（Kimi）、DeepSeek等也支持工具调用，适合用于Agent开发。

环境准备：虚拟机与Ubuntu系统配置

本教程选择了对新手最友好的Dify部署方式——通过宝塔面板进行本地部署。在开始之前，需要准备两样东西：

1. 虚拟机软件：VMware Workstation 17 或 VMware Player（用于运行Linux系统）
2. Linux系统镜像：Ubuntu 22.04

安装VMware时有一个关键提醒：不要将软件装到C盘，因为运行时会产生大量缓存文件，容易撑爆系统盘。建议安装到其他分区。

创建并安装Ubuntu虚拟机

在VMware中创建新虚拟机时，选择"稍后安装操作系统"，系统类型选Linux，版本选Ubuntu 64位。磁盘大小方面，如果虚拟机仅用于运行Dify，分配20G即可，并建议拆分为多个文件。

创建完成后，虚拟机是无法直接启动的——因为它此时是一个"空系统"。需要在"编辑虚拟机设置"中找到CD/DVD选项，选择"使用ISO镜像文件"，加载Ubuntu 22.04的镜像（这一步相当于把安装光盘"放进"电脑），然后才能播放启动。

Ubuntu安装过程要点

启动后进入图形安装界面，语言选择"中文简体"。在安装类型上，如果只使用宝塔部署Dify，选择"最小安装"即可；如果还需要做其他Linux开发，可选"正常安装"。磁盘处理直接选"清除整个磁盘"（注意：这里清除的是分配给虚拟机的空间，不影响宿主机）。设置好用户名和密码后（可勾选自动登录避免每次输入），等待安装完成并重启即可。

部署宝塔面板：可视化运维的核心工具

宝塔面板是整个Dify部署流程的核心工具，它将复杂的Linux运维操作转化为可视化的"点点点"操作。

获取并执行宝塔安装命令

在宝塔官网选择"Linux面板" → "免费版"，根据系统版本（Ubuntu）复制对应的安装命令。回到虚拟机，用 Ctrl+Alt+T 打开终端，右键粘贴命令并回车。系统会要求输入密码——注意，Linux终端输入密码时不会显示任何字符，只要确认输入正确后回车即可。

宝塔面板登录与安全配置

安装完成后，面板会输出登录信息，包括外网地址、内网地址、用户名和密码。本地部署建议使用内网地址访问（外网IP是动态的，不适合本地环境）。将地址复制到浏览器即可进入宝塔面板。

首次登录需阅读协议并绑定账号。进入后，可以通过面板自带的 bt 命令行工具（宝塔缩写）进行安全优化：

• 修改默认密码和用户名（避免使用过于简单的密码）
• 修改面板端口（如改为更好记的8899）
• 修改安全入口（默认的随机字符串难以记忆，可自定义）

在宝塔中一键部署Dify的完整步骤

这是整个流程最便捷的部分。宝塔提供了Docker模块，可以实现Dify的"一键部署"。

安装Docker模块

在宝塔面板找到Docker选项，点击安装，安装方式选默认即可。Docker安装需要一定时间，耐心等待即可。安装完成后刷新面板，即可看到Docker管理界面。

通过Docker安装Dify

在Docker模块中搜索"Dify"，点击安装、确定即可。应用名称可自定义，也可保留默认。

Dify安装常见问题排查

实际部署中，很多用户会遇到安装失败的情况，以下是完整的排错思路：

问题一：BTfile错误 —— 卸载后重新搜索安装，并将版本改为 1.00（指定稳定版本）。

问题二：网络抓取失败 —— 如果改版本后仍报错，说明是网络问题。需要修改虚拟机的DNS配置：

sudo nano /etc/resolv.conf

将 nameserver 修改为：

nameserver 8.8.8.8
nameserver 8.8.4.4

保存后（Ctrl+O 确认，Ctrl+X 退出），执行命令重启面板并清理host缓存，再回到宝塔重新安装。

问题三：Docker镜像无法拉取 —— 在Docker设置中修改加速URL（镜像加速链接）。宝塔的帮助文档中提供了多个加速链接，可以逐个尝试，填写后重启Docker，再卸载重装Dify。

访问并初始化Dify

安装成功后，Dify会进入"运行中"状态。复制其地址，将 https 改为 http，端口改为 8088，后面加上 /install 进入初始化界面。例如：http://192.168.x.x:8088/install。

在此界面设置管理员邮箱、用户名和密码，本地部署即宣告完成。此后就可以关闭虚拟机的图形界面，仅通过宝塔面板进行管理和操作。

总结

通过宝塔面板 + Docker 的组合，Dify的本地部署被大大简化，即使是没有Linux经验的新手也能跟着操作完成。整个流程可概括为：准备虚拟机与系统 → 部署宝塔面板 → 安装Docker → 一键部署Dify。真正的难点往往不在于安装本身，而在于网络与镜像拉取的排错——掌握了DNS修改和镜像加速这两个技巧，绝大部分问题都能迎刃而解。

完成部署后，你就拥有了一个完整的AI应用开发平台，接下来便可以在此基础上构建智能聊天机器人、Agent智能体、工作流以及挂载专属知识库。