📋 系统要求

• 操作系统：Windows 10 版本 2004 及更高版本，或 Windows 11

• 内存：建议至少 8GB，推荐 16GB

• CPU：至少 2 核

• 虚拟化：确保已在 BIOS 中开启虚拟化支持（Intel VT-x / AMD-V）

📦 前期软件安装

1. 安装 WSL2（Windows 子系统）

1. 以管理员身份打开 PowerShell 或命令提示符。

2. 运行以下命令，这将默认安装 Ubuntu 发行版

   wsl --install

3. 按照提示重启计算机。

2. 安装 Docker Desktop

1. 访问 Docker Desktop for Windows下载安装程序。

2. 运行安装包，在安装向导中务必勾选：

   • [ ] Use WSL 2 based engine

   • [ ] Enable integration with my default WSL distro（或类似选项）

3. 安装完成后启动 Docker Desktop。首次启动可能会要求登录，可选择跳过。

3. 安装 Git

1. 访问 Git for Windows 官网下载安装程序。

2. 运行安装程序，大部分选项保持默认，但在以下几步请注意：

   • 选择组件：勾选 Git Bash Here和 Git GUI以便集成。

   • 选择默认编辑器：建议选择 Visual Studio Code或 Notepad++。

   • 调整 PATH 环境：选择 “Git from the command line and also from 3rd-party software”。

   • 配置行尾符转换：选择 “Checkout Windows-style, commit Unix-style line endings”。

🚀 部署 Dify

1. 获取 Dify 源代码

打开 PowerShell 或命令提示符，执行以下命令：

# 克隆代码仓库（选择一个稳定的目录，避免路径包含中文或空格）
cd D:\WORK
git clone https://github.com/langgenius/dify.git
cd dify

如果网络连接不稳定导致克隆中断，请删除不完整的 dify文件夹后重试。

2. 准备配置文件

进入 Dify 的 docker目录，并复制环境变量配置文件：

cd dify/docker
Copy-Item .env.example .env

（可选）您可以编辑 .env文件来修改默认配置，如端口、数据库密码等。

🌐 核心步骤：解决网络与镜像拉取问题

这是部署成功的关键。根据【链接1：DaoCloud 镜像加速服务文档】和您的实践，解决 Docker 镜像拉取失败有多种方案。

解决方案 A：配置 Docker 镜像加速器（推荐基础方案）

这是最通用的方法，配置后对所有 docker pull命令生效。

1. 右键点击系统托盘（右下角）的 Docker Desktop 图标，选择 Settings（设置）。

2. 在左侧选择 Docker Engine。

3. 在右侧的配置窗口中，找到 "registry-mirrors": []部分。

4. 将以下当前（2026年4月）可用的国内镜像加速器地址添加到方括号内，如文档所示：

   {
     "registry-mirrors": [
       "https://docker.m.daocloud.io",
       "https://dockerproxy.com"
     ]
   }

5. 点击窗口右上角的 Apply & Restart​ 按钮，等待 Docker 重启。

重要提示：根据文档说明，registry-mirrors配置仅适用于加速 docker.io这一个源站。对于其他源站（如 gcr.io, quay.io），应使用下文提到的“域名前缀替换”方案。

解决方案 B：使用域名前缀替换（推荐进阶方案）

对于无法通过 registry-mirrors加速的镜像，或作为临时测试，可以使用文档中提到的“增加前缀”方法。在拉取镜像时，手动在原始镜像名前添加 m.daocloud.io/前缀。

例如，要拉取 docker.io/library/nginx:latest，可以运行：

docker pull m.daocloud.io/docker.io/library/nginx:latest

根据文档，Dify 所需的一些基础镜像（如 ubuntu/squid, postgres:15-alpine）均可通过此方式加速。

解决方案 C：离线安装（终极方案，最可靠）

如果网络环境极差，上述在线加速方案均失败，请采用此方案。

1. 下载离线包：访问 Dify 的 GitHub Releases 页面 (https://github.com/langgenius/dify/releases)，下载与您版本对应的 dify-offline-*.tar或 dify-offline-*.tar.gz文件。

2. 加载镜像：将下载的离线包放入 D:\WORK\Dify\dify\docker目录，并执行：

   docker load -i dify-offline-*.tar

3. 启动服务：镜像加载完成后，Docker Compose 将直接使用本地镜像启动，完全无需网络。

   docker compose up -d

🎯 启动 Dify 服务

在完成上述任一网络解决方案的配置后，在 D:\WORK\Dify\dify\docker目录下执行启动命令：

docker compose up -d

首次启动会下载或加载所有必需镜像（约 5-10 GB），请耐心等待几分钟。

✅ 验证与访问

1. 检查服务状态：

   docker compose ps

   应看到约 10 个容器（如 dify-api, dify-web, postgres, redis等）状态均为 running。

2. 访问 Dify：

   • 打开浏览器，访问 http://localhost:3000

   • 首次访问会进入安装向导，按照提示创建管理员账户即可开始使用。

⚠️ 注意事项与故障排查

• 端口冲突：如果 3000 端口被占用，可修改 docker-compose.yml或 .env文件中的端口映射。

• 存储路径：Docker 镜像默认存储在 C 盘。如需更改，可在 Docker Desktop 的 Settings -> Resources -> Advanced​ 中修改磁盘镜像位置。

• 文档参考：如遇其他镜像（如来自 gcr.io, quay.io）拉取问题，请参考【链接1】中的“支持前缀替换的 Registry”表格，使用对应的加速域名。

• 网络诊断：如果配置加速器后仍拉取失败，可尝试在 PowerShell 中运行 docker pull hello-world测试基础网络连通性。

• 版本匹配：使用离线安装包时，请确保其版本与 docker-compose.yml中定义的镜像版本兼容。

至此，您已完成 Dify 在 Windows 上基于 Docker 的本地部署。