实践01：使用Docker本地部署Dify智能体开发工具

原创已于 2025-06-10 16:35:43 修改 · 1.2k 阅读

30 ·

CC 4.0 BY-SA版权

文章标签：

#Dify #智能体开发 #入门级 #零基础

于 2025-06-09 15:36:38 首次发布

Dify智能体应用开发专栏收录该内容

8 篇文章

订阅专栏

估计用时：1 小时

实践目标：

通过本案例快速掌握使用Docker方式快速完成智能体应用开发工具在本地设备的安装和部署。

主机设备前提条件：

安装 Dify 之前, 请确保本地设备已满足最低安装要求。

CPU ≥ 2 Core
RAM ≥ 4GB

实践环境：

操作系统	macOS Monterey 12.7.6
设备型号	MacBook Pro（12-inch，2017， Four Thunderbolt 3 Ports）
处理器	3.3 GHz 双核 Interl Core i7
内存	16GB 2133MHz LPDDR3
图形显卡	Interl Iris Grarphics 550 1536 MB

实验步骤：

步骤1：下载安装Docker

1.1 打开Docker桌面版下载网址：https://docs.docker.com/desktop/setup/install/mac-install/

说明：请根据Apple主机芯片类型，点击选择对应的安装程序下载链接地址

1.2 点击下载Docker Desktop应用程序并安装

说明：Windows系统用户，选择左侧菜单对应的系统连接点击下载安装即可。

步骤2：克隆Dify代码仓库

打开系统【终端应用】，使用 git指令 克隆 Dify 源代码（推荐选择1.4.1版本）至本地环境。

# Dify当前最新版本为 1.4.1
git clone https://github.com/langgenius/dify.git --branch 1.4.1

步骤3：配置部署Dify环境变量

进入Dify源代码的Docker目录，复制环境配置文件。

# 进入Dify源代码的Docker目录
cd dify/docker
# 复制环境变量
cp .env.example .env

步骤4：启动Docker容器

使用Docker指令，根据 步骤3 配置信息，启动Dify在Docker中的自动化部署。

说明：Docker会自动化部署全新容器并下载所需资源配置Dify的运行环境，需要等待。

# 启动Docker部署Dify
docker compose up -d

常见问题：Docker获取Dify环境资源网络拉取出现超时报错！

解决方案：Docker拉取网络资源超时报错处理

运行命令后，你应该会看到类似以下的输出，显示所有容器的状态和端口映射：

步骤5：Docker容器Dify部署验证

输入Docker指令验证。

# 验证Docker部署Dify正确性
docker compose ps

在这个输出中，你应该可以看到包括 3 个业务服务api / woker / web，以及 6 个基础组件weaviate / db / redis / ngnix / ssrf_proxy / sandbox 。

通过这些步骤，我们已经在本地成功安装 Dify。

步骤6：启动Dify并设置账户

6.1 初始化页面设置【管理员账户】，打开本地浏览器，访问网址 http://localhost/install

6.2 Dify 用户主页面访问，输入网址 http://localhost

步骤7：输入用户账号进入Dify主界面

输入之前注册的正确账号和密码后，成功进入Dify主界面。

实验操作完毕！

总结

通过本实验，我们掌握了使用 Docker 快速部署 Dify 智能体开发工具。从 Docker的下载安装，克隆Dify的代码仓库，Dify环境变量的配置以及启动容器并验证部署正确性等进行了详细的讲解和操作说明。Windows的小伙伴操作基本一致。最后，我们通过对Dify设置账户进入主界面，完成本地开发环境搭建。