必须先启用wsl2并验证为running状态、安装docker desktop且server版本≥20.10、配置国内镜像加速源、复制并正确编辑.env文件、最后执行docker compose up -d启动服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Windows 电脑上完整跑起 Dify，必须先让 Docker 环境真正就绪——不是装完 Docker Desktop 就算成功，而是要确保 WSL2 正常启用、Docker 引擎能识别 Linux 容器、镜像拉取不卡在超时、资源分配足够支撑多容器并行启动，缺一不可。
启用 WSL2 并验证子系统状态
按下 Win+R，输入 wsl --list --verbose，回车。如果提示“不是内部或外部命令”，说明 WSL 未安装，需以管理员身份运行 PowerShell，执行 wsl --install；若已安装但版本为 1，必须升级：先执行 wsl --set-default-version 2，再重启电脑。
重启后再次运行 wsl --list --verbose，确认输出中 DEFAULT 发行版状态为 Running 且 VERSION 显示 2。这一步失败，后续所有容器都无法正常挂载卷或访问网络。
安装并配置 Docker Desktop
从 Docker 官网下载最新 Windows 版安装包，全程使用默认选项安装，安装向导末尾勾选 Enable WSL 2 Features。
安装完成后启动 Docker Desktop，右下角托盘图标变绿即表示服务就绪。此时打开 PowerShell，运行 docker version，必须同时看到 Client 和 Server 的 Version 字段，且 Server 版本 ≥ 20.10 —— 若 Server 部分为空或报错，说明 WSL2 集成未生效，需进入 Docker Desktop Settings → General → 勾选 Use the WSL 2 based engine，再点击 Apply & Restart。
配置国内镜像加速器（必做）
右键托盘 Docker 图标 → Settings → Docker Engine，在右侧 JSON 编辑框中，将 registry-mirrors 字段替换为以下内容：
{ "registry-mirrors": ["https://docker.m.daocloud.io", "https://hub-mirror.c.163.com"] }
点击 Apply & Restart。这一步不做，docker compose up 极大概率卡死在 pulling image 阶段，且无明确报错提示，只会无限等待。
获取 Dify 源码并准备部署目录
打开终端（推荐使用 Windows Terminal 中的 WSL2 Ubuntu），执行：
git clone https://github.com/langgenius/dify.git && cd dify
进入项目根目录后，运行：cp .env.example .env。不要跳过这步——没有 .env 文件，docker compose 启动时会因缺失 DB_ENGINE 等关键变量直接退出。
用 VS Code 或记事本打开 .env，确认以下三行未被注释且值合理：
DB_ENGINE=postgresql
REDIS_URL=redis://redis:6379/0
CELERY_BROKER_URL=redis://redis:6379/1
启动 Dify 容器服务
确保当前路径是 dify/（即包含 docker-compose.yaml 的目录），执行：
docker compose up -d
等待约 90 秒，期间终端无报错即视为启动中。运行 docker compose ps，检查 STATUS 列是否全部显示 healthy 或至少为 up；若出现 exited，立即执行 docker compose logs api 查看首 20 行错误日志。
全部服务就绪后，在浏览器中访问 http://localhost/install，页面加载完成即表示部署成功。
