​
环境要求

  • Docker
  • Docker Compose
  • Linux 服务器
    • Docker Desktop 不支持在 Windows 和 Mac 上使用。
    • 最低配置：4 核 CPU，16 GB 内存，100 GB 磁盘空间。

​
快速开始

​
下载

从 Dify Enterprise 官方发布页面 下载指定版本。请将 <version> 替换为你需要下载的具体版本号，例如 1.0.0。

使用 wget：

wget https://langgenius.github.io/dify-enterprise-docker-compose/dify-docker-compose-<version>.tgz

使用 curl：

curl -O https://langgenius.github.io/dify-enterprise-docker-compose/dify-docker-compose-<version>.tgz

​
安装步骤

  1. 将下载的压缩包解压至部署目录。

    mkdir dify-enterprise
tar -xzf dify-docker-compose-<version>.tgz -C ./dify-enterprise/

  2. 启动 docker compose。

    cd dify-enterprise
docker compose up -d

  3. 访问 Dify Enterprise 的方法。

  4. 验证 Dify 服务状态（用于检查 Dify Enterprise 的各项服务是否正常运行）。

  5. 激活许可证（用于激活 Dify Enterprise 的许可证）。

​
从社区版升级

  1. 创建企业版数据库（需确保社区版已启动）。

    docker exec -it dify-db-1 psql -U postgres -c "CREATE DATABASE enterprise;"

    提示： 建议根据实际运行的容器名称进行调整。使用 docker container ls 找到 db 服务的名称。

  2. 关闭社区版。

    docker compose down

  3. 备份你的数据和设置（根据你的系统配置，可能需要使用 sudo 命令）。

    tar -czf backup.tgz volumes .env # 如果还有其他自定义文件和文件夹，请自行添加。

  4. 保留 backup.tgz 和 dify-docker-compose-<version>.tgz 文件，删除其余所有社区版文件和文件夹。

  5. 将下载的压缩包解压到你的部署目录。

    tar -xzf dify-docker-compose-<version>.tgz -C /path/to/directory

  6. 恢复你的备份，为了避免冲突，先删除 volumes 文件夹。

    rm -rf volumes

    然后运行：

    tar -xzf backup.tgz

  7. 如果存在自定义配置文件（如 docker-compose.yaml、ssrf_proxy/squid.conf 或 nginx/conf.d/default.conf），请根据需要更新这些文件，以确保配置一致。

  8. 启动 docker compose。

    docker compose up -d

  9. 访问 Dify Enterprise 的方法。

  10. 验证 Dify 服务状态（用于检查 Dify Enterprise 的各项服务是否正常运行）。

  11. 激活许可证（用于激活 Dify Enterprise 的许可证）。

​
从之前的企业版升级

  1. 备份你的数据和设置（根据你的系统配置，可能需要使用 sudo 命令）。

    tar -czf backup.tgz volumes .env # 如果还有其他自定义文件和文件夹，请添加

  2. 删除旧版本的所有文件和文件夹，除了 backup.tgz 和 dify-docker-compose-<version>.tgz。

  3. 将下载的压缩包解压到你的部署目录。

    tar -xzf dify-docker-compose-<version>.tgz -C /path/to/directory

  4. 恢复你的备份，为了避免冲突，先删除 volumes 文件夹。

    rm -rf volumes

    然后运行：

    tar -xzf backup.tgz

  5. 如果存在自定义配置文件（如 docker-compose.yaml、ssrf_proxy/squid.conf 或 nginx/conf.d/default.conf），请根据需要更新这些文件，以确保配置一致。

  6. 启动 docker compose。

    docker compose up -d

​
高级配置

​
访问 Dify Enterprise 的方法

要访问 Dify Enterprise，需要将域名指向服务器的 IP 地址。你需要修改本地机器上的 hosts 文件，该文件通常位于 /etc/hosts (Linux/macOS) 或 C:\Windows\System32\drivers\etc\hosts (Windows)。添加以下条目：

4.152.1.216 console.dify.local
4.152.1.216 app.dify.local
4.152.1.216 api.dify.local
4.152.1.216 upload.dify.local
4.152.1.216 enterprise.dify.local

​
域名要求

Dify Enterprise 需要设置 5 个域名。这些域名是：

  • 控制台：console.dify.local
  • 服务 API：api.dify.local
  • APP：app.dify.local
  • 文件：upload.dify.local
  • 企业版管理后台：enterprise.dify.local

若需更改这些设置，可将相关配置添加至你的部署目录中的 .env 文件。

# .env

CONSOLE_API_URL="http://console.dify.local"
CONSOLE_WEB_URL="http://console.dify.local"
SERVICE_API_URL="http://api.dify.local"
APP_API_URL="http://app.dify.local"
APP_WEB_URL="http://app.dify.local"
FILES_URL="http://upload.dify.local"
ENTERPRISE_URL="http://enterprise.dify.local"

​
持久化存储

默认情况下，企业版采用本地磁盘作为存储介质。若需更改此设置，可将相关配置添加至你的部署目录中的 .env 文件。例如使用 AWS S3：

# .env

STORAGE_TYPE=s3

S3_USE_AWS_MANAGED_IAM=
S3_ENDPOINT=
S3_REGION=
S3_BUCKET_NAME=
S3_ACCESS_KEY=
S3_SECRET_KEY=

有关其他存储选项的配置，请参考文件存储配置。

​
Postgres 数据库

若需更改此设置，可将相关配置添加至你的部署目录中的 .env 文件。

# .env

DB_USERNAME=postgres
DB_PASSWORD=difyai123456
DB_HOST=db
DB_PORT=5432
DB_DATABASE=dify

有关其他数据库的配置，请参考数据库配置。

​
Redis 数据库

若需更改此设置，可将相关配置添加至你的部署目录中的 .env 文件。

# .env

REDIS_HOST=redis
REDIS_PORT=6379
REDIS_USERNAME=
REDIS_PASSWORD=difyai123456
REDIS_USE_SSL=false
REDIS_DB=0

有关 Redis 的其他配置，请参考 Redis 配置。

​
向量数据库

默认情况下，企业版使用 Weaviate 作为向量数据库。若需更改此设置，可将相关配置添加至你的部署目录中的 .env 文件。例如，要使用 Qdrant：

# .env

VECTOR_STORE=qdrant

QDRANT_URL=http://qdrant:6333
QDRANT_API_KEY=difyai123456
QDRANT_CLIENT_TIMEOUT=20
QDRANT_GRPC_ENABLED=false
QDRANT_GRPC_PORT=6334

有关其他向量数据库的配置，请参考向量数据库配置。

​
其它配置

如需了解更多信息，请参考环境变量说明。