Dify的Windows平台部署:从Docker安装到Dify运行

本文介绍如何在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
相关推荐
共享家952718 分钟前
408 操作系统第一章
服务器·数据库·windows
PellyKoo1 小时前
【docker】cifs卷改smb密码后容器起不来的解决方法
运维·docker·容器
时早玖沐1 小时前
放弃 QQ 官方机器人:用 SnowLuma + AstrBot 自建 QQ 机器人
docker·开源·agent
Sakura_j_h_2 小时前
GitHub Actions 打包 Windows exe:中文编码与产物上传
windows·ci/cd·打包发布·github·pyinstaller·github actions
阿标在干嘛2 小时前
容器编排的“场景适配”:我们为什么在部分服务中回归了Docker Compose?
运维·docker·容器
xixiaoyunya5 小时前
搭一个浏览器即用的二进制文件分发点:目录规范与权限边界实践
网络·windows
麻瓜code6 小时前
Spring AI 全模块 API 字典一览(1.1.0 版)
人工智能·windows·spring
IT19956 小时前
Docker 快速部署 DM8 达梦数据库|完整踩坑笔记
笔记·docker·容器
wzg20166 小时前
ubuntu通过docker镜像部署安装onlyoffice
linux·ubuntu·docker
Star(up up up)6 小时前
Docker系列---Docker容器基本命令(新手小白保姆级实操教程)
运维·学习·程序人生·青少年编程·docker·容器·dubbo