環境変数 - Dify Docs

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。

Dify はデフォルト設定でそのまま動作します。デプロイをカスタマイズするには、関連するファイルの環境変数を編集します：

必須の起動値 は docker/.env にあります（デプロイ時に docker/.env.example からコピーして作成したファイル）。直接編集します。
オプションまたはプロバイダー固有の設定 は docker/envs/ にテンプレートとして用意されています。デフォルト値を上書きするには、対応するテンプレートをコピーし（.example 拡張子を外す）、コピーを編集します。例：
cd dify/docker cp envs/vectorstores/milvus.env.example envs/vectorstores/milvus.env

docker/.env の値は、docker/envs/*.env ファイルの値より優先されます。

Dify をアップグレードした後、各 .env.example を対応する .env と比較し、新規または変更された変数を確認してください。

共通変数

これらの URL 変数は、Dify の各サービスのアドレスを設定します。 Nginx 背後のシングルドメインデプロイ（デフォルトの Docker Compose 構成）の場合、これらは空のままで構いません。システムがリクエストから自動検出します。カスタムドメイン、マルチドメインデプロイ、またはリバースプロキシを使用する場合に設定してください。

CONSOLE_API_URL

デフォルト値：（空） Dify バックエンド API の公開 URL。OAuth ログイン（GitHub、Google）、Notion 連携、または OAuth を必要とするプラグインを使用する場合に設定してください。これらの機能は、認証後にユーザーをリダイレクトするための絶対コールバック URL を必要とします。また、セキュア（HTTPS のみ）Cookie を使用するかどうかも決定します。例：https://api.console.dify.ai

SERVER_CONSOLE_API_URL

デフォルト値：http://api:5001 Web フロントエンドコンテナがサーバーサイドでリクエストを送信する際に使用する Console API のアドレスです。公開ドメインを経由せず、Docker 内部ネットワークから API に直接アクセスします。この変数は Web フロントエンドコンテナでのみ使用され、Python バックエンドには影響しません。ブラウザからのリクエストは引き続き CONSOLE_API_URL を使用します。空の場合は CONSOLE_API_URL にフォールバックします。API サービスの内部アドレスが異なる場合にのみ変更してください。

CONSOLE_WEB_URL

デフォルト値：（空） Dify コンソールフロントエンドの公開 URL。すべてのシステムメール（招待、パスワードリセット、通知）のリンク構築、および OAuth ログイン後のコンソールへのリダイレクトに使用されます。CONSOLE_CORS_ALLOW_ORIGINS が設定されていない場合、デフォルトの CORS 許可オリジンとしても機能します。空の場合、メールリンクが正しく機能しません。シングルドメインデプロイでも、メール機能を使用する場合はこの変数を設定してください。例：https://console.dify.ai

SERVICE_API_URL

デフォルト値：（空） Dify コンソールで Developer に表示される API Base URL。Developer が Dify API を呼び出すためにコードにコピーする URL です。空の場合、現在のリクエストから自動検出されます（例：http://localhost/v1）。サーバーが複数のアドレスでアクセス可能な場合、この変数を設定して一貫した URL を確保してください。例：https://api.dify.ai

APP_API_URL

デフォルト値：（空） Web アプリフロントエンド（公開アプリ）のバックエンド API URL。この変数は Web フロントエンドコンテナでのみ使用され、Python バックエンドには影響しません。空の場合、Docker イメージのデフォルトは http://127.0.0.1:5001です。例：https://api.app.dify.ai

APP_WEB_URL

デフォルト値：（空）公開 Web アプリのアクセス URL。ワークフローの 人間の入力ノード に必要です。メール通知のフォームリンクは {APP_WEB_URL}/form/{token} 形式で構築されます。空の場合、人間の入力メールに有効なフォームリンクが含まれません。例：https://app.dify.ai

TRIGGER_URL

デフォルト値：http://localhost Webhook およびインテグレーショントリガーエンドポイントのアクセス URL。外部システムがこのアドレスを使用してワークフローを呼び出します。Dify はトリガーコールバック URL を {TRIGGER_URL}/triggers/webhook/{id} の形式で構築し、コンソールに表示します。外部システムからトリガーが動作するようにするには、それらがアクセスできるパブリックドメインまたは IP アドレスを指定する必要があります。

FILES_URL

デフォルト値：（空；CONSOLE_API_URL にフォールバック）ファイルプレビューおよびダウンロードリンクのベース URL です。Dify はすべてのファイル（アップロードされたドキュメント、ツール出力、ワークスペースロゴ）に対して、署名付きの時間制限 URL を生成します。生成された URL はフロントエンドとマルチモーダルモデルに提供されます。ファイル処理プラグインを使用する場合、またはファイル URL を専用ドメインで使用したい場合に設定してください。FILES_URLと CONSOLE_API_URL の両方が空の場合、ファイルプレビューが機能しません。例：https://upload.example.comまたはhttp://<your-ip>:5001

INTERNAL_FILES_URL

デフォルト値：（空；FILES_URL にフォールバック） Docker ネットワーク内のサービス間通信で使用されるファイルアクセス URL（例：プラグインデーモン、PDF/Word 抽出器）。これらの内部サービスは、Nginx やパブリックドメインを Nginx 経由する外部 FILES_URL にアクセスできない場合があります。空の場合、内部サービスは FILES_URL を使用します。内部サービスが外部 URL にアクセスできない場合に設定してください。例：http://api:5001

FILES_ACCESS_TIMEOUT

デフォルト値：300（5 分）署名付きファイル URL の有効期間（秒）。この時間を過ぎると URL は拒否され、ファイルを再リクエストする必要があります。長時間実行プロセスの場合は増加し、セキュリティを強化する場合は減少させてください。

ENABLE_COLLABORATION_MODE

デフォルト値：true ワークフローキャンバスのリアルタイム共同編集（同時編集、キャンバス上のコメント、@メンション）を有効化します。 localhost 以外のホストから Dify にアクセスする場合、NEXT_PUBLIC_SOCKET_URL をブラウザから到達できる WebSocket URL に設定してください（CORS 設定を参照）。デフォルトの ws://localhost はローカル専用環境でのみ動作します。共同編集機能を無効化するには、この値を false に設定します。Docker Compose を使用している場合は、COMPOSE_PROFILES から collaboration も削除してください。削除しないと、専用の api_websocket コンテナはトラフィックを受け取らないまま起動し続けます。独自のリバースプロキシを使用する場合は /socket.io/ パスで Upgrade および Connection ヘッダーを転送してください（同梱の nginx テンプレートにはこの設定が含まれています）。API を複数レプリカで運用する場合はスティッキーセッションが必要です。大きなワークフローの共同編集中にエディタが切断と再接続を繰り返す場合は、WEBSOCKET_MAX_HTTP_BUFFER_SIZE を上げてください。

システムエンコーディング

変数	デフォルト値	説明
`LANG`	`C.UTF-8`	システムロケール設定。UTF-8 エンコーディングを保証します。
`LC_ALL`	`C.UTF-8`	すべてのカテゴリのロケールオーバーライド。
`PYTHONIOENCODING`	`utf-8`	Python I/O エンコーディング。

サーバー設定

ログ

変数	デフォルト値	説明
`LOG_LEVEL`	`INFO`	最小ログレベル。すべてのハンドラー（ファイル＋コンソール）のログ記録内容を制御します。レベル（低→高）：`DEBUG`、`INFO`、`WARNING`、`ERROR`、`CRITICAL`。
`LOG_OUTPUT_FORMAT`	`text`	`text`はタイムスタンプ、レベル、スレッド、トレース ID を含む人間可読な形式を出力します。`json` はログ集約ツール（ELK、Datadog など）向けの構造化 JSON を出力します。
`LOG_FILE`	`/app/logs/server.log`	ログファイルパス。設定するとファイルベースのログ記録が有効になり、自動ローテーションされます。ディレクトリは自動作成されます。空の場合はコンソールにのみ出力されます。
`LOG_FILE_MAX_SIZE`	`20`	ローテーション前のログファイル最大サイズ（MB）。超過すると現在のファイルが `.1` にリネームされ、新しいファイルが作成されます。
`LOG_FILE_BACKUP_COUNT`	`5`	保持するローテーションログファイル数。デフォルト設定では最大 6 ファイル（現在のファイル＋5 バックアップ）が存在します。
`LOG_DATEFORMAT`	`%Y-%m-%d %H:%M:%S`	テキスト形式ログのタイムスタンプフォーマット（strftime コード）。JSON 形式では無視されます。
`LOG_TZ`	`UTC`	ログタイムスタンプのタイムゾーン（pytz 形式、例：`Asia/Shanghai`）。テキスト形式にのみ適用されます。JSON は常に UTC を使用します。Celery のタスクスケジューリングタイムゾーンも設定します。

一般

変数	デフォルト値	説明
`DEBUG`	`false`	詳細ログを有効化：ツール実行の詳細、完全な LLM プロンプトとレスポンス、アプリ起動時間。ローカル開発に有用です。ログに機密データが出力される可能性があるため、本番環境では推奨しません。
`FLASK_DEBUG`	`false`	標準 Flask デバッグモードフラグ。Dify では積極的に使用されていません。`DEBUG` が主要な制御変数です。
`ENABLE_REQUEST_LOGGING`	`false`	すべての HTTP リクエストに対してコンパクトなアクセスログ（`METHOD PATH STATUS DURATION TRACE_ID`）を記録します。`LOG_LEVEL`が `DEBUG` に設定されている場合、完全なリクエストとレスポンスボディも JSON 形式で記録されます。
`DEPLOY_ENV`	`PRODUCTION`	Sentry と OpenTelemetry の監視データにタグ付けし、環境別にエラーとトレースをフィルタリングできるようにします。`X-Env` レスポンスヘッダーとしても送信されます。アプリケーションの動作は変更しません。
`DEPLOYMENT_EDITION`	`COMMUNITY`	デプロイのエディション（`COMMUNITY`、`ENTERPRISE`、`CLOUD`）。デフォルトのまま使用してください。従来の `EDITION`、`ENTERPRISE_ENABLED`、`BILLING_ENABLED` を置き換えるものです。これらの旧変数は 1.17.0 以降無視されます。
`MIGRATION_ENABLED`	`true`	`true`の場合、コンテナ起動時にデータベーススキーママイグレーション（`flask upgrade-db`）を自動実行します。Docker のみ。マイグレーションを別途実行する場合は `false`に設定してください。ソースコードからの起動では、`flask db upgrade` を手動で実行してください。
`CHECK_UPDATE_URL`	`https://updates.dify.ai`	コンソールがこの URL で Dify の新バージョンを確認します。空に設定すると無効化されます。エアギャップ環境や外部 HTTP コールを防止したい場合に有用です。
`OPENAI_API_BASE`	`https://api.openai.com/v1`	レガシー変数。Dify 自身のコードでは積極的に使用されていません。環境に存在する場合、OpenAI Python SDK に読み取られる可能性があります。

SECRET_KEY

デフォルト値：（.env.example にプリセット；本番環境では必ず置き換えてください）セッション Cookie 署名、JWT 認証トークンに使用されます。さらに、ファイル URL 署名（HMAC-SHA256）とサードパーティ OAuth 資格情報の暗号化（AES-256）にも使用されます。初回起動前に、強力なキーを生成してください：

openssl rand -base64 42

デプロイ後にこのキーを変更すると、すべてのユーザーが即座にログアウトされ、すべてのファイル URL が無効になり、OAuth を使用するプラグイン連携が壊れます。暗号化された資格情報は復元できなくなります。

PASSWORD_PEPPER

デフォルト値：（空）メンバーが Dify へのサインインに使うパスワードに混ぜ込む、サーバー側の秘密値です。流出したデータベースのコピーだけでは、パスワードを解読できなくなります。空のままなら、動作は変わりません。ペッパーを使う場合は、初回セットアップで管理者アカウントを作成する前に設定してください。十分なエントロピーを持つランダムな値を生成します。例：

openssl rand -base64 32

Docker Compose では、docker/envs/core-services/api.env に設定します（ファイルがまだない場合は api.env.example から作成してください）。docker/.env には書かないでください。Compose はこのファイルの値を、ワーカー、プラグインデーモン、Agent バックエンド、Web フロントエンド、コード実行サンドボックスにも渡します。ソースコードからデプロイした場合は、api/.env に設定します。

アカウント作成後にペッパーを設定、変更、削除すると、既存のパスワードはサインイン時に無効と判定されます。誤って操作した場合は、以前の値に戻してください。その間にリセットされなかったパスワードは、すべて再び使えるようになります。この値は SECRET_KEY と同様に厳重に管理してください。

既存のアカウントがあるデプロイで有効にする場合は、有効化後に各メンバーが再びサインインできる手段を用意してください：

API コンテナで flask reset-password を実行し、各アカウントのパスワードをリセットします。コマンドの詳細は管理者パスワードのリセットを参照してください。
メンバー自身に、パスワードリセットメールからパスワードを再設定してもらいます。この方法にはメール送信の設定が必要です。
ENABLE_EMAIL_CODE_LOGIN を有効にしている場合、メンバーはパスワードの代わりに、メールで届くコードを使ってサインインできます。

KEY_PROVIDER_TYPE

デフォルト値：local 保存された資格情報（モデルプロバイダーの API キー、ツール資格情報などワークスペースの機密情報）を暗号化する、ワークスペースごとの鍵の保管場所を選択します。

local：ワークスペースごとに RSA 鍵ペアを生成し、秘密鍵を STORAGE_TYPE のストレージバックエンドに保存します。
azure-keyvault：各ワークスペースの RSA 鍵を Azure Key Vault に保管し、秘密鍵が Key Vault の外に出ることはありません。認証には DefaultAzureCredential（マネージド ID、環境変数、または Azure CLI ログイン）を使用します。

プロバイダーは最初のワークスペースを作成する前に決めてください。一方のプロバイダーで暗号化した資格情報はもう一方では復号できません。資格情報が保存済みのデプロイで切り替えると、再入力するまで読み取れなくなります。

変数	デフォルト値	説明
`AZURE_KEYVAULT_VAULT_URL`	（空）	Key Vault インスタンスの URL。`KEY_PROVIDER_TYPE` が `azure-keyvault` の場合は必須で、未設定だと API サービスが起動しません。例：`https://your-vault-name.vault.azure.net`
`AZURE_KEYVAULT_KEY_SIZE`	`2048`	Dify が Key Vault にワークスペース用の鍵を新規作成する際の RSA 鍵長（ビット）。新規作成時のみ適用され、既存の鍵のサイズは変わりません。
`AZURE_KEYVAULT_ROTATION_INTERVAL_DAYS`	（空）	設定すると（最小 7）、新規作成されるワークスペース鍵に N 日ごとの Key Vault 自動ローテーションポリシーが付与されます。古いバージョンの鍵は使用可能なまま残るため、ローテーション前に暗号化した資格情報も再暗号化なしで復号できます。空のままにすると、ローテーションは Azure 側で手動管理します。

INIT_PASSWORD

デフォルト値：（空）初回セットアップ時のオプションのセキュリティゲート。設定すると、/install ページで管理者アカウント作成前にこのパスワードの入力が必要になります。サーバーが公開されている場合の不正なセットアップを防止します。セットアップ完了後、この変数は効力を失います。最大長：30 文字。

トークンとリクエスト制限

変数	デフォルト値	説明
`ACCESS_TOKEN_EXPIRE_MINUTES`	`60`	ログインセッションのアクセストークンの有効期間（分）。期限切れ後、ブラウザがリフレッシュトークンを使用してサイレントに更新します。ユーザーはログアウトされません。
`REFRESH_TOKEN_EXPIRE_DAYS`	`30`	資格情報を再入力せずにログイン状態を維持できる期間（日）。この期間内にアクセスがない場合、再ログインが必要です。
`APP_MAX_EXECUTION_TIME`	`3600`	アプリ実行の最大実行時間（秒）。超過すると終了されます。`WORKFLOW_MAX_EXECUTION_TIME` と連動する外側の制限で、両方ともデフォルトは 1 時間です。これはアプリキューレベル、もう一方はワークフローエンジンレベルで適用されます。ワークフローにより多くの時間が必要な場合は、両方を増やしてください。 Agent を利用する場合は、この 2 つの外側の制限を Agent の実行期限（`DIFY_AGENT_RUN_TIMEOUT_SECONDS`）以上に保ってください。下回ると Agent の実行が途中で打ち切られます。
`APP_DEFAULT_ACTIVE_REQUESTS`	`0`	アプリごとのデフォルト同時リクエスト制限。UI でカスタム制限が設定されていないアプリに使用されます。`0`は無制限を意味します。有効な制限はこの値と `APP_MAX_ACTIVE_REQUESTS` の小さい方になります。
`APP_MAX_ACTIVE_REQUESTS`	`0`	アプリごとのグローバル同時リクエスト上限。アプリのカスタム設定がこの値を超える場合、オーバーライドされます。`0` は無制限を意味します。
`WEBSOCKET_MAX_HTTP_BUFFER_SIZE`	`10485760`	共同編集用 WebSocket が受け付ける 1 メッセージの最大バイト数（デフォルトは 10 MiB）。大きなワークフローの保存時にグラフが上限を超え、切断が繰り返される場合は値を上げる。 `/socket.io/` を処理する API プロセスに設定する。Docker Compose では `api_websocket` コンテナが該当する。

コンテナ起動設定

Docker イメージまたは Docker Compose で起動する場合にのみ有効です。

変数	デフォルト値	説明
`DIFY_BIND_ADDRESS`	`0.0.0.0`	API サーバーがバインドするネットワークインターフェース。`0.0.0.0`はすべてのインターフェースでリッスンします。`127.0.0.1` に設定するとローカルホストのみに制限されます。
`DIFY_PORT`	`5001`	API サーバーのリッスンポート。
`SERVER_WORKER_AMOUNT`	`1`	Gunicorn ワーカープロセス数。gevent（デフォルト）使用時は各ワーカーが greenlet で複数の同時接続を処理するため、通常 1 で十分です。同期ワーカーの場合は `(2 x CPUコア数) + 1`を使用してください。参考ドキュメント。
`SERVER_WORKER_CLASS`	`gevent`	Gunicorn ワーカータイプ。デフォルト値のままにしてください。他の値は psycopg2 と gRPC のパッチを壊します。
`SERVER_WORKER_CONNECTIONS`	`10`	ワーカーごとの最大同時接続数。非同期ワーカー（gevent）にのみ適用されます。高負荷時に接続拒否やレスポンス遅延が発生する場合は、この値を増加してください。
`GUNICORN_TIMEOUT`	`360`	ワーカーがこの秒数以内に応答しない場合、Gunicorn はそのワーカーを終了して再起動します。ストリーミング LLM レスポンスに使用される長時間 SSE 接続をサポートするため、360（6 分）に設定されています。
`API_WEBSOCKET_WORKER_AMOUNT`	`1`	Docker Compose のみ。リアルタイムコラボレーションを担う専用 `api_websocket` コンテナの Gunicorn ワーカー数です。コラボレーションのイベントは Redis 経由でワーカー間に同期されます。編集トラフィックが多く、1 つのワーカーが CPU コアを使い切る場合は安心して増やせます。
`API_WEBSOCKET_WORKER_CLASS`	`geventwebsocket.gunicorn.workers.GeventWebSocketWorker`	Docker Compose のみ。専用の `api_websocket` コンテナのワーカークラスです。デフォルト値のままにしてください。他の値は WebSocket サポートを壊します。
`API_WEBSOCKET_WORKER_CONNECTIONS`	`1000`	Docker Compose のみ。`api_websocket` ワーカー 1 つあたりが同時に受け付ける WebSocket 接続の最大数です。開いているワークフローエディタタブごとに 1 接続を使用するため、デフォルトではワーカー 1 つあたり最大 1000 の同時編集セッションを処理できます。それ以上が見込まれる場合は、値を増やすかワーカーを追加してください。
`API_WEBSOCKET_GUNICORN_TIMEOUT`	`360`	Docker Compose のみ。`api_websocket` ワーカーがこの秒数内に応答しない場合、Gunicorn が再起動します。デフォルトの 360 秒（6 分）は長時間保持される WebSocket 接続に適しています。
`CELERY_WORKER_CLASS`	（空；デフォルトは gevent）	Celery ワーカータイプ。`SERVER_WORKER_CLASS` と同じ gevent パッチ要件があります。変更は強く非推奨です。
`CELERY_WORKER_AMOUNT`	`4`	Celery ワーカープロセス数。オートスケーリング無効時のみ使用されます。リソースの限られた VM では下げてください。スループットを柔軟に調整したい場合は、この値を上げるより `CELERY_AUTO_SCALE` を有効化するほうが適切です。
`CELERY_AUTO_SCALE`	`false`	動的オートスケーリングを有効化。有効時、Celery はキュー深度を監視し、`CELERY_MIN_WORKERS`から `CELERY_MAX_WORKERS` の間でワーカーを動的に生成/終了します。
`CELERY_MAX_WORKERS`	（空；デフォルトは CPU 数）	オートスケーリング有効時の最大ワーカー数。
`CELERY_MIN_WORKERS`	（空；デフォルトは 1）	オートスケーリング有効時の最小ワーカー数。
`COMPOSE_WORKER_HEALTHCHECK_DISABLED`	`true`	Docker Compose による Celery Worker コンテナのヘルスチェックを無効化します。繁忙な Worker 上での `celery inspect ping` はコストが高いため、デフォルトで無効です。`false` に設定すると有効化されます。Docker Compose デプロイメントにのみ適用されます。
`COMPOSE_WORKER_HEALTHCHECK_INTERVAL`	`30s`	Celery Worker ヘルスチェックの実行間隔。`COMPOSE_WORKER_HEALTHCHECK_DISABLED=false` の場合にのみ有効です。Docker Compose の期間書式（例：`30s`、`1m`）を受け付けます。
`COMPOSE_WORKER_HEALTHCHECK_TIMEOUT`	`30s`	1 回の Celery Worker ヘルスチェックのタイムアウト。`COMPOSE_WORKER_HEALTHCHECK_DISABLED=false` の場合にのみ有効です。

MODE

デフォルト値：worker（worker サービスの env ファイルに設定された値。変数が未設定の場合、コンテナは API サーバーを起動） dify-api イメージがコンテナ起動時に実行するプロセスを選択します。3 つの env サンプルファイルがそれぞれのサービス向けの値を設定しています：worker.env.example は worker、api.env.example は api、worker-beat.env.example は beat。指定できる値：

api（空または認識されない値も同様）：API サーバー
worker：Celery タスクコンシューマー
beat：定期タスクディスパッチャー
job：Flask CLI コマンドを 1 つ実行して終了
migration：MIGRATION_ENABLED=true と併用し、データベース移行後に終了

付属の Compose ファイルはサービスごとに適切な値を設定済みのため、変更が必要なのは Kubernetes などのカスタム構成のみです。誤った値ではコンテナが別のプロセスを実行します。worker がないと、インデックス作成やメールのタスクが処理されずに滞留します。

API ツール設定

変数	デフォルト値	説明
`API_TOOL_DEFAULT_CONNECT_TIMEOUT`	`10`	API ツールノードが外部 API を呼び出す際の TCP 接続確立の最大待機時間（秒）。
`API_TOOL_DEFAULT_READ_TIMEOUT`	`60`	API ツールノードが外部 API からレスポンスデータを受信する最大待機時間（秒）。

データベース設定

データベースはデフォルトで PostgreSQL を使用します。OceanBase、MySQL、seekdb もサポートされています。

変数	デフォルト値	説明
`DB_TYPE`	`postgresql`	データベースタイプ。サポートされる値：`postgresql`、`mysql`、`oceanbase`、`seekdb`。TiDB などの MySQL 互換データベースは `mysql` を使用できます。
`DB_USERNAME`	`postgres`	データベースユーザー名。接続文字列で URL エンコードされるため、特殊文字も安全に使用できます。
`DB_PASSWORD`	`difyai123456`	データベースパスワード。接続文字列で URL エンコードされるため、`@`、`:`、`%` などの文字も安全に使用できます。
`DB_HOST`	`db_postgres`	データベースサーバーのホスト名。
`DB_PORT`	`5432`	データベースサーバーのポート。MySQL を使用する場合は `3306` に設定してください。
`DB_DATABASE`	`dify`	データベース名。

コネクションプール

Dify がデータベースコネクションプールを管理する方法を制御します。デフォルト設定はほとんどのデプロイで問題なく動作します。

変数	デフォルト値	説明
`SQLALCHEMY_POOL_SIZE`	`30`	プール内に保持する永続接続数。
`SQLALCHEMY_MAX_OVERFLOW`	`10`	プールが満杯の場合に許可される追加の一時接続数。デフォルト設定では、最大 40 接続（30 + 10）が同時に存在できます。
`SQLALCHEMY_POOL_RECYCLE`	`3600`	この秒数の後に接続をリサイクルし、古い接続を防止します。
`SQLALCHEMY_POOL_TIMEOUT`	`30`	プールが枯渇した場合の接続待機時間。この時間内に接続が解放されない場合、リクエストはタイムアウトエラーで失敗します。
`SQLALCHEMY_POOL_RESET_ON_RETURN`	`rollback`	接続がプールに返却された際の SQLAlchemy の動作です。`rollback` は再利用前に未コミットのトランザクション状態をクリアし、`commit` はコミットします。
`SQLALCHEMY_POOL_PRE_PING`	`false`	使用前に軽量クエリで接続をテストします。「接続切断」エラーを防止しますが、わずかなレイテンシーが追加されます。不安定なネットワークの本番環境で推奨されます。
`SQLALCHEMY_POOL_USE_LIFO`	`false`	均等ローテーション（FIFO）の代わりに、最後に返却された接続を再利用します（LIFO）。LIFO はより少ない接続を「ウォーム」状態に保ち、オーバーヘッドを削減できます。
`SQLALCHEMY_ECHO`	`false`	すべての SQL 文をログに出力します。クエリ問題のデバッグに有用です。

PostgreSQL パフォーマンスチューニング

これらは PostgreSQL コンテナへの起動引数として渡されます。Dify アプリケーションではなく、データベースサーバーの設定です。

変数	デフォルト値	説明
`POSTGRES_MAX_CONNECTIONS`	`200`	最大データベース接続数。API と Celery ワーカーが同時に接続プールを開くため、`too many connections` エラーを避けるには、少なくとも `SERVER_WORKER_AMOUNT × SERVER_WORKER_CONNECTIONS + CELERY_WORKER_AMOUNT + 余裕` の接続数を確保してください。参考ドキュメント
`POSTGRES_SHARED_BUFFERS`	`128MB`	バッファ用共有メモリ。推奨値：利用可能メモリの 25%。参考ドキュメント
`POSTGRES_WORK_MEM`	`4MB`	データベースワーカーごとの作業メモリ。参考ドキュメント
`POSTGRES_MAINTENANCE_WORK_MEM`	`64MB`	メンテナンス作業用に予約されるメモリ。参考ドキュメント
`POSTGRES_EFFECTIVE_CACHE_SIZE`	`4096MB`	プランナーの有効キャッシュサイズの推定値。参考ドキュメント
`POSTGRES_STATEMENT_TIMEOUT`	`0`	ステートメント終了前の最大実行時間（ミリ秒）。`0`はタイムアウトなし。参考ドキュメント
`POSTGRES_IDLE_IN_TRANSACTION_SESSION_TIMEOUT`	`0`	トランザクション内アイドルセッションの最大時間（ミリ秒）。`0`はタイムアウトなし。参考ドキュメント

MySQL パフォーマンスチューニング

これらは MySQL コンテナへの起動引数として渡されます。Dify アプリケーションではなく、データベースサーバーの設定です。

変数	デフォルト値	説明
`MYSQL_MAX_CONNECTIONS`	`1000`	最大 MySQL 接続数。
`MYSQL_INNODB_BUFFER_POOL_SIZE`	`512M`	InnoDB バッファプールサイズ。推奨値：専用 MySQL サーバーの利用可能メモリの 70-80%。参考ドキュメント
`MYSQL_INNODB_LOG_FILE_SIZE`	`128M`	InnoDB ログファイルサイズ。参考ドキュメント
`MYSQL_INNODB_FLUSH_LOG_AT_TRX_COMMIT`	`2`	トランザクションコミット時の InnoDB ログフラッシュ方式。オプション：`0`（フラッシュなし）、`1`（フラッシュ＆同期）、`2`（OS キャッシュへフラッシュ）。参考ドキュメント

Redis 設定

これらの変数を設定して、Dify を Redis インスタンスに接続します。Dify はスタンドアロン（デフォルト）、Sentinel、Cluster の 3 つのデプロイモードをサポートしています。

変数	デフォルト値	説明
`REDIS_HOST`	`redis`	Redis サーバーのホスト名。スタンドアロンモードでのみ使用されます。Sentinel または Cluster モード有効時は無視されます。
`REDIS_PORT`	`6379`	Redis サーバーのポート。スタンドアロンモードでのみ使用されます。
`REDIS_USERNAME`	（空）	Redis 6.0+ ACL ユーザー名。すべてのモード（スタンドアロン、Sentinel、Cluster）に適用されます。
`REDIS_PASSWORD`	`difyai123456`	Redis 認証パスワード。Cluster モードの場合は、代わりに `REDIS_CLUSTERS_PASSWORD` を使用してください。
`REDIS_DB`	`0`	Redis データベース番号（0-15）。スタンドアロンおよび Sentinel モードにのみ適用されます。Celery のデータベース（`CELERY_BROKER_URL` で設定；デフォルトは DB 1）と衝突しないようにしてください。
`REDIS_KEY_PREFIX`	（空）	Redis キーに適用されるグローバルプレフィックス。Pub/Sub チャネル、Redis Streams 名、Celery のキューと結果バックエンドキーにも適用されます。Dify はプレフィックスとキーの間にコロンを自動挿入します。たとえば `staging` を設定すると、実際のキーは `staging:session:abc` の形式になります。複数の Dify インスタンスが同一の Redis を共有する場合（例：staging と production）、キー衝突の回避に有効です。空のままにすると、プレフィックスなしのデフォルト動作を維持します。既存のデプロイで後から有効化すると、以前のプレフィックス（または空）で書き込まれたキーは参照できなくなります。
`REDIS_USE_SSL`	`false`	Redis 接続の SSL/TLS を有効化。Sentinel プロトコルには自動適用されません。
`REDIS_MAX_CONNECTIONS`	（空）	Redis プール内の最大接続数。空のままでライブラリのデフォルトを使用します。必要に応じて Redis サーバーの `maxclients` に合わせて設定してください。
`REDIS_KEEPALIVE`	`true`	Redis 接続で TCP keepalive を有効にします。ファイアウォールやロードバランサーに静かに切断されたアイドル接続を検知し、次回使用時に失敗する前に再確立します。
`REDIS_KEEPALIVE_IDLE`	`30`	最初の TCP keepalive プローブを送信するまでの接続アイドル秒数（`TCP_KEEPIDLE`）。`REDIS_KEEPALIVE=true` のときに適用されます。
`REDIS_KEEPALIVE_INTERVAL`	`10`	TCP keepalive プローブの送信間隔（秒）（`TCP_KEEPINTVL`）。`REDIS_KEEPALIVE=true` のときに適用されます。
`REDIS_KEEPALIVE_COUNT`	`10`	接続が切断されたと判断するまでに許容する未確認プローブの回数（`TCP_KEEPCNT`）。`REDIS_KEEPALIVE=true` のときに適用されます。

Redis SSL 設定

REDIS_USE_SSL=trueの場合にのみ適用されます。Celery broker の URL が rediss:// スキームを使用する場合、これらの設定は Celery broker にも適用されます。

変数	デフォルト値	説明
`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 Sentinel モード

Sentinel は高可用性のための自動マスター検出とフェイルオーバーを提供します。Cluster モードとは相互に排他的です。

変数	デフォルト値	説明
`REDIS_USE_SENTINEL`	`false`	Redis Sentinel モードを有効化。有効時、`REDIS_HOST`/`REDIS_PORT` は無視されます。Dify は Sentinel ノードに接続し、現在のマスターを問い合わせます。
`REDIS_SENTINELS`	（空）	Sentinel ノードのアドレス。形式：`<ip1>:<port1>,<ip2>:<port2>,<ip3>:<port3>`。これらは Sentinel インスタンスであり、Redis サーバーではありません。
`REDIS_SENTINEL_SERVICE_NAME`	（空）	Sentinel が監視する論理サービス名（`sentinel.conf`で設定）。Dify は `master_for(service_name)` を呼び出して現在のマスターを検出します。
`REDIS_SENTINEL_USERNAME`	（空）	Sentinel ノードの認証ユーザー名。`REDIS_USERNAME` とは別です。後者は Redis マスター/レプリカの認証に使用されます。
`REDIS_SENTINEL_PASSWORD`	（空）	Sentinel ノードの認証パスワード。`REDIS_PASSWORD` とは別です。
`REDIS_SENTINEL_SOCKET_TIMEOUT`	`0.1`	Sentinel ノードとの通信の Socket タイムアウト（秒）。デフォルトの 0.1 秒は高速なローカルネットワークを想定しています。クラウド/WAN デプロイでは、断続的なタイムアウトを防止するために 1.0-5.0 秒に増加してください。

Redis Cluster モード

Cluster モードは複数の Redis ノード間での自動シャーディングを提供します。Sentinel モードとは相互に排他的です。

変数	デフォルト値	説明
`REDIS_USE_CLUSTERS`	`false`	Redis Cluster モードを有効化。
`REDIS_CLUSTERS`	（空）	Cluster ノード。形式：`<ip1>:<port1>,<ip2>:<port2>,<ip3>:<port3>`
`REDIS_CLUSTERS_PASSWORD`	（空）	Redis Cluster のパスワード。

Redis 接続の堅牢性設定

これらの変数は、Redis 接続のクライアント側リトライ、タイムアウト、ヘルスチェックの動作を調整します。デフォルト値は控えめに設定されています。ネットワークレイテンシが高いクラウド/WAN デプロイでは、タイムアウト値を増やしてください。

変数	デフォルト値	説明
`REDIS_RETRY_RETRIES`	`3`	一時的な障害（`ConnectionError`、`TimeoutError`、`socket.timeout`）発生時の、Redis コマンドごとの最大リトライ回数。`0` に設定するとリトライを無効化します。ジッター付き指数バックオフを使用します。
`REDIS_RETRY_BACKOFF_BASE`	`1.0`	リトライ間の指数バックオフのベース遅延（秒）。
`REDIS_RETRY_BACKOFF_CAP`	`10.0`	リトライ間のバックオフ遅延の上限（秒）。
`REDIS_SOCKET_TIMEOUT`	`5.0`	Redis 読み取り/書き込み操作の Socket タイムアウト（秒）。高負荷下で断続的なコマンドタイムアウトが発生する場合は増やしてください。
`REDIS_SOCKET_CONNECT_TIMEOUT`	`5.0`	Redis 接続確立の Socket タイムアウト（秒）。
`REDIS_HEALTH_CHECK_INTERVAL`	`30`	アイドル接続に対するクライアント側ヘルスチェックの間隔（秒）。`0`に設定すると無効化します。Cluster モードでは適用されません（`redis-py` が該当パラメータを静かに削除します）。

Celery 設定

データセットインデックス作成、メール送信、定期ジョブに使用されるバックグラウンドタスクキューを設定します。

CELERY_BROKER_URL

デフォルト値：redis://:difyai123456@redis:6379/1 Celery メッセージブローカーの Redis 接続 URL。直接接続形式：

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

Sentinel モード形式（複数ノードはセミコロンで区切り）：

sentinel://<redis_username>:<redis_password>@<sentinel_host>:<sentinel_port>/<redis_database>

変数	デフォルト値	説明
`CELERY_BACKEND`	`redis`	Celery がタスク結果を保存する場所。オプション：`redis`（高速、インメモリ）または `database`（メインデータベースに保存）。
`BROKER_USE_SSL`	`false`	`CELERY_BROKER_URL`が `rediss://` スキームを使用する場合に自動有効化。Redis SSL 証明書設定を broker 接続に適用します。
`CELERY_USE_SENTINEL`	`false`	Celery broker の Redis Sentinel モードを有効化。
`CELERY_SENTINEL_MASTER_NAME`	（空）	Sentinel サービス名（Master Name）。
`CELERY_SENTINEL_PASSWORD`	（空）	Sentinel 認証パスワード。`REDIS_SENTINEL_PASSWORD` とは別です。キャッシュとタスクキューで異なる Sentinel クラスターを使用する場合に異なる値を設定できます。
`CELERY_SENTINEL_SOCKET_TIMEOUT`	`0.1`	Sentinel への接続タイムアウト（秒）。
`CELERY_TASK_ANNOTATIONS`	`null`	特定のタスクにランタイム設定（例：レート制限）を適用します。形式：JSON 辞書。例：`{"tasks.add": {"rate_limit": "10/s"}}`。ほとんどのユーザーはこの設定を必要としません。

CORS 設定

フロントエンドのクロスドメインアクセスポリシーを制御します。

変数	デフォルト値	説明
`WEB_API_CORS_ALLOW_ORIGINS`	`*`	Web API へのクロスオリジンリクエストの許可オリジン。例：`https://dify.app`
`CONSOLE_CORS_ALLOW_ORIGINS`	`*`	コンソール API へのクロスオリジンリクエストの許可オリジン。設定されていない場合、`CONSOLE_WEB_URL` にフォールバックします。
`COOKIE_DOMAIN`	（空）	フロントエンドとバックエンドが異なるサブドメインで実行される場合、共有トップレベルドメイン（例：`example.com`）に設定します。これにより認証 Cookie をサブドメイン間で共有できます。空の場合、Cookie は最もセキュアな `__Host-` プレフィックスを使用し、単一ドメインにロックされます。
`NEXT_PUBLIC_COOKIE_DOMAIN`	（空）	クロスサブドメイン Cookie のフロントエンドフラグ。`1`（または任意の非空値）に設定して有効化します。実際のドメインはバックエンドで `COOKIE_DOMAIN` から読み取られます。
`NEXT_PUBLIC_SOCKET_URL`	`ws://localhost`	リアルタイム共同編集のためのブラウザ側 WebSocket エンドポイント。スキーム + ホスト + ポートのみを指定します（パス `/socket.io/` は固定）。`http(s)://` を `ws(s)://` に置き換えてください。例：`wss://dify.example.com`。デフォルトは同梱 nginx の 80 番ポートに対応します。ランタイムで適用されるため、コンテナ再起動で反映されます。
`NEXT_PUBLIC_BATCH_CONCURRENCY`	`5`	フロントエンドのみ。バッチ操作時に UI が発行する同時 API コール数を制御します。

Dify CLI とプログラマティック API

/openapi/v1/* は、Dify CLI（difyctl）などのクライアントが OAuth ベアラートークンで利用する、ユーザー単位のプログラマティック API です。デフォルトでは無効です。CLI を使うには OPENAPI_ENABLED と ENABLE_OAUTH_BEARER の両方を true にします。

変数	デフォルト値	説明
`OPENAPI_ENABLED`	`false`	Dify CLI（`difyctl`）が利用する `/openapi/v1/` プログラマティック API のマスタースイッチ。 `false` の間はすべての `/openapi/v1/` エンドポイントが 404 を返し、`difyctl login` を開始できません。`ENABLE_OAUTH_BEARER` と併せて有効にします。
`ENABLE_OAUTH_BEARER`	`false`	`/openapi/v1/*` の OAuth ベアラー認証を有効にし、デバイスフローのログイン承認も制御します。 `OPENAPI_ENABLED=true` でもこれが `false` だと、`difyctl login` は承認時に 503 で失敗します。CLI には両方の `true` が必要です。
`OPENAPI_KNOWN_CLIENT_IDS`	`difyctl`	デバイスフローのログインを開始できる OAuth クライアント ID（カンマ区切り）。 ID を追加すればコード変更なしで他のクライアントを許可できます。`difyctl` を外すと CLI ログインが `unsupported_client` で失敗します。
`OAUTH_TTL_DAYS`	`14`	`difyctl login` によるログインの有効日数。ログインした時点から数えます。1～365 を指定でき、範囲外の値は近いほうの上限または下限に補正されます。変更は新しいログインにのみ反映されます。
`OPENAPI_CORS_ALLOW_ORIGINS`	（空）	`/openapi/v1/*` をクロスオリジンで呼び出せるブラウザオリジン（カンマ区切り）。空の場合はすべて拒否します。標準デプロイでは影響がなく、CLI などブラウザ以外のクライアントは CORS の対象外です。
`OPENAPI_RATE_LIMIT_PER_TOKEN`	`60`	OAuth ベアラートークンごとの `/openapi/v1/*` に対する 1 分あたりのリクエスト上限。Redis 経由でレプリカ間に共有されます。超過すると 429 と `Retry-After` ヘッダーを返します。`0` で無効化できます。
`DEVICE_FLOW_APPROVE_RATE_LIMIT_PER_HOUR`	`10`	1 つのブラウザセッションが 1 時間に承認・拒否できるデバイスフローログインの回数。超えると承認が 429 を返し、ウィンドウのリセット待ちになります。`0` は指定できません。

ファイルストレージ設定

Dify がアップロードファイル、データセットドキュメント、暗号化キーを保存する場所を設定します。各ストレージタイプには独自の資格情報変数があります。使用するもののみを設定してください。

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 のファイルシステムスキームを使用）。

OpenDAL（デフォルト）

Apache OpenDAL を使用するデフォルトのストレージバックエンド。多くのストレージサービスをサポートする統一インターフェースです。Dify は OPENDAL_<SCHEME>_* に一致する環境変数を自動スキャンし、OpenDAL に渡します。例えば、OPENDAL_SCHEME=s3 の場合、OPENDAL_S3_ACCESS_KEY_ID、OPENDAL_S3_SECRET_ACCESS_KEY などを設定します。

変数	デフォルト値	説明
`OPENDAL_SCHEME`	`fs`	使用するストレージサービス。例：`fs`（ローカルファイルシステム）、`s3`、`gcs`、`azblob`。

デフォルトの fs スキームの場合：

変数	デフォルト値	説明
`OPENDAL_FS_ROOT`	`storage`	ローカルファイルシステムストレージのルートディレクトリ。存在しない場合は自動作成されます。

利用可能なすべてのスキームとその設定オプションについては、 OpenDAL サービスドキュメントを参照してください。

変数	デフォルト値	説明
`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`。バケット名を URL パスに含める（`path`）か、サブドメインとして使用する（`virtual`）かを制御します。`S3_USE_AWS_MANAGED_IAM` が `false` の場合のみ有効です。
`S3_USE_AWS_MANAGED_IAM`	`false`	明示的な access key や secret key の代わりに AWS IAM ロールを使用します。対象は EC2 インスタンスプロファイルや ECS タスクロールです。有効時はインスタンスメタデータから資格情報を自動検出します。

Azure Blob

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`GOOGLE_STORAGE_BUCKET_NAME`	（空）	Google Cloud Storage バケット名。
`GOOGLE_STORAGE_SERVICE_ACCOUNT_JSON_BASE64`	（空）	Base64 エンコードされたサービスアカウント JSON キー。

Alibaba Cloud OSS

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`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`	仮想ホスト型の代わりにパス型 URL を使用。

Volcengine TOS

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`BAIDU_OBS_BUCKET_NAME`	（空）	Baidu OBS バケット名。
`BAIDU_OBS_ACCESS_KEY`	（空）	Baidu OBS access key。
`BAIDU_OBS_SECRET_KEY`	（空）	Baidu OBS secret key。
`BAIDU_OBS_ENDPOINT`	（空）	Baidu OBS サーバー URL。

Supabase

変数	デフォルト値	説明
`SUPABASE_BUCKET_NAME`	（空）	Supabase ストレージバケット名。
`SUPABASE_API_KEY`	（空）	Supabase API キー。
`SUPABASE_URL`	（空）	Supabase サーバー URL。

ClickZetta Volume

変数	デフォルト値	説明
`CLICKZETTA_VOLUME_TYPE`	`user`	ボリュームタイプ。オプション：`user`（個人/小規模チーム）、`table`（エンタープライズマルチテナント）、`external`（データレイク統合）。
`CLICKZETTA_VOLUME_NAME`	（空）	外部ボリューム名（`TYPE=external` の場合のみ必要）。
`CLICKZETTA_VOLUME_TABLE_PREFIX`	`dataset_`	テーブルボリュームのテーブルプレフィックス（`TYPE=table` の場合のみ使用）。
`CLICKZETTA_VOLUME_DIFY_PREFIX`	`dify_km`	他のアプリから分離するための Dify ファイルディレクトリプレフィックス。

ClickZetta Volume は、ベクトルデータベースセクションで設定された CLICKZETTA_* 接続パラメータを再利用します。

アーカイブストレージ

ワークフロー実行ログをアーカイブするための独立した S3 互換ストレージ。archive-workflow-runs メンテナンスコマンドが、指定した期限より古いワークフロー実行を月単位の Parquet バンドルにまとめます。アーカイブから生成される CSV エクスポートはエクスポート用バケットに一時保存されます。

変数	デフォルト値	説明
`ARCHIVE_STORAGE_ENABLED`	`false`	ワークフローログアーカイブ用のアーカイブストレージを有効化。
`ARCHIVE_STORAGE_ENDPOINT`	（空）	S3 互換エンドポイント URL。
`ARCHIVE_STORAGE_ARCHIVE_BUCKET`	（空）	アーカイブされたワークフロー実行ログ用バケット。
`ARCHIVE_STORAGE_EXPORT_BUCKET`	（空）	アーカイブされたログから生成される一時的な CSV エクスポート ZIP 用バケット。バケットのライフサイクルルールで自動削除できます。
`ARCHIVE_STORAGE_ACCESS_KEY`	（空）	Access key。
`ARCHIVE_STORAGE_SECRET_KEY`	（空）	Secret key。
`ARCHIVE_STORAGE_REGION`	`auto`	ストレージリージョン。
`ARCHIVE_STORAGE_ADDRESS_STYLE`	`path`	アーカイブストレージの S3 アドレッシングスタイル。リクエスト URL のどこにバケット名を置くかを決めます。プロバイダーがパス形式のリクエストを拒否する場合は、`virtual` に切り替えてください。 `path` はパスに置く（`https://<endpoint>/<bucket>/...`）。 `virtual` はホスト名に置く（`https://<bucket>.<endpoint>/...`）。 `auto` は S3 クライアントに判断を任せる。アーカイブ用とエクスポート用の両方のバケットに適用され、CSV エクスポートのダウンロードリンクも対象です。 `S3_ADDRESS_STYLE` とは別に設定し、デフォルトも異なります。

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

ナレッジベースのエンベディング保存と類似検索に使用するベクトルデータベースを設定します。各プロバイダーには独自の資格情報変数があります。使用するもののみを設定してください。

VECTOR_STORE

デフォルト値：weaviate ベクトルデータベースバックエンドを選択します。データセットに既にインデックスがある場合、データセットに保存されたタイプがこの設定より優先されます。Docker Compose でプロバイダーを切り替える場合、COMPOSE_PROFILES がこの値に基づいて対応するコンテナを自動起動します。サポートされる値：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。

変数	デフォルト値	説明
`VECTOR_INDEX_NAME_PREFIX`	`Vector_index`	ベクトルデータベースのコレクション名に追加されるプレフィックス。複数の Dify デプロイでベクトルデータベースインスタンスを共有する場合に変更してください。

Weaviate

変数	デフォルト値	説明
`WEAVIATE_ENDPOINT`	`http://weaviate:8080`	Weaviate REST API エンドポイント。
`WEAVIATE_API_KEY`	（空）	Weaviate 認証用 API キー。
`WEAVIATE_GRPC_ENDPOINT`	`grpc://weaviate:50051`	高性能バイナリプロトコル用の別の gRPC エンドポイント。バッチ操作が大幅に高速になります。未設定の場合、HTTP エンドポイントから推測されます。
`WEAVIATE_TOKENIZATION`	`word`	テキストフィールドのトークン化方法。オプション：`word`（空白と句読点で分割）、`whitespace`（空白のみで分割）、`character`（文字レベル、CJK 言語に適しています）。

OceanBase / seekdb

seekdb は OceanBase のライト版であり、同じ接続設定を共有します。

変数	デフォルト値	説明
`OCEANBASE_VECTOR_HOST`	`oceanbase`	ホスト名または IP アドレス。
`OCEANBASE_VECTOR_PORT`	`2881`	ポート番号。
`OCEANBASE_VECTOR_USER`	`root@test`	データベースユーザー名。
`OCEANBASE_VECTOR_PASSWORD`	`difyai123456`	データベースパスワード。
`OCEANBASE_VECTOR_DATABASE`	`test`	データベース名。
`OCEANBASE_CLUSTER_NAME`	`difyai`	クラスター名（Docker デプロイのみ）。
`OCEANBASE_MEMORY_LIMIT`	`6G`	OceanBase のメモリ制限（Docker デプロイのみ）。
`SEEKDB_MEMORY_LIMIT`	`2G`	seekdb のメモリ制限（Docker デプロイのみ）。
`OCEANBASE_ENABLE_HYBRID_SEARCH`	`false`	ベクトル検索と併用する BM25 クエリ用の全文インデックスを有効化。OceanBase >= 4.3.5.1 が必要です。有効化後にコレクションを再作成する必要があります。
`OCEANBASE_FULLTEXT_PARSER`	`ik`	全文パーサー。組み込み：`ngram`、`beng`、`space`、`ngram2`、`ik`。外部（プラグインが必要）：`japanese_ftparser`、`thai_ftparser`。

Qdrant

変数	デフォルト値	説明
`QDRANT_URL`	`http://qdrant:6333`	Qdrant エンドポイントアドレス。
`QDRANT_API_KEY`	`difyai123456`	Qdrant 用 API キー。
`QDRANT_CLIENT_TIMEOUT`	`20`	クライアントタイムアウト（秒）。
`QDRANT_GRPC_ENABLED`	`false`	gRPC 通信を有効化。
`QDRANT_GRPC_PORT`	`6334`	gRPC ポート。
`QDRANT_REPLICATION_FACTOR`	`1`	シャードごとのレプリカ数。

Milvus

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`MYSCALE_HOST`	`myscale`	MyScale ホスト。
`MYSCALE_PORT`	`8123`	MyScale ポート。
`MYSCALE_USER`	`default`	ユーザー名。
`MYSCALE_PASSWORD`	（空）	パスワード。
`MYSCALE_DATABASE`	`dify`	データベース名。
`MYSCALE_FTS_PARAMS`	（空）	全文検索パラメータ。多言語サポートリファレンス。

Couchbase

変数	デフォルト値	説明
`COUCHBASE_CONNECTION_STRING`	`couchbase://couchbase-server`	Couchbase クラスターの接続文字列。
`COUCHBASE_USER`	`Administrator`	ユーザー名。
`COUCHBASE_PASSWORD`	`password`	パスワード。
`COUCHBASE_BUCKET_NAME`	`Embeddings`	バケット名。
`COUCHBASE_SCOPE_NAME`	`_default`	スコープ名。

Hologres

変数	デフォルト値	説明
`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`	スキーマ名。
`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

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`PGVECTO_RS_HOST`	`pgvecto-rs`	ホスト名。
`PGVECTO_RS_PORT`	`5432`	ポート番号。
`PGVECTO_RS_USER`	`postgres`	ユーザー名。
`PGVECTO_RS_PASSWORD`	`difyai123456`	パスワード。
`PGVECTO_RS_DATABASE`	`dify`	データベース名。

AnalyticDB

変数	デフォルト値	説明
`ANALYTICDB_KEY_ID`	（空）	Aliyun access key ID。AccessKey の作成。
`ANALYTICDB_KEY_SECRET`	（空）	Aliyun access key secret。
`ANALYTICDB_REGION_ID`	`cn-hangzhou`	リージョン識別子。
`ANALYTICDB_INSTANCE_ID`	（空）	インスタンス ID（例：`gp-xxxxxx`）。インスタンスの作成。
`ANALYTICDB_ACCOUNT`	（空）	アカウント名。アカウントの作成。
`ANALYTICDB_PASSWORD`	（空）	アカウントパスワード。
`ANALYTICDB_NAMESPACE`	`dify`	名前空間（スキーマ）。存在しない場合は自動作成されます。
`ANALYTICDB_NAMESPACE_PASSWORD`	（空）	名前空間パスワード。新しい名前空間作成時に使用されます。
`ANALYTICDB_HOST`	（空）	直接接続ホスト（API ベースのアクセスの代替）。
`ANALYTICDB_PORT`	`5432`	直接接続ポート。
`ANALYTICDB_MIN_CONNECTION`	`1`	最小プール接続数。
`ANALYTICDB_MAX_CONNECTION`	`5`	最大プール接続数。

TiDB Vector

変数	デフォルト値	説明
`TIDB_VECTOR_HOST`	`tidb`	ホスト名。
`TIDB_VECTOR_PORT`	`4000`	ポート番号。
`TIDB_VECTOR_USER`	（空）	ユーザー名。
`TIDB_VECTOR_PASSWORD`	（空）	パスワード。
`TIDB_VECTOR_DATABASE`	`dify`	データベース名。
`TIDB_VECTOR_ENABLE_FULLTEXT_SEARCH`	`false`	TiDB Vector 上のナレッジベースで全文検索とハイブリッド検索を利用できるようにします。新規のナレッジベーステーブルには多言語対応の全文インデックスが付与され、既存テーブルには次回ドキュメントをインデックスする際に追加されます。全文インデックスをサポートする TiDB デプロイが必要です。

MatrixOne

変数	デフォルト値	説明
`MATRIXONE_HOST`	`matrixone`	ホスト名。
`MATRIXONE_PORT`	`6001`	ポート番号。
`MATRIXONE_USER`	`dump`	ユーザー名。
`MATRIXONE_PASSWORD`	`111`	パスワード。
`MATRIXONE_DATABASE`	`dify`	データベース名。

Chroma

変数デフォルト値説明
CHROMA_HOST127.0.0.1Chroma サーバーホスト。
CHROMA_PORT8000Chroma サーバーポート。
CHROMA_TENANTdefault_tenantテナント名。
CHROMA_DATABASEdefault_databaseデータベース名。
CHROMA_AUTH_PROVIDERchromadb.auth.token_authn.TokenAuthClientProvider認証プロバイダークラス。
CHROMA_AUTH_CREDENTIALS（空）認証資格情報。

変数	デフォルト値	説明
`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`	認証プロバイダークラス。
`CHROMA_AUTH_CREDENTIALS`	（空）	認証資格情報。

Oracle

変数	デフォルト値	説明
`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 用ウォレットの場所。
`ORACLE_WALLET_PASSWORD`	`dify`	ウォレットパスワード。
`ORACLE_IS_AUTONOMOUS`	`false`	Oracle Autonomous Database を使用するかどうか。

AlibabaCloud MySQL

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`RELYT_HOST`	`db`	ホスト名。
`RELYT_PORT`	`5432`	ポート番号。
`RELYT_USER`	`postgres`	ユーザー名。
`RELYT_PASSWORD`	`difyai123456`	パスワード。
`RELYT_DATABASE`	`postgres`	データベース名。

OpenSearch

変数	デフォルト値	説明
`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 リクエスト署名を使用（AWS Managed OpenSearch または Serverless 用）。
`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）。`aws_managed_iam` 認証でのみ使用。

Tencent Cloud VectorDB

変数	デフォルト値	説明
`TENCENT_VECTOR_DB_URL`	`http://127.0.0.1`	アクセスアドレス。コンソール。
`TENCENT_VECTOR_DB_API_KEY`	`dify`	API キー。キー管理。
`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

変数	デフォルト値	説明
`ELASTICSEARCH_HOST`	`0.0.0.0`	ホスト名。
`ELASTICSEARCH_PORT`	`9200`	ポート番号。
`ELASTICSEARCH_USERNAME`	`elastic`	ユーザー名。
`ELASTICSEARCH_PASSWORD`	`elastic`	パスワード。
`ELASTICSEARCH_USE_CLOUD`	`false`	Elastic Cloud モードに切り替え。`true`の場合、host/port/username/password の代わりに `ELASTICSEARCH_CLOUD_URL`と `ELASTICSEARCH_API_KEY` を使用します。
`ELASTICSEARCH_CLOUD_URL`	（空）	Elastic Cloud エンドポイント URL。`ELASTICSEARCH_USE_CLOUD=true` の場合に必要です。
`ELASTICSEARCH_API_KEY`	（空）	Elastic Cloud API キー。`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

変数	デフォルト値	説明
`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 キー。
`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`	Baidu Vector DB 側で自動インデックス再構築をトリガーする絶対行数増分のしきい値。`_RATIO` と併せて機能し、いずれかのしきい値を先に超えた時点で有効になります。
`BAIDU_VECTOR_DB_AUTO_BUILD_ROW_COUNT_INCREMENT_RATIO`	`0.05`	自動インデックス再構築をトリガーする相対増加率のしきい値（新規行数/既存行数）。上記の絶対しきい値と合わせ、先に達した条件が適用されます。
`BAIDU_VECTOR_DB_REBUILD_INDEX_TIMEOUT_IN_SECONDS`	`300`	インデックス再構築の完了をクライアントが待機する最大時間（秒）。タイムアウト時、クライアント側の呼び出しは失敗しますが、サーバー側の再構築は完了する可能性があります。しばらく経ってから再度クエリを投げれば成功することが多いです。

VikingDB

変数	デフォルト値	説明
`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`	Socket タイムアウト（秒）。

Lindorm

変数	デフォルト値	説明
`LINDORM_URL`	`http://localhost:30070`	Lindorm 検索エンジン URL。コンソール。
`LINDORM_USERNAME`	`admin`	ユーザー名。
`LINDORM_PASSWORD`	`admin`	パスワード。
`LINDORM_USING_UGC`	`true`	UGC モードを使用。
`LINDORM_QUERY_TIMEOUT`	`1`	クエリタイムアウト（秒）。

OpenGauss

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`HUAWEI_CLOUD_HOSTS`	`https://127.0.0.1:9200`	クラスターエンドポイント URL。
`HUAWEI_CLOUD_USER`	`admin`	ユーザー名。
`HUAWEI_CLOUD_PASSWORD`	`admin`	パスワード。

Upstash Vector

変数	デフォルト値	説明
`UPSTASH_VECTOR_URL`	（空）	Upstash Vector エンドポイント URL。
`UPSTASH_VECTOR_TOKEN`	（空）	Upstash Vector API トークン。

TableStore

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`CLICKZETTA_USERNAME`	（空）	ユーザー名。
`CLICKZETTA_PASSWORD`	（空）	パスワード。
`CLICKZETTA_INSTANCE`	（空）	インスタンス名。
`CLICKZETTA_SERVICE`	`api.clickzetta.com`	サービスエンドポイント。
`CLICKZETTA_WORKSPACE`	`quick_start`	ワークスペース名。
`CLICKZETTA_VCLUSTER`	`default_ap`	仮想クラスター。
`CLICKZETTA_SCHEMA`	`dify`	スキーマ名。
`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

変数	デフォルト値	説明
`IRIS_HOST`	`iris`	ホスト名。
`IRIS_SUPER_SERVER_PORT`	`1972`	スーパーサーバーポート。
`IRIS_USER`	`_SYSTEM`	ユーザー名。
`IRIS_PASSWORD`	`Dify@1234`	パスワード。
`IRIS_DATABASE`	`USER`	データベース名。
`IRIS_SCHEMA`	`dify`	スキーマ名。
`IRIS_CONNECTION_URL`	（空）	完全な接続 URL（個別設定をオーバーライド）。
`IRIS_MIN_CONNECTION`	`1`	最小プール接続数。
`IRIS_MAX_CONNECTION`	`3`	最大プール接続数。
`IRIS_TEXT_INDEX`	`true`	テキストインデックスを有効化。
`IRIS_TEXT_INDEX_LANGUAGE`	`en`	テキストインデックスの言語。

ナレッジベース設定

変数	デフォルト値	説明
`UPLOAD_FILE_SIZE_LIMIT`	`15`	ドキュメントアップロード（PDF、Word ドキュメントなど）の最大ファイルサイズ（MB）。超過するとユーザーに「ファイルが大きすぎます」エラーが表示されます。画像、動画、音声には適用されません。それらには下記の別の制限があります。
`UPLOAD_FILE_BATCH_LIMIT`	`5`	フロントエンドがアップロードバッチごとに許可する最大ファイル数。
`UPLOAD_FILE_EXTENSION_BLACKLIST`	（空）	アップロードできないファイル拡張子のセキュリティブロックリスト。カンマ区切り、小文字、ドットなし。例：`exe,bat,cmd,com,scr,vbs,ps1,msi,dll`。空の場合はすべてのタイプを許可します。
`SINGLE_CHUNK_ATTACHMENT_LIMIT`	`10`	単一のナレッジベースセグメント（チャンク）に埋め込める最大画像数。
`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`	ドキュメント抽出ライブラリ。`dify`は txt、md、pdf、html、xlsx、docx、csv をサポートします。`Unstructured`は doc、msg、eml、ppt、pptx、xml、epub のサポートを追加します（`UNSTRUCTURED_API_URL` が必要）。
`UNSTRUCTURED_API_URL`	（空）	Unstructured.io API エンドポイント。`ETL_TYPE`が `Unstructured`の場合に必要です。`.ppt`ファイルのサポートにも必要です。例：`http://unstructured:8000/general/v0/general`。
`UNSTRUCTURED_API_KEY`	（空）	Unstructured.io 認証用 API キー。
`SCARF_NO_ANALYTICS`	`true`	Unstructured ライブラリのテレメトリ/分析収集を無効化。
`TOP_K_MAX_VALUE`	`10`	ナレッジベース検索で `top_k` パラメータ（検索ごとの結果返却数）にユーザーが設定できる最大値。
`DATASET_MAX_SEGMENTS_PER_REQUEST`	`0`	データセット API リクエストごとの最大セグメント数。`0` は無制限を意味します。

アノテーションインポート

変数	デフォルト値	説明
`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`	ワークスペースごとの 1 分あたりの最大アノテーションインポートリクエスト数。超過すると HTTP 429 が返されます。
`ANNOTATION_IMPORT_RATE_LIMIT_PER_HOUR`	`20`	ワークスペースごとの 1 時間あたりの最大アノテーションインポートリクエスト数。
`ANNOTATION_IMPORT_MAX_CONCURRENT`	`5`	ワークスペースごとの最大同時アノテーションインポートタスク数。古いタスクは 2 分後に自動クリーンアップされます。

モデル設定

変数	デフォルト値	説明
`PLUGIN_BASED_TOKEN_COUNTING_ENABLED`	`false`	正確な使用量追跡のためにプラグインベースのトークンカウントを使用。無効の場合、トークンカウントは 0 を返します（高速ですがコスト追跡の精度が低下します）。

マルチモーダル設定

変数	デフォルト値	説明
`MULTIMODAL_SEND_FORMAT`	`base64`	マルチモーダル LLM にファイルを送信する方法。`base64`はリクエストにファイルデータを埋め込みます（互換性が高く、オフラインで動作、ペイロードが大きい）。`url`は署名付き URL を送信してモデルに取得させます（高速、リクエストが小さいですが、モデルが `FILES_URL` にアクセスできる必要があります）。
`UPLOAD_IMAGE_FILE_SIZE_LIMIT`	`10`	直接アップロードの最大画像ファイルサイズ（MB）（jpg、png、webp、gif、svg）。
`UPLOAD_VIDEO_FILE_SIZE_LIMIT`	`100`	直接アップロードの最大動画ファイルサイズ（MB）（mp4、mov、mpeg、webm）。
`UPLOAD_AUDIO_FILE_SIZE_LIMIT`	`50`	直接アップロードの最大音声ファイルサイズ（MB）（mp3、m4a、wav、amr、mpga）。

すべてのアップロードサイズ制限は NGINX_CLIENT_MAX_BODY_SIZE（デフォルト 100M）によっても制限されます。アップロード制限を 100 MB を超えて増加する場合は、NGINX_CLIENT_MAX_BODY_SIZE も同様に増加してください。そうしないと、Nginx が 413 エラーでアップロードを拒否します。

Sentry 設定

Sentry はエラー追跡とパフォーマンス監視を提供します。各サービスにはエラーレポートを分離するための独自の DSN があります。

変数	デフォルト値	説明
`SENTRY_DSN`	（空）	サービス間で共有される Sentry DSN。
`API_SENTRY_DSN`	（空）	API サービス用の Sentry DSN。設定されている場合、`SENTRY_DSN` をオーバーライドします。空の場合、バックエンドの Sentry が無効になります。
`API_SENTRY_TRACES_SAMPLE_RATE`	`1.0`	パフォーマンストレーシングに含めるリクエストの割合（0.01 = 1%、1.0 = 100%）。トレースはサービス間のリクエストフローを追跡します。
`API_SENTRY_PROFILES_SAMPLE_RATE`	`1.0`	CPU/メモリプロファイリングに含めるリクエストの割合（0.01 = 1%）。プロファイルはコード内で時間が費やされている箇所を表示します。
`SENTRY_TRACES_SAMPLE_RATE`	`1.0`	`API_SENTRY_TRACES_SAMPLE_RATE` の直接名で、`docker/envs/core-services/` 配下の設定ファイルが使用します。 Compose 構成では `API_SENTRY_*` の値が優先されます。Sentry DSN が空の間は無効です。
`SENTRY_PROFILES_SAMPLE_RATE`	`1.0`	`API_SENTRY_PROFILES_SAMPLE_RATE` の直接名で、用途は上と同じです。プロファイリングはトレース対象に選ばれたリクエストからのみ採取されるため、実際の量はおおよそ両レートの積になります。
`WEB_SENTRY_DSN`	（空）	Web フロントエンド（Next.js）用の Sentry DSN。フロントエンドのみ。
`PLUGIN_SENTRY_ENABLED`	`false`	プラグインデーモンサービスの Sentry を有効化。
`PLUGIN_SENTRY_DSN`	（空）	プラグインデーモン用の Sentry DSN。

Notion 連携設定

ナレッジベースデータソースとして Dify を Notion に接続します。 https://www.notion.so/my-integrations で連携資格情報を取得してください。

変数	デフォルト値	説明
`NOTION_INTEGRATION_TYPE`	`public`	`public`は標準 OAuth 2.0 を使用します（HTTPS リダイレクト URL が必要、CLIENT_ID + CLIENT_SECRET が必要）。`internal`は直接連携トークンを使用します（HTTP で動作）。ローカルデプロイには `internal` を使用してください。
`NOTION_CLIENT_SECRET`	（空）	OAuth クライアントシークレット。`public` 連携に必要です。
`NOTION_CLIENT_ID`	（空）	OAuth クライアント ID。`public` 連携に必要です。
`NOTION_INTERNAL_SECRET`	（空）	Notion からの直接連携トークン。`internal` 連携に必要です。

メール設定

Dify はアカウント招待、パスワードリセット、ログインコード、人間の入力ノード通知のメールを送信します。サポートされる 3 つのプロバイダーのいずれかを設定してください。メールリンクには CONSOLE_WEB_URL の設定が必要です。共通変数を参照してください。

変数	デフォルト値	説明
`MAIL_TYPE`	`resend`	メールプロバイダー：`resend`、`smtp`、または `sendgrid`。
`MAIL_DEFAULT_SEND_FROM`	（空）	すべての送信メールのデフォルト「From」アドレス。必須です。

Resend

変数	デフォルト値	説明
`RESEND_API_URL`	`https://api.resend.com`	Resend API エンドポイント。セルフホスト Resend またはプロキシ用にオーバーライドします。
`RESEND_API_KEY`	（空）	Resend API キー。`MAIL_TYPE=resend` の場合に必要です。

SMTP

3 つの 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）。

変数	デフォルト値	説明
`SMTP_SERVER`	（空）	SMTP サーバーアドレス。
`SMTP_PORT`	`465`	SMTP サーバーポート。STARTTLS モードの場合は `587` を使用してください。
`SMTP_USERNAME`	（空）	SMTP ユーザー名。IP ホワイトリストされたサーバーでは空にできます。
`SMTP_PASSWORD`	（空）	SMTP パスワード。IP ホワイトリストされたサーバーでは空にできます。
`SMTP_USE_TLS`	`true`	TLS を有効化。`true`で `SMTP_OPPORTUNISTIC_TLS=false`の場合、暗黙的 TLS（`SMTP_SSL`）を使用します。
`SMTP_OPPORTUNISTIC_TLS`	`false`	暗黙的 TLS の代わりに STARTTLS（明示的 TLS）を使用。`SMTP_USE_TLS=true` と併用する必要があります。
`SMTP_LOCAL_HOSTNAME`	（空）	SMTP HELO/EHLO で送信されるホスト名をオーバーライド。SMTP サーバーがコンテナホスト名を拒否する場合に Docker で必要です（Google Workspace、Microsoft 365 でよく発生）。ドメインに設定してください（例：`mail.yourdomain.com`）。

SendGrid

変数	デフォルト値	説明
`SENDGRID_API_KEY`	（空）	SendGrid API キー。`MAIL_TYPE=sendgrid` の場合に必要です。

詳細については、 SendGrid ドキュメントを参照してください。

その他の設定

コンソール機能

変数	デフォルト値	説明
`ENABLE_LEARN_APP`	`true`	Learn Dify セクションの表示を切り替えます。対象は探索ページのチュートリアルテンプレート、スタジオにアプリがないときの入門パネル、ヘルプメニューの表示切り替えです。 `false` で 3 か所とも非表示になります。
`ENABLE_SKILL`	`true`	メインナビゲーションに Skills を表示します。 `false` にすると、ワークスペースの UI からスキルが非表示になります。

認証とアカウント

デフォルトでは、サインインはメールアドレスとパスワードで行い、新しいアカウントはワークスペースへの招待または初期セットアップウィザードで作成します。以下のトグルでこの方針を調整できます。

変数	デフォルト値	説明
`ENABLE_EMAIL_PASSWORD_LOGIN`	`true`	メールアドレスとパスワードでコンソールにサインインします。無効にすると、サインインページからパスワードフォームが消え、パスワードログイン、パスワードリセット、セルフサービス登録の各エンドポイントが 403 を返します。サインイン方法は必ず 1 つ以上有効にしてください。すべて無効にすると、認証方式が未設定である旨が表示され、設定を戻すまで誰もログインできません。
`ENABLE_EMAIL_CODE_LOGIN`	`false`	パスワードの代わりに、メールで届く 6 桁のワンタイムコードでサインインします。メール送信の設定が必要です（メール設定を参照）。未設定ではコードが届きません。`ALLOW_REGISTER=true` の場合、未登録のメールアドレスでコードを入力するとアカウントも作成されるため、セルフサービス登録の経路にもなります。
`EMAIL_CODE_LOGIN_TOKEN_EXPIRY_MINUTES`	`5`	サインインコードの有効時間（分）。期限切れのコードは拒否され、再取得が必要です。
`EMAIL_CODE_LOGIN_MAX_ATTEMPTS`	`5`	1 つのサインインコードで許容される入力ミスの最大回数。超えるとコードが無効になり、再取得が必要です。
`ENABLE_SOCIAL_OAUTH_LOGIN`	`false`	コンソールのサインインページに GitHub と Google のサインインボタンを表示します。ボタンが機能するのは、対応する GitHub または Google の OAuth アプリ認証情報を API サービスに設定した場合だけです。フラグだけ有効にして認証情報が未設定だと、サインインは失敗します。初回の OAuth サインインでアカウントが作成されるのは `ALLOW_REGISTER=true` のときだけです。
`ALLOW_REGISTER`	`false`	アカウントの自己作成を許可します。サインインページに新規登録リンクを表示し（パスワードログインが有効な場合）、初回のメールコードまたは OAuth サインインでのアカウント作成を許可します。招待制にするには `false` のままにします。ワークスペースへの招待と初期セットアップウィザードは常に利用できます。
`ALLOW_CREATE_WORKSPACE`	`false`	どのワークスペースにも属さないアカウントに対して、セルフサービス登録時やメールコード、OAuth サインイン時にワークスペースを自動作成します。`false` の場合、こうしたアカウントはワークスペースへの招待を待つ必要があります。セットアップウィザードが作成する管理者ワークスペースには影響しません。
`ENABLE_CHANGE_EMAIL`	`true`	アカウント設定ページからメールアドレスを変更できるようにします。変更はメールの確認コードで検証されるため、メール送信の設定が必要です。外部ディレクトリと一致させる必要がある場合など、メールアドレスを固定したいときは `false` に設定します。

LLMOps トレース配信

アプリ実行のトレースは、バックグラウンドタスクが LLMOps プロバイダーへ配信します。対象のプロバイダーは Langfuse、LangSmith、Arize/Phoenix などです。Docker Compose でデプロイする場合は、docker/envs/core-services/shared.env にこれらの変数を設定します。

変数	デフォルト値	説明
`OPS_TRACE_UNIFIED_ENABLED`	`false`	`true` にすると、LangSmith と Arize/Phoenix のトレースに共通の構造を使います。ワークフロー実行、ノード、それらの親子関係を記録します。デフォルトの `false` では、各プロバイダーの従来のトレース実装を使います。他のプロバイダーには影響しません。各アプリで LLMOps を有効にし、プロバイダーを設定する必要があります。
`OPS_AGENT_TRACE_ENABLED`	`false`	`true` にすると、Agent のモデル呼び出しとツール呼び出しがトレースに含まれます。対象は Agent アプリと、Agent ノードを含む Workflow アプリおよび Chatflow アプリです。アプリが呼び出すワークフローツール内の Agent は含まれません。あわせて `DIFY_AGENT_APPLICATION_TRACING_ENABLED` も `true` にしてください。 `false` の間は、Agent、Workflow、Chatflow アプリのトレース設定に、Agent トレースを利用できない旨が表示されます。各アプリでトレースを有効にしてプロバイダーを設定し、Agent の内部処理を収集をオンのままにしておく必要もあります（デフォルトはオン）。
`DIFY_AGENT_APPLICATION_TRACING_ENABLED`	`false`	`OPS_AGENT_TRACE_ENABLED` と対になる Agent バックエンド側の設定です。Agent をトレースするには両方を `true` にしてください。 `docker/envs/core-services/dify-agent.env` で設定します。Agent バックエンドは `shared.env` を読み込まないため、そちらに設定しても反映されません。
`ENABLE_APPLICATION_TRACE_RECONCILE_TASK`	`true`	`OPS_AGENT_TRACE_ENABLED` が `true` の場合のみ有効です。30 秒ごとにバックグラウンドジョブを実行し、配信待ちの Agent トレースを再送します。保持期間（デフォルトで 7 日）を過ぎると、Dify が保存している Agent トレースデータも削除します。トレースプロバイダーにすでに配信されたデータは削除されません。
`OPS_TRACE_RETRYABLE_DISPATCH_MAX_RETRIES`	`780`	一時的な失敗後にトレース配信をリトライする最大回数。超えるとそのトレースは破棄されます。デフォルトのリトライ時間（回数 × `OPS_TRACE_RETRYABLE_DISPATCH_DELAY_SECONDS`）は、1 時間のワークフロー上限とエクスポート猶予期間を上回るよう設定されています。現在この経路に入るのは、Arize/Phoenix でネストしたワークフローをトレースする場合のみです。子トレースが親のコンテキストより先に届くと発生します。`0` は指定できません。
`OPS_TRACE_RETRYABLE_DISPATCH_DELAY_SECONDS`	`5`	リトライの間隔（秒）。許容ウィンドウは間隔 × 最大回数（デフォルトで約 65 分）です。小さくするとネストしたトレースが早く届く一方、リトライ回数を早く使い切ります。`0` は指定できません。
`OPS_TRACE_PARENT_CONTEXT_TTL_SECONDS`	`3900`	親ワークフローのトレースコンテキストを保持する時間（秒）。保持中は、後から届くネストした子トレースが親に接続できます。 `OPS_TRACE_UNIFIED_ENABLED` が `true` の場合、リトライ時間（回数 × 間隔）以上に設定してください。これより小さいと、Dify は設定を読み込めません。

インデックス作成

変数	デフォルト値	説明
`INDEXING_MAX_SEGMENTATION_TOKENS_LENGTH`	`4000`	ナレッジベース用にドキュメントをチャンク化する際のテキストセグメントごとの最大トークン長。大きい値はチャンクあたりのコンテキストを多く保持し、小さい値はより細かい粒度を提供します。

新規ユーザーのデフォルト設定

変数	デフォルト値	説明
`NEW_USER_DEFAULT_PLUGIN_IDS`	（空）	新しいワークスペースの作成時に自動インストールされるマーケットプレイスのプラグイン ID（カンマ区切り）。
`NEW_USER_DEFAULT_MODELS`	（空）	新しいワークスペースに設定されるデフォルトモデル。`model_type:provider:model` 形式のカンマ区切り。

ワークフロー生成

変数	デフォルト値	説明
`WORKFLOW_GENERATION_TIMEOUT_MS`	`180000`	`/create` または `/refine` によるアプリ生成 1 回を UI が待つ時間。web コンテナが読み込む。
`WORKFLOW_GENERATOR_NODE_BUILDER_MAX_WORKERS`	`6`	`/create`／`/refine` の生成リクエスト 1 回あたりの、ノード構成を組み立てる LLM 呼び出しの最大並列数。

トークンと招待

すべてのトークン有効期限変数は、Redis に保存されるワンタイムトークンの有効期間を制御します。期限切れ後、ユーザーは新しいトークンをリクエストする必要があります。

変数	デフォルト値	説明
`INVITE_EXPIRY_HOURS`	`72`	ワークスペース招待リンクの有効期間（時間）。
`RESET_PASSWORD_TOKEN_EXPIRY_MINUTES`	`5`	パスワードリセットトークンの有効期間（分）。
`EMAIL_REGISTER_TOKEN_EXPIRY_MINUTES`	`5`	メール登録トークンの有効期間（分）。
`CHANGE_EMAIL_TOKEN_EXPIRY_MINUTES`	`5`	メール変更トークンの有効期間（分）。
`OWNER_TRANSFER_TOKEN_EXPIRY_MINUTES`	`5`	ワークスペースオーナー移譲トークンの有効期間（分）。

コード実行サンドボックス

以下の設定は、API と Worker がサンドボックスに接続する方法を指定します。サンドボックスは、コードノード（Python、JavaScript）とテンプレート変換ノード（Jinja2）を分離して実行する独立したサービスです。

変数	デフォルト値	説明
`CODE_EXECUTION_ENDPOINT`	`http://sandbox:8194`	サンドボックスサービスエンドポイント。
`CODE_EXECUTION_API_KEY`	`dify-sandbox`	サンドボックス認証用 API キー。サンドボックスサービスの `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`	アイドルなサンドボックス接続が閉じられるまでの秒数。

コードとテンプレートの出力制限

API と Worker は、コードノードとテンプレート変換ノードの出力にこれらの制限を適用します。サンドボックスサービスはこれらの変数を読み取りません。変更を反映するには、サンドボックスではなく API と Worker を再起動してください。

変数	デフォルト値	説明
`CODE_MAX_NUMBER`	`9223372036854775807`	コードノード出力で許可される最大数値（最大 64 ビット符号付き整数）。
`CODE_MIN_NUMBER`	`-9223372036854775808`	コードノード出力で許可される最小数値（最小 64 ビット符号付き整数）。
`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`	テンプレート変換ノード出力の最大文字数。

ワークフローランタイム

変数	デフォルト値	説明
`WORKFLOW_MAX_EXECUTION_STEPS`	`500`	ワークフロー実行ごとの最大ノード実行回数。ツールノードが呼び出したワークフローツール内部のノードも数えます。超過するとワークフローが終了されます。
`WORKFLOW_MAX_EXECUTION_TIME`	`3600`	ワークフロー実行ごとの最大実行時間（秒）。超過するとワークフローが終了されます。 `APP_MAX_EXECUTION_TIME` と対になる外側の制限です（両方ともデフォルトは 1 時間）。両方を一緒に増やしてください。Agent を利用する場合は、Agent の実行期限（`DIFY_AGENT_RUN_TIMEOUT_SECONDS`）以上に保ちます。
`WORKFLOW_CALL_MAX_DEPTH`	`5`	ネストされたワークフロー呼び出しの最大深度。無限再帰を防止します。
`MAX_VARIABLE_SIZE`	`204800`	単一のワークフロー変数の最大サイズ（バイト、200 KB）。
`WORKFLOW_FILE_UPLOAD_LIMIT`	`10`	1 つのファイルアップロードフィールド（ユーザー入力ノードのファイル変数など）における最大ファイル数設定の上限です。ノードパネルの最大ファイル数スライダーはこの値で制限されます。フィールドごとの設定をより大きくするには、この値を上げます。
`WORKFLOW_NODE_EXECUTION_STORAGE`	`rdbms`	ワークフローノード実行レコードの保存先。`rdbms`はすべてをデータベースに保存します。`hybrid` は新しいデータをオブジェクトストレージに保存し、両方から読み取ります。
`DSL_EXPORT_ENCRYPT_DATASET_ID`	`true`	DSL ファイルエクスポート時にデータセット ID を暗号化。クロス環境インポートを容易にするためにプレーン ID をエクスポートする場合は `false` に設定してください。

ワークフローストレージリポジトリ

ワークフロー実行データを処理するバックエンド実装を選択します。デフォルトの SQLAlchemy リポジトリはすべてをデータベースに保存します。代替実装（例：Celery、Logstore）は異なるストレージ戦略に使用できます。

変数	デフォルト値	説明
`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`	ループノードの最大反復回数。無限ループを防止します。
`MAX_PARALLEL_LIMIT`	`10`	ワークフロー内の最大並列ブランチ数。
`GRAPH_ENGINE_MAX_WORKERS`	`10`	GraphEngine インスタンスごとのワーカー数。

ワークフローログクリーンアップ

変数	デフォルト値	説明
`WORKFLOW_LOG_CLEANUP_ENABLED`	`false`	毎日午前 2:00 にワークフロー実行ログの自動クリーンアップを有効化。
`WORKFLOW_LOG_RETENTION_DAYS`	`30`	クリーンアップ前にワークフローログを保持する日数。
`WORKFLOW_LOG_CLEANUP_BATCH_SIZE`	`100`	クリーンアップバッチごとに処理するログエントリ数。システムパフォーマンスに基づいて調整してください。
`WORKFLOW_LOG_CLEANUP_SPECIFIC_WORKFLOW_IDS`	（空）	クリーンアップを制限するワークフロー ID のカンマ区切りリスト。空の場合、すべてのワークフローログがクリーンアップされます。

HTTP リクエストノード

ワークフローで外部 API を呼び出すために使用される HTTP リクエストノードの設定です。

変数	デフォルト値	説明
`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

変数	デフォルト値	説明
`WEBHOOK_REQUEST_BODY_MAX_SIZE`	`10485760`	Webhook ペイロードの最大サイズ（バイト、10 MB）。これを超えるペイロードは 413 エラーで拒否されます。

SSRF 保護

Dify からのすべてのアウトバウンド HTTP リクエスト（HTTP ノード、画像ダウンロードなど）は、プロキシを経由します。このプロキシは内部/プライベート IP 範囲へのリクエストをブロックし、Server-Side Request Forgery（SSRF）攻撃を防止します。

変数	デフォルト値	説明
`SSRF_PROXY_HTTP_URL`	`http://ssrf_proxy:3128`	HTTP リクエスト用 SSRF プロキシ URL。
`SSRF_PROXY_HTTPS_URL`	`http://ssrf_proxy:3128`	HTTPS リクエスト用 SSRF プロキシ URL。
`SSRF_POOL_MAX_CONNECTIONS`	`100`	SSRF HTTP クライアントプール内の最大同時接続数。
`SSRF_POOL_MAX_KEEPALIVE_CONNECTIONS`	`20`	SSRF プールで維持する最大アイドル接続数。
`SSRF_POOL_KEEPALIVE_EXPIRY`	`5.0`	アイドルな SSRF 接続が閉じられるまでの秒数。

エージェント設定

変数	デフォルト値	説明
`MAX_TOOLS_NUM`	`10`	エージェントが同時に使用できる最大ツール数。
`MAX_ITERATIONS_NUM`	`99`	エージェント実行ごとの最大推論イテレーション数。無限エージェントループを防止します。

Web フロントエンドサービス

これらの変数は Next.js Web フロントエンドコンテナのみで使用されます。Python バックエンドには影響しません。

変数	デフォルト値	説明
`TEXT_GENERATION_TIMEOUT_MS`	`60000`	ストリーミングテキスト生成 UI のフロントエンドタイムアウト。ストリームがこの時間以上停止した場合、UI はレンダリングを一時停止します。
`ALLOW_INLINE_STYLES`	`false`	ユーザー生成の Markdown コンテンツでインライン `style` 属性と `<style>` ブロックの使用を許可します。セキュリティ上の理由（インラインスタイルはフィッシングに悪用される可能性があります）から、デフォルトでは無効です。信頼できるソースからのリッチなスタイリングが必要な場合にのみ有効化してください。
`ALLOW_UNSAFE_DATA_SCHEME`	`false`	`data:` スキームの URL レンダリングを許可。セキュリティのためデフォルトでは無効です。
`MAX_TREE_DEPTH`	`50`	1 つの実行パスの最大ノード数。上限を超えるワークフローは公開できません。変更は新たに公開するワークフローにのみ適用されます。
`MARKDOWN_FORM_FIELD_NAME_EXTRA_CHARS`	（空）	チャット応答内の Markdown からアプリがレンダリングするフォームで、フィールドの `name` 属性に追加で許可する文字。デフォルトでは、フィールド名は文字で始まり、文字・数字・アンダースコア・ハイフンのみ使用できます。それ以外の文字を名前に含むフィールドはレンダリングされません。追加する文字は 1 つの文字列として設定します。半角と全角のどちらも使用できます。例：`()！？`
`MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH`	`128`	チャット応答内の Markdown からアプリがレンダリングするフォームで、フィールドの `name` 属性に許可する最大長。これより長い名前のフィールドはレンダリングされません。名前に使える文字は `MARKDOWN_FORM_FIELD_NAME_EXTRA_CHARS` で決まり、この変数は長さを制限します。生成されたフィールド名が上限を超え、レンダリングされたフォームにフィールドが欠ける場合は、この値を上げてください。正の整数を指定します。

NEXT_PUBLIC_ENABLE_FEATURE_PREVIEW

デフォルト値：true Go to Anything コマンドパレットの /create と /refine コマンドを有効にします。これらは自然言語の説明から Workflow や Chatflow アプリを生成・修正します。false に設定すると非表示になります。

新しい Agent

新しい Agent は、Docker Compose デプロイで追加サービス（Agent バックエンド、サンドボックス、サンドボックス専用の外向きプロキシ）として動作します。DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN を設定すれば、いずれも docker compose up で起動します。この機能はデフォルトで有効で、設定の大部分は既存の Compose の値から導出されるため、通常は以下の変数だけを確認すれば十分です。

DIFY_AGENT_SERVER_SECRET_KEY

デフォルト値：（.env.example に開発用キーを設定済み。本番環境では必ず置き換えてください） Agent バックエンドが内部トークンの鍵を導出するためのルートシークレットです。サンドボックス内の Agent がバックエンドを呼び出す際のトークンもここから導出されます。デフォルトは公開された開発用キーのため、デプロイはそのまま起動しますが、このキーを知っていれば誰でもトークンを偽造できます。本番環境で使用する前に置き換えてください。値はパディングなしの base64url テキストで、デコードするとちょうど 32 バイトになる必要があります。値が不正な場合、Agent バックエンドは起動しません。次のコマンドで生成できます：

python3 -c "import secrets; print(secrets.token_urlsafe(32))"

DIFY_AGENT_API_TOKEN

デフォルト値：（.env.example に開発用トークンを設定済み。本番環境では必ず置き換えてください） Dify API が Agent バックエンドの実行 API を呼び出す際に提示する Bearer トークンです。Compose は同じ値を両方のサービスに渡すため、一度設定するだけで一致が保たれます。デフォルトは公開された開発用トークンのため、デプロイはそのまま起動します。ただし、Agent バックエンドに到達でき、トークンを知っていれば誰でも実行を開始できます。本番環境で使用する前に、独自のランダムな値に置き換えてください。

DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN

デフォルト値：（空；ランタイムバックエンドがデフォルトの local の場合は必須）同梱のサンドボックスが Agent バックエンドを認証するための共有シークレットです。空のままだと、両方のサービスが起動直後に終了し、再起動を繰り返します。Dify を起動する前に設定してください。 docker/.env で一度設定すれば、Compose が両方のサービスに渡します。docker/envs/ 配下のファイルにだけ設定した値は反映されません。次のコマンドで生成できます：

openssl rand -base64 32

旧 DIFY_AGENT_SHELLCTL_AUTH_TOKEN を置き換えます。旧名も互換エイリアスとして引き続き使えます。

NEXT_PUBLIC_ENABLE_AGENT_V2

デフォルト値：true 新しい Agent を Web UI に表示します。メインナビゲーションの Agents 項目と、ワークフローのノード一覧の新しい Agent ノードです。false にすると非表示になり、クラシック Agent ノードにフォールバックします。ENABLE_AGENT_V2 を置き換えるもので、こちらは引き続きフォールバックとして機能します。

UPLOAD_SKILL_FILE_SIZE_LIMIT

デフォルト値：50 スキルパッケージ（.zip または .skill）の最大サイズを MB 単位で指定します。Agent にアップロードする場合と、スキルライブラリへインポートする場合の両方に適用されます。上限を超えるパッケージはサイズエラーで拒否されます。 100 より大きくする場合は、NGINX_CLIENT_MAX_BODY_SIZE も同じ値以上に設定してください。設定しないと、Nginx が 413 エラーでアップロードを拒否します。この環境変数が制限するのは、パッケージファイル自体のサイズだけです。パッケージの中身には、バイト単位で設定する別の上限があります：

変数	デフォルト値	説明
`SKILL_PACKAGE_MAX_UNCOMPRESSED_BYTES`	`209715200`	展開したスキルパッケージの合計サイズの上限（バイト単位、200 MB）。超過したパッケージは拒否され、Agent へのアップロードでは `archive_too_large`、スキルライブラリでは `skill_too_large` が返る。
`SKILL_PACKAGE_MAX_ENTRIES`	`5000`	スキルパッケージ内のエントリ数の上限。フォルダーもエントリとして数えられる。Agent へのアップロードとライブラリへのインポートのどちらでも同じ。超過したパッケージは `too_many_entries` または `too_many_files` で拒否される。
`SKILL_PACKAGE_MAX_SKILL_MD_BYTES`	`1048576`	パッケージ内の `SKILL.md` のサイズ上限（バイト単位、1 MB）。超過すると `skill_md_too_large` で拒否される。 Agent にアップロードするスキルと、アプリパッケージに同梱されたスキルに適用される。スキルライブラリへのインポートには適用されない。

Agent とアプリのパッケージ制限

これらの制限は、Agent に限らず、すべてのアプリパッケージ（.ifpkg）に適用されます。どのアプリタイプも、デフォルトではこの形式でエクスポートされるためです。制限はエクスポート時とインポート時の両方でチェックされ、ファイルとしてアップロードする場合も URL からインポートする場合も対象です。いずれかの制限を超えるパッケージは、超えた制限を引き上げるまで、エクスポートやインポート全体が失敗します。 100 MB を超えるパッケージをアップロードする場合は、NGINX_CLIENT_MAX_BODY_SIZE も引き上げてください。引き上げないと、Nginx が先にリクエストを拒否します。パッケージに同梱する各スキルも、スキルの制限を満たす必要があります：

インポート時、UPLOAD_SKILL_FILE_SIZE_LIMIT を超えるスキルがあると、インポート全体が失敗します。SKILL_PACKAGE_* の制限を超えるスキルはスキップされ、インポートは警告付きで完了します。そのスキルを取り込むには、超えた制限を引き上げてから、パッケージを再度インポートしてください。
エクスポート時、SKILL_PACKAGE_* の制限を超えるスキルがあると、その制限を引き上げるまでエクスポート全体が失敗します。

変数	デフォルト値	説明
`AGENT_PACKAGE_MAX_BYTES`	`536870912`	パッケージの最大サイズ（バイト単位、512 MB）。圧縮時と展開後の両方でチェックする。展開後のサイズには、同梱スキルの中身も含まれる。大きなファイルやスキルを同梱したアプリや Agent のエクスポート・インポートが失敗する場合に引き上げる。
`AGENT_PACKAGE_MAX_MANIFEST_BYTES`	`5242880`	パッケージ内の各 YAML ファイルの最大サイズ（バイト単位、5 MB）。対象はマニフェストと、Agent パッケージでは Agent の設定ファイル。同梱スキルやファイルは `AGENT_PACKAGE_MAX_BYTES` に計上されるため、この値を引き上げるのは、Agent の設定だけで 5 MB を超える場合に限られる。アプリの DSL には適用されない。DSL は固定の 10 MB 上限のまま。
`AGENT_PACKAGE_MAX_ENTRIES`	`5000`	パッケージ内の項目数の上限。パッケージの項目は、同梱するスキル・ファイル・アイコンごとに 1 件と、いくつかの固定項目からなる。数千のスキルやファイルを同梱したアプリや Agent のエクスポート・インポートが失敗する場合に引き上げる。

AGENT_BACKEND_BASE_URL

デフォルト値：http://agent_backend:5050 API が Agent バックエンドにアクセスするためのアドレスです。Docker Compose ではデフォルトのままにします。その他の変数は、同梱のサービスを設定するか、既存の Compose 値から導出されるため、通常は変更不要です。

変数	デフォルト値	説明
`DIFY_AGENT_REDIS_URL`	（空。`REDIS_PASSWORD` から導出）	Agent バックエンドが実行状態を保存する Redis 接続。Compose のデフォルトは同梱の `redis` のデータベース 2。
`DIFY_AGENT_REDIS_PREFIX`	`dify-agent`	Agent バックエンドの Redis キーのプレフィックス。
`DIFY_AGENT_SHUTDOWN_GRACE_SECONDS`	`30`	Agent バックエンドの停止時に、進行中の実行の完了を待つ秒数。
`DIFY_AGENT_RUN_RETENTION_SECONDS`	`7200`	各 Agent 実行のレコードとイベントストリームを Redis に保持する秒数。最後の書き込みから数える（デフォルトは 2 時間）。値を下げると Redis メモリを早く解放できるが、切断後にイベントを再生できる期間も短くなる。
`DIFY_AGENT_RUN_EVENT_STREAM_MAX_LENGTH`	`5000`	各 Agent 実行の Redis ストリームに保持するイベント数の上限（概算）。値を下げると、1 回の実行が使う Redis メモリを減らせる。上限に達すると、新しいイベントの書き込み時に古いイベントから削除する。削除したイベントは切断後に再生できない。
`DIFY_AGENT_STREAM_TEXT_DELTA_COALESCING_ENABLED`	`true`	モデルが連続して出力するテキスト差分をまとめて、Redis に書き込み、配信する。有効のままにすると、Redis への書き込み回数とイベント数を減らせる。差分を個別に配信するには `false` に設定する。ツール呼び出しなど、テキスト以外のイベントの内容と順序は変わらない。
`DIFY_AGENT_STREAM_TEXT_DELTA_FLUSH_INTERVAL_MS`	`100`	まとめたテキスト差分を配信する間隔の目安（ミリ秒）。値を下げるとテキストの更新頻度が上がる。上げると、1 回の配信量が増え、配信回数が減る。厳密な時間制限ではない。`DIFY_AGENT_STREAM_TEXT_DELTA_MAX_CHARS` に達すると早めに配信する。最小値は 1。結合を無効にするには `DIFY_AGENT_STREAM_TEXT_DELTA_COALESCING_ENABLED` を `false` にする。
`DIFY_AGENT_STREAM_TEXT_DELTA_MAX_CHARS`	`4096`	まとめたテキスト差分を、フラッシュ間隔を待たずに配信する文字数のしきい値。値を下げると、小さなまとまりで早めに配信できる。差分は分割せずに追加するため、文字数がこの値を超える場合がある。最小値は 1。
`DIFY_AGENT_RUN_TIMEOUT_SECONDS`	`3600`	Agent 実行 1 回のモデルとツール処理に適用される制限時間。超過した実行は `agent_run_limit_exceeded` で失敗する。旧 `AGENT_BACKEND_RUN_TIMEOUT_SECONDS` を置き換える。 API 側の `APP_MAX_EXECUTION_TIME` と `WORKFLOW_MAX_EXECUTION_TIME`（デフォルト `3600`）をこの値より低く設定すると、実行が先に停止される。 `e2b` バックエンドではサンドボックス側の `DIFY_AGENT_E2B_ACTIVE_TIMEOUT_SECONDS`（上限 3600）も適用されるため、E2B での実行は 1 時間が上限のまま。`local` バックエンドでは 1 時間を超える値も有効になる。より長い実行を許可するには、この値と API 側の 2 つの制限をすべて引き上げる。
`AGENT_BACKEND_STREAM_READ_TIMEOUT_SECONDS`	`30`	Agent バックエンドへの SSE 接続 1 本あたりの読み取りタイムアウト。
`AGENT_BACKEND_STREAM_MAX_RECONNECTS`	`3`	ストリーム切断時、実行を失敗と判定するまでに API が再接続を試みる回数。
`DIFY_AGENT_PLUGIN_DAEMON_URL`	（空。`PLUGIN_DAEMON_URL` から導出）	Agent バックエンドがツール呼び出しに使うプラグインデーモンのアドレス。
`DIFY_AGENT_PLUGIN_DAEMON_API_KEY`	（空。`PLUGIN_DAEMON_KEY` から導出）	プラグインデーモンの認証情報。
`DIFY_AGENT_OUTBOUND_HTTP_CONNECT_TIMEOUT`	`10`	Agent サービスの外向き HTTP 呼び出し（ツールやプラグインの通信など）の接続タイムアウト（秒）。
`DIFY_AGENT_OUTBOUND_HTTP_READ_TIMEOUT`	`600`	読み取りタイムアウト（秒）。遅いツール応答や大きなダウンロードが完了できるように、デフォルトは長めに設定されている。
`DIFY_AGENT_OUTBOUND_HTTP_WRITE_TIMEOUT`	`30`	外向きリクエストの書き込みタイムアウト（秒）。
`DIFY_AGENT_OUTBOUND_HTTP_POOL_TIMEOUT`	`10`	接続プールの空き接続を待つ時間（秒）。
`DIFY_AGENT_OUTBOUND_HTTP_MAX_CONNECTIONS`	`100`	Agent サービスの外向き HTTP の接続プールサイズ。
`DIFY_AGENT_OUTBOUND_HTTP_MAX_KEEPALIVE_CONNECTIONS`	`20`	再利用のために保持するアイドル接続数。
`DIFY_AGENT_OUTBOUND_HTTP_KEEPALIVE_EXPIRY`	`30`	アイドル接続を閉じるまで保持する秒数。
`DIFY_AGENT_INNER_API_URL`	（空。`PLUGIN_DIFY_INNER_API_URL` から導出）	Agent バックエンドの内部呼び出し用 Dify API アドレス。
`DIFY_AGENT_INNER_API_KEY`	（空。`PLUGIN_DIFY_INNER_API_KEY` から導出）	API サービスの `INNER_API_KEY_FOR_PLUGIN` と一致させる（`INNER_API_KEY` ではない）。
`DIFY_AGENT_LOCAL_SANDBOX_ENDPOINT`	`http://local_sandbox:5004`	同梱のサンドボックスサービスのアドレス。旧 `DIFY_AGENT_SHELLCTL_ENTRYPOINT` を置き換える。旧名も互換エイリアスとして引き続き使える。
`EXPOSE_LOCAL_SANDBOX_PORT`	`5004`	ソースコードからのデプロイで使うミドルウェアスタックが Agent サンドボックスを公開するホスト側のポート。ソースから起動した Agent バックエンドは `http://localhost:5004` でサンドボックスに到達できる。設定はそのスタックの `middleware.env` で行う。変更した場合は、Agent バックエンドの `.env` にある `DIFY_AGENT_LOCAL_SANDBOX_ENDPOINT` を新しいポートに合わせる。ミドルウェアスタック専用。フル構成の Compose スタックでは、サンドボックスは内部ネットワークに留まる。
`DIFY_AGENT_STUB_API_BASE_URL`	`http://agent_backend:5050/agent-stub`	サンドボックス内の Agent が Agent バックエンドを呼び出すためのアドレス。同梱の `local` サンドボックスではデフォルトのままにする。 `openshell` バックエンドでは、サンドボックスが Compose のサービス名を解決できない。`docker/.env` で、サンドボックスから到達でき、Agent バックエンドの `/agent-stub` パスにルーティングされるアドレスを設定する。あわせて、Agent バックエンドのポート 5050 を公開するかプロキシする。
`DIFY_AGENT_SANDBOX_FILES_BASE_URL`	`http://api:5001`	サンドボックス内の Agent がファイル転送に使う Dify API アドレス。Docker Compose ではデフォルトのまま使う。リモートサンドボックスバックエンドでは、公開されている Dify アドレスを指定する。
`AGENT_BACKEND_BINDING_FILE_DOWNLOAD_TIMEOUT_SECONDS`	`240`	API が Agent のサンドボックスからファイルを取得する際の待ち時間。超過すると転送は失敗する。Agent 側の `DIFY_AGENT_BINDING_FILE_DOWNLOAD_COMMAND_TIMEOUT_SECONDS` より高く保つこと。
`AGENT_BACKEND_HOME_SNAPSHOT_TIMEOUT_SECONDS`	`45`	home snapshot の転送を伴う Agent バックエンド呼び出し（スナップショットの取得・削除、スナップショットを復元する実行の開始）を API が待つ時間。 home 環境が大きい Agent でビルドの適用や実行開始が失敗する場合は、値を大きくしてください。
`DIFY_AGENT_BINDING_FILE_DOWNLOAD_COMMAND_TIMEOUT_SECONDS`	`210`	そのファイルを出力するサンドボックスコマンドの実行時間の上限。デフォルトは API 側のタイムアウトより低く、Agent 自身のエラーが先に表面化するようにしている。
`DIFY_AGENT_STUB_UPLOAD_FILE_SIZE_LIMIT`	`50`	サンドボックス内の Agent が Dify にアップロードする 1 ファイルの上限サイズ（MiB）。返信のために生成したファイルなどが対象。
`SHELLCTL_ENABLE_PATH_ISOLATION`	`true`	カーネルレベルの Landlock でサンドボックスが読み書きできるパスを制限する。Landlock を有効にした Linux 5.13 以降が必要。1.18.0 以降、サンドボックスは Landlock を適用できない場合にコマンドの実行をすべて拒否する。`docker/envs/core-services/local-sandbox.env` で設定する。`.env` の値はサンドボックスコンテナには渡されない。
`DIFY_AGENT_SHELL_REDACT_PATTERNS`	（空）	シェル出力を Agent が読む前にマスクする正規表現の JSON 配列。API キーなどの機密を保護する。Agent の内部トークンは常にマスクされる。
`LOGFIRE_CONSOLE`	`false`	デバッグ時に `true` にすると、Agent バックエンドが自身のリクエスト、外向き HTTP、Redis のスパンをコンテナログに出力する。トラジェクトリのエクスポートとは無関係で、そちらはこのログに何も出力しない。 1.18.0 以降、Agent 実行のスパンはこのログに表示されない。Agent の実行を追跡するには、トラジェクトリのエクスポートを使う。

DIFY_AGENT_RUNTIME_BACKEND

デフォルト値：local Agent のサンドボックスをどこで実行するかを選択します：

local：同梱のサンドボックスコンテナを使います。
e2b：Agent ごとのサンドボックスを E2B のクラウド VM で実行します。同梱コンテナより強い分離が得られます。
openshell：自社で運用する NVIDIA OpenShell ゲートウェイを使い、サンドボックスを自社のインフラ上で実行します。

この変数と 2 つのコールバックアドレス（DIFY_AGENT_STUB_API_BASE_URL と DIFY_AGENT_SANDBOX_FILES_BASE_URL）は、docker/.env で設定します。Compose はこの 3 つを docker/.env から Agent バックエンドに渡すため、envs/core-services/dify-agent.env に書いた値は反映されません。リモートバックエンドごとに、専用の変数グループがあります：

E2B

docker/docker-compose.e2b.yaml オーバーレイが、このバックエンド向けに Compose 構成を調整します。

変数	デフォルト値	説明
`DIFY_AGENT_E2B_API_KEY`	（空；`E2B_API_KEY`/`E2B_API_TOKEN` にフォールバック）	E2B アカウントキー。`e2b` バックエンドでは必須。
`DIFY_AGENT_E2B_TEMPLATE`	`difys-default-team/dify-agent-local-sandbox`	Agent が実行される E2B サンドボックステンプレート。
`EXPOSE_AGENT_BACKEND_PORT`	`15050`	`docker-compose.e2b.yaml` オーバーレイが Agent バックエンド（コンテナポート `5050`）を公開するホスト側のポート。ホスト側で 15050 が使用中の場合は別のポートに変更する。
`DIFY_AGENT_E2B_ACTIVE_TIMEOUT_SECONDS`	`3600`	1 つの E2B サンドボックスがアクティブでいられる時間。Agent の 1 回の実行全体に及ぶ。3600 が上限で、それより大きい値は拒否される。 `DIFY_AGENT_RUN_TIMEOUT_SECONDS` 以上に設定すること。サンドボックスのアクティブ時間が実行の許容時間より短いと、実行が制限時間内でもサンドボックスが先に終了してしまう。
`DIFY_AGENT_E2B_SHELLCTL_PORT`	`5004`	E2B VM 内でサンドボックス制御サービスが待ち受けるポート。

OpenShell

openshell に切り替える前に、次の準備を済ませてください：

agent_backend コンテナから到達できる OpenShell ゲートウェイ（バージョン 0.0.106 以降）を用意します。
ゲートウェイの認証情報として、Bearer トークン、mTLS クライアント証明書のペア、またはその両方を用意します。Compose には証明書のマウント設定が含まれていないため、ファイルを読み取り専用で agent_backend に自分でマウントし、UID 1001 から読み取れるようにします。
ゲートウェイがサンドボックスの起動に使うランタイムイメージを用意します。
Agent が会話をまたいで保持する永続ファイル用に、共有ボリュームを用意します。docker compose down -v で削除されないよう、Compose の外で作成します。
サンドボックスから Dify へ戻るネットワーク経路を確保します：
- サンドボックスから到達できるコールバックアドレスを用意します。
- Agent バックエンドの /agent-stub パスへのルートを用意します。ベースの Compose ファイルは、Agent バックエンドのポート 5050 を公開しません。このポートは Agent の実行を開始する API も提供しているため、リバースプロキシなどを使って /agent-stub だけを公開します。

OpenShell に切り替えるには、次の手順を実行します：

OpenShell セットアップガイドを参照して、ゲートウェイと上記の準備をすべて整えます。ガイドには、ランタイムイメージのビルド、ボリュームの初期化、証明書のマウント、Kubernetes でのセットアップ、スモークテストの手順が記載されています。
docker/.env で DIFY_AGENT_RUNTIME_BACKEND を openshell に設定し、以下の変数を入力します。
docker compose up -d で Agent バックエンドを再作成します。必須の値が欠けているか、形式が正しくない場合、Agent バックエンドは起動しません。
Agent を実行して、設定を確認します。Agent バックエンドが初めてゲートウェイに接続するのは、Agent の実行時か、Agent のビルドチャットで適用をクリックしたときです。そのため、エンドポイント、認証情報、イメージの誤りは、その時点で初めて実行や適用の失敗として表面化します。

サンドボックスは実行が終わっても、Dify が削除するまでゲートウェイ上で動き続けます。ゲートウェイの容量は、アクティブなサンドボックスだけでなく、アイドル状態のサンドボックスも見込んで計画してください。同梱サンドボックスの外向きプロキシは、OpenShell サンドボックスには適用されません。ネットワークアクセスを制限するには、DIFY_AGENT_OPENSHELL_EGRESS_ALLOW を設定してください。

変数	デフォルト値	説明
`DIFY_AGENT_OPENSHELL_GATEWAY_ENDPOINT`	（空）	`openshell` バックエンドでは必須。未設定だと Agent バックエンドは起動しない。OpenShell ゲートウェイのアドレスを、スキームなしの `host:port` 形式で指定する。 `agent_backend` コンテナ内から到達できる必要がある。Docker ホスト上のゲートウェイには `localhost` ではなく `host.docker.internal:<port>` を使い、Linux では `extra_hosts` でこの名前をホストにマッピングする。例：`gateway.example.com:17670`
`DIFY_AGENT_OPENSHELL_BEARER_TOKEN`	（空）	Agent バックエンドがゲートウェイに提示する OIDC Bearer トークン。ゲートウェイの認証方式に合わせて、このトークン、mTLS クライアント証明書のペア、またはその両方を使う。起動時に一度だけ読み込まれる。ローテーションした後は Agent バックエンドを再作成する。
`DIFY_AGENT_OPENSHELL_TLS_CA_PATH`	（空）	ゲートウェイの証明書に署名した CA 証明書の、`agent_backend` コンテナ内のパス。`DIFY_AGENT_OPENSHELL_INSECURE` が `true` の場合は無視される。
`DIFY_AGENT_OPENSHELL_TLS_CLIENT_CERT_PATH`	（空）	mTLS クライアント証明書の、`agent_backend` コンテナ内のパス。`DIFY_AGENT_OPENSHELL_TLS_CLIENT_KEY_PATH` と両方設定するか、両方空にする。片方だけ設定すると Agent バックエンドは起動しない。
`DIFY_AGENT_OPENSHELL_TLS_CLIENT_KEY_PATH`	（空）	mTLS クライアント秘密鍵の、`agent_backend` コンテナ内のパス。`DIFY_AGENT_OPENSHELL_TLS_CLIENT_CERT_PATH` と両方設定するか、両方空にする。片方だけ設定すると Agent バックエンドは起動しない。
`DIFY_AGENT_OPENSHELL_INSECURE`	`false`	TLS ではなく平文の gRPC でゲートウェイに接続し、TLS のパスは使わない。Bearer トークンを設定している場合は、この接続でも送信される。平文のゲートウェイを使うローカル開発専用。
`DIFY_AGENT_OPENSHELL_WORKSPACE`	`default`	Agent バックエンドがサンドボックスを作成・管理する OpenShell ワークスペース。ゲートウェイ上の名前空間であり、Dify のワークスペースではない。
`DIFY_AGENT_OPENSHELL_SANDBOX_IMAGE`	`docker.io/library/dify-agent-runtime:latest`	ゲートウェイが各サンドボックス用に起動するコンテナイメージ。デフォルトは、OpenShell セットアップガイドのビルドコマンドが生成するタグ。 Dify を動かす Docker デーモンだけでなく、ゲートウェイのコンピュートドライバーからも利用できる必要がある。ゲートウェイの Docker デーモンにイメージを読み込むか、ゲートウェイがプルできるレジストリにプッシュして、その参照を指定する。明示的に設定すること。どの env ファイルでも設定しない場合、Agent バックエンドは `langgenius/dify-agent-local-sandbox:latest` にフォールバックする。このイメージは古い可能性があり、その場合は OpenShell で起動できない。
`DIFY_AGENT_OPENSHELL_DRIVER_CONFIG`	（空）	`openshell` バックエンドでは必須。ゲートウェイのコンピュートドライバーがすべてのサンドボックスに適用する JSON。共有ボリュームを `DIFY_AGENT_OPENSHELL_SHARED_MOUNT_PATH` にマウントする必要がある。形式はドライバーによって異なる。 JSON が不正、または空のオブジェクトだと Agent バックエンドは起動しない。Dify はマウント自体を確認しないため、ボリュームが別のパスにマウントされていても Agent バックエンドは起動する。マウント先は必ず再確認すること。 Docker ドライバーの例：`{"docker":{"mounts":[{"type":"volume","source":"dify-agent-shared","target":"/mnt/dify-agent-shared","read_only":false}]}}`
`DIFY_AGENT_OPENSHELL_SHARED_MOUNT_PATH`	`/mnt/dify-agent-shared`	各サンドボックス内で共有ボリュームをマウントする場所。`DIFY_AGENT_OPENSHELL_DRIVER_CONFIG` のマウント先と一致させる。Agent のビルドチャットで適用をクリックするたびに、Agent の永続ファイルがここに保存される。絶対パスでなければ、Agent バックエンドは起動しない。
`DIFY_AGENT_OPENSHELL_SHELLCTL_AUTH_TOKEN`	（空）	`openshell` バックエンドでは必須。未設定だと Agent バックエンドは起動しない。Agent バックエンドが各サンドボックス内で起動するコマンドサービスに対し、自身を認証するための共有シークレット。任意のランダムな文字列を設定する。同梱サンドボックスを保護する `DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN` とは別のもの。
`DIFY_AGENT_OPENSHELL_EGRESS_ALLOW`	（空）	サンドボックスが接続できる `host:port` エンドポイントのカンマ区切りリスト。スキームやパスは付けない。空の場合はネットワークポリシーを送らず、外向き通信はゲートウェイのデフォルトに従う。設定すると、サンドボックスはリストにあるエンドポイントにしか接続できない。パッケージのインストールや Web アクセスも、そのホストをリストに入れない限り機能しなくなる。`DIFY_AGENT_STUB_API_BASE_URL` と `DIFY_AGENT_SANDBOX_FILES_BASE_URL` のホストも含めること。含めないと、Agent の実行が Dify にコールバックできない。形式が不正なエントリがあると、Agent バックエンドは起動しない。例：`agent.example.com:443,dify.example.com:443`
`DIFY_AGENT_OPENSHELL_SHELLCTL_PORT`	`5004`	各サンドボックス内でコマンドサービスが待ち受けるループバックポート。Agent バックエンドはゲートウェイ経由で到達するため、ポートを開放する必要はない。ランタイムイメージがすでに 5004 を使っている場合にのみ変更する。
`DIFY_AGENT_OPENSHELL_READY_TIMEOUT_SECONDS`	`300`	新規作成または再起動したサンドボックスが準備完了になるまで待つ時間（秒）。混雑したゲートウェイでサンドボックスの起動中に Agent の実行が失敗する場合は、値を引き上げる。
`DIFY_AGENT_OPENSHELL_EXEC_TIMEOUT_SECONDS`	`120`	Agent バックエンドがゲートウェイ経由でサンドボックス内で実行する、各セットアップコマンドの制限時間（秒）。Agent の永続ファイルのコピーやコマンドサービスの起動などが対象。Agent 自身が実行するコマンドは制限しない。永続ファイルが大きい Agent で新しいセッションを開始できない場合は、値を引き上げる。

Agent トラジェクトリのエクスポート

すでに運用しているトレーシングバックエンドで Agent の動作を確認するには、トラジェクトリのエクスポートを有効にします。有効にすると、Agent バックエンドは各 Agent 実行のトレースを OTLP/HTTP で OpenTelemetry コレクターに送信します。トレースには、モデルへのリクエストとツール呼び出しが含まれます。デプロイ内のすべてのワークスペースの実行が、1 つのコレクターに届きます。各スパンには、ワークスペース、アプリ、Agent、エンドユーザー、会話、ワークフロー実行、ノードの ID が付与されます。dify.app_id や dify.conversation.id などの属性で、トレースを 1 つのアプリや 1 つの会話に絞り込めます。これらの ID は、コンテンツのエクスポートを無効にしていてもエクスポートされます。トラジェクトリのエクスポートは、LLMOps トレース配信とは別の仕組みです。LLMOps トレース配信は、アプリ作成者がアプリごとに Langfuse などのプロバイダーで設定します。API と Worker の OpenTelemetry 計装とも別で、どちらの設定もトラジェクトリのエクスポートには影響しません。有効にするには、次の手順を実行します：

docker/.env で、DIFY_AGENT_TRAJECTORY_ENABLED を true に、DIFY_AGENT_TRAJECTORY_OTLP_TRACES_ENDPOINT をコレクターのトレース URL に設定します。認証情報が必要な場合は DIFY_AGENT_TRAJECTORY_OTLP_HEADERS に指定します。 Agent バックエンドは shared.env を読み込まないため、これらの変数を shared.env に設定しても反映されません。
docker compose up -d で Agent バックエンドを再作成します。値が不正な場合、Agent バックエンドは起動せず、修正するまで Agent の実行は失敗します。
ツールを呼び出すタスクを Agent に実行させ、トレーシングバックエンドでサービス名 dify-agent-trajectory のツール呼び出しスパンを探します。

DIFY_AGENT_TRAJECTORY_INCLUDE_CONTENT を true にすると、すべてのワークスペースのプロンプト、システムインストラクション、モデルの応答、ツールの引数と結果がコレクターに送られます。コレクターへのアクセスは、会話そのものと同じように制限してください。

変数	デフォルト値	説明
`DIFY_AGENT_TRAJECTORY_ENABLED`	`false`	トラジェクトリのエクスポートを有効にする。`DIFY_AGENT_TRAJECTORY_OTLP_TRACES_ENDPOINT` が必要で、`true` にしてエンドポイントがない場合、Agent バックエンドは起動しない。
`DIFY_AGENT_TRAJECTORY_OTLP_TRACES_ENDPOINT`	（空）	コレクターの OTLP/HTTP トレースエンドポイントの完全な URL。パスまで含め、そのまま使われる。gRPC エンドポイントには対応していない。 `http` または `https` を使い、認証情報や `#` フラグメントを含めないこと。条件を満たさないと Agent バックエンドは起動しない。認証情報は `DIFY_AGENT_TRAJECTORY_OTLP_HEADERS` に指定する。例：`https://collector.example.com/v1/traces`
`DIFY_AGENT_TRAJECTORY_OTLP_HEADERS`	`{}`	エクスポートのたびに送信するヘッダー。`{"Authorization":"Bearer <token>"}` のような JSON オブジェクトで指定する。コレクターの認証情報に使う。 `Authorization=Bearer <token>` のように JSON でない値を指定すると、Agent バックエンドは起動しない。
`DIFY_AGENT_TRAJECTORY_SERVICE_NAME`	`dify-agent-trajectory`	エクスポートするすべてのスパンに設定する `service.name`。トレーシングバックエンドでの絞り込みに使う。空にはできない。
`DIFY_AGENT_TRAJECTORY_INCLUDE_CONTENT`	`false`	`true` にすると、スパンに会話の内容（プロンプト、システムインストラクション、モデルの応答、ツールの引数と結果）を追加する。バイナリコンテンツはエクスポートされない。無効の場合、トレースには各実行のステップとタイミングが表示されるが、やり取りの内容は含まれない。Agent がなぜそう回答・行動したかを確認したいときに有効にする。ただし、コレクターがすべてのワークスペースの会話を保持してよい場合に限る。
`DIFY_AGENT_TRAJECTORY_TRACE_CONTEXT_MODE`	`isolated`	Agent のスパンと他のトレースとの関係。`isolated` は Agent 実行ごとに新しいトレースを開始する。`shared` は Agent のスパンを現在のトレースに参加させ、そのサンプリング判定に従わせる。 Agent バックエンド自身のテレメトリもこのトレーシングバックエンドに送っている場合を除き、`isolated` のままにする。これに当たるのは、Agent バックエンド自身のテレメトリ用に `LOGFIRE_TOKEN` または標準の `OTEL_EXPORTER_OTLP_*` 変数を設定している場合だけ。それ以外で `shared` にすると、ルートスパンが欠けたトレースが残ることがある。
`DIFY_AGENT_TRAJECTORY_MAX_QUEUE_SIZE`	`2048`	エクスポート待ちのスパン数の上限。高負荷時にスパンが欠落する場合は引き上げる。
`DIFY_AGENT_TRAJECTORY_MAX_EXPORT_BATCH_SIZE`	`512`	1 回のエクスポートリクエストに含めるスパン数の上限。`DIFY_AGENT_TRAJECTORY_MAX_QUEUE_SIZE` を超えると、Agent バックエンドは起動しない。
`DIFY_AGENT_TRAJECTORY_SCHEDULE_DELAY_MS`	`5000`	バッチエクスポートの間隔（ミリ秒）。
`DIFY_AGENT_TRAJECTORY_EXPORT_TIMEOUT_MS`	`5000`	1 バッチのエクスポートにかける制限時間（ミリ秒）。コレクターへの各 HTTP リクエストのタイムアウトは変わらず、5 秒に固定されている。

データベースサービス

Docker Compose でデータベースと Redis のコンテナを直接設定します。「ミドルウェアスタック」と記した行は、ソースコードからのデプロイで起動するスタックにのみ適用され、そのスタックの middleware.env で設定します。フル構成の Compose スタックでは、これらのサービスは内部ネットワークに留まります。

変数	デフォルト値	説明
`PGDATA`	`/var/lib/postgresql/data/pgdata`	コンテナ内の PostgreSQL データディレクトリ。
`MYSQL_HOST_VOLUME`	`./volumes/mysql/data`	MySQL データボリュームとしてマウントされるホストパス。
`PGDATA_HOST_VOLUME`	`./volumes/db/data`	PostgreSQL データボリュームとしてマウントされるホストパス。ミドルウェアスタック。フル構成の Compose スタックは `./volumes/db/data` を直接マウントする。
`REDIS_HOST_VOLUME`	`./volumes/redis/data`	Redis データボリュームとしてマウントされるホストパス。ミドルウェアスタック。
`EXPOSE_POSTGRES_PORT`	`5432`	ミドルウェアスタックが PostgreSQL を公開するホスト側のポート。
`EXPOSE_MYSQL_PORT`	`3306`	ミドルウェアスタックが MySQL を公開するホスト側のポート。
`EXPOSE_REDIS_PORT`	`6379`	ミドルウェアスタックが Redis を公開するホスト側のポート。

サンドボックスサービス

サンドボックスは、コードノード（Python、JavaScript、Jinja2）を実行するための隔離されたサービスです。セキュリティのためにネットワークアクセスを無効化できます。

変数	デフォルト値	説明
`SANDBOX_API_KEY`	`dify-sandbox`	サンドボックス認証用 API キー。API サービスの `CODE_EXECUTION_API_KEY` と一致する必要があります。
`SANDBOX_GIN_MODE`	`release`	サンドボックスサービスモード：`release`または `debug`。
`SANDBOX_WORKER_TIMEOUT`	`15`	単一コード実行の最大実行時間（秒）。
`SANDBOX_ENABLE_NETWORK`	`true`	コードからのアウトバウンド HTTP リクエストを許可。コードノードが外部サービスにアクセスすることを防止するには無効化してください。
`SANDBOX_HTTP_PROXY`	`http://ssrf_proxy:3128`	ネットワーク有効時の SSRF 保護用 HTTP プロキシ。
`SANDBOX_HTTPS_PROXY`	`http://ssrf_proxy:3128`	SSRF 保護用 HTTPS プロキシ。
`SANDBOX_PORT`	`8194`	サンドボックスサービスのポート。

Nginx リバースプロキシ

変数	デフォルト値	説明
`NGINX_SERVER_NAME`	`_`	Nginx サーバー名。`_` は任意のホスト名に一致します。
`NGINX_HTTPS_ENABLED`	`false`	HTTPS を有効化。`true`の場合、SSL 証明書と鍵を `./nginx/ssl/` に配置してください。
`NGINX_PORT`	`80`	HTTP ポート。
`NGINX_SSL_PORT`	`443`	HTTPS ポート（`NGINX_HTTPS_ENABLED=true` の場合のみ使用）。
`NGINX_SSL_CERT_FILENAME`	`dify.crt`	`./nginx/ssl/` 内の SSL 証明書ファイル名。
`NGINX_SSL_CERT_KEY_FILENAME`	`dify.key`	`./nginx/ssl/` 内の SSL 秘密鍵ファイル名。
`NGINX_SSL_PROTOCOLS`	`TLSv1.2 TLSv1.3`	許可される TLS プロトコルバージョン。
`NGINX_WORKER_PROCESSES`	`auto`	Nginx ワーカープロセス数。`auto` は CPU コア数に一致します。
`NGINX_CLIENT_MAX_BODY_SIZE`	`100M`	最大リクエストボディサイズ。プロキシレベルのファイルアップロード制限に影響します。
`NGINX_KEEPALIVE_TIMEOUT`	`65`	キープアライブタイムアウト（秒）。
`NGINX_PROXY_READ_TIMEOUT`	`3600s`	プロキシ読み取りタイムアウト。長時間の SSE ストリームをサポートするため高く設定（1 時間）されています。
`NGINX_PROXY_SEND_TIMEOUT`	`3600s`	プロキシ送信タイムアウト。
`NGINX_ENABLE_CERTBOT_CHALLENGE`	`false`	`/.well-known/acme-challenge/` で Let’s Encrypt ACME チャレンジリクエストを受け入れます。自動証明書更新のために有効化してください。
`NGINX_SOCKET_IO_UPSTREAM`	`api_websocket:5001`	Nginx が `/socket.io/` トラフィックを転送する上流（upstream）です。デフォルトでは `collaboration` プロファイルで起動する専用の `api_websocket` コンテナを指します。Docker Compose の外で WebSocket サービスを実行する場合のみ変更してください。

HTTPS を有効化した後、共通変数の URL 変数（例：CONSOLE_API_URL、CONSOLE_WEB_URL）も https:// を使用するように更新してください。

Certbot 設定

変数	デフォルト値	説明
`CERTBOT_EMAIL`	（空）	Let’s Encrypt の証明書通知に必要なメールアドレス。
`CERTBOT_DOMAIN`	（空）	SSL 証明書のドメイン名。
`CERTBOT_OPTIONS`	（空）	追加の certbot CLI オプション（例：`--force-renewal`、`--dry-run`）。

RESPECT_XFORWARD_HEADERS_ENABLED

デフォルト値：Docker Compose では true、ソースコードからのデプロイでは false 有効にすると、Dify は API の直前にあるプロキシが送る X-Forwarded-For ヘッダーから、各ユーザーの IP アドレスを取得します。 Docker Compose を Cloudflare やロードバランサーなどのプロキシの背後で運用する場合は、この変数を有効のままにします。そのうえで、同梱の Nginx がプロキシを信頼するよう設定してください。設定が済むまでは、すべてのユーザーがプロキシのアドレスからのアクセスとして扱われます。サインインメールの送信制限なども、そのアドレス単位で全ユーザーが共有することになります。

有効にしている間は、API に直接接続できるものであれば、Dify が認識するアドレスを自由に指定できてしまいます。偽装されたアドレスは IP 単位のレート制限をすり抜けられるうえ、アカウントの最終サインイン IP などの記録にも残ります。Docker Compose は API のポートを公開していません。ただし、同じ Docker ネットワーク上のコンテナ（コードサンドボックスなど）からは直接接続できます。Docker ネットワークを internal にしても、これらの接続は防げません。API への直接接続は、信頼できる呼び出し元だけに許可してください。これらのコンテナで信頼できないコードを実行する場合は、ネットワークやファイアウォールのルールで隔離してください。これらのコンテナから API へのリクエストがそれでも必要な場合は、すべて X-Forwarded-For を書き換えるゲートウェイを通してください。すでに API のポートを公開している場合は、この変数を無効にするのではなく、ポートを閉じてください。無効にすると、すべてのユーザーが Nginx のアドレスからのアクセスとして扱われます。

ソースコードからのデプロイでは、API の前段にプロキシが 1 つだけあり、API へのアクセスがそのプロキシ経由に限られる場合に有効にしてください。そのプロキシは X-Forwarded-For を設定している必要があります。

SSRF プロキシ

内部/プライベートネットワークへのリクエストをブロックする Squid ベースの SSRF プロキシコンテナの設定です。

変数	デフォルト値	説明
`SSRF_HTTP_PORT`	`3128`	プロキシのリッスンポート。
`EXPOSE_SSRF_PROXY_PORT`	`3128`	ソースコードからのデプロイで使うミドルウェアスタックがプロキシの `SSRF_HTTP_PORT` を公開するホスト側のポート。そのスタックの `middleware.env` で設定する。フル構成の Compose スタックではプロキシは内部ネットワークに留まる。
`EXPOSE_SANDBOX_PORT`	`8194`	ミドルウェアスタックがプロキシのサンドボックス用ポート（`SSRF_SANDBOX_PROXY_PORT`）を公開するホスト側のポート。ソースから起動したコードはプロキシ経由でサンドボックスに到達する。
`SSRF_COREDUMP_DIR`	`/var/spool/squid`	コアダンプディレクトリ。
`SSRF_SANDBOX_PROXY_PORT`	`8194`	SSRF プロキシがサンドボックスサービスへの送信トラフィックをリバースプロキシするためにリッスンするポート。
`SSRF_SANDBOX_PROXY_HOST`	`sandbox`	SSRF プロキシの転送先となるサンドボックスサービスのホスト名。
`SSRF_PROXY_ALLOW_PRIVATE_IPS`	（空）	SSRF プロキシが通過を許可するプライベート IP アドレスまたは CIDR 範囲（カンマ区切り）。対象は HTTP リクエストノード、ツール、およびセルフホストの Firecrawl または WaterCrawl サーバーを使うウェブサイトから同期。ホスト名を許可するには `SSRF_PROXY_ALLOW_PRIVATE_DOMAINS` を使う。許可した範囲内のアドレスには、どの HTTP リクエストノードやツールからも到達できるようになる。プライベートネットワーク全体ではなく、Dify が到達する必要のあるホストだけを指定すること。 `docker/.env` で設定する。`envs/infrastructure/ssrf-proxy.env` に書いた値は反映されない。例：`192.168.0.189,10.0.20.0/29`
`SSRF_PROXY_ALLOW_PRIVATE_DOMAINS`	（空）	プライベートアドレスに解決される場合でも SSRF プロキシが通過を許可するホスト名（カンマ区切り）。名前は完全一致で照合される。先頭にドットを付けると（`.corp.internal`）、サブドメインも対象になる。 `SSRF_PROXY_ALLOW_PRIVATE_IPS` と同じく対象を必要最小限に絞り、同じ方法で設定する。`docker/.env.example` にはこの変数の行がないため、自分で追加する。例：`firecrawl.internal`
`SSRF_DEFAULT_TIME_OUT`	`5`	プロキシされたリクエストのデフォルト全体タイムアウト（秒）。
`SSRF_DEFAULT_CONNECT_TIME_OUT`	`5`	デフォルト接続タイムアウト（秒）。
`SSRF_DEFAULT_READ_TIME_OUT`	`5`	デフォルト読み取りタイムアウト（秒）。
`SSRF_DEFAULT_WRITE_TIME_OUT`	`5`	デフォルト書き込みタイムアウト（秒）。

Docker Compose

変数	デフォルト値	説明
`COMPOSE_PROFILES`	`${VECTOR_STORE:-weaviate},${DB_TYPE:-postgresql},collaboration`	起動するサービスコンテナを選びます。デフォルトでは、ベクトルストア、データベース、`collaboration` プロファイルを起動します。`DB_TYPE=mysql` なら MySQL を使います。`collaboration` を削除すると、`api_websocket` コンテナを起動しません。
`EXPOSE_NGINX_PORT`	`80`	Nginx HTTP にマッピングされるホストポート。
`EXPOSE_NGINX_SSL_PORT`	`443`	Nginx HTTPS にマッピングされるホストポート。

モデルプロバイダーとツールの表示順設定

アプリインターフェースで利用可能なツールとモデルプロバイダーおよびその表示順をカスタマイズします。カンマ区切りの値を使用し、項目間にスペースを入れないでください。

変数	デフォルト値	説明
`POSITION_TOOL_PINS`	（空）	特定のツールをリストの先頭に固定。例：`bing,google`。
`POSITION_TOOL_INCLUDES`	（空）	リストされたツールのみ表示。未設定の場合、すべてのツールが利用可能です。
`POSITION_TOOL_EXCLUDES`	（空）	特定のツールを非表示（固定されたツールには影響しません）。
`POSITION_PROVIDER_PINS`	（空）	特定のモデルプロバイダーを先頭に固定。例：`openai,anthropic`。
`POSITION_PROVIDER_INCLUDES`	（空）	リストされたプロバイダーのみ表示。未設定の場合、すべてのプロバイダーが利用可能です。
`POSITION_PROVIDER_EXCLUDES`	（空）	特定のプロバイダーを非表示（固定されたプロバイダーには影響しません）。

プラグインデーモン設定

プラグインデーモンは、プラグインのライフサイクル（インストール、実行、アップグレード）を管理する独立したサービスです。API は HTTP 経由で通信します。

変数	デフォルト値	説明
`PLUGIN_DAEMON_URL`	`http://plugin_daemon:5002`	プラグインデーモンサービス URL。
`PLUGIN_DAEMON_KEY`	（自動生成）	プラグインデーモンの認証キー。
`PLUGIN_DAEMON_PORT`	`5002`	プラグインデーモンのリッスンポート。
`DB_SSL_MODE`	`disable`	プラグインデーモンが PostgreSQL に接続する際の `sslmode`。データベースが TLS を必須とする場合は `require` にする。`.env.example` には項目がない。フル構成の Compose スタックでは `docker/.env`、ミドルウェアスタックでは `middleware.env` で設定する。
`PLUGIN_DAEMON_TIMEOUT`	`600.0`	すべてのプラグインデーモンリクエスト（インストール、実行、リスト表示）のタイムアウト（秒）。
`PLUGIN_MAX_PACKAGE_SIZE`	`52428800`	プラグインパッケージの最大サイズ（バイト、50 MB）。マーケットプレイスダウンロード時に検証されます。
`PLUGIN_MAX_FILE_SIZE`	`52428800`	プラグインが Dify に返す単一ファイルの最大サイズ（バイト、50 MB）。ツールプラグインが生成した画像やドキュメントの出力などが対象です。上限を超えるファイルは「file is too large」エラーで呼び出しが失敗します。
`PLUGIN_MODEL_SCHEMA_CACHE_TTL`	`3600`	プラグインモデルスキーマのキャッシュ期間（秒）。繰り返しの参照を削減します。
`PLUGIN_MODEL_PROVIDERS_CACHE_ENABLED`	`true`	各テナントのプラグインモデルプロバイダー一覧を Redis にキャッシュするかどうか。プラグインを外部システムからインストールしていて、テナントのプラグイン変更時にこのデプロイのキャッシュを無効化できない場合は無効にします。
`PLUGIN_MODEL_PROVIDERS_CACHE_TTL`	`86400`	各テナントのプラグインモデルプロバイダー一覧を Redis にキャッシュする期間（秒）。デフォルトは 24 時間。テナントがプラグインをインストール、アンインストール、またはアップグレードすると、Dify はこのキャッシュを無効化します。
`PLUGIN_DIFY_INNER_API_KEY`	（自動生成）	プラグインデーモンが Dify API にコールバックする際に使用する API キー。プラグインデーモンサービス設定の `DIFY_INNER_API_KEY` と一致する必要があります。
`INNER_API_KEY_FOR_PLUGIN`	（env サンプルにデフォルト値あり。本番では必ず変更）	同じシークレットの API サービス側の直接名（`docker/envs/core-services/` 由来）。Compose 構成では `PLUGIN_DIFY_INNER_API_KEY` が両側に反映されます。 API はプラグインからのコールバック（モデル呼び出し、ツール呼び出し、ファイル転送）ごとにこのキーを検証します。不一致だとこれらの呼び出しは失敗しますが、プラグインのインストールは動作します。デフォルト値は Dify リポジトリで公開されており、コールバック API の唯一の認証手段のため、必ず変更してください。
`PLUGIN_DIFY_INNER_API_URL`	`http://api:5001`	プラグインデーモンがコールバックする内部 API URL。
`PLUGIN_DEBUGGING_HOST`	`0.0.0.0`	プラグインリモートデバッグ接続のホスト。
`PLUGIN_DEBUGGING_PORT`	`5003`	プラグインリモートデバッグ接続のポート。
`PLUGIN_REMOTE_INSTALL_HOST`	`localhost`	コンソールがプラグイン開発者に提示するリモートデバッグ接続先。表示専用で、デーモンの待ち受けには影響しません。開発者が到達できるホスト名を設定してください（Compose 構成では `EXPOSE_PLUGIN_DEBUGGING_HOST`）。デフォルトの `localhost` は Docker ホスト上で開発する場合のみ有効です。
`PLUGIN_REMOTE_INSTALL_PORT`	`5003`	提示されるデバッグ接続先のポート部分。デーモンが公開するデバッグポート（`EXPOSE_PLUGIN_DEBUGGING_PORT`）と一致している必要があります。Compose 構成では同じ変数から両方が設定されます。
`MARKETPLACE_ENABLED`	`true`	Dify Marketplace のプラグイン機能を有効または無効にします。無効にすると、Marketplace プラグインの閲覧・インストール画面への導線が非表示になります。API は Marketplace からのプラグインのインストールとアップグレードを拒否します。定期アップグレードチェック（`ENABLE_CHECK_UPGRADABLE_PLUGIN_TASK`）も停止します。テンプレートのインポート処理自体には影響しません。ただし、インポートしたテンプレートが未インストールの Marketplace プラグインに依存する場合があります。Marketplace が無効な間は、その依存プラグインをインストールできません。インストール済みのプラグインはそのまま動作します。インストールポリシーで許可されている場合は、GitHub やローカルパッケージからも引き続きインストールできます。
`MARKETPLACE_API_URL`	`https://marketplace.dify.ai`	プラグインとテンプレートの閲覧・ダウンロード、プラグインのアップグレード確認に使う Marketplace API エンドポイント。 Dify API サービス、バックグラウンドワーカー、Web サービス、ユーザーのブラウザでこの URL を使用します。各実行環境からアクセスできる必要があります。
`MARKETPLACE_URL`	（空。Compose 構成では `https://marketplace.dify.ai` にフォールバック）	Marketplace リンクのベース URL。プラグイン詳細ページや「統合」ページの Marketplace 入口に使用します。Dify は Creator Center のガイドリンク生成にもこの値を使用します。 `MARKETPLACE_API_URL` とは用途が異なり、後者は Marketplace のデータとパッケージを提供する API エンドポイントです。
`FORCE_VERIFYING_SIGNATURE`	`true`	プラグインインストール前に有効な署名を要求。改ざんまたは未署名のパッケージのインストールを防止します。
`PLUGIN_MAX_EXECUTION_TIMEOUT`	`600`	プラグイン実行タイムアウト（秒、プラグインデーモン側）。API 側の `PLUGIN_DAEMON_TIMEOUT` と一致させる必要があります。
`PIP_MIRROR_URL`	（空）	プラグインデーモンがプラグインの依存関係をインストールする際に使用するカスタム PyPI ミラー URL。高速インストールやエアギャップ環境に有用です。

Creator Center 設定

Creator Center（creators.dify.ai）は、Dify アプリをテンプレートとして提出する窓口です。提出されたテンプレートはレビューを経て Dify マーケットプレイスに掲載されます。Dify コンソールから Creator Center を開くと、新しいブラウザタブに表示されます。スタジオの マーケットプレイスに公開 アクションは、アプリをアプリパッケージ（.ifpkg）としてエクスポートし、Creator Center にアップロードします。ユーザーは Creator Center で提出を完了します。手順はアプリをマーケットプレイスに公開を参照してください。

変数	デフォルト値	説明
`CREATORS_PLATFORM_FEATURES_ENABLED`	`true`	アプリの「公開する」パネルにマーケットプレイスに公開アクションを表示するかどうかを制御します。`false` に設定するとアクションが非表示になり、対応するコンソール API は 403 を返します。テンプレートを外部に提出する一発経路をユーザーに提供したくないデプロイで有用です。
`CREATORS_PLATFORM_API_URL`	`https://creators.dify.ai`	Creator Center サービスのベース URL。API サービスとユーザーのブラウザの両方がこの URL を使うため、どちらからも到達できる必要があります。
`CREATORS_PLATFORM_OAUTH_CLIENT_ID`	（空）	Creator Center へのパスワードレス SSO に使用する OAuth クライアント ID。セルフホスト環境では空のままにしてください。空でも公開できますが、ログインしていないユーザーは Creator Center に手動でログインする必要があります。デプロイの OAuth サーバーに未登録の ID を設定すると、マーケットプレイスに公開が失敗します。

OTLP / OpenTelemetry 設定

OpenTelemetry は分散トレーシングとメトリクス収集を提供します。有効時、Dify は Flask を計装し、テレメトリデータを OTLP コレクターにエクスポートします。

変数	デフォルト値	説明
`ENABLE_OTEL`	`false`	OpenTelemetry 計装のマスタースイッチ。
`OTLP_TRACE_ENDPOINT`	（空）	専用トレースエンドポイント URL。未設定の場合、`{OTLP_BASE_ENDPOINT}/v1/traces` にフォールバックします。
`OTLP_METRIC_ENDPOINT`	（空）	専用メトリクスエンドポイント URL。未設定の場合、`{OTLP_BASE_ENDPOINT}/v1/metrics` にフォールバックします。
`OTLP_BASE_ENDPOINT`	`http://localhost:4318`	ベース OTLP コレクター URL。特定のトレース/メトリクスエンドポイントが設定されていない場合のフォールバックとして使用されます。
`OTLP_API_KEY`	（空）	OTLP 認証用 API キー。`Authorization: Bearer` ヘッダーとして送信されます。
`OTEL_EXPORTER_TYPE`	`otlp`	エクスポータータイプ。`otlp` はコレクターにエクスポートします。その他の値はコンソールエクスポーター（デバッグ用）を使用します。
`OTEL_EXPORTER_OTLP_PROTOCOL`	（空）	OTLP エクスポートのプロトコル。`grpc` は gRPC エクスポーターを使用します。それ以外は HTTP を使用します。
`OTEL_SAMPLING_RATE`	`0.1`	トレースするリクエストの割合（0.1 = 10%）。高トラフィックの本番環境ではオーバーヘッドを削減するために値を小さくします。
`OTEL_BATCH_EXPORT_SCHEDULE_DELAY`	`5000`	バッチエクスポート間の遅延（ミリ秒）。
`OTEL_MAX_QUEUE_SIZE`	`2048`	ドロップ前のキューに入れられる最大スパン数。
`OTEL_MAX_EXPORT_BATCH_SIZE`	`512`	エクスポートバッチごとの最大スパン数。
`OTEL_METRIC_EXPORT_INTERVAL`	`60000`	メトリクスエクスポート間隔（ミリ秒）。
`OTEL_BATCH_EXPORT_TIMEOUT`	`10000`	バッチスパンエクスポートのタイムアウト（ミリ秒）。
`OTEL_METRIC_EXPORT_TIMEOUT`	`30000`	メトリクスエクスポートのタイムアウト（ミリ秒）。

その他

変数	デフォルト値	説明
`CSP_WHITELIST`	（空）	Content Security Policy ヘッダーで許可する追加ドメイン。
`NEXT_TELEMETRY_DISABLED`	`0`	`1` にすると Next.js の匿名テレメトリを無効にする。Compose スタックではデフォルトで有効のまま。
`ALLOW_EMBED`	`false`	Dify ページの iframe 埋め込みを許可。`false`の場合、クリックジャッキングを防止するため `X-Frame-Options: DENY` を設定します。
`SWAGGER_UI_ENABLED`	`false`	`SWAGGER_UI_PATH` で Swagger UI を公開し、API ドキュメントをブラウジングできるようにします。Swagger エンドポイントは認証をバイパスします。
`SWAGGER_UI_PATH`	`/swagger-ui.html`	Swagger UI の URL パス。
`MAX_SUBMIT_COUNT`	`100`	並列ワークフローノード実行に使用されるスレッドプール内の最大同時タスク送信数。
`TENANT_ISOLATED_TASK_CONCURRENCY`	`1`	テナントごとに同時処理されるドキュメントインデックスまたは RAG パイプラインタスク数。高速なインデックス作成のために増加できますが、データベース負荷が増加します。
`DIFY_ENV_NACOS_REQUEST_TIMEOUT`	`10.0`	Nacos 設定サーバーへの HTTP リクエストのタイムアウト（秒）。
`DIFY_ENV_NACOS_CONNECT_TIMEOUT`	`3.0`	Nacos 設定サーバーへの接続確立のタイムアウト（秒）。

定期タスク設定

Dify は Celery Beat を使用して、設定可能なスケジュールでバックグラウンドメンテナンスタスクを実行します。

変数	デフォルト値	説明
`ENABLE_CLEAN_EMBEDDING_CACHE_TASK`	`false`	毎日午前 2:00 に期限切れのエンベディングキャッシュレコードをデータベースから削除します。データベースサイズを管理します。
`ENABLE_CLEAN_UNUSED_DATASETS_TASK`	`false`	保持期間内にアクティビティがなかったナレッジベースのドキュメントを無効化します。毎日午前 3:00 に実行されます。
`ENABLE_CLEAN_MESSAGES`	`false`	毎日午前 4:00 に `SANDBOX_EXPIRED_RECORDS_RETENTION_DAYS` の保持期間を超えた会話メッセージを削除します。
`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`	サーキットブレーカー：ティックごとにディスパッチされる最大スケジュール数。`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_TIMEOUT_TASK_INTERVAL`	`1`	期限切れの人間の入力フォームを確認する頻度（分）。
`ENABLE_CONVERSATION_CLEANUP_TASK`	`true`	会話削除のセーフティネット。削除された会話は即座に見えなくなり、メッセージと会話中にツールが生成したファイルはバックグラウンドジョブが削除します。エンドユーザーがアップロードしたファイルは保持されます。このタスクは、クリーンアップが実行されなかった会話を定期的に再処理し、データの残留を防ぎます。
`CONVERSATION_CLEANUP_TASK_INTERVAL`	`5`	タスクの実行頻度（分）。
`CONVERSATION_CLEANUP_BATCH_SIZE`	`100`	1 回のスイープで再処理する会話の最大数。

レコード保持とクリーンアップ

古いメッセージとワークフロー実行レコードの定期クリーンアップを制御します。保持期間を超えたレコードはバッチ単位で削除されます。

変数	デフォルト値	説明
`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 時間）。

Aliyun SLS ログストア設定

データベースの代わりにワークフロー実行ログを外部に保存するための Aliyun Simple Log Service とのオプション統合。ログストア実装を使用するようにリポジトリ設定変数を設定して有効化します。

変数	デフォルト値	説明
`ALIYUN_SLS_ACCESS_KEY_ID`	（空）	SLS 認証用 Aliyun access key ID。
`ALIYUN_SLS_ACCESS_KEY_SECRET`	（空）	SLS 認証用 Aliyun access key secret。
`ALIYUN_SLS_ENDPOINT`	（空）	SLS サービスエンドポイント URL（例：`cn-hangzhou.log.aliyuncs.com`）。
`ALIYUN_SLS_REGION`	（空）	Aliyun リージョン（例：`cn-hangzhou`）。
`ALIYUN_SLS_PROJECT_NAME`	（空）	ワークフローログ保存用 SLS プロジェクト名。
`ALIYUN_SLS_LOGSTORE_TTL`	`365`	SLS ログストアのデータ保持期間（日）。永久保存には `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 ワーカー間の Redis ベースのイベント転送です。

変数	デフォルト値	説明
`EVENT_BUS_REDIS_URL`	（空）	イベントストリーミング用 Redis 接続 URL。空の場合、メイン Redis 接続設定を使用します。
`EVENT_BUS_REDIS_CHANNEL_TYPE`	`pubsub`	トランスポートタイプ。`pubsub` は at-most-once 配信、`sharded` はシャード Pub/Sub、`streams` は Redis Streams（at-least-once 配信）です。
`EVENT_BUS_REDIS_USE_CLUSTERS`	`false`	イベントバスの Redis Cluster モードを有効化。大規模デプロイメントに推奨されます。

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

ベクトルデータベースコンテナ自体の設定です（Dify クライアント接続ではありません）。選択した VECTOR_STORE の変数のみが関連します。

Weaviate サービス

変数	デフォルト値	説明
`WEAVIATE_PERSISTENCE_DATA_PATH`	`/var/lib/weaviate`	コンテナ内のデータ永続化ディレクトリ。
`WEAVIATE_QUERY_DEFAULTS_LIMIT`	`25`	デフォルトのクエリ結果制限。
`WEAVIATE_AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED`	`true`	匿名アクセスを許可。
`WEAVIATE_DEFAULT_VECTORIZER_MODULE`	`none`	デフォルトのベクトライザーモジュール。
`WEAVIATE_CLUSTER_HOSTNAME`	`node1`	クラスターノードのホスト名。
`WEAVIATE_AUTHENTICATION_APIKEY_ENABLED`	`true`	API キー認証を有効化。
`WEAVIATE_AUTHENTICATION_APIKEY_ALLOWED_KEYS`	（自動生成）	許可される API キー。クライアント設定の `WEAVIATE_API_KEY` と一致する必要があります。
`WEAVIATE_AUTHENTICATION_APIKEY_USERS`	`hello@dify.ai`	API キーに関連付けられたユーザー。
`WEAVIATE_AUTHORIZATION_ADMINLIST_ENABLED`	`true`	管理者リスト認可を有効化。
`WEAVIATE_AUTHORIZATION_ADMINLIST_USERS`	`hello@dify.ai`	管理者ユーザー。
`WEAVIATE_DISABLE_TELEMETRY`	`false`	Weaviate テレメトリを無効化。
`WEAVIATE_ENABLE_TOKENIZER_GSE`	`false`	GSE トークナイザーを有効化（中国語）。
`WEAVIATE_ENABLE_TOKENIZER_KAGOME_JA`	`false`	Kagome トークナイザーを有効化（日本語）。
`WEAVIATE_ENABLE_TOKENIZER_KAGOME_KR`	`false`	Kagome トークナイザーを有効化（韓国語）。
`WEAVIATE_HOST_VOLUME`	`./volumes/weaviate`	Weaviate データボリュームとしてマウントされるホストパス。ミドルウェアスタック（ソースコードからのデプロイ）。そのスタックの `middleware.env` で設定する。フル構成の Compose スタックは `./volumes/weaviate` を直接マウントする。
`EXPOSE_WEAVIATE_PORT`	`8080`	ソースコードからのデプロイで使うミドルウェアスタックが Weaviate REST API を公開するホスト側のポート。ソースから起動した Dify は `http://localhost:8080` で到達できる。ホスト側で 8080 が使用中の場合は別のポートに変更し、`WEAVIATE_ENDPOINT` を新しいポートに合わせる。ミドルウェアスタック専用。フル構成の Compose スタックでは Weaviate は内部ネットワークに留まる。
`EXPOSE_WEAVIATE_GRPC_PORT`	`50051`	ミドルウェアスタックが Weaviate gRPC を公開するホスト側のポート。`grpc://localhost:50051` で到達できる。変更した場合は `WEAVIATE_GRPC_ENDPOINT` を新しいポートに合わせる。

Milvus サービス（ETCD + MinIO）

変数	デフォルト値	説明
`ETCD_AUTO_COMPACTION_MODE`	`revision`	ETCD 自動コンパクションモード。
`ETCD_AUTO_COMPACTION_RETENTION`	`1000`	リビジョン数での自動コンパクション保持。
`ETCD_QUOTA_BACKEND_BYTES`	`4294967296`	バックエンドクォータ（バイト、4 GB）。
`ETCD_SNAPSHOT_COUNT`	`50000`	スナップショットをトリガーする変更数。
`ETCD_ENDPOINTS`	`etcd:2379`	ETCD サービスエンドポイント。
`MINIO_ACCESS_KEY`	`minioadmin`	MinIO access key。
`MINIO_SECRET_KEY`	`minioadmin`	MinIO secret key。
`MINIO_ADDRESS`	`minio:9000`	MinIO サービスアドレス。
`MILVUS_AUTHORIZATION_ENABLED`	`true`	Milvus セキュリティ認可を有効化。

OpenSearch サービス

変数	デフォルト値	説明
`OPENSEARCH_DISCOVERY_TYPE`	`single-node`	クラスター形成のディスカバリタイプ。
`OPENSEARCH_BOOTSTRAP_MEMORY_LOCK`	`true`	起動時にメモリをロックしてスワッピングを防止。
`OPENSEARCH_JAVA_OPTS_MIN`	`512m`	最小 JVM ヒープサイズ。
`OPENSEARCH_JAVA_OPTS_MAX`	`1024m`	最大 JVM ヒープサイズ。
`OPENSEARCH_INITIAL_ADMIN_PASSWORD`	`Qazwsxedc!@#123`	OpenSearch サービスの初期管理者パスワード。
`OPENSEARCH_MEMLOCK_SOFT`	`-1`	ソフトメモリロック制限（`-1` は無制限）。
`OPENSEARCH_MEMLOCK_HARD`	`-1`	ハードメモリロック制限（`-1` は無制限）。
`OPENSEARCH_NOFILE_SOFT`	`65536`	ソフトファイルディスクリプタ制限。
`OPENSEARCH_NOFILE_HARD`	`65536`	ハードファイルディスクリプタ制限。

PGVector / PGVecto.RS サービス

変数	デフォルト値	説明
`PGVECTOR_PGUSER`	`postgres`	PGVector コンテナの PostgreSQL ユーザー。
`PGVECTOR_POSTGRES_PASSWORD`	（自動生成）	PGVector コンテナの PostgreSQL パスワード。
`PGVECTOR_POSTGRES_DB`	`dify`	PGVector コンテナ内のデータベース名。
`PGVECTOR_PGDATA`	`/var/lib/postgresql/data/pgdata`	コンテナ内のデータディレクトリ。
`PGVECTOR_PG_BIGM_VERSION`	`1.2-20240606`	pg_bigm 拡張のバージョン。

Oracle / Chroma / Elasticsearch サービス

変数	デフォルト値	説明
`ORACLE_PWD`	`Dify123456`	コンテナの Oracle データベースパスワード。
`ORACLE_CHARACTERSET`	`AL32UTF8`	Oracle 文字セット。
`CHROMA_SERVER_AUTHN_CREDENTIALS`	（自動生成）	Chroma サーバーコンテナの認証資格情報。
`CHROMA_SERVER_AUTHN_PROVIDER`	`chromadb.auth.token_authn.TokenAuthenticationServerProvider`	Chroma サーバーの認証プロバイダー。
`CHROMA_IS_PERSISTENT`	`TRUE`	Chroma の永続ストレージを有効化。
`KIBANA_PORT`	`5601`	Kibana ポート（Elasticsearch UI）。

IRIS / その他のサービス

変数	デフォルト値	説明
`IRIS_WEB_SERVER_PORT`	`52773`	IRIS Web サーバー管理ポート。
`IRIS_TIMEZONE`	`UTC`	IRIS コンテナのタイムゾーン。
`DB_PLUGIN_DATABASE`	`dify_plugin`	プラグインデータ用の別データベース名。

プラグインデーモンストレージ設定

プラグインデーモンは異なるストレージバックエンドにプラグインパッケージを保存できます。PLUGIN_STORAGE_TYPE に一致するプロバイダーのみを設定してください。

変数	デフォルト値	説明
`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_PPROF_ENABLED`	`false`	プラグインデーモンの Go pprof プロファイリングを有効化。
`PLUGIN_PYTHON_ENV_INIT_TIMEOUT`	`120`	プラグインの Python 環境初期化のタイムアウト（秒）。
`PLUGIN_STDIO_BUFFER_SIZE`	`1024`	プラグイン stdio 通信のバッファサイズ（バイト）。
`PLUGIN_STDIO_MAX_BUFFER_SIZE`	`5242880`	プラグイン stdio 通信の最大バッファサイズ（バイト、5 MB）。
`ENDPOINT_URL_TEMPLATE`	`http://localhost/e/{hook_id}`	プラグインエンドポイントの URL テンプレート。`{hook_id}` は実際のフック ID に置き換えられます。
`EXPOSE_PLUGIN_DAEMON_PORT`	`5002`	プラグインデーモンにマッピングされるホストポート。
`EXPOSE_PLUGIN_DEBUGGING_HOST`	`localhost`	プラグインリモートデバッグのホスト。
`EXPOSE_PLUGIN_DEBUGGING_PORT`	`5003`	プラグインリモートデバッグのホストポート。

プラグイン S3 ストレージ

変数	デフォルト値	説明
`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`	仮想ホスト型の代わりにパス型 URL を使用。
`PLUGIN_AWS_ACCESS_KEY`	（空）	AWS access key。
`PLUGIN_AWS_SECRET_KEY`	（空）	AWS secret key。
`PLUGIN_AWS_REGION`	（空）	AWS リージョン。

プラグイン Azure Blob ストレージ

変数	デフォルト値	説明
`PLUGIN_AZURE_BLOB_STORAGE_CONTAINER_NAME`	（空）	Azure Blob コンテナ名。
`PLUGIN_AZURE_BLOB_STORAGE_CONNECTION_STRING`	（空）	Azure Blob 接続文字列。

プラグイン Tencent COS ストレージ

変数	デフォルト値	説明
`PLUGIN_TENCENT_COS_SECRET_KEY`	（空）	Tencent COS secret key。
`PLUGIN_TENCENT_COS_SECRET_ID`	（空）	Tencent COS secret ID。
`PLUGIN_TENCENT_COS_REGION`	（空）	Tencent COS リージョン。

プラグイン Aliyun OSS ストレージ

変数	デフォルト値	説明
`PLUGIN_ALIYUN_OSS_REGION`	（空）	Aliyun OSS リージョン。
`PLUGIN_ALIYUN_OSS_ENDPOINT`	（空）	Aliyun OSS エンドポイント。
`PLUGIN_ALIYUN_OSS_ACCESS_KEY_ID`	（空）	Aliyun OSS access key ID。
`PLUGIN_ALIYUN_OSS_ACCESS_KEY_SECRET`	（空）	Aliyun OSS access key secret。
`PLUGIN_ALIYUN_OSS_AUTH_VERSION`	`v4`	Aliyun OSS 認証バージョン。
`PLUGIN_ALIYUN_OSS_PATH`	（空）	Aliyun OSS パスプレフィックス。

プラグイン Volcengine TOS ストレージ

変数	デフォルト値	説明
`PLUGIN_VOLCENGINE_TOS_ENDPOINT`	（空）	Volcengine TOS エンドポイント。
`PLUGIN_VOLCENGINE_TOS_ACCESS_KEY`	（空）	Volcengine TOS access key。
`PLUGIN_VOLCENGINE_TOS_SECRET_KEY`	（空）	Volcengine TOS secret key。
`PLUGIN_VOLCENGINE_TOS_REGION`	（空）	Volcengine TOS リージョン。

最終更新日 2026年10月23日

​共通変数

​CONSOLE_API_URL

​SERVER_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

​ENABLE_COLLABORATION_MODE

​システムエンコーディング

​サーバー設定

​ログ

​一般

​SECRET_KEY

​PASSWORD_PEPPER

​KEY_PROVIDER_TYPE

​INIT_PASSWORD

​トークンとリクエスト制限

​コンテナ起動設定

​MODE

​API ツール設定

​データベース設定

​コネクションプール

​PostgreSQL パフォーマンスチューニング

​MySQL パフォーマンスチューニング

​Redis 設定

​Redis SSL 設定

​Redis Sentinel モード

​Redis Cluster モード

​Redis 接続の堅牢性設定

​Celery 設定

​CELERY_BROKER_URL

​CORS 設定

​Dify CLI とプログラマティック API

​ファイルストレージ設定

​STORAGE_TYPE

​アーカイブストレージ

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

​VECTOR_STORE

​ナレッジベース設定

​アノテーションインポート

​モデル設定

​マルチモーダル設定

​Sentry 設定

​Notion 連携設定

​メール設定

​その他の設定

​コンソール機能

​認証とアカウント

​LLMOps トレース配信

​インデックス作成

​新規ユーザーのデフォルト設定

​ワークフロー生成

​トークンと招待

​コード実行サンドボックス

​コードとテンプレートの出力制限

​ワークフローランタイム

​ワークフローストレージリポジトリ

​ワークフローログクリーンアップ

​HTTP リクエストノード

​Webhook

​SSRF 保護

​エージェント設定

​Web フロントエンドサービス

​NEXT_PUBLIC_ENABLE_FEATURE_PREVIEW

​新しい Agent

​DIFY_AGENT_SERVER_SECRET_KEY

​DIFY_AGENT_API_TOKEN

​DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN

​NEXT_PUBLIC_ENABLE_AGENT_V2

​UPLOAD_SKILL_FILE_SIZE_LIMIT

​Agent とアプリのパッケージ制限

​AGENT_BACKEND_BASE_URL

​DIFY_AGENT_RUNTIME_BACKEND

​Agent トラジェクトリのエクスポート

​データベースサービス

​サンドボックスサービス

共通変数

CONSOLE_API_URL

SERVER_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

ENABLE_COLLABORATION_MODE

システムエンコーディング

サーバー設定

ログ

一般

SECRET_KEY

PASSWORD_PEPPER

KEY_PROVIDER_TYPE

INIT_PASSWORD

トークンとリクエスト制限

コンテナ起動設定

MODE

API ツール設定

データベース設定

コネクションプール

PostgreSQL パフォーマンスチューニング

MySQL パフォーマンスチューニング

Redis 設定

Redis SSL 設定

Redis Sentinel モード

Redis Cluster モード

Redis 接続の堅牢性設定

Celery 設定

CELERY_BROKER_URL

CORS 設定

Dify CLI とプログラマティック API

ファイルストレージ設定

STORAGE_TYPE

アーカイブストレージ

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

VECTOR_STORE

ナレッジベース設定

アノテーションインポート

モデル設定

マルチモーダル設定

Sentry 設定

Notion 連携設定

メール設定

その他の設定

コンソール機能

認証とアカウント

LLMOps トレース配信

インデックス作成

新規ユーザーのデフォルト設定

ワークフロー生成

トークンと招待

コード実行サンドボックス

コードとテンプレートの出力制限

ワークフローランタイム

ワークフローストレージリポジトリ

ワークフローログクリーンアップ

HTTP リクエストノード

Webhook

SSRF 保護

エージェント設定

Web フロントエンドサービス

NEXT_PUBLIC_ENABLE_FEATURE_PREVIEW

新しい Agent

DIFY_AGENT_SERVER_SECRET_KEY

DIFY_AGENT_API_TOKEN

DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN

NEXT_PUBLIC_ENABLE_AGENT_V2

UPLOAD_SKILL_FILE_SIZE_LIMIT

Agent とアプリのパッケージ制限

AGENT_BACKEND_BASE_URL

DIFY_AGENT_RUNTIME_BACKEND

Agent トラジェクトリのエクスポート

データベースサービス

サンドボックスサービス