Windows 安装 Dify 全流程教程（Docker 部署 + 避坑指南）

Windows 安装 Dify 全流程教程Docker 部署 避坑指南想在本地快速体验大模型应用开发这篇教程带你从 0 到 1 在 Windows 上部署 Dify覆盖 Docker 环境准备、镜像加速、项目启动和常见报错排查。⚡ 快速参考适用系统Windows 10/11部署方式Docker Desktop核心命令docker compose up -d访问地址http://localhost/signin建议耗时20~40 分钟 学习目标通过本文你将掌握Dify 在本地安装的完整流程Windows 下 Docker 的两种虚拟化方案WSL / Hyper-V镜像加速与常见安装失败的处理方式启动 Dify 并完成首次登录初始化一、Dify 简介Dify 是一个开源的大语言模型LLM应用开发平台支持快速构建生成式 AI 应用。它的优势在于不仅开发者能快速上手非技术同学也可以参与应用配置与数据运营。二、Windows 安装 Docker Desktop2.1 下载 Docker Desktop官方下载地址https://docs.docker.com/desktop/setup/install/windows-install/2.2 先确认系统方式WSL 或 Hyper-VWindows 下通常有两种方式WSL推荐默认方式兼容性和体验通常更好Hyper-V可选适用于特定系统配置场景三、方式 A基于 WSL推荐3.1 启用虚拟机相关功能路径控制面板 - 程序 - 启用或关闭 Windows 功能确保虚拟化相关选项已开启。3.2 检查 WSL 版本并更新按Win R打开终端执行wsl--version如果没有显示版本详情说明 WSL 版本可能过旧继续执行wsl--installwsl--update更新后如提示重启请按提示重启系统。3.3 安装 Docker Desktop安装包双击后按默认步骤安装即可。四、方式 B基于 Hyper-V可选4.1 开启 Hyper-V路径同样是控制面板 - 程序 - 启用或关闭 Windows 功能勾选Hyper-V相关选项。4.2 常见报错说明有同学会遇到报错Docker Desktop requires Windows 10 Pro/Enterprise/Home version 19044 or above这类问题一般与系统版本或版本标识相关意思是docker只支持 Windows 10 专业版/企业版/家庭版并且版本要高于19044升级windows系统或者重装系统就可以了。如果你遇到这种问题先确认系统版本是否满足要求再进行后续安装。4.3 安装过程注意项在 Hyper-V 场景下安装界面的选项要按当前环境选择避免与 WSL 选项冲突。安装完成后按提示重启并重新打开 Docker Desktop。五、Docker 初始化配置5.1 首次打开 Docker Desktop可先跳过登录进入主界面即可。5.2 调整资源存储位置可选默认资源一般在 C 盘。如果你空间紧张建议改到其他盘符。5.3 配置镜像加速非常关键如果不配置镜像源拉取镜像可能很慢甚至失败。进入 Docker Engine加入registry-mirrors配置你笔记中的配置可直接使用。{ builder: { gc: { defaultKeepStorage: 20GB, enabled: true } }, experimental: false, features: { buildkit: true }, registry-mirrors: [ https://docker.1panelproxy.com, https://2a6bf1988cb6428c877f723ec7530dbc.mirror.swr.myhuaweicloud.com, https://docker.m.daocloud.io, https://hub-mirror.c.163.com, https://mirror.baidubce.com, https://your_preferred_mirror, https://dockerhub.icu, https://docker.registry.cyou, https://docker-cf.registry.cyou, https://dockercf.jsdelivr.fyi, https://docker.jsdelivr.fyi, https://dockertest.jsdelivr.fyi, https://mirror.aliyuncs.com, https://dockerproxy.com, https://mirror.baidubce.com, https://docker.m.daocloud.io, https://docker.nju.edu.cn, https://docker.mirrors.sjtug.sjtu.edu.cn, https://docker.mirrors.ustc.edu.cn, https://mirror.iscas.ac.cn, https://docker.rainbond.cc ] }5.4 验证 Docker 是否正常docker--versiondockerpull hello-world如果hello-world拉取成功说明 Docker 基本可用。六、拉取并配置 Dify6.1 克隆仓库gitclone https://github.com/langgenius/dify.git如果 GitHub 拉取失败也可以打开仓库页面点击Code - Download ZIP6.2 配置环境文件进入目录并复制环境文件cddify/dockercp.env.example .env如果你在 Windows 下不方便执行cp也可以手动把.env.example重命名为.env。七、启动 Dify在dify/docker目录执行dockercompose up-d等待容器启动完成后浏览器访问http://localhost/signin首次进入按页面提示设置邮箱、用户名、密码即可登录。八、常见问题排查8.1 Docker 打不开 / 启动失败优先检查BIOS 是否开启虚拟化Windows 功能中 WSL 或 Hyper-V 是否正确启用Docker Desktop 是否已重启8.2 拉取镜像超时检查镜像加速配置是否生效更换可用镜像源后重试8.3docker compose up -d报错是否在dify/docker目录执行.env文件是否存在端口是否被占用可重启 Docker 后重试九、总结到这里你已经完成了 Dify 在 Windows 的本地部署。下一步建议你创建第一个应用配置模型供应商尝试上传知识库做一个简单问答机器人如果你愿意我下一篇可以继续写《Dify 入门实战5 分钟搭建你的第一个 AI 助手》。附命令清单便于复制wsl--versionwsl--installwsl--updatedocker--versiondockerpull hello-worldgitclone https://github.com/langgenius/dify.gitcddify/dockercp.env.example .envdockercompose up-d