Skip to main content

本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。

Tip

常见部署问题，详见 常见问题解答。

部署前准备#

确保机器满足以下最低系统要求。

硬件#

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

软件#

操作系统所需软件说明
macOS 10.14 或更高版本Docker Desktop（含 Docker Compose 2.24.0+）Docker 虚拟机至少配置 2 个虚拟 CPU 和 8 GiB 内存。

安装说明详见 Mac 版 Docker Desktop 安装指南。
Linux 发行版Docker 19.03+

Docker Compose 2.24.0+		安装说明详见 Docker 引擎安装指南 和 Docker Compose 安装指南。
Windows（启用 WSL 2）Docker Desktop（含 Docker Compose 2.24.0+）源代码和绑定到 Linux 容器的数据建议存储在 Linux 文件系统中，而非 Windows。

安装说明详见 Windows 版 Docker Desktop 安装指南。

部署并启动#

克隆 Dify

克隆 Dify 源代码到本地机器。

Info

此命令需要 git、curl 和 jq。如提示 command not found，安装缺少的工具后重新运行命令。

报 fatal: Remote branch null not found in upstream origin 错误时，改用显式版本号重试，最新版本号见 Dify releases：

详见 克隆报错「Remote branch null not found」。

启动 Dify

  1. 进入 Dify 源代码中的 docker 目录：

  2. 复制必要的环境配置文件：

    如需自定义部署，参见 自定义。

  3. 启动容器：

    Note

    Dify 需要 Docker Compose 2.24.0 或更高版本。运行 docker compose version 确认版本。

    启动以下容器：

    • 7 个核心服务：api、api_websocket、worker、worker_beat、web、plugin_daemon、agent_backend
    • 8 个依赖组件：weaviate、db_postgres、redis、nginx、ssrf_proxy、agent_ssrf_proxy、sandbox、local_sandbox
    • 1 个一次性任务：init_permissions，用于设置存储文件权限，完成后自动退出。

  4. 验证所有容器是否成功运行：

    每个容器的状态应为 Up 或 healthy。init_permissions 状态显示为 Exited 是正常的。

访问#

  1. 打开管理员初始化页面，设置管理员账户：

  2. 完成管理员账户设置后，在以下地址登录 Dify：

自定义#

如需自定义部署，编辑相关文件中的环境变量，然后重启 Dify。

编辑环境变量

  • 必要的启动值 位于 docker/.env 文件中（部署时从 docker/.env.example 复制创建）。直接编辑即可。

  • 可选或特定提供商的设置 在 docker/envs/ 下有对应模板。要覆盖默认值，复制相应模板（去掉 .example 后缀），然后编辑副本。

    例如：

docker/.env 中的值优先于任何 docker/envs/*.env 文件中的值。

Tip

所有变量的说明，详见 环境变量。

重启 Dify

升级#

不同版本的升级步骤可能有所不同。详见 Releases 页面中提供的目标版本升级指南。

Note

升级后，对照各 .env.example 文件检查对应的 .env，确认是否有新增或变更的变量。

若你自定义过 docker-compose.yaml，请把自定义内容重新应用到新版本的文件上，而不是沿用旧文件。新版本可能新增 Dify 运行所需的服务。