Dify安装 Dify探索 PART 1 --- Dify安装之路 For myself——Dify 总安装流程（Win

Dify探索

PART 1 --- Dify安装之路

For myself——Dify 总安装流程（Windows + WSL2 + Docker Desktop）

前置环境（一次性）

Windows 10 / 11
WSL2（Ubuntu 20.04 / 22.04）
打开Docker Desktop（必须在 Windows 启动） Docker daemon 自动启动

获取 Dify 源码

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

若网络慢，自行在github上下载zip源码也可以

处理 Windows 遗留的 `Zone.Identifier` 文件（关键）

🔹 查看（可选）

find . -name "*Zone.Identifier*" -type f

🔹 删除（标准命令）

find . -name "*Zone.Identifier*" -type f -delete

作用：

避免 Docker build / compose 异常
避免 Git 目录污染
避免权限与 I/O 错误

目录结构整理（防止双层 dify-main）

目标结构：

Dify/
└── dify-main/
    ├── docker/
    ├── api/
    ├── web/

若出现 dify-main/dify-main：

cd ~/Dify/dify-main
mv dify-main/* .
mv dify-main/.* . 2>/dev/null
rmdir dify-main

Docker Compose 插件修复（WSL 关键坑）

4.1 安装官方插件

sudo apt update
sudo apt install -y docker-compose-plugin

4.2 插件路径桥接（关键）

sudo mkdir -p /usr/local/lib/docker/cli-plugins
sudo ln -sf /usr/libexec/docker/cli-plugins/docker-compose \
            /usr/local/lib/docker/cli-plugins/docker-compose

4.3 验证

docker compose version

准备环境变量（规范做法）

cd ~/Dify/dify-main/docker
cp .env.example .env //复制环境变量模板

即使你现在不改，也必须有 .env

启动 Dify（首次会很慢）

docker compose up -d

首次启动行为：

拉取 2–3GB 镜像
5–15 分钟属正常

状态确认

docker compose ps
docker ps

所有服务应为 Up。

访问与初始化

访问：

http://localhost

初始化管理员账号
进入控制台 → 安装模型 / 配置 LLM

二、删除 `Zone.Identifier` 后缀文件

（由于我是直接从本机copy到WSL故会产生些冗余文件）

✅ 查看

find . -name "*Zone.Identifier*" -type f

✅ 删除（推荐）

find . -name "*Zone.Identifier*" -type f -delete

✅ 指定目录删除

find ~/Dify -name "*Zone.Identifier*" -type f -delete

三、核心经验总结

Windows + WSL 下，Docker Desktop 是 Docker 引擎
WSL 中的 docker 只是 CLI
Zone.Identifier 是 Windows NTFS 遗留标记，Linux / Docker 不需要
Compose 插件路径是 WSL 最大坑之一
第一次 docker compose up -d 慢是正常现象

现在的系统状态是：
Windows 负责 Docker 引擎
WSL 负责开发环境
Docker Compose 负责服务编排
Zone.Identifier 已清干净
Dify 已成功运行

Dify安装