AI 原生开放教材

外观

Dify 中文系统教程（How-to-use-dify）课时教程·中文原文 ↗仓库 ↗

11 自部署 Docker Compose ​

学习目标 ​

你将理解 Dify 自部署的基本流程、最低要求和常见风险。

什么时候需要自部署 ​

考虑自部署的原因：

  • 数据需要留在自己的服务器。
  • 需要更强的网络和权限控制。
  • 需要接入内部模型、数据库或系统。
  • 团队需要统一管理。
  • 有特殊合规要求。

不建议一开始就自部署的情况：

  • 只是学习 Dify。
  • 没有服务器维护经验。
  • 不知道如何备份和升级。
  • 团队还没验证真实需求。

官方最低要求 ​

官方 Docker Compose 快速开始文档中，自部署前的最低硬件要求包括：

  • CPU >= 2 Core。
  • RAM >= 4 GiB。

macOS 使用 Docker Desktop 时，官方建议给 Docker 虚拟机至少 2 个 vCPU 和 8 GiB 内存。Linux 需要 Docker 19.03+ 和 Docker Compose 1.28+。

基础部署流程 ​

官方文档的基本流程是：

  1. 克隆 Dify 源码，建议使用 GitHub 最新 release tag。
  2. 进入 dify/docker 目录。
  3. 复制 .env.example 为 .env。
  4. 使用 Docker Compose 启动。

示例：

bash
git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker compose up -d

会启动哪些服务 ​

官方文档列出的 Docker Compose 启动内容包括核心服务和依赖组件，例如：

  • api
  • worker
  • worker_beat
  • web
  • plugin_daemon
  • weaviate
  • db_postgres
  • redis
  • nginx
  • ssrf_proxy
  • sandbox

实际服务可能随版本变化，请以当前官方 compose 文件为准。

部署后第一件事 ​

不要急着开放公网。先确认：

  • 管理员账号是否创建。
  • 模型供应商是否配置。
  • 文件上传是否正常。
  • 知识库索引是否正常。
  • 插件服务是否正常。
  • 日志是否有错误。

生产注意事项 ​

  • 配置强密码和访问控制。
  • 反向代理启用 HTTPS。
  • 定期备份数据库和上传文件。
  • 记录当前 Dify 版本。
  • 升级前先备份。
  • 不要把测试密钥和生产密钥混用。
  • 限制公网访问管理入口。

常见错误 ​

  • 服务器内存太小。
  • Windows 下把数据放在非 Linux 文件系统导致性能差。
  • .env 没改就直接生产使用。
  • 没有备份就升级。
  • 只备份 compose 文件，没有备份数据库和存储。