Windows 10 下安装 Dify 详细步骤（Docker Desktop + WSL2）
- 前言
- 环境准备
- 详细操作步骤
-
- 第一步：检查并开启 CPU 虚拟化
- 第二步：安装并配置 WSL2
- 第三步：安装 Docker Desktop
- 第四步：解压Dify源码包
- 第五步：放置 Docker 配置文件
- 第六步：移动 Dify 启动/停止脚本
- 第七步：启动 Docker Desktop
- 第八步：启动 Dify
- 第九步：访问 Dify
-
- 可选：停止 Dify
- 常见问题
- 总结
前言
本文记录了在 Windows 10 64位系统上部署开源 LLM 应用开发平台 Dify 的完整过程。所有安装文件均已打包在 dify安装.zip 中，按照以下步骤操作即可顺利完成部署。
环境准备
- 操作系统：Windows 10 64位（专业版/企业版/教育版，家庭版需额外开启 Hyper-V 或 WSL2 功能）
- 硬件要求：CPU 支持虚拟化技术（Intel VT-x / AMD SVM），并在 BIOS 中已开启。
- 压缩包内容：
详细操作步骤
第一步：检查并开启 CPU 虚拟化
- 若显示“已启用”，则继续下一步。
- 若显示“已禁用”，需重启电脑进入 BIOS/UEFI 设置，找到并开启 Intel VT-x 或AMD SVM 功能（不同主板位置不同，通常位于 Advanced / CPU Configuration 中）。
第二步：安装并配置 WSL2
Docker Desktop 在 Windows 上默认使用 WSL2 后端，因此必须先正确安装 WSL2。
powershell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
powershell
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
重启电脑（必须，使功能生效）。
安装 WSL2 Linux 内核更新包：
-
解压 dify安装.zip，找到 wsl_update_x64msi，双击运行安装。
-
或者从微软官网下载最新版，但压缩包内已提供，直接使用即可。
将 WSL 默认版本设置为 WSL2：
powershell
wsl –set-default-version 2
如果提示“WSL 2 需要更新其内核组件”，请确保上一步已安装内核更新包。
第三步：安装 Docker Desktop
解压 dify安装.zip，找到 Docker Desktop Installer .exe，右键选择“以管理员身份运行”。
安装过程中，保持默认选项（不要勾选“Use WSL 2 instead of Hyper-V”之类，因为新版默认已集成 WSL2 支持）。如果安装程序询问，确保选择“使用 WSL 2”。
安装完成后，不要立即启动 Docker Desktop（根据说明，需要先放置配置文件）。
第四步：解压Dify源码包
将 dify-main.zip 解压到某个工作目录，例如 F:\\dify（注意路径不要包含中文或空格）。
解压后，你会得到一个名为 dify-main 的文件夹，解压后路径为 F:\\dify\\dify-main。
第五步：放置 Docker 配置文件
%USERPROFILE%.docker
并回车，进入当前用户的 Docker 配置目录（如果 .docker 文件夹不存在，可手动创建）。
第六步：移动 Dify 启动/停止脚本
进入 Dify 源码目录下的 docker 子文件夹，例如 F:\\dify\\dify-main\\docker。
将压缩包中的 dify-start.bat 和 dify-stop.bat 复制到该目录中。
第七步：启动 Docker Desktop
双击桌面上的 Docker Desktop 图标启动，或从开始菜单启动。
首次启动可能非常慢（长达几分钟甚至二十分钟），请耐心等待。期间任务栏 Docker 鲸鱼图标会显示“Docker Desktop starting”。
如果一切顺利，图标将变为稳定状态，并显示“Docker Desktop is running”。如果遇到卡顿，请检查前两步 WSL2 配置是否正确。
启动后，可能会弹出登录/注册窗口，直接跳过登录（点击“Continue without signing in”）。
第八步：启动 Dify
powershell
cd F:\\dify\\dify-main\\docker
powershell
.\\dify-start.bat
或者手动执行 Docker Compose 命令：
powershell
docker-compose up -d
-
首次启动会拉取多个镜像（如 PostgreSQL、Redis、Weaviate、Dify 自身等），耗时较长（取决于网络速度，通常 10~30 分钟）。请保持网络畅通，不要中断。
-
拉取完成后，Dify 服务将在后台运行。可以通过 docker-compose logs -f 查看日志，或等待脚本执行完毕。
第九步：访问 Dify
-
打开浏览器，访问 http://localhost:80（或 http://127.0.0.1）。
-
如果一切正常，你会看到 Dify 的初始化页面，根据提示设置管理员账号即可开始使用。
可选：停止 Dify
如需停止服务，进入 docker 目录运行 dify-stop.bat 或执行 docker-compose down。
常见问题
-
Docker 启动卡在“Starting the Docker Engine” 大概率是 WSL2 未正确安装或未设置默认版本。请重新执行第二步，确保 WSL2 内核更新包已安装，并重启电脑。
-
访问 localhost 无法打开 检查 Docker 容器是否正常运行：docker ps 应看到 docker-api-1、docker-worker-1、docker-weaviate-1、docker-db-1、docker-redis-1 等多个容器。若缺少，重新执行 docker-compose up -d。
-
镜像拉取慢 已通过 daemon.json 配置了国内镜像加速器，若仍慢可自行修改为其他可用地址。
-
Windows 10 家庭版用户 家庭版默认不支持 Hyper-V 和 WSL2，需先手动开启：
- 创建文本文件并写入以下内容，另存为 Hyper-V.cmd，右键管理员运行：
pushd “%~dp0” dir /b %SystemRoot%\\servicing\\Packages*Hyper-V*.mum >hyper-v.txt for /f %%i in (‘findstr /i . hyper-v.txt 2^>nul’) do dism /online /norestart /add-package:“%SystemRoot%\\servicing\\Packages%%i” del hyper-v.txt Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL
- 重启后，再按照第二步启用 WSL2 功能。
总结
通过以上步骤，可以在 Windows 10 上成功部署Dify。整个过程主要依赖于 Docker Desktop 的 WSL2 后端，因此确保 WSL2 正确配置是关键。以后每次重启电脑，只需启动 Docker Desktop，然后运行 dify-start.bat 即可快速恢复服务。
