Dify 安装部署教程

Dify 是目前最流行的开源 LLMOps 平台之一：可视化编排 Agent、自带知识库（RAG）、支持 100+ 模型接入，一条命令即可本地部署。本教程带你从零跑通 Dify。

Dify 部署

一、环境要求

  • 系统：Linux / macOS / Windows（推荐 Linux 服务器）

  • Docker：20.10+，并启用 Docker Compose

  • 配置：最低 4 核 8G 内存（生产建议 8 核 16G）

  • 模型 API Key：OpenAI / DeepSeek / 通义千问 / 智谱 任选其一

二、安装步骤

1. 安装 Docker（如已安装可跳过）

1
# Ubuntu / Debiancurl -fsSL https://get.docker.com | bashsudo systemctl enable --now docker# 验证docker --versiondocker compose version

2. 克隆 Dify 仓库

1
git clone https://github.com/langgenius/dify.gitcd dify/dockercp .env.example .env

3. 启动服务

1
docker compose up -d

首次启动会拉取镜像（约 5~10 分钟），看到 Started 后访问：

1
http://localhost （默认 80 端口）

三、初始化配置

  • 打开浏览器进入首页，设置管理员邮箱和密码

  • 进入「设置 → 模型供应商」，添加你的模型 API Key（以 DeepSeek 为例）：

1
# 在 DeepSeek 开放平台申请 Key 后填入类型: 对话型 (LLM)模型: deepseek-chatAPI Key: sk-xxxxxxxx
  • 创建应用：工作室 → 创建空白应用 → 聊天助手

Dify 工作台

四、快速搭建一个 Agent

  • 在应用编排页，左侧选择「Agent」模式

  • 添加工具：搜索、网页读取、代码执行等

  • 编写提示词（System Prompt），例如：

1
你是一位耐心的智能客服助手。- 优先使用【搜索】工具查询最新信息- 回答要简洁、分点- 不确定时如实说明
  • 右上角「发布」→ 可嵌入网站、调用 API、发布到微信/飞书

五、常见问题

问题 解决
80 端口被占用 修改 docker/.env 中 EXPOSE_NGINX_PORT 后重启
模型调用失败 检查 API Key 是否填写、模型名是否正确
内存不足 关闭向量库组件：docker compose stop weaviate
升级版本 cd dify/docker && docker compose pull && docker compose up -d

小结

Dify 的价值在于把模型、知识库、工具、工作流串成一条可视化流水线，无需编写胶水代码。本地部署后数据完全自控，适合企业内网与私有化场景。

延伸阅读：