保姆级教程：Dify 本地一键部署（Windows/Mac 通用）

一、前言

在 AI 应用开发领域，Dify 是一款开源的 LLM 应用开发平台，支持可视化编排 Prompt、对接各类大模型、搭建知识库、生成 API 服务，无需复杂代码就能快速开发企业级 AI 应用。

很多小伙伴想本地部署 Dify 用于学习、测试，但官方文档对新手不够友好。本文用最简单、最稳定的方式，带你 10 分钟完成 Dify 本地部署，全程无坑！

二、部署前准备（必看）

1. 环境要求

操作系统：Windows 10+/MacOS/Linux
必须安装：Docker Desktop（核心依赖，一键容器化部署）
内存建议：≥ 4GB（避免启动卡顿）

2. 安装 Docker Desktop

Docker 是 Dify 部署的核心工具，无需手动配置环境，一键运行所有服务。

下载地址 ：Docker 官方下载

Windows 直接安装，勾选 "Use WSL2"（推荐）
Mac 直接拖拽安装即可
安装完成后，启动 Docker Desktop，保持后台运行

三、开始部署 Dify（核心步骤）

1. 下载 Dify 部署包

打开终端（Windows 用 PowerShell，Mac 用终端），执行命令克隆代码：

bash 复制代码

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

如果没装 Git，直接去 Dify GitHub 下载 ZIP 压缩包，解压即可。

2. 进入部署目录

bash 复制代码

cd dify

3. 复制环境配置文件

bash 复制代码

cp .env.example .env

Windows PowerShell 命令：

powershell 复制代码

copy .env.example .env

这个文件是 Dify 的配置文件，默认配置即可直接运行，无需修改。

4. 一键启动 Dify

核心命令，直接复制运行：

bash 复制代码

docker compose up -d

-d 表示后台运行，关闭终端不影响服务
首次启动会自动下载镜像，等待 3-5 分钟（取决于网速）

5. 验证启动成功

执行命令查看服务状态：

bash 复制代码

docker compose ps

看到所有服务状态为 running 就说明启动成功！

四、访问 Dify 后台

打开浏览器，输入地址：

http://localhost:8080

首次访问需要注册账号，邮箱随便填，密码自定义，注册后直接登录使用。

五、基础配置（快速上手）

1. 配置大模型（必配）

Dify 本身不带模型，必须对接第三方 LLM：

进入后台 → 右上角「设置」→ 「模型供应商」
选择你要用的模型（通义千问、文心一言、GPT、DeepSeek 等）
填写 API Key 即可启用

2. 上传知识库

左侧「知识库」→ 「创建知识库」
支持上传 TXT/Markdown/PDF/Word 等文件
自动分词、向量化，无需配置 Elasticsearch（默认用 Qdrant）

3. 创建 AI 应用

左侧「应用」→ 「创建应用」
选择对话型/知识库型/函数型应用
可视化配置 Prompt、温度、上下文等参数
直接发布为 API 或 Web 应用

六、常用运维命令

1. 停止 Dify

bash 复制代码

docker compose stop

2. 重启 Dify

bash 复制代码

docker compose restart

3. 查看日志（排查问题用）

bash 复制代码

docker compose logs -f

4. 彻底删除服务（保留数据）

bash 复制代码

docker compose down

七、常见问题解决

1. 启动报错：端口 8080 被占用

修改 .env 文件中的端口：

ini 复制代码

WEB_PORT=8081  # 改成 8081 或其他未占用端口

然后重启服务：docker compose up -d

2. Windows 启动慢/卡顿

打开 Docker Desktop → 设置 → 资源
分配内存 ≥ 4GB，CPU ≥ 2 核
重启 Docker 再启动 Dify

3. 无法访问 localhost:8080

检查 Docker 所有服务是否为 running
关闭电脑防火墙/杀毒软件
浏览器清空缓存重试

八、总结

Dify 本地部署核心就是 Docker + 一条命令，无需复杂环境配置，新手也能轻松搞定。

本地部署适合：

学习 AI 应用开发
测试私有知识库
开发企业内部 AI 工具
二次开发定制功能