dify在windows上本地部署需依次完成wsl2与docker desktop安装、拉取配置项目代码、设置国内镜像源加速、执行docker compose up -d启动服务，并访问http://localhost完成管理员注册。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Windows电脑上把Dify完整跑起来，让AI应用开发环境真正属于你自己的硬盘和内存，而不是依赖远程服务器或云账号——这需要打通Docker容器、本地模型接入、环境变量配置和Web服务暴露四个关键环节，任何一个卡住都会导致localhost打不开或模型调用失败。
安装WSL2与Docker Desktop
Windows家庭版没有Hyper-V，但WSL2是Docker Desktop在Win10/11上运行的唯一可靠后端，跳过这步直接装Docker会报错“Docker Engine stopped”。
以管理员身份打开PowerShell，执行：wsl --install。系统会自动下载Linux内核更新包并重启。
重启后打开Windows终端（非PowerShell），输入wsl -l -v，确认Ubuntu版本显示为WslVersion: 2且状态为Running。
前往Docker官网下载Windows安装包，安装时必须勾选“Use the WSL 2 based engine”，否则Docker无法识别已启用的WSL2。
安装完成后启动Docker Desktop，右下角托盘出现小鲸鱼图标且显示“Docker is running”，再在CMD中运行docker run hello-world，看到“Hello from Docker!”即证明底层容器引擎就绪。
拉取并配置Dify项目代码
方法一：直接下载ZIP包（适合不熟悉Git的用户）
访问GitHub上的Dify官方仓库（https://github.com/langgenius/dify），点击绿色Code按钮→Download ZIP，解压到路径不含中文和空格的位置，例如C:\dify。
方法二：用Git克隆（推荐，便于后续升级）
打开Git Bash，执行：git clone https://github.com/langgenius/dify.git C:/dify。注意路径用正斜杠，且不要放在桌面或OneDrive同步目录下——Docker对长路径和符号链接极其敏感。
进入C:\dify\docker目录，把.env.example重命名为.env。这一步漏掉会导致所有服务启动后立即退出，因为Dify读不到基础配置。
配置国内镜像源加速启动
第一步：打开Docker Desktop → Settings → Docker Engine
第二步：在JSON配置框中，将"registry-mirrors"字段替换为以下任一可用地址（实测2026年6月仍有效）：
"https://docker.mirrors.ustc.edu.cn"
"https://mirror.baidubce.com"
"https://docker.mirrors.sjtug.sjtu.edu.cn"
第三步：点击Apply & Restart，等待Docker完全重启。这一步不做，docker compose up -d会卡在pull镜像阶段长达10分钟以上，甚至超时失败。
第四步：验证加速效果，在PowerShell中运行：docker pull nginx:alpine。如果30秒内完成拉取，说明镜像源生效。
启动Dify服务并首次访问
① 打开PowerShell，cd到C:\dify\docker目录
② 执行：docker compose up -d（Docker Compose V2）或docker-compose up -d（V1）
③ 等待约2–5分钟，期间Docker会自动拉取langgenius/dify-api、weaviate/weaviate等6个镜像并启动容器
④ 检查状态：docker compose ps，确认api、web、worker、db、redis、weaviate全部显示Up且端口映射正常（如0.0.0.0:80→80/tcp）
⑤ 打开浏览器，访问http://localhost。页面加载成功后，按提示注册第一个管理员账户——邮箱必须真实可用，密码需含大小写字母+数字+符号，否则后续无法重置。
