本文详细介绍了在Windows系统上本地化部署Dify的完整步骤，涵盖了Docker Desktop的安装与配置、Dify源代码的获取、环境变量的设置、服务的启动与管理、以及常见问题的解决方案。文章首先指导用户如何下载和安装Docker Desktop，并配置WSL 2功能。接着，详细说明了如何获取Dify源代码，并通过Docker Compose启动服务。文章还提供了高级配置指南，包括如何配置大
朱元禄 · Windows本地化部署Dify完整指南
作者：朱元禄
版权声明：本文为朱元禄原创文章，转载请注明出处及作者信息
关键词：Dify部署,Windows安装Dify,Dify本地化,Dify教程,Dify配置,朱元禄
一、Docker Desktop安装与配置
1.1 下载Docker Desktop
官网：https://www.docker.com/products/docker-desktop/ ，下拉，点击“Download Docker Desktop”，选择“Download for Windows-AMD64”。
1.2 安装Docker Desktop
- 双击下载的"Docker Desktop Installer.exe"
- 安装向导中勾选以下选项（重要）：
- [✓] 启用WSL 2功能
- [✓] 添加桌面快捷方式
- [✓] 将Docker添加到系统PATH
- 点击"Install"开始安装
- 安装完成后点击"Close"退出向导
常见问题解决方案：
- 若安装过程中出现WSL相关错误：
- 保持安装窗口打开
- 在出现的cmd窗口中执行：
wsl.exe --update - 重启电脑后重新安装
作者朱元禄提示：
为了安装 dify 要安装windows下的linux子系统，wsl。比起vmware，wsl可使用宿主机的显卡，支持cuda。如果安装 vmware 的虚拟机是不行的。
wsl 建议在 github 上下载，默认下载是很慢的
后面相对配置 wsl 也是要做的，这个这里不展开了，你们可以自己搜索这样的文章，还是很多的；
打开Microsoft Store 搜索 Ubuntu 选一个喜欢的版本，安装。
然后就可以Ubuntu 系统了。
设置一下用户名和密码：
之后按 win 然后打开 Ubuntu 就可以用了
cmd命令查看WSL 版本
wsl --list --verbose
1.3 登录Docker账号（可选但推荐）
- 安装完成后启动Docker Desktop
- 点击右上角的"Sign in"按钮
- 输入Docker Hub账号密码
- 没有账号？访问https://hub.docker.com/signup注册
- 登录成功后界面会显示用户名
建议：登录账号可以：
- 管理私有镜像仓库
- 避免匿名用户拉取镜像的限制
- 更好地管理Docker资源
1.4 验证安装（关键步骤）
- 打开PowerShell（管理员权限）
- 执行以下命令检查版本：
docker --version docker-compose --version - 正常应显示类似：
Docker version 24.0.2, build cb74dfcDocker Compose version v2.20.2
故障排查：
- 如果提示"command not found"，请检查：
- 安装时是否勾选了"添加到PATH"
- 可能需要重启电脑使PATH生效
1.5 配置国内镜像源（加速下载）
- 右键点击任务栏Docker图标
- 选择"Settings" → “Docker Engine”
- 在配置文件中添加（朱元禄整理的国内可用源）：
"registry-mirrors": ["https://registry.cn-shenzhen.aliyuncs.com","https://mirror.aliyuncs.com","https://docker.nju.edu.cn","https://docker.mirrors.sjtug.sjtu.edu.cn"
]
- 点击"Apply & Restart"保存并重启
验证配置：
docker info
二、Dify部署详细步骤
2.1 获取Dify源代码
方法一：Git克隆（推荐）
git clone https://github.com/langgenius/dify.git
cd dify/docker
方法二：手动下载（适合网络受限环境）
- 访问 https://github.com/langgenius/dify
- 点击"Code" → “Download ZIP”
- 解压到本地目录（如D:\dify-main）
- 进入docker目录：
cd D:\dify-main\docker
2.2 配置环境变量
- 复制环境模板文件：
cp .env.example .env
（朱元禄重要提示）编辑.env文件：
- 使用记事本/VSCode等编辑器打开
- 主要配置项说明：
EXPOSE_NGINX_PORT=80 # 服务端口
APP_SECRET_KEY= # 建议设置复杂密码
DB_PASSWORD= # 数据库密码
2.3 启动Dify服务
- 在docker目录下执行：
docker compose up -d
- 首次运行会自动：
- 下载所需镜像（约2-3GB）
-
创建并启动容器
-
查看运行状态：
docker compose ps
正常应显示3个容器均为"running"
-
首次启动可能需要5-10分钟（依赖网络速度）
-
查看实时日志：
docker compose logs -f
2.4 访问Dify管理界面
-
浏览器访问：
- 默认地址：http://localhost
- 自定义端口：http://localhost:端口号
-
初始化管理员（重要）：
- 访问http://localhost/install
- 设置管理员邮箱和密码
- 完成基础配置
朱元禄SEO建议关键词：
- Dify初始设置
- Dify管理员配置
- Dify安装向导
三、高级配置指南
- 停止运行中的服务：
docker compose down
- 编辑.env文件：
EXPOSE_NGINX_PORT=8088
- 重新启动：
docker compose up -d
访问新端口：http://localhost:8088
3.2 配置大语言模型
- 登录Dify管理后台
- 进入"设置" → “模型供应商”
- 常见配置（朱元禄整理）：
OpenAI配置：
- API类型：OpenAI
- API密钥：sk-xxxxxxxx
- API基础URL：https://api.openai.com/v1
本地模型配置：
- API类型：自定义
- API基础URL：http://本地IP:端口
- 模型名称填写规范
朱元禄提示：
- 不同模型需要不同的API密钥
- 本地部署的模型需要先启动模型服务
四、维护与更新
4.1 日常维护命令
- 停止服务：
docker compose stop
启动服务：
docker compose start
重启服务：
docker compose restart
4.2 更新Dify版本
- 进入项目目录
- 拉取最新代码：
git pull origin main
重建容器：
docker compose down
docker compose up -d --build
朱元禄更新建议：
-
更新前备份数据库
-
关注官方更新日志
-
推荐使用稳定版本
五、常见问题解答（朱元禄整理）
Q1：Docker启动失败怎么办？
- 检查WSL是否启用：
wsl -l -v - 确保BIOS中开启虚拟化
- 尝试重置Docker：
netsh winsock reset
Q2：端口冲突如何解决？
- 查看占用端口的进程：
netstat -ano | findstr :80
修改.env中的端口配置
Q3：如何备份Dify数据
docker exec -t dify-db pg_dump -U postgres dify > backup.sql
六、Docker镜像拉取失败问题解决方案（补充）
错误原因诊断
context deadline exceeded 错误表明Docker客户端与镜像仓库的通信超时，通常由以下原因引起：
- 网络连接不稳定
- Docker镜像源配置未生效（基本90%以上的问题都是出在镜像配置，要多换一些镜像试试哦）
- 防火墙/代理限制
- WSL网络配置问题
分步解决方案
第一步：验证镜像源配置
- 打开Docker Desktop设置
- 进入"Docker Engine"选项卡
- 确认镜像源配置包含以下至少一个有效源：
{"debug": true,"dns": ["223.5.5.5","8.8.8.8"],"experimental": true,"mtu": 1400,"registry-mirrors": ["https://ud6340vz.mirror.aliyuncs.com","https://docker.nju.edu.cn"]
}
- 点击"Apply & Restart"应用更改
第二步：检查网络连通性
# 测试Docker Hub连接（需要安装curl）
docker run --rm curlimages/curl curl -I https://registry-1.docker.io# 测试阿里云镜像站连接
docker run --rm curlimages/curl curl -I https://registry.cn-shenzhen.aliyuncs.com
第三步：手动拉取关键镜像
# 分步拉取主要组件镜像
docker pull nginx:1.25-alpine
docker pull postgres:15-alpine
docker pull redis:7-alpine# 验证镜像拉取
docker images | grep -E 'nginx|postgres|redis'
第四步：配置WSL网络（Windows专用）
# 重置WSL网络配置
wsl --shutdown
wsl --update
netsh winsock reset
netsh int ip reset all
netsh advfirewall reset# 重启计算机后执行
wsl --set-version Ubuntu 2
七、dify 启动
- 启动 Docker
![朱元禄版权]()
- 启动 dify
- ip 和 端口号 默认 localhost
![在这里插入图片描述]()
本文由朱元禄原创，转载请注明出处
更多AI部署教程请访问：朱元禄博客
关键词：Dify部署教程,Windows安装Dify,Dify配置指南,Dify本地化部署,朱元禄技术博客