第2篇：Dify 部署保姆级教程：用 Docker跑起来

一、整体流程一览

复制代码

Step 1：安装 Docker Desktop（含 WSL2 环境配置）
Step 2：克隆 Dify 仓库
Step 3：进入 docker 目录，配置 .env
Step 4：启动 Dify（docker compose up -d）
Step 5：初始化登录

二、Step 1：安装 Docker Desktop

1.1 环境要求：WSL

在 Windows 上跑 Docker Desktop，我们使用默认推荐的 WSL2。

WSL2 的系统要求如下：

WSL 版本：2.1.5 或更高
系统：Windows 10 64 位（22H2，内部版本 19045）或 Windows 11 64 位（23H2，内部版本 22631）及以上
硬件：64 位处理器（带二级地址转换 SLAT）、4GB 内存、BIOS 中开启硬件虚拟化

1.2 开启 Windows 功能（WSL 子系统 + 虚拟机平台）

打开控制面板，进入「程序」：

点击「启用或关闭 Windows 功能」，勾选以下两项，点确定（可能需重启）：

✅ 适用于 Linux 的 Windows 子系统（WSL）
✅ 虚拟机平台

1.3 验证 / 安装 WSL

按 Win + R，输入 cmd 打开命令行，验证 WSL 版本：

复制代码

wsl --version

如果没有显示版本信息，说明 WSL 是旧版，需要更新。以管理员身份打开 PowerShell 或命令提示符，执行：

复制代码

wsl --install
wsl --update

勾选并点击确定后，务必重启电脑，否则 WSL2 无法正常工作

1.4 安装 Docker Desktop

从官网（Install Docker Desktop on Windows | Docker Docs ）下载 Docker Desktop 并安装。

安装配置界面，保持默认勾选：

✅ Use WSL 2 instead of Hyper-V (recommended)（使用 WSL2 而非 Hyper-V，推荐）
✅ Add shortcut to desktop（在桌面添加快捷方式）

首次启动会要求同意 Docker 订阅协议，点击 Accept：

欢迎界面选择「Continue without signing in」（不登录，直接使用）：

1.5 配置 Docker Desktop（两个关键设置，避免踩坑）

设置一：修改资源下载路径（省 C 盘空间）

打开 Settings → Resources → Advanced ，修改「Disk image location」到一个空间更大的盘（比如 D 盘）。默认放在 C 盘，时间久了会很占空间：

设置二：配置镜像加速源（解决拉取镜像慢/失败）

打开 Settings → Docker Engine ，在配置文件里加上 registry-mirrors 镜像源（国内访问 Docker Hub 很慢甚至失败，这一步基本是必须的）：

镜像源随时可能失效，如果配置后依然拉取失败，建议自行搜索最新的国内 Docker 镜像源替换

复制代码

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [
    "https://docker.xuanyuan.me",
    "https://docker.1ms.run",
    "https://docker.m.daocloud.io",
    "https://registry-1.docker.io"
  ]
}

点 Apply 保存。