環境変数説明

​

共通の環境変数

​

CONSOLE_API_URL

​

CONSOLE_WEB_URL

​

SERVICE_API_URL

​

APP_API_URL

​

APP_WEB_URL

​

FILES_URL

​

サーバー側

​

MODE

• api APIサーバーを起動します。
• 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の数。デフォルト 1。推奨計算式：CPUのコア数 x 2 + 1。 詳細はこちら：https://docs.gunicorn.org/en/stable/design.html#how-many-workers
• SERVER_WORKER_CLASS デフォルトはgevent。Windowsの場合、syncまたはsoloに切り替えることができます。
• GUNICORN_TIMEOUT リクエスト処理のタイムアウト時間。デフォルト 360。SSE（Server-Sent Events）接続をより長く維持するため。
• 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にアクセスできない問題を解決するために使用されます。HTTPプロキシと同様に設定します。

​

データベース設定

• DB_USERNAME：ユーザー名
• DB_PASSWORD：パスワード
• DB_HOST：データベースホスト
• DB_PORT：データベースポート番号。デフォルト5432
• DB_DATABASE：データベース名
• SQLALCHEMY_POOL_SIZE：データベース接続プールのサイズ。デフォルトは30接続。必要に応じて増やせます。
• SQLALCHEMY_POOL_RECYCLE：データベース接続プールのリサイクル時間。デフォルト3600秒。
• SQLALCHEMY_ECHO：SQLを出力するかどうか。デフォルトはfalse。

​

Redis 設定

• REDIS_HOST：Redisホスト
• REDIS_PORT：Redisポート。デフォルト6379
• REDIS_DB：Redisデータベース。デフォルトは0。セッションRedisおよびCeleryブローカーとは異なるデータベースを使用してください。
• REDIS_USERNAME：Redisユーザー名。デフォルトは空
• REDIS_PASSWORD：Redisパスワード。デフォルトは空。パスワードを設定することを強く推奨します。
• REDIS_USE_SSL：SSLプロトコルを使用して接続するかどうか。デフォルトはfalse
• REDIS_USE_SENTINEL：Redis Sentinelを使用してRedisサーバーに接続
• REDIS_SENTINELS：Sentinelノード、フォーマット：<sentinel1_ip>:<sentinel1_port>,<sentinel2_ip>:<sentinel2_port>,<sentinel3_ip>:<sentinel3_port>
• REDIS_SENTINEL_SERVICE_NAME：Sentinelサービス名、Master Nameと同じ
• REDIS_SENTINEL_USERNAME：Sentinelのユーザー名
• REDIS_SENTINEL_PASSWORD：Sentinelのパスワード
• REDIS_SENTINEL_SOCKET_TIMEOUT：Sentinelのタイムアウト、デフォルト値：0.1、単位：秒

​

Celery 設定

• CELERY_BROKER_URL フォーマットは以下の通りです（直接接続モード）
  redis://<redis_username>:<redis_password>@<redis_host>:<redis_port>/<redis_database>
  
  例：redis://:difyai123456@redis:6379/1。 Sentinelモード
  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に設定すると、Sentinelモードが有効になります。デフォルトはfalse
• CELERY_SENTINEL_MASTER_NAME Sentinelのサービス名、すなわちMaster Name
• CELERY_SENTINEL_SOCKET_TIMEOUT Sentinelへの接続タイムアウト、デフォルト値：0.1、単位：秒

​

CORS 設定

• CONSOLE_CORS_ALLOW_ORIGINS コンソールのCORSクロスオリジンポリシー。デフォルトは*、すべてのドメインがアクセス可能です。
• WEB_API_CORS_ALLOW_ORIGINS WebアプリのCORSクロスオリジンポリシー。デフォルトは*、すべてのドメインがアクセス可能です。

​

ファイルストレージ設定

• STORAGE_TYPE ストレージのタイプ 以下の値は .env / Docker Compose 用です。Helm デプロイは代わりに values.yaml の persistence.type を使用します（opendal 非対応）。
  • opendal（Docker Compose のデフォルト） Apache OpenDAL 経由のストレージ。OPENDAL_SCHEME でバックエンドを選択（デフォルト fs、ローカルファイルシステム）。各 scheme の設定項目は OPENDAL_<SCHEME>_<CONFIG> の命名に従う。
  • local（Helm のデフォルト） ローカルファイルストレージ。内部的に OpenDAL fs にマップされる。選択する場合は下記の STORAGE_LOCAL_PATH を設定。
  • s3 S3オブジェクトストレージ。この場合、以下のS3_プレフィックスを設定する必要があります。
  • azure-blob Azure Blobストレージ。この場合、以下のAZURE_BLOB_ プレフィックスを設定する必要があります。
  • huawei-obs Huawei OBS オブジェクト ストレージ。このオプションが選択されている場合は、次の HUAWEI_OBS_ という接頭辞が付いた構成を設定する必要があります。
• OPENDAL_SCHEME OpenDAL ストレージの scheme。デフォルト fs（ローカルファイルシステム）。
• OPENDAL_FS_ROOT OpenDAL ローカルファイルシステムのルートディレクトリ。デフォルト storage。
• STORAGE_LOCAL_PATH デフォルトはstorage、すなわち現在のディレクトリのstorageディレクトリに保存します。 dockerまたはdocker-composeでデプロイする場合、2つのコンテナにある/app/api/storageディレクトリを同じローカルディレクトリにマウントする必要があります。マウントしなかった場合、ファイルが見つからないエラーが発生する可能性があります。
• S3_ENDPOINT：S3エンドポイントアドレス
• S3_BUCKET_NAME：S3バケット名
• S3_ACCESS_KEY：S3アクセスキー
• S3_SECRET_KEY：S3シークレットキー
• S3_REGION：S3リージョン情報（例：us-east-1）
• AZURE_BLOB_ACCOUNT_NAME: アカウント名（例：‘difyai’）
• AZURE_BLOB_ACCOUNT_KEY: アカウントキー（例：‘difyai’）
• AZURE_BLOB_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 # reference: https://www.alibabacloud.com/help/en/oss/user-guide/regions-and-endpoints
• ALIYUN_OSS_REGION: ap-southeast-1 # reference: https://www.alibabacloud.com/help/en/oss/user-guide/regions-and-endpoints
• ALIYUN_OSS_AUTH_VERSION: v4
• ALIYUN_OSS_PATH: your-path # Don’t start with ’/’. OSS doesn’t support leading slash in object names. reference: https://www.alibabacloud.com/help/en/oss/support/0016-00000005
• 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 # 参考文献: https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0500.html

​

ベクトルデータベース設定

• VECTOR_STORE 使用可能なベクトルDB一覧：
  • weaviate
  • qdrant
  • milvus
  • zilliz（milvusと同じ）
  • pinecone（現在未公開）
  • tidb_vector
  • analyticdb
  • couchbase
• WEAVIATE_ENDPOINT Weaviateエンドポイントアドレス（例：http://weaviate:8080）。
• WEAVIATE_API_KEY Weaviateに接続するために使用するapi-keyの資格情報。
• WEAVIATE_GRPC_ENDPOINT Weaviateの gRPC エンドポイント（例：grpc://weaviate:50051）。gRPC を使うと性能が大幅に向上する。
• WEAVIATE_TOKENIZATION Weaviateが使用するトークナイズ方式。デフォルト word。
• 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とトークンを パブリックエンドポイントとAPIキーに調整してください。
• MILVUS_TOKEN MilvusのTOKEN設定。デフォルトは空。
• MILVUS_USER Milvusユーザーの設定。デフォルトは空。
• MILVUS_PASSWORD Milvusパスワードの設定。デフォルトは空。
• TIDB_VECTOR_HOST TiDB Vectorホスト設定（例：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 Aliyun OpenAPI認証に使用されるアクセスキーIDです。ドキュメンテーション を参照してAccessKeyを作成します。
• ANALYTICDB_KEY_SECRET Aliyun OpenAPI認証に使用されるアクセスキーシークレットです。
• ANALYTICDB_INSTANCE_ID あなたのAnalyticDBインスタンスのユニークな識別子で、例えば gp-xxxxxx です。ドキュメンテーション を参照してインスタンスを作成します。
• ANALYTICDB_REGION_ID AnalyticDBインスタンスが位置するリージョンの識別子で、例えば cn-hangzhou です。
• ANALYTICDB_ACCOUNT AnalyticDBインスタンスに接続するために使用するアカウント名です。ドキュメンテーション を参照してアカウントを作成します。
• ANALYTICDB_PASSWORD AnalyticDBインスタンスに接続するために使用するアカウントのパスワードです。
• ANALYTICDB_NAMESPACE AnalyticDBインスタンス内で操作したいnamespace(schema)です。例えば dify です。このnamespaceが存在しない場合、自動的に作成されます。
• ANALYTICDB_NAMESPACE_PASSWORD namespace(schema)のパスワードです。このnamespaceが存在しない場合、このパスワードで作成されます。
• COUCHBASE_CONNECTION_STRING クラスターへのCouchbase接続文字列です。
• COUCHBASE_USER データベースユーザーのユーザー名です。
• COUCHBASE_PASSWORD データベースユーザーのパスワードです。
• COUCHBASE_BUCKET_NAME 使用するバケットの名前です。
• COUCHBASE_SCOPE_NAME 使用するスコープの名前です。

​

ナレッジベース設定

• UPLOAD_FILE_SIZE_LIMIT アップロードファイルのサイズ制限。デフォルトは15M。
• UPLOAD_FILE_BATCH_LIMIT 一度にアップロードできるファイル数の上限。デフォルトは5個。
• ETL_TYPE 使用可能なファイル抽出ソリューション一覧（デフォルト Unstructured）：
  • dify Dify独自のファイル抽出ソリューション
  • Unstructured Unstructured.ioのファイル抽出ソリューション
• UNSTRUCTURED_API_URL ETL_TYPEがUnstructuredの場合、Unstructured APIパスの設定が必要です。 例：http://unstructured:8000/general/v0/general
• TOP_K_MAX_VALUE RAG の最大の上位 k 値。デフォルトは 10。

​

マルチモーダルモデル設定

• MULTIMODAL_SEND_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イベントの報告割合。例えば、0.01に設定すると1%となります。
• SENTRY_PROFILES_SAMPLE_RATE Sentryプロファイルの報告割合。例えば、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サーバポートnumber
    • 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：ワークフロー内のHTTPリクエストノードの最大テキストサイズ、デフォルト1MB。
• HTTP_REQUEST_NODE_MAX_BINARY_SIZE：ワークフロー内の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 Configuration

⚠️ この設定はバージョン 0.3.24 から廃止されました。

• SESSION_TYPE： セッションコンポーネントのタイプ
  • redis（デフォルト） これを選択した場合、下記の SESSION_REDIS_ で始まる環境変数を設定する必要があります。
  • sqlalchemy これを選択した場合、現在のデータベース接続を使用し、sessions テーブルを使用してセッションレコードを読み書きします。
• SESSION_REDIS_HOST：Redis ホスト
• SESSION_REDIS_PORT：Redis ポート、デフォルトは 6379
• SESSION_REDIS_DB：Redis データベース、デフォルトは 0、Redis および Celery ブローカーとは異なるデータベースを使用してください。
• SESSION_REDIS_USERNAME：Redis ユーザー名、デフォルトは空
• SESSION_REDIS_PASSWORD：Redis パスワード、デフォルトは空、パスワードの設定を強く推奨します。
• SESSION_REDIS_USE_SSL：SSL プロトコルを使用して接続するかどうか、デフォルトは false

​

クッキー戦略の設定

⚠️ この設定はバージョン 0.3.24 から廃止されました。

• COOKIE_HTTPONLY クッキーの HttpOnly 設定、デフォルトは true。
• COOKIE_SAMESITE クッキーの SameSite 設定、デフォルトは Lax。
• COOKIE_SECURE クッキーの Secure 設定、デフォルトは false。

​

ドキュメントのチャンク長の設定

​

INDEXING_MAX_SEGMENTATION_TOKENS_LENGTH

• 単一のチャンク内により多くの文脈を保持でき、複雑または文脈依存のタスクに適しています。
• チャンク数が減少し、処理時間やストレージの負担が軽減されます。

• より細かい粒度を提供し、正確な情報抽出や要約タスクに適しています。
• モデルのトークン制限を超えるリスクを低減し、制限の厳しいモデルに適応します。

• チャンク長が大きい場合: 文脈依存性が高いタスク（例: 感情分析や長文の要約）に適しています。
• チャンク長が小さい場合: 詳細な分析が必要なタスク（例: キーワード抽出や段落レベルの内容処理）に適しています。

​

よくある質問

​

values.yamlファイルに環境変数がないが、その変数が.env.exampleファイルで提供されている場合、その変数をどのように追加または変更すればよいですか？

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

​

HTTP_PROXYとHTTPS_PROXYの設定方法は？

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