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

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

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

灵魂摆渡发布于 2025/2/7更新于 2026/7/2339 浏览
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. 总结
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 深入解析大语言模型(LLM)的 AI 幻觉成因与治理方案
  • Vue 3 开发实战:10 个提升效率的核心技巧
  • Stable Diffusion XL 文生图模型结构与部署解析
  • LLaMA 大模型本地部署与调用指南
  • 三维人体姿态估计前沿算法与论文案例
  • OpenClaw 在 macOS 和 Windows 上的安装与配置
  • CleanShot X Mac 截图录屏及 GIF 录制完整指南
  • RTX 4090 本地部署腾讯混元与阿里通义万相视频模型
  • Flutter WalletConnect 鸿蒙化适配:Web3 钱包连接与 DApp 授权
  • Python 环境管理对比:uv 与 conda 的核心差异与选型指南
  • 基于无人机遥感的植被覆盖度测量实践
  • AI 时代如何脱颖而出:商业认知与行动指南
  • 【异常】飞书OpenClaw机器人 HTTP 401: Invalid Authentication 报错排查与解决方案
  • Dart 设计模式:单例模式
  • 10 款开源 AI 视频工具:免配置开箱即用
  • C++ 线程库与多线程编程核心机制解析
  • Python heapq 入门与实战:最小堆、Top-K 和优先队列
  • C++入门基础:逐步剖析核心语法
  • 大模型浪潮:是泡沫还是技术革命?
  • Claude Code 安装配置与实战教程

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如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