Dify的安装部署与卸载

Dify：Dify（Define + Modify）是一款开源的LLM应用开发平台（LLMOps）

Dify的核心能力：

可视化编排：拖拽式 Prompt / 工作流 / RAG 配置
多模型兼容：OpenAI、Claude、Gemini、通义千问、文心一言、Ollama 本地模型等
企业级 RAG：文档上传、解析、分块、向量库、召回、溯源
Agent 能力：函数调用、工具集、ReAct 推理、多步骤任务
API 一键发布：自动生成应用 API，可嵌入业务系统
LLMOps：日志、调用统计、成本监控、版本管理、审核

01 安装Dify

硬件配置（最低）：

CPU：≥2 核（推荐 4 核 +）
内存：≥4 GB（强烈建议 16 GB+，否则容易 OOM）
磁盘：≥50 GB 可用空间（SSD 更佳）
必须在 BIOS/UEFI 开启 CPU 虚拟化（VT-x / AMD-V）

软件依赖（推荐）：

组件	要求	验证
WSL2		`wsl -l -v`
Docker Desktop	含Docker Compose	docker --version `docker compose version`
Git	可选，用于GitHub取源码
Chrome / Edge	浏览器

什么是WSL2？

（Windows Subsystem for Linux 2）是Windows10/11系统自带的一项功能，可以在Windows里直接运行完整的 Linux 系统，不需要嵌入虚机/安装双系统。它的本质是一个轻量化的虚机+Linux内核。

为什么部署Dify要用WSL2？

因为Dify是Linux原生应用（依赖 Docker、Docker Compose、PostgreSQL、Redis 等），很多依赖（如docker、bash脚本）Windows 不原生支持。

什么是Docker Compose？

Docker Compose 是 Docker 官方推出的「多容器编排工具」，专门用来一键管理、启动、停止多个相互关联的 Docker 容器，用一个 docker-compose.yml 配置文件，就能把一整套应用的所有服务、网络、存储、依赖关系定义清楚，用一条命令完成部署。

为什么部署Dify要用Docker Compose？

Dify 本身是「多服务分布式架构」，不是单容器应用，Dify 正常运行，至少需要 6 个以上相互依赖的容器协同工作。

容器服务	作用
`nginx`	反向代理、负载均衡，对外暴露端口
`api`	Dify 核心 API 服务，处理业务逻辑
`worker`	异步任务处理（如大模型调用、文件解析）
`postgres`	关系型数据库，存储用户、应用、配置数据
`redis`	缓存、消息队列，支撑高并发
`qdrant/weaviate/pgvector`	向量数据库，支撑 RAG 知识库检索
`sandbox（可选）`	代码执行沙箱，保障插件 / 工具运行安全

步骤1：安装和开启WSL2

# 查看本地是否安装了WSL2，如果出现版本列表（VERSION列显示2）wsl --list --verbose  #或简写 wsl -l -v

在PowerShell 里查询wsl版本时，系统检测到本机未安装，并提示按下任意键可自动安装。

重启电脑，以管理员方式重开PowerShell，并执行

# 一键安装默认的 Ubuntu 22.04 LTS（最稳定、最常用）wsl --install# 如需安装其他版本（如Debian），参考以下命令wsl --install -d Debian

设置好用户名和密码以后，自动进入Linux环境。同时跳出来管理界面：

如何在wsl的linux终端子系统和powershell命令行之间切换？

在wsl的终端linux子系统中，输入exit、logout或者按下Ctrl+D即可退出当前wsl会话，切回PowerShell。wsl后台进程仍在运行，下次输入wsl可秒切回。

重新验证wsl及linux子系统版本。

步骤2：安装Docker Desktop

下载链接：：https://www.docker.com/products/docker-desktop/

Doker Desktop的安装包下载和账户注册，可能需要用梯子科学上网，这部分需要自行解决。

验证Docker Desktop

# 查看 Docker 引擎版本docker --version# 查看 Docker Compose 版本docker compose version

步骤3：部署Dify

# 进入D盘(不占用系统盘空间)cd D:\# 通过git获取Dify源码git clone https://github.com/langgenius/dify.git# 进入dify文件中的docker目录cd dify/docker

复制.env.example示例文件内容到.env配置文件。

copy .env.example .env

进入dify\docker目录下，用记事本打开 .env文件，一般来说至少要修改以下几点，本次测试部署保持默认。

# 加密密钥（自行生成随机字符串）SECRET_KEY=xxx# 数据库密码（自己设）POSTGRES_PASSWORD=xxx# 访问地址（本地默认）CONSOLE_API_URL=http://localhostAPP_API_URL=http://localhost

一键启动

在 docker 目录打开 PowerShell，执行：

# 按照docker-compose.yml配置自动下载镜像、创建容器、安顺序启动数据库、Redis、API、前端...并-d后台运行docker compose up -d

其他实用命令

docker compose ps        # 看 Dify 运行是否正常docker compose logs -f   # 看实时日志docker compose start     # 启动服务 docker compose stop      # 停止服务docker compose restart   # 重启服务docker compose down      # 关闭并删除容器（数据不丢）docker compose down -v   # 彻底删除+清空数据（谨慎）docker compose pull      # 重新拉取镜像（解决镜像可能损坏的问题）

在本地浏览器输入你配置的dify访问地址或http://localhost（默认访问入口）。进入注册/登录界面。

登录后的dify页面是这样

02 卸载Dify

第一种：快速卸载（仅删除容器，保留数据 / 镜像）。

适合临时清理容器，后续需重新启动 Dify，保留知识库、配置数据。

#在dify\docker目录下执行，停止所有运行中的容器docker compose down# 验证卸载，输出为空，代表容器已彻底卸载docker compose ps

第二种：彻底卸载（删除容器 + 数据卷，重置环境）。

适合需要重置 Dify，清空所有数据（知识库、账号、配置），重新部署全新环境。

# 停止并删除所有容器，同时-v删除所有数据卷docker compose down -v# 删除 Dify 相关镜像（释放磁盘空间）docker images | grep dify# 删除对应镜像（替换为你的镜像ID）docker rmi -f 镜像ID # 验证卸载：容器为空 docker compose ps # 无 dify 相关镜像（若执行了删除步骤）docker images

最后手动删除\dify目录文件即可。

至此，dify已经完全从你的电脑里彻底删除了。

卸载DockerDesktop、WSL2可直接在windows应用程序中执行即可，不再赘述。

欢迎交流评论，谢谢！