本文介绍如何在Windows平台上部署Dify。整个部署过程分为两大步骤:第一步是安装Docker Desktop,第二步是使用Docker部署Dify。下面我们逐步展开。
1. Docker Desktop安装
1.1 下载安装包
首先需要获取Docker Desktop的安装包,可以通过以下两种方式:
方式1:从官网选择版本下载
访问Docker官网:https://www.docker.com/,在官网页面选择适合的版本进行下载。
方式2:从视频资料里获取
也可以直接使用课程视频资料中提供的安装包,这样能确保版本与教程一致。
1.2 确认安装
双击运行下载好的安装程序,在弹出的界面中点击OK即可开始安装。
1.3 等待安装完成
安装过程需要一些时间,请耐心等待进度条走完。
1.4 重启电脑
安装完成后,系统会提示需要重启电脑。可以选择立即重启,也可以关闭窗口稍后自行重启。建议尽快重启以确保Docker组件正确加载。
1.5 接受服务协议
重启电脑后,Docker Desktop会自动弹出服务协议窗口,点击接受即可继续。
1.6 完成安装
接受协议后,Docker Desktop会继续完成剩余的安装配置步骤。
1.7 允许控制
安装过程中,Windows可能会弹出权限控制提示,选择允许即可。
1.8 不登录使用
Docker Desktop启动后可能会提示登录Docker账号,这里可以选择跳过登录,直接以未登录状态使用。
1.9 跳过可选步骤
对于首次安装的小伙伴,Windows系统可能会提示需要安装适用于Linux的Windows子系统(WSL)。这里选择确认安装,稍等片刻后系统会自动完成WSL的安装。
1.10 安装成功验证
安装完成后,我们需要验证Docker是否正常工作。通过Win+R快捷键调出运行窗口,输入cmd打开命令行终端。
在命令行中输入docker并回车,如果能正常显示Docker的版本信息和使用帮助,说明Docker安装成功。
2. 部署Dify
2.1 拉取Dify代码
Dify的代码托管在GitHub上,可以通过以下地址获取:
https://github.com/langgenius/dify
也可以直接使用本地提供的Dify代码压缩包。
2.2 更改配置信息
下面的操作在Dify的GitHub README文档中都有详细说明,可以参考:https://github.com/langgenius/dify/blob/main/README_CN.md
这里直接进行操作:
进入Dify仓库目录下的docker目录,将.env.example文件复制一份并重命名为.env。
然后按需修改.env文件中的配置。例如,可以修改端口号。默认端口号是80,可以修改为8100以避免端口冲突。
2.3 打开终端
以下操作可以在Windows的命令行窗口中进行,也可以在Docker客户端的终端中进行。例如,在终端中进入Dify的docker目录。
2.4 安装部署
在docker目录下执行以下命令部署Dify:
bash
docker compose up -d
这里需要注意,大概率会由于网络问题或镜像缺失问题发生报错。如果遇到报错,可以再次输入命令重新执行。
安装完成后,再次输入docker compose up -d确认所有服务都已正常启动。
2.5 访问Dify
部署完成后,在浏览器中访问localhost即可进入Dify平台。
首次访问需要设置管理员用户名和密码,具体步骤这里略过。设置完成后,使用方式和官方提供的云平台是一样的。

如果启动报错,最好清除损坏的缓存和未完成的层,然后重新拉取:
java
# 停止并移除相关容器/镜像
docker compose down --rmi all -v
# 清理构建缓存和无用镜像
docker system prune -a --force
# 重新拉取
docker compose pull
docker compose up -d
启动后一直install状态:
1,检查容器运行状态(最关键)
不要只看网页,必须确认所有容器是否真正处于 Up 且 Healthy 状态。
docker compose ps -a
2,数据库初始化未完成
Dify 首次启动需要执行数据库迁移(Migration)。如果中途断开或超时,页面会卡在安装中。
-
解决: 重启 API 服务触发迁移:
docker compose restart api worker