Windows下使用Docker部署Dify完整教程

以下是在Windows系统下通过Docker部署Dify的详细步骤：

一、系统环境准备

1. 启用Windows功能
2. 打开【控制面板】 > 【程序】 > 【启用或关闭Windows功能】，勾选以下选项：
3. 适用于Linux的Windows子系统（WSL）
4. 虚拟机平台（若为专业版建议勾选Hyper-V）
5. 远程差分压缩API支持
6. 完成后重启系统。
7. 安装WSL2
8. 以管理员身份运行PowerShell，输入命令：

1. 若安装失败，尝试执行：

1. 重启后验证状态：wsl --status。

二、安装与配置Docker

1. 下载Docker Desktop
2. 访问Docker官网下载Windows版本安装包，按默认配置完成安装。
3. 配置镜像源（加速下载）
4. 右键任务栏Docker图标 → Settings → Docker Engine → 添加以下镜像源（示例）：

1. 点击“Apply & Restart”生效。
2. 验证安装
3. 打开PowerShell执行：

三、部署Dify服务

1. 获取Dify代码
2. 方法一（推荐）：克隆Git仓库

1. 方法二：手动下载GitHub ZIP文件，解压后进入dify/docker目录。
2. 配置环境变量
3. 复制环境模板文件：

1. 编辑.env文件，关键配置项：

1. 启动Docker容器
2. 在dify/docker目录下执行：

1. 首次启动会下载约2-3GB镜像，耐心等待完成。
2. 验证服务状态
3. 查看容器运行状态：

1. 实时日志监控：

四、访问与初始化

1. 本地访问Dify
2. 浏览器输入：http://localhost（默认端口80，若修改则替换为自定义端口）。
3. 首次访问需初始化管理员账号：
4. 访问http://localhost/install，设置邮箱和密码。
5. 远程访问配置（可选）
6. 使用内网穿透工具（如cpolar）：
7. 安装cpolar后创建HTTP隧道，映射本地80端口至公网地址。
8. 固定域名配置：升级cpolar套餐绑定二级子域名，实现永久访问。

五、集成大语言模型（以Ollama为例）

1. 添加模型供应商
2. 登录Dify后台 → Settings → Model Providers → 选择“Ollama”。
3. 配置参数：
4. Base URL：http://host.docker.internal:11434（本地Ollama服务地址）
5. Model Name：输入本地模型名称（如llama3）。
6. 测试模型功能
7. 创建新应用 → 选择配置的模型 → 进行对话或任务测试。

六、常见问题处理

1. 端口冲突
2. 使用netstat -ano | findstr :80查找占用进程，关闭或修改.env中的端口。
3. 镜像拉取失败
4. 检查Docker镜像源配置 → 更换有效镜像源 → 重启Docker。
5. 容器频繁重启
6. 检查日志：docker logs <容器ID> → 调整.env或docker-compose.yml配置。
7. WSL启动失败
8. 重置网络配置：netsh winsock reset → 重启系统。

七、维护与更新

1. 停止/重启服务

1. 更新Dify版本
2. 进入项目目录 → 拉取最新代码 → 重建容器：

通过以上步骤，您可以在Windows系统上完成Dify的本地化部署及模型集成。如需进一步优化（如HTTPS配置、多用户管理），可参考Dify官方文档。