南瓜丶奇迹师1. 项目背景与核心目标
最近在本地Windows 10环境下部署Dify v1.11.1时遇到了不少"坑"，这里把我的完整踩坑经历和解决方案整理成文。Dify作为一款开源的自动化部署工具，在CI/CD流程中能显著提升效率，但不同环境下的配置差异常常导致各种意外问题。
这次部署的主要目标是建立一个可用于中小型项目的本地开发环境，支持Docker容器化部署和基本的自动化流程。选择v1.11.1版本是因为它在功能完整性和稳定性之间取得了较好平衡，但官方文档对Windows环境的说明相对简略。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与前置条件
2.1 系统要求确认
首先需要确保你的Win10系统满足以下最低要求：
- 版本：1903或更高（建议21H2）
- 内存：8GB以上（Docker运行需要足够资源）
- 存储：至少20GB可用空间
- 已启用WSL2（Windows Subsystem for Linux 2）
重要提示：务必通过
winver命令检查系统版本，早期版本的Win10在容器支持上存在诸多限制。
2.2 必要组件安装
-
Docker Desktop配置：
- 下载最新稳定版（当前为4.25.0）
- 安装时勾选"Use WSL 2 instead of Hyper-V"
- 在Settings > Resources中调整CPU和内存分配（建议CPU≥4核，内存≥6GB）
-
WSL2环境准备：
bash复制
wsl --install -d Ubuntu-20.04 wsl --set-default-version 2安装后建议执行
wsl --update确保内核最新 -
Git环境配置：
- 安装Git for Windows
- 配置core.autocrlf为false避免换行符问题：
git复制git config --global core.autocrlf false
3. Dify v1.11.1部署流程
3.1 源码获取与初始化
推荐使用官方Git仓库的release版本：
bash复制git clone https://github.com/dify/dify.git -b v1.11.1
cd dify
初始化配置文件：
bash复制cp .env.example .env
3.2 环境变量关键配置
修改.env文件中以下关键参数：
env复制# 数据库配置
DB_HOST=host.docker.internal
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=your_strong_password
# Redis配置
REDIS_HOST=host.docker.internal
REDIS_PORT=6379