环境变量 - Dify Enterprise Docs

Dify 企业版通过 Helm 部署，大多数变量在 values.yaml 文件中配置。Helm chart 会将一组固定变量写入 API、web、worker 和 enterprise 这几个 ConfigMap（默认值取自 values.yaml），其余 Dify 应用变量则通过各服务的 extraEnv 字段暴露。

此处列出的变量仅供参考。Dify 应用读取的变量远多于 Helm chart 直接设置的部分。完整的应用级变量列表见上游 .env.example。任何未在 values.yaml 中设置的变量都可通过 extraEnv 添加（见常见问题）。如果在 values.yaml 中找不到某个变量，通过 extraEnv 设置即可。

标注为 (Helm default) 的默认值是 chart 从 values.yaml 写入 ConfigMap 的值。其余默认值均为 Dify 应用的内置默认值，在变量未通过 extraEnv 设置时生效。

通用变量

以下 URL 变量用于配置 Dify 各服务的公开地址。Helm chart 根据 values.yaml 中的域名设置（global.consoleApiDomain、global.consoleWebDomain 等）推导这些变量，因此通常设置域名即可，无需直接设置变量。

CONSOLE_API_URL

默认值：由 global.consoleApiDomain 推导 Dify 后端 API 的公开 URL。用于构造 OAuth 授权回调（GitHub、Google 登录）、Notion 集成，以及任何需要 OAuth 的插件。同时决定是否使用安全（仅 HTTPS）Cookie。范例：https://api.console.dify.ai

CONSOLE_WEB_URL

默认值：由 global.consoleWebDomain 推导 Dify 控制台前端的公开 URL。用于构造所有系统邮件（邀请、密码重置、通知）中的链接，并在 OAuth 登录后将用户重定向回控制台。当 CONSOLE_CORS_ALLOW_ORIGINS 未设置时，它还作为默认的 CORS 允许来源。范例：https://console.dify.ai

SERVICE_API_URL

默认值：由 global.serviceApiDomain 推导控制台中向开发者展示的 API Base URL，即开发者复制到代码里调用 Dify API 的地址。当服务器可通过多个地址访问时，设置该变量可确保 URL 一致。范例：https://api.dify.ai

APP_API_URL

默认值：由 global.appApiDomain 推导 WebApp 前端（已发布应用）使用的后端 API URL。该变量由 web 前端容器使用，而非 Python 后端。范例：https://api.app.dify.ai

APP_WEB_URL

默认值：由 global.appWebDomain 推导已发布 WebApp 的公开访问 URL。工作流中的 Human Input 节点必须设置此项：邮件通知里的表单链接按 {APP_WEB_URL}/form/{token} 构造。若为空，Human Input 邮件将无法包含有效的表单链接。范例：https://app.dify.ai

TRIGGER_URL

默认值：由 global.triggerDomain 推导 Webhook 和集成触发端点的公开访问 URL。外部系统通过该地址调用你的工作流。Dify 按 {TRIGGER_URL}/triggers/webhook/{id} 构造触发器回调 URL 并在控制台中展示。要让触发器正常工作，此项必须指向外部系统可访问的公开域名或 IP。

FILES_URL

默认值：由 global.filesDomain 推导文件预览与下载链接的基础 URL。Dify 为所有文件（上传的文档、工具输出、工作空间 Logo）生成带签名、有时效的 URL，并提供给前端和多模态模型。为防止伪造，文件 URL 经过签名并会过期（见 FILES_ACCESS_TIMEOUT）。范例：https://upload.example.com

INTERNAL_FILES_URL

默认值：（为空；回退到 FILES_URL）集群内部服务之间通信所用的文件访问 URL（例如插件守护进程和文档提取器）。若外部 FILES_URL 通过 ingress 或公开域名路由，内部服务可能无法访问。当内部服务无法访问外部 URL 时，通过 extraEnv 设置此项。范例：http://dify-api-svc:5001

FILES_ACCESS_TIMEOUT

默认值：300（5 分钟）签名文件 URL 的有效时长（秒）。超过该时间后 URL 会被拒绝，文件需重新请求。长耗时流程可调大；追求更严格的安全性可调小。

服务器配置

日志

Variable	Default	Description
`LOG_LEVEL`	`INFO` (Helm default)	最低日志级别。级别由低到高：`DEBUG`、`INFO`、`WARNING`、`ERROR`、`CRITICAL`。生产环境用 `ERROR` 可减少噪声。
`LOG_OUTPUT_FORMAT`	`json` (Helm default)	`json` 生成适合聚合工具（ELK、Datadog）的结构化日志，`text` 生成可读性更好的文本行。chart 默认 `json`，应用自身默认 `text`。
`LOG_FILE`	`/app/logs/server.log`	日志文件路径。设置后启用基于文件的日志记录并自动轮转；为空时日志仅输出到控制台。
`LOG_FILE_MAX_SIZE`	`20`	触发轮转的日志文件最大体积（MB）。
`LOG_FILE_BACKUP_COUNT`	`5`	保留的轮转日志文件数量。
`LOG_DATEFORMAT`	`%Y-%m-%d %H:%M:%S`	文本格式日志的时间戳格式（strftime 代码）。
`LOG_TZ`	`UTC`	日志时间戳的时区，同时设置 Celery 的任务调度时区。

通用

Variable	Default	Description
`MODE`	`api` / `worker` / `beat` (Helm default)	服务角色。chart 会按 ConfigMap 分别设置，不要覆盖。
`DEBUG`	`false`	启用详细日志：节点输入/输出、工具执行细节、完整的 LLM 提示词与响应。不建议在生产环境使用。
`FLASK_DEBUG`	`false`	标准 Flask 调试标志。Dify 并未实际使用，主要由 `DEBUG` 控制。
`ENABLE_REQUEST_LOGGING`	`false`	为每个 HTTP 请求记录一行简洁的访问日志。在 `LOG_LEVEL=DEBUG` 下，还会记录完整的请求与响应体。
`DEPLOY_ENV`	`PRODUCTION` (Helm default)	在 Sentry 和 OpenTelemetry 中为监控数据打标签，便于按环境过滤。同时作为 `X-Env` 响应头发送。
`MIGRATION_ENABLED`	`true` (API), `false` (worker/beat) (Helm default)	为 `true` 时，在容器启动时自动执行数据库 schema 迁移。chart 仅为 API 服务启用。
`CHECK_UPDATE_URL`	`https://updates.dify.ai` (Helm default)	控制台通过该 URL 检查 Dify 新版本。离网（air-gapped）环境可置空。
`OPENAI_API_BASE`	`https://api.openai.com/v1`	遗留变量，Dify 自身代码并未实际使用。

SECRET_KEY

默认值：由 chart 设置（见你部署的 secret 配置）用于会话 Cookie 签名、JWT 鉴权令牌、文件 URL 签名（HMAC-SHA256），以及加密第三方 OAuth 凭据（AES-256）。Helm chart 通过一个 secret 管理该值。

部署后更改此密钥会立即登出所有用户、使所有文件 URL 失效，并破坏所有使用 OAuth 的插件集成，因为它们的加密凭据将无法恢复。

KEY_PROVIDER_TYPE

默认值：local 选择工作空间凭据加密密钥的存储方式。凭据包括模型供应商和工具的密钥：

local：将各工作空间的 RSA 私钥存入 STORAGE_TYPE 指定的存储后端。
azure-keyvault：将工作空间的 RSA 密钥存入 Azure Key Vault。私钥保留在密钥保管库中，通过 Azure DefaultAzureCredential 进行身份验证。

在创建凭据前选定密钥提供方。已有部署切换提供方后，新提供方无法读取原有凭据，系统也不会自动迁移这些凭据。

Dify 应用各服务与 plugin_manager 的 KEY_PROVIDER_TYPE 必须保持一致。使用 Azure 时，AZURE_KEYVAULT_VAULT_URL 也须一致。通过 api.extraEnv、worker.extraEnv、workerBeat.extraEnv 和 plugin_manager.extraEnv 配置。additionalWorkers 中的每个 worker 也需要在自身的 extraEnv 中设置这些变量，不会继承 worker.extraEnv。使用 azure-keyvault 时，配置以下变量：

变量	默认值	说明
`AZURE_KEYVAULT_VAULT_URL`	（未设置）	必填的密钥保管库 URL，例如 `https://your-vault-name.vault.azure.net`。
`AZURE_KEYVAULT_KEY_SIZE`	`2048`	新生成的工作空间 RSA 密钥的位数。除非组织要求其他密钥长度，否则保留默认值。
`AZURE_KEYVAULT_ROTATION_INTERVAL_DAYS`	（未设置）	Dify 应用创建的工作空间密钥的自动轮换间隔，单位为天，最小值为 `7`。保留旧版本密钥，以便 Dify 解密使用这些密钥加密的凭据。

Token 与请求限制

Variable	Default	Description
`ACCESS_TOKEN_EXPIRE_MINUTES`	`60`	登录会话的访问令牌保持有效的时长（分钟）。浏览器会用刷新令牌静默续期。
`REFRESH_TOKEN_EXPIRE_DAYS`	`30`	用户无需重新输入凭据即可保持登录的时长（天）。
`APP_MAX_EXECUTION_TIME`	`3600`	单次应用执行在被终止前可运行的最长时间（秒）。与 `WORKFLOW_MAX_EXECUTION_TIME` 配合生效。通过 `api.appMaxExecutionTimeSeconds` 设置。
`APP_DEFAULT_ACTIVE_REQUESTS`	`0`	未设置自定义上限时，每个应用的默认并发请求上限。`0` 表示不限。
`APP_MAX_ACTIVE_REQUESTS`	`0`	每个应用并发请求的全局上限。`0` 表示不限。
`WEBSOCKET_MAX_HTTP_BUFFER_SIZE`	`10485760`（Helm 默认值）	工作流编辑器协作时接收的单条消息大小上限，单位为字节（10 MiB）。超出上限的消息会被拒绝，编辑器连接也会断开。大型工作流超出此限制时，可调高该值。通过 `collaboration.websocket.maxHttpBufferSize` 设置。

Worker 配置

Helm chart 通过 values.yaml 而非环境变量管理 worker 数量。serverWorkerAmount 控制 API Gunicorn worker 数，celeryWorkerAmount 控制每个 worker 部署的 Celery worker 数。请在 values.yaml 中设置。

Variable	Default	Description
`SERVER_WORKER_AMOUNT`	`1` (Helm default)	Gunicorn worker 进程数。使用 gevent（默认）时，1 通常足够。通过 `values.yaml` 中的 `api.serverWorkerAmount` 设置。
`GUNICORN_TIMEOUT`	`360` (Helm default)	若 worker 在该秒数内无响应，Gunicorn 会重启它。360 可支持长连接的 SSE 流式输出。
`CELERY_WORKER_AMOUNT`	`1` (Helm default)	每个 worker 部署的 Celery worker 进程数。通过 `values.yaml` 中的 `worker.celeryWorkerAmount` 设置。
`SERVER_WORKER_CLASS`	`gevent`	Gunicorn worker 类型。保持默认值，其他值会破坏 psycopg2 和 gRPC 的猴子补丁。
`SERVER_WORKER_CONNECTIONS`	`10`	每个 worker 的最大并发连接数。仅对异步（gevent）worker 生效。
`CELERY_WORKER_CLASS`	（为空；默认 gevent）	Celery worker 类型。强烈不建议更改。

API Tool 配置

Variable	Default	Description
`API_TOOL_DEFAULT_CONNECT_TIMEOUT`	`10`	API Tool 节点调用外部 API 时，建立 TCP 连接的最长等待时间（秒）。
`API_TOOL_DEFAULT_READ_TIMEOUT`	`60`	API Tool 节点从外部 API 接收响应数据的最长等待时间（秒）。

数据库配置

Helm chart 通过 values.yaml 和共享的数据库 ConfigMap 配置主数据库连接（主机、端口、凭据、数据库名），而非通过各个 DB_* 变量。下列变量用于调优应用的连接池，可通过 extraEnv 设置。

Variable	Default	Description
`SQLALCHEMY_POOL_SIZE`	`250` (Helm default)	连接池中保持的持久连接数。chart 默认 250（应用默认 30）。通过 `api.db.poolSize` / `worker.db.poolSize` 设置。
`SQLALCHEMY_POOL_RECYCLE`	`3600` (Helm default)	连接在该秒数后回收，以避免陈旧连接。
`SQLALCHEMY_MAX_OVERFLOW`	`10`	连接池满时允许的额外临时连接数。
`SQLALCHEMY_POOL_TIMEOUT`	`30`	连接池耗尽时，等待可用连接的时长。
`SQLALCHEMY_POOL_RESET_ON_RETURN`	`rollback`	连接归还到池时执行的动作。`rollback` 清除未提交的事务状态，`commit` 则提交。
`SQLALCHEMY_POOL_PRE_PING`	`false`	使用前用一条轻量查询测试每个连接。可避免「连接丢失」错误，但会增加少量延迟。
`SQLALCHEMY_POOL_USE_LIFO`	`false`	复用最近归还的连接（LIFO），而非均匀轮换（FIFO）。
`SQLALCHEMY_ECHO`	`false`	将所有 SQL 语句打印到日志。便于排查查询问题。

Redis 配置

Helm chart 通过 values.yaml（共享的 Redis 配置）配置 Redis 连接。应用支持单机、Sentinel 和 Cluster 三种模式。下列变量是应用级调节项；在 Helm 部署中，优先使用 chart 的 Redis 设置，调优时再用 extraEnv。

Variable	Default	Description
`REDIS_KEY_PREFIX`	（为空）	应用于所有 Redis 键、pub/sub 频道、Streams 名称和 Celery broker 队列的可选全局前缀。当多个 Dify 实例共用一个 Redis 部署时很有用。在已有部署上启用前缀，会让之前前缀下写入的键被遗弃。
`REDIS_USE_SSL`	`false`	为 Redis 连接启用 SSL/TLS。不会自动应用于 Sentinel 协议。
`REDIS_MAX_CONNECTIONS`	（为空）	Redis 连接池的最大连接数。不设置则使用库的默认值。

Redis SSL 配置

仅在 REDIS_USE_SSL=true 时生效。

Variable	Default	Description
`REDIS_SSL_CERT_REQS`	`CERT_NONE`	证书校验级别：`CERT_NONE`、`CERT_OPTIONAL` 或 `CERT_REQUIRED`。
`REDIS_SSL_CA_CERTS`	（为空）	用于校验 Redis 服务器的 CA 证书文件路径。
`REDIS_SSL_CERTFILE`	（为空）	用于双向 TLS 的客户端证书路径。
`REDIS_SSL_KEYFILE`	（为空）	用于双向 TLS 的客户端私钥路径。

Redis 连接弹性

Variable	Default	Description
`REDIS_RETRY_RETRIES`	`3`	瞬时故障时每条 Redis 命令的最大重试次数。设为 `0` 可禁用。采用带抖动的指数退避。
`REDIS_RETRY_BACKOFF_BASE`	`1.0`	重试间指数退避的基础延迟（秒）。
`REDIS_RETRY_BACKOFF_CAP`	`10.0`	重试间退避延迟的上限（秒）。
`REDIS_SOCKET_TIMEOUT`	`5.0`	Redis 读/写操作的套接字超时（秒）。
`REDIS_SOCKET_CONNECT_TIMEOUT`	`5.0`	建立 Redis 连接的套接字超时（秒）。
`REDIS_HEALTH_CHECK_INTERVAL`	`30`	对空闲连接进行客户端健康检查的间隔（秒）。设为 `0` 可禁用。Cluster 模式下不生效。

Celery 配置

Helm chart 通过 values.yaml 和共享的 Celery secret 管理 Celery broker 连接。下列变量是应用级调优项。

Variable	Default	Description
`CELERY_BACKEND`	`redis`	Celery 存放任务结果的位置。可选：`redis`（快速、内存型）或 `database`。
`BROKER_USE_SSL`	`false`	当 broker URL 使用 `rediss://` 协议时自动启用。
`CELERY_USE_SENTINEL`	`false`	为 Celery broker 启用 Redis Sentinel 模式。
`CELERY_SENTINEL_MASTER_NAME`	（为空）	Sentinel 服务名（Master Name）。
`CELERY_SENTINEL_PASSWORD`	（为空）	Sentinel 鉴权密码。
`CELERY_SENTINEL_SOCKET_TIMEOUT`	`0.1`	连接 Sentinel 的超时（秒）。
`CELERY_TASK_ANNOTATIONS`	`null`	为特定任务应用运行时设置（例如速率限制）。格式为 JSON 字典。多数用户无需配置。

CORS 配置

控制前端的跨域访问策略。chart 仅在 values.yaml 中设置时才写入这些变量。

Variable	Default	Description
`WEB_API_CORS_ALLOW_ORIGINS`	`*`	允许向 Web API 发起跨域请求的来源。范例：`https://dify.app`
`CONSOLE_CORS_ALLOW_ORIGINS`	`*`	允许向控制台 API 发起跨域请求的来源。未设置时回退到 `CONSOLE_WEB_URL`。
`COOKIE_DOMAIN`	（为空）	当前后端运行在不同子域时，设为共享的顶级域名（例如 `example.com`），以便跨子域共享鉴权 Cookie。

文件存储配置

配置 Dify 存放上传文件、知识库文档和加密密钥的位置。每种存储类型都有各自的凭据变量，只需配置你使用的那种。在 Helm 部署中，除非 chart 已暴露，否则通过 extraEnv 设置。

STORAGE_TYPE

默认值：opendal 选择文件存储后端。支持的值：opendal、s3、azure-blob、aliyun-oss、google-storage、huawei-obs、volcengine-tos、tencent-cos、baidu-obs、oci-storage、supabase、clickzetta-volume、local（已弃用；内部通过 OpenDAL 的 filesystem 协议实现）。

OpenDAL（默认）

默认存储后端，基于 Apache OpenDAL，提供支持多种存储服务的统一接口。Dify 会自动扫描匹配 OPENDAL_<SCHEME>_* 的环境变量并传给 OpenDAL。例如当 OPENDAL_SCHEME=s3 时，设置 OPENDAL_S3_ACCESS_KEY_ID、OPENDAL_S3_SECRET_ACCESS_KEY 等。

Variable	Default	Description
`OPENDAL_SCHEME`	`fs`	使用的存储服务。范例：`fs`（本地文件系统）、`s3`、`gcs`、`azblob`。
`OPENDAL_FS_ROOT`	`storage`	本地文件系统存储的根目录（配合 `fs` 协议使用）。

所有可用协议及其配置选项，见 OpenDAL 服务文档。

Variable	Default	Description
`S3_ENDPOINT`	（为空）	S3 端点地址。非 AWS 的 S3 兼容服务（MinIO 等）必填。
`S3_REGION`	`us-east-1`	S3 区域。
`S3_BUCKET_NAME`	`difyai`	S3 存储桶名称。
`S3_ACCESS_KEY`	（为空）	S3 Access Key。使用 IAM 角色时无需填写。
`S3_SECRET_KEY`	（为空）	S3 Secret Key。使用 IAM 角色时无需填写。
`S3_ADDRESS_STYLE`	`auto`	S3 寻址方式：`auto`、`path` 或 `virtual`。仅在 `S3_USE_AWS_MANAGED_IAM` 为 `false` 时生效。
`S3_USE_AWS_MANAGED_IAM`	`false`	使用 AWS IAM 角色（EC2 实例配置文件、EKS 服务账户）而非显式密钥。凭据会从实例元数据自动发现。

Azure Blob

Variable	Default	Description
`AZURE_BLOB_ACCOUNT_NAME`	`difyai`	Azure 存储账户名。
`AZURE_BLOB_ACCOUNT_KEY`	`difyai`	Azure 存储账户密钥。
`AZURE_BLOB_CONTAINER_NAME`	`difyai-container`	Azure Blob 容器名。
`AZURE_BLOB_ACCOUNT_URL`	`https://<your_account_name>.blob.core.windows.net`	Azure Blob 账户 URL。

Google Cloud Storage

Variable	Default	Description
`GOOGLE_STORAGE_BUCKET_NAME`	（为空）	Google Cloud Storage 存储桶名称。
`GOOGLE_STORAGE_SERVICE_ACCOUNT_JSON_BASE64`	（为空）	Base64 编码的服务账户 JSON 密钥。

Alibaba Cloud OSS

Variable	Default	Description
`ALIYUN_OSS_BUCKET_NAME`	（为空）	OSS 存储桶名称。
`ALIYUN_OSS_ACCESS_KEY`	（为空）	OSS access key。
`ALIYUN_OSS_SECRET_KEY`	（为空）	OSS secret key。
`ALIYUN_OSS_ENDPOINT`	`https://oss-ap-southeast-1-internal.aliyuncs.com`	OSS 端点。区域与端点参考。
`ALIYUN_OSS_REGION`	`ap-southeast-1`	OSS 区域。
`ALIYUN_OSS_AUTH_VERSION`	`v4`	OSS 鉴权版本。
`ALIYUN_OSS_PATH`	（为空）	对象路径前缀。不要以 `/` 开头。参考。
`ALIYUN_CLOUDBOX_ID`	（为空）	基于 CloudBox 的 OSS 部署所用的 CloudBox ID。

Tencent Cloud COS

Variable	Default	Description
`TENCENT_COS_BUCKET_NAME`	（为空）	COS 存储桶名称。
`TENCENT_COS_SECRET_KEY`	（为空）	COS secret key。
`TENCENT_COS_SECRET_ID`	（为空）	COS secret ID。
`TENCENT_COS_REGION`	（为空）	COS 区域，例如 `ap-guangzhou`。参考。
`TENCENT_COS_SCHEME`	（为空）	访问 COS 的协议（`http` 或 `https`）。
`TENCENT_COS_CUSTOM_DOMAIN`	（为空）	访问 COS 的自定义域名。

OCI Object Storage

Variable	Default	Description
`OCI_ENDPOINT`	（为空）	OCI 端点 URL。
`OCI_BUCKET_NAME`	（为空）	OCI 存储桶名称。
`OCI_ACCESS_KEY`	（为空）	OCI access key。
`OCI_SECRET_KEY`	（为空）	OCI secret key。
`OCI_REGION`	`us-ashburn-1`	OCI 区域。

Huawei OBS

Variable	Default	Description
`HUAWEI_OBS_BUCKET_NAME`	（为空）	OBS 存储桶名称。
`HUAWEI_OBS_ACCESS_KEY`	（为空）	OBS access key。
`HUAWEI_OBS_SECRET_KEY`	（为空）	OBS secret key。
`HUAWEI_OBS_SERVER`	（为空）	OBS 服务器 URL。参考。
`HUAWEI_OBS_PATH_STYLE`	`false`	使用 path-style URL 而非 virtual-hosted-style。

Volcengine TOS

Variable	Default	Description
`VOLCENGINE_TOS_BUCKET_NAME`	（为空）	TOS 存储桶名称。
`VOLCENGINE_TOS_ACCESS_KEY`	（为空）	TOS access key。
`VOLCENGINE_TOS_SECRET_KEY`	（为空）	TOS secret key。
`VOLCENGINE_TOS_ENDPOINT`	（为空）	TOS 端点 URL。参考。
`VOLCENGINE_TOS_REGION`	（为空）	TOS 区域，例如 `cn-guangzhou`。

Baidu OBS

Variable	Default	Description
`BAIDU_OBS_BUCKET_NAME`	（为空）	百度 OBS 存储桶名称。
`BAIDU_OBS_ACCESS_KEY`	（为空）	百度 OBS access key。
`BAIDU_OBS_SECRET_KEY`	（为空）	百度 OBS secret key。
`BAIDU_OBS_ENDPOINT`	（为空）	百度 OBS 服务器 URL。

Supabase

Variable	Default	Description
`SUPABASE_BUCKET_NAME`	（为空）	Supabase 存储桶名称。
`SUPABASE_API_KEY`	（为空）	Supabase API key。
`SUPABASE_URL`	（为空）	Supabase 服务器 URL。

ClickZetta Volume

Variable	Default	Description
`CLICKZETTA_VOLUME_TYPE`	`user`	Volume 类型。可选：`user`、`table`、`external`。
`CLICKZETTA_VOLUME_NAME`	（为空）	外部 Volume 名称（仅在 `TYPE=external` 时必填）。
`CLICKZETTA_VOLUME_TABLE_PREFIX`	`dataset_`	Table volume 的表前缀（仅在 `TYPE=table` 时使用）。
`CLICKZETTA_VOLUME_DIFY_PREFIX`	`dify_km`	Dify 文件目录前缀，用于与其他应用隔离。

ClickZetta Volume 复用 Vector Database 部分配置的 CLICKZETTA_* 连接参数。

归档存储

用于归档工作流运行日志的独立 S3 兼容存储。把超过保留期的工作流运行记录归档为 JSONL 格式。

Variable	Default	Description
`ARCHIVE_STORAGE_ENABLED`	`false`	为工作流日志归档启用归档存储。
`ARCHIVE_STORAGE_ENDPOINT`	（为空）	S3 兼容端点 URL。
`ARCHIVE_STORAGE_ARCHIVE_BUCKET`	（为空）	存放已归档工作流运行日志的存储桶。
`ARCHIVE_STORAGE_EXPORT_BUCKET`	（为空）	存放工作流运行导出的存储桶。
`ARCHIVE_STORAGE_ACCESS_KEY`	（为空）	Access key。
`ARCHIVE_STORAGE_SECRET_KEY`	（为空）	Secret key。
`ARCHIVE_STORAGE_REGION`	`auto`	存储区域。
`ARCHIVE_STORAGE_ADDRESS_STYLE`	`path`	归档存储的 S3 寻址方式。`path` 使用路径式 URL，`virtual` 使用虚拟托管式 URL，`auto` 由 S3 客户端自动选择。

向量数据库配置

配置用于知识库嵌入存储和相似度搜索的向量数据库。每个供应商都有各自的凭据变量，只需配置你使用的那个。

VECTOR_STORE

默认值：weaviate 选择向量数据库后端。如果某个数据集已建立索引，该数据集存储的类型优先于此设置。支持的值：weaviate、oceanbase、seekdb、qdrant、milvus、myscale、relyt、pgvector、pgvecto-rs、chroma、opensearch、oracle、tencent、elasticsearch、elasticsearch-ja、analyticdb、couchbase、vikingdb、opengauss、tablestore、vastbase、tidb、tidb_on_qdrant、baidu、lindorm、huawei_cloud、upstash、matrixone、clickzetta、alibabacloud_mysql、iris、hologres。

Variable	Default	Description
`VECTOR_INDEX_NAME_PREFIX`	`Vector_index`	添加到向量数据库 collection 名称的前缀。如果多个 Dify 部署共用一个向量数据库实例，请更改此项。

Weaviate

Variable	Default	Description
`WEAVIATE_ENDPOINT`	`http://weaviate:8080`	Weaviate REST API 端点。
`WEAVIATE_API_KEY`	（为空）	Weaviate 鉴权用的 API key。
`WEAVIATE_GRPC_ENDPOINT`	`grpc://weaviate:50051`	用于高性能二进制协议的独立 gRPC 端点。未设置时回退为从 HTTP 端点推断。
`WEAVIATE_TOKENIZATION`	`word`	分词方式。可选：`word`、`whitespace`、`character`（对 CJK 语言更友好）。

OceanBase / seekdb

seekdb 是 OceanBase 的精简版，使用相同的连接配置。

Variable	Default	Description
`OCEANBASE_VECTOR_HOST`	`oceanbase`	主机名或 IP 地址。
`OCEANBASE_VECTOR_PORT`	`2881`	端口号。
`OCEANBASE_VECTOR_USER`	`root@test`	数据库用户名。
`OCEANBASE_VECTOR_PASSWORD`	`difyai123456`	数据库密码。
`OCEANBASE_VECTOR_DATABASE`	`test`	数据库名。
`OCEANBASE_ENABLE_HYBRID_SEARCH`	`false`	在向量搜索之外启用 BM25 查询的全文索引。要求 OceanBase >= 4.3.5.1。启用后必须重建 collection。
`OCEANBASE_FULLTEXT_PARSER`	`ik`	全文解析器。内置：`ngram`、`beng`、`space`、`ngram2`、`ik`。

Qdrant

Variable	Default	Description
`QDRANT_URL`	`http://qdrant:6333`	Qdrant 端点地址。
`QDRANT_API_KEY`	`difyai123456`	Qdrant 的 API key。
`QDRANT_CLIENT_TIMEOUT`	`20`	客户端超时（秒）。
`QDRANT_GRPC_ENABLED`	`false`	启用 gRPC 通信。
`QDRANT_GRPC_PORT`	`6334`	gRPC 端口。
`QDRANT_REPLICATION_FACTOR`	`1`	每个分片的副本数。

Milvus

Variable	Default	Description
`MILVUS_URI`	`http://host.docker.internal:19530`	Milvus URI。使用 Zilliz Cloud 时填 Public Endpoint。
`MILVUS_DATABASE`	（为空）	数据库名。
`MILVUS_TOKEN`	（为空）	鉴权令牌。使用 Zilliz Cloud 时填 API Key。
`MILVUS_USER`	（为空）	用户名。
`MILVUS_PASSWORD`	（为空）	密码。
`MILVUS_ENABLE_HYBRID_SEARCH`	`false`	为全文检索启用 BM25 稀疏索引。要求 Milvus >= 2.5.0。
`MILVUS_ANALYZER_PARAMS`	（为空）	文本字段的分析器参数。
`MILVUS_SECURE`	`false`	为 Milvus 连接启用单向 TLS。启用后，客户端通过 TLS 加密的 gRPC 连接并验证服务器证书。
`MILVUS_SERVER_PEM_PATH`	（为空）	容器内 Milvus 服务器证书（PEM）的路径，在启用 `MILVUS_SECURE` 时用于验证服务器。
`MILVUS_SERVER_NAME`	（为空）	用于验证的服务器名称（TLS SNI，需与证书的 CN 或 SAN 匹配）。设置 `MILVUS_SERVER_PEM_PATH` 时必填。

MyScale

Variable	Default	Description
`MYSCALE_HOST`	`myscale`	MyScale 主机。
`MYSCALE_PORT`	`8123`	MyScale 端口。
`MYSCALE_USER`	`default`	用户名。
`MYSCALE_PASSWORD`	（为空）	密码。
`MYSCALE_DATABASE`	`dify`	数据库名。
`MYSCALE_FTS_PARAMS`	（为空）	全文检索参数。参考。

Couchbase

Variable	Default	Description
`COUCHBASE_CONNECTION_STRING`	`couchbase://couchbase-server`	Couchbase 集群的连接字符串。
`COUCHBASE_USER`	`Administrator`	用户名。
`COUCHBASE_PASSWORD`	`password`	密码。
`COUCHBASE_BUCKET_NAME`	`Embeddings`	存储桶名称。
`COUCHBASE_SCOPE_NAME`	`_default`	Scope 名称。

Hologres

Variable	Default	Description
`HOLOGRES_HOST`	（为空）	主机名。
`HOLOGRES_PORT`	`80`	端口号。
`HOLOGRES_DATABASE`	（为空）	数据库名。
`HOLOGRES_ACCESS_KEY_ID`	（为空）	Access key ID（用作 PG 用户名）。
`HOLOGRES_ACCESS_KEY_SECRET`	（为空）	Access key secret（用作 PG 密码）。
`HOLOGRES_SCHEMA`	`public`	Schema 名称。
`HOLOGRES_TOKENIZER`	`jieba`	文本字段的分词器。
`HOLOGRES_DISTANCE_METHOD`	`Cosine`	距离度量方法。
`HOLOGRES_BASE_QUANTIZATION_TYPE`	`rabitq`	量化类型。
`HOLOGRES_MAX_DEGREE`	`64`	HNSW 最大度数。
`HOLOGRES_EF_CONSTRUCTION`	`400`	HNSW ef_construction 参数。

PGVector

Variable	Default	Description
`PGVECTOR_HOST`	`pgvector`	主机名。
`PGVECTOR_PORT`	`5432`	端口号。
`PGVECTOR_USER`	`postgres`	用户名。
`PGVECTOR_PASSWORD`	`difyai123456`	密码。
`PGVECTOR_DATABASE`	`dify`	数据库名。
`PGVECTOR_MIN_CONNECTION`	`1`	连接池最小连接数。
`PGVECTOR_MAX_CONNECTION`	`5`	连接池最大连接数。
`PGVECTOR_PG_BIGM`	`false`	启用 pg_bigm 扩展用于全文检索。

Vastbase

Variable	Default	Description
`VASTBASE_HOST`	`vastbase`	主机名。
`VASTBASE_PORT`	`5432`	端口号。
`VASTBASE_USER`	`dify`	用户名。
`VASTBASE_PASSWORD`	`Difyai123456`	密码。
`VASTBASE_DATABASE`	`dify`	数据库名。
`VASTBASE_MIN_CONNECTION`	`1`	连接池最小连接数。
`VASTBASE_MAX_CONNECTION`	`5`	连接池最大连接数。

PGVecto.RS

Variable	Default	Description
`PGVECTO_RS_HOST`	`pgvecto-rs`	主机名。
`PGVECTO_RS_PORT`	`5432`	端口号。
`PGVECTO_RS_USER`	`postgres`	用户名。
`PGVECTO_RS_PASSWORD`	`difyai123456`	密码。
`PGVECTO_RS_DATABASE`	`dify`	数据库名。

AnalyticDB

Variable	Default	Description
`ANALYTICDB_KEY_ID`	（为空）	阿里云 access key ID。创建 AccessKey。
`ANALYTICDB_KEY_SECRET`	（为空）	阿里云 access key secret。
`ANALYTICDB_REGION_ID`	`cn-hangzhou`	区域标识。
`ANALYTICDB_INSTANCE_ID`	（为空）	实例 ID，例如 `gp-xxxxxx`。创建实例。
`ANALYTICDB_ACCOUNT`	（为空）	账户名。创建账户。
`ANALYTICDB_PASSWORD`	（为空）	账户密码。
`ANALYTICDB_NAMESPACE`	`dify`	命名空间（schema）。不存在时自动创建。
`ANALYTICDB_NAMESPACE_PASSWORD`	（为空）	命名空间密码。
`ANALYTICDB_HOST`	（为空）	直连主机（基于 API 访问的替代方案）。
`ANALYTICDB_PORT`	`5432`	直连端口。
`ANALYTICDB_MIN_CONNECTION`	`1`	连接池最小连接数。
`ANALYTICDB_MAX_CONNECTION`	`5`	连接池最大连接数。

TiDB Vector

Variable	Default	Description
`TIDB_VECTOR_HOST`	`tidb`	主机名。
`TIDB_VECTOR_PORT`	`4000`	端口号。
`TIDB_VECTOR_USER`	（为空）	用户名。
`TIDB_VECTOR_PASSWORD`	（为空）	密码。
`TIDB_VECTOR_DATABASE`	`dify`	数据库名。

MatrixOne

Variable	Default	Description
`MATRIXONE_HOST`	`matrixone`	主机名。
`MATRIXONE_PORT`	`6001`	端口号。
`MATRIXONE_USER`	`dump`	用户名。
`MATRIXONE_PASSWORD`	`111`	密码。
`MATRIXONE_DATABASE`	`dify`	数据库名。

Chroma

VariableDefaultDescription
CHROMA_HOST127.0.0.1Chroma 服务器主机。
CHROMA_PORT8000Chroma 服务器端口。
CHROMA_TENANTdefault_tenant租户名称。
CHROMA_DATABASEdefault_database数据库名。
CHROMA_AUTH_PROVIDERchromadb.auth.token_authn.TokenAuthClientProvider鉴权 provider 类。
CHROMA_AUTH_CREDENTIALS（为空）鉴权凭据。

Variable	Default	Description
`CHROMA_HOST`	`127.0.0.1`	Chroma 服务器主机。
`CHROMA_PORT`	`8000`	Chroma 服务器端口。
`CHROMA_TENANT`	`default_tenant`	租户名称。
`CHROMA_DATABASE`	`default_database`	数据库名。
`CHROMA_AUTH_PROVIDER`	`chromadb.auth.token_authn.TokenAuthClientProvider`	鉴权 provider 类。
`CHROMA_AUTH_CREDENTIALS`	（为空）	鉴权凭据。

Oracle

Variable	Default	Description
`ORACLE_USER`	`dify`	Oracle 用户名。
`ORACLE_PASSWORD`	`dify`	Oracle 密码。
`ORACLE_DSN`	`oracle:1521/FREEPDB1`	数据源名称。
`ORACLE_CONFIG_DIR`	`/app/api/storage/wallet`	Oracle 配置目录。
`ORACLE_WALLET_LOCATION`	`/app/api/storage/wallet`	Autonomous DB 的 wallet 位置。
`ORACLE_WALLET_PASSWORD`	`dify`	Wallet 密码。
`ORACLE_IS_AUTONOMOUS`	`false`	是否使用 Oracle Autonomous Database。

AlibabaCloud MySQL

Variable	Default	Description
`ALIBABACLOUD_MYSQL_HOST`	`127.0.0.1`	主机名。
`ALIBABACLOUD_MYSQL_PORT`	`3306`	端口号。
`ALIBABACLOUD_MYSQL_USER`	`root`	用户名。
`ALIBABACLOUD_MYSQL_PASSWORD`	`difyai123456`	密码。
`ALIBABACLOUD_MYSQL_DATABASE`	`dify`	数据库名。
`ALIBABACLOUD_MYSQL_MAX_CONNECTION`	`5`	连接池最大连接数。
`ALIBABACLOUD_MYSQL_HNSW_M`	`6`	HNSW M 参数。

Relyt

Variable	Default	Description
`RELYT_HOST`	`db`	主机名。
`RELYT_PORT`	`5432`	端口号。
`RELYT_USER`	`postgres`	用户名。
`RELYT_PASSWORD`	`difyai123456`	密码。
`RELYT_DATABASE`	`postgres`	数据库名。

OpenSearch

Variable	Default	Description
`OPENSEARCH_HOST`	`opensearch`	主机名。
`OPENSEARCH_PORT`	`9200`	端口号。
`OPENSEARCH_SECURE`	`true`	使用 HTTPS。
`OPENSEARCH_VERIFY_CERTS`	`true`	校验 SSL 证书。
`OPENSEARCH_AUTH_METHOD`	`basic`	`basic` 使用用户名/密码，`aws_managed_iam` 通过 Boto3 凭据使用 AWS SigV4 请求签名。
`OPENSEARCH_USER`	`admin`	用户名。仅在 `basic` 鉴权时使用。
`OPENSEARCH_PASSWORD`	`admin`	密码。仅在 `basic` 鉴权时使用。
`OPENSEARCH_AWS_REGION`	`ap-southeast-1`	AWS 区域。仅在 `aws_managed_iam` 鉴权时使用。
`OPENSEARCH_AWS_SERVICE`	`aoss`	AWS 服务类型：`es`（Managed Cluster）或 `aoss`（OpenSearch Serverless）。

Tencent Cloud VectorDB

Variable	Default	Description
`TENCENT_VECTOR_DB_URL`	`http://127.0.0.1`	访问地址。控制台。
`TENCENT_VECTOR_DB_API_KEY`	`dify`	API key。密钥管理。
`TENCENT_VECTOR_DB_TIMEOUT`	`30`	请求超时（秒）。
`TENCENT_VECTOR_DB_USERNAME`	`dify`	账户名。账户管理。
`TENCENT_VECTOR_DB_DATABASE`	`dify`	数据库名。创建数据库。
`TENCENT_VECTOR_DB_SHARD`	`1`	分片数。
`TENCENT_VECTOR_DB_REPLICAS`	`2`	副本数。
`TENCENT_VECTOR_DB_ENABLE_HYBRID_SEARCH`	`false`	启用混合检索。稀疏向量文档。

Elasticsearch

Variable	Default	Description
`ELASTICSEARCH_HOST`	`0.0.0.0`	主机名。
`ELASTICSEARCH_PORT`	`9200`	端口号。
`ELASTICSEARCH_USERNAME`	`elastic`	用户名。
`ELASTICSEARCH_PASSWORD`	`elastic`	密码。
`ELASTICSEARCH_USE_CLOUD`	`false`	切换到 Elastic Cloud 模式。为 `true` 时使用 `ELASTICSEARCH_CLOUD_URL` 和 `ELASTICSEARCH_API_KEY`，而非主机/端口/用户名/密码。
`ELASTICSEARCH_CLOUD_URL`	（为空）	Elastic Cloud 端点 URL。`ELASTICSEARCH_USE_CLOUD=true` 时必填。
`ELASTICSEARCH_API_KEY`	（为空）	Elastic Cloud API key。`ELASTICSEARCH_USE_CLOUD=true` 时必填。
`ELASTICSEARCH_VERIFY_CERTS`	`false`	校验 SSL 证书。
`ELASTICSEARCH_CA_CERTS`	（为空）	CA 证书路径。
`ELASTICSEARCH_REQUEST_TIMEOUT`	`100000`	请求超时（毫秒）。
`ELASTICSEARCH_RETRY_ON_TIMEOUT`	`true`	超时时重试。
`ELASTICSEARCH_MAX_RETRIES`	`10`	最大重试次数。

Baidu Vector DB

Variable	Default	Description
`BAIDU_VECTOR_DB_ENDPOINT`	`http://127.0.0.1:5287`	端点 URL。
`BAIDU_VECTOR_DB_CONNECTION_TIMEOUT_MS`	`30000`	连接超时（毫秒）。
`BAIDU_VECTOR_DB_ACCOUNT`	`root`	账户名。
`BAIDU_VECTOR_DB_API_KEY`	`dify`	API key。
`BAIDU_VECTOR_DB_DATABASE`	`dify`	数据库名。
`BAIDU_VECTOR_DB_SHARD`	`1`	分片数。
`BAIDU_VECTOR_DB_REPLICAS`	`3`	副本数。
`BAIDU_VECTOR_DB_INVERTED_INDEX_ANALYZER`	`DEFAULT_ANALYZER`	倒排索引分析器。
`BAIDU_VECTOR_DB_INVERTED_INDEX_PARSER_MODE`	`COARSE_MODE`	倒排索引解析器模式。
`BAIDU_VECTOR_DB_AUTO_BUILD_ROW_COUNT_INCREMENT`	`500`	触发自动重建索引的行数绝对增量。与 `_RATIO` 配合，任一阈值先达到即触发。
`BAIDU_VECTOR_DB_AUTO_BUILD_ROW_COUNT_INCREMENT_RATIO`	`0.05`	触发自动重建索引的相对增长。任一阈值先达到即触发。
`BAIDU_VECTOR_DB_REBUILD_INDEX_TIMEOUT_IN_SECONDS`	`300`	客户端等待索引重建完成的最长时间。

VikingDB

Variable	Default	Description
`VIKINGDB_ACCESS_KEY`	（为空）	Access key。
`VIKINGDB_SECRET_KEY`	（为空）	Secret key。
`VIKINGDB_REGION`	`cn-shanghai`	区域。
`VIKINGDB_HOST`	`api-vikingdb.xxx.volces.com`	API 主机。替换为你所在区域的端点。
`VIKINGDB_SCHEME`	`http`	协议（`http` 或 `https`）。
`VIKINGDB_CONNECTION_TIMEOUT`	`30`	连接超时（秒）。
`VIKINGDB_SOCKET_TIMEOUT`	`30`	套接字超时（秒）。

Lindorm

Variable	Default	Description
`LINDORM_URL`	`http://localhost:30070`	Lindorm 搜索引擎 URL。控制台。
`LINDORM_USERNAME`	`admin`	用户名。
`LINDORM_PASSWORD`	`admin`	密码。
`LINDORM_USING_UGC`	`true`	使用 UGC 模式。
`LINDORM_QUERY_TIMEOUT`	`1`	查询超时（秒）。

OpenGauss

Variable	Default	Description
`OPENGAUSS_HOST`	`opengauss`	主机名。
`OPENGAUSS_PORT`	`6600`	端口号。
`OPENGAUSS_USER`	`postgres`	用户名。
`OPENGAUSS_PASSWORD`	`Dify@123`	密码。
`OPENGAUSS_DATABASE`	`dify`	数据库名。
`OPENGAUSS_MIN_CONNECTION`	`1`	连接池最小连接数。
`OPENGAUSS_MAX_CONNECTION`	`5`	连接池最大连接数。
`OPENGAUSS_ENABLE_PQ`	`false`	启用 PQ 加速。

Huawei Cloud Search

Variable	Default	Description
`HUAWEI_CLOUD_HOSTS`	`https://127.0.0.1:9200`	集群端点 URL。
`HUAWEI_CLOUD_USER`	`admin`	用户名。
`HUAWEI_CLOUD_PASSWORD`	`admin`	密码。

Upstash Vector

Variable	Default	Description
`UPSTASH_VECTOR_URL`	（为空）	Upstash Vector 端点 URL。
`UPSTASH_VECTOR_TOKEN`	（为空）	Upstash Vector API 令牌。

TableStore

Variable	Default	Description
`TABLESTORE_ENDPOINT`	`https://instance-name.cn-hangzhou.ots.aliyuncs.com`	端点地址。将 `instance-name` 替换为你的实例。
`TABLESTORE_INSTANCE_NAME`	（为空）	实例名称。
`TABLESTORE_ACCESS_KEY_ID`	（为空）	Access key ID。
`TABLESTORE_ACCESS_KEY_SECRET`	（为空）	Access key secret。
`TABLESTORE_NORMALIZE_FULLTEXT_BM25_SCORE`	`false`	归一化全文 BM25 分数。

ClickZetta

Variable	Default	Description
`CLICKZETTA_USERNAME`	（为空）	用户名。
`CLICKZETTA_PASSWORD`	（为空）	密码。
`CLICKZETTA_INSTANCE`	（为空）	实例名称。
`CLICKZETTA_SERVICE`	`api.clickzetta.com`	服务端点。
`CLICKZETTA_WORKSPACE`	`quick_start`	工作空间名称。
`CLICKZETTA_VCLUSTER`	`default_ap`	虚拟集群。
`CLICKZETTA_SCHEMA`	`dify`	Schema 名称。
`CLICKZETTA_BATCH_SIZE`	`100`	操作的批处理大小。
`CLICKZETTA_ENABLE_INVERTED_INDEX`	`true`	启用倒排索引。
`CLICKZETTA_ANALYZER_TYPE`	`chinese`	分析器类型。
`CLICKZETTA_ANALYZER_MODE`	`smart`	分析器模式。
`CLICKZETTA_VECTOR_DISTANCE_FUNCTION`	`cosine_distance`	距离函数。

InterSystems IRIS

Variable	Default	Description
`IRIS_HOST`	`iris`	主机名。
`IRIS_SUPER_SERVER_PORT`	`1972`	Super server 端口。
`IRIS_USER`	`_SYSTEM`	用户名。
`IRIS_PASSWORD`	`Dify@1234`	密码。
`IRIS_DATABASE`	`USER`	数据库名。
`IRIS_SCHEMA`	`dify`	Schema 名称。
`IRIS_CONNECTION_URL`	（为空）	完整连接 URL（覆盖单项设置）。
`IRIS_MIN_CONNECTION`	`1`	连接池最小连接数。
`IRIS_MAX_CONNECTION`	`3`	连接池最大连接数。
`IRIS_TEXT_INDEX`	`true`	启用文本索引。
`IRIS_TEXT_INDEX_LANGUAGE`	`en`	文本索引语言。

知识库配置

Variable	Default	Description
`UPLOAD_FILE_SIZE_LIMIT`	`15` (Helm default)	文档上传（PDF、Word 文档等）的最大文件大小（MB）。超出时用户会看到「文件过大」错误。通过 `values.yaml` 中的 `api.limits.uploadFileSize` 设置。
`UPLOAD_FILE_BATCH_LIMIT`	`5` (Helm default)	单次上传批次允许的最大文件数。通过 `api.limits.uploadFileBatchCount` 设置。
`UPLOAD_FILE_EXTENSION_BLACKLIST`	（为空）	禁止上传的文件扩展名安全黑名单。逗号分隔、小写、不带点。范例：`exe,bat,cmd,com,scr,vbs,ps1,msi,dll`。
`SINGLE_CHUNK_ATTACHMENT_LIMIT`	`10`	单个知识库分段（chunk）中可嵌入的最大图片数。
`IMAGE_FILE_BATCH_LIMIT`	`10`	单次上传批次的最大图片文件数。
`ATTACHMENT_IMAGE_FILE_SIZE_LIMIT`	`2`	知识库索引期间从外部 URL 抓取图片的最大大小（MB）。区别于针对直接上传的 `UPLOAD_IMAGE_FILE_SIZE_LIMIT`。
`ATTACHMENT_IMAGE_DOWNLOAD_TIMEOUT`	`60`	知识库索引期间从外部 URL 下载图片的超时（秒）。
`ETL_TYPE`	`dify` (Helm default)	文档提取库。`dify` 支持 txt、md、pdf、html、xlsx、docx、csv，`Unstructured` 额外支持 doc、msg、eml、ppt、pptx、xml、epub。当 `global.rag.etlType` 为 `Unstructured` 时，chart 会设置 `Unstructured` 并自动接入 `UNSTRUCTURED_API_URL`。
`UNSTRUCTURED_API_URL`	（为空；`etlType=Unstructured` 时由 chart 设置）	Unstructured.io API 端点。`ETL_TYPE` 为 `Unstructured` 时必填。
`UNSTRUCTURED_API_KEY`	（为空）	Unstructured.io 鉴权用的 API key。
`SCARF_NO_ANALYTICS`	`true`	禁用 Unstructured 库的遥测采集。
`TOP_K_MAX_VALUE`	`10` (Helm default)	用户在知识库检索中可为 `top_k` 参数设置的最大值。通过 `global.rag.topKMaxValue` 设置。
`DATASET_MAX_SEGMENTS_PER_REQUEST`	`0`	每次 dataset API 请求的最大分段数。`0` 表示不限。

标注导入

Variable	Default	Description
`ANNOTATION_IMPORT_FILE_SIZE_LIMIT`	`2`	标注导入的最大 CSV 文件大小（MB）。超出时返回 HTTP 413。
`ANNOTATION_IMPORT_MAX_RECORDS`	`10000`	每次标注导入的最大记录数。
`ANNOTATION_IMPORT_MIN_RECORDS`	`1`	每次标注导入所需的最少有效记录数。
`ANNOTATION_IMPORT_RATE_LIMIT_PER_MINUTE`	`5`	每个工作空间每分钟的最大标注导入请求数。超出时返回 HTTP 429。
`ANNOTATION_IMPORT_RATE_LIMIT_PER_HOUR`	`20`	每个工作空间每小时的最大标注导入请求数。
`ANNOTATION_IMPORT_MAX_CONCURRENT`	`5`	每个工作空间的最大并发标注导入任务数。

模型配置

Variable	Default	Description
`PLUGIN_BASED_TOKEN_COUNTING_ENABLED`	`false`	使用基于插件的 token 计数以精确跟踪用量。禁用时 token 计数返回 0（更快，但成本跟踪不够准确）。

多模态配置

Variable	Default	Description
`MULTIMODAL_SEND_FORMAT`	`base64`	文件发送给多模态 LLM 的方式。`base64` 将文件数据嵌入请求（兼容性更好），`url` 发送签名 URL 供模型抓取（更快、请求更小，但模型必须能访问 `FILES_URL`）。
`UPLOAD_IMAGE_FILE_SIZE_LIMIT`	`5` (Helm default)	直接上传的最大图片文件大小（MB，jpg、png、webp、gif、svg）。chart 默认 5（应用默认 10）。通过 `api.limits.uploadImageFileSize` 设置。
`UPLOAD_VIDEO_FILE_SIZE_LIMIT`	`100`	直接上传的最大视频文件大小（MB，mp4、mov、mpeg、webm）。
`UPLOAD_AUDIO_FILE_SIZE_LIMIT`	`50`	直接上传的最大音频文件大小（MB，mp3、m4a、wav、amr、mpga）。

Sentry 配置

Sentry 提供错误跟踪和性能监控。在 Helm 部署中，通过 values.yaml（api.sentry、worker.sentry、web.sentry）按服务启用 Sentry。

Variable	Default	Description
`SENTRY_DSN`	（为空）	Sentry DSN。启用 Sentry 时由 chart 按服务设置。
`SENTRY_TRACES_SAMPLE_RATE`	`1.0`	纳入性能追踪的请求比例（0.01 = 1%）。
`SENTRY_PROFILES_SAMPLE_RATE`	`1.0`	纳入 CPU/内存性能分析的请求比例。
`PLUGIN_SENTRY_ENABLED`	`false`	为插件守护进程服务启用 Sentry。
`PLUGIN_SENTRY_DSN`	（为空）	插件守护进程的 Sentry DSN。

Notion 集成配置

将 Dify 连接到 Notion 作为知识库数据源。在 https://www.notion.so/my-integrations 获取集成凭据。

Variable	Default	Description
`NOTION_INTEGRATION_TYPE`	`public`	`public` 使用标准 OAuth 2.0（需要 HTTPS 重定向 URL，以及 CLIENT_ID 和 CLIENT_SECRET），`internal` 使用直连集成令牌（支持 HTTP）。
`NOTION_CLIENT_SECRET`	（为空）	OAuth client secret。`public` 集成必填。
`NOTION_CLIENT_ID`	（为空）	OAuth client ID。`public` 集成必填。
`NOTION_INTERNAL_SECRET`	（为空）	来自 Notion 的直连集成令牌。`internal` 集成必填。

邮件配置

Dify 会为账户邀请、密码重置、登录验证码和 Human Input 节点通知发送邮件。配置三种受支持的服务商之一。邮件链接要求设置 CONSOLE_WEB_URL（见通用变量）。

Variable	Default	Description
`MAIL_TYPE`	`resend`	邮件服务商：`resend`、`smtp` 或 `sendgrid`。
`MAIL_DEFAULT_SEND_FROM`	（为空）	所有外发邮件的默认「From」地址。必填。

Resend

Variable	Default	Description
`RESEND_API_URL`	`https://api.resend.com`	Resend API 端点。自托管 Resend 或代理时可覆盖。
`RESEND_API_KEY`	（为空）	Resend API key。`MAIL_TYPE=resend` 时必填。

SMTP

三种 TLS 模式：隐式 TLS（SMTP_USE_TLS=true、SMTP_OPPORTUNISTIC_TLS=false、端口 465）、STARTTLS（SMTP_USE_TLS=true、SMTP_OPPORTUNISTIC_TLS=true、端口 587）或明文（SMTP_USE_TLS=false、端口 25）。

Variable	Default	Description
`SMTP_SERVER`	（为空）	SMTP 服务器地址。
`SMTP_PORT`	`465`	SMTP 服务器端口。STARTTLS 模式用 `587`。
`SMTP_USERNAME`	（为空）	SMTP 用户名。对 IP 白名单服务器可为空。
`SMTP_PASSWORD`	（为空）	SMTP 密码。对 IP 白名单服务器可为空。
`SMTP_USE_TLS`	`true`	启用 TLS。配合 `SMTP_OPPORTUNISTIC_TLS=false` 时使用隐式 TLS。
`SMTP_OPPORTUNISTIC_TLS`	`false`	使用 STARTTLS（显式 TLS）而非隐式 TLS。必须与 `SMTP_USE_TLS=true` 一起使用。
`SMTP_LOCAL_HOSTNAME`	（为空）	覆盖 SMTP HELO/EHLO 中发送的主机名。当你的 SMTP 服务器拒绝容器主机名时必填（Google Workspace、Microsoft 365 常见）。

SendGrid

Variable	Default	Description
`SENDGRID_API_KEY`	（为空）	SendGrid API key。`MAIL_TYPE=sendgrid` 时必填。

更多细节见 SendGrid 文档。

其他配置

索引

Variable	Default	Description
`INDEXING_MAX_SEGMENTATION_TOKENS_LENGTH`	`4000` (Helm default)	为知识库分段文档时，每个文本片段的最大 token 长度。值越大每个分段保留的上下文越多，值越小粒度越细。通过 `global.rag.indexingMaxSegmentationTokensLength` 设置。

Token 与邀请

所有 token 过期变量都控制存于 Redis 的一次性令牌保持有效的时长。过期后用户须重新申请新令牌。

Variable	Default	Description
`INVITE_EXPIRY_HOURS`	`72`	工作空间邀请链接的有效时长（小时）。
`RESET_PASSWORD_TOKEN_EXPIRY_MINUTES`	`5`	密码重置令牌的有效期（分钟）。
`EMAIL_REGISTER_TOKEN_EXPIRY_MINUTES`	`5`	邮箱注册令牌的有效期（分钟）。
`OWNER_TRANSFER_TOKEN_EXPIRY_MINUTES`	`5`	工作空间所有者转移令牌的有效期（分钟）。

代码执行沙箱

沙箱是一个独立服务，在隔离环境中运行 Python、JavaScript 和 Jinja2 代码节点。chart 会自动将 CODE_EXECUTION_ENDPOINT 指向集群内的沙箱服务。

Variable	Default	Description
`CODE_EXECUTION_ENDPOINT`	集群内沙箱服务 (Helm default)	沙箱服务端点。chart 将其指向内置的沙箱服务。
`CODE_EXECUTION_API_KEY`	`dify-sandbox`	沙箱鉴权用的 API key。必须与沙箱服务中的 `SANDBOX_API_KEY` 一致。
`CODE_EXECUTION_SSL_VERIFY`	`true`	校验沙箱连接的 SSL。
`CODE_EXECUTION_CONNECT_TIMEOUT`	`10`	连接超时（秒）。
`CODE_EXECUTION_READ_TIMEOUT`	`60`	读取超时（秒）。
`CODE_EXECUTION_WRITE_TIMEOUT`	`10`	写入超时（秒）。
`CODE_EXECUTION_POOL_MAX_CONNECTIONS`	`100`	到沙箱服务的最大并发 HTTP 连接数。
`CODE_EXECUTION_POOL_MAX_KEEPALIVE_CONNECTIONS`	`20`	沙箱连接池中保持存活的最大空闲连接数。
`CODE_EXECUTION_POOL_KEEPALIVE_EXPIRY`	`5.0`	空闲沙箱连接被关闭前的秒数。
`CODE_MAX_NUMBER`	`9223372036854775807`	代码节点输出允许的最大数值。
`CODE_MIN_NUMBER`	`-9223372036854775808`	代码节点输出允许的最小数值。
`CODE_MAX_STRING_LENGTH`	`400000`	代码节点输出的最大字符串长度。
`CODE_MAX_DEPTH`	`5`	输出数据结构的最大嵌套深度。
`CODE_MAX_PRECISION`	`20`	输出中浮点数的最大小数位数。
`CODE_MAX_STRING_ARRAY_LENGTH`	`30`	字符串数组输出的最大元素数。
`CODE_MAX_OBJECT_ARRAY_LENGTH`	`30`	对象数组输出的最大元素数。
`CODE_MAX_NUMBER_ARRAY_LENGTH`	`1000`	数值数组输出的最大元素数。
`TEMPLATE_TRANSFORM_MAX_LENGTH`	`400000`	模板转换节点输出的最大字符长度。

工作流运行时

Variable	Default	Description
`WORKFLOW_MAX_EXECUTION_STEPS`	`500`	单次工作流运行的最大节点执行数。超出会终止工作流。
`WORKFLOW_MAX_EXECUTION_TIME`	`3600`	工作室或应用内置环境中单次运行的最长时间（秒）。通过 `api.workflowMaxExecutionTimeSeconds` 设置。已部署环境中的运行使用独立的时限，通过 `enterprise.workflowMaxExecutionTimeSeconds` 设置（默认 `1200` 秒）。
`WORKFLOW_CALL_MAX_DEPTH`	`5`	工作流嵌套调用工作流的最大深度。防止无限递归。
`MAX_VARIABLE_SIZE`	`204800`	单个工作流变量的最大大小（字节，200 KB）。
`WORKFLOW_FILE_UPLOAD_LIMIT`	`10`	单次工作流执行可上传的最大文件数。
`WORKFLOW_NODE_EXECUTION_STORAGE`	`rdbms`	工作流节点执行记录的存储位置。`rdbms` 将所有内容存于数据库，`hybrid` 将新数据存于对象存储并从两者读取。
`DSL_EXPORT_ENCRYPT_DATASET_ID`	`true`	导出 DSL 文件时加密 dataset ID。设为 `false` 可导出明文 ID，便于跨环境导入。

工作流追踪

这些设置用于 API 和 worker 中的工作流追踪集成，与 OpenTelemetry 遥测配置相互独立。

变量	默认值	说明
`OPS_TRACE_UNIFIED_ENABLED`	`false`（Helm 默认值）	设为 `true` 可在 LangSmith 或 Arize Phoenix 中使用统一工作流追踪。保留 `false` 则沿用原有追踪行为。其他提供方仍使用原有实现。通过 `api.opsTrace.unifiedEnabled` 设置。
`OPS_TRACE_PARENT_CONTEXT_TTL_SECONDS`	`3900`（Helm 默认值）	父级追踪上下文的保留时间，单位为秒，用于将子工作流的追踪关联到父级追踪。通过 `api.opsTrace.parentContextTtlSeconds` 设置，值为正整数。
`OPS_TRACE_RETRYABLE_DISPATCH_MAX_RETRIES`	`780`（Helm 默认值）	向提供方发送追踪数据时，遇到暂时性故障的最大重试次数。不影响工作流执行的重试次数。通过 `api.opsTrace.retryableDispatchMaxRetries` 设置，值为正整数。

启用统一追踪后，OPS_TRACE_PARENT_CONTEXT_TTL_SECONDS 不得小于 OPS_TRACE_RETRYABLE_DISPATCH_MAX_RETRIES 与 OPS_TRACE_RETRYABLE_DISPATCH_DELAY_SECONDS 的乘积，否则无法通过应用配置校验。重试间隔默认为 5 秒，可通过 extraEnv 修改。使用默认重试次数和间隔时，父级上下文至少需保留 780 × 5 = 3900 秒。

工作流存储仓库

以下变量选择由哪个后端实现处理工作流执行数据。默认的 SQLAlchemy 仓库将所有内容存于数据库。

Variable	Default	Description
`CORE_WORKFLOW_EXECUTION_REPOSITORY`	`core.repositories.sqlalchemy_workflow_execution_repository.SQLAlchemyWorkflowExecutionRepository`	工作流执行记录的仓库实现。
`CORE_WORKFLOW_NODE_EXECUTION_REPOSITORY`	`core.repositories.sqlalchemy_workflow_node_execution_repository.SQLAlchemyWorkflowNodeExecutionRepository`	工作流节点执行记录的仓库实现。
`API_WORKFLOW_RUN_REPOSITORY`	`repositories.sqlalchemy_api_workflow_run_repository.DifyAPISQLAlchemyWorkflowRunRepository`	工作流运行 API 操作的服务层仓库。
`API_WORKFLOW_NODE_EXECUTION_REPOSITORY`	`repositories.sqlalchemy_api_workflow_node_execution_repository.DifyAPISQLAlchemyWorkflowNodeExecutionRepository`	工作流节点执行 API 操作的服务层仓库。
`LOOP_NODE_MAX_COUNT`	`100`	Loop 节点的最大迭代次数。防止无限循环。
`MAX_PARALLEL_LIMIT`	`10`	工作流中并行分支的最大数量。

GraphEngine Worker 池

Variable	Default	Description
`GRAPH_ENGINE_MIN_WORKERS`	`3`	每个 GraphEngine 实例的最小 worker 数。
`GRAPH_ENGINE_MAX_WORKERS`	`10`	每个 GraphEngine 实例的最大 worker 数。
`GRAPH_ENGINE_SCALE_UP_THRESHOLD`	`0`（Helm 默认值）	触发新增 worker 的队列深度。通过 `api.graphEngineScaleUpThreshold` 设置。
`GRAPH_ENGINE_SCALE_DOWN_IDLE_TIME`	`5.0`	移除多余 worker 前的空闲时间（秒）。

工作流日志清理

chart 通过 workerBeat.enableWorkflowLogCleanup 启用此功能，它会在 beat ConfigMap 上设置 WORKFLOW_LOG_CLEANUP_ENABLED。其余变量不由 chart 设置，请通过 worker 和 beat 服务的 extraEnv 配置。

Variable	Default	Description
`WORKFLOW_LOG_CLEANUP_ENABLED`	`false` (Helm default)	启用每天凌晨 2:00 自动清理工作流执行日志。通过 `workerBeat.enableWorkflowLogCleanup` 设置。
`WORKFLOW_LOG_RETENTION_DAYS`	`30`	清理前保留工作流日志的天数。
`WORKFLOW_LOG_CLEANUP_BATCH_SIZE`	`100`	每个清理批次处理的日志条数。
`WORKFLOW_LOG_CLEANUP_SPECIFIC_WORKFLOW_IDS`	（为空）	限定清理范围的工作流 ID 列表，逗号分隔。为空时清理所有工作流日志。

HTTP Request 节点

以下变量用于配置工作流中调用外部 API 的 HTTP Request 节点。

Variable	Default	Description
`HTTP_REQUEST_NODE_MAX_TEXT_SIZE`	`1048576`	最大文本响应大小（字节，1 MB）。超过此值的响应会被截断。
`HTTP_REQUEST_NODE_MAX_BINARY_SIZE`	`10485760`	最大二进制响应大小（字节，10 MB）。
`HTTP_REQUEST_NODE_SSL_VERIFY`	`true`	校验 SSL 证书。用自签名证书测试时可禁用。
`HTTP_REQUEST_MAX_CONNECT_TIMEOUT`	`10`	用户在工作流编辑器中可设置的最大连接超时（秒）。
`HTTP_REQUEST_MAX_READ_TIMEOUT`	`600`	读取超时上限（秒）。
`HTTP_REQUEST_MAX_WRITE_TIMEOUT`	`600`	写入超时上限（秒）。

Webhook

Variable	Default	Description
`WEBHOOK_REQUEST_BODY_MAX_SIZE`	`10485760`	最大 webhook 负载大小（字节，10 MB）。更大的负载会被拒绝并返回 413 错误。

SSRF 防护

Dify 所有出站 HTTP 请求（HTTP 节点、图片下载等）都经由一个代理路由，该代理会拦截发往内部/私有 IP 段的请求，防止服务端请求伪造（SSRF）攻击。启用 SSRF 代理时，chart 会自动设置 SSRF_PROXY_HTTP_URL 和 SSRF_PROXY_HTTPS_URL。

Variable	Default	Description
`SSRF_PROXY_HTTP_URL`	集群内 SSRF 代理 (Helm default)	HTTP 请求的 SSRF 代理 URL。
`SSRF_PROXY_HTTPS_URL`	集群内 SSRF 代理 (Helm default)	HTTPS 请求的 SSRF 代理 URL。
`SSRF_POOL_MAX_CONNECTIONS`	`100`	SSRF HTTP 客户端池的最大并发连接数。
`SSRF_POOL_MAX_KEEPALIVE_CONNECTIONS`	`20`	SSRF 池中保持存活的最大空闲连接数。
`SSRF_POOL_KEEPALIVE_EXPIRY`	`5.0`	空闲 SSRF 连接被关闭前的秒数。
`SSRF_PROXY_ALLOW_PRIVATE_IPS`	（为空；Docker Compose 默认值）	仅适用于 Docker Compose。允许通过 SSRF 代理的私有 IP 或 CIDR 网段，以逗号或空格分隔。
`SSRF_PROXY_ALLOW_PRIVATE_DOMAINS`	（为空；Docker Compose 默认值）	仅适用于 Docker Compose。允许通过 SSRF 代理的内部域名，以逗号或空格分隔。
`RESPECT_XFORWARD_HEADERS_ENABLED`	`false`	信任反向代理传来的 X-Forwarded-For/Proto/Port 头。仅在单个可信反向代理之后启用。

Helm 部署在 values.yaml 中配置 SSRF 代理策略：

代码执行节点的沙箱使用 ssrfProxy.squidConf。API 和 worker 经由同一代理发送的请求也受此策略控制。
由 Sandbox Gateway 管理的 Agent 沙箱使用独立策略，通过 sandboxGateway.ssrfProxy.squidConf 配置。

将上述两个 Docker Compose 放行变量加入 ssrfProxy.extraEnv 不会改变代理策略。

Agent 配置

Variable	Default	Description
`MAX_TOOLS_NUM`	`10`	一个 agent 可同时使用的最大工具数。
`MAX_ITERATIONS_NUM`	`99`	单次 agent 执行的最大推理迭代次数。

UPLOAD_SKILL_FILE_SIZE_LIMIT

默认值：50 导入 Skill 库或作为内嵌 Skill 上传到 Agent 的 .zip 或 .skill 包的最大大小（MiB）。通过 api.limits.uploadSkillFileSize 设置。

Dify CLI 与编程 API

变量	默认值	说明
`OPENAPI_ENABLED`	`false`	启用 `/openapi/v1/*` 接口组（供 `difyctl` 及其他编程客户端使用）。为 `false` 时 chart 同时会关闭网关路由。通过 `api.openapi.enabled` 设置。
`ENABLE_OAUTH_BEARER`	`true`	OAuth bearer 中间件：校验设备流令牌与服务 API 的 bearer 认证。CLI 登录流程依赖它。通过 `api.enableOauthBearer` 设置。

Web 前端服务

以下变量仅由 Next.js web 前端容器使用，不影响 Python 后端。

Variable	Default	Description
`TEXT_GENERATION_TIMEOUT_MS`	`60000`	流式文本生成 UI 的前端超时。若数据流停滞超过此时长，UI 会暂停渲染。
`ALLOW_INLINE_STYLES`	`false`	允许用户生成的 Markdown 内容中使用内联 `style` 属性和 `<style>` 块。出于安全考虑默认禁用。
`ALLOW_UNSAFE_DATA_SCHEME`	`false`	允许渲染使用 `data:` 协议的 URL。出于安全考虑默认禁用。
`MARKDOWN_FORM_FIELD_NAME_EXTRA_CHARS`	（为空；Helm 默认值）	聊天回复中 Markdown 表单字段的 `name` 属性可使用的额外字符。将 `web.markdownFormFieldNameExtraChars` 设为 `()！？` 等字符串，即可使用 `field()！？` 这样的字段名。字段名必须以 Unicode 字母开头，后续字符可为 Unicode 字母、标记、数字、`_`、`-` 或在此添加的字符。添加的每个字符都按字面含义处理。名称无效的字段不会显示。
`MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH`	`128`（Helm 默认值）	聊天回复中 Markdown 表单字段的 `name` 属性的最大字符数。名称超长的字段不会显示。通过 `web.markdownFormFieldNameMaxLength` 设置。
`MARKETPLACE_URL`	由 chart 设置 (Helm default)	前端中展示的市场 web URL。通过 `global.marketplace.url` 设置。

企业版专属配置

以下变量仅适用于 Dify 企业版。当 enterprise.enabled 为 true 时，Helm chart 会将它们设置到 API 和 worker 的 ConfigMap 上。

Dify Enterprise 3.13.0 用 DEPLOYMENT_EDITION（取值 ENTERPRISE 或 COMMUNITY）替代了 ENTERPRISE_ENABLED。chart 会自动设置新变量；升级时请同步更新仍引用 ENTERPRISE_ENABLED 的 extraEnv 条目、自定义 overlay 或自动化脚本。

Variable	Default	Description
`DEPLOYMENT_EDITION`	`ENTERPRISE`（启用企业版时由 chart 设置）	服务运行的部署版本：`COMMUNITY` 或 `ENTERPRISE`，自 Dify Enterprise 3.13.0 起替代 `ENTERPRISE_ENABLED`。启用企业版功能前请就授权事宜联系你的 Dify 代表。
`CAN_REPLACE_LOGO`	`true`（启用企业版时的 Helm default）	允许自定义工作空间/控制台 Logo。chart 为企业版部署将其设为 `true`。
`MODEL_LB_ENABLED`	`true`（启用企业版时的 Helm default）	为某个模型在多个凭据间启用负载均衡。chart 为企业版部署将其设为 `true`（应用默认为 `false`）。
`ENTERPRISE_API_URL`	集群内企业版服务 (Helm default)	企业版后端服务的内部 URL。由 chart 自动设置。
`ENTERPRISE_REQUEST_TIMEOUT`	`5`	Dify API 调用企业版后端的最大超时（秒）。
`ENTERPRISE_DISABLE_RUNTIME_CREDENTIAL_CHECK`	`false`	为 `true` 时，凭据策略检查仅在保存工作流时进行，而非运行时。以一致性换取运行时性能。
`ENABLE_LICENSE_EXPIRY_NOTICE`	`true`	许可证临近到期时，在控制台显示到期倒计时角标。设为 `false` 可隐藏角标，许可证状态与相关限制不受影响。通过 api 服务的 `extraEnv` 配置（chart 不设置此变量）。Dify Enterprise 3.12.1 起可用。
`RBAC_ENABLED`	`true`（`enterpriseRbac.enabled` 为 `true` 时由 chart 设置）	启用 RBAC 权限服务集成。Dify Enterprise 3.12.1 起，chart 也会将其设置到 worker 的 ConfigMap，使 worker 执行相同的权限检查。
`ENTERPRISE_RBAC_API_URL`	集群内 RBAC 服务（Helm 默认）	企业版 RBAC 服务的内部地址。由 chart 随 `RBAC_ENABLED` 一同自动设置。
`INNER_API`	`true`（启用 inner API 时由 chart 设置）	启用用于服务间调用的内部 API。
`EDITION`	`SELF_HOSTED`	部署形态标识，在控制台侧暴露为 `deployment_edition`。保持默认值；其他取值会启用企业部署中无法工作的托管服务行为。通过 `global.edition` 设置。
`WEBAPP_PUBLIC_ACCESS_ENABLED`	`true`	是否允许将 Web 应用的访问级别设为公开（任何拥有链接的人无需认证即可访问）。设为 `false` 将在整个部署关闭公开访问，Web 应用访问控制中的「任何人」选项会置灰。通过 `enterprise.webappPublicAccessEnabled` 设置。

部署环境（App Runner）

以下变量用于配置部署环境，也就是你在企业管理后台的 环境管理 中创建、再把应用部署进去的那些环境。 Enterprise 服务会在 Kubernetes 中创建 App Runner 工作负载，用来运行各环境中的应用。共享模式的环境只有一个工作负载，承载其中所有应用；隔离模式下，每个应用各有一个工作负载。 chart 会将这些变量写入 enterprise 的 ConfigMap 和 Secret。它们不影响工作室中的运行，也不影响应用的内置环境（你发布的版本直接在此上线）。这两者运行在 API 和 worker 上，由本页其余部分的变量控制。安装或升级前，把 enterprise.appRunner.controlSigningKey 和 enterprise.webappPassportSigningKey 中的占位值 #REPLACE_ME# 替换为你自己的密钥。使用 ExternalSecret 时，把这两个密钥添加到 global.externalSecret.remoteKey 指定的远程 Secret（默认为 dify）中，属性名分别为 enterprise.appRunner.controlSigningKey 和 enterprise.webappPassportSigningKey。

有两个配置项限制单次运行的最长时间，分别适用于不同的运行：

部署环境中的运行：enterprise.workflowMaxExecutionTimeSeconds，默认 1200 秒（20 分钟）。
工作室中的运行和内置环境：api.workflowMaxExecutionTimeSeconds，默认 3600 秒（60 分钟）。

两者写入的变量都叫 WORKFLOW_MAX_EXECUTION_TIME，但分属不同的 ConfigMap，改一个不会影响另一个。由于默认值不同，在工作室中能跑完的工作流，部署后仍可能中途停止。运行时间较长的工作流，请先在部署环境中测试，再投入使用。

变量	Helm 默认值	说明
`APP_RUNNER_CONTROL_SIGNING_KEY`	`#REPLACE_ME#`	Enterprise 服务用来验证 App Runner 工作负载身份的密钥。通过 `enterprise.appRunner.controlSigningKey` 设置。
`WEBAPP_PASSPORT_SIGNING_KEY`	`#REPLACE_ME#`	部署环境中的 Web 应用会向终端用户发放会话令牌，此密钥用于为这些令牌签名。通过 `enterprise.webappPassportSigningKey` 设置。
`WORKFLOW_MAX_EXECUTION_TIME`	`1200`	部署环境中单次运行的最长时间，单位为秒。超时的运行会停止，并返回 `request_timeout`。阻塞式返回时，响应为 HTTP 504；流式返回时，事件流中会包含一个 `status: 504` 的 `error` 事件。通过 `enterprise.workflowMaxExecutionTimeSeconds` 设置。
`WEBAPP_PASSPORT_TTL`	`86400s`	终端用户登录部署环境中的 Web 应用后，保持登录状态的时长。取值须为大于 0 的时长（`86400s` 即 24 小时）。如果用户用 Dify 账户登录，账户登录过期时，会话也会随之结束。通过 `enterprise.webappPassportTtl` 设置。
`APP_RUNNER_LOG_RETENTION_DAYS`	`30`	企业管理后台在调用记录中保留部署环境运行记录的天数（最小值为 `1`）。每天的清理任务会删除更早的记录。调小该值后，下一次清理会删除新保留期之外的全部运行记录。通过 `enterprise.appRunnerLog.retentionDays` 设置。
`APP_DEPLOY_CLUSTER_ROLE_ENABLED`	`false`	设为 `true` 后，环境可运行在 Helm release 所在命名空间以外的命名空间中。启用后，创建环境的人可在命名空间字段中为环境选择命名空间。通过 `enterprise.appDeploy.clusterRole.enabled` 设置，不要用 `extraEnv`，这样 chart 才会同时创建所需的 ClusterRole。该角色允许 Enterprise 服务的 ServiceAccount 访问所有命名空间中的 Deployment、Service、ConfigMap 和 Secret。需在环境使用前先创建好每个目标命名空间，并在其中添加 `imagePullSecrets` 列出的 Secret。改回 `false` 之前，先删除使用其他命名空间的环境。
`APP_RUNNER_IMAGE`	`langgenius/dify-ee-app-runner` 仓库	Enterprise 服务创建 App Runner 工作负载时使用的镜像。要从私有镜像仓库拉取，先把该镜像同步到你的仓库，再将仓库地址指向这份副本；tag 不同时，一并修改 tag。通过 `enterprise.appRunner.image.repository` 和 `enterprise.appRunner.image.tag` 设置。
`APP_RUNNER_IMAGE_PULL_SECRETS`	`imagePullSecrets` 中的名称	附加到 App Runner 工作负载上的镜像拉取 Secret 名称，以逗号分隔。工作负载只在自己所在的命名空间中查找这些 Secret，因此环境用到的每个命名空间里都要有这些 Secret。通过根级 `imagePullSecrets` 设置。
`APP_RUNNER_WORKER_POOL_SIZE`	`0`	每个 App Runner 工作负载中的 worker 进程数。设为 `0` 时，按工作负载的 CPU 自动计算：每核 8 个 worker，最少 4 个。共享模式下，工作负载的 CPU 取自环境的设置；隔离模式下取自应用的设置。设为正数时，所有工作负载的 worker 数都固定为该值，每个工作负载的内存 request 和 limit 也会随之提高。通过 `enterprise.appRunner.workerPoolSize` 设置。
`APP_RUNNER_RECONCILE_INTERVAL_SEC`	`10`	每个 App Runner 工作负载向 Enterprise 服务查询部署、下线和设置变更的间隔，单位为秒。值越小，变更生效越快；值越大，发往 Enterprise 服务的查询越少。取值范围为 `1`～`60`，超出此范围时 Enterprise 服务无法启动。通过 `enterprise.appRunner.reconcileIntervalSeconds` 设置。

以下变量由 chart 生成，无需配置：

变量	说明
`APP_RUNNER_CONTROL_ENDPOINT`	App Runner 工作负载连接的 Enterprise 服务地址。
`APP_RUNNER_CODE_EXECUTION_ENDPOINT`	代码执行节点使用的沙箱地址。
`APP_RUNNER_CODE_EXECUTION_API_KEY`	用于认证 App Runner 发往沙箱的请求。由 `global.innerApiKey` 派生。
`APP_RUNNER_PLUGIN_DAEMON_ENDPOINT`	插件守护进程地址。

App Runner 遥测

chart 只在 global.otel.enabled 和 enterpriseCollector.enabled 均为 true 时设置以下变量，这两项默认都已开启。任一项关闭，App Runner 工作负载就不会发送遥测数据。

变量	Helm 默认值	说明
`APP_RUNNER_OTEL_ENDPOINT`	集群内的企业版收集器	App Runner 工作负载发送遥测数据的目标地址。由 chart 设置。
`APP_RUNNER_OTEL_PROTOCOL`	`grpc`	OTLP 传输协议。由 chart 设置。
`APP_RUNNER_OTLP_AUTH`	`Bearer` 后接 `global.innerApiKey`	OTLP 认证信息，存储在 Secret 中。由 chart 设置。
`APP_RUNNER_OTEL_TRACES_SAMPLER_RATIO`	`"0.2"`	追踪采样比例。不想采样任何追踪时，使用字符串 `"0"`：数值 `0` 会渲染为 `1.0`，反而全部采样。通过 `global.otel.samplingRate` 设置。该配置项也会设置 API 和 worker 的 `ENTERPRISE_OTEL_SAMPLING_RATE` 与 `OTEL_SAMPLING_RATE`。
`APP_RUNNER_OTEL_INCLUDE_CONTENT`	`false`	设为 `true` 后，遥测数据会包含工作流、节点和消息的输入与输出。这些内容可能含有终端用户的数据，仅在你的遥测后端允许存储此类数据时开启。通过 `global.otel.sender.includeContent` 设置。该配置项也会设置 API 和 worker 的 `ENTERPRISE_INCLUDE_CONTENT`。

企业版遥测

用于企业版审计和追踪的 OpenTelemetry 导出。当 enterprise.enabled 和 global.otel.enabled 均为 true 时，chart 会启用这些变量，并将端点接入集群内的企业版收集器。

Variable	Default	Description
`ENTERPRISE_TELEMETRY_ENABLED`	`true`（Helm 默认值）	启用企业版遥测采集。要求企业版部署（`DEPLOYMENT_EDITION=ENTERPRISE`）。当 `enterprise.enabled` 和 `global.otel.enabled` 均为 `true` 时，chart 将此变量设为 `true`。应用默认值为 `false`。
`ENTERPRISE_OTLP_ENDPOINT`	集群内收集器 (Helm default)	企业版 OTel 收集器端点。
`ENTERPRISE_OTLP_PROTOCOL`	`grpc`（Helm default；应用默认 `http`）	OTLP 协议：`http` 或 `grpc`。
`ENTERPRISE_OTLP_HEADERS`	（为空）	OTLP 导出的鉴权头（`key=value,key2=value2`）。
`ENTERPRISE_OTLP_API_KEY`	（为空）	企业版 OTLP 导出鉴权的 Bearer 令牌。
`ENTERPRISE_INCLUDE_CONTENT`	`false`	在追踪中包含输入/输出内容。默认关闭，以免记录敏感数据。通过 `global.otel.sender.includeContent` 设置。
`ENTERPRISE_SERVICE_NAME`	`dify`	OTel 资源上报的服务名。
`ENTERPRISE_OTEL_SAMPLING_RATE`	`0.2`（Helm 默认值）	企业版追踪的采样率（0.0 到 1.0）。通过 `global.otel.samplingRate` 设置。应用默认值为 `1.0`。

模型供应商与工具排序配置

自定义应用界面中可用的工具和模型供应商及其显示顺序。使用逗号分隔的值，各项之间不加空格。chart 从 values.yaml 中的 api.positionTool 和 api.positionProvider 写入这些变量。

Variable	Default	Description
`POSITION_TOOL_PINS`	（为空）	将特定工具置顶。范例：`bing,google`。
`POSITION_TOOL_INCLUDES`	（为空）	仅显示列出的工具。不设置时所有工具均可用。
`POSITION_TOOL_EXCLUDES`	（为空）	隐藏特定工具（置顶的工具不受影响）。
`POSITION_PROVIDER_PINS`	（为空）	将特定模型供应商置顶。范例：`openai,anthropic`。
`POSITION_PROVIDER_INCLUDES`	（为空）	仅显示列出的供应商。不设置时所有供应商均可用。
`POSITION_PROVIDER_EXCLUDES`	（为空）	隐藏特定供应商（置顶的供应商不受影响）。

插件守护进程配置

插件守护进程是一个独立服务，管理插件生命周期（安装、执行、升级）。启用插件守护进程时，chart 会自动设置守护进程 URL、密钥和市场相关设置。

Variable	Default	Description
`PLUGIN_DAEMON_URL`	集群内插件守护进程服务 (Helm default)	插件守护进程服务 URL。
`PLUGIN_DAEMON_KEY`	由 chart 设置 (Helm default)	插件守护进程的鉴权密钥。从 `global.innerApiKey` 派生。
`PLUGIN_MODEL_PROVIDERS_CACHE_TTL`	`86400`	在 Redis 中缓存各租户插件模型供应商列表的时长（秒），默认 24 小时。租户安装、卸载或升级插件时，Dify 会使该缓存失效。
`PLUGIN_DAEMON_PORT`	`5002` (Helm default)	插件守护进程监听端口。
`PLUGIN_DAEMON_TIMEOUT`	`600.0`	所有插件守护进程请求的超时（秒）。
`PLUGIN_MAX_PACKAGE_SIZE`	`52428800` (Helm default)	最大插件包大小（字节，50 MB）。
`PLUGIN_MAX_FILE_SIZE`	`52428800`	插件返回给 Dify 的单个文件大小上限，单位为字节（50 MiB）。超出上限的文件会被拒绝。通过 `api.limits.pluginFileSize` 配置，该设置同时应用于 API 和 worker。这是 Dify 应用配置，不限制插件安装包的大小。
`PLUGIN_MODEL_SCHEMA_CACHE_TTL`	`3600`	缓存插件模型 schema 的时长（秒）。
`MARKETPLACE_ENABLED`	`true` (Helm default)	启用插件市场。禁用时仅可使用本地安装的插件。通过 `global.marketplace.enabled` 设置。
`MARKETPLACE_API_URL`	`https://marketplace.dify.ai` (Helm default)	市场 API 端点。通过 `global.marketplace.apiUrl` 设置。
`FORCE_VERIFYING_SIGNATURE`	`true`	安装插件前要求有效签名。
`PLUGIN_MAX_EXECUTION_TIMEOUT`	`600`	插件执行超时（秒，插件守护进程一侧）。
`PIP_MIRROR_URL`	（为空）	插件守护进程安装插件依赖时使用的自定义 PyPI 镜像 URL。适用于离网环境。
`ENDPOINT_URL_TEMPLATE`	由 `global.consoleApiDomain` 推导 (Helm default)	插件端点的 URL 模板。`{hook_id}` 会被替换为实际的 hook ID。
`PLUGIN_MODEL_PROVIDERS_CACHE_ENABLED`	`false`（chart 固定值）	是否在 Redis 中缓存各租户的插件模型供应商列表。由于插件也可能从控制面板安装、绕过会使缓存失效的租户流程，chart 将其关闭。该变量设置在 API ConfigMap 上。

Agent Backend 配置

以下变量设置在 agent-backend 服务上，该服务为 Agent 功能提供支撑。完整部署方式见 Agent Sandbox 部署。

变量	默认值	说明
`DIFY_AGENT_SERVER_SECRET_KEY`	开发默认值（生产环境必须替换）	Agent 工具回调令牌的加密密钥，base64url 编码的 32 字节随机值。通过 `agentBackend.serverSecretKey` 设置。
`DIFY_AGENT_API_TOKEN`	自动派生	agent-backend 访问 Dify API 的认证令牌。chart 从 `global.innerApiKey` 派生，无需单独设置。
`DIFY_AGENT_RUN_RETENTION_SECONDS`	`7200`（2 小时，Helm 默认值）	Agent 运行记录及每次运行的事件流在 Redis 中的保留时长，从最后一次写入起计，单位为秒。调低此值可更早释放 Redis 内存，但数据也会更早过期并被删除，能查询运行记录和事件的时间随之缩短。通过 `agentBackend.runRetentionSeconds` 设置，值为不小于 `1` 的整数。
`DIFY_AGENT_RUN_EVENT_STREAM_MAX_LENGTH`	`5000`（Helm 默认值）	每次 Agent 运行保留用于重放的事件数量上限，是近似值。即使尚未达到保留时长，较早的事件也可能被删除。通过 `agentBackend.runEventStreamMaxLength` 设置。
`DIFY_AGENT_RUN_TIMEOUT_SECONDS`	`3600`	单次 Agent 运行的模型与工具循环的墙钟截止时间（秒）。Agent 运行同时受 `APP_MAX_EXECUTION_TIME` 和 `WORKFLOW_MAX_EXECUTION_TIME` 约束，实际上限取三者中的最小值。通过 `agentBackend.runTimeoutSeconds` 设置。
`DIFY_AGENT_STUB_UPLOAD_FILE_SIZE_LIMIT`	`50`	Agent 经 Agent Stub 上传路径保存或返回的单个文件大小上限（MiB）。通过 `agentBackend.stubUploadFileSizeLimit` 设置。
`DIFY_AGENT_SHELL_REDACT_PATTERNS`	（空）	在内置凭证脱敏之外，对 Agent 模型读取的命令输出额外脱敏的正则模式，JSON 数组格式。通过 `agentBackend.extraEnv` 设置。
`DIFY_AGENT_STREAM_TEXT_DELTA_COALESCING_ENABLED`	`true`（Helm 默认值）	合并流式文本更新后再发送。设为 `false` 时，每次更新单独发送。通过 `agentBackend.streamTextDelta.coalescingEnabled` 设置。
`DIFY_AGENT_STREAM_TEXT_DELTA_FLUSH_INTERVAL_MS`	`100`（Helm 默认值）	启用文本更新合并后，发送已缓存更新的目标间隔，单位为毫秒。调低此值可更早发送已缓存的文本；调高可合并更多更新。实际间隔可能更长。通过 `agentBackend.streamTextDelta.flushIntervalMs` 设置，值为正整数。
`DIFY_AGENT_STREAM_TEXT_DELTA_MAX_CHARS`	`4096`（Helm 默认值）	启用文本更新合并后，触发发送的字符数阈值。调低此值可更早发送，每批文本也更少；调高则可积累更多文本。达到或超过阈值时，会立即发送已缓存的文本，不会截断回复。通过 `agentBackend.streamTextDelta.maxChars` 设置，值为正整数。

Agent 快照与文件传输超时

这些超时设置控制请求和文件传输的等待时间，与 Agent 的运行时限相互独立。所有值的单位均为秒，且必须大于 0；调高后，系统会等待更久才判定超时。

变量	默认值	说明
`AGENT_BACKEND_HOME_SNAPSHOT_TIMEOUT_SECONDS`	`45`（Helm 默认值）	API/worker 请求 Agent 后端创建或删除 Home 文件快照，以及从快照恢复执行环境时的超时时间。通过 `api.agentBackend.homeSnapshotTimeoutSeconds` 设置。
`AGENT_BACKEND_BINDING_FILE_DOWNLOAD_TIMEOUT_SECONDS`	`240`（Helm 默认值）	API/worker 通过 Agent 后端从 Agent 执行环境获取文件时的超时时间。通过 `api.agentBackend.bindingFileDownloadTimeoutSeconds` 设置。
`DIFY_AGENT_BINDING_FILE_DOWNLOAD_COMMAND_TIMEOUT_SECONDS`	`210`（Helm 默认值）	Agent 后端等待沙箱命令完成的超时时间。该命令将请求的文件上传到 Dify，供用户下载。通过 `agentBackend.bindingFileDownloadCommandTimeoutSeconds` 设置。

DIFY_AGENT_BINDING_FILE_DOWNLOAD_COMMAND_TIMEOUT_SECONDS 应大于 CLI 的上传时限 180 秒，且小于 AGENT_BACKEND_BINDING_FILE_DOWNLOAD_TIMEOUT_SECONDS。

Agent 后端 HTTP 客户端

这些设置用于 Agent 后端访问 Dify API 和插件守护进程的 HTTP 客户端。每个客户端有独立的连接池，使用该客户端的 Agent 运行共享这一连接池。

变量	默认值	说明
`DIFY_AGENT_OUTBOUND_HTTP_CONNECT_TIMEOUT`	`10`（Helm 默认值）	建立连接的超时时间，单位为秒。通过 `agentBackend.outboundHttp.connectTimeoutSeconds` 设置。
`DIFY_AGENT_OUTBOUND_HTTP_READ_TIMEOUT`	`600`（Helm 默认值）	等待下一个响应数据块的超时时间，单位为秒，不是整个请求的时限。通过 `agentBackend.outboundHttp.readTimeoutSeconds` 设置。
`DIFY_AGENT_OUTBOUND_HTTP_WRITE_TIMEOUT`	`30`（Helm 默认值）	发送一个请求数据块的超时时间，单位为秒。通过 `agentBackend.outboundHttp.writeTimeoutSeconds` 设置。
`DIFY_AGENT_OUTBOUND_HTTP_POOL_TIMEOUT`	`10`（Helm 默认值）	等待连接池中可用连接的超时时间，单位为秒。通过 `agentBackend.outboundHttp.poolTimeoutSeconds` 设置。
`DIFY_AGENT_OUTBOUND_HTTP_MAX_CONNECTIONS`	`100`（Helm 默认值）	每个客户端连接池的最大并发连接数。通过 `agentBackend.outboundHttp.maxConnections` 设置。
`DIFY_AGENT_OUTBOUND_HTTP_MAX_KEEPALIVE_CONNECTIONS`	`20`（Helm 默认值）	每个连接池中为复用而保留的最大空闲连接数。通过 `agentBackend.outboundHttp.maxKeepaliveConnections` 设置。
`DIFY_AGENT_OUTBOUND_HTTP_KEEPALIVE_EXPIRY`	`30`（Helm 默认值）	空闲连接的保留时间，单位为秒，超时后连接失效。通过 `agentBackend.outboundHttp.keepaliveExpirySeconds` 设置。

延长超时时间可给较慢的操作留出更多时间，但超时报错也会相应推迟。提高连接数上限可减少等待空闲连接的时间，但会增加目标服务的并发负载。保留更多空闲连接或延长保留时间有利于复用，同时也会持续占用资源。

OTLP / OpenTelemetry 配置

应用级 OpenTelemetry 埋点（区别于上面的企业版遥测）。启用时，Dify 会对 Flask 进行埋点并将遥测数据导出到 OTLP 收集器。

Variable	Default	Description
`ENABLE_OTEL`	`false`	应用级 OpenTelemetry 埋点的总开关。
`OTLP_TRACE_ENDPOINT`	（为空）	专用的 trace 端点 URL。未设置时回退到 `{OTLP_BASE_ENDPOINT}/v1/traces`。
`OTLP_METRIC_ENDPOINT`	（为空）	专用的 metric 端点 URL。未设置时回退到 `{OTLP_BASE_ENDPOINT}/v1/metrics`。
`OTLP_BASE_ENDPOINT`	`http://localhost:4318`	OTLP 收集器基础 URL。
`OTLP_API_KEY`	（为空）	OTLP 鉴权用的 API key。以 `Authorization: Bearer` 头发送。
`OTEL_EXPORTER_TYPE`	`otlp`	导出器类型。`otlp` 导出到收集器，其他值使用控制台导出器。
`OTEL_EXPORTER_OTLP_PROTOCOL`	（为空）	OTLP 导出协议。`grpc` 使用 gRPC 导出器，其他值使用 HTTP。
`OTEL_SAMPLING_RATE`	`0.2`（Helm 默认值）	追踪的请求比例（0.2 = 20%）。通过 `global.otel.samplingRate` 设置。应用默认值为 `0.1`。
`OTEL_BATCH_EXPORT_SCHEDULE_DELAY`	`5000`	批量导出之间的延迟（毫秒）。
`OTEL_MAX_QUEUE_SIZE`	`2048`	丢弃前队列中 span 的最大数量。
`OTEL_MAX_EXPORT_BATCH_SIZE`	`512`	每个导出批次的最大 span 数。
`OTEL_METRIC_EXPORT_INTERVAL`	`60000`	Metric 导出间隔（毫秒）。
`OTEL_BATCH_EXPORT_TIMEOUT`	`10000`	批量 span 导出超时（毫秒）。
`OTEL_METRIC_EXPORT_TIMEOUT`	`30000`	Metric 导出超时（毫秒）。

杂项

Variable	Default	Description
`CSP_WHITELIST`	（为空）	在 Content Security Policy 头中额外允许的域名。
`ALLOW_EMBED`	`false`	允许 Dify 页面被嵌入 iframe。为 `false` 时设置 `X-Frame-Options: DENY` 以防点击劫持。
`SWAGGER_UI_ENABLED`	`false` (Helm default)	暴露 Swagger UI 以浏览 API 文档。Swagger 端点会绕过鉴权。chart 默认禁用。
`SWAGGER_UI_PATH`	`/swagger-ui.html`	Swagger UI 的 URL 路径。
`MAX_SUBMIT_COUNT`	`100`	并行执行工作流节点所用线程池的最大并发任务提交数。
`TENANT_ISOLATED_TASK_CONCURRENCY`	`1`	每个租户同时处理的文档索引或 RAG 流水线任务数。

定时任务配置

Dify 使用 Celery Beat 按可配置的计划运行后台维护任务。通过 workerBeat.conversationCleanup.enabled 启用或禁用会话清理任务。执行间隔通过 workerBeat.conversationCleanup.intervalMinutes 设置，批次大小通过 workerBeat.conversationCleanup.batchSize 设置。chart 会将这些设置应用于 API、所有 worker 和 Celery Beat。

Variable	Default	Description
`ENABLE_CONVERSATION_CLEANUP_TASK`	`true`	对已删除但首次清理任务遗漏的会话重新执行清理，永久删除其消息和关联的工具生成文件。此任务与 `ENABLE_CLEAN_MESSAGES` 按保留时长清理消息的机制独立。
`CONVERSATION_CLEANUP_TASK_INTERVAL`	`5`	扫描尚待清理的已删除会话的间隔，单位为分钟。间隔越短，重试越及时，扫描也越频繁。
`CONVERSATION_CLEANUP_BATCH_SIZE`	`100`	每轮扫描最多分发的会话清理任务数。值越大，一次分发的清理任务越多。
`ENABLE_CLEAN_EMBEDDING_CACHE_TASK`	`false`	每天凌晨 2:00 删除过期的嵌入缓存记录。
`ENABLE_CLEAN_UNUSED_DATASETS_TASK`	`false`	禁用保留期内无活动的知识库中的文档。每天凌晨 3:00 运行。
`ENABLE_CLEAN_MESSAGES`	`false`	每天凌晨 4:00 删除超过保留期的会话消息。
`ENABLE_MAIL_CLEAN_DOCUMENT_NOTIFY_TASK`	`false`	向工作空间所有者发送邮件，列出被清理任务自动禁用了文档的知识库。每周一上午 10:00 运行。
`ENABLE_DATASETS_QUEUE_MONITOR`	`false`	监控 Redis 中数据集处理队列的积压。队列超过阈值时发送邮件告警。
`QUEUE_MONITOR_INTERVAL`	`30`	检查队列的频率（分钟）。
`QUEUE_MONITOR_THRESHOLD`	`200`	触发告警邮件的队列大小。
`QUEUE_MONITOR_ALERT_EMAILS`	（为空）	接收队列告警的邮箱地址（逗号分隔）。
`ENABLE_CHECK_UPGRADABLE_PLUGIN_TASK`	`true`	每 15 分钟检查市场中是否有更新的插件版本。
`ENABLE_WORKFLOW_SCHEDULE_POLLER_TASK`	`true`	启用触发定时工作流运行的工作流调度轮询器。
`WORKFLOW_SCHEDULE_POLLER_INTERVAL`	`1`	检查到期定时工作流的频率（分钟）。
`WORKFLOW_SCHEDULE_POLLER_BATCH_SIZE`	`100`	每个轮询周期获取的最大到期计划数。
`WORKFLOW_SCHEDULE_MAX_DISPATCH_PER_TICK`	`0`	熔断器：每个 tick 派发的最大计划数。`0` 表示不限。
`ENABLE_WORKFLOW_RUN_CLEANUP_TASK`	`false`	启用工作流运行记录的自动清理。
`ENABLE_CREATE_TIDB_SERVERLESS_TASK`	`false`	为向量数据库池化预创建 TiDB Serverless 集群。
`ENABLE_UPDATE_TIDB_SERVERLESS_STATUS_TASK`	`false`	定期更新 TiDB Serverless 集群状态。
`ENABLE_HUMAN_INPUT_TIMEOUT_TASK`	`true`	检查过期的 Human Input 表单，并恢复或停止超时的工作流。
`HUMAN_INPUT_TIMEOUT_TASK_INTERVAL`	`1`	检查过期 Human Input 表单的频率（分钟）。

记录保留与清理

Variable	Default	Description
`SANDBOX_EXPIRED_RECORDS_RETENTION_DAYS`	`30`	超过这么多天的记录可被删除。
`SANDBOX_EXPIRED_RECORDS_CLEAN_BATCH_SIZE`	`1000`	每个清理批次处理的记录数。
`SANDBOX_EXPIRED_RECORDS_CLEAN_BATCH_MAX_INTERVAL`	`200`	清理批次之间的最大随机延迟（毫秒）。
`SANDBOX_EXPIRED_RECORDS_CLEAN_TASK_LOCK_TTL`	`90000`	Redis 锁 TTL（秒，约 25 小时），防止清理任务并发执行。

阿里云 SLS Logstore 配置

与阿里云日志服务（SLS）的可选集成，将工作流执行日志存于外部而非数据库。

Variable	Default	Description
`ALIYUN_SLS_ACCESS_KEY_ID`	（为空）	SLS 鉴权用的阿里云 access key ID。
`ALIYUN_SLS_ACCESS_KEY_SECRET`	（为空）	SLS 鉴权用的阿里云 access key secret。
`ALIYUN_SLS_ENDPOINT`	（为空）	SLS 服务端点 URL（例如 `cn-hangzhou.log.aliyuncs.com`）。
`ALIYUN_SLS_REGION`	（为空）	阿里云区域（例如 `cn-hangzhou`）。
`ALIYUN_SLS_PROJECT_NAME`	（为空）	存储工作流日志的 SLS 项目名。
`ALIYUN_SLS_LOGSTORE_TTL`	`365`	SLS logstore 的数据保留天数。`3650` 表示永久存储。
`LOGSTORE_DUAL_WRITE_ENABLED`	`false`	同时将工作流数据写入 SLS 和 PostgreSQL。迁移到 SLS 期间很有用。
`LOGSTORE_DUAL_READ_ENABLED`	`true`	当 SLS 无结果时回退到 PostgreSQL。
`LOGSTORE_ENABLE_PUT_GRAPH_FIELD`	`true`	在 SLS 日志中包含完整的工作流图定义。设为 `false` 可减少存储。

事件总线配置

API 与 Celery worker 之间基于 Redis 的事件传输。

Variable	Default	Description
`EVENT_BUS_REDIS_URL`	（为空）	事件流的 Redis 连接 URL。为空时使用主 Redis 连接设置。
`EVENT_BUS_REDIS_CHANNEL_TYPE`	`pubsub`	传输类型：`pubsub`、`sharded` 或 `streams`（至少一次投递）。
`EVENT_BUS_REDIS_USE_CLUSTERS`	`false`	为事件总线启用 Redis Cluster 模式。大型部署推荐。

插件守护进程存储配置

插件守护进程可将插件包存于不同的存储后端。只需配置与 PLUGIN_STORAGE_TYPE 匹配的那个供应商。

Variable	Default	Description
`PLUGIN_STORAGE_TYPE`	`local`	插件存储后端：`local`、`aws_s3`、`tencent_cos`、`azure_blob`、`aliyun_oss`、`volcengine_tos`。
`PLUGIN_STORAGE_LOCAL_ROOT`	`/app/storage`	本地插件存储的根目录。
`PLUGIN_WORKING_PATH`	`/app/storage/cwd`	插件执行的工作目录。
`PLUGIN_INSTALLED_PATH`	`plugin`	已安装插件的子目录。
`PLUGIN_PACKAGE_CACHE_PATH`	`plugin_packages`	缓存插件包的子目录。
`PLUGIN_MEDIA_CACHE_PATH`	`assets`	缓存媒体资源的子目录。
`PLUGIN_STORAGE_OSS_BUCKET`	（为空）	对象存储桶名称（在 S3/COS/OSS/TOS 各供应商间共用）。
`PLUGIN_PYTHON_ENV_INIT_TIMEOUT`	`120`	为插件初始化 Python 环境的超时（秒）。
`PLUGIN_STDIO_BUFFER_SIZE`	`1024`	插件 stdio 通信的缓冲区大小（字节）。
`PLUGIN_STDIO_MAX_BUFFER_SIZE`	`5242880`	插件 stdio 通信的最大缓冲区大小（字节，5 MB）。

Plugin S3 Storage

Variable	Default	Description
`PLUGIN_S3_USE_AWS`	`false`	使用 AWS S3（区别于 S3 兼容服务）。
`PLUGIN_S3_USE_AWS_MANAGED_IAM`	`false`	使用 IAM 角色而非显式凭据。
`PLUGIN_S3_ENDPOINT`	（为空）	S3 端点 URL。
`PLUGIN_S3_USE_PATH_STYLE`	`false`	使用 path-style URL 而非 virtual-hosted。
`PLUGIN_AWS_ACCESS_KEY`	（为空）	AWS access key。
`PLUGIN_AWS_SECRET_KEY`	（为空）	AWS secret key。
`PLUGIN_AWS_REGION`	（为空）	AWS 区域。

Plugin Azure Blob Storage

Variable	Default	Description
`PLUGIN_AZURE_BLOB_STORAGE_CONTAINER_NAME`	（为空）	Azure Blob 容器名。
`PLUGIN_AZURE_BLOB_STORAGE_CONNECTION_STRING`	（为空）	Azure Blob 连接字符串。

Plugin Tencent COS Storage

Variable	Default	Description
`PLUGIN_TENCENT_COS_SECRET_KEY`	（为空）	腾讯 COS secret key。
`PLUGIN_TENCENT_COS_SECRET_ID`	（为空）	腾讯 COS secret ID。
`PLUGIN_TENCENT_COS_REGION`	（为空）	腾讯 COS 区域。

Plugin Aliyun OSS Storage

Variable	Default	Description
`PLUGIN_ALIYUN_OSS_REGION`	（为空）	阿里云 OSS 区域。
`PLUGIN_ALIYUN_OSS_ENDPOINT`	（为空）	阿里云 OSS 端点。
`PLUGIN_ALIYUN_OSS_ACCESS_KEY_ID`	（为空）	阿里云 OSS access key ID。
`PLUGIN_ALIYUN_OSS_ACCESS_KEY_SECRET`	（为空）	阿里云 OSS access key secret。
`PLUGIN_ALIYUN_OSS_AUTH_VERSION`	`v4`	阿里云 OSS 鉴权版本。
`PLUGIN_ALIYUN_OSS_PATH`	（为空）	阿里云 OSS 路径前缀。

Plugin Volcengine TOS Storage

Variable	Default	Description
`PLUGIN_VOLCENGINE_TOS_ENDPOINT`	（为空）	火山引擎 TOS 端点。
`PLUGIN_VOLCENGINE_TOS_ACCESS_KEY`	（为空）	火山引擎 TOS access key。
`PLUGIN_VOLCENGINE_TOS_SECRET_KEY`	（为空）	火山引擎 TOS secret key。
`PLUGIN_VOLCENGINE_TOS_REGION`	（为空）	火山引擎 TOS 区域。

常见问题

如何设置 `values.yaml` 中没有的变量？

通过需要该变量的服务（api、worker 或 web）的 extraEnv 字段添加。例如，在 API 服务上设置两个变量：

api:
  extraEnv:
    - name: ENV_FROM_COMMUNITY1
      value: "env123"
    - name: ENV_FROM_COMMUNITY2
      value: "env123"

同样的方式适用于 worker.extraEnv 和 web.extraEnv。在每个读取该变量的服务上都设置一遍。

如何配置 `HTTP_PROXY` 和 `HTTPS_PROXY`？

出于安全考虑，你可能需要让 Dify API 服务的出站流量经由代理路由。使用 extraEnv 字段：

api:
  extraEnv:
    - name: "HTTP_PROXY"
      value: "http://proxy.example.com:8080"
    - name: "HTTPS_PROXY"
      value: "http://proxy.example.com:8080"

​通用变量

​CONSOLE_API_URL

​CONSOLE_WEB_URL

​SERVICE_API_URL

​APP_API_URL

​APP_WEB_URL

​TRIGGER_URL

​FILES_URL

​INTERNAL_FILES_URL

​FILES_ACCESS_TIMEOUT

​服务器配置

​日志

​通用

​SECRET_KEY

​KEY_PROVIDER_TYPE

​Token 与请求限制

​Worker 配置

​API Tool 配置

​数据库配置

​Redis 配置

​Redis SSL 配置

​Redis 连接弹性

​Celery 配置

​CORS 配置

​文件存储配置

​STORAGE_TYPE

​归档存储

​向量数据库配置

​VECTOR_STORE

​知识库配置

​标注导入

​模型配置

​多模态配置

​Sentry 配置

​Notion 集成配置

​邮件配置

​其他配置

​索引

​Token 与邀请

​代码执行沙箱

​工作流运行时

​工作流追踪

​工作流存储仓库

​GraphEngine Worker 池

​工作流日志清理

​HTTP Request 节点

​Webhook

​SSRF 防护

​Agent 配置

​UPLOAD_SKILL_FILE_SIZE_LIMIT

​Dify CLI 与编程 API

​Web 前端服务

​企业版专属配置

​部署环境（App Runner）

​App Runner 遥测

​企业版遥测

​模型供应商与工具排序配置

​插件守护进程配置

​Agent Backend 配置

​Agent 快照与文件传输超时

​Agent 后端 HTTP 客户端

​OTLP / OpenTelemetry 配置

​杂项

​定时任务配置

​记录保留与清理

​阿里云 SLS Logstore 配置

​事件总线配置

​插件守护进程存储配置

​常见问题

​如何设置 values.yaml 中没有的变量？

​如何配置 HTTP_PROXY 和 HTTPS_PROXY？

通用变量

CONSOLE_API_URL

CONSOLE_WEB_URL

SERVICE_API_URL

APP_API_URL

APP_WEB_URL

TRIGGER_URL

FILES_URL

INTERNAL_FILES_URL

FILES_ACCESS_TIMEOUT

服务器配置

日志

通用

SECRET_KEY

KEY_PROVIDER_TYPE

Token 与请求限制

Worker 配置

API Tool 配置

数据库配置

Redis 配置

Redis SSL 配置

Redis 连接弹性

Celery 配置

CORS 配置

文件存储配置

STORAGE_TYPE

归档存储

向量数据库配置

VECTOR_STORE

知识库配置

标注导入

模型配置

多模态配置

Sentry 配置

Notion 集成配置

邮件配置

其他配置

索引

Token 与邀请

代码执行沙箱

工作流运行时

工作流追踪

工作流存储仓库

GraphEngine Worker 池

工作流日志清理

HTTP Request 节点

Webhook

SSRF 防护

Agent 配置

UPLOAD_SKILL_FILE_SIZE_LIMIT

Dify CLI 与编程 API

Web 前端服务

企业版专属配置

部署环境（App Runner）

App Runner 遥测

企业版遥测

模型供应商与工具排序配置

插件守护进程配置

Agent Backend 配置

Agent 快照与文件传输超时

Agent 后端 HTTP 客户端

OTLP / OpenTelemetry 配置

杂项

定时任务配置

记录保留与清理

阿里云 SLS Logstore 配置

事件总线配置

插件守护进程存储配置

常见问题

如何设置 `values.yaml` 中没有的变量？

如何配置 `HTTP_PROXY` 和 `HTTPS_PROXY`？