Skip to main content

​
要求

​
快速开始

​
下载

你可以从 Dify Enterprise 的 仓库 中下载特定版本。 使用 wget：
使用 curl：

​
安装步骤

  1. 解压下载的文件到你的部署目录：
  2. 复制环境变量模板，然后启动 Docker Compose：
  3. 如何访问 Dify Enterprise
    • 获取服务器的 IP，并在本地修改 hosts 文件，将域名指向该 IP，例如：
  4. 验证服务状态
  5. 激活许可证

​
从社区版升级

3.10 重构了环境变量配置：原先单一的 .env.example 现已拆分为精简的 .env.example 加上可选的 envs/*.env.example 文件，企业版设置则以激活状态置于 envs/enterprise/ 下。还原你备份的 .env 是安全的：Docker Compose 会 最后 读取 .env，因此你的现有值优先生效，部署无需迁移即可继续工作。如需采用 3.10 的新默认值或新增的变量，可选择将 .env 与新的 .env.example 对齐；随包提供的 dify-env-sync.sh 会执行从 .env.example 到 .env 的单向同步（保留你的自定义值、先行备份，并报告已移除的键）。
  1. 创建企业版数据库（确保社区版正在运行）：
    提示：你可能需要根据实际运行的容器名称做调整，可使用 docker container ls 查看 db 容器名称。
  2. 停止社区版服务：
  3. 备份数据和配置（可能需要 sudo）：
  4. 删除社区版的所有文件和文件夹，仅保留 backup.tgz 和 dify-docker-compose-<version>.tgz
  5. 解压企业版安装包到部署目录：
  6. 恢复备份：先删除 volumes 文件夹
    然后执行：
  7. 如果你有自定义配置（如 docker-compose.yaml、ssrf_proxy/squid.conf、或 nginx/conf.d/default.conf），请手动合并修改。
  8. 启动 Docker Compose：
  9. 如何访问 Dify Enterprise:
    • 获取服务器的 IP，并在本地修改 hosts 文件，将域名指向该 IP，例如：
  10. 验证服务状态
  11. 激活许可证

​
从旧的企业版升级

3.10 重构了环境变量配置：原先单一的 .env.example 现已拆分为精简的 .env.example 加上可选的 envs/*.env.example 文件，企业版设置则以激活状态置于 envs/enterprise/ 下。还原你备份的 .env 是安全的：Docker Compose 会 最后 读取 .env，因此你的现有值优先生效，部署无需迁移即可继续工作。如需采用 3.10 的新默认值或新增的变量，可选择将 .env 与新的 .env.example 对齐；随包提供的 dify-env-sync.sh 会执行从 .env.example 到 .env 的单向同步（保留你的自定义值、先行备份，并报告已移除的键）。
  1. 备份数据和配置（可能需要 sudo）：
  2. 删除旧版的所有文件和文件夹，仅保留 backup.tgz 和 dify-docker-compose-<version>.tgz
  3. 解压新版本文件到部署目录：
  4. 恢复备份：先删除 volumes 文件夹
    然后执行：
  5. 如果你有自定义配置（如 docker-compose.yaml、ssrf_proxy/squid.conf、或 nginx/conf.d/default.conf），请手动合并修改。
  6. 启动 Docker Compose：

​
高级配置

​
配置文件

部署目录中的配置分散在以下几类文件中：
  • .env：你的生效配置。首次启动前请从 .env.example 复制（cp .env.example .env）。所有自定义项都写在这里；Docker Compose 最后 读取该文件，因此 .env 中的值优先级最高，会覆盖其他所有文件。
  • envs/enterprise/*.env：企业版服务配置。随包已激活并自动接入，标准部署无需复制或修改。
  • envs/*.env.example：按主题分组的可选高级配置（数据库、向量库、基础设施等）。如需启用某组，请去掉 .example 后缀复制该文件（例如 cp envs/databases/redis.env.example envs/databases/redis.env）。
对于下文的各项设置，只需将变量加入 .env 即可，它们会覆盖上述文件中的任何默认值。

​
域名要求

Dify Enterprise 要求配置以下 5 个域名：
  • Console: console.dify.local
  • Services API: api.dify.local
  • APP: app.dify.local
  • Files: upload.dify.local
  • Enterprise: enterprise.dify.local
你可以在 .env 文件中配置这些域名：

​
持久化存储配置

默认使用本地存储。如需修改，可在 .env 文件中配置。例如使用 AWS S3：
更多存储选项配置，请参考：文件存储配置指南

​
Postgres 数据库配置

更多数据库配置，请参考：数据库配置指南

​
Redis 数据库配置

更多配置，请参考：Redis 配置指南

​
向量数据库配置

默认使用 Weaviate，如需切换为 Qdrant，可以在 .env 文件中配置如下：
更多向量数据库配置，请参考：向量数据库配置指南

​
更多配置项

请参考官方文档：环境变量说明 获取更多高级配置。