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
相关推荐
蜗牛互联网1 小时前
Python Agent 工具调用:审批令牌、参数白名单和累计预算
java·开发语言·人工智能·windows·后端·python
夏虫不可与之言冰3 小时前
使用Flash Download Tool给ESP32烧录固件
c语言·c++·windows·单片机·物联网·iot
colinu3 小时前
Docker 容器自启动策略说明与常用命令
运维·docker·容器
灯澜忆梦3 小时前
【docker】#3 | 数据卷挂载
运维·docker·容器
像风一样自由202011 小时前
52.Docker部署大模型应用从本地开发到服务化运行
运维·人工智能·docker·容器·大模型·智能体
陈陈CHENCHEN15 小时前
【Kubernetes】纯 IPv6 K8s 用 socat 打通 IPv4 服务
云原生·容器·kubernetes
江湖有缘16 小时前
Docker实战 | 使用Docker部署rmoments社交平台
jvm·docker·oracle
jack1868916 小时前
Devin 智能软件工程师实战应用指南
windows
Hello_Pyhx18 小时前
WinDirStat 2.9.3:从目录扫描到可复查的占用报表
windows·mac·垃圾清理