設定変更 (1.13.0)

状態: draft / バージョン: 1.13.0 (2026-02-11)

TL;DR

PUBSUB_REDIS_URL (必須): API と Celery ワーカー間の PubSub 通信に使用される Redis URL を指定します。空の場合、標準の REDIS_* 設定がデフォルトになります。
PUBSUB_REDIS_CHANNEL_TYPE (必須): ストリーミングイベント用のチャネルタイプを定義します。オプションは pubsub (デフォルト) または sharded です。高スループット環境では sharded の使用を強く推奨します。
PUBSUB_REDIS_USE_CLUSTERS (必須): PubSub 用の Redis クラスターモードを有効にするには true に設定します。sharded PubSub と組み合わせることで、これは水平スケーリングに不可欠です。
WEB_FORM_SUBMIT_RATE_LIMIT_MAX_ATTEMPTS: レート制限ウィンドウ内でIPアドレスごとに許可されるWebフォーム送信の最大数 (デフォルト: 30)。

(執筆予定: この機能が解決する課題と運用上のインパクトを書く)

アーキテクチャの変更をサポートするため、いくつかの新しい環境変数を導入しました。大規模なデプロイメントでは、スケーラビリティを確保するためにPubSub Redisの設定に特に注意を払う必要があります。

PUBSUB_REDIS_URL (重要): API と Celery ワーカー間の PubSub 通信に使用される Redis URL を指定します。空の場合、標準の REDIS_* 設定がデフォルトとして適用されます。
PUBSUB_REDIS_CHANNEL_TYPE (重要): ストリーミングイベント用のチャネルタイプを定義します。オプションは pubsub (デフォルト) または sharded です。高スループット環境では sharded の使用を強く推奨します。
PUBSUB_REDIS_USE_CLUSTERS (重要): PubSub 用の Redis クラスターモードを有効にするには true に設定します。sharded PubSub と組み合わせることで、これは水平スケーリングに不可欠です。

その他の追加項目:

WEB_FORM_SUBMIT_RATE_LIMIT_MAX_ATTEMPTS: レート制限ウィンドウ内で IP ごとに許可される Web フォーム送信の最大数 (デフォルト: 30)。
WEB_FORM_SUBMIT_RATE_LIMIT_WINDOW_SECONDS: Web フォーム送信のレート制限用の秒単位の時間ウィンドウ (デフォルト: 60)。
HUMAN_INPUT_GLOBAL_TIMEOUT_SECONDS: Workflow の実行が、グローバルタイムアウトになる前に人間の入力を待って一時停止できる最大秒数 (デフォルト: 604800、7 日間)。
ENABLE_HUMAN_INPUT_TIMEOUT_TASK: 期限切れの人間入力リクエストをチェックするバックグラウンドタスクを有効にします (デフォルト: true)。
HUMAN_INPUT_TIMEOUT_TASK_INTERVAL: タイムアウトチェックタスクの間隔 (分単位) を設定します (デフォルト: 1)。
ENABLE_API_TOKEN_LAST_USED_UPDATE_TASK: API トークンの last_used_at タイムスタンプを一括更新する定期的なバックグラウンドタスクを有効にします (デフォルト: true)。
API_TOKEN_LAST_USED_UPDATE_INTERVAL: API トークンの last_used_at タイムスタンプを一括更新するための間隔 (分単位) を設定します (デフォルト: 30)。
SANDBOX_EXPIRED_RECORDS_CLEAN_BATCH_MAX_INTERVAL: DB 負荷の急増を軽減するため、保持クリーンアップバッチ間の最大ランダム遅延 (ミリ秒単位) (デフォルト: 200)。

(執筆予定)

(執筆予定 — 上記抜粋を整理)

(執筆予定)

(執筆予定)

(執筆予定)

ソース:
- GitHub Release 1.13.0

本記事は非公式まとめです。正式仕様は Dify 公式ドキュメントをご確認ください。