下面给你一套最清晰、最稳定、适合小白的 Windows 11 本地安装 Docker和Dify 全流程。如果你照着做，一般 20 分钟即可安装成功。
✅ 一、系统要求
Windows 11
至少 8GB 内存（推荐 16GB）
已开启虚拟化（BIOS 中 Intel VT-x / AMD-V）
✅ 二、安装必须的软件
1. 安装 WSL2（必须）
以管理员身份打开 PowerShell：
wsl --install
提示重启后，自动安装 Ubuntu。
确认 WSL2 是否启用：
wsl -l -v
若显示类似：
Ubuntu Running 2
✔ 说明 WSL2 已启用。
2. 安装 Docker Desktop（必须）
下载地址：
https://www.docker.com/products/docker-desktop/
安装时务必选择：
✔ Use WSL 2 backend
✔ 启用 Integration（WSL 集成）
安装完成后打开 Docker Desktop → 确保显示：
Docker is running
✅ 三、下载 Dify 项目代码
⚠️ 非常重要：
必须将 Dify 项目放在 Windows 用户目录
例如：
C:\Users\你的用户名\dify
不要放在：
桌面（有时也行但不稳定）
WSL 内部（会导致 volume 问题）
C:\Program Files
OneDrive 同步目录
在 PowerShell 输入：
cd C:\Users\你的用户名\
git clone https://github.com/langgenius/dify.gitcd dify
✅ 四、生成环境变量文件
copy .env.example .env
默认配置即可，如果你本机访问，确保：
APP_DOMAIN=http://localhost
✅ 五、启动 Dify（最关键的一步！）
确保你在 dify 目录下，运行：
docker compose up -d
它将启动 10+ 个服务，包括：
dify-web
dify-api
worker
postgres
redis
pgvector
第一次启动会自动拉镜像（大概 1GB 左右）。
等待 1～3 分钟。
✅ 六、在浏览器访问 Dify
打开：
�� http://localhost:3000
第一次进入会让你创建一个管理员账号。
完成后，你就能使用 Dify 了！
�� 七、检查服务是否正常运行
查看所有容器：
docker compose ps
查看 API 日志：
docker compose logs -f api
常见问题（如果网页打不开）：
|
问题 |
解决方法 |
|
某些容器退出 |
多执行一次 docker compose up -d |
|
docker 启动失败 |
重启 Docker Desktop |
|
80 或 3000 端口被占用 |
修改 .env 中 WEB_PORT |
|
报卷宗权限错误 |
确保项目在 C:\Users\你的名字 |
安装完成！
配置外部模型
OpenAI
DeepSeek
Qwen
Moonshot
ChatGLM
使用本地模型
Ollama + Dify
LM Studio + Dify
vLLM + Dify
数据库、向量库优化
