Windows 11 本地部署Dify详解

Windows本地化部署Dify完整指南

一、Docker Desktop安装与配置

参考：Window 11 Docker安装-XQLEE'Blog

二、Dify部署详细步骤

2.1 获取Dify源代码

方法一：Git克隆（推荐）

git clone https://github.com/langgenius/dify.git
cd dify/docker

方法二：手动下载（适合网络受限环境）

1. 访问 https://github.com/langgenius/dify

2. 点击"Releases" → “Latest”

   

   打开Latest(最新稳定版)后拉到最下面

   

   看到Assets 点开，点击Source code (zip)下载

3. 解压到本地目录（如D:\dify-main）
4. 进入docker目录：

cd D:\dify-main\docker

2.2 配置环境变量

1. 复制环境模板文件：

   cp .env.example .env

（重要提示）编辑.env文件：

2. 使用记事本/VSCode等编辑器打开

• 主要配置项说明：

EXPOSE_NGINX_PORT=80    # 服务端口
#APP_SECRET_KEY=         # 建议设置复杂密码
DB_PASSWORD=difyai123456 # 数据库密码

# pip python软件镜像源配置
PIP_MIRROR_URL=https://pypi.tuna.tsinghua.edu.cn/simple
#PIP_MIRROR_URL=

PIP_MIRROR_URL如果清华的不行就换其他

• 清华：https://pypi.tuna.tsinghua.edu.cn/simple
• 阿里：https://mirrors.aliyun.com/pypi/simple/
• 豆瓣：https://pypi.douban.com/simple/
• 中科大：https://pypi.mirrors.ustc.edu.cn/simple/

2.3 启动Dify服务

1. 在docker目录下执行：

   docker-compose up -d

• 首次运行会自动：

• 下载所需镜像（约2-3GB）

  

2. 创建并启动容器
3. 查看运行状态：

docker-compose ps
正常应显示3个容器均为"running"

• 首次启动可能需要5-10分钟（依赖网络速度）
• 查看实时日志：

docker-compose logs -f

2.4 访问Dify管理界面

1. 浏览器访问：
   • 默认地址：http://localhost
   • 自定义端口：http://localhost:端口号
2. 初始化管理员（重要）：
   • 访问http://localhost/install
   • 设置管理员邮箱和密码
   • 完成基础配置

SEO建议关键词：

• Dify初始设置
• Dify管理员配置
• Dify安装向导

三、高级配置指南

1. 停止运行中的服务：

docker-compose down

2. 编辑.env文件：

EXPOSE_NGINX_PORT=8088

3. 重新启动：

docker-compose up -d

访问新端口：http://localhost:8088

3.2 配置大语言模型

1. 登录Dify管理后台
2. 进入"设置" → “模型供应商”
3. 常见配置（整理）：

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版本

1. 进入项目目录

2. 拉取最新代码：

   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客户端与镜像仓库的通信超时，通常由以下原因引起：

1. 网络连接不稳定
2. Docker镜像源配置未生效（基本90%以上的问题都是出在镜像配置，要多换一些镜像试试哦）
3. 防火墙/代理限制
4. WSL网络配置问题

分步解决方案

第一步：验证镜像源配置

1. 打开Docker Desktop设置
2. 进入"Docker Engine"选项卡
3. 确认镜像源配置包含以下至少一个有效源：

{
  "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"
  ]
}

4. 点击"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 启动

1. 启动 Docker
2. 启动 dify

ip 和 端口号 默认 localhost