一、整体流程一览Step 1安装 Docker Desktop含 WSL2 环境配置 Step 2克隆 Dify 仓库 Step 3进入 docker 目录配置 .env Step 4启动 Difydocker compose up -d Step 5初始化登录二、Step 1安装 Docker Desktop1.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保存。1.6 验证 Docker 安装命令行输入docker --version看到版本号说明 Docker 安装成功三、Step 2克隆 Dify 仓库进入你要存放项目的目录比如D:\Workspace\Dev-Projects可以直接下载源码压缩包访问GitHub - langgenius/dify: Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack. · GitHubBuild Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack. - langgenius/difyhttps://github.com/langgenius/dify仓库页面 → 点击Code→ 选择Download ZIP→ 解压即可效果相同四、Step 3进入 docker 目录配置 .env3.1 进入 docker 目录进入刚才的dify项目找到docker文件夹。在 Windows 资源管理器里可以直接在地址栏输入cmd回车就在该目录打开命令行省去 cd 命令3.2 配置 .env 环境变量文件把.env.example文件改名为.env五、Step 4启动 Dify在docker目录下执行docker compose up -d首次启动会拉取大量镜像api、nginx、redis、postgres 等耐心等待拉取完成后容器会自动创建并启动看到[] Running 12/12各容器状态为Runningpostgres 为Healthy说明 Dify 启动成功也可以在 Docker Desktop 的Containers界面直观看到所有容器在运行六、Step 5初始化登录浏览器访问http://localhost会自动跳转到登录页localhost/signin。如果是第一次使用点击「初始化账户」设置管理员账号邮箱 密码登录后进入「工作室」localhost/apps点击「创建」选择「创建空白应用」或「从应用模板创建」即可创建你的第一个 Dify 应用记得后续在「设置 → 模型供应商」里填入模型 API Key如 DeepSeek、通义千问等应用才能真正跑起来。七、常见问题与排查7.1 拉取镜像慢 / 超时失败在Docker Engine里配置registry-mirrors镜像加速源见 1.5 节然后重新docker compose up -d。镜像源随时可能失效如果配置后依然拉取失败建议自行搜索最新的国内 Docker 镜像源替换7.2 C 盘空间被占满修改Resources → Advanced → Disk image location到其他盘见 1.5 节。7.3 端口占用修改.env中的EXPOSE_NGINX_PORT端口号后重启改完端口访问地址要带上对应端口号如http://localhost:8080。