环境变量说明

​

公共变量

​

CONSOLE_API_URL

​

CONSOLE_WEB_URL

​

SERVICE_API_URL

​

APP_API_URL

​

APP_WEB_URL

​

FILES_URL

​

服务端

​

MODE

• api：启动 API Server。
• worker：启动异步队列 worker。

​

DEBUG

​

FLASK_DEBUG

​

SECRET_KEY

​

DEPLOY_ENV

• PRODUCTION（默认）：生产环境。
• TESTING：测试环境，前端页面会有明显颜色标识，该环境为测试环境。

​

LOG_LEVEL

​

MIGRATION_ENABLED

​

CHECK_UPDATE_URL

​

TEXT_GENERATION_TIMEOUT_MS

​

CSP_WHITELIST

*.sentry.io http://localhost:* http://127.0.0.1:* https://analytics.google.com https://googletagmanager.com https://api.github.com

​

容器启动相关配置

• DIFY_BIND_ADDRESS：API 服务绑定地址，默认：0.0.0.0，即所有地址均可访问。
• DIFY_PORT：API 服务绑定端口号，默认 5001。
• SERVER_WORKER_AMOUNT：API 服务 Server worker 数量，即 gevent worker 数量，公式：cpu 核心数 x 2 + 1。可参考：https://docs.gunicorn.org/en/stable/design.html#how-many-workers
• SERVER_WORKER_CLASS：默认为 gevent，若为 windows，可以切换为 sync 或 solo。
• GUNICORN_TIMEOUT：请求处理超时时间，默认 200，建议 360，以支持更长的 sse 连接时间。
• CELERY_WORKER_CLASS：和 SERVER_WORKER_CLASS 类似，默认 gevent，若为 windows，可以切换为 sync 或 solo。
• CELERY_WORKER_AMOUNT：Celery worker 数量，默认为 1，按需设置。
• HTTP_PROXY：HTTP 代理地址，用于解决国内无法访问 OpenAI、HuggingFace 的问题。注意，若代理部署在宿主机 (例如 http://127.0.0.1:7890)，此处代理地址应当和接入本地模型时一样，使用 Docker 容器内部的宿主机地址（例如 http://192.168.1.100:7890 或 http://172.17.0.1:7890）。
• HTTPS_PROXY：HTTPS 代理地址，用于解决国内无法访问 OpenAI、HuggingFace 的问题。同上。

​

数据库配置

• DB_USERNAME：用户名
• DB_PASSWORD：密码
• DB_HOST：数据库 host
• DB_PORT：数据库端口号，默认 5432
• DB_DATABASE：数据库 database
• SQLALCHEMY_POOL_SIZE：数据库连接池大小，默认 30 个连接数，可适当增加。
• SQLALCHEMY_POOL_RECYCLE：数据库连接池回收时间，默认 3600 秒。
• SQLALCHEMY_ECHO：是否打印 SQL，默认 false。

​

Redis 配置

• REDIS_HOST：Redis host
• REDIS_PORT：Redis port，默认 6379
• REDIS_DB：Redis Database，默认为 0，请和 Session Redis、Celery Broker 分开用不同 Database。
• REDIS_USERNAME：Redis 用户名，默认为空
• REDIS_PASSWORD：Redis 密码，默认为空，强烈建议设置密码。
• REDIS_USE_SSL：是否使用 SSL 协议进行连接，默认 false
• REDIS_USE_SENTINEL：使用 Redis Sentinel 连接 Redis 服务器
• REDIS_SENTINELS：哨兵节点，格式：<sentinel1_ip>:<sentinel1_port>,<sentinel2_ip>:<sentinel2_port>,<sentinel3_ip>:<sentinel3_port>
• REDIS_SENTINEL_SERVICE_NAME：哨兵服务名，同 Master Name
• REDIS_SENTINEL_USERNAME：哨兵的用户名
• REDIS_SENTINEL_PASSWORD：哨兵的密码
• REDIS_SENTINEL_SOCKET_TIMEOUT：哨兵超时时间，默认值：0.1，单位：秒

​

Celery 配置

• CELERY_BROKER_URL 格式如下（直连模式）：
  Copy

  Ask AI

  redis://<redis_username>:<redis_password>@<redis_host>:<redis_port>/<redis_database>
  

  范例：redis://:difyai123456@redis:6379/1 哨兵模式：
  Copy

  Ask AI

  sentinel://<sentinel_username>:<sentinel_password>@<sentinel_host>:<sentinel_port>/<redis_database>
  

  范例：sentinel://localhost:26379/1;sentinel://localhost:26380/1;sentinel://localhost:26381/1
• BROKER_USE_SSL 若设置为 true，则使用 SSL 协议进行连接，默认 false。
• CELERY_USE_SENTINEL 若设置为 true，则启用哨兵模式，默认 false。
• CELERY_SENTINEL_MASTER_NAME 哨兵的服务名，即 Master Name。
• CELERY_SENTINEL_SOCKET_TIMEOUT 哨兵连接超时时间，默认值：0.1，单位：秒。

​

CORS 配置

• CONSOLE_CORS_ALLOW_ORIGINS 控制台 CORS 跨域策略，默认为 *，即所有域名均可访问。
• WEB_API_CORS_ALLOW_ORIGINS WebAPP CORS 跨域策略，默认为 *，即所有域名均可访问。

​

文件存储配置

• STORAGE_TYPE 存储设施类型
  • local（默认）：本地文件存储，若选择此项则需要设置下方 STORAGE_LOCAL_PATH 配置。
  • s3：S3 对象存储，若选择此项则需要设置下方 S3_ 开头的配置。
  • azure-blob：Azure Blob 存储，若选择此项则需要设置下方 AZURE_BLOB_ 开头的配置。
  • aliyun-oss：阿里云 OSS 存储，若选择此项则需要设置下方 ALIYUN_OSS_ 开头的配置。
  • huawei-obs：Huawei OBS 存储，若选择此项则需要设置下方 HUAWEI_OBS_ 开头的配置。
  • volcengine-tos：Volcengine TOS 存储，若选择此项则需要设置下方 VOLCENGINE_TOS_ 开头的配置。
  • tencent-cos：腾讯云 COS 存储，若选择此项则需要设置下方 TENCENT_COS_ 开头的配置。
• STORAGE_LOCAL_PATH 默认为 storage，即存储在当前目录的 storage 目录下。若使用 Docker 或 Docker-compose 进行部署，请务必将两个容器中 /app/api/storage 目录挂载到同一个本机目录，否则可能会出现文件找不到的报错。
• S3_ENDPOINT：S3 端点地址
• S3_BUCKET_NAME：S3 桶名称
• S3_ACCESS_KEY：S3 Access Key
• S3_SECRET_KEY：S3 Secret Key
• S3_REGION：S3 地域信息，如：us-east-1
• AZURE_BLOB_ACCOUNT_NAME: your-account-name 如 ‘difyai’
• AZURE_BLOB_ACCOUNT_KEY: your-account-key 如 ‘difyai’
• AZURE_BLOB_CONTAINER_NAME: your-container-name 如 ‘difyai-container’
• AZURE_BLOB_ACCOUNT_URL: ‘https://your_account_name.blob.core.windows.net’
• ALIYUN_OSS_BUCKET_NAME: your-bucket-name 如 ‘difyai’
• ALIYUN_OSS_ACCESS_KEY: your-access-key 如 ‘difyai’
• ALIYUN_OSS_SECRET_KEY: your-secret-key 如 ‘difyai’
• ALIYUN_OSS_ENDPOINT: https://oss-ap-southeast-1-internal.aliyuncs.com # 参考文档
• ALIYUN_OSS_REGION: ap-southeast-1 # 参考文档
• ALIYUN_OSS_AUTH_VERSION: v4
• ALIYUN_OSS_PATH: your-path # 路径不要使用斜线 ”/” 开头，阿里云 OSS 不支持。参考文档
• HUAWEI_OBS_BUCKET_NAME: your-bucket-name 如 ‘difyai’
• HUAWEI_OBS_SECRET_KEY: your-secret-key 如 ‘difyai’
• HUAWEI_OBS_ACCESS_KEY: your-access-key 如 ‘difyai’
• HUAWEI_OBS_SERVER: your-server-url # 参考文档。
• VOLCENGINE_TOS_BUCKET_NAME: your-bucket-name 如 ‘difyai’。
• VOLCENGINE_TOS_SECRET_KEY: your-secret-key 如 ‘difyai’。
• VOLCENGINE_TOS_ACCESS_KEY: your-access-key 如 ‘difyai’。
• VOLCENGINE_TOS_REGION: your-region 如 ‘cn-guangzhou’ # 参考文档。
• VOLCENGINE_TOS_ENDPOINT: your-endpoint 如 ‘tos-cn-guangzhou.volces.com’ # 参考文档。
• TENCENT_COS_BUCKET_NAME: your-bucket-name 如 ‘difyai’
• TENCENT_COS_SECRET_KEY: your-secret-key 如 ‘difyai’
• TENCENT_COS_SECRET_ID: your-secret-id 如 ‘difyai’
• TENCENT_COS_REGION: COS 地域信息，参考文档。
• TENCENT_COS_SCHEME: 指定使用 http/https 协议来访问 COS。

​

向量数据库配置

• VECTOR_STORE 可使用的枚举类型包括：
  • weaviate
  • qdrant
  • milvus
  • zilliz 与 milvus 一致
  • myscale
  • pinecone (暂未开放)
  • tidb_vector
  • analyticdb
  • couchbase
  • oceanbase
  • tablestore
  • lindorm
  • tencent
  • matrixone
• WEAVIATE_ENDPOINT Weaviate 端点地址，如：http://weaviate:8080。
• WEAVIATE_API_KEY 连接 Weaviate 使用的 api-key 凭据。
• WEAVIATE_BATCH_SIZE Weaviate 批量创建索引 Object 的数量，默认 100。可参考此文档。
• WEAVIATE_GRPC_ENABLED 是否使用 gRPC 方式与 Weaviate 进行交互，开启后性能会大大增加，本地可能无法使用，默认为 true。
• QDRANT_URL Qdrant 端点地址，如：https://your-qdrant-cluster-url.qdrant.tech/
• QDRANT_API_KEY 连接 Qdrant 使用的 api-key 凭据。
• PINECONE_API_KEY 连接 Pinecone 使用的 api-key 凭据。
• PINECONE_ENVIRONMENT Pinecone 所在的环境，如：us-east4-gcp
• MILVUS_URI Milvus 的 URI 配置。例如：http://host.docker.internal:19530。对于 Zilliz Cloud，请将 URI 和 TOKEN 分别设置为 Public Endpoint 和 API Key。
• MILVUS_TOKEN Milvus TOKEN 配置，默认为空。
• MILVUS_USER Milvus 用户名配置，默认为空。
• MILVUS_PASSWORD Milvus 密码配置，默认为空。
• MYSCALE_HOST MyScale host 配置。
• MYSCALE_PORT MyScale port 配置。
• MYSCALE_USER MyScale 用户名配置，默认为 default。
• MYSCALE_PASSWORD MyScale 密码配置，默认为空。
• MYSCALE_DATABASE MyScale 数据库配置，默认为 default。
• MYSCALE_FTS_PARAMS MyScale 全文搜索配置，如需多语言支持，请参考 MyScale 文档，默认为空（仅支持英语）。
• TIDB_VECTOR_HOST TiDB Vector host 配置，如：xxx.eu-central-1.xxx.tidbcloud.com
• TIDB_VECTOR_PORT TiDB Vector 端口号配置，如：4000
• TIDB_VECTOR_USER TiDB Vector 用户配置，如：xxxxxx.root
• TIDB_VECTOR_PASSWORD TiDB Vector 密码配置
• TIDB_VECTOR_DATABASE TiDB Vector 数据库配置，如：dify
• ANALYTICDB_KEY_ID 用于阿里云 OpenAPI 认证的访问密钥 ID。请阅读 Analyticdb 文档 来创建你的 AccessKey。
• ANALYTICDB_KEY_SECRET 用于阿里云 OpenAPI 认证的访问密钥秘密。
• ANALYTICDB_INSTANCE_ID 你的 AnalyticDB 实例的唯一标识符，例如 gp-xxxxxx。请阅读 Analyticdb 文档 来创建你的实例。
• ANALYTICDB_REGION_ID AnalyticDB 实例所在区域的标识符，例如 cn-hangzhou。
• ANALYTICDB_ACCOUNT 用于连接 AnalyticDB 实例的账户名称。请阅读 Analyticdb 文档 来创建账户。
• ANALYTICDB_PASSWORD 用于连接 AnalyticDB 实例的账户密码。
• ANALYTICDB_NAMESPACE 在 AnalyticDB 实例内要操作的命名空间 (schema)，例如 dify。如果此命名空间不存在，将自动创建。
• ANALYTICDB_NAMESPACE_PASSWORD 命名空间 (schema) 的密码。如果命名空间不存在，将使用此密码进行创建。
• COUCHBASE_CONNECTION_STRING Couchbase 集群的连接 string 字符串。
• COUCHBASE_USER 数据库用户名。
• COUCHBASE_PASSWORD 数据库密码。
• COUCHBASE_BUCKET_NAME Bucket 名称。
• COUCHBASE_SCOPE_NAME Scope 名称。
• OCEANBASE_VECTOR_HOST OceanBase Vector 数据库的 Host。
• OCEANBASE_VECTOR_PORT OceanBase Vector 数据库的端口。
• OCEANBASE_VECTOR_USER OceanBase Vector 数据库的用户名。
• OCEANBASE_VECTOR_PASSWORD OceanBase Vector 数据库的密码。
• OCEANBASE_VECTOR_DATABASE OceanBase Vector 数据库的库名。
• OCEANBASE_CLUSTER_NAME OceanBase 集群名，仅用于 Docker 部署。
• OCEANBASE_MEMORY_LIMIT OceanBase 内存使用上限，仅用于 Docker 部署。
• TABLESTORE_ENDPOINT Tablestore 访问 Endpoint。
• TABLESTORE_INSTANCE_NAME Tablestore 访问实例名。
• TABLESTORE_ACCESS_KEY_ID Tablestore 访问 ID。
• TABLESTORE_ACCESS_KEY_SECRET Tablestore 访问密钥。
• LINDORM_URL LINDORM 搜索引擎地址，可从控制台 获得。
• LINDORM_USERNAME LINDORM 用户名
• LINDORM_PASSWORD LINDORM 访问密码
• TENCENT_VECTOR_DB_URL 腾讯云向量数据库访问地址，控制台 获得。
• TENCENT_VECTOR_DB_API_KEY 向量数据库服务端的API密钥（密码），用于进行身份认证。 密钥管理。
• TENCENT_VECTOR_DB_USERNAME 向量数据库账号，默认root， 账号与权限管理。
• TENCENT_VECTOR_DB_TIMEOUT 设置默认请求超时时间。
• TENCENT_VECTOR_DB_DATABASE 数据库（Database）是按照数据结构来组织、存储和管理数据的仓库，一个实例可以创建多个 Database。 新建Database。
• TENCENT_VECTOR_DB_SHARD 指定分片数（Shards）。
• TENCENT_VECTOR_DB_REPLICAS 指定副本数（Replica）。
• TENCENT_VECTOR_DB_ENABLE_HYBRID_SEARCH 指定是否开启HybridSearch。稀疏向量文档。
• MATRIXONE_HOST Matrxone 数据库 host 配置，默认为 matrixone。
• MATRIXONE_PORT Matrxone 数据库 port 配置，默认为 6001。
• MATRIXONE_USER Matrxone 数据库 user 配置，默认为 dump。
• MATRIXONE_PASSWORD Matrxone 数据库 password 配置，默认为 111。
• MATRIXONE_DATABASE Matrxone 数据库 database 配置，默认为 dify。

​

知识库配置

• UPLOAD_FILE_SIZE_LIMIT 上传文件大小限制，默认 15M
• UPLOAD_FILE_BATCH_LIMIT 每次上传文件数上限，默认 5 个。
• ETL_TYPE 可使用的枚举类型包括：
  • dify：Dify 自研文件 Extract 方案
  • Unstructured：Unstructured.io 文件 Extract 方案
• UNSTRUCTURED_API_URL Unstructured API 路径，当 ETL_TYPE 为 Unstructured 需要配置。 如：http://unstructured:8000/general/v0/general
• TOP_K_MAX_VALUE RAG 的最大 top-k 值，默认值为 10。

​

多模态模型配置

• MULTIMODAL_SEND_IMAGE_FORMAT 多模态模型输入时，发送图片的格式，默认为 base64，可选 url。 url 模式下，调用的延迟会比 base64 模式下低，一般建议使用兼容更好的 base64 模式。 若配置为 url，则需要将 FILES_URL 配置为外部可访问的地址，以便多模态模型可以访问到图片。
• UPLOAD_IMAGE_FILE_SIZE_LIMIT 上传图片文件大小限制，默认 10M。

​

Sentry 配置

• SENTRY_DSN Sentry DSN 地址，默认为空，为空时则所有监控信息均不上报 Sentry。
• SENTRY_TRACES_SAMPLE_RATE Sentry events 的上报比例，若为 0.01，则为 1%。
• SENTRY_PROFILES_SAMPLE_RATE Sentry profiles 的上报比例，若为 0.01，则为 1%。

​

Notion 集成配置

• NOTION_CLIENT_ID
• NOTION_CLIENT_SECRET

​

邮件相关配置

• MAIL_TYPE
  • resend
    • MAIL_DEFAULT_SEND_FROM：发件人的电子邮件名称，例如：no-reply no-reply@dify.ai，非必需。
    • RESEND_API_KEY：用于 Resend 邮件提供程序的 API 密钥，可以从 API 密钥获取。
  • smtp
    • SMTP_SERVER：SMTP 服务器地址
    • SMTP_PORT：SMTP 服务器端口号
    • SMTP_USERNAME：SMTP 用户名
    • SMTP_PASSWORD：SMTP 密码
    • SMTP_USE_TLS：是否使用 TLS，默认为 false
    • MAIL_DEFAULT_SEND_FROM：发件人的电子邮件名称，例如：no-reply no-reply@dify.ai，非必需。

​

模型供应商 & 工具 位置配置

• POSITION_TOOL_PINS 将列出的工具固定在列表顶部，确保它们在界面中置顶出现。（使用逗号分隔的值，中间不留空格。） 示例: POSITION_TOOL_PINS=bing,google
• POSITION_TOOL_INCLUDES 指定要在应用中包含的工具。只有此处列出的工具才可用。如果未设置，则除非在 POSITION_TOOL_EXCLUDES 中指定，否则所有工具都会包含在内。（使用逗号分隔的值，中间不留空格。） 示例: POSITION_TOOL_INCLUDES=bing,google
• POSITION_TOOL_EXCLUDES 排除在应用中显示或使用的特定工具。此处列出的工具将从可用选项中省略，除非它们被固定。（使用逗号分隔的值，中间不留空格。） 示例: POSITION_TOOL_EXCLUDES=yahoo,wolframalpha
• POSITION_PROVIDER_PINS 将列出的模型供应商固定在列表顶部，确保它们在界面中置顶出现。（使用逗号分隔的值，中间不留空格。） 示例: POSITION_PROVIDER_PINS=openai,openllm
• POSITION_PROVIDER_INCLUDES 指定要在应用中包含的模型供应商。只有此处列出的供应商才可用。如果未设置，则除非在 POSITION_PROVIDER_EXCLUDES 中指定，否则所有供应商都会包含在内。（使用逗号分隔的值，中间不留空格。） 示例: POSITION_PROVIDER_INCLUDES=cohere,upstage
• POSITION_PROVIDER_EXCLUDES 排除在应用中显示特定模型供应商。此处列出的供应商将从可用选项中移除，除非它们被置顶。（使用逗号分隔的值，中间不留空格。） 示例: POSITION_PROVIDER_EXCLUDES=openrouter,ollama

​

其他

• INVITE_EXPIRY_HOURS：成员邀请链接有效时间（小时），默认：72。
• HTTP_REQUEST_NODE_MAX_TEXT_SIZE：workflow 工作流中 HTTP 请求节点的最大文本大小，默认 1MB。
• HTTP_REQUEST_NODE_MAX_BINARY_SIZE：workflow 工作流中 HTTP 请求节点的最大二进制大小，默认 10MB。

​

Web 前端

​

SENTRY_DSN

​

已废弃

​

CONSOLE_URL

⚠️ 修改于 0.3.8，于 0.4.9 废弃，替代为：CONSOLE_API_URL 和 CONSOLE_WEB_URL。

​

API_URL

⚠️ 修改于 0.3.8，于 0.4.9 废弃，替代为 SERVICE_API_URL。

​

APP_URL

⚠️ 修改于 0.3.8，于 0.4.9 废弃，替代为 APP_API_URL 和 APP_WEB_URL。

​

Session 配置

⚠️ 该配置从 0.3.24 版本起废弃。

• SESSION_TYPE： Session 组件类型
  • redis（默认） 选择此项，则需要设置下方 SESSION_REDIS_ 开头的环境变量。
  • sqlalchemy 选择此项，则使用当前数据库连接，并使用 sessions 表进行读写 session 记录。
• SESSION_REDIS_HOST：Redis host
• SESSION_REDIS_PORT：Redis port，默认 6379
• SESSION_REDIS_DB：Redis Database，默认为 0，请和 Redis、Celery Broker 分开用不同 Database。
• SESSION_REDIS_USERNAME：Redis 用户名，默认为空
• SESSION_REDIS_PASSWORD：Redis 密码，默认为空，强烈建议设置密码。
• SESSION_REDIS_USE_SSL：是否使用 SSL 协议进行连接，默认 false

​

Cookie 策略配置

⚠️ 该配置从 0.3.24 版本起废弃。

• COOKIE_HTTPONLY Cookie HttpOnly 配置，默认为 true。
• COOKIE_SAMESITE Cookie SameSite 配置，默认为 Lax。
• COOKIE_SECURE Cookie Secure 配置，默认为 false。

​

文档分段长度配置

​

INDEXING_MAX_SEGMENTATION_TOKENS_LENGTH

• 可在单个分段内保留更多上下文，适合需要处理复杂或上下文相关任务的场景。
• 分段数量减少，从而降低处理时间和存储需求。

• 提供更高的粒度，适合精确提取或总结文本内容。
• 减少超出模型 token 限制的风险，更适配限制严格的模型。

• 较大分段：适合上下文依赖性强的任务，例如情感分析或长文档总结。
• 较小分段：适合精细分析场景，例如关键词提取或段落级内容处理。