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是否正常工作。通过WinR快捷键调出运行窗口输入cmd打开命令行终端。在命令行中输入docker并回车如果能正常显示Docker的版本信息和使用帮助说明Docker安装成功。2. 部署Dify2.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目录下执行以下命令部署Difydocker compose up -d这里需要注意大概率会由于网络问题或镜像缺失问题发生报错。如果遇到报错可以再次输入命令重新执行。安装完成后再次输入docker compose up -d确认所有服务都已正常启动。2.5 访问Dify部署完成后在浏览器中访问localhost即可进入Dify平台。首次访问需要设置管理员用户名和密码具体步骤这里略过。设置完成后使用方式和官方提供的云平台是一样的。如果启动报错最好清除损坏的缓存和未完成的层然后重新拉取# 停止并移除相关容器/镜像 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 -a2数据库初始化未完成Dify 首次启动需要执行数据库迁移Migration。如果中途断开或超时页面会卡在安装中。解决重启 API 服务触发迁移docker compose restart api worker