使用 Docker Compose 部署 Dify - Dify Docs

简介

《使用 Docker Compose 部署 Dify》是 Dify 官方文档中的一篇自部署指南，主要介绍如何通过 Docker Compose 在本地或服务器上使用源代码快速部署并启动 Dify 平台。本文档由 AI 自动翻译，常见部署问题可参考常见问题解答。

部署前准备

在部署 Dify 之前，需确保机器满足以下最低系统要求：

硬件

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

软件

主要功能与部署步骤

部署并启动

1. 克隆 Dify：使用命令将 Dify 源代码克隆到本地（需 git、curl 和 jq 工具）。
   复制代码

   git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git

2. 启动 Dify：
   • 进入 dify/docker 目录；
   • 复制环境配置文件：cp .env.example .env；
   • 使用 docker compose up -d 启动容器（需 Docker Compose 2.24.0+）。
   • 启动的容器包括：6 个核心服务（api、api_websocket、worker、worker_beat、web、plugin_daemon）、6 个依赖组件（weaviate、db_postgres、redis、nginx、ssrf_proxy、sandbox）以及 1 个一次性任务（init_permissions，完成后自动退出属正常）。
   • 可通过 docker compose ps 验证容器状态应为 Up 或 healthy。

访问

• 管理员初始化页面：本地为 http://localhost/install，服务器为 http://your_server_ip/install；
• 设置账户后，登录地址：本地为 http://localhost，服务器为 http://your_server_ip。

自定义

• 编辑 docker/.env（必要启动值）或 docker/envs/ 下对应模板副本（可选设置）中的环境变量，其中 .env 中的值优先于 envs/*.env；
• 修改后执行 docker compose down 与 docker compose up -d 重启。

升级

不同版本升级步骤可能不同，需参考 Releases 页面的目标版本升级指南，并对照 .env.example 检查 .env 变量变更。

适用场景

本文档适用于希望在 macOS、Linux 或 Windows（WSL 2）环境下，通过 Docker Compose 自托管部署 Dify 的开发者或运维人员，可用于快速搭建本地开发环境或私有化服务器部署。