Dify本地私有化部署(保姆级教程)

0 阅读5分钟

大家好,我是小民,见字欢喜。

前面几篇我们聊了智能体框架的全景图,主流框架基本过了一遍。但其中有一个平台,我觉得值得单独拎出来好好写写——Dify。

为什么?就一条:它开源、能私有化部署,数据从头到尾都在自己手里。

如果你对数据安全比较在意,或者想自己折腾一套智能体平台,那这篇文章就是为你准备的。

话不多说,今天咱们真刀真枪地干一场——从零开始,在自己电脑上搭一个Dify。

文章有点长,但干货管够👇

01 Dify到底是啥

简单说,Dify是一个开源的LLM应用开发平台;通俗点讲,就是你可以私有化部署的“扣子”。

它自带可视化工作流编辑器,主流大模型基本都能接(OpenAI、DeepSeek、Llama、通义千问等),RAG、Agent、工作流三大核心能力也都有。

Dify的亮点

  • 开源免费: 代码在GitHub上,想改就改
  • 数据私有: 部署在自己服务器上,数据不外传
  • 功能完整: 对标扣子,该有的都有
  • 社区活跃: 插件多、文档全、踩坑了有人帮

一句话总结➔如果你想要扣子的体验,但又不想把数据交给别人,Dify就是答案。

02 部署方式怎么选

Dify支持好几种部署方式👇

第1种:Docker Compose(官方推荐)

适合正式部署。

优点是组件完整、功能全面,缺点是需要Linux环境。

第2种:VMware虚拟机

适合本地学习或测试。

好处是环境隔离、能随时快照、不影响宿主机,缺点是资源占用高一些。

第3种:云服务器

适合要公网访问的场景。

优点是直接对外服务、访问方便,缺点是一直要花钱。


本文咱们选的是VMware + Linux + Docker Compose这条路,好处是在Windows上开个虚拟机,随便折腾,坏了快照一恢复,主机一点事没有。

再说下配置要求:

  • CPU:最低2核,推荐4核
  • 内存:最低8GB,推荐16GB
  • 磁盘:最低20GB,推荐50GB

真要上生产环境的话,建议4核16GB起步。

03 VMware环境搭建

先去VMware官网下载Workstation Pro(收费)或者Workstation Player(免费),按提示装就行,没啥难度。

如果需要详细的安装教程,留言区喊一声,我专门出一篇

我电脑上之前就装过VMware,也有现成的虚拟机,所以就直接克隆了一份Rocky 9.4的系统专门用来部署Dify。

几个关键配置👇

先选网络模式➔桥接模式或者NAT模式都行。

  • 桥接模式:虚拟机和主机同网段,局域网内可以直接访问
  • NAT模式:虚拟机通过主机上网,适合本地自己测试

再配个静态IP

为啥要配静态IP?

因为不想每次重启服务器IP变来变去,后面访问起来太折腾,这里我装的Rocky带可视化界面,配IP比较简单👇

顺手关个防火墙

测试环境建议关掉,省得后面莫名其妙连不上

systemctl stop firewalld.service
systemctl disable firewalld.service

安装Docker环境

镜像加速一定要配,不然下载慢到怀疑人生

创建并打开daemon.json

vim /etc/docker/daemon.json

贴上下面这段

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.mirrors.tuna.tsinghua.edu.cn",
    "https://mirror.ccs.tencentyun.com",
    "https://hub-mirror.c.163.com"
  ],
  "max-concurrent-downloads": 10
}

重启让配置生效

systemctl daemon-reload
systemctl restart docker.service

这里我顺手写了个docker和docker-compose快速安装的脚本(贴出来内容有点多),有需要的小伙伴留言区喊一声👇

装完长这样

好了,环境准备就绪,下面开始进入正题👇

04 部署Dify

4.1 下载Dify源码

① 克隆官方仓库

git clone https://github.com/langgenius/dify.git

然后——翻车了👇

救法一:换Gitee

直接用Gitee上的Dify镜像,快得多

git clone https://gitee.com/dify_ai/dify.git

优点➔不用改任何配置,下载飞起,适合国内网络。

注意➔Gitee上的仓库可能比GitHub官方稍微慢半拍,但代码是同步的,日常用完全没问题。

救法二:配置代理

在Xshell中配置代理(懂的都懂~)

这里咱们用Gitee的镜像继续👇

① 克隆仓库

git clone https://gitee.com/dify_ai/dify.git

② 进到docker目录

cd dify/docker

③ 复制环境变量模板

cp .env.example .env

4.2 配置环境变量(关键!)

编辑.env文件;这几个地方配不对,前端调不通API,访问就报404➔重点盯住👇

# 设置访问地址
APP_API_URL=http://你虚拟机的IP
CONSOLE_API_URL=http://你虚拟机的IP

# 生成强密钥(用下面openssl命令生成)
SECRET_KEY=your_generated_secret_key

# 数据库密码
POSTGRES_PASSWORD=你的强密码
REDIS_PASSWORD=你的强密码

生成密钥的命令:openssl rand -base64 42

4.3 一键启动

注意➔要在 /root/dify/docker 目录下执行

docker-compose up -d

第一次启动会自动拉镜像,大概5-10分钟,看你网速。

看到上图那样,就说明成了 🎉🎉🎉

05 初始化Dify

5.1 访问页面

浏览器打开 http://你的虚拟机IP,就能看到安装引导页

第一次进去会让你创建管理员账号,填邮箱和密码就行

5.2 配置大模型

进到「设置」→「模型供应商」,添加你的API Key

没有API Key的小伙伴,推荐用DeepSeek或通义千问,注册会送一些免费额度,这里咱们接DeepSeek👇

插件装好之后,来配API Key

配完长这样👇

搞定~🎉

下篇咱们在Dify上搞搞智能体~

部署过程中遇到啥问题,留言区见哈,看到就回~