1. 项目概述
最近在本地Windows 10环境下部署Dify v1.11.1时遇到了PostgreSQL权限问题,经过一番折腾终于解决。这里记录下完整的部署过程和踩坑经验,希望能帮到同样遇到问题的朋友。
Dify是一个开源的AI应用开发平台,基于Python开发,使用Docker容器化部署。v1.11.1是2023年发布的一个重要版本,修复了多个已知问题并增加了新功能。在Windows环境下部署时,由于文件系统权限问题,PostgreSQL容器启动会遇到特殊挑战。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 系统要求
- Windows 10 20H2或更高版本
- WSL2已启用并配置
- Docker Desktop 4.12.0或更高版本
- Git 2.39.2或更高版本
提示:建议使用Windows Terminal作为命令行工具,比默认cmd更好用
2.2 安装必要组件
-
首先确保WSL2已正确安装:
bash复制
wsl --list --verbose应该能看到至少一个发行版(如Ubuntu)状态为"Running"
-
安装Docker Desktop时,务必勾选"Use WSL 2 based engine"选项
-
验证Docker安装:
bash复制
docker --version docker-compose --version
3. 获取Dify源码
3.1 克隆代码仓库
推荐使用git克隆指定tag的代码:
bash复制git clone --branch v1.11.1 https://github.com/langgenius/dify.git
cd dify
如果网络问题导致克隆失败,也可以直接下载zip包:
- 访问Dify的GitHub仓库
- 切换到v1.11.1标签
- 点击"Download ZIP"按钮
- 解压到本地目录
3.2 检查代码结构
关键目录说明:
docker/:包含所有Docker相关配置api/:后端API服务代码web/:前端界面代码scripts/:各种辅助脚本
