OmniRoute/docs/i18n/ja/docs/reference/FEATURE_FLAGS.md

Feature Flags (日本語)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

再デプロイなしで OmniRoute の動作を変更するランタイムトグル。 ここに記載されているすべてのフラグは、 src/shared/constants/featureFlagDefinitions.ts で定義されています。 このファイルが唯一の信頼できる情報源です。ダッシュボードと REST API はどちらも このファイルを参照するため、以下の表は内容が 1:1 で一致するように生成されています。

---

機能フラグとは

機能フラグは、実行時に値を変更してデータベースに永続化できる、名前付きのトグル（boolean または enum）です。プロセスを再デプロイする必要はありません。各フラグは、key、label、 description、category、defaultValue、type、および requiresRestart ヒントを持つ FeatureFlagDefinition によって記述されます。

解決順序

フラグの実効値は、 resolveFeatureFlag() によって、以下の優先順位で解決されます（上位が優先されます）。

1. DB オーバーライド — feature_flags 名前空間の key_value テーブルに保存されている値（ダッシュボードまたは REST API 経由で設定）。
2. 環境変数 — 設定されていて空でない場合の process.env[<KEY>]。
3. 定義のデフォルト値 — featureFlagDefinitions.ts の defaultValue。

boolean フラグは、実効値が "true"、"1"、または "yes" の場合に有効とみなされます（isFeatureFlagEnabled() を参照）。

Note

ほとんどのフラグには、ENVIRONMENT.md に記載されている、同じ名前の対応する環境変数もあります。フラグの DB オーバーライドは、その環境変数よりも優先されます。 requiresRestart: true のフラグはすぐに永続化されますが、プロセス起動時にのみ再読み込みされます。このフラグを切り替えると、ダッシュボードに **「サーバーを再起動」**バナーが表示されます。

---

フラグ一覧

6 カテゴリ、全 72 フラグ。デフォルトは定義上のデフォルト値、つまり DB オーバーライドも環境変数も存在しない場合に使用される値です。

セキュリティ（10）

キー	型	デフォルト	説明
REQUIRE_API_KEY	boolean	false	すべての受信リクエストに API キーを必須とします。
INPUT_SANITIZER_ENABLED	boolean	true	すべてのリクエストに対する入力サニタイズを有効にします。
INJECTION_GUARD_MODE	enum	off	プロンプトインジェクションのガードモード。値：off、warn、block、redact。
PII_REDACTION_ENABLED	boolean	false	リクエストから PII を編集します（INPUT_SANITIZER_MODE とは独立）。
PII_RESPONSE_SANITIZATION	boolean	false	プロバイダーのレスポンスから PII をサニタイズします。
PII_RESPONSE_SANITIZATION_MODE	enum	redact	PII レスポンスのサニタイズモード。値：redact、warn、block、off。
OUTBOUND_SSRF_GUARD_ENABLED	boolean	true	プライベート／内部 IP 範囲への送信リクエストをブロックします。
ALLOW_API_KEY_REVEAL	boolean	false	認証済みのダッシュボードユーザーが、マスクされた値だけでなく、保存済みの API キーを表示できるようにします。
AUTH_LOG_INCLUDE_ACCOUNT_ID	boolean	false	AUTH ログ行にアカウントのプレフィックスを含めます（例：「 アカウントを使用中：abc12345...」）。共有／マルチテナントのプロセスログからアカウント識別子を編集するため、デフォルトでは無効です。デバッグモードとは独立しており、デバッグモードを切り替えてもこの情報は表示されません。
OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN	boolean	false	OIDC が有効な場合、パスワードログインを無効にし、ユーザーが OIDC シングルサインオン経由でのみ認証できるようにします。無効な場合（デフォルト）、パスワードログインと OIDC の両方を利用できます。

ネットワーク（15）

キー	型	デフォルト	再起動	説明
ENABLE_TLS_FINGERPRINT	boolean	false	✓	TLS フィンガープリントのステルスモードを有効にします。
AUDIO_REMOTE_PROVIDER_NODES	boolean	false		/v1/audio/* ルートが、localhost 外部でホストされている OpenAI 互換プロバイダーノードを使用できるようにします。デフォルトでは無効です。音声をリモートホストにルーティングすると送信元 ID が変わるため、オペレーターが明示的に決定する必要があります。ループバックノードは常に許可され、この設定の影響を受けません。
PROXY_AUTO_SELECT_ENABLED	boolean	false		接続にプロキシが割り当てられていない場合、レジストリから最初に利用可能なプロキシを自動選択します。デフォルトでは無効です（有効にすると、レジストリ内のあらゆるプロキシがグローバルフォールバックになるためです — #3332）。
OMNIROUTE_CONTROL_PLANE_PROXY_DIRECT_FALLBACK	boolean	false		プロキシ到達性の事前チェックに失敗した場合、OAuth およびプロバイダー検証フローが固定プロキシをバイパスして直接接続することを許可します。送信元 IP が変わる可能性があるため、デフォルトでは無効です。
NETWORK_ROTATION_SHARED_EGRESS_GUARD	boolean	true		複数アカウントのローテーションエグゼキューターでネットワーク例外（タイムアウト、接続拒否／リセット）が発生し、失敗したアカウントに専用プロキシがない場合、各アカウントを再試行する代わりに短時間のクールダウンを適用し、リクエストの残りの処理ではプロキシなしの他のアカウントをスキップします。デフォルトでは有効です（安全性：送信元 IP は変わらず、共有送信元アカウントにおけるレイテンシー／クールダウンのリスクのみを軽減します）。無効にすると、最初のプロキシなしの例外発生時に即座に伝播する動作に戻ります。
PROXY_SKIP_RECENTLY_FAILED	boolean	false		プロキシプールおよび opencode のアカウント単位のローテーションで、直前に失敗したプロキシ（TCP プローブが拒否された、またはそのプロキシ経由で 429 を受信したもの）の再提供を、プロセス単位で一定期間停止します。この期間は失敗を繰り返すたびに倍増し、上限まで延長されます。プロキシのステータスは書き込まれません。すべての候補が保留された場合、選択は変更されません。デフォルトでは無効です。
PROXY_POOL_EGRESS_OBSERVATION	boolean	false		ダッシュボードのプロキシプール配下に、過去 24 時間にそのメンバーで使用された、観測済みの送信元 IP 数と、それらを使用した接続数を表示します。読み取り専用で、プロキシログから計算され、ルーティングには使用されません。デフォルトでは無効です。
OPENCODE_RESPONSES_STALL_ROTATION	boolean	false		OpenCode エグゼキューターで、ストリーミングされた Responses 応答の最初のボディバイトを監視します（監視時間：RESPONSES_FIRST_BYTE_TIMEOUT_MS、デフォルト：15000）。2xx の Responses ストリームが監視時間を超えて無応答のままである場合、ストールとして扱います。そのアカウントをクールダウンし、リクエストを次のアカウントへ 1 回だけローテーションします。2 回目のストールでは即座に失敗します。デフォルトでは無効であり、ストールしたストリームは現在と同様に、ストリーム準備タイムアウトまで待機し続けます。
OPENCODE_USER_BLOCKED_ROTATION	boolean	false		OpenCode エグゼキューター：user_blocked 拒否を含む 403/451（地域制限でも Cloudflare のフィンガープリント拒否でもないもの）が発生した場合、拒否されたアカウントをクールダウンし、リクエストごとに最大 1 回、次のアカウントへローテーションします。2 回目の拒否は成功マークを付けず、そのまま返されます。デフォルトでは無効です。上流側のユーザーブロックを回避するルーティングは、回避行為と見なされ、フリート全体にフラグが広がる可能性があるためです。
OPENCODE_TRANSIENT_FAILOVER_BACKOFF	boolean	false		OpenCode ローテーション: 一時的なアップストリーム障害（5xx または空の 400）が 2 回連続して発生した場合、次のアカウントへ移る前に待機します。待機時間は 1.5 秒から始まり、障害が続くたびに倍増しますが、1 回の待機につき最大 6 秒、1 リクエストにつき合計最大 10 秒に制限されます。クライアントが切断した場合は待機をスキップし、待機前に失敗したレスポンスボディを解放します。デフォルトではオフで、フェイルオーバーは即時に実行されます。
OPENCODE_RATE_LIMITED_429_EARLY_STOP	boolean	false		OpenCode ローテーション: 実際のレート制限として分類された最初の 429（解析可能な Retry-After がある、または本文にレート制限や使用量制限が明記されている場合）でアカウントの処理を停止し、そのアップストリームの 429 を変更せずに返します。分類されない 429 の場合はローテーションを継続します。デフォルトではオフです。無料枠は送信元 IP ごとに制限されるため（#9611）、すべての 429 でローテーションし、すべてのアカウントを試し終えた場合は最後のアップストリーム 429 を返します。
MITM_DISABLE_TLS_VERIFY	boolean	false	✓	MITM プロキシの TLS 証明書検証を無効にします。危険です。
OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS	boolean	false		プライベート／内部ネットワークを指すプロバイダー URL を許可します。
OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS	boolean	true		ローカル／プライベートアドレス（127.0.0.1、localhost、LAN）上のプロバイダーの追加／検証を許可します。デフォルトでオンです（ローカル優先）。公開アドレスのみを厳格に許可する場合は無効にしてください。クラウドメタデータへのアクセスは引き続きブロックされます。
ENABLE_CC_COMPATIBLE_PROVIDER	boolean	false	✓	Claude Code 互換プロバイダーモードを有効にします。

ポリシー（5）

キー	型	デフォルト	説明
TOOL_POLICY_MODE	enum	disabled	ツール使用ポリシーの適用モードです。値: disabled、warn、block。
RATE_LIMIT_AUTO_ENABLE	boolean	false	使用パターンに基づいてレート制限を自動的に有効にします。
DISABLE_CONTEXT_WINDOW_CHECKS	boolean	false	単一モデルへの直接リクエストに対する OmniRoute のローカルなコンテキストウィンドウ／最大入力トークンのチェックをスキップします。アップストリームの制限は引き続き適用されます。
CAPABILITY_FILTER_ENABLED	boolean	false	対象モデルに必要な機能（ビジョン、ツール、構造化出力、コンテキストウィンドウ）がない場合、ディスパッチ前にリクエストを拒否します。コンボレイヤーの互換性フィルターを経由しない、単一プロバイダーへの直接リクエストを保護します。
RADAR_ENABLED	boolean	false	OmniRoute Radar モジュール（カタログフィード画面と同期）を有効にします。デフォルトではオフです。有効にしても UI が使用可能になるだけで、データ同期には別途オプトインが必要です。

ランタイム（32）

キー	型	デフォルト	再起動	説明
UNIVERSAL_CONTEXT_HANDOFF_ENABLED	boolean	true		コンボルーティングでモデルが切り替わる際に、会話の要約を生成して挿入します。無効にすると、モデルの切り替えが個別に扱われ、既存および今後のすべてのコンボに対するバックグラウンドの引き継ぎリクエストが抑止されます。
RESPONSES_PASSTHROUGH_DROP_COMMENTARY	boolean	true		Responses API のパススルーストリームから内部の commentary フェーズの出力項目を削除してからクライアントへ転送します。無効にすると、未加工のアップストリーム commentary を受信します。
OMNIROUTE_MCP_ENFORCE_SCOPES	boolean	true		MCP ツールへのアクセスにスコープ制限を適用します。
OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS	boolean	false		MCP ツールの説明を圧縮して、トークン使用量を削減します。
OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS	boolean	false		ランタイムでバックグラウンドタスク処理を有効にします。
OMNIROUTE_DISABLE_BACKGROUND_SERVICES	boolean	false	✓	すべてのバックグラウンドサービス（クォータ更新、同期など）を無効にします。
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS	boolean	false		プロジェクトレベルの RTK フィルターを検証なしで信頼します。
OMNIROUTE_ENABLE_LIVE_WS	boolean	true	✓	インポート時にリアルタイムダッシュボードの WebSocket サーバーを起動します（デフォルトではポート 20132）。
OMNIROUTE_CODEX_WS_ENABLED	boolean	true		Codex が Responses-over-WebSocket トランスポートを使用できるようにします。オフの場合、Codex は HTTP Responses にフォールバックします。
OMNIROUTE_CODEX_APP_SERVER_ENABLED	boolean	true		Codex がローカル app-server WebSocket JSON-RPC トランスポート（codexTransport=app-server）を使用できるようにします。オフの場合、app-server の使用を選択した接続は Codex の他のトランスポートにフォールバックします。
OMNIROUTE_EMERGENCY_FALLBACK	boolean	true		予算を使い切ったリクエストを、緊急用の無料フォールバックプロバイダー／モデルにルーティングします。（以下の緊急予算フォールバックを参照してください。）
STREAM_RECOVERY_ENABLED	boolean	false		レスポンスのバイトがクライアントに到達する前に切断されたアップストリーム SSE ストリームに対して、透過的な早期再試行を有効にします。
STREAM_RECOVERY_MIDSTREAM_ENABLED	boolean	false		バイトがすでにクライアントに到達した後でも、レスポンスを再リクエストして連結するストリーム復旧を許可します。
STREAM_RECOVERY_TOOLCALL_ORDER_FIX	boolean	false		ストリーム途中の継続をツール呼び出しに対して安全にします。ツール呼び出しが発行された場合（実行中、または finish_reason tool_calls ですでに完了済み）は、切断されたストリームを再開せず、予算をすべて消費する代わりに、空の継続が 1 回発生した時点で終了します。オフの場合はリリース時の動作になります。
STREAM_EARLY_EOF_SIBLING_FAILOVER_ENABLED	boolean	false		SSE ストリームが有用なフレームを一切送信せずに終了し、制限付きの同一接続再試行を使い切った場合、兄弟接続へ 1 回フェイルオーバーします。使用可能な兄弟接続がない場合は、元の STREAM_EARLY_EOF 502 が返されます。デフォルトではオフです。同一接続での再試行後も早期 EOF は終端エラーとして扱われます。
MODEL_CATALOG_INCLUDE_NAMES	boolean	true		/v1/models レスポンスに表示用の名前フィールドを含めます。モデル ID のみを想定するクライアントでは無効にしてください。
MODELS_CATALOG_PREFIX_MODE	enum	dual		/v1/models でモデル ID に付けるプレフィックスを制御します。'dual'（デフォルト）は、後方互換性のため、エイリアスと正規プロバイダー ID の両方のプレフィックスを出力します。'alias' は短いエイリアスプレフィックスのみを出力します（例：deepseek-web/model ではなく ds-web/model）。'canonical' は完全なプロバイダー ID プレフィックスのみを出力します。値：dual、alias、canonical。
ARENA_ELO_SYNC_ENABLED	boolean	true		モデルの知能ランキングのために、Arena AI リーダーボードの ELO を定期的に同期します。
EXPOSE_CC_DISCOVERY_ALIASES	boolean	false		/v1/models で claude/<provider>/<model> ミラー ID を公開し、Claude Code ゲートウェイのモデル検出で Claude 以外のモデルも一覧表示されるようにします。3 段階ゲートのグローバルレベルです（環境変数がダッシュボードのオーバーライドより優先されます）。Claude Code の設定を参照してください。
NO_THINKING_ALIAS_ENABLED	boolean	true		no-think// ゲートウェイエイリアスのマスタースイッチです。オン（デフォルト）の場合、/v1/models は対象となる思考対応 Claude モデルごとに思考なしのバリアントを公開し、リクエストで送信された no-think/ ID は、推論を抑制した状態で実際のモデルに解決されます。オフの場合、バリアントは公開されず、no-think/ ID は他の不明なモデル ID と同様に扱われます。オンの場合でも、モデルごとの ModelSpec.noThinkingAlias によるオプトイン／オプトアウトが適用されます。
OMNIROUTE_DISABLE_THINKING_LEVEL_VARIANTS	boolean	false		/v1/models カタログで、思考レベルのバリアント（例: -low、-medium、-high）を生成しないようにします。
OMNIROUTE_CHAT_VIRTUAL_LANES	boolean	false	✓	プロバイダーへのディスパッチで、テナントごとの適応型仮想アドミッションレーンを有効にします（#9654）。これにより、あるテナントのバーストが原因で別のテナントに 503 が返されることがなくなります。OMNIROUTE_CHAT_VIRTUAL_LANES 環境変数は、このダッシュボードのオーバーライドより優先されます。変更はサーバーの再起動時に有効になります。
EXPOSE_FUNCTIONAL_GATEWAY_MIRRORS	boolean	false		正規の所有者に有効な認証情報がなくても、有効な認証情報を持つパススルーゲートウェイによってルーティングされるモデルについて、/v1/models で / ミラー ID を公開します。警告: グローバルに有効にすると、すべてのクライアントにカタログエントリが追加されます。
NEWAPI_AGGREGATOR_BALANCE	boolean	false		New-API / One-API / Sub2API アグリゲーター互換ノードの残高検出を有効にします。有効にすると、アグリゲーターフラグが設定された互換ノードは、ダッシュボードとクォータ事前チェックのルーティングで残高を報告します。
SERVER_OWNED_TOOL_LOOP_ENABLED	boolean	false		モデルがクライアントで使用可能なレスポンスを返すまで、サーバー管理の非ストリーミングツール呼び出しを継続します。
SEARCH_STATS_HIDE_DELETED_CONNECTIONS	boolean	false		検索統計と最近の検索では、現在も有効な接続を持つプロバイダーのみをカウントします（duckduckgo-free のようなキー不要のプロバイダーは常にカウントされます）。オフの場合、プロバイダー ID を持つ保持済みの検索行がすべて維持されます。
FREE_BADGE_REQUIRES_PROVIDER_FREE_TIER	boolean	false		ダッシュボードのプロバイダーページ: プロバイダーが正式にサポートするシグナルに対してのみ Free バッジを表示します。文書化された無料枠がない登録済みプロバイダーについては、表示名による推測、boolean 以外の free フィールド、および :free サフィックスを判定対象から除外します。オフの場合、従来のバッジルールが維持されます。
RETRY_AFTER_PROVENANCE_ENABLED	boolean	false		集約された 429/503 利用不可レスポンスで、具体的な将来の再試行時刻が不明な場合、合成された 1 秒の値を使用する代わりに Retry-After を省略し、error.retry_after_provenance（signal | none）を追加します。また、コンボのドレインパスで、JSON およびプレーンテキストのアップストリーム本文に記載された再試行のヒントを読み取れるようにします。このフィールドは unavailableResponse() によって構築されたレスポンスにのみ表示されます。その他の 429/503 の本文は変更されません。
PROTECTED_PRIORITY_INFRA_502_ENABLED	boolean	false		fallback-only-on-quota-exhaustion としてマークされた priority コンボターゲットが、クォータ以外であることが明らかな原因（プロバイダーのサーキットブレーカーが開いている、予測レイテンシによるスキップ）でコンボを停止した場合、クォータ超過のように見える 503 ではなく 502 を返します。ロックアウト、クールダウン、利用不可、枯渇、および同時実行数上限による停止では、引き続き 503 を返します。
MISTRAL_AMBIGUOUS_401_SOFT_LOCKOUT	boolean	false		単純な Mistral 401（{"detail":"Unauthorized"}、明示的な認証シグナルなし）は、キーが失効している場合とクォータを使い切った場合とで同一です。有効にすると、接続を expired として停止する代わりにクールダウンさせます。これは接続ごとに1時間あたり最大3回までで、次の発生時には停止されるため、失効したキーも最終的には停止状態に収束します。デフォルトでは無効です。無効の場合、単純な Mistral 401 が発生するたびに、従来どおり接続を停止します。
XAI_OAUTH_LIVE_MODEL_DISCOVERY	boolean	false		固定された静的シードの代わりに、OAuth ベアラートークンを使用して https://api.x.ai/v1/models から xai-oauth 接続用の最新の xAI モデルカタログを取得します。デフォルトでは無効です。無効の場合、xai-oauth は静的シードを変更せずに引き続き提供します。解決エラーが発生した場合、ディスカバリーはシードにフォールバックします（このエンドポイントで x.ai が OAuth ベアラートークンを受け付けるかどうかは未確認です）。
BATCH_AND_FILE_AUTO_CLEANUP_ENABLED	boolean	false		自動クリーンアップ処理により、OMNIROUTE_BATCH_RETENTION_DAYS より古い終端状態（completed/failed/cancelled/expired）の Batch API ジョブを行ごとのチェックポイントとともに削除し、独自の expires_at を過ぎたアップロード済みファイルの BLOB コンテンツを消去できるようにします。デフォルトでは無効です。オペレーターが明示的に有効化するまで、既存のすべてのインストール環境ではこのデータが従来どおり保持されます。オペレーターが実行する DELETE /api/v1/batches/delete-completed ルートは、どちらの設定でも影響を受けません。これは独立した無条件の公開 API コントラクトです。

CLI（5）

キー	型	デフォルト	再起動	説明
CLI_COMPAT_ALL	boolean	false	✓	すべての CLI クライアントで互換モードを有効にします。
MODEL_ALIAS_COMPAT_ENABLED	boolean	false		モデルエイリアス互換レイヤーを有効にします。
PRICING_SYNC_ENABLED	boolean	false		料金データの自動同期を有効にします（PRICING_SYNC_ENABLED 環境変数も必要です）。
OMNIROUTE_AUTO_SYNC_CODEX_PROFILES	boolean	false		プロバイダーモデルの同期後、最新のカタログから ~/.codex/*.config.toml プロファイルファイルを自動的に（再）書き込みします。アクティブ／デフォルトの Codex 設定は変更しません。デフォルトでは無効です。
OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES	boolean	false		プロバイダーモデルの同期後、最新のカタログから ~/.claude/profiles//settings.json Claude Code プロファイルを自動的に（再）書き込みします。アクティブ／デフォルトの Claude 設定は変更しません。デフォルトでは無効です。

ヘルス（5）

キー	型	デフォルト	説明
OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK	boolean	false	ローカルインスタンスのヘルスチェックエンドポイントを無効にします。
OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK	boolean	false	トークン検証のヘルスチェックを無効にします。
SKILLS_SANDBOX_NETWORK_ENABLED	boolean	false	スキルサンドボックス環境でのネットワークアクセスを有効にします。
PROXY_HEALTH_BLOCKED_RESETS_STREAK	boolean	false	プロキシのヘルススイープで、ターゲットが拒否したプローブ（401/403/429）によって、プロキシの連続失敗回数をリセットします。デフォルトではオフです。拒否は中立のままです（#10654）。5xx はどちらの場合も未確定のままであり、拒否によってプロキシが削除、無効化、再有効化されることはありません。
DB_HEALTHCHECK_STARTUP_DEFERRED_ENABLED	boolean	false	起動完了までブロックする代わりに、サーバーがリクエストの受け付けを開始した後（setImmediate 経由）に、起動時の DB 整合性／ヘルスチェックを実行します（#13717）。デフォルトではオフです。起動はこの PR より前とまったく同じようにブロックされます。

Note

INPUT_SANITIZER_BLOCK_THRESHOLD とその従来のエイリアスである INJECTION_GUARD_BLOCK_THRESHOLD は、INJECTION_GUARD_MODE の block モードを調整しますが、これらは src/shared/utils/injectionSeverity.ts によって読み取られる通常の環境変数であり、機能フラグではありません。DB によるオーバーライドも、 ダッシュボードの切り替えもありません。詳しくは ENVIRONMENT.md を参照してください。

Note

再起動 列は、requiresRestart: true のフラグを示します。値は即座に 永続化されますが、プロセスの再読み込み後にのみ有効になります。列挙型の フラグでは、許可された値の集合に含まれない値は拒否されます（ setFeatureFlagOverride() と REST の PUT ハンドラーの両方で サーバー側の検証が行われます）。

---

フラグの切り替え

ダッシュボード

ダッシュボード → 設定 → 機能フラグ (/dashboard/settings/feature-flags) に移動します。グリッド (src/app/(dashboard)/dashboard/settings/components/FeatureFlagsGrid.tsx) では、以下の操作がサポートされています。

• キーまたは説明による検索と、カテゴリによるフィルタリング（加えて、合成された 再起動が必要ビュー）。
• boolean フラグ用のトグルと enum フラグ用のドロップダウン (src/app/(dashboard)/dashboard/settings/components/FeatureFlagCard.tsx)。
• 各フラグのソースバッジ — DB、ENV、または DEF —。有効値の 取得元を示します。
• オーバーライドを削除するためのリセットボタン（ソースが DB のフラグにのみ表示）と、 下部にあるすべてのオーバーライドをリセットボタン。
• requiresRestart フラグが変更されたときに表示されるサーバーを再起動バナー。

REST API

すべての操作は単一のルートを介して実行されます。 src/app/api/settings/feature-flags/route.ts。 すべてのメソッドで認証済みのダッシュボードセッションが必要です（認証されていない場合は 401）。

GET /api/settings/feature-flags

すべてのフラグについて、有効値、ソース、および概要を返します。

{
  "flags": [
    {
      "key": "REQUIRE_API_KEY",
      "label": "Require API Key",
      "description": "Require an API key for all incoming requests",
      "category": "security",
      "type": "boolean",
      "enumValues": null,
      "defaultValue": "false",
      "effectiveValue": "false",
      "source": "default", // "db" | "env" | "default"
      "requiresRestart": false,
      "warningLevel": "caution",
    },
    // ... 全72個のフラグ
  ],
  "summary": {
    "total": 56,
    "active": 0,
    "inactive": 0,
    "overriddenByDb": 0,
    "overriddenByEnv": 0,
  },
}

PUT /api/settings/feature-flags

単一のオーバーライドを設定または削除します。本文: { key: string; value?: string }。 value を省略すると、オーバーライドが削除されます（env / デフォルトに復元）。

# DB オーバーライドを設定
curl -X PUT http://localhost:20128/api/settings/feature-flags \
  -H "Content-Type: application/json" \
  -d '{"key":"REQUIRE_API_KEY","value":"true"}'

# オーバーライドを削除（"value" なし）
curl -X PUT http://localhost:20128/api/settings/feature-flags \
  -H "Content-Type: application/json" \
  -d '{"key":"REQUIRE_API_KEY"}'

レスポンスには、新しい effectiveValue/source、previousValue/ previousSource、および requiresRestart がそのまま含まれます。不明なキーや範囲外の enum 値は 400 で拒否されます。

DELETE /api/settings/feature-flags

すべての DB オーバーライドを一度にクリアし、各フラグを env / デフォルト値に 復元します。{ cleared: <count>, message: "..." } を返します。

Note

requiresRestart: true のフラグは、プロセスを再読み込みした後にのみ反映されます。 ダッシュボードの再起動フローは POST /api/restart を呼び出した後、サーバーが復旧するまで GET /api/health/ping をポーリングします。

---

緊急予算フォールバック

OMNIROUTE_EMERGENCY_FALLBACK（カテゴリ runtime、デフォルト true）は、 open-sse/services/emergencyFallback.ts の緊急無料フォールバック経路を制御します。有効な場合、予算を使い果たしたリクエストは 即座に失敗する代わりに、無料のフォールバックプロバイダー/モデルにルーティングされます。 この動作を無効にし、予算を使い果たしたリクエストを失敗させるには、ダッシュボードのトグル、 DB オーバーライド、または OMNIROUTE_EMERGENCY_FALLBACK 環境変数を使用して、 false（または 0）に設定します。（PR #3741 / #3752 でダッシュボードのトグルとして公開。）

---

関連項目

• 環境変数リファレンス — ほとんどのフラグには、同名の環境変数が記載されています（DB のオーバーライドが優先されます）。
• src/shared/constants/featureFlagDefinitions.ts — すべてのフラグの信頼できる唯一の情報源です。
• src/shared/utils/featureFlags.ts — 解決ロジック（resolveFeatureFlag、isFeatureFlagEnabled、resolveAllFeatureFlags）。
• src/lib/db/featureFlags.ts — key_value テーブルの feature_flags 名前空間における DB オーバーライドの永続化処理。