跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashSaaSAI

Ubuntu 本地部署 Dify 详细教程

在 Ubuntu 系统上通过 Docker Compose 本地部署 Dify 开源大语言模型应用开发平台的完整流程。内容涵盖环境准备、Docker 安装与配置、镜像源设置、源码获取、环境变量调整及服务启动步骤。部署完成后,用户可通过浏览器访问 localhost/apps 创建管理员账号并使用聊天助手、文本生成、Agent 及工作流等功能。

嘘发布于 2026/3/27更新于 2026/9/1081 浏览
Ubuntu 本地部署 Dify 详细教程

1 关于 Dify

  • Dify 是一个开源的大语言模型(LLM)应用开发平台;
  • 可以简化和加速生成式 AI 应用的创建和部署;
  • 为开发者提供低代码/无代码的解决方案,同时支持高级定制化需求。

2 Dify 核心功能

  • 多模型支持:

① 支持主流商业模型(如 OpenAI GPT、Claude、DeepSeek、ChatGLM 等)及开源模型(如 Llama、Mistral);
② 提供 模型管理 功能,支持快速切换和自定义接入。

  • 应用类型:

聊天助手:多轮对话交互(如客服机器人);
文本生成:自动化创作、翻译、摘要等;
Agent:任务分解、工具调用(如数据分析、API 集成);
工作流:可视化编排复杂流程(如条件分支、多节点任务)。

  • 关键技术组件:

RAG(检索增强生成):
① 支持文档上传、分块、向量化索引(如 PDF、Notion 同步);
② 提供混合检索(向量 + 全文搜索)和重排序优化。

Agent 框架:
① 支持 Function Calling 和 ReAct 推理模式,集成工具(如搜索、代码执行)。

  • 低代码开发:

① 通过可视化界面编排 Prompt、上下文和插件,无需深入编码;
② 提供模块化设计,如拖拽式工作流构建。

3 访问和使用

  • 详见 Dify 官方文档;

4 dify 部署

  • 在 Ubuntu 上本地部署 Dify 可以按照多种方式,以下是通过 Docker Compose 进行部署的步骤,这是官方推荐的简单部署方式:

4.1 前提条件

  • 确保已安装 Docker 和 Docker Compose;
  • 推荐配置:2GB 以上内存,4 核 CPU。

4.2 安装 Docker 和 Docker Compose

# 安装 Docker
sudo apt update
sudo apt install -y docker.io
# 启动 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker
# 安装 Docker Compose
sudo apt install -y docker-compose
# 将当前用户添加到 docker 组(避免每次使用 sudo)
sudo usermod -aG docker $USER

4.3 获取 Dify 源码

# 克隆 Dify 仓库
git clone https://github.com/langgenius/dify.git

在这里插入图片描述

4.4 配置环境变量

  • 进入到如下目录:
cd dify/docker

在这里插入图片描述

# 复制环境变量示例文件
cp .env.example .env

4.5 docker 卸载

如果需要,请卸载,如果不需要请跳过。

# 卸载现有 Docker
sudo apt purge -y docker.io docker-compose
sudo rm -rf /var/lib/docker /var/lib/containerd

4.6 docker 安装

4.6.1 docker 安装
# 重新安装
sudo apt update
sudo apt install -y docker.io docker-compose
# 启动服务
sudo systemctl start containerd
sudo systemctl start docker
# 将当前用户添加到 docker 组(避免每次使用 sudo)
sudo usermod -aG docker $USER
4.6.2 docker 镜像源修改
  • 打开 Docker 的配置文件:
sudo vim /etc/docker/daemon.json
  • 添加镜像加速配置(推荐使用多个):
{"registry-mirrors":["https://docker.xuanyuan.me","https://docker.1ms.run"]}
  • 重启 Docker 服务:
sudo systemctl daemon-reload
sudo systemctl restart docker
  • 验证是否生效:
docker info | grep -A 10-i registry
4.6.3 docker 仍无法启动排查
  • 执行以下命令清理可能遗留的 PID 文件:
sudo pkill dockerd
sudo rm -f /var/run/docker.pid
sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl restart docker
  • 镜像拉取仍访问 registry-1.docker.io?

检查是否有镜像路径写死在 docker-compose.yaml 文件中;
使用 sed 批量替换镜像地址(仅适用于明文配置):

sed -i 's#registry-1.docker.io#docker.xuanyuan.me#g' docker-compose.yaml
  • 测试镜像源是否能访问:
docker pull docker.xuanyuan.me/library/redis:6-alpine
docker pull docker.1ms.run/library/nginx:alpine
4.6.4 常见国内镜像源

玄元云:https://docker.xuanyuan.me
1ms:https://docker.1ms.run
阿里云:登录 阿里云容器镜像服务 获取;
清华大学:https://docker.tuna.tsinghua.edu.cn;
中科大:https://docker.mirrors.ustc.edu.cn

4.7 启动服务

# 启动所有服务
docker-compose up -d
# 查看服务状态
docker-compose ps

在这里插入图片描述

5 访问 Dify

部署完成后,通过浏览器访问:http://localhost/apps;

在这里插入图片描述

6 初始化管理员账号

首次访问时,系统会引导创建管理员账号,按照提示完成设置即可。

在这里插入图片描述

常用命令: 停止服务:docker-compose down 查看日志:docker-compose logs -f 重启服务:docker-compose restart

目录

  1. 1 关于 Dify
  2. 2 Dify 核心功能
  3. 3 访问和使用
  4. 4 dify 部署
  5. 4.1 前提条件
  6. 4.2 安装 Docker 和 Docker Compose
  7. 安装 Docker
  8. 启动 Docker 服务
  9. 安装 Docker Compose
  10. 将当前用户添加到 docker 组(避免每次使用 sudo)
  11. 4.3 获取 Dify 源码
  12. 克隆 Dify 仓库
  13. 4.4 配置环境变量
  14. 复制环境变量示例文件
  15. 4.5 docker 卸载
  16. 卸载现有 Docker
  17. 4.6 docker 安装
  18. 4.6.1 docker 安装
  19. 重新安装
  20. 启动服务
  21. 将当前用户添加到 docker 组(避免每次使用 sudo)
  22. 4.6.2 docker 镜像源修改
  23. 4.6.3 docker 仍无法启动排查
  24. 4.6.4 常见国内镜像源
  25. 4.7 启动服务
  26. 启动所有服务
  27. 查看服务状态
  28. 5 访问 Dify
  29. 6 初始化管理员账号

更多推荐文章

查看全部
  • Gitea 本地部署与常用 Git 命令实战指南
  • Vivado 工程版本管理实战:Git 配置与重建指南
  • 基于SpringBoot的流浪动物救助收养系统
  • 使用 OpenClaw 与飞书构建自动化服务器运维机器人
  • 命令行大模型交互工具 MCPHost 使用指南
  • 用 AI 辅助解析 B 站充电视频页面结构与鉴权逻辑
  • HeartMuLa 音乐创作工具本地部署指南
  • Trae 内置 GitHub 扩展授权问题及解决方案
  • Python itertools pairwise 函数详解
  • Vivado 许可证获取与配置指南
  • LangChain 快速上手指南:核心组件与实战应用
  • 安卓陀螺仪开发笔记:从角速度到角度积分
  • PIL 读取图片及 numpy 与 tensor 格式转换详解
  • GitNexus:零服务器代码智能引擎,为 AI Agent 构建代码库知识图谱
  • RabbitMQ 事务机制详解:Spring AMQP 配置与问题排查
  • LLaMA-Factory 微调多模态大模型 Qwen3-VL
  • AnythingLLM:零成本搭建私人 ChatGPT,支持主流大模型
  • 低空经济下无人机光伏巡检技术与应用
  • WebMCP:浏览器原生 AI 交互新范式
  • 本地部署 Llama3 8B/70B 大模型完整指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online