Dify Enterprise Edition 部署指南（AWS）

为确保顺利部署 Dify 企业版，请按照以下基础设施与配置说明进行操作。

一、基础设施要求

需要权限的 AWS 服务：

S3
ECR

支持的认证方式：

Dify 支持以下两种方式访问 AWS 服务：

Access Key 模式（AK/SK）：通过环境变量提供凭证
IRSA 模式：IAM Roles for Service Accounts，实现更安全、精细的权限控制

二、Access Key 模式配置

步骤 1：准备凭证

创建一个只具备 S3 和 ECR 权限的 IAM 用户，获取其 Access Key 和 Secret Key。

步骤 2：创建 Kubernetes Secret

kubectl create secret generic image-repo-secret --from-file=<path to .aws/credentials>

步骤 3：修改 `values.yaml`

persistence:
  type: "s3"
  s3:
    endpoint: "https://s3.{region_code}.amazonaws.com"
    region: "{region_code}"
    bucketName: "your_bucket_name"
    useAwsS3: true
    useAwsManagedIam: false
    accessKey: "{your access key}"
    secretKey: "{your secret key}"

# 新增两个服务：
plugin_daemon:
  enabled: true
  replicas: 1
  apiKey: "dify123456"

plugin_connector:
  apiKey: "dify123456"
  imageRepoSecret: "image-repo-secret"
  imageRepoPrefix: "{account_id}.dkr.ecr.{region}.amazonaws.com/dify-ee"
  imageRepoType: ecr
  ecrRegion: "us-west-2"

步骤 4：配置 `dify_plugin_daemon` 数据库

externalPostgres:
  enabled: true
  address: "rds_address"
  port: "5432"
  credentials:
    plugin_daemon:
      database: "dify_plugin_daemon"
      username: "{user}"
      password: "{password}"
      sslmode: "disable"
    audit:
      database: "audit"
      username: "{user}"
      password: "{password}"
      sslmode: "disable"

步骤 5：升级 Helm Release

helm upgrade dify dify/dify-ee -n default --version 3.0.0

三、IRSA 模式配置

由于企业环境对 Access Key 管控严格，我们推荐使用 AWS Pod Identity (IRSA) 方式来访问资源。

✅ 优势

遵循 AWS 最佳安全实践
可对插件执行环境进行精细化权限管理

🪄 快速配置（推荐）

步骤 1：创建 IAM Role 和 Service Account

前置条件
- 可用的 AWS 区域以及 EKS 集群
- 已存在的 S3 Bucket 用于 Dify 文件存储
- 本地已安装并配置好 kubectl，可访问目标 EKS 集群
- 本地已安装 AWS CLI 并配置好凭证

🚀 方案 A：运行一键脚本

‼️ 一键脚本仅用于演示和测试，请根据自己的安全要求编写生产脚本。可向 Dify FDE 团队获取此演示脚本。

./irsa_one_click.sh

🔨 方案 B：手动配置

为 EKS 集群启用 IAM OIDC Provider 请参考 AWS 官方文档，将 EKS 集群与 OIDC 身份提供者关联。此步骤是使用 IRSA 的前提。

创建 IAM Policy

项目	示例命名	描述
S3 Policy 名称	`dify-ee-irsa-<cluster_name>-s3-policy`	对指定 S3 Bucket 具有完全访问权限
ECR Policy 名称	`dify-ee-irsa-<cluster_name>-ecr-policy`	对 ECR 完全访问权限及对 CloudTrail 只读权限
ECR Policy 名称	`dify-ee-irsa-<cluster_name>-ecr-pull-only-policy`	仅允许从 ECR 拉取镜像

创建关联 Policy 的 IAM Role

项目	示例命名	policy
IAM Role - S3	`DifyEE-Role-<cluster_name>-s3`	`dify-ee-irsa-<cluster_name>-s3-policy`
IAM Role - S3 + ECR	`DifyEE-Role-<cluster_name>-s3-ecr`	`dify-ee-irsa-<cluster_name>-s3-policy` 和 `dify-ee-irsa-<cluster_name>-ecr-policy`
IAM Role - ECR Pull-only	`DifyEE-Role-<cluster_name>-ecr-image-pull`	`dify-ee-irsa-<cluster_name>-ecr-pull-only-policy`

为 IAM Role 创建 ServiceAccount

用途	默认名称	绑定 IAM Role	描述
dify-api、dify-worker 使用	dify-api-sa	`DifyEE-Role-<cluster_name>-s3`	后端服务访问 S3，例如文件上传等
dify-plugin-crd 镜像构建使用	dify-plugin-crd-sa	`DifyEE-Role-<cluster_name>-s3-ecr`	访问 S3 并操作插件镜像仓库
dify-plugin 运行时使用	dify-plugin-runner-sa	`DifyEE-Role-<cluster_name>-ecr-image-pull`	用于拉取插件运行所需镜像

步骤 2：设置环境变量

根据版本发布说明配置所需变量（如 S3_REGION、S3_BUCKET_NAME 等）。

步骤 3：修改 `values.yaml`

persistence:
  type: "s3"
  s3:
    endpoint: "https://s3.{region_code}.amazonaws.com"
    region: "{region_code}"
    bucketName: "your_bucket_name"
    useAwsS3: true
    useAwsManagedIam: true

api:
  enabled: true
  replicas: 1
  innerApi:
    enabled: true
    apiKey: "dify123456"
  serviceAccountName: "dify-api-sa"

worker:
  enabled: true
  replicas: 1
  serviceAccountName: "dify-api-sa"

plugin_daemon:
  enabled: true
  replicas: 1
  apiKey: "dify123456"

plugin_connector:
  apiKey: "dify123456"
  customServiceAccount: "dify-plugin-build-sa"
  runnerServiceAccount: "dify-plugin-build-run-sa"
  imageRepoPrefix: "{account_id}.dkr.ecr.{region}.amazonaws.com/dify-ee"
  imageRepoType: ecr
  ecrRegion: "us-west-2"

步骤 4：添加插件数据库配置

externalPostgres:
  enabled: true
  address: "rds_address"
  port: "5432"
  credentials:
    plugin_daemon:
      database: "dify_plugin_daemon"
      username: "{user}"
      password: "{password}"
      sslmode: "disable"
    audit:
      database: "audit"
      username: "{user}"
      password: "{password}"
      sslmode: "disable"

步骤 5：根据发布日志升级（安装）

https://langgenius.github.io/dify-helm/#/pages/3_0_0

步骤 6：给应用自建的 ServiceAccount 增加 S3 权限

ServiceAccount 名称：dify-plugin-connector-sa

kubesctl annotate serviceaccount -n {namespace} dify-plugin-connector-sa eks.amazonaws.com/role-arn={arn_of_IAM_S3}

如果你使用./irsa_one_click.sh 创建了 s3 读写的角色，这个 arn 会出现在脚本执行的末尾。

步骤7：重启 Dify Deamon Pod

kubectl delete pod {dify-plugin-daemon_name}

注意事项

❌ 不支持 Redis Cluster 模式
🌐 EKS 节点需能访问互联网或配置 NAT Gateway

环境部署

高级配置

云基础设施

AWS 部署指南

Dify Enterprise Edition 部署指南（AWS）

一、基础设施要求

需要权限的 AWS 服务：

支持的认证方式：

二、Access Key 模式配置

步骤 1：准备凭证

步骤 2：创建 Kubernetes Secret

步骤 3：修改 `values.yaml`

步骤 4：配置 `dify_plugin_daemon` 数据库

步骤 5：升级 Helm Release

三、IRSA 模式配置

✅ 优势

🪄 快速配置（推荐）

步骤 1：创建 IAM Role 和 Service Account

前置条件

🚀 方案 A：运行一键脚本

🔨 方案 B：手动配置

步骤 2：设置环境变量

步骤 3：修改 `values.yaml`

步骤 4：添加插件数据库配置

步骤 5：根据发布日志升级（安装）

步骤 6：给应用自建的 ServiceAccount 增加 S3 权限

步骤7：重启 Dify Deamon Pod

注意事项

​Dify Enterprise Edition 部署指南（AWS）

​一、基础设施要求

​需要权限的 AWS 服务：

​支持的认证方式：

​二、Access Key 模式配置

​步骤 1：准备凭证

​步骤 2：创建 Kubernetes Secret

​步骤 3：修改 values.yaml

​步骤 4：配置 dify_plugin_daemon 数据库

​步骤 5：升级 Helm Release

​三、IRSA 模式配置

​✅ 优势

​🪄 快速配置（推荐）

​步骤 1：创建 IAM Role 和 Service Account

前置条件

🚀 方案 A：运行一键脚本

🔨 方案 B：手动配置

​步骤 2：设置环境变量

​步骤 3：修改 values.yaml

​步骤 4：添加插件数据库配置

​步骤 5：根据发布日志升级（安装）

​步骤 6：给应用自建的 ServiceAccount 增加 S3 权限

​步骤7：重启 Dify Deamon Pod

​注意事项

Dify Enterprise Edition 部署指南（AWS）

一、基础设施要求

需要权限的 AWS 服务：

支持的认证方式：

二、Access Key 模式配置

步骤 1：准备凭证

步骤 2：创建 Kubernetes Secret

步骤 3：修改 `values.yaml`

步骤 4：配置 `dify_plugin_daemon` 数据库

步骤 5：升级 Helm Release

三、IRSA 模式配置

✅ 优势

🪄 快速配置（推荐）

步骤 1：创建 IAM Role 和 Service Account

步骤 2：设置环境变量

步骤 3：修改 `values.yaml`

步骤 4：添加插件数据库配置

步骤 5：根据发布日志升级（安装）

步骤 6：给应用自建的 ServiceAccount 增加 S3 权限

步骤7：重启 Dify Deamon Pod

注意事项