跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI算法

Docker 部署 Dify 平台搭建可视化 LLM 应用环境

综述由AI生成Dify 是一款开源的大语言模型应用开发平台,融合了 BaaS 和 LLM Ops 理念。在本地或服务器通过 Docker Compose 快速部署 Dify 的步骤,涵盖环境准备、代码克隆、容器启动、配置更新及基础使用。内容包含必要的硬件要求、Docker 命令操作、环境变量配置说明、版本更新方法以及常见问题排查指南,帮助开发者构建私有化大模型应用环境。

灵魂摆渡发布于 2025/2/7更新于 2026/5/3116 浏览
Docker 部署 Dify 平台搭建可视化 LLM 应用环境

Docker 部署 Dify 平台搭建可视化 LLM 应用环境

1. 关于 Dify

Dify 是一款开源的大语言模型(LLM)应用开发平台。它融合了后端即服务(Backend as a Service)和 LLM Ops 的理念,使开发者可以快速搭建生产级的生成式 AI 应用。即使是非技术人员,也能参与到 AI 应用的定义和数据运营过程中。

Dify 内置了构建 LLM 应用所需的关键技术栈,包括对数百个模型的支持、直观的 Prompt 编排界面、高质量的 RAG 引擎、稳健的 Agent 框架、灵活的流程编排,并同时提供了一套易用的界面和 API。这为开发者节省了许多重复造轮子的时间,使其可以专注在创新和业务需求上。

与 LangChain 这类开发库相比,Dify 提供了更接近生产需要的完整方案。它好比是一套脚手架,经过了精良的工程设计和软件测试。重要的是,Dify 是开源的,由专业团队和社区共同打造。你可以基于任何模型自部署类似 Assistants API 和 GPTs 的能力,在灵活和安全的基础上,同时保持对数据的完全控制。

2. 前提条件

Dify 可以在运行 Docker 环境的 Windows、macOS、Linux 等电脑中部署。安装 Dify 之前,请确保你的机器已满足最低安装要求:

  • CPU >= 2 Core
  • RAM >= 4 GiB
  • 磁盘空间 >= 20 GB

此外,操作系统还需要安装好 Docker 环境,不同 OS 所需的软件如下:

操作系统软件描述
macOSDocker Desktop为 Docker 虚拟机(VM)至少分配 2 个虚拟 CPU(vCPU) 和 8GB 初始内存,否则安装可能会失败。
LinuxDocker 19.03 or later, Docker Compose 1.28 or later需确保 Docker Compose 插件或独立二进制文件可用。
WindowsDocker Desktop (WSL 2)建议将源代码和其他数据绑定到 Linux 容器中时,将其存储在 Linux 文件系统中,而不是 Windows 文件系统中,以获得更好的性能。

3. 部署过程

3.1 克隆代码仓库

从 GitHub 克隆 Dify 源代码至本地环境。

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

3.2 配置环境变量

复制环境配置文件并修改必要参数。

cp .env.example .env

重要提示:在生产环境中,请务必修改 .env 文件中的默认密码和密钥,特别是 DB_PASSWORD、REDIS_PASSWORD 和 SECRET_KEY。

3.3 启动容器

根据系统上的 Docker Compose 版本,选择合适的命令来启动容器。可以通过 docker compose version 检查版本。

如果版本是 Docker Compose V2,使用以下命令:

docker compose up -d

如果版本是 Docker Compose V1,使用以下命令:

docker-compose up -d

运行命令后,你应该会看到类似以下的输出,显示所有容器的状态和端口映射:

[+] Running 11/11
 ✔ Network docker_ssrf_proxy_network  Created
 ✔ Network docker_default             Created
 ✔ Container docker-redis-1           Started
 ✔ Container docker-ssrf_proxy-1      Started
 ✔ Container docker-sandbox-1         Started
 ✔ Container docker-web-1             Started
 ✔ Container docker-weaviate-1        Started
 ✔ Container docker-db-1              Started
 ✔ Container docker-api-1             Started
 ✔ Container docker-worker-1          Started
 ✔ Container docker-nginx-1           Started

最后检查是否所有容器都正常运行:

docker compose ps

在这个输出中,你应该可以看到包括 3 个业务服务(api / worker / web),以及 6 个基础组件(weaviate / db / redis / nginx / ssrf_proxy / sandbox)。

4. 常用配置说明

为了适应不同的网络环境和安全需求,建议关注以下关键配置项:

  • APP_SECRET_KEY: 用于加密敏感信息,建议设置为随机字符串。
  • CONSOLE_API_URL: 控制台 API 访问地址,默认为 http://localhost:5001。
  • WEBAPP_API_URL: Web 端 API 访问地址,默认为 http://localhost:5001。
  • DB_USERNAME/DB_PASSWORD: 数据库账号密码,切勿使用默认值。
  • WEAVIATE_ENDPOINT: Weaviate 向量数据库连接地址。

5. 更新 Dify

当 Dify 版本更新后,可以通过命令行更新已经部署的 Dify 环境。

进入 dify 源代码的 docker 目录,按顺序执行以下命令:

cd dify/docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d

执行上述命令更新完成后,需按以下操作同步环境变量配置(重要!)。

如果 .env.example 文件有更新,请务必同步修改您本地的 .env 文件。检查 .env 文件中的所有配置项,确保它们与您的实际运行环境相匹配。您可能需要将 .env.example 中的新变量添加到 .env 文件中,并更新已更改的任何值。

6. 使用 Dify

按照以上步骤部署好 Dify 后,首先前往管理员初始化页面设置管理员账户:

# 本地环境
http://localhost/install

# 服务器环境
http://your_server_ip/install

可以打开以下地址访问 Dify 主页面:

# 本地环境
http://localhost

# 服务器环境
http://your_server_ip

7. 常见问题排查

7.1 容器无法启动

如果部分容器状态为 Exited,请查看日志定位问题:

docker logs docker-db-1
docker logs docker-api-1

常见原因包括端口冲突、内存不足或权限问题。确保宿主机 80、443、5432、6379 等端口未被占用。

7.2 连接外部模型

Dify 支持接入多种大模型。在管理后台的「模型提供商」中,可以选择 OpenAI、Azure、Ollama 等接口。对于私有化部署,推荐使用 Ollama 运行本地模型,通过配置 OLLAMA_BASE_URL 实现本地推理。

8. 总结

通过私有化本地部署 Dify,结合 Ollama 等大模型运行环境,可以打造自己的私有大模型工具链,实现大模型的本地可视化运行。在涉密或敏感数据场合具有极大的应用价值。

目录

  1. Docker 部署 Dify 平台搭建可视化 LLM 应用环境
  2. 1. 关于 Dify
  3. 2. 前提条件
  4. 3. 部署过程
  5. 3.1 克隆代码仓库
  6. 3.2 配置环境变量
  7. 3.3 启动容器
  8. 4. 常用配置说明
  9. 5. 更新 Dify
  10. 6. 使用 Dify
  11. 本地环境
  12. 服务器环境
  13. 本地环境
  14. 服务器环境
  15. 7. 常见问题排查
  16. 7.1 容器无法启动
  17. 7.2 连接外部模型
  18. 8. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • GLM-5 与 Qwen3.5 双模型对比:一句话生成 HTML 小游戏
  • ES6 核心语法全解析:let/const、箭头函数、异步处理
  • 闲鱼 x-sign 生成算法逆向分析
  • CTF Web 命令执行实战:从基础注入到高级绕过技巧
  • Linux 下 libwebkit2gtk-4.1-0 安装与配置指南
  • 使用 CLIProxyAPI 和 New API 搭建统一 AI 中转站实战
  • Qwen-Image-Edit-2511-Multiple-Angles LoRA 多角度 AI 图像生成指南
  • 小米智能家居 Miloco 分离式部署实战
  • TrendRadar 本地部署指南:Docker 配置、AI 模型接入与 MCP 服务对接
  • VSCode 集成 GitHub Copilot 插件使用指南
  • Python 3.12 下载与安装配置指南
  • 使用 Ollama 本地部署 LLaMA 大模型
  • Windows 下 MySQL 安装与使用教程
  • 软体机器人动作捕捉系统:6 大主流方案深度测评与选型指南
  • MAC M1 本地部署 Llama.cpp 与通义千问 Qwen 1.5-7B 实践指南
  • 大模型多 GPU 分布式训练并行策略详解与选择指南
  • 离散 PR 控制器原理、C 语言实现及逆变闭环验证
  • ESP-Drone 开源无人机开发入门指南
  • 青海少年 AI 农业创业:基于 ViT 的病虫害检测系统
  • 前端 JS 加载失败处理方案:重试与多源备份

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • Base64 字符串编码/解码

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