Dify 零基础入门：从部署到你的第一个 AI 应用

2301_80117363

153人浏览 · 2026-06-24 17:15:21

2301_80117363 · 2026-06-24 17:15:21 发布

Dify 零基础入门：从部署到你的第一个 AI 应用

不写代码，也能搭建自己的 AI 聊天助手。

Dify 是什么

一句话：Dify 是一个低代码 AI 应用开发平台，让你不写代码就能搭建 AI 聊天助手、知识库、工作流。

如果大模型是发动机，Dify 就是造车工厂。你不用自己造发动机——选一个现成的模型接上去，搭个车壳（系统提示词、界面、工作流），就能开了。

Dify 能做什么：

聊天助手：接一个大模型，写个系统提示词，就是一个 AI 客服/助手
知识库：上传文档，让 AI 基于你的文档回答问题（RAG）
工作流：拖拽式搭建复杂的 AI 处理流程
API 集成：把你的 AI 应用发布成 API，接入到其他系统

适合的场景：快速原型验证、内部 AI 工具、个人项目、学习 AI 应用开发。

部署前的准备

硬件需求

配置	最低要求	推荐
CPU	2 核	4 核
内存	4 GB	8 GB
磁盘	30 GB	50 GB

软件需求

Docker + Docker Compose（Dify 的所有组件都跑在 Docker 容器里）
Git（克隆 Dify 仓库）

关于部署环境

我的 Windows 本机虚拟化相关系统文件损坏，无法直接安装 Docker Desktop。所以我选择在虚拟机（VMware + Ubuntu Server）中部署。如果你的 Windows 能正常安装 Docker Desktop，直接装就行，不需要虚拟机。

虚拟机方案的配置建议：

VMware / VirtualBox
  -> Ubuntu Server 22.04
  -> 4 GB 内存
  -> 2 核 CPU
  -> 50 GB 磁盘
  -> 网络模式：桥接（方便宿主机访问虚拟机的 Web 服务）

安装 Docker

在 Ubuntu 上安装 Docker 和 Docker Compose：

# 一键安装 Docker（官方脚本）
curl -fsSL https://get.docker.com | sh

# 把当前用户加入 docker 组（避免每次都要 sudo）
sudo usermod -aG docker $USER

# 重新登录使权限生效，然后验证
docker --version
docker compose version

如果看到版本号输出，说明安装成功。

镜像拉取可能比较慢，可以配置国内镜像源加速：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

部署 Dify

第 1 步：克隆仓库

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

第 2 步：配置环境变量

cp .env.example .env

.env 文件里有很多配置项，默认就行。如果需要改端口，修改 EXPOSE_NGINX_PORT 这一行。

第 3 步：启动

docker compose up -d

第一次启动会拉取镜像，需要等几分钟。可以看日志确认进度：

docker compose logs -f

第 4 步：验证

docker compose ps

应该能看到多个容器都在 running 状态：

NAME                  STATUS
docker-api-1          Up
docker-web-1          Up
docker-worker-1       Up
docker-db-1           Up
docker-redis-1        Up
docker-nginx-1        Up

Dify 启动后会拉起这些容器：API 服务、Web 前端、Worker（后台任务）、PostgreSQL 数据库、Redis 缓存、Nginx 反向代理。Docker Compose 帮你把所有依赖都打包好了，不用一个个装。

常见问题

问题	解决
端口 80 被占用	改 `.env` 里的 `EXPOSE_NGINX_PORT` 为其他端口，如 8080
内存不足导致容器崩溃	虚拟机内存至少分配 4GB，建议 8GB
镜像拉取超时	配置 Docker 镜像源（见上文）

首次访问与注册

浏览器打开 http://虚拟机IP:80（本地部署就是 http://localhost:80）。

第一次访问会进入注册页面，创建管理员账号。注册完成后进入 Dify 控制台，左侧导航大概长这样：

探索 - Dify 官方提供的模板和示例工作室 - 创建和管理你的 AI 应用知识库 - 上传文档，构建 RAG 知识库工具 - 管理外部工具集成设置 - 模型配置、成员管理、系统设置

界面很直观，基本不需要看文档就能摸索。接下来先做一件事：把大模型接进来。
在这里插入图片描述

配置模型 API

Dify 本身不是大模型，它是一个平台。你需要给它接一个大模型才能用。

添加模型供应商

进入 设置 → 模型供应商 → 添加模型。

Dify 支持很多模型供应商。如果你用的是国产模型（比如小米 Mimo、通义千问），选 OpenAI API Compatible（兼容接口），然后填：

配置项	填什么
API Key	你的 API Key
Base URL	中转地址或官方地址
模型名称	具体模型 ID，如 `mimo-large-latest`

在这里插入图片描述

接本地模型

如果你本地有 LM Studio 或 Ollama 跑了模型，也可以接进来：

LM Studio 启动一个本地服务（默认监听 http://localhost:1234）
Dify 里添加模型供应商，选 OpenAI API Compatible
Base URL 填 http://宿主机IP:1234/v1
API Key 随便填一个（LM Studio 不校验）

注意：如果 Dify 跑在虚拟机里，localhost 指的是虚拟机自己，不是宿主机。需要用宿主机的实际 IP 地址。

配置完成后，点「检查可用性」验证连接是否成功。看到绿色对勾就 OK。

创建第一个 AI 应用

模型接好了，现在来创建你的第一个 AI 应用。

选择模板

进入「工作室」，点「创建应用」。Dify 提供了几种应用类型：

类型	适合什么	难度
聊天助手	单轮/多轮对话，问答机器人	入门
文本生成	写文章、翻译、摘要	入门
Agent	能调用工具的智能体	中级
工作流	复杂的多步骤 AI 流程	中级