跳到主内容

Dify 部署教程:Docker Compose、RAG 与 AI 工作流

版本 以官网当前版本为准(以官网为准)

环境要求、启动与初始化

源码、Compose 与版本记录

多租户、品牌与商业条件

无需自托管的官方云服务

Dify 是构建 AI 应用、RAG 和智能体工作流的 Web 平台,可用官方云服务或自行部署 Community Edition。它不是桌面安装包;官方自托管方式是 Docker Compose,模型需连接云端或私有推理服务。

Dify Docker 部署与模型知识库配置步骤示意图
Dify 自托管前应准备 Docker 和持久化存储,部署后再配置模型与知识库。

部署前需要什么

官方最低参考是 2 核 CPU、4GiB 内存;Docker Desktop 文档建议至少分配 2 个 vCPU 和 8GiB 内存。生产容量还要考虑文档解析、向量库、Worker 和插件。

为什么不是一个容器

Dify Compose 会启动 Web、API、Worker、PostgreSQL、Redis、向量库、Nginx、插件、沙箱和 SSRF 代理等组件。迁移时必须覆盖各服务的数据卷和依赖。

首次安装的正确顺序

  • 从 langgenius/dify 获取与文档匹配的版本,检查 Compose 要求。
  • 审查 docker/.env.example,替换应用密钥、数据库密码和外部凭据。
  • 先在本机或内网启动,通过 /install 创建首个管理员。
  • 确认登录、模型与工作流后,再配置域名、HTTPS 和防火墙。

模型与 RAG 数据会去哪里

自托管不等于内容都留在服务器:连接云端 LLM、嵌入、重排或 OCR 后,提示词和文档片段会发送给提供方。知识库的原文件、解析结果和向量也存放在不同组件中。

工作流和插件安全

  • 保留代码沙箱和 SSRF 防护,不为排错关闭隔离。
  • 插件和工具只授予必要的网络、文件与账号凭据。
  • 公开接口设置认证、速率限制、预算和日志脱敏。
  • 管理员、编辑者和知识库成员按最小权限分配。

备份与升级

备份 PostgreSQL、向量库、上传文件、插件数据和配置,并测试恢复。升级前阅读迁移说明并保留镜像标签,不直接跟随 main。

许可证限制

Dify 使用修改版 Apache-2.0 许可证。未经书面授权不得用源码运营多租户环境,也不能移除或修改前端 LOGO 和版权信息。SaaS、多工作区或换品牌项目应核对 LICENSE。

部署结论

个人试用可选 Dify Cloud;本地测试用官方 Compose;正式上线补齐密钥、HTTPS、权限、预算、备份和升级方案,同时审查模型数据流与许可证。

反馈页面信息

请描述需要更正的地方,页面标题和网址会自动附上。

也可以发邮件至 [email protected]