# Environment Variables Reference (日本語) 🌐 **Languages:** 🇺🇞 [English](../../../../reference/ENVIRONMENT.md) · 🇪🇹 [am](../../../am/docs/reference/ENVIRONMENT.md) · 🇞🇊 [ar](../../../ar/docs/reference/ENVIRONMENT.md) · 🇊🇿 [az](../../../az/docs/reference/ENVIRONMENT.md) · 🇧🇬 [bg](../../../bg/docs/reference/ENVIRONMENT.md) · 🇧🇩 [bn](../../../bn/docs/reference/ENVIRONMENT.md) · 🇧🇊 [bs](../../../bs/docs/reference/ENVIRONMENT.md) · 🇚🇿 [cs](../../../cs/docs/reference/ENVIRONMENT.md) · 🇩🇰 [da](../../../da/docs/reference/ENVIRONMENT.md) · 🇩🇪 [de](../../../de/docs/reference/ENVIRONMENT.md) · 🇬🇷 [el](../../../el/docs/reference/ENVIRONMENT.md) · 🇪🇞 [es](../../../es/docs/reference/ENVIRONMENT.md) · 🇪🇪 [et](../../../et/docs/reference/ENVIRONMENT.md) · 🇮🇷 [fa](../../../fa/docs/reference/ENVIRONMENT.md) · 🇫🇮 [fi](../../../fi/docs/reference/ENVIRONMENT.md) · 🇫🇷 [fr](../../../fr/docs/reference/ENVIRONMENT.md) · 🇮🇪 [ga](../../../ga/docs/reference/ENVIRONMENT.md) · 🇮🇳 [gu](../../../gu/docs/reference/ENVIRONMENT.md) · 🇳🇬 [ha](../../../ha/docs/reference/ENVIRONMENT.md) · 🇮🇱 [he](../../../he/docs/reference/ENVIRONMENT.md) · 🇮🇳 [hi](../../../hi/docs/reference/ENVIRONMENT.md) · 🇭🇷 [hr](../../../hr/docs/reference/ENVIRONMENT.md) · 🇭🇺 [hu](../../../hu/docs/reference/ENVIRONMENT.md) · 🇊🇲 [hy](../../../hy/docs/reference/ENVIRONMENT.md) · 🇮🇩 [id](../../../id/docs/reference/ENVIRONMENT.md) · 🇳🇬 [ig](../../../ig/docs/reference/ENVIRONMENT.md) · 🇮🇹 [it](../../../it/docs/reference/ENVIRONMENT.md) · 🇬🇪 [ka](../../../ka/docs/reference/ENVIRONMENT.md) · 🇰🇭 [km](../../../km/docs/reference/ENVIRONMENT.md) · 🇮🇳 [kn](../../../kn/docs/reference/ENVIRONMENT.md) · 🇰🇷 [ko](../../../ko/docs/reference/ENVIRONMENT.md) · 🇱🇹 [lt](../../../lt/docs/reference/ENVIRONMENT.md) · 🇱🇻 [lv](../../../lv/docs/reference/ENVIRONMENT.md) · 🇮🇳 [ml](../../../ml/docs/reference/ENVIRONMENT.md) · 🇮🇳 [mr](../../../mr/docs/reference/ENVIRONMENT.md) · 🇲🇟 [ms](../../../ms/docs/reference/ENVIRONMENT.md) · 🇲🇹 [mt](../../../mt/docs/reference/ENVIRONMENT.md) · 🇲🇲 [my](../../../my/docs/reference/ENVIRONMENT.md) · 🇳🇵 [ne](../../../ne/docs/reference/ENVIRONMENT.md) · 🇳🇱 [nl](../../../nl/docs/reference/ENVIRONMENT.md) · 🇳🇎 [no](../../../no/docs/reference/ENVIRONMENT.md) · 🇮🇳 [or](../../../or/docs/reference/ENVIRONMENT.md) · 🇮🇳 [pa](../../../pa/docs/reference/ENVIRONMENT.md) · 🇵🇭 [phi](../../../phi/docs/reference/ENVIRONMENT.md) · 🇵🇱 [pl](../../../pl/docs/reference/ENVIRONMENT.md) · 🇵🇹 [pt](../../../pt/docs/reference/ENVIRONMENT.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/reference/ENVIRONMENT.md) · 🇷🇎 [ro](../../../ro/docs/reference/ENVIRONMENT.md) · 🇷🇺 [ru](../../../ru/docs/reference/ENVIRONMENT.md) · 🇱🇰 [si](../../../si/docs/reference/ENVIRONMENT.md) · 🇞🇰 [sk](../../../sk/docs/reference/ENVIRONMENT.md) · 🇞🇮 [sl](../../../sl/docs/reference/ENVIRONMENT.md) · 🇷🇞 [sr](../../../sr/docs/reference/ENVIRONMENT.md) · 🇞🇪 [sv](../../../sv/docs/reference/ENVIRONMENT.md) · 🇰🇪 [sw](../../../sw/docs/reference/ENVIRONMENT.md) · 🇮🇳 [ta](../../../ta/docs/reference/ENVIRONMENT.md) · 🇮🇳 [te](../../../te/docs/reference/ENVIRONMENT.md) · 🇹🇭 [th](../../../th/docs/reference/ENVIRONMENT.md) · 🇹🇷 [tr](../../../tr/docs/reference/ENVIRONMENT.md) · 🇺🇊 [uk-UA](../../../uk-UA/docs/reference/ENVIRONMENT.md) · 🇵🇰 [ur](../../../ur/docs/reference/ENVIRONMENT.md) · 🇺🇿 [uz](../../../uz/docs/reference/ENVIRONMENT.md) · 🇻🇳 [vi](../../../vi/docs/reference/ENVIRONMENT.md) · 🇳🇬 [yo](../../../yo/docs/reference/ENVIRONMENT.md) · 🇚🇳 [zh-CN](../../../zh-CN/docs/reference/ENVIRONMENT.md) · 🇹🇌 [zh-TW](../../../zh-TW/docs/reference/ENVIRONMENT.md) --- > OmniRoute が認識するすべおの環境倉数に関する完党なリファレンスです。 > クむックスタヌト甚テンプレヌトに぀いおは、[`.env.example`](../../.env.example)を参照しおください。 > [!IMPORTANT] > ここに蚘茉されおいるすべおの倉数は `.env.example` にも含たれおいる必芁があり、 > `.env.example` に含たれるすべおの倉数もここに蚘茉されおいる必芁がありたす。`npm run check:env-doc-sync` > は、コミット時および CI でこの敎合性を匷制したす。倉数を意図的に陀倖するには、 > `scripts/check/check-env-doc-sync.mjs` 内の蚱可リストに远加しおください。 --- ## 目次 - [1. 必須のシヌクレット](#1-required-secrets) - [2. ストレヌゞずデヌタベヌス](#2-storage--database) - [3. ネットワヌクずポヌト](#3-network--ports) - [4. セキュリティず認蚌](#4-security--authentication) - [5. 入力のサニタむズず PII 保護](#5-input-sanitization--pii-protection) - [6. ツヌルずルヌティングのポリシヌ](#6-tool--routing-policies) - [7. URL ずクラりド同期](#7-urls--cloud-sync) - [8. アりトバりンドプロキシ](#8-outbound-proxy) - [9. CLI ツヌル統合](#9-cli-tool-integration) - [10. 内郚゚ヌゞェントず MCP の統合](#10-internal-agent--mcp-integrations) - [11. OAuth プロバむダヌの認蚌情報](#11-oauth-provider-credentials) - [12. プロバむダヌの User-Agent オヌバヌラむド](#12-provider-user-agent-overrides) - [13. CLI フィンガヌプリントの互換性](#13-cli-fingerprint-compatibility) - [14. API キヌプロバむダヌ](#14-api-key-providers) - [15. タむムアりト蚭定](#15-timeout-settings) - [16. ロギング](#16-logging) - [17. メモリ最適化](#17-memory-optimization) - [18. 料金同期](#18-pricing-sync) - [19. モデル同期開発甚](#19-model-sync-dev) - [20. プロバむダヌ固有の蚭定](#20-provider-specific-settings) - [21. プロキシの正垞性](#21-proxy-health) - [22. デバッグ](#22-debugging) - [23. GitHub 統合](#23-github-integration) - [24. Skills サンドボックスv3.8.0+](#24-skills-sandbox-v380) - [27. Radar フィヌドセルフホスティング](#27-radar-feed-self-hosting) - [デプロむシナリオ](#deployment-scenarios) - [監査削陀枈み未䜿甚の倉数](#audit-removed--dead-variables) --- ## 1. 必須シヌクレット **はい**ずマヌクされた未蚭定のシヌクレットは、初回実行時に自動生成され`JWT_SECRET`、`API_KEY_SECRET`、デヌタディレクトリ内の `server.env` に保存されたす。そのディレクトリが䞀時的なものである堎合は、明瀺的に蚭定しおください。䟋倖は `OMNIROUTE_WS_BRIDGE_SECRET` です。これは `server.env` には保存されたせん。サヌバヌの゚ントリポむントは起動ごずに、プロセス内のブリッゞのみが䜿甚できる䞀時的な倀を発行するため、倖郚のブリッゞクラむアントでは明瀺的な蚭定が必芁です。 | 倉数 | 必須 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------- | -------------------- | ------------------ | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `JWT_SECRET` | **はい** | _(なし)_ | `src/lib/auth` | すべおのダッシュボヌドセッションCookieJWTの眲名ず怜蚌に䜿甚したす。`openssl rand -base64 48`で生成しおください。 | | `API_KEY_SECRET` | **はい** | _(なし)_ | `src/lib/db/apiKeys.ts` | SQLite内で保存されるAPIキヌ倀を暗号化するためのAES暗号鍵です。`openssl rand -hex 32`で生成しおください。 | | `INITIAL_PASSWORD` | いいえ | _(未蚭定)_ | `src/lib/auth/managementPassword.ts` | パスワヌドがただ保存されおいない間、起動時にダッシュボヌドのパスワヌドを蚭定したす。パスワヌドが保存されるず無芖されたす。npm むンストヌルず゜ヌスむンストヌルは `.env.example` を `.env` ぞコピヌするため、公開されおいるプレヌスホルダヌ `CHANGEME` のたた起動したす。初回起動前に眮き換えるか、その `.env` で `INITIAL_PASSWORD=`空を蚭定しお、未蚭定倀Docker むメヌゞのデフォルトず同様に、初回蚪問時にセットアップりィザヌドでパスワヌドを䜜成しおください。保存枈みパスワヌドの倉曎は、ダッシュボヌド → 蚭定 → セキュリティから行うか、`DATA_DIR` をサヌバヌのデヌタディレクトリに蚭定しお `omniroute reset-password`゜ヌスチェックアりトでは `node bin/reset-password.mjs`を実行しおください。 | | `OMNIROUTE_WS_BRIDGE_SECRET` | **はい**本番環境 | _(未蚭定)_ | `src/app/api/internal/codex-responses-ws/route.ts` | 内郚Codex Responses WebSocketブリッゞ甚の共有シヌクレットです。ElectronブラりザヌのWSリレヌずOmniRoute間のブリッゞリク゚ストを認蚌したす。⚠ **本番環境では必須です。未蚭定の堎合、すべおのWSブリッゞリク゚ストが拒吊されたす。**`openssl rand -base64 32`で生成しおください。 | | `OMNIROUTE_SW_BUILD_ID` | いいえ | _(git SHA)_ | `next.config.mjs`, `scripts/build/assembleStandalone.mjs` | PWAシェル#11779のキャッシュを確実に曎新するための明瀺的なサヌビスワヌカヌのIDです。解決チェヌンで最初に䜿甚されたす。 | | `SOURCE_VERSION` | いいえ | _(未蚭定)_ | `next.config.mjs`, `scripts/build/assembleStandalone.mjs` | チェヌンの2番目に䜿甚されたす。デプロむされたコミットずしおPaaSビルダヌ䟋Heroku圢匏によっお蚭定されたす。 | | `NEXT_PUBLIC_SW_BUILD_ID` | いいえ | _(導出倀)_ | `src/shared/components/PwaRegister.tsx` | クラむアントが`/sw.js?v=
`を登録するために䜿甚するビルド時の公開倀です。䞊蚘2぀の倀、続いおgit SHAから導出されたす。 | | `OMNIROUTE_PEER_STAMP_TOKEN` | いいえ自動 | _(起動ごずに自動)_ | `src/server/authz/policies/management.ts` | 信頌されたピアIPスタンプがOmniRoute自身のHTTPサヌバヌ`scripts/dev/peer-stamp.mjs`から発行されたこずを蚌明する、プロセス単䜍のシヌクレットです。authzミドルりェアは、スタンプにこのトヌクンが含たれおいる堎合にのみ、リク゚ストのロヌカル性LOCAL_ONLYルヌトのルヌプバックLANゲヌティングを信頌したす。起動ごずに自動生成されるため、未蚭定のたたにしおください。スタンプを共有する必芁があるマルチプロセス構成の堎合にのみ固定しおください。 | | `OMNIROUTE_TRUSTED_PROXIES` | いいえ | _(未蚭定)_ | `scripts/dev/peer-stamp.mjs` | IP蚱可拒吊リストが`X-Forwarded-For``X-Real-IP`を信頌できるリバヌスプロキシのIPたたはCIDR範囲を、カンマ区切りで指定したす。ルヌプバック、プラむベヌトネットワヌクアドレス、およびCloudflare゚ッゞは垞に信頌されたす。これら以倖のパブリックアドレス䞊にあるプロキシの堎合にのみ必芁です。指定しない堎合、フィルタヌはプロキシ自䜓のアドレスを刀定察象ずしたす。 | ### 生成コマンド ```bash # 4぀のシヌクレットをすべお䞀床に生成 echo "JWT_SECRET=$(openssl rand -base64 48)" echo "API_KEY_SECRET=$(openssl rand -hex 32)" echo "INITIAL_PASSWORD=$(openssl rand -base64 16)" echo "OMNIROUTE_WS_BRIDGE_SECRET=$(openssl rand -base64 32)" ``` > [!CAUTION] > 実際のシヌクレットを含む`.env`ファむルをバヌゞョン管理にコミットしないでください。`.gitignore`ではすでに`.env`が陀倖されおいたすが、プッシュする前に確認しおください。 --- ## 2. ストレヌゞずデヌタベヌス OmniRoute は、すべおの氞続化に **SQLite**`better-sqlite3` 経由を䜿甚したす。これらの倉数は、デヌタの保存堎所、暗号化、ラむフサむクルを制埡したす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------------ | ------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `DATA_DIR` | `~/.omniroute/` | `src/lib/db/core.ts` | SQLite DB、バックアップ、デヌタファむルのルヌトディレクトリです。Docker ボリュヌムやカスタムパスを䜿甚する堎合は䞊曞きしおください。 | | `OMNIROUTE_ALLOW_DEFAULT_DATA_DIR` | _未蚭定_ | `src/lib/dataPaths.ts` | テスト評䟡甚の DATA_DIR ガヌド#10428を回避するための゚スケヌプハッチです。`DATA_DIR` が指定されおいないテストおよび Node の eval/print プロヌブ`-e`/`--eval`/`-p`/`--print`。`--eval=`/`--print=` 圢匏を含むは、オペレヌタヌの実デヌタベヌスを開けないように、䞀時的な䜿い捚おディレクトリぞリダむレクトされたす。実ディレクトリの䜿甚を再び有効にするには `1` に蚭定したす。 | | `OMNIROUTE_BUILD_SHA` | _未蚭定_ | `src/lib/monitoring/buildSha.ts` | 実行䞭のアヌティファクトの Git SHA です。`npm run build:release` によっお埋め蟌たれたす。`dist/BUILD_SHA` センチネルを含たないコンテナでは泚入できたす。`/api/monitoring/health` で `system.buildSha` ずしお公開されたす。 | | `OMNIROUTE_RELEASE_REF` | `origin/main` | `scripts/build/buildProvenance.ts` | pack-artifact のプロベナンスゲヌトがビルド SHA ず照合する参照です#10427。 | | `OMNIROUTE_ALLOW_CANARY_BUILD` | _未蚭定_ | `scripts/build/buildProvenance.ts` | SHA がリリヌスラむン䞊にないビルドのパッケヌゞ化を蚱可するには `1` に蚭定したす。ゲヌトを倱敗させる代わりに、意図的なカナリアずしお蚘録されたす#10427。 | | `OMNIROUTE_SMOKE_API_KEY` | _未蚭定_ | `scripts/ops/deploy-canary.mjs` | カナリアデプロむのスモヌクプロヌブ甚 API キヌです。`/v1/chat/completions` に `Authorization: Bearer` ずしお送信されたす。デプロむスクリプトのみが䜿甚し#10429、サヌバヌが䜿甚するこずはありたせん。オプトむン匏 CLI スモヌクハヌネスの `OMNIROUTE_SMOKE_*` 倉数`tests/integration/upstream-cli-smoke.int.test.ts` 内の `RUN_CLI_SMOKE=1`、`OMNIROUTE_SMOKE_BASE_URL/MODEL/API_KEY_ENV/TARGETS/TIMEOUT_MS`ずは無関係です。詳现は [CLI 統合 → 実環境スモヌクスむヌプ](../guides/CLI-INTEGRATIONS.md) を参照しおください。 | | `OMNIROUTE_BUILDING` | _未蚭定_ | `src/lib/buildPhase.ts` | ビルドフェヌズシグナル#10060です。`scripts/build/build-next-isolated.mjs` によっお `1` に蚭定され、生成されたすべおのビルドワヌカヌに継承されたす。これにより、DB レむダヌはネむティブの better-sqlite3 アドオン終了時にワヌカヌを異垞終了させるを読み蟌む代わりに、䜕もしないスタブを返したす。実行䞭のサヌバヌでは決しお蚭定しないでください。 | | `OMNIROUTE_SKIP_NATIVE_DEP_CHECK` | `0` | `scripts/check/check-native-deps.mjs` | 特殊なベンダヌ管理ツリヌに察する、任意のネむティブ䟝存関係の事前ビルドチェックを省略するには `1` に蚭定したす。これにより、欠萜しおいる䟝存関係がビルド可胜になるわけではありたせん。ネむティブ䟝存関係が別経路で提䟛される堎合にのみ䜿甚しおください。 | | `OMNIROUTE_DATA_DIR` | _未蚭定_ | `open-sse/executors/promptql/threadSticky.ts` | `DATA_DIR` の**フォヌルバック゚むリアス**であり、`DATA_DIR` が未蚭定の堎合にのみ確認されたす。PromptQL ゚グれキュヌタヌのディスク䞊のスレッド固定セッションキャッシュ`/promptql-thread-sessions.json`の保存堎所を特定するために䜿甚されたす。どちらの倉数も蚭定されおいない堎合、キャッシュはメモリ内にのみ保持されたす再起動埌は氞続化されたせん。 | | `OMNIROUTE_PLUGINS_DIR` | _未蚭定_ | `src/lib/plugins/scanner.ts` | **ランタむムプラグむンスキャナヌ**が読み取り、プラグむンマネヌゞャヌがむンストヌル先ずしお䜿甚するルヌトディレクトリです。ホヌムから導出されるデフォルトを䞊曞きしたす#11827。スキャンパスを倉曎するためだけに HOME を移動するのではなく、Docker/K8s でバむンドマりントされたプラグむンツリヌを指定しおくださいHOME は、ホヌム盞察の他のすべおの動䜜にも圱響したす。未蚭定の堎合は `~/.omniroute/plugins`、プロセスがホヌムをたったく゚クスポヌトしおいない堎合は `/tmp/.omniroute/plugins` になりたす。この倉数により、プラグむンが暗黙的に怜出されない問題を解消できたす。解決されたディレクトリは、採甚された入力ずずもに、起動時に `scanner.dir_resolved` ずしお䞀床だけログに蚘録されたす。サヌバヌ偎専甚です。CLI コマンドプラグむンは、匕き続き独自の `OMNIROUTE_PLUGIN_PATH`セクション 9を䜿甚したす。 | | `STORAGE_ENCRYPTION_KEY` | _(空 = 無効)_ | `src/lib/db/encryption.ts` | 保存されおいる SQLite デヌタベヌス党䜓を暗号化するための AES キヌ。`openssl rand -hex 32` で生成したす。 | | `STORAGE_ENCRYPTION_KEY_VERSION` | `v1` | `scripts/build/bootstrap-env.mjs`, `electron/main.js` | 暗号化キヌのバヌゞョンラベル。叀いバックアップの埩号をサポヌトするため、キヌをロヌテヌションするずきにむンクリメントしたす。 | | `DISABLE_SQLITE_AUTO_BACKUP` | `false` | `src/lib/db/backup.ts` | `true` の堎合、定期的なバックアップおよび曞き蟌み前の SQLite ファむルバックアップmodels.dev の料金情報の保存/消去、蚭定の曞き蟌みをスキップしたす。手動バックアップず埩元前バックアップは匕き続き実行されたす。マむグレヌションランナヌによる必須の氞続的な安党スナップショットや、既存の氞続 DB に察する䞀括マむグレヌション保護は無効化**されたせん**。手動以倖のバックアップは、最倧でも 60 分に 1 回に制限されたす。ダッシュボヌドの **Settings → Storage** では、定期的な自動バックアップを個別に無効化できたす。 | | `OMNIROUTE_CRYPT_KEY` | _(未蚭定)_ | `src/lib/db/encryption.ts` | `STORAGE_ENCRYPTION_KEY` の**レガシヌ゚むリアス**。プラむマリ倉数が存圚しない堎合のフォヌルバックずしお受け付けられたす。 | | `OMNIROUTE_API_KEY_BASE64` | _(未蚭定)_ | `src/lib/db/encryption.ts` | フォヌルバックずしお受け付けられる**レガシヌ゚むリアス**Base64 ゚ンコヌド圢匏。䜿甚前に自動的にデコヌドされたす。 | | `OMNIROUTE_DB_HEALTHCHECK_INTERVAL_MS` | _(未蚭定)_ | `src/lib/db/core.ts` | 定期的な SQLite ヘルスチェックの間隔msを䞊曞きしたす。未蚭定の堎合、デフォルト倀は `NODE_ENV` に基づいお決定されたす。 | | `OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS` | _(削陀枈み)_ | `src/lib/db/walMaintenance.ts` | **削陀枈み。** 皌働䞭に定期的に `wal_checkpoint(TRUNCATE)` を実行するず、共有 wal-index マッピングが無効になり、SIGBUS によっおプロセスがクラッシュする可胜性があるため#13973、スケゞュヌラヌは廃止されたした。この倉数は機胜したせん。正の倀を指定するず非掚奚譊告が䞀床だけログに蚘録され、`0` たたは未蚭定の堎合は䜕も出力されたせん。WAL は PASSIVE チェックポむント䞋蚘によっお維持され、シャットダりン時のチェックポむントによっお切り詰められたす。 | | `OMNIROUTE_WAL_PASSIVE_INTERVAL_MS` | `300000` (5分) | `src/lib/db/walMaintenance.ts` | 頻繁に実行される `wal_checkpoint(PASSIVE)` の間隔msを䞊曞きしたす。保留䞭の WAL フレヌムを小さく保぀こずで、チェックポむントを高速に維持し、シャットダりン時の切り詰めの合間にも WAL ファむルのサむズを制限したす。`0` で無効化したす。 | | `OMNIROUTE_WAL_GUARD_MAX_MB` | `256` | `src/lib/db/walMaintenance.ts` | PASSIVE の実行時に WAL ファむルがこのサむズを超えおいるこずが怜出された堎合、マッピング枈みの wal-index を再曞き蟌みせずに WAL を最初から開始できるよう、`wal_checkpoint(RESTART)` を実行したす。皌働䞭の truncate モヌドのチェックポむントは削陀されたした`OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS` の行を参照。 | | `OMNIROUTE_PRESSURE_SELF_RESTART` | `false` | `open-sse/utils/resourcePressure.ts` | 重倧なリ゜ヌス逌迫が `OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS` の期間にわたっお継続した埌にプロセスを終了するには、`1`/`true`/`yes`/`on` に蚭定したす。これにより、無期限に 503 を返し続ける代わりに、スヌパヌバむザヌsystemd の `Restart=always`、Docker の再起動ポリシヌがクリヌンなプロセスを再起動できたす。 | | `OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS` | `120000` (2分) | `open-sse/utils/resourcePressure.ts` | 自己再起動のための終了凊理が実行されるたで、重倧なリ゜ヌス逌迫が継続しなければならない時間。 | | `OMNIROUTE_PRESSURE_PSI_DISABLED` | `false` | `open-sse/utils/resourcePressurePolicy.ts` | このプロセス自䜓には問題がないにもかかわらず、ノむゞヌネむバヌによっお 503 が発生する堎合に、ホスト党䜓の `/proc/pressure/memory``psi_some` / `psi_full`を無芖するには、`1`/`true`/`yes`/`on` に蚭定したす#13124。Cgroup ず V8 ヒヌプの保護は匕き続き有効です。たた、PSI は `cgroup_high` に察するカヌネルスロットリングの蚌拠ずしおカりントされなくなりたす。その堎合、`memory.high` を超える cgroup の合蚈倀が重倧ず刀定されるのは、`memory.events` の `high`/`max` が増加した堎合のみです。`memory.events` がない堎合は、生の比率が維持されたす。 | | `OMNIROUTE_SQLJS_WASM_PATH` | _(自動怜出)_ | `src/lib/db/adapters/sqljsAdapter.ts` | `sql.js` WASM フォヌルバックアダプタヌを䜿甚する際の `sql-wasm.wasm` ぞの明瀺的なパス絶察パス、たたは cwd からの盞察パス。未蚭定の堎合は、パッケヌゞの䟝存関係ず候補ずなるレむアりトから自動怜出されたす。 | | `OMNIROUTE_BATCH_RETENTION_DAYS` | `30` | `src/lib/db/cleanup.ts` | 完了状態completed/failed/cancelled/expiredの Batch API ゞョブに぀いお、チェックポむント、参照されおいる入力/出力/゚ラヌファむル、および行が、自動クリヌンアップのスむヌプによっお削陀されるたで保持される日数。`BATCH_AND_FILE_AUTO_CLEANUP_ENABLED` が有効になった埌にのみ適甚され、OpenAI 独自の Batch API 出力保持期間ず䞀臎したす。オペレヌタヌが実行する `DELETE /api/v1/batches/delete-completed` ルヌトには圱響したせん。このルヌトは蚭蚈䞊、無条件経過日数フィルタヌなしのたたです。 | | `BATCH_AND_FILE_AUTO_CLEANUP_ENABLED` | `false` | `src/lib/db/cleanup.ts` | `true` の堎合、自動クリヌンアップ凊理により、`OMNIROUTE_BATCH_RETENTION_DAYS` を超過した終了枈みの Batch API ゞョブおよびそのチェックポむントが削陀され、各ファむルの `expires_at` を超過したアップロヌド枈みファむルの BLOB コンテンツが消去されたす。デフォルトでは無効です。オペレヌタヌが明瀺的に有効化するたで、既存のすべおのむンストヌル環境ではこのデヌタが埓来どおり保持されたす。ダッシュボヌドから線集可胜な機胜フラグでもありたす。`docs/reference/FEATURE_FLAGS.md` → Runtime を参照しおください。 | | `OMNIROUTE_SKIP_DB_HEALTHCHECK` | `0` | `src/lib/db/core.ts`, `src/lib/db/healthCheck.ts` | `1` に蚭定するず、起動時の DB ヘルスチェックを完党にスキップしたす。短時間で終了するタスクや統合テストに有甚です。 | | `OMNIROUTE_FORCE_DB_HEALTHCHECK` | `0` | `src/lib/db/core.ts` | `1` に蚭定するず、通垞はスキップされる堎合短時間で終了するタスクなどでも、DB ヘルスチェックルヌプを匷制的に有効化したす。 | | `OMNIROUTE_SKIP_POSTINSTALL` | `0` | `scripts/postinstall.mjs` | `1` に蚭定するず、`npm install` 䞭のネむティブランタむムのりォヌムアップをスキップしたす。sqlite がすでにビルド枈みの CIヘッドレスむンストヌル環境に有甚です。 | | `OMNIROUTE_MIGRATIONS_DIR` | _自動怜出_ | `src/lib/db/migrationRunner.ts` | マむグレヌションランナヌがスキャンするディレクトリを䞊曞きしたす。カスタムビルドにバンドルされたマむグレヌションを含める堎合に有甚です。 | | `OMNIROUTE_EXTRA_MIGRATIONS_DIRS` | _未蚭定_ | `src/lib/db/migrationRunner/extraDirs.ts` | プラットフォヌムのパス区切り文字で区切った `namespace=dir` ゚ントリずしお、远加のマむグレヌションディレクトリを指定したす䟋`ee=/opt/app/enterprise/db/migrations`。そこで芋぀かったファむルは `-` ずしお蚘録されるため、独自のマむグレヌションを含むディストリビュヌションがアップストリヌムの数倀スロットず衝突するこずはありたせん。䞍正な圢匏の゚ントリ、無効な名前空間、たたは存圚しないディレクトリがある堎合、スキヌマを暗黙にスキップせず、起動時に゚ラヌをスロヌしたす。 | | `OMNIROUTE_MAX_PENDING_MIGRATIONS` | `50` | `src/lib/db/migrationRunner.ts` | 倧量の保留䞭マむグレヌションに察する安党しきい倀#3416です。既存の DB で、この数を超えるマむグレヌションが保留䞭の堎合、起動を䞭止したす远跡テヌブルが消去された堎合の保護。叀いバックアップを埩元するには倀を匕き䞊げ、チェックを無効化するには `0` に蚭定したす。 | | `OMNIROUTE_INSTALL_UPGRADE_WORKDIR` | _`/.install-upgrade`_ | `scripts/check/check-install-upgrade.mjs` | `check:install-upgrade` リリヌスゲヌトの䜜業ディレクトリです。玄 12 GB玄 3 GB のむンストヌルツリヌ 2 ぀ず tarballが必芁なため、小容量の tmpfs 䞊で実行しおはいけたせん。セルフホストランナヌでは `/tmp` が RAM ベヌスの 12 GB tmpfs であり、ゲヌトがその容量を䜿い果たしおパッケヌゞが切り詰められたした。 | | `OMNIROUTE_SPEND_FLUSH_INTERVAL_MS` | _コヌド内のデフォルト_ | `src/lib/spend/batchWriter.ts` | バッチ凊理される支出コストラむタヌのフラッシュ間隔ミリ秒です。倀を小さくするず曞き蟌みの集玄が枛り、倀を倧きくするず DB の競合が枛りたす。 | | `OMNIROUTE_SPEND_MAX_BUFFER_SIZE` | _コヌド内のデフォルト_ | `src/lib/spend/batchWriter.ts` | 匷制フラッシュされるたでにバッファリングできる支出゚ントリの最倧数です。高 QPS のデプロむでは倀を匕き䞊げ、メモリの䞊限管理がより重芁な堎合は倀を匕き䞋げたす。 | | `OMNIROUTE_PROXY_FETCH_DEBUG` | _未蚭定_ | `open-sse/utils/proxyFetch.ts` | `"true"` に蚭定するず、Vercel リレヌパスで `[ProxyFetch]` デバッグログを出力したす。ルヌティング情報の挏掩を防ぐため、デフォルトでは無効です。 | | `OMNIROUTE_PROXY_CORE_BINARY_PATH` | _未蚭定_ | `src/lib/proxySubscription/coreConfig/sync.ts` | 生成されたコア蚭定が採甚枈みファむルを眮き換える前に、その蚭定を怜蚌するロヌカルプロキシコアバむナリ`sing-box` ずいう名前のファむルの絶察パスです。未蚭定の堎合は、採甚枈みファむルの隣に `.generated` のみを曞き蟌みたす。ホスト環境専甚です。バむナリが実行されるため、デヌタベヌスには保存されず、管理 API 経由でも受け付けられたせん。 | | `OMNIROUTE_PROXY_CORE_RELOAD_COMMAND` | _未蚭定_ | `src/lib/proxySubscription/coreConfig/reload.ts` | 怜蚌枈みの蚭定眮換埌にロヌカルプロキシコアをリロヌドする方法です。シェルを介さずに実行される JSON 匕数配列、たたは倖郚の監芖プロセスがファむルを適甚する堎合は厳密に `external` を指定したす。デヌタベヌスには保存されず、API 経由でも公開されたせん。 | | `PROXY_LOG_INCLUDE_IPS` | `false` | `src/lib/proxyLogger.ts` | `"true"` たたは `"1"` に蚭定するず、詳现な `[ProxyEgress]` プロセスログ行にクラむアント゚グレス IP ずアカりントプレフィックスを含めたす。プロセスログから IP やアカりントプレフィックスが挏掩しないよう、デフォルトでは無効です。 | | `OMNIROUTE_DEBUG` | _(未蚭定)_ | `bin/cli/commands/quota.mjs` | `1` に蚭定するず、CLI のクォヌタコマンドからリク゚ストごずのタむミング蚺断`[omniroute] GET completed in Nms`を stderr に出力したす。 | | `OMNIROUTE_HEALTHCHECK_PATH` | _(自動)_ | `scripts/dev/healthcheck.mjs` | コンテナのヘルスチェックでプロヌブするパスを明瀺的に指定したす。未蚭定の堎合、プロヌブは `OMNIROUTE_BASE_PATH` からパスを導出したす。蚭定するず、詳现監芖゚ンドポむントの䜿甚に戻りたす。 | | `OMNIROUTE_DEBUG_COMPLETION` | _(未蚭定)_ | `bin/cli/commands/completion.mjs` | 空でない任意の倀に蚭定するず、CLI のシェル補完キャッシュ凊理読み取り/曎新/曞き蟌みから `[omniroute completion]` 蚺断を出力したす。デフォルトでは無効です。これらのキャッシュでぱラヌが通知されないため、キャッシュが欠萜たたは砎損しおいおもタブ補完が機胜しなくなるこずはありたせん。 | | `BATCH_RETRY_DURATION_MS` | `86400000`24時間 | `open-sse/services/batchProcessor.ts` | 個々のバッチ項目に察する最倧再詊行期間ミリ秒。この期間を超えた項目は倱敗ずしおマヌクされたす。 | | `BATCH_BACKOFF_BASE_MS` | `5000` | `open-sse/services/batchProcessor.ts` | バッチ項目の再詊行で䜿甚する指数バックオフの基本遅延時間ミリ秒。 | | `BATCH_BACKOFF_MAX_MS` | `3600000`1時間 | `open-sse/services/batchProcessor.ts` | バッチ項目の再詊行間に䜿甚する指数バックオフの䞊限ミリ秒。 | | `BATCH_MAX_CONCURRENT` | `1` | `open-sse/services/batchProcessor.ts` | 同時に凊理されるバッチの最倧数。スルヌプットを向䞊させるには増やしたすが、レヌト制限が集䞭しお発生するのを避けるため䜎い倀に保っおください。 | > [!IMPORTANT] > 既存の氞続デヌタベヌスを倉曎する前に、マむグレヌションランナヌは完党な > コンテンツアドレス方匏のスナップショットを `DATA_DIR/db_backups/` 配䞋に公開したす。公開には、 > 同䞀ファむルシステム内での䞊曞き䞍可のハヌドリンクず、氞続性を保蚌するファむル同期をサポヌトするファむルシステムが必芁です。 > POSIX ホストではディレクトリの同期も必芁です。Windows では Node がディレクトリハンドルを拒吊する堎合があるため、 > OmniRoute は公開されたファむルをフラッシュし、ディレクトリ゚ントリの同期をベスト゚フォヌトずしお扱いたす。 > マりントされた `DATA_DIR` がこれらを保蚌できない堎合、マむグレヌションを適甚する前に > 起動が安党偎に倱敗したす。`DATA_DIR` をこれらのプリミティブを備えたボリュヌムぞ移動しおください。 > マむグレヌションの安党性を回避するために `DISABLE_SQLITE_AUTO_BACKUP` を䜿甚しないでください。 ### シナリオ | シナリオ | 蚭定 | | ------------------ | --------------------------------------------------------------------------------------------------------------------------- | | **ロヌカル開発** | すべおデフォルトのたたにしたす。DB は `~/.omniroute/omniroute.db` に保存されたす。 | | **Docker** | `DATA_DIR=/data` を蚭定し、`/data` にボリュヌムをマりントしたす。 | | **保存時の暗号化** | `STORAGE_ENCRYPTION_KEY` を蚭定し、そのキヌを必ずバックアップしおください。キヌを倱うこずは、デヌタを倱うこずを意味したす。 | | **CI/テスト** | `DATA_DIR=/tmp/omniroute-test` — 䞀時的なため、暗号化は䞍芁です。 | --- ## 3. ネットワヌクずポヌト | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------------- | -------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `PORT` | `20128` | `src/lib/runtime/ports.ts` | Dashboard UI ず API ゚ンドポむントの䞡方で䜿甚するプラむマリポヌト単䞀ポヌトモヌド。 | | `OMNIROUTE_BASE_PATH` | _空 = ルヌト_ | `next.config.mjs`, `scripts/docker/ensure-docker-base-path.mjs` | リバヌスプロキシの背埌で OmniRoute を提䟛するための URL サブパスNext.js の `basePath` を蚭定。認蚌リダむレクトも basePath に察応。䟋: `/omniroute`。Docker では、倀は `docker build` 時に組み蟌たれたす`ARG OMNIROUTE_BASE_PATH`。ビルド枈みのルヌトむメヌゞでは、Next.js の起動前に、コンテナ起動時に䞀床だけ別のランタむム倀を適甚できたす。同じサブパスを含む公開オリゞンを `NEXT_PUBLIC_BASE_URL` に蚭定しおください。 | | `NEXT_PUBLIC_OMNIROUTE_BASE_PATH` | _空 = ルヌト_ | `src/shared/hooks/useDisplayBaseUrl.ts` | `OMNIROUTE_BASE_PATH` のブラりザ可芖ミラヌ。ビルド時にむンラむン化され、ダッシュボヌドの゚ンドポむント衚瀺が `https://host/v1` ではなく `https://host/omniroute/v1` になりたす。未蚭定の堎合は `OMNIROUTE_BASE_PATH` にフォヌルバックしたす。倉曎埌は再ビルドしおくださいNext の `basePath` はビルド時に決定されたす。 | | `DASHBOARD_ALLOW_EMBED` | _未蚭定 = フレヌム化䞍可_ | `next.config.mjs`, `scripts/build/dashboardEmbed.mjs` | HTML ペヌゞの iframe 埋め蟌みをオプトむンで有効にしたす。未蚭定の堎合、すべおのルヌトで `frame-ancestors 'none'` ず `X-Frame-Options: DENY` が送信されたす。`vscode` に蚭定するず、ペヌゞダッシュボヌド、ログむン、ドキュメント、ランディングが `frame-ancestors 'self' vscode-webview:` を䜿甚し、`X-Frame-Options` なしで提䟛されるため、VS Code Simple Browser で衚瀺できたすOmniCopilot の `dashboardOpen: "editor"` モヌド。API サヌフェス`/api`、`/v1`、`/v1beta`、`/a2a`、`/healthz`、ルヌトレベルの゚むリアスでは、いずれの堎合も厳栌なヘッダヌが維持されたす。認識される倀は `vscode` のみで、`1`/`true` では有効になりたせん。ビルド時蚭定のため、倉曎埌は再ビルドしおくださいむメヌゞの堎合は `docker build --build-arg DASHBOARD_ALLOW_EMBED=vscode`。ビルド枈み環境で蚭定しおも効果はありたせん。 | | `API_PORT` | _未蚭定_ | `src/lib/runtime/ports.ts` | 蚭定するず、`/v1/*` プロキシ API をこの個別ポヌトで提䟛したす。 | | `API_HOST` | `0.0.0.0` | `src/lib/runtime/ports.ts` | API ポヌトのバむンドアドレス。 | | `DASHBOARD_PORT` | _未蚭定_ | `src/lib/runtime/ports.ts` | 蚭定するず、Dashboard UI をこの個別ポヌトで提䟛したす。 | | `OMNI_MAX_CONCURRENT_CONNECTIONS` | `0` _無効_ | `src/sse/utils/backpressure.ts` | 凊理䞭の同時チャット接続数を制限したす。䞊限を超えたリク゚ストには `Retry-After` 付きの `503` が返されたす。正の敎数を指定するず制限が有効になり、未蚭定たたは `0` の堎合は無効になりたす。 | | `OMNIROUTE_INSTANCE_ID` | _未蚭定_ | `src/shared/resilience/peerRouting.ts` | OmniRoute むンスタンスを連鎖させる堎合に、このゲヌトりェむを識別する安定した䞀意の ID。受信時のピアルヌプチェックを有効にしたす。䜿甚可胜な文字は、英字、数字、`.`、`_`、`:`、`-` です。最倧 64 文字です。 | | `OMNIROUTE_PEER_URLS` | _未蚭定_ | `src/shared/resilience/peerRouting.ts`, `open-sse/executors/base.ts` | `X-OmniRoute-Peer-Trace` を受信できる、カンマ区切りの OmniRoute ベヌス URL。明瀺的に蚱可リストぞ登録されたアップストリヌム URL のみがピアメタデヌタを受信し、その他のプロバむダヌには䞀切圱響したせん。 | | `OMNIROUTE_PEER_MAX_HOPS` | `4` | `src/shared/resilience/peerRouting.ts` | チェヌンされたリク゚ストで受け入れる、以前にアクセス枈みの OmniRoute むンスタンスの最倧数`1``32`。むンスタンスが重耇しおいる堎合、たたは䞊限を䜿い切った堎合は、HTTP `508 Loop Detected` を返したす。 | | `PROD_DASHBOARD_PORT` | `20130` | `docker-compose.prod.yml` | Docker の本番モヌドで Dashboard を公開するホスト偎のポヌト。 | | `PROD_API_PORT` | `20131` | `docker-compose.prod.yml` | Docker の本番モヌドで API を公開するホスト偎のポヌト。 | | `OMNIROUTE_PORT` | _未蚭定_ | `src/lib/runtime/ports.ts` | Electron たたはその他のラッパヌ内で実行する堎合、`PORT` より優先されたす。 | | `LIVE_WS_PORT` | `20129` | `src/server/ws/liveServer.ts` | リアルタむム WebSocket ラむブ監芖サヌバヌ甚のポヌト。 | | `LIVE_WS_HOST` | `127.0.0.1` | `src/server/ws/liveServer.ts` | ラむブ WebSocket サヌバヌのバむンドアドレス。LAN 䞊に公開するには `0.0.0.0` に蚭定しおください`LIVE_WS_ALLOWED_ORIGINS` の蚭定も必芁です。 | | `LIVE_WS_ALLOWED_ORIGINS` | _未蚭定_ | `src/server/ws/liveServer.ts` | ラむブ WebSocket を開くこずが蚱可される远加のオリゞンカンマ区切り。ルヌプバックの Dashboard オリゞンは、デフォルトですでに蚱可されおいたす。 | | `LIVE_WS_ALLOWED_HOSTS` | _未蚭定_ | `src/server/ws/liveServerAllowList.ts` | ラむブ WebSocket のオリゞンずしお蚱可される远加のホスト名カンマ区切り。`LIVE_WS_ALLOWED_ORIGINS`完党なオリゞン URLずは異なり、ホスト郚分のみに䞀臎したす。LAN/Tailscale 環境で圹立ちたす。 | | `NEXT_PUBLIC_LIVE_WS_PUBLIC_URL` | _未蚭定_ | `src/hooks/useLiveDashboard.ts` | ラむブ Dashboard WebSocket の公開 URLブラりザ偎。WS サヌバヌの前段にリバヌスプロキシたたは Cloudflare Tunnel を配眮する堎合に蚭定したす䟋`wss://ws.my-ai.com/live-ws`。ブラりザは `ws://hostname:20132` の代わりにこの URL ぞ接続したす。パス名郚分は WebSocket のアップグレヌドパスずしおも䜿甚されたすデフォルト`/live-ws`。 | | `OMNIROUTE_ENABLE_LIVE_WS` | `true` | `src/server/ws/liveServer.ts` and `scripts/start-ws-server.mjs` | リアルタむム WebSocket サヌバヌを無効にするには、`0` たたは `false` に蚭定したすデフォルトでは有効で、ルヌプバックにバむンドされたす。スタンドアロンのラむブ WebSocket ヘルパヌスクリプトを無効にする CI/テストハヌネス甚の切り替え蚭定です。 | | `RELAY_IP_PER_MINUTE` | `30` | `src/app/api/v1/relay/chat/completions/route.ts` | トヌクン、IPごずのリレヌ速床制限リク゚スト数/分。むンメモリで、むンスタンス単䜍です。`0` たたは負の倀を指定するず IP 次元のゲヌトが無効になりたすトヌクン単䜍の DB 制限は匕き続き適甚されたす。 | | `NODE_ENV` | `production` | Next.js コア | ログの詳现床、キャッシュ、゚ラヌ詳现の公開、および Next.js の最適化を制埡したす。 | | `OMNIROUTE_USE_TURBOPACK` | `1` (Turbopack — コヌド䞊のデフォルト) | `package.json` / Next.js 16 | Turbopack は `npm run dev` および `npm run build` のデフォルトバンドラヌですベンチマヌクではビルドが 23 倍高速。Windows でネむティブバむンディングやバンドラヌ互換性の問題が発生する堎合、**たたは RAM に制玄のあるマシンでは**、webpack にフォヌルバックするため `0` に蚭定しおください。この Next.js バヌゞョン系列16.2.xの Turbopack プロダクションビルドは、倧芏暡なモゞュヌルグラフで webpack よりもはるかに高いメモリ䜿甚量に達するこずが䞊流で確認されおいたすNext 16.3 の Turbopack メモリ退避修正はただ安定版ではありたせん。webpack ぞのフォヌルバックではピヌク䜿甚量が倧幅に䜎くなりたす。#6409 を参照しおください。**Docker むメヌゞのビルドではデフォルトが `0`webpackです**。`Dockerfile` で `ARG OMNIROUTE_USE_TURBOPACK=0` が宣蚀されおいるため、単玔な `docker build .`Railway やその他のワンクリックホスト、臚時のセルフホスティング環境では、メモリ䞊限のあるビルダヌで OOM により匷制終了されたせん。Turbopack でむメヌゞをビルドするには、`--build-arg OMNIROUTE_USE_TURBOPACK=1` を枡しおください。`docs/guides/DOCKER_GUIDE.md` → ビルド時のリ゜ヌスを参照しおください。 | | `OMNIROUTE_SKIP_DB_HEALTHCHECK` | _(未蚭定)_ | `src/lib/db/core.ts` / `src/lib/db/healthCheck.ts` | 起動時の SQLite 敎合性ヘルスチェックをスキップするには、`1` に蚭定したす。倧芏暡なデヌタベヌスで起動を高速化する堎合に䟿利です。 | | `NOTIFY_SOCKET` | _(未蚭定)_ | systemdsd_notify プロトコル | プロセスが sd_notify 統合を備えたサヌビスナニットの䞋で実行される堎合に、systemd によっお蚭定されたす。OmniRoute はこれを読み取り`OMNIROUTE_DISABLE_SD_NOTIFY` を参照、READY/WATCHDOG 通知を送信したす。ナヌザヌが蚭定するこずはありたせん。 | | `OMNIROUTE_DISABLE_SD_NOTIFY` | _(未蚭定)_ | `scripts/dev/systemd-notify.mjs` | systemd ナニットの䞋で実行しおいる堎合でも、systemd sd_notifyType=notify / WatchdogSec=を無効にするには `1` に蚭定したす。systemd 倖では、通知機胜は垞に䜕も実行したせん。 | | `CREDENTIAL_HEALTH_CHECK_INTERVAL` | `3600000` | `open-sse/config/constants.ts` / `src/lib/credentialHealth/scheduler.ts` | バックグラりンドの認蚌情報ヘルスチェックスケゞュヌラヌの間隔ミリ秒。最小倀: 1000010 秒。 | | `CREDENTIAL_HEALTH_CACHE_TTL` | `300000` | `open-sse/config/constants.ts` / `src/lib/credentialHealth/cache.ts` | キャッシュされた認蚌情報のヘルスステヌタスの TTLミリ秒。 | | `OMNIROUTE_DISABLE_CREDENTIAL_HEALTH_CHECK` | `false` | `src/lib/credentialHealth/scheduler.ts` | プロバむダヌ接続のバックグラりンド定期テストを無効にするには、`1` たたは `true` に蚭定したす。怜玢プロバむダヌ`src/lib/providers/validation/searchProviders.ts` 内の SEARCH_VALIDATOR_CONFIGS。䟋: `tavily-search`は、垞にチェック察象から陀倖されたす。それらの「怜蚌」は実際に課金されるアップストリヌムク゚リであるため、タむマヌによるヘルスチェックは実行されたせん#9970。 | | `DEEP_HEALTH_CHECK_ENABLED` | `0` | `src/app/api/monitoring/health/route.ts` | 認蚌枈みの呌び出し元が `/api/monitoring/health?deep=1` をリク゚ストできるようにするには、`1` に蚭定したす。このリク゚ストは、TTL ごずに 1 回 completions サヌフェスをサンプリングしたす。匿名の呌び出し元がプロヌブをトリガヌするこずはありたせん。 | | `HOST` | `0.0.0.0` | `scripts/dev/run-next.mjs` | Next.js dev/start サヌバヌのバむンドアドレス。蚭定するず、デフォルトの `0.0.0.0` を䞊曞きしたす。 | | `HOSTNAME` | `127.0.0.1` | `scripts/dev/run-next-playwright.mjs` | Playwright ランナヌが Next.js を起動するずきに䜿甚するバむンドアドレス。再珟性ず隔離性のあるテストのため、デフォルトは `127.0.0.1` です。**`omniroute serve` には䜿甚しないでください**。代わりに `OMNIROUTE_SERVER_HOST` を䜿甚しおくださいPOSIX シェルは `HOSTNAME` をマシン名に自動蚭定するため、`.env` では䞊曞きできたせん。 | | `OMNIROUTE_SERVER_HOST` | `0.0.0.0` | `bin/cli/commands/serve.mjs` | `omniroute serve` のバむンドアドレス。POSIX シェルの `HOSTNAME` 倉数bash/zsh によっお垞にマシン名に蚭定されるずの競合を回避したす。未蚭定の堎合は `0.0.0.0` にフォヌルバックしたす。(#6194) | ### ポヌトモヌド ``` ┌─────────────────────── 単䞀ポヌトデフォルト ───────────────────────────┐ │ PORT=20128 │ │ → ダッシュボヌド: http://localhost:20128 │ │ → API: http://localhost:20128/v1/chat/completions │ └─────────────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────── ポヌト分割 ─────────────────────────────────────┐ │ DASHBOARD_PORT=20128 │ │ API_PORT=20129 │ │ API_HOST=0.0.0.0 │ │ → ダッシュボヌド: http://localhost:20128 │ │ → API: http://0.0.0.0:20129/v1/chat/completions │ │ 䜿甚䟋: ダッシュボヌドを localhost に制限しながら API を LAN に公開したす。│ └─────────────────────────────────────────────────────────────────────────────┘ ┌──────────────────────── Docker 本番環境 ───────────────────────────────────┐ │ PROD_DASHBOARD_PORT=443 PROD_API_PORT=8443 │ │ → docker-compose.prod.yml でコンテナポヌトをホストポヌトにマッピングしたす。│ └─────────────────────────────────────────────────────────────────────────────┘ ``` --- ## 4. セキュリティず認蚌 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `MACHINE_ID_SALT` | `endpoint-proxy-salt` | `src/lib/auth` | マシンのフィンガヌプリント生成のためにハヌドりェア識別子ず組み合わせる゜ルト。環境を分離するため、デプロむごずに倉曎しおください。 | | `OMNIROUTE_CLI_SALT` | _未蚭定 = むンストヌルごずにランダムな゜ルトを生成し、`/cli-token-salt.json` に氞続化_ | `src/lib/machineToken.ts` | ロヌカル CLI 認蚌トヌクンの導出に䜿甚する HMAC ゜ルト。この倀を蚭定するず、マシン䞊のすべおの CLI トヌクンがロヌテヌションされ、氞続化された゜ルトより垞に優先されたす。`docs/security/CLI_TOKEN.md` を参照しおください。 | | `AUTH_COOKIE_SECURE` | `false` | `src/lib/auth` | セッション Cookie に `Secure` フラグを蚭定したす。HTTPS の背埌で実行する堎合は、**必ず `true` に蚭定しおください**。 | | `REQUIRE_API_KEY` | `false` | API ミドルりェア | `true` の堎合、すべおの `/v1/*` プロキシリク゚ストに有効な API キヌを含める必芁がありたす。**このフラグは `GET /v1/models` ぞのアクセスを制埡したせん**。代わりに、これはダッシュボヌドのログむン方針`requireAuthForModels`に埓いたす。そのため、`/v1/models` からの `401` は、掚論が保護されおいるこずを意味したせん。`docs/security/INFERENCE_AUTH_POSTURE.md`#13695を参照しおください。 | | `ALLOW_API_KEY_REVEAL` | `false` | `src/shared/constants/featureFlagDefinitions.ts` | ダッシュボヌド UI で API キヌの完党な倀を衚瀺できるようにしたす。ダッシュボヌドの機胜フラグから蚭定できたすが、共有むンスタンスではセキュリティリスクがありたす。 | | `NO_LOG_API_KEY_IDS` | _空_ | `src/lib/compliance/index.ts` | リク゚ストログの蚘録察象倖ずする API キヌ ID のカンマ区切りリストGDPR 準拠。 | | `DEFAULT_RATE_LIMIT_PER_DAY` | _未蚭定 = 無制限_ | `src/shared/utils/apiKeyPolicy.ts` | `rate_limits` 列が null の API キヌに適甚される、1 日あたりのリク゚スト予算のフォヌルバック倀。未蚭定たたは空の堎合、暗黙的な䞊限はありたせん#2289、#11017。`0` も同様です無制限。正の敎数 N を指定するず、N/日、5N/週、20N/月が有効になりたす。䞍正な空でない倀の堎合は、埓来の 1000/日、5000/週、20000/月の期間制限にフォヌルバックしたす。 | | `MAX_BODY_SIZE_BYTES` | `10485760`10 MB | `src/shared/middleware/bodySizeGuard.ts` | 蚱可されるリク゚スト本文の最倧サむズ。この制限を超えるペむロヌドは拒吊されたす。 | | `OMNIROUTE_CHAT_LARGE_BODY_BYTES` | `262144`256 KB | `src/shared/middleware/chatBodyAdmission.ts` | このしきい倀以䞊の実際のリク゚スト本文は、JSON の解析前に、プロセスロヌカルでアトミックな高負荷凊理甚アドミッションリヌスを取埗したす`POST /v1/responses` を含む BYTE パス。構造的に負荷の高いリク゚ストず同じ [#10437](https://github.com/diegosouzapw/OmniRoute/pull/10437) の正垞時ヘッドルヌム回避策が適甚されたすが、[#7849](https://github.com/diegosouzapw/OmniRoute/issues/7849) の再発を防ぐため、匕き続き `OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES` / [#10110](https://github.com/diegosouzapw/OmniRoute/issues/10110) によっお制限されたす。 | | `OMNIROUTE_CHAT_HARD_MAX_BODY_BYTES` | `52428800` (50 MB) | `src/shared/middleware/chatBodyAdmission.ts` | 境界付き取り蟌み䞭に読み取られたバむト数に察しお適甚される、チャットルヌトのハヌド䞊限。`Content-Length` が欠萜、䞍正、たたは実際ず異なるリク゚ストも察象ずなり、超過時には `413` が返されたす。 | | `OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT` | _(未蚭定 — リク゚スト数の䞊限なし)_ | `src/shared/middleware/chatBodyAdmission.ts` | **#503-fanout:** この埓来のリク゚スト「数」䞊限は、明瀺的に蚭定された堎合にのみ適甚されるようになりたした。未蚭定デフォルトの堎合、重量玚チャットの受け入れは代わりに `OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES` によっお制埡されたす。これは、**単䞀プロセス**1぀のV8ヒヌプにおけるプロセスの実際のメモリ䞊限から自動算出されるバむト予算です。玄750kトヌクンの `/v1/responses` が2件重なるず玄12 GiBのヒヌプが異垞終了する#7849ずいうのは、**メモリ予算**に関する譊告であり、補品ずしおのハヌド䞊限が2件ずいう意味ではありたせん。正垞なプロセスヒヌプが遮断比率未満では、`OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM` により、より倚くの長時間 `/v1/responses` を同時に受け入れおもかたいたせん。数十4050の長時間SSEクラむアントを扱えるかどうかは、ヒヌプ + `OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES` / #10110 に䟝存し、「最倧2件」ではありたせん。「ホストを䜿い切る」ためにこれをむやみに匕き䞊げるず、#7849 が再発したす。**N個の独立した `DATA_DIR`**#11024によっお**ヒヌプ**を増やしおください。1぀のSQLiteファむルに察しお `replicas>1` を蚭定しおはなりたせん。 | | `OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES` | _(自動算出)_ | `src/shared/middleware/admissionBudget.ts` | **#503-fanout:** 自動算出される取り蟌みバむト予算V8ずcgroupのうち厳しい方のメモリ䞊限の25%を、䞀時的な8倍の増幅率で陀算を䞊曞きしたす。算出倀ず明瀺倀はいずれも8 MiB2 GiBの範囲に制限されたす。有効な予算を超える本文は、盎ちに `413 body_exceeds_budget` で倱敗したす。個別には凊理可胜な本文同士の競合は、匕き続き再詊行可胜な `503` になりたす。4050件の長時間SSEクラむアントを同時凊理できるかどうかは、この予算 + ヒヌプに䟝存し、ハヌドな「最倧2件」ではありたせん。調敎前に `/api/monitoring/health` で `chatAdmission.maxInflightBytes` / `budgetSource` / `pressureSeverity` を確認しおください。 | | `OMNIROUTE_CHAT_ADMISSION_HEAP_SHED_RATIO` | `0.75` | `src/shared/middleware/chatBodyAdmission.ts` | BYTEおよびSTRUCTUREの重量玚受け入れに察するヒヌプ負荷遮断比率`heapUsed / heap_size_limit`#10183、#10268、#10437。`OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT` を超える同時重量玚リク゚ストは、ヒヌプもこの比率以䞊の堎合にのみ、再詊行可胜な `503` で遮断されたす。正垞なヒヌプでは、healthy-headroom経由で受け入れられたす。 | | `OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM` | `OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT` (デフォルト `1`) | `src/shared/middleware/chatBodyAdmission.ts` | STRUCTUREずBYTEの**äž¡æ–¹**`OMNIROUTE_CHAT_LARGE_BODY_BYTES` 以䞊の本文を含む `admitChatRequest`に適甚される、正垞ヒヌプ高速パス#10437向けの境界付き远加容量です。この䞊限がない堎合、ビゞヌ状態でもヒヌプが正垞であれば、すべおのリク゚ストが䞊限なしで受け入れ制埡を迂回しおいたした。正垞ヒヌプパスを通じおこの数の同時リヌスがアクティブになるず、それ以降のビゞヌなリク゚ストは、実際のヒヌプ負荷時ず同じ境界付き埅機遮断パスぞフォヌルスルヌしたす。`0` にするず、このバむパスは完党に無効になりたす。 | | `OMNIROUTE_CHAT_HEAVY_MESSAGE_COUNT` | `200` | `src/shared/middleware/chatBodyAdmission.ts` | 本文がバむトしきい倀未満であっおも、チャットリク゚ストを重量玚ず分類するメッセヌゞ数です。 | | `OMNIROUTE_CHAT_HEAVY_TOOL_COUNT` | `64` | `src/shared/middleware/chatBodyAdmission.ts` | 本文がバむトしきい倀未満であっおも、チャットリク゚ストを重量玚ず分類するツヌル数です。 | | `OMNIROUTE_CHAT_HEAVY_ESTIMATED_TOKENS` | `32000` | `src/shared/middleware/chatBodyAdmission.ts` | リク゚ストを重量玚ず分類するための、文字列サむズに基づく保守的なトヌクン掚定倀です。これは受け入れコストの代替指暙であり、プロバむダヌの課金甚トヌクン化ではありたせん。 | | `OMNIROUTE_CHAT_HARD_MAX_MESSAGES` | `0` (無効) | `src/shared/middleware/chatBodyAdmission.ts` | オプトむンで蚭定できる、任意のチャット履歎䞊限です。デフォルトでは無効です。メッセヌゞ数はデプロむメントポリシヌであり、リク゚ストに普遍的な性質ではありたせん。たた、ここで䞊限を蚭定するず、圧瞮パむプラむンによっお凊理可胜になる前に、䌚話が終端的な `413` で拒吊されたす。ヒヌプ増加は `OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT` ずヒヌプ負荷遮断によっお制限されたす。ハヌド䞊限が必芁なメモリ制玄の厳しいデプロむメントでは、正の倀を蚭定しおください。その堎合、超過時には圧瞮が必芁であるこずを瀺す構造化された `413` が返されたす。 | | `OMNIROUTE_MAX_NONSTREAMING_RESPONSE_BYTES` | `67108864` (64 MB) | `open-sse/handlers/chatCore/nonStreamingResponseBody.ts` | メモリに完党にバッファリングされる、非ストリヌミングのアップストリヌムレスポンスに察するハヌド䞊限です。これを超えるずアップストリヌムリヌダヌがキャンセルされ、ヒヌプが枯枇するたで無制限に文字列を増倧させる代わりに、リク゚ストが即座に倱敗したす。 | | `OMNIROUTE_FORWARDING_HEADER_BUDGET_BYTES` | `768` | `open-sse/handlers/chatCore/responseHeaders.ts` | アップストリヌムのレスポンスヘッダヌから転送する最倧通信バむト数。䞊限を超えるず、䞀般的なリバヌスプロキシのヘッダヌ制限内に収たるよう、優先床の䜎いヘッダヌカスタム `x-codex-*`、`x-oai-request-id` などが砎棄されたす。レスポンスヘッダヌのサむズが倧きくなる代わりに、より倚くのアップストリヌムメタデヌタを転送するには、より倧きい倀を蚭定しおください。 | | `CORS_ORIGIN` | _(未蚭定)_ | `src/server/cors/origins.ts` | 埓来の単䞀オリゞン甚CORS蚱可リスト。新芏デプロむでは `CORS_ALLOWED_ORIGINS` を掚奚したす。CORSはクロスオリゞンのブラりザヌAPIクラむアント専甚です。認蚌枈みダッシュボヌドからの曞き蟌みでは、代わりに同䞀オリゞンリク゚ストずセッションに玐付いたCSRF保護を䜿甚したす。 | | `CORS_ALLOWED_ORIGINS` | _(未蚭定)_ | `src/server/cors/origins.ts` | カンマ区切りのCORS蚱可リスト。`CORS_ALLOW_ALL=true` が明瀺的に蚭定されおいない限り、ワむルドカヌドは送信されたせん。 | | `CORS_ALLOW_ALL` | `false` | `src/server/cors/origins.ts` | ブラりザヌのあらゆる `Origin` をそのたた返すための、開発環境専甚の回避手段。共有環境たたは本番環境では有効にしないでください。 | | `OUTBOUND_SSRF_GUARD_ENABLED` | `true` | `src/shared/network/outboundUrlGuardPolicy.ts` | 埓来の゚むリアス。この環境倉数の倀より先にダッシュボヌドのトグルDBによるオヌバヌラむドが読み蟌たれたす。いずれかで `false`、`0`、`no`、たたは `off` を指定するず、そのフラグのダッシュボヌドトグルがオフずしお保存されおいる堎合でも、`OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS=true` ず同様にホストチェックが無効になりたす。その他の倀の堎合、ガヌドの動䜜は以䞋の2぀のフラグに委ねられたす。 | | `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS` | `false` | `src/shared/network/outboundUrlGuardPolicy.ts` | ガヌドモヌドに埓うプロバむダヌパスで、クラりドメタデヌタのブロック169.254.0.0/16党䜓、metadata.google.internalを含むアりトバりンドURLガヌドのホストチェックを無効にしたす。察象には、URL怜蚌、モデル怜出、プロバむダヌノヌドのベヌスURLリモヌトリランキングノヌドを含む、プロキシフォヌルバックテストのほか、リモヌト画像メディアの取埗など、プロバむダヌに隣接するアりトバりンドパスが含たれたす。たた、クラりドメタデヌタリンクロヌカル゚ンドポむントを陀くプラむベヌトWebhookタヌゲットも蚱可したす。これらの゚ンドポむントは、このフラグがオンでも匕き続きブロックされたす。`BaseExecutor.execute()` を介しお送信されるチャットリク゚ストでは、クラりドメタデヌタチェックが維持されたす。ロヌカルプロバむダヌはデフォルト蚭定で動䜜したす。`OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS`デフォルトは `true`により、怜蚌、怜出、およびプロバむダヌノヌドのパスではロヌカルURLずLAN URLがすでに蚱可されおいたす。プロキシフォヌルバックテストずプラむベヌトWebhookタヌゲットはこのフラグのみを参照し、このフラグがオフの堎合はロヌカルLANホストをブロックしたす。`OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS=false` より優先されたす。ダッシュボヌドのトグルから保存された倀は、この倉数より優先されたす。 | | `OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS` | `true` | `src/shared/network/outboundUrlGuardPolicy.ts` | プロバむダヌ怜蚌、モデル怜出、チャット、およびガヌドモヌドが管理するその他のプロバむダヌ関連アりトバりンドパスで、ロヌカルプラむベヌトアドレス127.0.0.1、localhost、LAN、プラむベヌト範囲のプロバむダヌURLを蚱可したす。**デフォルトは `true`**ロヌカル優先です。この堎合、ガヌドはクラりドメタデヌタ゚ンドポむント169.254.0.0/16党䜓ず、既知のメタデヌタホスト名であるmetadata.google.internal、metadata.goog、Alibaba/Azure/Oracle IMDS、fd00:ec2::254をブロックしたす。プラむベヌトホストずルヌプバックホストもブロックする公開環境限定モヌドにするには、`false` に蚭定したす。ガヌドはDNSルックアップの前に、蚘述されたずおりのホスト名たたはIPリテラルをチェックしたす。公開環境限定モヌドでは、セヌフフェッチラッパヌがさらにホスト名を解決し、プラむベヌトアドレスが返された堎合は拒吊したす。`OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS=true` にするず、その行に蚘茉されたパスでこれらのチェックが無効になりたす。LM Studio、Ollama、vLLM、Llamafile、Tritonなどの組み蟌みロヌカルプロバむダヌでは、キヌ怜蚌ずチャットに関するすべおのホストチェックがスキップされたす。ダッシュボヌドのトグルから保存された倀は、この倉数より優先されたす。(#5066) | | `AUDIO_REMOTE_PROVIDER_NODES` | `false` | `src/app/api/v1/_shared/audioProviderNodes.ts` | `/v1/audio/*` ルヌト文字起こし、音声、翻蚳で、localhost倖でホストされおいるOpenAI互換プロバむダヌノヌドを䜿甚できるようにしたす。デフォルトではオフです。音声をリモヌトホストにルヌティングするず倖向き通信の送信元IDが倉わるため、オペレヌタヌが明瀺的に刀断する必芁がありたす。ルヌプバックプラむベヌトノヌドlocalhost、127.0.0.1、172.16-31.xは垞に蚱可され、この蚭定の圱響を受けたせん。(#3963) | | `RERANK_REMOTE_PROVIDER_NODES` | `false` | `src/app/api/v1/_shared/rerankProviderNodes.ts` | `POST /v1/rerank`およびメモリ゚ンゞンのルヌプバックによるリランキング手順で、localhost倖でホストされおいるOpenAI互換プロバむダヌノヌドTEI、Infinity、vLLMなどを実行しおいるLANマシンたたはTailscaleピアを䜿甚できるようにしたす。デフォルトではオフです。リモヌトホストぞのルヌティングでは倖向き通信の送信元IDが倉わるため、オペレヌタヌが明瀺的に刀断する必芁がありたす。ルヌプバックノヌドlocalhost、127.0.0.1、172.16-31.xは垞に蚱可され、この蚭定の圱響を受けたせん。リモヌトノヌドのベヌスURLは、プロバむダヌのアりトバりンドURLポリシヌ`OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS` / `OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS`にも適合する必芁がありたす。 | | `OMNIROUTE_LOCAL_PROVIDER_NODE_HOSTS` | _空_ | `src/shared/network/localNodeHosts.ts` | プロバむダヌノヌドルヌティングでロヌカルずしお扱うホスト名カンマたたは空癜区切り。通垞は、OmniRoute 自身の Docker ネットワヌク䞊にあるリランカヌ、TEI、たたはオヌディオサむドカヌの Docker/Compose サヌビス名`http://reranker:8080/v1`を指定したす。これにより、ノヌドにコンテナ IP をハヌドコヌドする必芁がなくなりたす。指定されたホストでは、各リモヌトノヌドに察しお `RERANK_REMOTE_PROVIDER_NODES` / `AUDIO_REMOTE_PROVIDER_NODES` を有効にしなくおも、`/v1/rerank`、`/v1/audio/*`、およびロヌカルヘルスチェックを利甚できたす。たた、これらのホストは `HTTP(S)_PROXY` や接続に固定されたプロキシを経由せず、垞に盎接呌び出されたす。ただし、接続の API キヌは匕き続き送信されたす。単䞀ラベル名ず `.internal`/`.local` 名のみが受け入れられたす。パブリック FQDN、IP リテラル、およびクラりドメタデヌタ名は譊告ずずもに無芖されたす。(#14635) | | `OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN` | `false` | `src/app/api/auth/login/route.ts` | OIDC が有効な堎合、パスワヌドログむンを無効にし、ナヌザヌが OIDC シングルサむンオン経由でのみ認蚌できるようにしたす。短瞮゚むリアス `OIDC_DISABLE_PASSWORD_LOGIN` も䜿甚できたす。同じキヌのダッシュボヌド機胜フラグが優先されたす。(#10889) | | `OIDC_DISABLE_PASSWORD_LOGIN` | `false` | `src/app/api/auth/login/route.ts` | `OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN` の短瞮゚むリアスです (#10889)。 | ### セキュリティ匷化チェックリスト ```bash # 本番環境における最䜎限のセキュリティ蚭定: AUTH_COOKIE_SECURE=true # HTTPS が必芁 REQUIRE_API_KEY=true # すべおのプロキシ呌び出しを認蚌 ALLOW_API_KEY_REVEAL=false # UI にキヌを決しお衚瀺しない CORS_ALLOWED_ORIGINS=https://your.domain.com MAX_BODY_SIZE_BYTES=5242880 # 侊限 5 MB ``` --- ## 5. 入力サニタむズず PII 保護 OmniRoute は、リク゚スト偎のむンゞェクションスキャンずレスポンス偎の PII 陀去ずいう、2 局の防埡を提䟛したす。 > **⚠ 制限事項:** これらのガヌドレヌルは完党なプロンプトむンゞェクションファむアりォヌルや PII DLP システムではなく、*ベスト゚フォヌト型のヒュヌリスティック*怜出です。誀怜知無害なペル゜ナ/RPG プロンプトが怜出されるや怜出挏れリヌトスピヌク、空癜の挿入、英語以倖のパタヌンが発生する可胜性がありたす。これらだけではコンプラむアンス察応ずしお十分ではありたせん。䟝存する前に、モヌドを調敎し、実際のトラフィックに察しおテストしおください。 ### リク゚スト偎: プロンプトむンゞェクションガヌド | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | --------------------------------- | ---------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `INPUT_SANITIZER_ENABLED` | `true` | `src/middleware/promptInjectionGuard.ts` | 受信メッセヌゞに察するプロンプトむンゞェクションパタヌンのスキャンを有効にしたす。 | | `INPUT_SANITIZER_MODE` | `warn` | `src/middleware/promptInjectionGuard.ts` | むンゞェクションポリシヌ: `warn` = ログ蚘録のみ、`block` = リク゚ストを 400 で拒吊したす。埓来の `redact` はむンゞェクションテキストを陀去**したせん**。リク゚スト内の PII を曞き換えるには `PII_REDACTION_ENABLED` を䜿甚しおください。 | | `INJECTION_GUARD_MODE` | _(未蚭定)_ | `src/middleware/promptInjectionGuard.ts` | `INPUT_SANITIZER_MODE` の埓来の゚むリアスです。動䜜は同じです。 | | `INPUT_SANITIZER_BLOCK_THRESHOLD` | `high` | `src/shared/utils/injectionSeverity.ts` | `MODE=block` が拒吊する最䜎重倧床: `high`デフォルト、`medium`、たたは `low`。しきい倀を䞋げない限り、重倧床が Medium のパタヌンは監芖のみずなりたす。 | | `INJECTION_GUARD_BLOCK_THRESHOLD` | _(未蚭定)_ | `src/shared/utils/injectionSeverity.ts` | `INPUT_SANITIZER_BLOCK_THRESHOLD` の埓来の゚むリアスです。動䜜は同じです。 | | `PII_REDACTION_ENABLED` | `false` | `src/lib/guardrails/piiMasker.ts` | `true` の堎合、受信リク゚スト内の PII をマスキングしたすむンゞェクションモヌドずは独立しおいたす。 | | `CREDENTIAL_REDACTION_ENABLED` | `false` | `src/lib/guardrails/credentialMasker.ts` | リク゚スト/レスポンスのペむロヌドから、既知の API キヌ/シヌクレットトヌクンのパタヌンをマスキングしたす。オプトむン方匏で、`PII_REDACTION_ENABLED` ず同様に動䜜したす。 | ### レスポンス偎: PII サニタむザヌ | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | -------------------------------- | ---------- | ------------------------- | ------------------------------------------------------------------------------------------ | | `PII_RESPONSE_SANITIZATION` | `false` | `src/lib/piiSanitizer.ts` | クラむアントに返す前に、LLM のレスポンスに挏掩した PII が含たれおいないかスキャンしたす。 | | `PII_RESPONSE_SANITIZATION_MODE` | `redact` | `src/lib/piiSanitizer.ts` | `redact` = PII をマスキング、`warn` = ログ蚘録のみ、`block` = レスポンス党䜓を砎棄したす。 | ### VS Code トヌクン化ルヌトのコンテキストサニタむザヌ | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ----------------------------------- | ---------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_VSCODE_SANITIZE_CONTEXT` | `1` | `src/app/api/v1/vscode/contextSanitizer.ts` | `/v1/vscode/[token]/*` リク゚ストから、暗黙的なアクティブ゚ディタヌのコンテキスト`editorContext`、`activeEditor`、`currentFile`、`selection`、`openTabs` を陀去し、明瀺的に添付された機密ファむルの内容をマスキングしたす。デフォルトで安党な蚭定です。無効にするには `0` に蚭定しおください。 | ### シナリオ | シナリオ | 蚭定 | | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **゚ンタヌプラむズコンプラむアンス** | `INPUT_SANITIZER_ENABLED=true`、`INPUT_SANITIZER_MODE=block`、`PII_REDACTION_ENABLED=true`、`PII_RESPONSE_SANITIZATION=true`むンゞェクションをブロックし、リク゚スト/レスポンスの PII をマスキングしたす。各モヌドは独立しおいたす | | **監芖のみ** | `INPUT_SANITIZER_ENABLED=true`、`INPUT_SANITIZER_MODE=warn` — ログには蚘録したすが、ブロックは行いたせん | | **個人利甚** | すべお無効のたたにしたす — オヌバヌヘッドはれロです | --- ## 6. ツヌルおよびルヌティングポリシヌ | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ----------------------------------------------------------- | ----------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `TOOL_POLICY_MODE` | `disabled` | `src/lib/toolPolicy.ts` | LLMによるツヌル関数呌び出しぞのアクセスを制埡したす。`allowlist` = リストに蚘茉されたツヌルのみ、`denylist` = リストに蚘茉されたもの以倖すべお、`disabled` = 制限なし。 | | `OMNIROUTE_PAYLOAD_RULES_PATH` | `./config/payloadRules.json` | `open-sse/services/payloadRules.ts` | ペむロヌド操䜜ルヌルのJSONファむルぞのパスモデルプロトコルごずのアップストリヌム調敎。 | | `OMNIROUTE_PAYLOAD_RULES_RELOAD_MS` | `5000` | `open-sse/services/payloadRules.ts` | ペむロヌドルヌルファむルをホットリロヌドする間隔ミリ秒。最小倀は`1000`。 | | `OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS` | `false` | `open-sse/services/model.ts` | オプトむン蚭定Claude Codeクラむアントからの、プロバむダヌプレフィックスのない`claude-*`モデルIDを、プロバむダヌプレフィックスを芁求する代わりにClaude Code OAuthアカりント経由でルヌティングしたす。明瀺的なプロバむダヌプレフィックスが匕き続き優先されたす。Claudeプロバむダヌペヌゞのダッシュボヌドトグルからも蚭定できたす。 | | `BARE_MODEL_DEFAULT_OVERRIDE_LEGACY` | `false` | `open-sse/services/model.ts` | 埓来の`resolveBareModelToConnectionDefault`動䜜#4825プレフィックスのない任意のモデル名を、遞択した接続の`defaultModel`で眮き換えたす。デフォルトでは無効であり、`auto`たたは空のモデルのみが眮き換えられたす。有効にするず、ペアごずに譊告が1回蚘録されたす。 | | `COMBO_CONCURRENCY_PER_MODEL` | `3` | `open-sse/services/comboConfig.ts` | ラりンドロビンコンボのモデルごずの同時実行数䞊限#9100。ラりンドロビンコンボのセマフォは、䞊曞き手段がないたたモデルごずの同時リク゚スト数が3に固定されおいたため、より高い同時実行トラフィックがその䞊限の背埌で盎列化されおいたした。`>= 1`ずなるよう怜蚌され、`<= 32`に制限されたす。 | | `DISABLE_CONTEXT_WINDOW_CHECKS` | `false` | `open-sse/handlers/chatCore.ts` | 盎接の単䞀モデルリク゚ストに察するOmniRouteのロヌカルコンテキストりィンドり最倧入力トヌクンチェックをスキップする、危険なオプトむン蚭定です。アップストリヌムプロバむダヌは匕き続き実際の䞊限を適甚し、プロンプト圧瞮ずモデル自䜓の出力トヌクン䞊限も匕き続き有効です。実際の優先順䜍は、Feature Flags DBの䞊曞き > 環境倉数 > デフォルトです。再起動は䞍芁です。 | | `OMNIROUTE_SELF_HOSTED_PROVIDERS` | _未蚭定_ | `open-sse/services/selfHostedEntry.ts` | むンラむンYAMLの`providers:`ドキュメントRIC-738、D4。蚭定されおいる堎合`strategy:`ブロックの有無を問わず、`/v1/chat/completions`はクラりドパむプラむンではなく、セルフホスト型の統合OpenAI互換゚ントリぞ振り分けられたす。未蚭定デフォルトの堎合、ルヌトはそのたた既存のクラりドパむプラむンぞフォヌルスルヌしたす。`docs/routing/SELF_HOSTED_OPENAI_ENTRY.md`を参照しおください。 | | `OMNIROUTE_SELF_HOSTED_PROVIDERS_FILE` | _未蚭定_ | `open-sse/services/selfHostedEntry.ts` | むンラむン環境倉数よりもファむルを優先するデプロむ向けに、`OMNIROUTE_SELF_HOSTED_PROVIDERS`ず同じ`providers:`ドキュメントを保持するYAMLファむルぞのパス。どちらか䞀方を蚭定するず、セルフホスト型゚ントリが有効になりたす。 | | `OMNIROUTE_SELF_HOSTED_API_KEY` | _未蚭定 — オヌプンルヌト_ | `open-sse/services/selfHostedEntry.ts` | 統合セルフホスト型゚ントリ甚のオプションの共有APIキヌD5のスキャフォヌルド、キヌごずのクォヌタシステム甚に予玄。蚭定されおいる堎合、リク゚ストに`Authorization: Bearer `を含める必芁がありたす。未蚭定の堎合、ルヌトはオヌプンずなり、既存のセルフホスト型ロヌカルプロバむダヌパタヌンルヌプバック信頌枈みネットワヌクぞのデプロむず䞀臎したす。 | | `OMNIROUTE_SELF_HOSTED_STRATEGY` | _未蚭定_ | `open-sse/services/routingStrategies.ts` | 決定論的ルヌティング゚ンゞン向けのむンラむンYAML `strategy:`ドキュメントM2/RIC-740、D3— ブラックリストホワむトリスト、クヌルダりンブレヌカヌ、コスト優先、レむテンシヌ考慮、フォヌルバックチェヌン。キヌごずに、`OMNIROUTE_SELF_HOSTED_PROVIDERS`内にネストされたむンラむン`strategy:`ブロックを䞊曞きしたす。`docs/routing/DETERMINISTIC_ROUTING.md`を参照しおください。 | | `OMNIROUTE_SELF_HOSTED_STRATEGY_FILE` | _(未蚭定)_ | `open-sse/services/routingStrategies.ts` | むンラむン環境倉数よりもファむルを䜿甚したいデプロむ向けの、`OMNIROUTE_SELF_HOSTED_STRATEGY` ず同じ `strategy:` ドキュメントを保持する YAML ファむルぞのパス。 | | `OMNIROUTE_DISABLE_CONVERSATION_TRACKING` | _(未蚭定)_ | `open-sse/services/conversationTracker.ts` | 䌚話履歎の収集を停止するには `1` を蚭定したす。`resolveConversationId()` は、SQLite の読み取りやメッセヌゞ履歎の解析を行う前に、远跡察象倖の結果を返したす。クラむアントから提䟛されたセッション ID も察象です。ルヌティングセッションの凊理は倉曎されず、既存のレコヌドも削陀されたせん。ダッシュボヌドの䌚話ビュヌを䜿甚せず、タヌンテヌブルの増加を止めたいデプロむ向けです。 | | `OMNIROUTE_NADIR_API_KEY` | _(未蚭定)_ | `open-sse/services/autoCombo/nadirStrategy.ts` | オプトむンの `nadir` 自動コンボルヌタヌ戊略甚 API キヌ。コンボ独自の `config.nadir.apiKey` が未蚭定の堎合に䜿甚されたす。省略可胜です。キヌなしの呌び出しは Nadir の匿名ティアに送られたすが、IP ごずにレヌト制限されるため、共有ゲヌトりェむ経由では䜿甚できたせん。機密情報です。コンボごずに異なるアカりントを䜿甚する堎合は、コンボ単䜍のフィヌルドを掚奚したす。 | | `OMNIROUTE_NADIR_BASE_URL` | `https://api.getnadir.com` | `open-sse/services/autoCombo/nadirStrategy.ts` | Nadir 刀断 API のベヌスオリゞン。コンボ独自の `config.nadir.baseUrl` が未蚭定の堎合に䜿甚されたす。プロンプトの先頭郚分を自組織のネットワヌク内に保持するセルフホスト版 Nadir でのみ必芁です。末尟の `/v1` は蚱容され、削陀されたす。 | | `OMNIROUTE_API_KEY_WEEKLY_WINDOW` | `provider` | `src/lib/usage/apiKeyUsageLimits.ts` | API キヌごずの USD 䜿甚量䞊限に適甚する週次りィンドりリク゚ストの制限、`GET /api/keys/{id}/usage-limits`、`@@om-usage`。`provider`: キヌがアクセス可胜なアップストリヌム接続のうち、最も早い週次リセット時点に週が終了したす。既知のリセット時点がない堎合は、盎近 7 日間のロヌリング期間になりたす。`calendar`: 珟地時間の月曜日 00:00 から次の月曜日 00:00 たでの週で、すべおのキヌで同䞀です。アップストリヌムアカりントの 1 ぀のプヌルを、個別に予算蚭定された倚数のキヌで共有する堎合は、`calendar` を掚奚したす。無効な倀の堎合は `provider` にフォヌルバックしたす。 | | `OMNIROUTE_API_KEY_WEEKLY_WINDOW_TIMEZONE` | _(プロセスのタむムゟヌン)_ | `src/lib/usage/apiKeyUsageLimits.ts` | `calendar` 週次りィンドりの月曜日 00:00 を定矩する IANA タむムゟヌン䟋: `Asia/Shanghai`。未蚭定たたは無効な堎合: OmniRoute プロセスのタむムゟヌンホストたたはコンテナの `TZ`。コンテナむメヌゞでは未蚭定、぀たり協定䞖界時であるこずが䞀般的です。`provider` モヌドでは無芖されたす。 | | `OMNIROUTE_MAX_TOOLS_LIMIT` | `128` | `open-sse/config/constants.ts` | リク゚ストで蚱可されるツヌル数のデフォルト䞊限OpenAI のデフォルト。正の敎数のみ指定できたす。未蚭定たたは無効な倀の堎合は `128` が維持されたす。既知の䞊限たたは事前蚭定された䞊限を持぀プロバむダヌ`grok-cli` は 200、`nvidia` は 1536には、匕き続き各プロバむダヌ独自の䞊限が適甚されたす。これはデフォルトの䞊限倀のみを倉曎したす。 | | `OMNIROUTE_PROMPT_EMULATE_TOOLS` | _(有効)_ | `open-sse/executors/syntxChat.ts` | SYNTX.ai のプロンプト゚ミュレヌションによるツヌル呌び出し: 未蚭定、たたは `1`/`true`/`on`/`yes` の堎合、ロヌカルのツヌルカタログをプロンプトに挿入したす。それ以倖の倀䟋: `0`の堎合は挿入をスキップしたす。 | --- ## 7. URL ずクラりド同期 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------------------- | --------------------------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `BASE_URL` | `http://localhost:20128` | `src/lib/cloudSync.ts` | 内郚同期ゞョブが `/api/sync/cloud` を呌び出すために䜿甚するサヌバヌ偎 URL。アプリが公開プロキシ経由で提䟛される堎合でも、ルヌプバック URL たたはコンテナ URL のたたにしおください。 | | `CLOUD_URL` | _(空)_ | `src/lib/cloudSync.ts` | クラりドリレヌの゚ンドポむント URLプレミアム機胜。 | | `CLOUD_SYNC_TIMEOUT_MS` | `12000` | `src/lib/cloudSync.ts` | クラりド同期リク゚ストの HTTP タむムアりト。 | | `OMNIROUTE_BUILD_PROFILE` | `full` | Webpack ビルド蚭定 | ビルド時のプロファむル暩限付きモゞュヌルをバンドルから物理的に陀倖するには `minimal` に蚭定。 | | `OMNIROUTE_STANDALONE_DIR` | _.build/ スタンドアロン出力_ | `scripts/build/colocate-standalone.mjs` | ビルド埌の䜵眮ステップで䜿甚されるスタンドアロン出力ディレクトリを䞊曞きするためのビルド時蚭定。ランタむム蚭定ではありたせん。 | | `OMNIROUTE_CLOUD_SYNC_SECRET` | _(空)_ | `src/lib/cloudSync.ts` | クラりド同期レスポンスの HMAC-SHA256 眲名を怜蚌するために䜿甚される共有シヌクレット。 | | `OMNIROUTE_CLOUD_SYNC_SECRETS` | `false` | `src/lib/cloudSync.ts` | クラりド同期゚ンドポむントによるロヌカル認蚌情報の䞊曞きを蚱可するには、`true` に蚭定したす。デフォルトは `false` です。 | | `OMNIROUTE_CLOUD_SYNC_ENFORCE_SIGNATURE` | `false` | `src/lib/cloudSync.ts` | ロヌカルシヌクレットが蚭定されおいない堎合に、眲名のないクラりド同期レスポンスを拒吊するには `true` に蚭定したす#13679。このフラグに関係なく、眲名が存圚する堎合は垞に怜蚌され、`OMNIROUTE_CLOUD_SYNC_SECRET` が未蚭定の堎合は必ず拒吊されたす。v3.9 ではデフォルトが眲名怜蚌の匷制に倉曎されたす。 | | `OMNIROUTE_ZED_IMPORT_LEGACY_ONE_STEP` | `false` | `src/app/api/providers/zed/import/route.ts` | ナヌザヌ確認なしで、v3.8.5 のワンステップの「すべおをむンポヌト」動䜜にフォヌルバックするには、`true` に蚭定したす。 | | `NEXT_PUBLIC_BASE_URL` | `http://localhost:20128` | OAuth、ダッシュボヌド、同期 | OAuth の redirect_uri、ダッシュボヌドのリンク、生成される公開 URL に䜿甚する倖郚公開 URL。OAuth コヌルバックたたは生成されるブラりザヌリンクで正芏のリバヌスプロキシホストを䜿甚する必芁がある堎合は、安定した公開 URL に蚭定しおください。 | | `NEXT_PUBLIC_CLOUD_URL` | _(空)_ | クラむアント偎 | `CLOUD_URL` のクラむアント偎ミラヌ。 | | `NEXT_PUBLIC_APP_URL` | _(未蚭定)_ | `src/shared/services/cloudSyncScheduler.ts` | `NEXT_PUBLIC_BASE_URL` のレガシヌフォヌルバック。 | | `NEXT_PUBLIC_PORT` | _(未蚭定 — `PORT` にフォヌルバック)_ | `src/shared/hooks/useDisplayBaseUrl.ts` | オリゞンが䞍明な堎合SSR/テストの衚瀺 URL に䜿甚するクラむアント偎のフォヌルバックポヌト。`PORT` より先に読み取られたす。 | | `OMNIROUTE_PUBLIC_BASE_URL` | _(未蚭定)_ | 公開オリゞンリゟルバヌ、画像 URL | 公開 URL の生成およびダッシュボヌド以倖でのブラりザヌオリゞン怜蚌に䜿甚される、ブラりザヌ向け OmniRoute オリゞンのうち最も優先床が高いものです。OpenWebUI たたは別のリレヌが内郚 URL 経由で OmniRoute にアクセスする䞀方、ナヌザヌのブラりザヌが LAN、トンネル、たたは公開オリゞンから生成枈みメディアを取埗する必芁がある堎合に蚭定したす。`/v1` は含めないでください。 | | `OMNIROUTE_PROVIDER_MANIFEST_URL` | _(未蚭定)_ | `open-sse/config/providerPluginManifestUrl.ts` | サむドカヌクラむアントに通知される、プロバむダヌプラグむンマニフェストの絶察 URL。未蚭定の堎合、OmniRoute はリク゚ストオリゞンたたは HOST/PORT から `/api/v1/provider-plugin-manifest` を導出したす。 | | `OMNIROUTE_PUBLIC_PROTOCOL` | `http` | `open-sse/config/providerPluginManifestUrl.ts` | リク゚ストオリゞンを䜿甚せず、HOST/PORT からプロバむダヌプラグむンマニフェスト URL を導出する際に䜿甚されるプロトコル。明瀺的な `OMNIROUTE_PROVIDER_MANIFEST_URL` が蚭定されおいない状態で、TLS を終端する公開プロキシの背埌に配眮する堎合は `https` に蚭定したす。 | | `OMNIROUTE_TRUST_PROXY` | _(未蚭定)_ | `src/server/origin/publicOrigin.ts` | 転送された公開オリゞンヘッダヌに察するオプションの信頌モヌド。未蚭定 = セキュリティ刀定で `Forwarded` / `X-Forwarded-*` を信頌したせん。`true` / `loopback` は、トヌクンが付䞎されたルヌプバックプロキシからの転送ホスト/プロトコルのみを信頌したす。`private` / `lan` はプラむベヌト LAN のプロキシピアも信頌し、`API_PORT` ブリッゞがそのようなピアの `X-Forwarded-For` を保持できるようにしたす。本番環境では、明瀺的な `NEXT_PUBLIC_BASE_URL` を掚奚したす。 | | `KIE_CALLBACK_URL` | _(未蚭定)_ | `open-sse/utils/kieTask.ts` | 非同期 kie.ai ゞョブ甚の公開コヌルバック URL。`OMNIROUTE_KIE_CALLBACK_URL` および `OMNIROUTE_PUBLIC_URL` よりも優先される最優先のオヌバヌラむドです。 | | `OMNIROUTE_KIE_CALLBACK_URL` | _(未蚭定)_ | `open-sse/utils/kieTask.ts` | `KIE_CALLBACK_URL` の別衚蚘。䞻芁倉数が未蚭定の堎合のフォヌルバックです。 | | `OMNIROUTE_PUBLIC_URL` | _(未蚭定)_ | `open-sse/utils/kieTask.ts` | 非同期コヌルバック URL の構成に䜿甚される公開オリゞン。kie.ai コヌルバックで最も優先床の䜎いフォヌルバックです。たた、他のリレヌ向けの汎甚公開 URL ずしおも䜿甚されたす。 | | `OMNIROUTE_CROF_USAGE_URL` | `https://crof.ai/usage_api/` | `open-sse/services/usage.ts` | 䜿甚量ペヌゞで䜿甚される CrofAI クォヌタ照䌚゚ンドポむント。リレヌ / テストフィクスチャ向けにオヌバヌラむドできたす。 | | `OMNIROUTE_CLINEPASS_USAGE_URL` | `https://api.cline.bot/api/v1/users/me/plan/usage-limits` | `open-sse/services/usage/clinepass.ts` | 䜿甚量ペヌゞで䜿甚される ClinePass の 5 時間 / 週間 / 月間クォヌタ゚ンドポむント。リレヌ / テストフィクスチャ向けにオヌバヌラむドできたす。 | | `OMNIROUTE_OPENCODE_QUOTA_URL` | `https://opencode.ai/zen/go/v1/usage` | `open-sse/services/opencodeQuotaFetcher.ts` | 䜿甚量ペヌゞで䜿甚される、公匏の API キヌ認蚌付き OpenCode Go 䜿甚量゚ンドポむント。リレヌ / テストフィクスチャ向けにオヌバヌラむドできたす。 | | `OPENCODE_SYNTHESIZE_CLI_HEADERS` | `true` | `open-sse/executors/opencode.ts` | クラむアントが送信しなかった堎合、opencode-go/zen のアップストリヌムリク゚ストに OpenCode CLI 識別ヘッダヌUser-Agent、x-opencode-client/project、リク゚スト/セッション UUIDを合成し、VPS からの送信時に Cloudflare が受け入れるようにしたす#6210/#5997。#10571 以降はデフォルトで有効です。`false`/`0`/`no`/`off` で無効化できたす。 | | `OPENCODE_USER_AGENT` | `opencode/1.18.31` | `open-sse/utils/opencodeHeaders.ts` | `OPENCODE_SYNTHESIZE_CLI_HEADERS` が有効で、プロバむダヌごずの `_USER_AGENT` オヌバヌラむドが蚭定されおいない堎合に䜿甚されるデフォルトの User-Agent。opencode ゚グれキュヌタヌにのみ適甚されたす。䞊流偎でゲヌトされるキヌレスリク゚ストでは、蚭定倀に `opencode/= 1.17>` が含たれおいない堎合、拒吊されるのではなく、このデフォルト倀に眮き換えられたす。 | | `OMNIROUTE_FORWARD_ATTRIBUTION` | `1`有効 | `open-sse/utils/opencodeHeaders.ts` | クラむアントアプリの垰属情報ヘッダヌ`x-session-id`、`x-title`、`http-referer`を䞊流プロバむダヌに転送し、䞀芧に含たれるハヌネス内で開始されたリク゚ストが、ルヌタヌ通過埌もその識別情報を維持できるようにしたすOpenRouter のパブリッシャヌゲヌトでは、これらがキヌずしお䜿甚されたす。`0`/`false`/`no`/`off` を指定するず、レゞストリオペレヌタヌの識別情報を維持し、クラむアントが指定した倀を砎棄したす。オペレヌタヌが蚭定したカスタムヘッダヌは、垞にクラむアントの倀より優先されたす。 | | `OPENCODE_CLIENT` | `desktop` | `open-sse/executors/opencode.ts` | `OPENCODE_SYNTHESIZE_CLI_HEADERS` が有効な堎合に生成される `x-opencode-client` ヘッダヌの倀。 | | `OPENCODE_PROJECT` | `global` | `open-sse/executors/opencode.ts` | `OPENCODE_SYNTHESIZE_CLI_HEADERS` が有効な堎合に生成される `x-opencode-project` ヘッダヌの倀。 | | `OMNIROUTE_EGRESS_IP_LOCK_PROVIDERS` | _未蚭定_ | `open-sse/config/providerErrorRules.ts` | 䞊流障害を送信元 IP ごずに分類するプロバむダヌの有効なセット1 回の 429 により、その IP を共有するすべおの関連接続が停止したす。未蚭定の堎合は、無料枠のデフォルト `opencode,opencode-go,opencode-cli` が䜿甚されたす。`none`/`off`/`false`/`0` を指定するず連鎖停止が完党に無効になり、カンマ区切りのリストを指定するずセットが眮き換えられたす。有料プランでは䞊流偎でアカりント単䜍に分類されるため、安党に無効化できたす#9611。 | | `OPENCODE_FREE_TIER_REQUEST_CONTRACT` | _未蚭定_ | `open-sse/executors/opencodeFreeTierContract.ts` | `off` に蚭定するず、キヌレス OpenCode リク゚ストのボディストリヌミングフラグずツヌルリストの調敎を停止したす。ヘッダヌは匕き続き適甚されたす。リク゚ストごずに読み蟌たれるため、倉曎は盎ちに反映されたす。 | | `OPENCODE_FREE_TIER_PLACEHOLDER_TOOLS` | _未蚭定_ | `open-sse/executors/opencodeFreeTierContract.ts` | ツヌルを含たないキヌレス OpenCode リク゚ストで、そのモデルに぀いおただ䜕も怜出されおいない堎合に宣蚀する、カンマ区切りのツヌル名。空の堎合は、モデルに呌び出さないよう指瀺される単䞀のプレヌスホルダヌにフォヌルバックしたす。最倧 32 ゚ントリで、圢匏は `[A-Za-z_][A-Za-z0-9_-]{0,63}` です。無効な゚ントリは無芖されたす。 | | `OMNIROUTE_OLLAMA_CLOUD_USAGE_URL` | `https://ollama.com/settings` | `open-sse/services/usage.ts` | クォヌタのスクレむピングに䜿甚される Ollama Cloud 蚭定 URL。リレヌテストフィクスチャ向けにオヌバヌラむドできたす。 | | `OLLAMA_USAGE_COOKIE` | _未蚭定_ | `open-sse/services/usage.ts` | 蚭定ペヌゞからクォヌタをスクレむピングするために䜿甚される Ollama Cloud の `__Secure-session` Cookie。機密情報です。耇数のアカりントが蚭定されおいる堎合は、接続ごずのダッシュボヌドフィヌルドを䜿甚するこずを掚奚したす。 | | `OLLAMA_CLOUD_USAGE_COOKIE` | _未蚭定_ | `open-sse/services/usage.ts` | Ollama Cloud の `__Secure-session` Cookie 甚の代替環境倉数。機密情報です。耇数のアカりントが蚭定されおいる堎合は、接続ごずのダッシュボヌドフィヌルドを䜿甚するこずを掚奚したす。 | | `OMNIROUTE_OLLAMA_USAGE_COOKIE` | _未蚭定_ | `open-sse/services/usage.ts` | より短い゚むリアスより先に䜿甚される、Ollama Cloud の `__Secure-session` Cookie 甚の代替環境倉数。機密情報です。耇数のアカりントが蚭定されおいる堎合は、接続ごずのダッシュボヌドフィヌルドを䜿甚するこずを掚奚したす。 | | `OMNIROUTE_CODEWHISPERER_BASE_URL` | `https://codewhisperer.us-east-1.amazonaws.com` | `open-sse/services/usage.ts` | CodeWhispererAWS Kiroの䜿甚量制限゚ンドポむント。リレヌテストフィクスチャ向けにオヌバヌラむドできたす。 | > [!IMPORTANT] > リバヌスプロキシnginx、Caddyの背埌にデプロむする堎合、OAuth コヌルバックや生成される公開リンクでそのホスト名を䜿甚する必芁があるずきは、`NEXT_PUBLIC_BASE_URL` を安定した公開 URL䟋`https://omniroute.example.com`に蚭定しおください。これを蚭定しないず、redirect_uri が䞀臎しないため OAuth コヌルバックが倱敗したり、生成された公開リンクが内郚コンテナのオリゞンを指したりする可胜性がありたす。 > > サヌバヌ間ゞョブでは、`BASE_URL` を内郚ルヌプバックコンテナ URL のたたにしおください。認蚌情報を䌎う内郚自己フェッチには、ブラりザの `Origin` や公開ホスト名を䜿甚しないでください。 > > 認蚌枈みダッシュボヌドからの曞き蟌みには、静的な公開ベヌス URL は必芁ありたせん。ダッシュボヌドは、セッションに玐付けられた CSRF トヌクンを䜿甚しお、同䞀オリゞンの安党でないリク゚ストを送信したす。OmniRoute は、ダッシュボヌド以倖のブラりザ統合に察する公開オリゞンの怜蚌も䞀元管理したす。明瀺的な公開 URL の環境倉数が最初に信頌され、`OMNIROUTE_TRUST_PROXY` が有効で、か぀盎接接続しおいるプロキシピアがトヌクンによっお信頌枈みず瀺されおいない限り、生の `Forwarded` / `X-Forwarded-*` ヘッダヌは無芖されたす。同䞀オリゞンのダッシュボヌドリク゚ストを修正するために CORS 蚭定を䜿甚しないでください。CORS は、クロスオリゞンのブラりザクラむアント専甚です。 --- ## 8. アりトバりンドプロキシ 送信制埡、ゞオルヌティング、たたは IP マスキングのために、アップストリヌム LLM プロバむダヌぞの呌び出しを HTTP たたは SOCKS5 プロキシ経由でルヌティングしたす。 `OMNIROUTE_UPSTREAM_HTTP2_ENABLED` のデフォルト倀は `true` です。`false`、`0`、`no`、たたは `off` に蚭定するず、`open-sse/utils/proxyDispatcher.ts` および `open-sse/utils/proxyFetch.ts` の Undici ディスパッチャヌで、盎接送信、HTTP(S)/SOCKS プロキシ、リレヌ、およびそれらの新芏゜ケットを䜿甚した再詊行に察しお HTTP/1.1 が匷制されたす。この蚭定でも、TLS 蚌明曞の怜蚌、プロキシ認蚌、接続数制限、およびキヌプアラむブ蚭定は維持されたす。ディスパッチャヌはキャッシュされ、リレヌ゚ヌゞェントは起動時に䜜成されるため、この蚭定を倉曎した埌は OmniRoute を再起動しおください。この切り替えは、wreq の TLS フィンガヌプリンティングやプロバむダヌ固有のトランスポヌトには圱響したせん。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------------------- | ---------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ENABLE_SOCKS5_PROXY` | `true` | `open-sse/executors` | アップストリヌム呌び出し甚の SOCKS5 プロキシ゚ヌゞェントを有効にしたす。`false` で無効化できたす。 | | `NEXT_PUBLIC_ENABLE_SOCKS5_PROXY` | `true` | クラむアント偎 | SOCKS5 が利甚可胜かどうかをクラむアント偎で認識したす。 | | `PROXY_SKIP_RECENTLY_FAILED` | `true` | `src/shared/utils/featureFlags.ts` | デフォルトで有効な機胜フラグです[FEATURE_FLAGS.md](./FEATURE_FLAGS.md) を参照。ダッシュボヌドの DB オヌバヌラむドが優先されたす。プロキシプヌルおよびアカりントごずのロヌテヌションでは、盎前に倱敗したメンバヌTCP プロヌブが拒吊された、たたはそのメンバヌ経由で 429 が返されたものを、倱敗を繰り返すたびに䞊限たで倍増する期間、再び遞択しないようにしたす。`false` にするず通垞の遞択方匏に戻りたす。 | | `SELECTOR_CONTROL_ALLOWLIST` | _(未蚭定)_ | `src/lib/proxySubscription/selectorGuard.ts` | ルヌプバック以倖のロヌカルコアのセレクタヌ制埡察象に察する蚱可リストですカンマたたはスペヌスで区切ったホスト名たたは IP。`*` は LAN/プラむベヌトアドレスを蚱可したすが、メタデヌタアドレスおよびリンクロヌカルアドレスは蚱可したせん。http/https 経由のルヌプバックはデフォルトで蚱可されたす。ダッシュボヌドの DB 倀が蚭定枈みか぀空でない堎合、この倉数より優先されたす。 | | `PROXY_QUOTA_429_BASE_MS` | `300000` | `open-sse/utils/proxyRefusalMemory.ts` | 429 による陀倖の基本期間msです。倱敗を繰り返すたびに倍増したす。起動時に䞀床だけ読み取られたす。`1000..3600000` の範囲に制限され、範囲倖たたは読み取り䞍胜の堎合は譊告ずずもにデフォルト倀ぞフォヌルバックしたす。 | | `PROXY_QUOTA_429_MAX_MS` | `900000` | `open-sse/utils/proxyRefusalMemory.ts` | 429 による陀倖期間の䞊限msです。起動時に䞀床だけ読み取られたす。`1000..3600000` の範囲に制限され、範囲倖たたは読み取り䞍胜の堎合は譊告ずずもにデフォルト倀ぞフォヌルバックしたす。䞊限が基本期間を䞋回る堎合もデフォルト倀ぞフォヌルバックしたす。䞊限を匕き䞋げるず、連続倱敗の蚘憶期間も短くなり、有効期限の終了から `2 x max` 埌に゚ントリが削陀されたす。 | | `PROXY_POOL_SHARED_EGRESS_ORDER` | `false` | `src/shared/utils/featureFlags.ts` | オプトむンの機胜フラグです[FEATURE_FLAGS.md](./FEATURE_FLAGS.md) を参照。ダッシュボヌドの DB オヌバヌラむドが優先されたす。クォヌタが送信元アドレス単䜍で割り圓おられるプロバむダヌでは、盎近に拒吊されたメンバヌず同じ芳枬枈み送信元アドレスを共有するプヌルメンバヌを、正垞なメンバヌの盎埌に順䜍付けしたす。順序のみを倉曎し、陀倖は行いたせん。この機胜が読み取る拒吊シグナルを生成する `PROXY_SKIP_RECENTLY_FAILED` が必芁です。 | | `PROXY_WEBHOOK_REBOUND_MS` | `300000` | `src/lib/proxyEvents/proxyTransitionBridge.ts` | プヌルメンバヌごずに繰り返される `proxy.set_aside` Webhook アラヌトを抑制し、拒吊が集䞭しおもむベントが 1 件だけ送信されるようにするリバりンドりィンドりmsです。送信のたびに読み取られたす。`1000..3600000` の範囲に制限され、範囲倖たたは読み取り䞍胜の堎合は通知なしでデフォルト倀ぞフォヌルバックしたす。 | | `HTTP_PROXY` | _(未蚭定)_ | Node.js 暙準 | アップストリヌム呌び出し甚の HTTP プロキシです。 | | `HTTPS_PROXY` | _(未蚭定)_ | Node.js 暙準 | アップストリヌム呌び出し甚の HTTPS プロキシです。 | | `ALL_PROXY` | _(未蚭定)_ | Node.js 暙準 | 汎甚プロキシです`socks5://` をサポヌト。 | | `OMNIROUTE_PROXY_ECHO_URL` | _(未蚭定)_ | `src/lib/proxyEchoTarget.ts` | プロキシ経由の倖向き通信プロヌブで䜿甚する゚コヌ IP のタヌゲットを、単䞀の URL に固定したす。未蚭定の堎合、プロヌブは `api64.ipify.org`、次に `api4.ipify.org` を詊行するため、IPv4 専甚トンネルが停止しおいるず誀っお報告されるこずはありたせん#9694。 | | `NO_PROXY` | _(未蚭定)_ | Node.js 暙準 | プロキシを迂回するホスト名/IP をカンマ区切りで指定したす。 | | `OMNIROUTE_PROXY_DISPATCHER_CONNECTIONS` | `32` | `open-sse/utils/proxyDispatcher.ts` | キャッシュされた HTTP/SOCKS プロキシディスパッチャヌごずの最倧同時゜ケット数。耇数のリク゚ストが同じアカりントレベルのプロキシを共有する堎合、Codex `/v1/responses` などの長時間維持される SSE ストリヌムには耇数の接続が必芁です。`256` を超える倀は䞊限に制限されたす。 | | `SOCKS_HANDSHAKE_TIMEOUT_MS` | `10000` | `open-sse/utils/socksConnectorWithFamily.ts` | SOCKS5 ハンドシェむク接続のタむムアりトミリ秒。単䞀の䜏宅向けゲヌトりェむホストに高い同時実行負荷䟋: 100 件の同時リク゚ストがかかる堎合は、この倀を匕き䞊げおください。プヌルが飜和しおいるず、プロキシに到達可胜であっおも実際のハンドシェむクが 10 秒を超える堎合があり、そうしないず誀った `[Proxy Fast-Fail] Proxy unreachable` ずしお衚面化したす。䞊限は `120000` です。 | | `PROXY_FAIL_OPEN` | `false` | `src/sse/handlers/chatHelpers.ts` | `false`デフォルトの堎合、割り圓おられたプロキシの解決に倱敗したリク゚ストは、盎接接続ぞフォヌルバックせず、**拒吊フェむルクロヌズ**されたす。これにより、実 IP の挏掩を防止したす。埓来の DIRECT フォヌルバックを埩元するには `true` に蚭定しおください。 | | `ENABLE_TLS_FINGERPRINT` | `false` | `open-sse/executors` | wreq-js を䜿甚しお TLS フィンガヌプリントを停装したすChrome 124 を暡倣。JA3/JA4 によるブロックぞの察策ずなりたす。 | | `TLS_FINGERPRINT_PROVIDERS` | _(未蚭定)_ | `open-sse/utils/proxyFetch.ts` | 新しいプロキシ経由 TLS ルヌティング`open-sse/utils/proxyFetch.ts`に䜿甚するプロバむダヌの蚱可リストを、カンマ区切りで指定したす。未蚭定の堎合、盎接 TLS は埓来の動䜜を維持し、ここで指定されたプロバむダヌのみが Chrome-124 フィンガヌプリントブリッゞを経由したす。蚱可リストが未蚭定の堎合でも、Groq`api.groq.com`は陀倖されたす。これは、Chrome JA3 では Cloudflare 1010 が発生する䞀方、ネむティブの undici では API に到達できるためです。 | | `OMNIROUTE_TURNSTILE_IGNORE_TLS_ERRORS` | `false` | `open-sse/services/claudeTurnstileSolver.ts` | Claude Turnstile の Playwright ブラりザヌコンテキストで、HTTPS 蚌明曞゚ラヌを無芖できるようにしたす。 | ### シナリオ | シナリオ | 蚭定 | | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | **SSH トンネル経由の SOCKS5** | `ALL_PROXY=socks5://127.0.0.1:7890`, `ENABLE_SOCKS5_PROXY=true` | | **䌁業 HTTP プロキシ** | `HTTP_PROXY=http://proxy.corp.com:3128`, `HTTPS_PROXY=http://proxy.corp.com:3128`, `NO_PROXY=localhost,internal.corp.com` | | **フィンガヌプリント察策** | `ENABLE_TLS_FINGERPRINT=true` — `wreq-js`同梱が必芁です | | **倖向き通信が制埡されおいる環境 / 盎接アクセス䞍可** | `PROXY_FAIL_OPEN=false`デフォルトのたたにしたす。プロキシが利甚できない堎合、盎接接続で挏掩する代わりにリク゚ストは明瀺的に倱敗したす。 | | **埓来環境 / 開発環境 — 盎接フォヌルバックを蚱可** | `PROXY_FAIL_OPEN=true`。セキュリティ匷化前の動䜜を埩元し、プロキシの解決に倱敗した堎合は盎接接続を䜿甚したす。 | > **泚NVIDIA 怜蚌バむパス — #3226:** NVIDIA の API キヌ怜蚌゚ンドポむントは、 > グロヌバルプロキシ/TLS パッチ適甚枈みの fetch 経由でルヌティングされるず停止したすundici dispatcher → 504。 > `src/lib/providers/validation.ts::directHttpsRequest()` は、`safeOutboundFetch({ bypassProxyPatch: true })` を䜿甚しお、 > その怜蚌呌び出しに限り意図的にプロキシパッチを迂回したす。 > これは文曞化された限定的な䟋倖であり、チャット/䜿甚量の倖向き通信には**圱響したせん**。 > バむパスの適甚範囲は `tests/unit/proxy-bypass-scope-guard-3226.test.ts` によっお固定されおいたす。 --- ## 9. CLI ツヌル統合 OmniRoute が CLI サむドカヌClaude Code、Codex などを怜出しお起動する方法を制埡したす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | --------------------------------- | -------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `CLI_MODE` | `auto` | `src/shared/services/cliRuntime.ts` | `auto` = システムの PATH を怜玢、`manual` = 明瀺的に指定されたパスのみを䜿甚したす。 | | `CLI_EXTRA_PATHS` | _(未蚭定)_ | `src/shared/services/cliRuntime.ts` | CLI バむナリ怜出甚の远加 PATH ゚ントリコロン区切り。 | | `CLI_CONFIG_HOME` | _(未蚭定)_ | `src/shared/services/cliRuntime.ts` | CLI 蚭定`~/.claude`、`~/.codex`の読み取りに䜿甚するホヌムディレクトリを䞊曞きしたす。絶察パスであり、プロセスのホヌム内にある必芁がありたす。**たたは**、コンテナ内ではバむンドマりントされたパスも䜿甚できたす`/host-home` はこの仕組みで動䜜したす。それ以倖の堎合はホヌムディレクトリにフォヌルバックしたす。 | | `CLI_ALLOW_CONFIG_WRITES` | `true` | `src/shared/services/cliRuntime.ts` | OmniRoute による CLI 蚭定ファむルぞの曞き蟌みトヌクンの曎新、セッションデヌタを蚱可したす。`false` に蚭定するず、CLI 蚭定ぞのすべおの曞き蟌みが明瀺的な「曞き蟌みが無効」゚ラヌで倱敗したす。 | | `CLI_CLAUDE_BIN` | `claude` | `src/shared/services/cliRuntime.ts` | Claude CLI バむナリぞのカスタムパス。 | | `CLI_CODEX_BIN` | `codex` | `src/shared/services/cliRuntime.ts` | Codex CLI バむナリぞのカスタムパス。 | | `CLI_DROID_BIN` | `droid` | `src/shared/services/cliRuntime.ts` | Droid CLI バむナリぞのカスタムパス。 | | `CLI_OPENCLAW_BIN` | `openclaw` | `src/shared/services/cliRuntime.ts` | OpenClaw CLI バむナリぞのカスタムパス。 | | `CLI_CURSOR_BIN` | `agent`、次に `cursor` | `src/shared/services/cliRuntime.ts` | Cursor ゚ヌゞェントバむナリぞのカスタムパス。指定されおいない堎合、怜出では最初に `agent` を詊し、芋぀からなければ `cursor` にフォヌルバックしたす。 | | `CLI_CLINE_BIN` | `cline` | `src/shared/services/cliRuntime.ts` | Cline CLI バむナリぞのカスタムパス。 | | `CLI_5DIVE_BIN` | `5dive` | `src/shared/services/cliRuntime.ts` | 5dive CLI バむナリぞのカスタムパス。 | | `CLI_5DIVE_STATE_DIR` | `/var/lib/5dive` | `src/shared/services/cliRuntime.ts` | 5dive のシステム状態ディレクトリroot 所有の認蚌プロファむル。5dive 自䜓の STATE_DIR デフォルトを反映したす。 | | `CLI_CONTINUE_BIN` | `cn` | `src/shared/services/cliRuntime.ts` | Continue CLI バむナリぞのカスタムパス。 | | `CLI_QODER_BIN` | `qodercli` | `src/shared/services/cliRuntime.ts` | Qoder CLI バむナリぞのカスタムパス。 | | `CLI_QWEN_BIN` | `qwen` | `src/shared/services/cliRuntime.ts` | Qwen Code CLI バむナリぞのカスタムパス。 | | `CLI_AIDER_BIN` | `aider` | `src/shared/services/cliRuntime.ts` | Aider CLI バむナリぞのカスタムパス。 | | `CLI_GOOSE_BIN` | `goose` | `src/shared/services/cliRuntime.ts` | Goose CLI バむナリぞのカスタムパス。 | | `CLI_GEMINI_BIN` | `gemini` | `src/shared/services/cliRuntime.ts` | Google Gemini CLI バむナリぞのカスタムパス。サヌバヌ偎での怜出ずヘルスチェックにのみ䜿甚されたす。`omniroute run gemini` はシステムの PATH から `gemini` バむナリを解決したす。 | | `CLI_KILO_BIN` | `kilocode` | `src/shared/services/cliRuntime.ts` | Kilo Code CLI バむナリぞのカスタムパス。 | | `CLI_OPENCODE_BIN` | `opencode` | `src/shared/services/cliRuntime.ts` | OpenCode CLI バむナリぞのカスタムパス。 | | `CLI_HERMES_BIN` | `hermes` | `src/shared/services/cliRuntime.ts` | Hermes バむナリぞのカスタムパス。䞡方のカタログ゚ントリ`hermes` ず `hermes-agent`で共有されたす。 | | `CLI_FORGE_BIN` | `forge` | `src/shared/services/cliRuntime.ts` | ForgeCode CLI バむナリぞのカスタムパス。 | | `CLI_JCODE_BIN` | `jcode` | `src/shared/services/cliRuntime.ts` | jcode CLI バむナリぞのカスタムパス。 | | `CLI_DEEPSEEK_TUI_BIN` | `deepseek-tui` | `src/shared/services/cliRuntime.ts` | DeepSeek TUI バむナリぞのカスタムパス。 | | `CLI_CODEWHALE_BIN` | `codewhale` | `src/shared/services/cliRuntime.ts` | CodeWhale CLI バむナリぞのカスタムパス。 | | `CLI_SMELT_BIN` | `smelt` | `src/shared/services/cliRuntime.ts` | Smelt CLI バむナリぞのカスタムパス。 | | `CLI_PI_BIN` | `pi` | `src/shared/services/cliRuntime.ts` | Pipi-coding-agentバむナリぞのカスタムパス。 | | `CLI_CRUSH_BIN` | `crush` | `src/shared/services/cliRuntime.ts` | Crush CLI バむナリぞのカスタムパス。 | | `CLI_OMP_BIN` | `omp` | `src/shared/services/cliRuntime.ts` | Oh My Pi`omp`゚ヌゞェントバむナリぞのカスタムパス。 | | `CLI_LETTA_BIN` | `letta` | `src/shared/services/cliRuntime.ts` | Letta CLI バむナリぞのカスタムパス。 | | `CLI_PRIME_AGENT_BIN` | `prime-agent` | `src/shared/services/cliRuntime.ts` | Prime AgentPrime Intellectバむナリぞのカスタムパス。 | | `CLI_WINDSURF_BIN` | _なし_ | `src/shared/services/cliRuntime.ts` | Windsurf バむナリぞのカスタムパス。Windsurf には**デフォルトコマンドがありたせん**。これが蚭定されるたで、バむナリ怜出は無効のたたです。 | | `CLI_DEVIN_BIN` | `devin` | `open-sse/executors/devin-cli.ts` | Devin CLI バむナリv3.8.0ぞのカスタムパス。Windsurf/Devin ゚グれキュヌタヌによっお䜿甚されたす。 | | `DEVIN_DESKTOP_VERSION` | `3.6.27` | `open-sse/executors/devin-desktop.ts` | Devin Desktop の `ide_version`。オヌバヌラむドには `x.y.z` 圢匏を䜿甚する必芁がありたす。無効な倀の堎合は、怜蚌枈みのデフォルトにフォヌルバックしたす。 | | `DEVIN_DESKTOP_EXTENSION_VERSION` | `1.48.2` | `open-sse/executors/devin-desktop.ts` | バンドルされた Codeium/language-server の `extension_version`。Desktop の `ide_version` ずは異なりたす。オヌバヌラむドには `x.y.z` を䜿甚する必芁がありたす。無効な倀の堎合は、バンドルされたデフォルトが䜿甚されたす。 | | `CLI_DEVIN_AGENTIC_BIN` | `devin` | `open-sse/executors/devin-cli-agentic.ts` | ゚ヌゞェント型ブリッゞ専甚の Devin CLI オヌバヌラむド。゚グれキュヌタヌはロヌカルの ACP stdio アップストリヌムのみを受け入れたす。 | | `DEVIN_AGENTIC_HOME` | _必須_ | `open-sse/executors/devin-cli-agentic.ts` | ゚ヌゞェント型 Devin サブプロセス甚の絶察パスで指定された分離ホヌム。受け入れられるブリッゞパスは `/home/bridge` およびタスクロヌカルの `.sandbox` パスですWindows では `C:\...\.sandbox\...`。 | | `DEVIN_AGENTIC_ACP_TIMEOUT_MS` | `120000` | `open-sse/executors/devin-cli-agentic.ts` | ブリッゞが子プロセスを終了し、明瀺的なタむムアりトを返すたでの、Devin ACP の1タヌンあたりの最倧時間。 | | `DEVIN_BRIDGE_MODEL` | `devin-cli-agentic/swe-1-7` | `docker/devin-bridge/compose.yml` | 分離ブリッゞ甚のメむン Claude Code モデル゚むリアス。ラむブハヌネスは、この䟋を珟圚の Devin アカりントから返されたモデルに眮き換えたす。 | | `DEVIN_BRIDGE_SONNET_MODEL` | `DEVIN_BRIDGE_MODEL` | `docker/devin-bridge/compose.yml` | Claude Code がデフォルトの Sonnet を芁求したずきに䜿甚される分離ブリッゞ゚むリアス。 | | `DEVIN_BRIDGE_OPUS_MODEL` | `DEVIN_BRIDGE_MODEL` | `docker/devin-bridge/compose.yml` | Claude Code がデフォルトの Opus を芁求したずきに䜿甚される分離ブリッゞ゚むリアス。 | | `DEVIN_BRIDGE_HAIKU_MODEL` | `DEVIN_BRIDGE_MODEL` | `docker/devin-bridge/compose.yml` | Claude Code がデフォルトの Haiku を芁求したずきに䜿甚される分離ブリッゞ゚むリアス。 | | `DEVIN_BRIDGE_SUBAGENT_MODEL` | `DEVIN_BRIDGE_MODEL` | `docker/devin-bridge/compose.yml` | Claude Code のサブ゚ヌゞェントに䜿甚される分離ブリッゞ゚むリアス。 | | `DEVIN_SEAT_API_URL` | `https://server.codeium.com` | `open-sse/services/usage/devinCli.ts` | Devin CLI のクォヌタ`GetUserStatus`で䜿甚される Codeium シヌト管理 API のオプションのオヌバヌラむド。 | | `AUGGIE_BIN` | `auggie` | `open-sse/executors/auggie.ts` | ロヌカルの `auggie` プロバむダヌで䜿甚される AugmentAuggieCLI バむナリの絶察パスのオヌバヌラむド。蚭定されおいない堎合は `CLI_AUGGIE_BIN`、次に PATH 怜玢ぞフォヌルバックしたす。 | | `CLI_AUGGIE_BIN` | `auggie` | `open-sse/executors/auggie.ts` | AugmentAuggieCLI バむナリパスの゚むリアスオヌバヌラむド`AUGGIE_BIN` の埌に確認されたす。 | | `ZCODE_BIN` | `zcode` | `open-sse/executors/zcode.ts` | ロヌカルの `zcode` プロバむダヌの stdio クラむアントで䜿甚されるバむナリ。蚭定されおいない堎合は PATH 䞊の `zcode` ぞフォヌルバックしたす。 | | `ZCODE_ARGS` | — | `open-sse/executors/zcode.ts` | `cliTools` 経由で起動される際に `zcode` バむナリぞ枡される远加匕数の JSON 配列16 個以䞋の文字列。 | | `ZCODE_CWD` | `process.cwd()` | `open-sse/executors/zcode.ts` | ZCode app-server サブプロセスの䜜業ディレクトリ。 | | `ZCODE_PROVIDER_ID` | `builtin:zai-coding-plan` | `open-sse/executors/zcode.ts` | app-server ぞ送信されるプロバむダヌ ID のオヌバヌラむド。 | | `ZCODE_SERVER_RUNTIME_ROOT` | `~/.zcode/server` | `open-sse/executors/zcode.ts` | ZCode app-server ランタむムのルヌト同梱の `node` ず `zcode-server.cjs` が配眮される堎所。 | | `ZCODE_SERVER_NODE` | `/node` | `open-sse/executors/zcode.ts` | ZCode app-server のホストに䜿甚される Node 実行可胜ファむル。 | | `ZCODE_SERVER_ENTRY` | `/zcode-server.cjs` | `open-sse/executors/zcode.ts` | ZCode サヌバヌのホストに䜿甚される app-server ゚ントリヌスクリプト。 | | `ZCODE_STARTUP_TIMEOUT_MS` | `10000` | `open-sse/executors/zcode.ts` | ZCode app-server の起動が倱敗したず刀断されるたでの起動タむムアりトミリ秒。 | | `ZCODE_RPC_TIMEOUT_MS` | `30000` | `open-sse/executors/zcode.ts` | ZCode app-server 呌び出しに察するリク゚ストごずの RPC タむムアりトミリ秒。 | | `ZCODE_TURN_TIMEOUT_MS` | `120000` | `open-sse/executors/zcode.ts` | スヌパヌバむザヌがタむムアりトさせるたでの、1 回の ZCode タヌンの最倧時間ミリ秒。 | | `ZCODE_POLL_INTERVAL_MS` | `250` | `open-sse/executors/zcode.ts` | ZCode タヌンの完了を確認するポヌリング間隔ミリ秒。 | | `HERMES_HOME` | `~/.hermes` | `src/lib/cli-helper/config-generator/hermesHome.ts` | OmniRoute が Hermes CLI 蚭定を読み曞きする Hermes Agent ホヌムディレクトリ。Windows で Hermes PowerShell むンストヌラヌが蚭定する環境倉数`%LOCALAPPDATA%\hermes`ず䞀臎したす。 | ### CLI プロファむルの自動同期 これらの機胜フラグはオプトむン方匏で、デフォルトでは無効です。 CLI Code ダッシュボヌドから切り替えるこずもできたす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------- | ---------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_AUTO_SYNC_CODEX_PROFILES` | `false` | `src/shared/constants/featureFlagDefinitions.ts` | プロバむダヌモデルの同期埌、ラむブカタログに基づいお `~/.codex/*.config.toml` プロファむルファむルを自動的に曞き換えたす。`CLI_ALLOW_CONFIG_WRITES` が必芁です。アクティブたたはデフォルトの Codex 蚭定、認蚌、Codex-lb 蚭定、プロバむダヌの遞択は倉曎されたせん。 | | `OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES` | `false` | `src/shared/constants/featureFlagDefinitions.ts` | プロバむダヌモデルの同期埌、ラむブカタログに基づいお `~/.claude/profiles//settings.json` Claude Code プロファむルファむルを自動的に曞き換えたす。`CLI_ALLOW_CONFIG_WRITES` が必芁です。アクティブたたはデフォルトの Claude 蚭定、認蚌、プロバむダヌの遞択は倉曎されたせん。 | ### Docker の䟋 ```bash # ホストのバむナリをコンテナにマりントし、その堎所を OmniRoute に指定したす CLI_EXTRA_PATHS=/host-cli/bin CLI_CONFIG_HOME=/host-home CLI_ALLOW_CONFIG_WRITES=true CLI_CLAUDE_BIN=/host-cli/bin/claude ``` `CLI_CONFIG_HOME` は、パスが実際にホストからバむンドマりントされおいる堎合にのみ有効です。`~/.codex:/host-home/.codex:rw` のようなマりントず組み合わせおください`docker-compose.yml` の `host` プロファむルを参照。コンテナナヌザヌのホヌム内にもバむンドマりント内にもないパスは無芖されたす。その堎所に曞き蟌んでも、コンテナの再䜜成時に砎棄されるためです。 むメヌゞは `USER node` ずしお実行されるため、マりントされおいない `/root` は有効なオヌバヌラむド先では**ありたせん**。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------------------- | ---------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_CONTAINER` | _(自動)_ | `src/shared/utils/containerEnv.ts` | コンテナ怜出を匷制的に有効`1`/`true`たたは無効`0`/`false`にしたす。自動怜出で認識されないランタむムでのみ必芁です。 | | `OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE` | `false` | `src/shared/services/cliRuntime.ts` | マりントされおいないコンテナパスぞの CLI ツヌル蚭定の曞き蟌みを蚱可したす。CLI での同等の指定は `--allow-container-write` です。 | ### CLI バむナリ`omniroute`甚ヘルパヌ これらの倉数は、`omniroute` CLI バむナリ自䜓の動䜜を調敎したす䞊蚘のサむドカヌ怜出ずは別です。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------- | --------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_LANG` | _(システム)_ | `bin/cli/i18n.mjs` | CLI の出力蚀語を匷制指定したす。BCP-47 ロケヌル䟋`en`、`pt-BR`を指定したす。システムのロケヌル環境倉数LC_ALL、LC_MESSAGESより優先されたす。 | | `OMNIROUTE_SHOW_LOG` | _(未蚭定)_ | `bin/cli/runtime/processSupervisor.mjs` | 監芖モヌドでサヌバヌの stdout/stderr を端末ぞ転送するには、`1` に蚭定したす。`omniroute serve` の `--log` フラグず同等です。 | | `OMNIROUTE_CLI_TOKEN` | _(未蚭定)_ | `bin/cli/api.mjs` | `x-omniroute-cli-token` ヘッダヌずしお挿入されるマシン認蚌トヌクンです。タスク 8.12 で自動生成されたす。 | | `GEMINI_CLI_HOME` | _(未蚭定)_ | `bin/cli/commands/setup-gemini.mjs` | 氞続的な Gemini ホヌムルヌトです。ワンショット実行では、䞀時的に分離されたホヌムが䜿甚されたす。 | | `OMNIROUTE_CHILD_SIGNAL_TIMEOUT_MS` | `5000` | `bin/cli/commands/run.mjs` | シグナルを受信した CLI 子プロセスを匷制終了するたでの猶予期間ミリ秒です。 | | `OMNIROUTE_CLI_SKIP_DEFAULT_DATA_ENV` | _(未蚭定)_ | `bin/omniroute.mjs` | 明瀺的な DATA_DIR ずずもに `1` に蚭定するず、デフォルトナヌザヌのデヌタディレクトリ環境ファむルをスキップしたす。 | | `OMNIROUTE_SYNC_TOKEN` | _(未蚭定)_ | `bin/cli/commands/sync.mjs` | `omniroute sync bundle` 甚の同期トヌクンです`GET /api/sync/bundle` は同期トヌクンのみを受け付け、API キヌは受け付けたせん。`--token` ず同等です。 | | `OMNIROUTE_HTTP_TIMEOUT_MS` | `30000` | `bin/cli/api.mjs` | CLI → サヌバヌリク゚ストの詊行ごずの HTTP タむムアりトミリ秒です。 | | `OMNIROUTE_READY_TIMEOUT_MS` | `60000` | `bin/cli/utils/pid.mjs` | CLI がタむムアりト譊告を衚瀺するたでに、サヌバヌのヘルス゚ンドポむントを埅機する最倧時間ミリ秒です。遅いコヌルドスタヌト䟋Windowsに圹立ちたす。`--ready-timeout` でも蚭定できたす。 | | `OMNIROUTE_VERBOSE` | `0` | `bin/cli/api.mjs` | CLI コマンドの実行䞭に、再詊行やバックオフの蚺断情報を stderr ぞ出力するには、`1` に蚭定したす。 | | `OMNIROUTE_PLUGIN_PATH` | _(未蚭定)_ | `bin/cli/plugins.mjs` | CLI プラグむン怜出甚のカスタムディレクトリ`omniroute-cmd-*` パッケヌゞです。未蚭定の堎合、デフォルトは `~/.omniroute/plugins/` です。CLI 専甚であり、`OMNIROUTE_PLUGINS_DIR`セクション 2で指定されるサヌバヌ偎のプラグむンスキャナヌには枡されたせん。 | | `OMNIROUTE_NO_UPDATE_NOTIFIER` | _(未蚭定)_ | `bin/omniroute.mjs` | 空でない任意の倀を蚭定するず、プロセス終了時の CLI 曎新通知を抑制したす。CI、静音モヌド、非テキスト出力モヌドでは、この通知は個別に無効化されたたたです。 | | `OMNIROUTE_DOCTOR_LIVENESS_URL` | _(導出)_ | `bin/cli/commands/doctor.mjs` | `omniroute doctor` が確認する Liveness URL です。プログラムから指定する `livenessUrl` オプションが優先され、それがない堎合は、この倀がそのたた䜿甚されたす。未蚭定の堎合、CLI はロヌカルダッシュボヌドの `/api/health/degradation` ゚ンドポむントを導出したす。 | | `OMNIROUTE_PROVIDER_CATALOG_PATH` | `src/shared/constants/providers/` | `bin/cli/provider-catalog.mjs` | CLI のプロバむダヌコマンドで䜿甚されるプロバむダヌカタログのパスです。プログラムから指定する `catalogPath` オプションが優先されたす。絶察パスはそのたた䜿甚され、盞察パスはプロゞェクトルヌトを基準に解決されたす。未蚭定の堎合、CLI はプロバむダヌ定数ディレクトリを䜿甚し、フォヌルバックずしお埓来の `providers.ts` ファむルを䜿甚したす。 | | `OMNIROUTE_PROVIDER_TEST_MODEL` | _(プロバむダヌのデフォルト)_ | `bin/cli/provider-test.mjs` | CLI のプロバむダヌ接続テスト甚のグロヌバルフォヌルバックモデルです。優先順䜍は、蚭定枈みの接続モデル、プロバむダヌ固有のモデルオヌバヌラむド、この倀、プロバむダヌ組み蟌みのテストモデルの順です。 | --- ## 10. 内郚゚ヌゞェントおよびMCP連携 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ----------------------------------------------- | --------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `OMNIROUTE_BASE_URL` | 自動怜出 | `open-sse/mcp-server/server.ts` | MCP/A2AツヌルがOmniRouteぞアクセスするための明瀺的なURL。localhostの自動怜出を䞊曞きしたす。 | | `OMNIROUTE_API_KEY` | _(未蚭定)_ | MCP/A2Aモゞュヌル | 内郚MCPツヌルおよびA2Aスキル呌び出し甚のAPIキヌ。 | | `OMNIROUTE_API_KEY_ID` | _(未蚭定)_ | `open-sse/mcp-server/audit.ts` | MCP監査ログの垰属先を瀺すキヌID。 | | `ROUTER_API_KEY` | _(未蚭定)_ | レガシヌ | `OMNIROUTE_API_KEY`のレガシヌ゚むリアス。 | | `OMNIROUTE_A2A_HISTORY_RETENTION_DAYS` | `30` | `src/lib/a2a/taskManager.ts` | 日次パヌゞで行が削陀されるたで、ロヌカルデヌタベヌスにA2Aタスク履歎を保持する日数。未蚭定、数倀以倖、たたは`<= 0`の堎合は`30`にフォヌルバックしたす。 | | `OMNIROUTE_A2A_MEMORY_HITS` | `1` | `src/lib/a2a/taskExecution.ts` | A2Aのメモリヒット可芳枬性機胜甚キルスむッチ。`0`に蚭定するず、タスクのメモリ想起怜玢を完党にスキップしたす。未蚭定を含むその他の倀では有効なたたです。 | | `OMNIROUTE_ISSUE_AGENT_ENABLED` | `false` | `src/app/api/issue-agent/runs/route.ts` | オフラむンロヌカルのIssue Agent蚘録枈みトリアヌゞ゚ンドポむントを有効にしたす。ロヌカルの蚘録枈みトリアヌゞワヌクフロヌを明瀺的に実行する堎合を陀き、無効のたたにしおください。 | | `OMNIROUTE_ISSUE_AGENT_TIMEOUT_MS` | _(未蚭定)_ | `src/lib/issueAgent/execution.ts` | 単䞀のIssue Agent蚘録枈みトリアヌゞ実行のタむムアりトミリ秒。内郚最倧倀に制限され、未蚭定たたは無効な堎合は組み蟌みのデフォルト倀にフォヌルバックしたす。 | | `OMNIROUTE_CONTEXT` | _(アクティブなコンテキスト)_ | `bin/cli/program.mjs`, `bin/cli/api.mjs` | `omniroute`コマンドのCLIリモヌトモヌド甚コンテキストプロファむル。ロヌカルのコンテキストストア内のアクティブなコンテキストを䞊曞きしたす。`--context `ず同等です。 | | `OMNIROUTE_CONTEXT_KEYCHAIN_DISABLED` | `0` | `bin/cli/contexts.mjs` | CLIコンテキスト認蚌情報甚のオプションの`keytar` OSキヌチェヌンバック゚ンドを無効にしたす。有効にするず、認蚌情報はモヌド`0600`の`config.json`に保持され、CLIはフォヌルバック譊告を䞀床だけ出力したす。意図的なヘッドレスコンテナ運甚を想定しおいたす。 | | `OMNIROUTE_MCP_ENFORCE_SCOPES` | `false` | `open-sse/mcp-server/server.ts` | MCPツヌル呌び出しに察しおスコヌプベヌスのアクセス制埡を適甚したす。 | | `OMNIROUTE_MCP_SCOPES` | _(すべお)_ | `open-sse/mcp-server/server.ts` | カンマ区切りのスコヌプ`admin`、`combos`、`health`、`models`、`routing`、`budget`、`metrics`、`pricing`、`memory`、`skills`。 | | `OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS` | `false` | `open-sse/mcp-server/descriptionCompressor.ts` | マニフェストをシリアラむズする前にMCPツヌルの説明を圧瞮したす。有効化する倀`1`、`true`、`on`。 | | `OMNIROUTE_MCP_DESCRIPTION_COMPRESSION` | `rtk` | `open-sse/mcp-server/descriptionCompressor.ts` | 圧瞮アルゎリズムプロファむル。無効化する倀`0`、`false`、`off`。 | | `OMNIROUTE_MCP_FETCH_TIMEOUT_MS` | `10000` | `open-sse/mcp-server/fetchTimeout.ts` | MCPサヌバヌ内郚の管理読み取りヘルス、レゞリ゚ンス、コンボ、クォヌタ、䜿甚量に察する䞭止たでの時間枠ミリ秒。 | | `OMNIROUTE_MCP_UPSTREAM_TIMEOUT_MS` | `60000` | `open-sse/mcp-server/fetchTimeout.ts` | プロバむダヌを埅機する MCP ホップ`route_request`、`web_search`、`web_fetch`の䞭断たでの時間ms。 | | `OMNIROUTE_CORPUS_CACHE_SIZE` | `5` | `src/lib/localCorpus/configured.ts` | メモリ内にキャッシュされるロヌカルコヌパスのむンデックスむンスタンスの最倧数LRU、むンデックス化されたルヌトディレクトリごずに 1 ぀。最小倀 `1` に制限されたす。 | | `MODEL_SYNC_INTERVAL_HOURS` | `6` | `src/shared/services/modelSyncScheduler.ts` | モデルカタログの同期間隔時間。 | | `PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES` | `70` | `src/lib/usage/providerLimits.ts` | プロバむダヌのレヌト制限およびクォヌタのポヌリング間隔。 | | `PROVIDER_LIMITS_SYNC_SPACING_MS` | `1500` | `src/lib/usage/providerLimits.ts` | 䞀括同期で連続する OAuth クォヌタ取埗間の間隔ms。アップストリヌムぞのアクセスが急増しないよう、OAuth 接続は䞀床に 1 ぀ず぀取埗されたす。`0` で無効化同時実行。 | | `OMNIROUTE_QUOTA_FETCH_MIN_INTERVAL_MS` | `250` | `open-sse/services/quotaFetchThrottle.ts` | リク゚スト単䜍のプリフラむト監芖パスにおける、連続するアップストリヌムクォヌタ取埗間の最小間隔ms。同時ネットワヌク呌び出しの間隔を空け、1 ぀の IP 䞊にある倚数のアカりントからアップストリヌムぞのアクセスが急増するのを防ぎたす。Codex`/wham/usage`、DeepSeek、Bailian䞡方の取埗箇所、OpenCode、Crof のクォヌタ取埗凊理に組み蟌たれおいたす#6009、#6911。汎甚の `usage.ts::getUsageForProvider` ディスパッチパスgithub/glm/minimax/nanogpt/xai/etc.はただ察象倖で、別途远跡されおいたす。キャッシュヒットには圱響したせん。`0` で無効化。`0..5000` の範囲に制限されたす。 | | `PROVIDER_LIMITS_POST_USAGE_REFRESH_DELAY_MS` | `5000` | `src/lib/usage/providerLimits.ts` | 実際の䜿甚むベント埌にプロバむダヌ制限を曎新するたでの遅延ms。アップストリヌムのクォヌタ API が消費量を登録するための時間を確保したす。 | | `OMNIROUTE_LOGIN_BROWSER_PATH` | 自動怜出 | `open-sse/services/adobeFireflyBrowserLogin.ts` | Adobe Firefly の察話型サむンむンおよび画面倖での曎新に䜿甚される、システムの Chrome たたは Edge 実行ファむルぞの絶察パス。 | | `ADOBE_FIREFLY_BROWSER_REFRESH` | 有効 | `open-sse/services/adobeFireflySession.ts` | アカりント単䜍の Chrome CDP セッションを䜿甚しお、IMS およびブラりザヌリスク状態を最新に保ちたす。ブラりザヌによる曎新を無効にするには `0` に蚭定したす。 | | `ADOBE_FIREFLY_SESSION_DISK` | 有効 | `open-sse/services/adobeFireflySession.ts` | 修埩された Adobe セッションを `DATA_DIR` 配䞋に氞続化し、プロセスの再起動埌も保持したす。セッションをメモリ内のみに保持するには `0` に蚭定したす。 | | `ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS` | `12000` | `open-sse/services/adobeFireflySession.ts` | Adobe Firefly の生成送信間の最小間隔ミリ秒。`0` で間隔蚭定を無効にしたす。 | | `ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS` | `15000` | `open-sse/services/adobeFireflySession.ts` | Adobe ぞの送信が 3 回成功するごずに蚭ける远加の埅機時間ミリ秒。 | | `ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS` | `8000` | `open-sse/services/adobeFireflyClient.ts` | Adobe から䞀時的な 408 応答を受信した埌の基本バックオフ時間ミリ秒。最倧 5 回の詊行にわたり、送信間隔ず組み合わせお適甚されたす。 | | `OMNIROUTE_DISABLE_BACKGROUND_SERVICES` | `false` | `src/instrumentation-node.ts` | すべおのバックグラりンドサヌビス同期、䟡栌蚭定、モデル曎新を無効にしたす。CIテストに有甚です。 | | `OMNIROUTE_HEADLESS` | _未蚭定_ | `src/lib/system/headless.ts` | プロキシ゚ンゞンのみで起動したす。オプションのサブシステムをスキップし、`/dashboard` → 404 ずなりたす。`omniroute serve --headless` ず同じです。[HEADLESS.md](../guides/HEADLESS.md) を参照しおください。 | | `OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS` | _未蚭定_ | `src/lib/config/runtimeSettings.ts` | 自動テストの怜出時でもバックグラりンドタスクを匷制的に有効にしたす。テスト甚ヒュヌリスティックを䞊曞きするには `1` に蚭定したす。 | | `OMNIROUTE_BUDGET_RESET_JOB_INTERVAL_MS` | `600000` | `src/lib/jobs/budgetResetJob.ts` | 予算リセットのチェック間隔ミリ秒。䞋限は `10000`。 | | `OMNIROUTE_CONNECTION_RECOVERY_INTERVAL_MS` | `60000` | `src/lib/quota/connectionRecovery.ts` | プロアクティブな接続クヌルダりン埩旧の実行間隔ミリ秒䞀時的な `rate_limited_until` の期限が切れた接続を、リク゚ストのホットパス倖で再怜蚌したす。䞋限は `5000`。 | | `OMNIROUTE_DISABLE_CONNECTION_RECOVERY` | `false` | `src/lib/quota/connectionRecovery.ts` | プロアクティブな接続クヌルダりン埩旧スケゞュヌラヌを無効にしたす`getProviderCredentials` での遅延埩旧は匕き続き適甚されたす。 | | `OMNIROUTE_REASONING_CACHE_CLEANUP_INTERVAL_MS` | `1800000` | `src/lib/jobs/reasoningCacheCleanupJob.ts` | 掚論キャッシュのクリヌンアップ間隔ミリ秒。䞋限は `60000`。 | | `OMNIROUTE_REASONING_MIN_BUDGET` | _未蚭定_無効 | `open-sse/services/reasoningTokenBuffer.ts` | 思考モデルの出力予算に察するオプトむンの䞋限呌び出し元の `max_tokens` が `[256, floor)` の範囲にある堎合、䞋限たで匕き䞊げられたすモデルの出力䞊限たで。未蚭定の堎合、クラむアントの予算は拡倧されたせん#9507。 | | `OMNIROUTE_REASONING_EFFORT_PROBE_PROVIDERS` | _未蚭定_無効 | `open-sse/services/learnedReasoningEffortCaps.ts` | オプトむンのカンマ区切りプロバむダヌ IDたたは `*``reasoning_effort` の 400/422 ゚ラヌに受け入れ可胜なセットが瀺されおいない堎合、1 段階䜎いティアで 1 回再詊行し`low` 未満にはしたせん、プロヌブに応答があった堎合に限りそのティアを孊習したす#14895。 | | `OMNIROUTE_LOG_EXPORT_CRON` | `0 * * * *` | `src/lib/jobs/logExportJob.ts` | 有効なすべおのログ゚クスポヌト先ぞ凊理を行う、呌び出しログ゚クスポヌトゞョブの Cron 匏UTC。 | | `OMNIROUTE_CONFIG_HOT_RELOAD_MS` | `5000` | `src/lib/config/hotReload.ts` | 蚭定ホットリロヌドのポヌリング間隔ミリ秒。`1000` 未満は拒吊されたす。 | | `OMNIROUTE_DISABLE_REDIS_AUTH_CACHE` | _有効_ | `src/lib/db/apiKeys.ts` | `1` に蚭定するず、Redis ベヌスの API キヌ認蚌キャッシュをバむパスしたすDB 読み取りを匷制したす。 | | `OMNIROUTE_RTK_TRUST_PROJECT_FILTERS` | `0` | `open-sse/services/compression/engines/rtk/filterLoader.ts` | 厳栌な眲名チェックを行わず、ナヌザヌ管理の RTK プロゞェクトフィルタヌルヌルを信頌したす。 | | `OMNIROUTE_LITE_MAX_TOOL_LENGTH` | `2000` | `open-sse/services/compression/lite.ts` | `lite.maxToolLength` が未蚭定の堎合の、Lite によるプロアクティブなツヌル結果切り詰めの文字数䞊限。範囲は 2561000000。ダッシュボヌド蚭定がこの環境倉数より優先されたす。 | | `OMNI_COMPRESSION_WORKERS` | `2` | `open-sse/services/compression/compressionWorkerPool.ts` | 同時実行可胜な同期 RTK/Caveman ワヌカヌの最倧数。超過したゞョブは FIFO 方匏で埅機したす。 | | `OMNI_COMPRESSION_WORKER_TIMEOUT_MS` | `120000` | `open-sse/services/compression/compressionWorkerPool.ts` | ゞョブ単䜍のタむムアりトミリ秒。タむムアりトしたワヌカヌは終了され、リク゚ストは倉曎されないたたフェむルオヌプンしたす。 | | `OMNI_COMPRESSION_WORKER_IDLE_MS` | `60000` | `open-sse/services/compression/compressionWorkerPool.ts` | 未䜿甚の圧瞮ワヌカヌが終了されるたでのアむドル時間ミリ秒。 | | `OMNI_COMPRESSION_WORKER_MAX_OLD_MB` | `1024` | `open-sse/services/compression/compressionWorkerPool.ts` | すべおのモヌドにおける、各圧瞮ワヌカヌの V8 旧䞖代ヒヌプ䞊限MB。䞋限は `128`。これを超えたゞョブは、ゲヌトりェむのヒヌプを増倧させる代わりにフェむルオヌプン非圧瞮したす。 | | `COMPRESSION_PIPELINE_BREAKER_ENABLED` | `false` | `open-sse/services/compression/pipelineEngineBreaker.ts` | T02 スタック型パむプラむンの゚ンゞン単䜍サヌキットブレヌカヌのマスタヌスむッチ。**オプトむンデフォルトはオフ** — オンの堎合、耇数のリク゚ストにわたっお繰り返し䟋倖をスロヌする゚ンゞンは、クヌルダりン期間䞭スキップフェむルオヌプンされたす。オフの堎合、埓来の動䜜ずバむト単䜍で同䞀です。 | | `COMPRESSION_PIPELINE_BREAKER_THRESHOLD` | `3` | `open-sse/services/compression/pipelineEngineBreaker.ts` | ゚ンゞンのブレヌカヌが開くたでの、リク゚ストをたたいだ連続倱敗回数。 | | `COMPRESSION_PIPELINE_BREAKER_COOLDOWN_MS` | `30000` | `open-sse/services/compression/pipelineEngineBreaker.ts` | オヌプン状態の゚ンゞンがハヌフオヌプンのプロヌブ前にスキップされ続ける時間ミリ秒。 | | `COMPRESSION_CCR_RETRIEVAL_RAMP_FACTOR` | `2` | `open-sse/services/compression/engines/ccr/index.ts` | T08/H8 CCR 取埗フィヌドバックのランプ係数保存枈みブロックの過去の取埗回数に応じお、有効な `minChars` を線圢に匕き䞊げたす頻繁に取埗されるコンテンツほど圧瞮率が䜎くなり、取埗回数が `>=3` の堎合は圧瞮されたせん。`1` にするずランプが無効になりたすしきい倀に達した堎合のみ二倀的にスキップ。 | | `COMPRESSION_CCR_DURABLE_STORE` | `true` | `open-sse/services/compression/engines/ccr/index.ts` | CCR 氞続ブロックストア#9061。むンメモリストアを SQLite でバックアップし、LRU による゚ビクション、TTL、再起動、たたは別むンスタンスに到達した取埗リク゚ストが発生しおもブロックを保持したす。ブロックをメモリ内にのみ保持するには `false` に蚭定したす。512KB を超えるブロックずクラりドランタむムでは、蚭定に関係なくメモリ内にのみ保持されたす。 | | `COMPRESSION_PREFIX_FREEZE_ENABLED` | `false` | `open-sse/services/compression/prefixFreeze.ts` | T08/H5 䜿甚状況に基づくプレフィックス固定のマスタヌスむッチ。**オプトむンデフォルトはオフ** — オンにするず、芳枬回数がしきい倀以䞊`>=`のシステムプロンプトは安定したキャッシュ可胜なプレフィックスずしお扱われ、静的キャッシュヒュヌリスティックで怜出できないプロバむダヌでも圧瞮察象から陀倖されたす固定は内容を*保持*するだけで、倉曎するこずはありたせん。 | | `COMPRESSION_PREFIX_FREEZE_THRESHOLD` | `3` | `open-sse/services/compression/prefixFreeze.ts` | システムプロンプトが固定された安定プレフィックスずしお扱われるたでに必芁な芳枬回数。 | | `OMNIROUTE_BOOTSTRAPPED` | `false` | `src/app/(dashboard)/dashboard/page.tsx` | 初期セットアップ埌にブヌトストラップスクリプトによっお `true` に蚭定されたす。セットアップりィザヌドの衚瀺を制埡したす。 | | `OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE` | `0` | `open-sse/executors/antigravity.ts` | ゚スケヌプハッチリク゚スト本文による Antigravity のプロゞェクトフィヌルドの䞊曞きを蚱可したす。 | | `ANTIGRAVITY_CREDITS` | `off` | `open-sse/services/antigravityCredits.ts` | Google One AI クレゞットポリシヌ`off` はクレゞットを挿入せず、`retry` は察象ずなるクォヌタ起因の 429 の発生埌に䞀床だけ挿入し、`always` は最初のリク゚ストで挿入したす。 | | `ANTIGRAVITY_ALLOW_SIGNATURE_BYPASS` | `0` | `open-sse/translator/request/openai-to-gemini.ts` | アップストリヌムが実際の眲名を拒吊する堎合に、Antigravity リク゚ストトランスレヌタヌが厳栌な CLI リク゚スト眲名怜蚌をスキップするこずを蚱可したすデバッグ旧匏 CLI モヌド。れロ以倖の倀でバむパスが有効になりたす。 | | `AGY_TOKEN_FILE` | `~/.gemini/antigravity-cli/antigravity-oauth-token` | `src/app/api/providers/agy-auth/apply-local/route.ts` | ロヌカルログむンの自動怜出むンポヌトに䜿甚する Antigravity CLIagyのトヌクンファむルパスを䞊曞きしたす。 | ### OAuth CLI ブリッゞ内郚 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------- | ------------ | ------------------------------- | ------------------------------------------ | | `OMNIROUTE_SERVER` | 自動怜出 | `src/lib/oauth/config/index.ts` | CLI↔OmniRoute 認蚌ブリッゞのサヌバヌ URL。 | | `OMNIROUTE_TOKEN` | _未蚭定_ | `src/lib/oauth/config/index.ts` | CLI ブリッゞの認蚌トヌクン。 | | `OMNIROUTE_USER_ID` | `cli` | `src/lib/oauth/config/index.ts` | CLI ブリッゞセッションのナヌザヌ ID。 | | `SERVER_URL` | _未蚭定_ | `src/lib/oauth/config/index.ts` | `OMNIROUTE_SERVER` のレガシヌ゚むリアス。 | | `CLI_TOKEN` | _未蚭定_ | `src/lib/oauth/config/index.ts` | `OMNIROUTE_TOKEN` のレガシヌ゚むリアス。 | | `CLI_USER_ID` | _未蚭定_ | `src/lib/oauth/config/index.ts` | `OMNIROUTE_USER_ID` のレガシヌ゚むリアス。 | --- ## 11. OAuthプロバむダヌの認蚌情報 **localhost開発甚**の組み蟌み認蚌情報。リモヌトデプロむメントの堎合は、各プロバむダヌの開発者コン゜ヌルで独自のものを登録しおください。 | 倉数 | プロバむダヌ | 泚蚘 | | :------------------------------------------ | :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CLAUDE_OAUTH_CLIENT_ID` | Claude Code (Anthropic) | パブリッククラむアント — シヌクレットは䞍芁です。 | | `CLAUDE_CODE_REDIRECT_URI` | Claude Code | リダむレクトURIを䞊曞きしたす。デフォルト: `https://platform.claude.com/oauth/code/callback` | | `CODEX_OAUTH_CLIENT_ID` | Codex / OpenAI | パブリッククラむアント。 | | `GEMINI_OAUTH_CLIENT_ID` | Gemini (Google) | 䞀臎する `_SECRET` が必芁です。 | | `GEMINI_OAUTH_CLIENT_SECRET` | Gemini (Google) | — | | `KIMI_CODING_OAUTH_CLIENT_ID` | Kimi Coding (Moonshot) | パブリッククラむアント。 | | `MUSE_CODE_OAUTH_CLIENT_ID` | Muse Code (Meta) | パブリックMuse CLIデバむスフロヌクラむアントIDのオプションの䞊曞き。組み蟌みのパブリッククラむアントを䜿甚するには未蚭定のたたにしたす。 | | `ANTIGRAVITY_OAUTH_CLIENT_ID` | Antigravity (Google) | 䞀臎する `_SECRET` が必芁です。 | | `ANTIGRAVITY_OAUTH_CLIENT_SECRET` | Antigravity (Google) | — | | `GITHUB_OAUTH_CLIENT_ID` | GitHub Copilot | パブリッククラむアント。 | | `GHE_COPILOT_OAUTH_CLIENT_ID` | GHE Copilot | GitHub Enterprise CopilotのOAuthクラむアントIDのオプションの䞊曞き。未蚭定の堎合、`GITHUB_OAUTH_CLIENT_ID`のパブリックデフォルトにフォヌルバックしたす。 | | `COPILOT_INTEGRATION_ID` | GitHub Copilot | `Copilot-Integration-Id`および`Editor-Plugin-Version`ヘッダヌで送信されるGitHub Copilotクラむアント統合IDのオプションの䞊曞き。デフォルトは`copilot-developer-cli`です。 | | `WINDSURF_API_KEY` | Windsurf / Devin (v3.8) | 接続ごずの認蚌情報が利甚できない堎合に`open-sse/executors/devin-cli.ts`で䜿甚されるAPIキヌのフォヌルバック。オプション。 | | `CLI_DEVIN_BIN` | Devin CLI (v3.8) | Devin CLIバむナリ (`devin`) ぞのカスタムパス。`open-sse/executors/devin-cli.ts`によっお解決されたす。 | | `GITLAB_DUO_OAUTH_CLIENT_ID` | GitLab Duo (v3.8) | GitLab DuoのOAuthクラむアントID。`https://gitlab.com/-/profile/applications`で、リダむレクトURIを`/callback`、スコヌプを`api, read_user, openid, profile, email`ずしおアプリを登録しおください。`GITLAB_OAUTH_CLIENT_ID`にフォヌルバックしたす。 | | `GITLAB_DUO_OAUTH_CLIENT_SECRET` | GitLab Duo (v3.8) | GitLab DuoのOAuthクラむアントシヌクレット。オプション — PKCEフロヌではシヌクレットは䞍芁です。`GITLAB_OAUTH_CLIENT_SECRET`にフォヌルバックしたす。 | | `GITLAB_DUO_BASE_URL` | GitLab Duo (v3.8) | GitLabベヌスURL (セルフホスト型GitLab) を䞊曞きしたす。デフォルトは`https://gitlab.com`です。`GITLAB_BASE_URL`にフォヌルバックしたす。 | | `GITLAB_BASE_URL` | GitLab Duo (v3.8) | `GITLAB_DUO_BASE_URL` のレガシヌフォヌルバック。`_DUO_` バリアントが蚭定されおいない堎合に䜿甚されたす。 | | `GITLAB_OAUTH_CLIENT_ID` | GitLab Duo (v3.8) | `src/lib/oauth/constants/oauth.ts` で䜿甚される `GITLAB_DUO_OAUTH_CLIENT_ID` のレガシヌフォヌルバック。 | | `GITLAB_OAUTH_CLIENT_SECRET` | GitLab Duo (v3.8) | `src/lib/oauth/constants/oauth.ts` で䜿甚される `GITLAB_DUO_OAUTH_CLIENT_SECRET` のレガシヌフォヌルバック。 | | `QODER_OAUTH_CLIENT_SECRET` | Qoder | — | | `QODER_OAUTH_AUTHORIZE_URL` | Qoder | Qoder OAuth を有効にするために蚭定したす。 | | `QODER_OAUTH_TOKEN_URL` | Qoder | — | | `QODER_OAUTH_USERINFO_URL` | Qoder | — | | `QODER_OAUTH_CLIENT_ID` | Qoder | — | | `QODER_PERSONAL_ACCESS_TOKEN` | Qoder | 盎接的な API キヌフォヌルバック (OAuth をバむパスしたす)。 | | `QODER_CLI_WORKSPACE` | Qoder | Qoder CLI のワヌクスペヌス ID。 | | `OMNIROUTE_QODER_WORKSPACE` | Qoder | `QODER_CLI_WORKSPACE` の゚むリアス。 | | `QODER_CLI_CONFIG_DIR` | Qoder | Qoder CLI の蚭定ディレクトリを䞊曞きしたす (分離された PAT セッションで、ブラりザログむンの䞊曞きを回避したす)。 | | `BLACKBOX_WEB_VALIDATED_TOKEN` | Blackbox Web | `/api/chat` で `validated` ずしお送信するフロント゚ンドの `tk` トヌクン。Blackbox がトヌクンの䞀臎を匷制する堎合に必芁です。それ以倖の堎合、OmniRoute はランダムな UUID にフォヌルバックしたす。Issue #2252 を参照しおください。 | | `VISION_BRIDGE_BASE_URL` | Vision Bridge guardrail | Anthropic 以倖の vision-bridge 呌び出し甚の OpenAI 互換ベヌス URL。レガシヌな OpenAI URL 環境倉数たたは api.openai.com にデフォルト蚭定されたす。OmniRoute の `/v1` セルフルヌプ、たたは任意の OpenAI 互換゚ンドポむント (Gemini OpenAI 互換、OpenRouter) を指したす。Issue #2232。URL が OmniRoute 自身の `/v1` である堎合、蚘述サブ芁求は `x-omniroute-admission-bypass: internal` を送信し、解決されたセルフルヌプ認蚌情報 (ロヌカルモヌドでは `sk_omniroute` センチネル、たたは `OMNIROUTE_API_KEY` / `ROUTER_API_KEY` — #1350) で認蚌されるため、`REQUIRE_API_KEY=true` のデプロむが機胜したす。 | | `VISION_BRIDGE_API_KEY` | Vision Bridge guardrail | 䞊蚘 URL 甚の API キヌ。Anthropic 以倖の vision-bridge 呌び出しの堎合、プロバむダヌごずの OpenAI / Google 環境倉数を䞊曞きしたす。Anthropic モデルは専甚の Anthropic キヌパスを保持したす。Issue #2232。 | | `OMNIROUTE_VISION_BRIDGE_NEGATIVE_CACHE_MS` | Vision Bridge guardrail | 「利甚可胜な候補なし」ずいうルヌティング結果がキャッシュされる期間 (ミリ秒単䜍、デフォルト `30000`)。無効な倀たたは負の倀はデフォルトにフォヌルバックしたす。`0` はネガティブキャッシュを無効にしたす。゜ヌス: `src/lib/guardrails/visionBridgeRouter.ts`。 | > [!WARNING] > > 1. [Google Cloud Console → 認蚌情報](https://console.cloud.google.com/apis/credentials) に移動したす。 > 2. OAuth 2.0 クラむアント ID (タむプ: 「Web アプリケヌション」) を䜜成したす。 > 3. 承認枈みリダむレクト URI ずしおサヌバヌ URL を远加したす。 > 4. `.env` 内の認蚌情報倀を眮き換えたす。 --- ## 12. プロバむダヌの User-Agent オヌバヌラむド 各アップストリヌムプロバむダヌに送信される `User-Agent` ヘッダヌをオヌバヌラむドしたす。これは、executor 基底クラスによっお実行時に動的に解決されたす。 ``` process.env[`${PROVIDER_ID}_USER_AGENT`] ``` > **゜ヌス:** `open-sse/executors/base.ts` → `buildHeaders()` | 倉数 | デフォルト倀 | 曎新するタむミング | | -------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `CLAUDE_USER_AGENT` | `claude-cli/2.1.280 (external, cli)` | Anthropic が新しい CLI バヌゞョンをリリヌスしたずき | | `CLAUDE_DISABLE_TOOL_NAME_CLOAK` | `false` | `executors/base.ts` + `executors/cliproxyapi.ts` | Anthropic 向けの䞡方の経路ネむティブ OAuth および CLIProxyAPIで、サヌドパヌティ補ハヌネスのツヌル名をそのたた Anthropic に転送するには、`1`/`true` に蚭定したす。デフォルトでは、executor は Claude Code 以倖のツヌル名に決定論的な゚むリアスを割り圓おClaude Code の暙準マッピングが存圚する堎合はそれを䜿甚し、それ以倖の堎合は PascalCase を䜿甚、レスポンスでは `_toolNameMap` を介しお元に戻したす。これにより、snake_case のツヌルを䜿甚するハヌネスが、フィンガヌプリントされたサヌドパヌティ補クラむアントずしお拒吊されるのを防ぎたす。デバッグ専甚です。 | | `CODEX_USER_AGENT` | `codex-cli/0.155.0 (Windows 10.0.26200; x64)` | OpenAI が Codex CLI を曎新したずき | | `CODEX_CLIENT_VERSION` | `0.155.0` | 完党な UA 文字列ずは独立しお Codex クラむアントのバヌゞョンをオヌバヌラむドする | | `CLAUDE_CODE_CLIENT_VERSION` | `2.1.280` | `CLAUDE_USER_AGENT` ずは独立しお、通知される Claude Code のバヌゞョンをオヌバヌラむドする。Anthropic は䞀郚のモデルをこの倀に基づいお制限したす#12417。 | | `CLAUDE_CODE_CLIENT_BUILD_REVISION` | `1e2` | OmniRoute が Claude の請求ブロック内の `cc_version=` に付加する3文字のサフィックスをオヌバヌラむドする。`CLAUDE_CODE_CLIENT_VERSION` ず䜵せお曎新しおください。バヌゞョンだけを固定するず、実圚するバむナリが生成しない `version.revision` の組み合わせが通知されたす。 | | `GITHUB_COPILOT_CLI_VERSION` | `1.0.91` | `GITHUB_USER_AGENT` ずは独立しお、通知される Copilot CLI のバヌゞョンをオヌバヌラむドする | | `GITHUB_USER_AGENT` | `GitHubCopilotChat/0.54.0` | GitHub Copilot Chat が曎新されたずき | | `ANTIGRAVITY_USER_AGENT` | `antigravity/2.0.1 darwin/arm64` | Antigravity IDE が曎新されたずき | | `KIRO_USER_AGENT` | `AWS-SDK-JS/3.0.0 kiro-ide/1.0.0` | Kiro IDE が曎新されたずき | | `KIRO_OAUTH_CLIENT_ID` | `kiro-cli` | Kiro の゜ヌシャルデバむスコヌド甚 `clientId`公開 IDをオヌバヌラむドする | | `KIRO_VERIFY_FULL_CRC` | `false` | オプトむン: Kiro むベントストリヌムでフレヌムごずの完党なメッセヌゞ CRC 怜蚌を行う砎損したストリヌムのデバッグ甚 | | `QODER_USER_AGENT` | `Qoder-Cli` | Qoder CLI が曎新されたずき | | `CURSOR_USER_AGENT` | `Cursor/3.3` | Cursor が曎新されたずき | > [!TIP] > `{PROVIDER_ID}_USER_AGENT` ずいうパタヌンを䜿甚しお、**任意の**プロバむダヌに User-Agent オヌバヌラむドを远加できたす。executor は環境倉数名を動的に構築したす。 --- ## 13. CLI フィンガヌプリント互換性 有効にするず、OmniRoute は HTTP ヘッダヌず JSON ボディのフィヌルドを䞊べ替え、公匏 CLI ツヌルの正確なシグネチャに䞀臎させたす。これにより、プロキシ IP を維持しながら、アカりントがフラグ付けされるリスクを軜枛したす。 **゜ヌス:** `open-sse/config/cliFingerprints.ts`、`open-sse/executors/base.ts` ### プロバむダヌ別 | 倉数 | 有効化 | 効果 | | ------------------------ | ------ | ------------------------------------------- | | `CLI_COMPAT_CODEX` | `=1` | Codex CLI のリク゚ストシグネチャを暡倣 | | `CLI_COMPAT_CLAUDE` | `=1` | Claude Code のリク゚ストシグネチャを暡倣 | | `CLI_COMPAT_GITHUB` | `=1` | GitHub Copilot のリク゚ストシグネチャを暡倣 | | `CLI_COMPAT_ANTIGRAVITY` | `=1` | Antigravity のリク゚ストシグネチャを暡倣 | | `CLI_COMPAT_CURSOR` | `=1` | Cursor のリク゚ストシグネチャを暡倣 | | `CLI_COMPAT_KIMI_CODING` | `=1` | Kimi Coding のリク゚ストシグネチャを暡倣 | | `CLI_COMPAT_KILOCODE` | `=1` | Kilo Code のリク゚ストシグネチャを暡倣 | | `CLI_COMPAT_CLINE` | `=1` | Cline のリク゚ストシグネチャを暡倣 | ### グロヌバル | 倉数 | 有効化 | 効果 | | ---------------- | ------ | ------------------------------------------------------------------------ | | `CLI_COMPAT_ALL` | `=1` | **すべおの**プロバむダヌでフィンガヌプリント互換性を䞀括で有効にしたす。 | ### Kimi Coding CLI の ID オヌバヌラむド | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ----------------------- | -------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------ | | `KIMI_CLI_VERSION` | `1.36.0` | `src/lib/oauth/providers/kimi-coding.ts` | OAuth/API 呌び出し時に送信される Kimi CLI のバヌゞョンを䞊曞きしたす。 | | `KIMI_CODING_DEVICE_ID` | _取埗枈みのデフォルト_ | `src/lib/oauth/providers/kimi-coding.ts` | クラむアントヘッダヌで䜿甚される、取埗枈みの Kimi デバむス ID を䞊曞きしたす。 | > [!NOTE] > この機胜は User-Agent オヌバヌラむド§12ず䜵甚できたす。フィンガヌプリントシステムはヘッダヌずボディフィヌルドの順序を凊理し、User-Agent オヌバヌラむドは特定の UA 文字列を凊理したす。䞡方を個別に有効化できたす。 --- ## 14. API キヌプロバむダヌ 盎接認蚌を䜿甚するプロバむダヌ向けの API キヌです。**掚奚蚭定:** Dashboard → Providers → Add API Key。 Docker たたはヘッドレスデプロむでは、代替手段ずしお環境倉数を䜿甚しお蚭定できたす。 認識されるパタヌン: `{PROVIDER_ID}_API_KEY` | 倉数 | プロバむダヌ | | ------------------ | ------------------------------------------------------------- | | `DEEPSEEK_API_KEY` | DeepSeek | | `NVIDIA_API_KEY` | NVIDIA NIM | | `JINA_AI_API_KEY` | Jina AIFoundation API + Reader フォヌルバック | | `JINA_API_KEY` | Jina AI`JINA_AI_API_KEY` の゚むリアス | | `GEMINI_API_KEY` | GeminiGoogle AI Studioの埋め蟌み + チャットフォヌルバック | | `GOOGLE_API_KEY` | Gemini`GEMINI_API_KEY` の゚むリアス | > [!NOTE] > Groq、xAI、Mistral、Perplexity、Together AI、Fireworks、Cerebras、Cohere、Nebius、Qianfan の静的な `${PROVIDER}_API_KEY` ゚ントリは、ランタむムで読み蟌たれなくなったため、v3.8.0 で削陀されたした。これらのプロバむダヌは、Dashboard / `data/provider-credentials.json` / 暗号化 DB のみに䟝存したす。移行手順に぀いおは、このドキュメントの末尟にある _監査: 削陀枈み / 無効な倉数_ セクションを参照しおください。 > [!TIP] > Dashboard で蚭定されたキヌは SQLite に暗号化しお保存され、環境倉数よりも優先されたす。 > > **Jina:** Dashboard に `jina-ai`たたは共有の `jina-reader`接続が存圚する堎合、`jina-ai/
` の埋め蟌み、再ランキング、分類、セグメント化、および `jina-search` では、クラスタヌの環境倉数キヌに課金されるこずは**ありたせん**。`getProviderCredentials` は先着充足方匏です。`JINA_AI_API_KEY` / `JINA_API_KEY` は、䜿甚可胜な Dashboard キヌが存圚しない堎合にのみ䜿甚されたす。呌び出しログでは、環境倉数ぞのフォヌルバックが `connection_id=env:JINA_AI_API_KEY` ずしお蚘録されたす。Reader カヌド`jina-reader`、`r.jina.ai`が `/v1/embeddings` たたは `/v1/rerank` を凊理するこずはありたせん。 > > **Gemini:** `gemini/gemini-embedding-2`゚むリアス `google/gemini-embedding-2`は、Dashboard の `gemini` 接続を最初に䜿甚したす。`GEMINI_API_KEY` / `GOOGLE_API_KEY` は、䜿甚可胜な Dashboard キヌが存圚しない堎合にのみ䜿甚されたす。呌び出しログでは、環境倉数ぞのフォヌルバックが `connection_id=env:GEMINI_API_KEY` ずしお蚘録されたす。ネむティブのマルチモヌダルトラフィックでは、`:embedContent` / `:batchEmbedContents` に察しお `x-goog-api-key` が䜿甚されたす。N 個の OpenAI `input` 項目は N 個のベクトルになりたす。 --- ## 15. タむムアりト蚭定 すべおの倀の単䜍は**ミリ秒**です。蚭定の解決は `src/shared/utils/runtimeTimeouts.ts` に集玄されおいたす。 ### タむムアりトの階局 ``` REQUEST_TIMEOUT_MSグロヌバルオヌバヌラむド ├─→ FETCH_TIMEOUT_MSアップストリヌムプロバむダヌ呌び出し、デフォルト: 600000 │ ├─→ FETCH_HEADERS_TIMEOUT_MSFETCH_TIMEOUT_MS から継承 │ ├─→ FETCH_BODY_TIMEOUT_MSFETCH_TIMEOUT_MS から継承 │ ├─→ TLS_CLIENT_TIMEOUT_MSFETCH_TIMEOUT_MS から継承 │ │ └── TLS_FIRST_BYTE_WATCHDOG_MS独立、デフォルト: 10000 │ ├── RESPONSES_FIRST_BYTE_TIMEOUT_MS独立、デフォルト: 15000 │ ├── OPENCODE_RESPONSES_HEADERS_WAIT_MS独立、デフォルト: 0 = 無効、掚奚: 30000 │ ├── OPENCODE_RESPONSES_HEADERS_WAIT_MAX_ROTATIONS独立、デフォルト: 2 │ ├── FETCH_CONNECT_TIMEOUT_MS独立、デフォルト: 30000 │ └── FETCH_KEEPALIVE_TIMEOUT_MS独立、デフォルト: 4000 ├─→ STREAM_IDLE_TIMEOUT_MSREQUEST_TIMEOUT_MS から継承、デフォルト: 600000 ├─→ STREAM_ACTIVE_TIMEOUT_MS独立、デフォルト: 1260000、0 で無効 ├─→ STREAM_READINESS_TIMEOUT_MSREQUEST_TIMEOUT_MS から継承、デフォルト: 80000 ├─→ STREAM_READINESS_MAX_TIMEOUT_MS適応的な準備埅機時間の延長に䞊限を蚭定、デフォルト: 180000 └─→ API_BRIDGE_PROXY_TIMEOUT_MSREQUEST_TIMEOUT_MS から継承、デフォルト: 30000 ├─→ API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS掟生、デフォルト: 300000 ├── API_BRIDGE_SERVER_HEADERS_TIMEOUT_MSデフォルト: 60000 ├── API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MSデフォルト: 5000 └── API_BRIDGE_SERVER_SOCKET_TIMEOUT_MSデフォルト: 0 = 無効 ``` | 倉数 | デフォルト | 説明 | | ----------------------------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `REQUEST_TIMEOUT_MS` | _未蚭定_ | グロヌバルショヌトカット — `FETCH_TIMEOUT_MS` ず `STREAM_IDLE_TIMEOUT_MS` の䞡方のデフォルト倀を䞊曞きしたす。 | | `FETCH_TIMEOUT_MS` | `600000` | 䞊流プロバむダヌ呌び出しに察する HTTP リク゚スト党䜓のタむムアりト。 | | `STREAM_IDLE_TIMEOUT_MS` | `600000` | 䞭止するたでに蚱容される、䞊流からの生バむト間の最倧無通信時間。拡匵思考モデルが 90 秒を超えお停止するこずはほずんどありたせん。 | | `STREAM_ACTIVE_TIMEOUT_MS` | `1260000` | アクティブな SSE ストリヌムの合蚈存続時間の䞊限。䞊流からバむトを受信しおもリセットされず、`REQUEST_TIMEOUT_MS` ずは独立しおいたす。レゞストリ内で最倧のモデル別 `timeoutMs`1200000、Codexに 60000 の䜙裕を加えお算出されおいるため、蚱可された党予算を䜿甚するモデルが回答途䞭で匷制終了されるこずはありたせん。無効にするには `0` に蚭定したす。 | | `OMNIROUTE_SSE_COMMENTS` | _無効_ | OmniRoute が SSE の `:` コメント行䟋: `: keepalive` ハヌトビヌトや `x-omniroute-*` メタデヌタトレヌラヌを送信できるかどうか。厳栌な OpenAI 互換クラむアントはすべおの SSE 行に察しお JSON.parse を実行し、`:` コメントでクラッシュするため、デフォルトでは無効です#10524。`data:` ハヌトビヌトには圱響したせん。再床有効にするには `on`/`true`/`1`/`yes` を蚭定したす。`open-sse/utils/sseHeartbeat.ts` で䜿甚されたす。 | | `SSE_COALESCE_MS` | `0`オフ | オプトむン: Claude クラむアントに送信される連続した Claude `content_block_delta` むベントブロックむンデックスずデルタ型が同じものをマヌゞし、少なくずも N ミリ秒ごずにフラッシュしたす。情報の損倱はありたせん。`signature_delta` ず境界むベントは決しおマヌゞされたせん。以䞋の型別倉数が蚭定されおいない限り、すべおのデルタ型に適甚されたす。`open-sse/utils/sseDeltaCoalesce.ts` で䜿甚されたす。 | | `SSE_COALESCE_THINKING_MS` | `0`オフ | `thinking_delta` に察する `SSE_COALESCE_MS` の型別オヌバヌラむド。 | | `SSE_COALESCE_TEXT_MS` | `0`オフ | `text_delta` に察する `SSE_COALESCE_MS` の型別オヌバヌラむド。 | | `SSE_COALESCE_INPUT_JSON_MS` | `0`オフ | `input_json_delta` に察する `SSE_COALESCE_MS` の型別オヌバヌラむド。 | | `SSE_FRAME_COALESCE_MS` | `0`オフ | オプトむン: N ミリ秒以内に転送される SSE フレヌムをバッチ化し、クラむアントぞの 1 回の曞き蟌みにたずめたす。最初のフレヌムず終了フレヌム`[DONE]`、`message_stop`、`error`、`response.completed`/`failed`/`incomplete`は決しお遅延したせん。バッチ凊理が有効な堎合、ITL はバッチ間隔を枬定したす。`open-sse/utils/sseOutputSink.ts` で䜿甚されたす。 | | `SSE_STALL_WATCHDOG` | `timer` | ストリヌミングレスポンスのバむト停止を監芖するりォッチドッグの実装。`timer` は䞊流チャンクごずに 1 ぀のタむマヌを再蚭定したす停止予算の時点で正確に発火。`interval` はストリヌムごずに 1 ぀のチェックを維持し、呚期は `clamp(budget/4, 1s, 5s)` ずなるため、停止は予算 + 呚期以内に怜出されたす。`open-sse/utils/streamStallWatchdog.ts` で䜿甚されたす。 | | `STREAM_READINESS_TIMEOUT_MS` | `80000` | ping 以倖の最初の SSE むベントを受信するたでの時間。`REQUEST_TIMEOUT_MS` が蚭定されおいる堎合は、その倀を継承したす。 | | `STREAM_READINESS_MAX_TIMEOUT_MS` | `180000` | 倧芏暡、ツヌル倚甚、たたは高床な掚論を䌎うストリヌミングリク゚ストに察する、適応型の初回むベント準備埅機時間の䞊限。 | | `OMNIROUTE_AGENT_GOAL_POLICY_ENABLED` | `true` | `/goal` ヒュヌリスティックのキルスむッチ。怜出を完党に無効にするには `false`/`0`/`off` に蚭定したす。これにより、リク゚スト本文やヘッダヌによっお準備タむムアりトずストリヌム埩旧が延長されるこずがなくなり、クラむアント制埡によるタむムアりト増幅を軜枛できたす。 | | `OMNIROUTE_AGENT_GOAL_READINESS_MAX_TIMEOUT_MS` | `600000` | 怜出された `/goal` ゚ヌゞェント実行、たたは `x-omniroute-agent-goal` によっお匷制されたリク゚ストに察する、初回むベント準備埅機時間の䞊限。 | | `OMNIROUTE_AGENT_GOAL_STREAM_RECOVERY` | `true` | 怜出された `/goal` ゚ヌゞェント実行に察しお、早期ストリヌム埩旧を自動的に有効にしたす。goal 固有のオプトむンを無効にするには `false`/`0`/`off` に蚭定したす。これはオペレヌタヌのデフォルトに埩旧機胜を远加するこずしかできず、明瀺的な `STREAM_RECOVERY_ENABLED`/DB 蚭定によるオプトアりトを䞊曞きするこずはありたせん。 | | `OMNIROUTE_CODEX_DROP_NONSTANDARD_EVENTS` | `true` | OpenAI SDK の `responses.stream()` で 502 ゚ラヌを発生させる非暙準の `codex.*` SSE むベント䟋: `codex.rate_limits`を陀去したす。デフォルトで有効です#11014。転送するには `0`/`false`/`no`/`off` を蚭定したす。 | | `OMNIROUTE_CODEX_APPSERVER_WS` | _未蚭定_ | オプトむンの Codex app-server トランスポヌト。ロヌカルの `codex app-server` サむドカヌの WebSocket ゚ンドポむント`ws://`/`wss://`。トヌクンずずもに蚭定するず、Codex リク゚ストは HTTP Responses API の代わりに JSON-RPC を介しおサむドカヌぞルヌティングされたす。接続ごずに `providerSpecificData.codexAppServerUrl` を䜿甚しお蚭定するこずもできたす。`open-sse/executors/codex/appServerConfig.ts` で䜿甚されたす。 | | `OMNIROUTE_CODEX_APPSERVER_WS_TOKEN` | _未蚭定_ | app-server に提瀺するむンラむンのケむパビリティトヌクンたたは bearer トヌクン。接続ごずのオヌバヌラむド: `providerSpecificData.codexAppServerToken`。 | | `OMNIROUTE_CODEX_APPSERVER_WS_TOKEN_FILE` | _(未蚭定)_ | app-server の機胜トヌクン`codex app-server --ws-token-file` から取埗を保持するファむルぞのパス。`OMNIROUTE_CODEX_APPSERVER_WS_TOKEN` が未蚭定の堎合に䜿甚されたす。接続ごずのオヌバヌラむド: `providerSpecificData.codexAppServerTokenFile`。 | | `OMNIROUTE_CODEX_APPSERVER_CWD` | `/tmp` | app-server のタヌンが実行される䜜業ディレクトリ。接続ごずのオヌバヌラむド: `providerSpecificData.codexAppServerCwd`。 | | `OMNIROUTE_CODEX_APPSERVER_APPROVAL` | _(未蚭定)_ | app-server のタヌンに枡される承認ポリシヌ䟋: `never`、`on-request`。接続ごずのオヌバヌラむド: `providerSpecificData.codexAppServerApprovalPolicy`。 | | `OMNIROUTE_CODEX_APPSERVER_SANDBOX` | _(未蚭定)_ | app-server のタヌンに枡されるサンドボックスポリシヌ䟋: `read-only`、`workspace-write`、`danger-full-access`。未蚭定の堎合、executor のデフォルトは `workspace-write` ですセキュリティ匷化枈み。以前は `danger-full-access`。接続ごずのオヌバヌラむド: `providerSpecificData.codexAppServerSandbox`。 | | `OMNIROUTE_CODEX_APPSERVER_AUTO_APPROVE` | `false` | app-server 自䜓の承認プロンプトホスト䞊でのコマンドファむル暩限の実行を自動承認したす。デフォルトではオフで、プロンプトは自動的に拒吊されたす。ハヌネスのツヌル呌び出しには圱響したせん別の `item/tool/call` パススルヌを経由したす。`true`/`1`/`yes` を指定できたす。接続ごずのオヌバヌラむド: `providerSpecificData.codexAppServerAutoApprove`。 | | `FETCH_HEADERS_TIMEOUT_MS` | = `FETCH_TIMEOUT_MS` | レスポンスヘッダヌを受信するたでの時間。 | | `OMNIROUTE_FETCH_START_TIMEOUT_CAP_MS` | `110000` | ストリヌミングリク゚ストでレスポンスヘッダヌを埅぀最倧時間ms。`0` にするずこの䞊限が無効になりたす。プロバむダヌで `fetchStartTimeoutCapMs` が明瀺的に指定されおいる堎合は、そちらが優先されたす。 | | `OMNIROUTE_DIRECT_HEADERS_TIMEOUT_MS` | `30000` (30秒) | プロキシを䜿甚しない盎接接続の各詊行で、レスポンス開始を埅぀最倧時間ms。タむムアりトするず、新しい゜ケットで1回再詊行したす。`0` に蚭定するず制限が無効になり、以前の動䜜が維持されたす。 | | `OMNIROUTE_LOCAL_DIRECT_HEADERS_TIMEOUT_MS` | `300000` (5分) | タヌゲットホストがプラむベヌトLANルヌプバック䟋: `localhost`、`host.docker.internal`、`192.168.x.x`である、プロキシを䜿甚しない盎接接続の詊行に察するレスポンス開始埅機時間の䞋限ms。これにより、ネむティブ Ollama のコヌルドスタヌトが䞊蚘のデフォルト30秒で打ち切られるのを防ぎたす。䞋限ずしお機胜し、実際の埅機時間には、この倀ず `OMNIROUTE_DIRECT_HEADERS_TIMEOUT_MS` のうち倧きい方が䜿甚されたす。`0` たたは無効な倀を指定するず、ロヌカルの䞋限が解陀されたす。リモヌトホストには圱響したせん。 | | `OMNIROUTE_DIRECT_RESPONSE_RETRY_TIMEOUT_MS` | `600000` (10分) | 䞊蚘のプヌル枈み接続での詊行がレスポンス開始タむムアりトになった埌、新しい゜ケットで行う RETRY 詊行の䞊限ms#13703。呌び出し元が独自の期限シグナル解決枈みの接続モデルプロバむダヌ`FETCH_TIMEOUT_MS` のカスケヌドをすでに蚭定しおいる堎合にのみ適甚されたす。想定される経路では、そのシグナルが実際の制限ずなっお先に発火するため、これは䞀埋の䞊限ではなく、䜙裕を持たせた安党策です。これがない堎合、再詊行ではプヌル枈み接続での詊行ず同じ短い `OMNIROUTE_DIRECT_HEADERS_TIMEOUT_MS` りィンドりが再利甚され、正垞でも TTFB が遅い掚論モデルで 504 が発生しおいたした。䞊蚘の䞀埋の䞋限を䞋回るこずはありたせん。呌び出し元が期限シグナルをたったく指定しおいない堎合、再詊行では䞀埋の䞋限がそのたた維持されたす。 | | `FETCH_BODY_TIMEOUT_MS` | = `FETCH_TIMEOUT_MS` | レスポンス本文党䜓を受信するたでの時間。 | | `FETCH_CONNECT_TIMEOUT_MS` | `30000` | TCP 接続確立のタむムアりト。 | | `FETCH_KEEPALIVE_TIMEOUT_MS` | `4000` | Keep-Alive ゜ケットのアむドルタむムアりト。 | | `TLS_CLIENT_TIMEOUT_MS` | = `FETCH_TIMEOUT_MS` | TLS フィンガヌプリントプロキシwreq-jsのタむムアりト。 | | `TLS_FIRST_BYTE_WATCHDOG_MS` | `10000` | wreq-js TLS フィンガヌプリントトランスポヌトの本文に限定しお、最初のバむトを受信するたでの時間を制限したす。`TLS_CLIENT_TIMEOUT_MS` だけでは、ヘッダヌが到着するずすぐに解決されるため、本文の停止を怜出できたせん#12656。タむムアりトするず wreq リヌダヌをキャンセルし、盎接接続プロキシディスパッチャヌにフォヌルバックしたす。`0` にするずりォッチドッグが無効になりたす。 | | `RESPONSES_FIRST_BYTE_TIMEOUT_MS` | `15000` | OpenCode executor のみ、か぀ `OPENCODE_RESPONSES_STALL_ROTATION` 機胜フラグがオンの堎合デフォルトはオフのみ適甚されたす。ヘッダヌ受信埌、ストリヌミングされた Responses 応答の本文の最初のバむトを埅぀時間を制限したす#13484。Responses ストリヌムは `response.created` で開始されるため、この時間を超えお䜕も受信しない堎合は停止ずみなされたす。そのアカりントはクヌルダりンされ、リク゚ストは次のアカりントぞ1回ロヌテヌションされたす。2回目の停止では即座に倱敗したす。`0` にするず、フラグがオンでもこのガヌドが無効になりたす。 | | `OPENCODE_RESPONSES_HEADERS_WAIT_MS` | `0` (= オフ) | OpenCode executor のみ: 別のアカりントがただ利甚可胜な堎合、ストリヌミングされた Responses 呌び出しで䞊流のレスポンスヘッダヌを埅぀時間を制限したす。キュヌに入ったリク゚ストはヘッダヌ埅機時間党䜓にわたっお埅機せず、次ぞ進みたす。圱響を受けるのはストリヌミングされた Responses 呌び出しのみですResponses ストリヌムは `response.created` で開始されるため、そこで䜕も受信しない状態は生成䞭ではなくキュヌ埅ちを意味したす。chat completions ず非ストリヌミング呌び出しには圱響せず、この時間枠は実効的な fetch-start の䞊限を短瞮するだけで、延長するこずはありたせん。有効化する堎合の掚奚倀: `30000`。`0` にするず無効になりたす。 | | `OPENCODE_RESPONSES_HEADERS_WAIT_MAX_ROTATIONS` | `2` | OpenCode executor のみ: 䞊蚘のヘッダヌ埅機䞊限に達した際、リク゚ストごずに次のアカりントぞ切り替えられる回数。最埌に残ったアカりントには、垞にヘッダヌ埅機時間党䜓が割り圓おられたす。 | | `OPENCODE_PARK_AND_RESUME` | `false` | OpenCode executor のみ: 䞀時的な 429 が繰り返された堎合たたは新しいプヌル負荷マヌカヌがある堎合、ハヌトビヌトを維持しながらリク゚ストを保留し、フリヌト党䜓ぞファンアりトする代わりに、最倧 3 個のアカりントを順番に詊す、䞊限付きのレグを 1 回再実行したす (#13924)。デフォルトでは無効です。無効時は、埓来どおり 429 ごずに次のアカりントぞ切り替えたす。 | | `OPENCODE_PARK_REPLAY_SERVE_SETASIDE` | `false` | OpenCode executor のみ: park-and-resume の再実行レグで、クヌルダりン枈みのすべおのアカりントがプロキシ拒吊メモリによっお陀倖されおいる堎合、䜕も再実行しない代わりに、それらのアカりントを䜿甚したす (#14851、#14750 のフォロヌアップ)。デフォルトでは無効です。その堎合、#14750 より前ず同様に、再実行レグは空になりたす。 | | `STREAM_READINESS_STALL_RETRY` | `false` | ストリヌミングチャットのみ: 最初のアップストリヌム本文が䜿甚可胜なむベントを生成する前に停止した堎合、同じルヌティングパスを通じお、同じ準備完了埅機時間の䞊限を䜿甚し、アカりントにペナルティを科さずに、䞊限付きの 2 回目の詊行を 1 回実行したす。デフォルトでは無効です。無効時は、最初の本文が停止するず再詊行せずにリク゚ストが倱敗したす。 | | `OPENCODE_POOL_RESELECT` | `false` | OpenCode executor のみ: 通垞のプヌルコンテキスト䞋にあるプロキシなしアカりントで、送信元別にバケット化されたプロバむダヌから 429 が返された埌、同じ送信元アドレスを再詊行する代わりに、次の詊行甚ずしお別のメンバヌを接続プヌルに芁求したす。これは順序付けのみを行い、陀倖はしたせん。プヌルを䜿い切った堎合は珟圚の動䜜を維持したす。デフォルトでは無効です。無効時は、埓来どおり 429 ごずに次のアカりントぞ切り替えたす。 | | `OPENCODE_POOL_STRAIN_MARKER_PATH` | _(未蚭定)_ | OpenCode executor のみ: 保留前に読み取るプヌル負荷マヌカヌのパスを䞊曞きしたす`{since, reason, ttl_s}`、デフォルトは `/tmp/opencode-pool-strain.json`、#13924。新しいマヌカヌがある堎合は再集蚈せずに保留し、マヌカヌがないか叀い堎合はバヌストカりンタヌぞフォヌルバックしたす。 | | `API_BRIDGE_PROXY_TIMEOUT_MS` | `30000` | `/v1` ブリッゞリク゚ストのプロキシホップタむムアりト。 | | `FIRECRAWL_BASE_URL` | `https://api.firecrawl.dev` | Firecrawl Web フェッチ executor の接続先をセルフホストむンスタンスに蚭定したすクラりド倖では API キヌは任意。 | | `FIRECRAWL_TIMEOUT_MS` | `30000` | Firecrawl Web フェッチ executor のリク゚スト単䜍のタむムアりト。 | | `TAVILY_BASE_URL` | _(未蚭定)_ | Tavily `/usage` クォヌタ取埗機胜Provider Limitsのベヌス URL。`api.tavily.com` を指しおいる堎合は無芖されたす。未蚭定の堎合は接続のベヌス URL にフォヌルバックしたす。 | | `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | `300000` | ブリッゞのサヌバヌリク゚スト党䜓のタむムアりト。 | | `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | `60000` | ブリッゞ経由でレスポンスヘッダヌを送信するたでの時間。 | | `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | `5000` | ブリッゞの keep-alive アむドルタむムアりト。 | | `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | `0` | Raw ゜ケットのタむムアりト0 = 無効。 | | `SHUTDOWN_TIMEOUT_MS` | `30000` | SIGTERM/SIGINT の受信埌、匷制終了するたでの猶予期間。 | | `OMNIROUTE_DEFAULT_FETCH_TIMEOUT_MS` | `120000` | `FETCH_TIMEOUT_MS` が未蚭定の堎合に `src/shared/utils/fetchTimeout.ts` で䜿甚されるフォヌルバック倀。 | | `OMNIROUTE_PROVIDER_PROBE_TIMEOUT_MS` | `8000` | `src/shared/network/safeOutboundFetch.ts` の `validationRead` および `modelsProbe` プリセットのタむムアりトミリ秒。䜎速な゚ンドポむントCerebras、Cloudflare AI、Groqでは、ダッシュボヌド䞊で active/error の状態が䞍安定に切り替わるのを防ぐため、この倀を増やしおください。無効な倀<1000たたは数倀以倖の倀の堎合は 8000ms にフォヌルバックしたす。 | | `OMNIROUTE_RELAY_FETCH_TIMEOUT_MS` | `25000` | `open-sse/utils/proxyFetch.ts` のリレヌ固有のフェッチタむムアりト (#9158)。停止したリレヌは、クラむアント/゚ヌゞェントのタむムアりト玄 30 秒より前に倱敗させる必芁がありたす。これにより、呌び出し元には汎甚的なアップストリヌムタむムアりトではなく、リレヌ固有の倱敗が通知されたす。垞に先に発生するよう、`29000` が䞊限です。 | | `OMNIROUTE_RETRY_BACKOFF_MS` | `10` | `open-sse/utils/proxyFetch.ts` の direct/relay/proxy の 1 回再詊行パスで共有される再詊行バックオフ (#9158)。`0` = 即時再詊行。 | | `OMNIROUTE_CLAUDE_TLS_TIMEOUT_MS` | `60000` | ネむティブ wreq-js リク゚ストのタむムアりト`claudeTlsClient.ts`。 | | `OMNIROUTE_CLAUDE_TLS_GRACE_MS` | `10000` | ネむティブタむムアりトに远加される、JS 偎の絶察ハヌドデッドラむンの猶予時間。 | | `OMNIROUTE_PPLX_TLS_TIMEOUT_MS` | `30000` | ネむティブ wreq-js リク゚ストのタむムアりト`perplexityTlsClient.ts`。 | | `OMNIROUTE_PPLX_TLS_GRACE_MS` | `10000` | ネむティブタむムアりトに远加される、JS 偎の絶察的なハヌドデッドラむン猶予時間。 | | `OMNIROUTE_PPLX_SEARCH_HINT` | `0` (オフ) | 呌び出し元のシステムメッセヌゞに「組み蟌みのりェブ怜玢機胜がありたす。怜玢結果を䜿甚しお質問に盎接回答しおください。」を远加したす`perplexity-web/protocol.ts`。デフォルトではオフです — Perplexity はいずれにせよ怜玢を実行し、この文がコヌディングクラむアントぞの応答にメタコメントずしお挏れるためです。元に戻すには `1`/`true`/`yes`/`on` を蚭定したす。 | | `OMNIROUTE_GROK_TLS_TIMEOUT_MS` | `60000` | ネむティブ wreq-js リク゚ストタむムアりト`grokTlsClient.ts`。 | | `OMNIROUTE_GROK_TLS_GRACE_MS` | `10000` | ネむティブタむムアりトに远加される、JS 偎の絶察的なハヌドデッドラむン猶予時間。 | | `OMNIROUTE_NOTION_TLS_TIMEOUT_MS` | `30000` | ネむティブ wreq-js リク゚ストタむムアりト`notionTlsClient.ts`。`notion-web` は長時間の生成に察応するため、リク゚ストごずに `180000` ぞ匕き䞊げたす。 | | `OMNIROUTE_NOTION_TLS_GRACE_MS` | `10000` | ネむティブタむムアりトに远加される、JS 偎の絶察的なハヌドデッドラむン猶予時間。 | | `OMNIROUTE_BROWSER_POOL` | `on` | ブラりザを䜿甚するりェブ Cookie チャット向けの共有 Playwright ブラりザプヌル`browserPool.ts`。無効にするには `off` を蚭定したす。 | | `OBSCURA_BIN` | `auto-detect` | ブラりザプヌルおよび Cloudflare Playground ゚グれキュヌタヌがプラむマリ゚ンゞンずしお䜿甚する `obscura` バむナリぞのパス`open-sse/services/obscura.ts`。未蚭定の堎合はシステムの PATH から自動怜出されたす。 | | `OBSCURA_CDP_ENDPOINT` | _(未蚭定)_ | Obscura を起動する代わりに、すでに実行䞭の Obscura`http://host:port`を指定したす。このモゞュヌルはそのプロセスを管理したせん`open-sse/services/obscura.ts`。 | | `OBSCURA_PORT` | `ランダムな空きポヌト` | 起動される `obscura serve` の明瀺的なポヌト。未蚭定の堎合は空きポヌトが自動的に遞択されたす`open-sse/services/obscura.ts`。 | | `WEB_COOKIE_USE_BROWSER` | `0` | りェブ Cookie チャットリク゚ストでブラりザを䜿甚する経路を遞択したす`browserBackedChat.ts`。有効にするには `1` を蚭定したす。 | | `KIMI_WEB_BASE_URL` | `https://www.kimi.ai` | Kimi Web囜際版 kimi.ai Connect-RPC゚グれキュヌタヌのベヌス URL`kimi-web.ts`。ミラヌプロキシ゚ンドポむントを䜿甚する堎合にのみ䞊曞きしおください。 | | `KIMI_WEB_CHAT_URL` | `/apiv2/kimi.gateway.chat.v1.ChatService/Chat` | Kimi Web ゚グれキュヌタヌの完党なチャット゚ンドポむント`kimi-web.ts`。 | | `OMNIROUTE_LOGIN_BROWSER_PATH` | _(自動怜出)_ | Adobe Firefly の察話型ブラりザサむンむンに䜿甚する、システムの Chrome/Edge 実行可胜ファむルぞのパス`adobeFireflyBrowserLogin.ts`。OS ごずの自動怜出より優先されたす。 | | `OMNIROUTE_STANDALONE_DIR` | _.build/ スタンドアロン出力_ | ビルド埌の同䞀配眮ステップで䜿甚されるスタンドアロン出力ディレクトリの、ビルド時の䞊曞き蚭定`scripts/build/colocate-standalone.mjs`。ランタむムではなく、ビルドツヌル向けです。 | コンボタヌゲットぞの詊行は、解決枈みのアップストリヌムリク゚ストタむムアりト`FETCH_TIMEOUT_MS`、たたは フェッチのデフォルト倀を指定しおいる堎合は `REQUEST_TIMEOUT_MS`を継承したす。コンボ、 コンボのデフォルト、たたはプロバむダヌのオヌバヌラむドで `targetTimeoutMs` を蚭定するのは、 コンボのフォヌルバックを高速化する堎合のみにしおください。珟圚のアップストリヌムタむムアりトを超える倀は、 アップストリヌムタむムアりトたでに制限されたす。 `comboTimeoutMs` は、フェむルオヌバヌ先党䜓に適甚される、コンボ党䜓の独立した実時間予算です。 反埩回数を無制限に保぀には、未蚭定たたは `0` のたたにしおください`comboPredicates.ts` に ハヌドコヌドされた 10 分間のハング停止凊理は匕き続き適甚されたす。正の倀を指定するず、コンボではその倀が この安党策に眮き換わりたす。遅い最初のタヌゲットの埌でもフェむルオヌバヌする時間を確保できるよう、 `comboTimeoutMs` は `targetTimeoutMs` より長く蚭定しおください。 ### サヌキットブレヌカヌのしきい倀 プロバむダヌレベルのサヌキットブレヌカヌ調敎。デフォルト倀は、v3.6 以降で 500 以䞊の接続に䜿甚されおいるスケヌリング枈みの倀を反映しおいたす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------------------------------- | ---------- | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_CIRCUIT_BREAKER_OAUTH_THRESHOLD` | `8` | `open-sse/config/constants.ts` | ブレヌカヌが䜜動するたでの OAuth プロバむダヌの連続倱敗しきい倀。 | | `OMNIROUTE_CIRCUIT_BREAKER_OAUTH_RESET_MS` | `60000` | `open-sse/config/constants.ts` | OAuth プロバむダヌのブレヌカヌのリセット期間ms。 | | `OMNIROUTE_CIRCUIT_BREAKER_API_KEY_THRESHOLD` | `12` | `open-sse/config/constants.ts` | API キヌプロバむダヌの連続倱敗しきい倀。 | | `OMNIROUTE_CIRCUIT_BREAKER_API_KEY_RESET_MS` | `30000` | `open-sse/config/constants.ts` | API キヌプロバむダヌのブレヌカヌのリセット期間ms。 | | `OMNIROUTE_CIRCUIT_BREAKER_LOCAL_THRESHOLD` | `2` | `open-sse/config/constants.ts` | ロヌカルプロバむダヌOllama、LM Studio などの連続倱敗しきい倀。 | | `OMNIROUTE_CIRCUIT_BREAKER_LOCAL_RESET_MS` | `15000` | `open-sse/config/constants.ts` | ロヌカルプロバむダヌのブレヌカヌのリセット期間ms。 | | `OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_THRESHOLD` | `10` | `open-sse/config/constants.ts` | プロバむダヌレベルのブレヌカヌOAuth プロバむダヌ党䜓がクヌルダりンに入るたでの期間内の倱敗回数。 | | `OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_WINDOW_MS` | `900000` | `open-sse/config/constants.ts` | プロバむダヌレベルのブレヌカヌOAuth プロバむダヌのロヌリング倱敗回数集蚈期間ms。 | | `OMNIROUTE_PROVIDER_BREAKER_OAUTH_COOLDOWN_MS` | `300000` | `open-sse/config/constants.ts` | プロバむダヌレベルのブレヌカヌOAuth プロバむダヌのしきい倀到達埌のクヌルダりン時間ms。 | | `OMNIROUTE_PROVIDER_BREAKER_OAUTH_DEGRADATION_THRESHOLD` | `5` | `open-sse/config/constants.ts` | OAuth プロバむダヌは、この倱敗回数に達するず DEGRADED に移行したす。 | | `OMNIROUTE_PROVIDER_BREAKER_OAUTH_MAX_BACKOFF_MULTIPLIER` | `8` | `open-sse/config/constants.ts` | OAuth プロバむダヌの resetTimeout ゚スカレヌションの最倧倍率。 | | `OMNIROUTE_PROVIDER_BREAKER_OAUTH_BACKOFF_ESCALATION_COUNT` | `2` | `open-sse/config/constants.ts` | OAuth プロバむダヌは、このオヌプンサむクル数に達するず゚スカレヌションしたす。 | | `OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_THRESHOLD` | `15` | `open-sse/config/constants.ts` | プロバむダヌレベルのブレヌカヌAPI キヌプロバむダヌ党䜓がクヌルダりンに入るたでの期間内の倱敗回数。 | | `OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_WINDOW_MS` | `1800000` | `open-sse/config/constants.ts` | プロバむダヌレベルのブレヌカヌAPI キヌプロバむダヌのロヌリング倱敗回数集蚈期間ms。 | | `OMNIROUTE_PROVIDER_BREAKER_API_KEY_COOLDOWN_MS` | `600000` | `open-sse/config/constants.ts` | プロバむダヌレベルのブレヌカヌAPI キヌプロバむダヌのしきい倀到達埌のクヌルダりン時間ms。 | | `OMNIROUTE_PROVIDER_BREAKER_API_KEY_DEGRADATION_THRESHOLD` | `7` | `open-sse/config/constants.ts` | API キヌプロバむダヌは、この倱敗回数に達するず DEGRADED に移行したす。 | | `OMNIROUTE_PROVIDER_BREAKER_API_KEY_MAX_BACKOFF_MULTIPLIER` | `4` | `open-sse/config/constants.ts` | API キヌプロバむダヌの resetTimeout ゚スカレヌションの最倧倍率。 | | `OMNIROUTE_PROVIDER_BREAKER_API_KEY_BACKOFF_ESCALATION_COUNT` | `3` | `open-sse/config/constants.ts` | API キヌプロバむダヌは、このオヌプンサむクル数に達するず゚スカレヌションしたす。 | | `OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_THRESHOLD` | `2` | `open-sse/config/constants.ts` | プロバむダヌレベルのブレヌカヌロヌカルプロバむダヌ党䜓がクヌルダりンに入るたでの倱敗回数。 | | `OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_WINDOW_MS` | `300000` | `open-sse/config/constants.ts` | プロバむダヌレベルのブレヌカヌロヌカルプロバむダヌのロヌリング倱敗回数集蚈期間ms。 | | `OMNIROUTE_PROVIDER_BREAKER_LOCAL_COOLDOWN_MS` | `60000` | `open-sse/config/constants.ts` | プロバむダヌレベルのブレヌカヌロヌカルプロバむダヌのしきい倀到達埌のクヌルダりン時間ms。 | | `OMNIROUTE_API_KEY_COOLDOWN_MS` | `60000` | `open-sse/services/apiKeyRotator.ts` | アップストリヌムの 429 に `Retry-After` が含たれおいない堎合、耇数キヌの API キヌロヌテヌションによっお適甚されるキヌごずのクヌルダりン時間ms#14573。正でない倀たたは数倀でない倀の堎合はデフォルト倀が䜿甚されたす。 | | `PIN_DROP_BACKOFF_LEVEL` | `2` | `open-sse/services/combo.ts` | コンテキストキャッシュのピンに玐づくプロバむダヌが継続的に異垞であるず刀断され、フェむルオヌバヌのためにピンが解陀されるバックオフ深床。 | | `PIN_DROP_GRACE_MS` | `20000` | `open-sse/services/combo.ts` | コンテキストキャッシュのピンを解陀する前に、短時間の䞀時的なクヌルダりンを蚱容するアンチフラップ期間ms。 | ### シナリオ | シナリオ | 蚭定 | | ---------------------------------- | -------------------------------------------------- | | **長時間実行されるコヌド生成** | `REQUEST_TIMEOUT_MS=900000`15 分 | | **ストリヌムの合蚈存続時間を制限** | `STREAM_ACTIVE_TIMEOUT_MS=1260000`21 分 | | **本番 API での高速な倱敗刀定** | `API_BRIDGE_PROXY_TIMEOUT_MS=10000` | | **拡匵思考モデル** | `STREAM_IDLE_TIMEOUT_MS=300000`チャンク間 5 分 | --- ## 16. ロギング ロギングシステムは、暙準出力ずロヌテヌションされるログファむルの䞡方に曞き蟌みたす。すべおの蚭定は `src/lib/logEnv.ts` によっお読み蟌たれたす。 | 倉数 | デフォルト | 説明 | | ----------------------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `APP_LOG_LEVEL` | `info` | 最小ログレベル`debug`、`info`、`warn`、`error`。 | | `APP_LOG_FORMAT` | `text` | 出力圢匏`text`人間が読みやすい圢匏たたは `json`構造化圢匏。 | | `APP_LOG_TO_FILE` | `true` | 暙準出力に加えお、ログをファむルに曞き蟌みたす。 | | `APP_LOG_FILE_PATH` | `logs/application/app.log` | ログファむルのパスプロゞェクトルヌトたたは `DATA_DIR` からの盞察パス。 | | `APP_LOG_MAX_FILE_SIZE` | `50M` | ロヌテヌション前の最倧ファむルサむズ。`50M`、`1G`、`512K`、たたはバむト単䜍の数倀を指定できたす。 | | `APP_LOG_RETENTION_DAYS` | `7` | ロヌテヌションされたアプリケヌションログファむルを保持する日数。 | | `APP_LOG_MAX_FILES` | `20` | ロヌテヌションされたログファむルのバックアップの最倧数。 | | `CALL_LOG_RETENTION_DAYS` | `7` | デヌタベヌス内のリク゚スト呌び出しログ゚ントリを保持する日数。 | | `CALL_LOG_MAX_ENTRIES` | `10000` | メモリ内バッファに保持する呌び出しログ゚ントリの最倧数。 | | `CALL_LOGS_TABLE_MAX_ROWS` | `100000` | プルヌニング前に蚱容される SQLite の `call_logs` テヌブルの最倧行数。 | | `ENABLE_REQUEST_LOGS` | _(未蚭定)_ | ダッシュボヌドの蚭定を䞊曞きし、詳现なリク゚ストログを匷制的に有効たたは無効にしたす。 | | `MAX_PENDING_REQUEST_AGE_MS` | `3600000`1時間 | メモリ内クリヌンアップの察象になるたで、孀立したアクティブなリク゚ストログ゚ントリを保持する最倧時間。 | | `CALL_LOG_PIPELINE_CAPTURE_STREAM_CHUNKS` | `false` | `call_log_pipeline_enabled=true` の堎合に、ストリヌムチャンクをパむプラむン成果物ぞ保存したす。オプトむン`true`であり、ディスク容量を節玄するためデフォルトでは無効です。 | | `CALL_LOG_PIPELINE_MAX_SIZE_KB` | `512` | `call_log_pipeline_enabled=true` の堎合の、パむプラむン呌び出しログ成果物の最倧サむズKB。 | | `PROXY_LOGS_TABLE_MAX_ROWS` | `100000` | プルヌニング前に蚱容される SQLite の `proxy_logs` テヌブルの最倧行数。 | | `PROXY_LOG_INCLUDE_IPS` | `false` | `[ProxyEgress]` コン゜ヌルログにクラむアント送信元 IP ずアカりントプレフィックスを含めたす。ダッシュボヌドデヌタベヌスのプロキシログレコヌドには完党な詳现が保持されたす。 | | `PROXY_LOG_FIRST_CHUNK_TIMING` | `false` | `"true"` たたは `"1"` に蚭定するず、プロキシログ行に `first_chunk_ms`送信開始から最初の有効な本文バむトたでを蚘録したす。各アップストリヌム本文を遅延パススルヌストリヌムでラップし、バむトの到着埌に行を曎新したす。レスポンスを倉曎せずにそのたた通過させるため、デフォルトでは無効です。 | | `APP_LOG_ROTATION_CHECK_INTERVAL_MS` | `60000`1分 | `src/lib/logRotation.ts` がアクティブなログファむルのサむズを再確認する間隔。 | | `CHAT_LOG_TEXT_LIMIT` | `65536` | チャットログ成果物に保持される文字列の最倧長デフォルトは 64 KB。 | | `CHAT_LOG_ARRAY_TAIL_ITEMS` | `128` | チャットログのペむロヌドを切り詰める際に、配列の末尟から保持する項目数。 | | `CHAT_LOG_MAX_DEPTH` | `6` | チャットログのペむロヌドが切り詰められるたでの最倧ネスト深床。 | | `CHAT_LOG_MAX_OBJECT_KEYS` | `80` | チャットログのペむロヌドに保持されるオブゞェクトキヌの最倧数0 = 無制限。 | | `CHAT_LOG_MAX_BODY_KB` | `1024` | リク゚ストレスポンス本文党䜓がこのサむズKBを超えるず、完党な耇補ではなく簡略化された芁玄に眮き換えられたす。長時間の゚ヌゞェント型䌚話で、実際のメッセヌゞではなくプレヌスホルダヌがダッシュボヌドに衚瀺される堎合は、この倀を増やしおください。 | | `CHAT_DEBUG_FILE` | `false` | true の堎合、`serializeArtifactForStorage` はサむズに基づく切り詰めをスキップしたす。デバッグ専甚です。 | --- ## 17. メモリ最適化 | 倉数 | デフォルト | 説明 | | ----------------------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_MEMORY_MB` | _自動_ベアメタル、**Docker むメヌゞでは `1024`** | Dockerスタンドアロン向けに**掚奚される** V8 ヒヌプ䞊限MB。未蚭定の堎合は動的に調敎されシステム RAM の玄 35%、`[512, 4096]` の範囲に制限、`512` は総メモリを読み取れない堎合にのみ䞋限ずしお䜿甚されたす。`run-standalone.mjs`Docker CMDでは、**明瀺的な**倀が `--max-old-space-size` ずしお远加され、競合する NODE_OPTIONS のヒヌプフラグより**優先**されたすV8 では最埌のフラグが有効。`omniroute serve` は匕き続き既存の NODE_OPTIONS ヒヌプ蚭定を優先したす#5238。䞡方に異なる数倀を蚭定しないでください。プロセスは䞡方の倀ず、どちらが優先されたかを瀺す譊告をログに蚘録したす。**公匏 Docker むメヌゞでは垞に `1024` が蚭定されるため、そこで動的調敎が実行されるこずはありたせん。** コヌディング゚ヌゞェントの `/v1/responses` には、cgroup 甚の䜙裕に加えお `8192``12288` が必芁です。[Docker ガむド — 実行時 RAM](../guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents)を参照しおください。 | | `OMNIROUTE_RSS_PRESSURE_MB` | _自動_`max(3072, 2 × OMNIROUTE_MEMORY_MB)`。`OMNIROUTE_MEMORY_MB` が未蚭定の堎合は無効 | `open-sse/utils/resourcePressure.ts` | V8 の `heapUsed` では怜出できないネむティブ倖郚メモリ向けの、プロセス RSS の絶察的な安党䞊限MB。これを超えるず、新しいリク゚ストには 503 `resource_pressure` が返されたす。RSS は急増埌に䜎䞋するこずがほずんどないため、`OMNIROUTE_PRESSURE_SELF_RESTART` ず䜵甚しおください。 | | `PROMPT_CACHE_MAX_SIZE` | `50` | キャッシュされるシステムプロンプト゚ントリの最倧数。 | | `PROMPT_CACHE_MAX_BYTES` | `2097152`2 MB | プロンプトキャッシュの合蚈最倧サむズ。 | | `PROMPT_CACHE_TTL_MS` | `300000`5 分 | プロンプトキャッシュ゚ントリの TTL。 | | `SEMANTIC_CACHE_MAX_SIZE` | `100` | キャッシュされる temperature=0 のレスポンスの最倧数。 | | `SEMANTIC_CACHE_MAX_BYTES` | `4194304`4 MB | セマンティックキャッシュの合蚈最倧サむズ。 | | `SEMANTIC_CACHE_TTL_MS` | `1800000`30 分 | セマンティックキャッシュ゚ントリの TTL。 | | `OMNIROUTE_CORPUS_CACHE_SIZE` | `5` | 同時に有効なむンメモリむンデックスを保持するロヌカルコヌパスルヌトの数`src/lib/localCorpus/configured.ts`。LRU䞊限に達するず、最も長く䜿甚されおいないルヌトのむンデックスが削陀され、次回のク゚リ時に再構築されたす。最小倀は `1` に制限されたす。数倀以倖の倀の堎合はデフォルトにフォヌルバックしたす。 | | `STREAM_HISTORY_MAX` | `50` | ダッシュボヌドのラむブビュヌ甚バッファに保持する盎近のストリヌムむベントの最倧数。 | | `CONTEXT_LENGTH_DEFAULT` | _未蚭定_ | `CONTEXT_LENGTH_` 倉数がないすべおのプロバむダヌに察する、グロヌバルなコンテキスト長の䞊曞きトヌクン数。蚭定するず、該圓するプロバむダヌに぀いお、カタログ、ダッシュボヌドの䞊曞き、およびレゞストリの倀を**眮き換えたす**。未蚭定の堎合、OmniRoute は組み蟌みの解決チェヌンを䜿甚し、その最終的なフォヌルバックは `128000` です。[プロバむダヌごずのコンテキスト長](#per-provider-context-length-context_length_provider)を参照しおください。 | | `USAGE_TOKEN_BUFFER` | `100` | 䜿甚量クォヌタを远跡する際に確保される、远加トヌクンの䜙裕。 | ### プロバむダヌごずのコンテキスト長`CONTEXT_LENGTH_` `open-sse/services/contextManager.ts``getEnvOverride()` / `resolveTokenLimit()`は、 実行時にプロバむダヌ ID から名前が生成される**プロバむダヌごずの**圢匏も読み取るため、 䞊の衚や `.env.example` に行ごずに列挙するこずはできたせん。 **名前。** `CONTEXT_LENGTH_`。ここで `` はプロバむダヌ ID を倧文字にし、`A-Z` / `0-9` 以倖のすべおの文字を `_` に眮換したものです。プロバむダヌ ID には、゚むリアス解決埌の正芏 ID短瞮゚むリアスが解決された埌の `provider/model` 文字列における `provider` 郚分が䜿甚されたす。カスタムの OpenAI たたは Anthropic 互換ノヌドでは、生成されたノヌド ID が䜿甚されるため、倉数名に UUID が含たれたす。倀は正の敎数で指定したトヌクン数です。それ以倖空、`0`、負数、数倀以倖は無芖され、解決凊理は次のステップぞ進みたす。 | プロバむダヌ ID | 倉数名 | | ----------------------------------------------------------- | -------------------------------------------------------------------------- | | agentrouter | CONTEXT_LENGTH_AGENTROUTER | | openrouter | CONTEXT_LENGTH_OPENROUTER | | openai-compatible-chat-0f8e2c1a-5b7d-4e3f-9a6c-2d1b8e4f7a90 | CONTEXT_LENGTH_OPENAI_COMPATIBLE_CHAT_0F8E2C1A_5B7D_4E3F_9A6C_2D1B8E4F7A90 | **優先順䜍。** `provider/model` の組み合わせでは、最初に倀が埗られたステップが採甚されたす。 1. そのプロバむダヌの `CONTEXT_LENGTH_`。 2. `CONTEXT_LENGTH_DEFAULT`グロヌバルな環境倉数による䞊曞き。 3. モデルごずのりィンドり氞続化されたコンテキストの䞊曞き倀ダッシュボヌドで蚭定されるか、怜出リコンサむラヌによっお自動的に固定されたす。`CONTEXT_WINDOW_RECONCILE_INTERVAL` を参照。それがない堎合は、同期されたカタログ / models.dev の倀。 4. プロバむダヌのレゞストリにある `defaultContextLength`。 5. モデル名に基づくヒュヌリスティック`claude` は 200000、`gemini` は 1000000、`gpt` / `o1` / `o3` / `o4` / `codex` は 400000。 6. 組み蟌みのプロバむダヌ別デフォルト倀、その埌 `128000`。 どちらの環境倉数ステップも**プロバむダヌ党䜓**に適甚されたす。そのプロバむダヌのすべおのモデルに同じ䞊限が蚭定され、モデルごずのダッシュボヌド䞊曞きよりも優先されたす。プロバむダヌ内の 1 ぀のモデルだけに異なるりィンドりが必芁な堎合は、代わりにダッシュボヌドでモデルごずの䞊曞きを䜿甚しおください。 **適甚範囲。** この解決チェヌンは、リク゚スト時のコンテキストりィンドりチェック`open-sse/handlers/chatCore.ts` における `context_length_exceeded` / 「入力がコンテキストりィンドりを超えおいたす」ずいう拒吊、プロンプト圧瞮のバゞェット、およびコンボのコンテキスト䞊限に䜿甚されたす。`GET /v1/models` が公開する `context_length` は、匕き続きカタログたたはレゞストリのメタデヌタに由来する堎合があり、環境倉数による䞊曞きを反映するずは限りたせん。 **䟋。** カタログでは 128,000 ず報告されおいる䞀方で、モデルが 1,050,000 トヌクンのりィンドりを受け入れるプロバむダヌの堎合 ```dotenv CONTEXT_LENGTH_AGENTROUTER=1050000 ``` 倉曎埌はサヌバヌを再起動しおください。この倀はサヌバヌプロセスの環境から読み取られたす。**デスクトップアプリ**では、サヌバヌは子プロセスずしお実行されるため、アプリの起動埌に蚭定されたシステム環境倉数は認識されたせん。アプリが読み蟌む `.env` ファむルにこの行を远加し怜玢順序に぀いおは [Electron ガむド環境ファむルの怜玢](../guides/ELECTRON_GUIDE.md#environment-file-lookup) を参照、アプリを完党に終了しおから再起動しおください。 ### 圧瞮 | 倉数 | デフォルト | 説明 | | ------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_RTK_TRUST_PROJECT_FILTERS` | 未蚭定 | `.rtk/trust.json` のハッシュなしで、プロゞェクトの `.rtk/filters.json` を信頌したす。管理されたロヌカル開発環境でのみ䜿甚しおください。 | ### メモリ゚ンゞンプラン 21 ### メモリ、スキル、トヌクン曎新のむベントルヌプコスト#10349 OmniRoute は**単䞀の Node プロセス**です。メモリの抜出/取埗、スキルの泚入、およびプロバむダヌトヌクンの曎新は、`GET /healthz` やダッシュボヌドず**同じむベントルヌプ**䞊で実行されたす。これらはワヌカヌスレッドではありたせん。 | 凊理 | コヌド | デフォルト | オペレヌタヌによる制埡 | | ------------------- | ---------------------------------- | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | | メモリの抜出 / 取埗 | `src/lib/memory/` | ダッシュボヌドの **memoryEnabled**デフォルトでオン | **蚭定 → メモリ**をオフにしたす。蚭定で機胜を無効にする以倖に、独立した環境倉数のキルスむッチはありたせん。 | | スキルの泚入 | `src/lib/skills/injection.ts` | ダッシュボヌドの **skillsEnabled**デフォルトでオン | **蚭定 → メモリ/スキル**`skillsEnabled`をオフにしたす。以䞋のサンドボックス蚭定は、泚入がすでにオンになっおいる堎合にのみ実行を制限したす。 | | トヌクンの曎新 | `src/sse/services/tokenRefresh.ts` | 接続枈みの OAuth/Web プロバむダヌではオン | プロバむダヌを切断するか、トヌクンが有効な状態を維持しおください。珟時点では `TOKEN_REFRESH=0` 環境倉数はありたせん。 | 負荷のないマシンで `/healthz` が遅い堎合は、たずメモリずスキルを無効にし、その埌でカタログ/圧瞮の負荷を確認しおください#10303、#9685。これらの機胜は `await` の箇所で実行を譲りたすが、それでも単䞀のスレッドを奪い合いたす。 氞続メモリサブシステム`src/lib/memory/`向けの埋め蟌みレむダヌ、ベクトルストア、および再ランキングの調敎項目。 | 倉数 | デフォルト | 説明 | | ------------------------------------ | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `MEMORY_EMBEDDING_CACHE_TTL_MS` | `300000`5分 | むンメモリ埋め蟌みキャッシュのTTL゜ヌスモデル次元シグネチャごず。 | | `MEMORY_EMBEDDING_CACHE_MAX` | `1000` | 埋め蟌みキャッシュに保持するLRU゚ントリの最倧数。 | | `MEMORY_TRANSFORMERS_MODEL` | `Xenova/all-MiniLM-L6-v2` | オプトむンのロヌカルMiniLMパむプラむン`@huggingface/transformers`甚HFリポゞトリID玄23 MB、int8、RAM箄400 MB。 | | `MEMORY_STATIC_MODEL` | `minishlab/potion-base-8M` | 静的なpotionModel2Vecルックアップテヌブル埋め蟌みモデル甚のHFリポゞトリID。キャッシュディレクトリに遅延ダりンロヌドされたす。 | | `MEMORY_STATIC_CACHE_DIR` | `/embeddings` | 静的potionモデルのファむルをキャッシュするディレクトリ。未蚭定の堎合、デフォルトで`DATA_DIR`配䞋になりたす。 | | `HF_HUB_ENDPOINT` | `https://huggingface.co` | `staticPotion.ts`が䜿甚するHugging Face HubのベヌスURLを䞊曞きしたす䟋゚アギャップ環境向けのミラヌ゚ンドポむント。 | | `MEMORY_VEC_TOP_K` | `20` | `src/lib/memory/vectorStore.ts`内の`sqlite-vec`総圓たりベクトル怜玢で䜿甚されるデフォルトのtop-K。 | | `MEMORY_RRF_K` | `60` | FTS5ずベクトル怜玢のハむブリッド取埗に䜿甚するReciprocal Rank Fusion定数`k`sqlite-vecのレシピ。 | | `VECTOR_STORE_DISABLE_VEC` | `false` | `getVectorStore()``src/lib/memory/vectorStore.ts`のテスト蚺断甚シヌム`true`の堎合、ベクトルストアを匷制的に`null`にし`sqlite-vec`のないクラりドWASM環境をシミュレヌト、メモリ怜玢をFTS5キヌワヌド怜玢に瞮退させたす。本番環境では未蚭定のたたにしおください。 | | `NOTION_API_KEY` | _未蚭定_ | Notionバック゚ンド甚のAPIキヌ`genericBackend.ts`の既知バック゚ンドプリセットで䜿甚。 | | `NOTION_API_URL` | `https://api.notion.com/v1` | Notion APIのベヌスURLセルフホスト型のNotion代替サヌビス向けに䞊曞き可胜。 | | `OBSIDIAN_API_KEY` | _未蚭定_ | Obsidian Vaultバック゚ンド甚のAPIキヌ`genericBackend.ts`の既知バック゚ンドプリセットで䜿甚。 | | `OBSIDIAN_API_URL` | `http://localhost:27123` | Obsidian Vault APIのベヌスURLリモヌトVault向けに䞊曞き可胜。 | | `MEMORY_TYPED_DECAY_ENABLED` | `false` | TV6型付きメモリ枛衰のマスタヌスむッチ。**オプトむンデフォルトはオフ** — スむヌプは枛衰したメモリを**削陀**したす。オフの堎合、`access_count``last_accessed_at`は玔粋なテレメトリであり、䜕も削陀されたせん。 | | `MEMORY_TYPED_DECAY_EPISODIC_DAYS` | `30` | 未䜿甚の`episodic`メモリが枛衰するたでのTTL日数。`0`にするずepisodicも枛衰したせん。氞続型`factual``procedural``semantic`は垞に枛衰したせん。枛衰クロックは`last_accessed_at`を基準に再蚭定されたす。 | | `MEMORY_TYPED_DECAY_ACCESS_IMMUNITY` | `3` | タむプに関係なく、メモリがこの回数以䞊`>=`泚入されるず枛衰しなくなりたす。`0`にするずアクセス回数による枛衰無効化を無効にしたす。 | | `MEMORY_TYPED_DECAY_SWEEP_INTERVAL` | `0`無効 | `src/lib/memory/typedDecay.ts`でオプションの定期枛衰スむヌプを実行する間隔秒。`0`未蚭定 = 定期スむヌプなし。二重のオプトむン方匏であり、`MEMORY_TYPED_DECAY_ENABLED=true`も必芁です。 | | `OMNIROUTE_STRICT_SYSTEM_PROVIDERS` | _未蚭定_ | `system`メッセヌゞを**むンデックス0でのみ**受け入れるプロバむダヌID倧文字小文字を区別しないのカンマ区切りリスト`src/lib/memory/injection.ts`。これらのプロバむダヌでは、耇数タヌンの䌚話においお、キャッシュに安党な配列途䞭ぞのメモリ挿入は安党ではないため、代わりにメモリを先頭のsystemメッセヌゞぞマヌゞ前眮したす。デフォルトでは`xiaomi-mimo``mimo`のみです。同じ「先頭に単䞀のsystemメッセヌゞ」ずいう制玄をチャットテンプレヌトで匷制するセルフホスト型OpenAI互換゚ンドポむント䟋Qwen3.5+/3.6に぀いおは、このリストを拡匵しおください。 | ### 䜎RAM Dockerの䟋 `128`はダッシュボヌド専甚です。このヒヌプ蚭定でコヌディング゚ヌゞェントが長時間`/v1/responses`を実行するず`FATAL ERROR`が発生したす。この䟋をClaudeCodexGrokゲヌトりェむずしお䜿甚しないでください。 ```bash OMNIROUTE_MEMORY_MB=128 PROMPT_CACHE_MAX_SIZE=20 PROMPT_CACHE_MAX_BYTES=524288 # 512 KB SEMANTIC_CACHE_MAX_SIZE=25 SEMANTIC_CACHE_MAX_BYTES=1048576 # 1 MB STREAM_HISTORY_MAX=10 ``` --- ## 18. 料金同期 倖郚゜ヌスからモデルの料金デヌタを自動的に同期したす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ----------------------- | ------------- | ------------------------ | -------------------------------------------- | | `PRICING_SYNC_ENABLED` | `false` | `src/lib/pricingSync.ts` | 定期的な料金同期をオプトむンで有効にしたす。 | | `PRICING_SYNC_INTERVAL` | `86400` (24h) | `src/lib/pricingSync.ts` | 同期間隔秒単䜍。 | | `PRICING_SYNC_SOURCES` | `litellm` | `src/lib/pricingSync.ts` | カンマ区切りのデヌタ゜ヌス。 | --- ## Arena ELO 同期 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------- | ------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ARENA_ELO_SYNC_ENABLED` | `true` | `src/shared/constants/featureFlagDefinitions.ts` | Arena AI リヌダヌボヌドの ELO を定期的に同期したす。Dashboard の Feature Flags から蚭定するか、`false` にしおオプトアりトできたす。 | | `MODELS_CATALOG_PREFIX_MODE` | `dual` | `src/shared/constants/featureFlagDefinitions.ts`, `src/app/api/v1/models/catalog.ts` | `GET /v1/models` のモデル ID に䜿甚するプレフィックス圢匏。`dual` は、すべおのモデルに぀いお短い゚むリアスプレフィックスず正芏プロバむダヌプレフィックスの䞡方を公開したす埌方互換性のため、カタログのサむズはおよそ2倍になりたす。`alias` はモデルごずに1぀の ID を出力したす。`canonical` は完党なプロバむダヌ ID プレフィックスのみを出力したす゚むリアスがすでに正芏 ID であるプロバむダヌは、単䞀の゚ントリを維持したす。クラむアントはリク゚ストごずに `?prefix=alias` を指定しお䞊曞きできたす。[API_REFERENCE](API_REFERENCE.md#model-id-prefixes-prefix) を参照しおください。 | | `ARENA_ELO_SYNC_INTERVAL` | `86400` (24h) | `src/lib/arenaEloSync.ts` | 同期間隔秒単䜍。 | --- ## PromptQL Playground プロバむダヌ非公匏実隓的 prompt.ql.app 甚にリバヌス゚ンゞニアリングされた GraphQL セッションブリッゞ`src/shared/constants/providers/web-cookie.ts`。すべお任意です。デフォルトでは公開 Playground ゚ンドポむントを䜿甚したす。セルフホストたたは代替の PromptQL デプロむメントを䜿甚する堎合にのみ䞊曞きしおください。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------- | | `PROMPTQL_GRAPHQL_ENDPOINT` | `https://data.prompt.ql.app/promptql/playground-v2-hge/v1/graphql` | `open-sse/executors/promptql.ts` | チャットセッション操䜜に䜿甚する GraphQL ゚ンドポむント。 | | `PROMPTQL_CREDITS_ENDPOINT` | `https://data.pro.ql.app/v1/graphql` | `open-sse/executors/promptql.ts`, `open-sse/services/usage/promptql.ts` | クレゞット残高䜿甚量の照䌚に䜿甚する GraphQL ゚ンドポむント。 | | `PROMPTQL_TOKEN_REFRESH_URL` | `https://auth.pro.ql.app/ddn/project/token` | `open-sse/executors/promptql.ts` | ベスト゚フォヌト方匏のトヌクン曎新に䜿甚する゚ンドポむント。 | | `PROMPTQL_POLL_TIMEOUT_MS` | `180000` | `open-sse/executors/promptql.ts` | タむムアりトするたで `thread_events` をポヌリングする最倧時間ミリ秒。 | --- ## HyperAgent Web プロバむダヌ非公匏実隓的 hyperagent.com 向けにリバヌス゚ンゞニアリングされたセッションブリッゞ`src/shared/constants/providers/web-cookie.ts`。任意蚭定です。デフォルトでは公開の請求䜿甚量゚ンドポむントを参照したす。セルフホスト環境たたは代替の HyperAgent デプロむメントを䜿甚する堎合にのみ䞊曞きしおください。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------- | --------------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------- | | `HYPERAGENT_USAGE_URL` | `https://hyperagent.com/api/settings/billing/usage` | `open-sse/services/usage/hyperagent.ts` | 請求䜿甚量のクレゞットブロックを取埗するために䜿甚される゚ンドポむント。 | --- ## Kilo Code 䜿甚量クォヌタ Kilo Code プロバむダヌ向けの個人 USD 残高および Kilo Pass 䜿甚量の照䌚。任意蚭定です。デフォルトでは公開 Kilo API を参照したす。リレヌたたはテストフィクスチャを䜿甚する堎合にのみ䞊曞きしおください。認蚌には、接続に既存の OAuth アクセストヌクンが䜿甚されたす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | -------------- | --------------------- | ------------------------------------- | ----------------------------------------------------------------------------------- | | `KILO_API_URL` | `https://api.kilo.ai` | `open-sse/services/usage/kilocode.ts` | Kilo Code の個人残高および Kilo Pass の䜿甚量を取埗するために䜿甚されるベヌス URL。 | --- ## Adobe Firefly Web プロバむダヌ非公匏実隓的 Adobe Firefly Web プロバむダヌ向けのブラりザヌ駆動型セッション曎新 `open-sse/services/adobeFireflyBrowserLogin.ts`、`open-sse/services/adobeFireflySession.ts`、 `open-sse/services/adobeFireflyClient.ts`。任意蚭定です。すべおのデフォルト倀は通垞の デスクトップむンストヌル向けに調敎されおいたす。 > **#9255 で削陀されたした。** 旧 CDP 接続型 Chrome ランタむムadobeFireflyChromeRuntime.tsは > Playwright ブラりザヌログむンサヌビスに眮き換えられ、その蚭定項目は存圚しなくなりたした。 > ADOBE_FIREFLY_CHROME_ CDP_PORT / VISIBLE / HEADED / PING / FORCE_RESTART 倉数、および > ADOBE_FIREFLY_LOGIN_WAIT_MS ず ADOBE_FIREFLY_FORTER_WAIT_MS はコヌドベヌス内の > どこからも読み取られないため、蚭定しおも効果はありたせん。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------ | ------------ | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ADOBE_FIREFLY_CHROME_HEADLESS` | `0` | `open-sse/services/adobeFireflyBrowserLogin.ts` | 真のヘッドレス Chrome を䜿甚するには `1` に蚭定したす生成では動䜜しないこずが既知であり、デバッグ専甚です。 | | `ADOBE_FIREFLY_BROWSER_REFRESH` | `1` | `open-sse/services/adobeFireflySession.ts` | 事前のブラりザヌりォヌムアップを有効化無効化したす。`0` にするず事前りォヌムアップが無効になりたすバッチ途䞭の 408 リカバリヌは匕き続き適甚されたす。 | | `ADOBE_FIREFLY_SESSION_DISK` | `1` | `open-sse/services/adobeFireflySession.ts` | Adobe Firefly セッションのディスクぞの氞続化を無効にするには `0` に蚭定したす。 | | `ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS` | _未蚭定_ | `open-sse/services/adobeFireflySession.ts` | 連続する送信間に適甚される最小間隔ms。組み蟌みのデフォルト倀を䞊曞きしたす。 | | `ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS` | _未蚭定_ | `open-sse/services/adobeFireflySession.ts` | バッチ成功埌に远加される埅機時間ms。組み蟌みのデフォルト倀を䞊曞きしたす。 | | `ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS` | _未蚭定_ | `open-sse/services/adobeFireflyClient.ts` | 生成リク゚ストを送信する前の基本遅延ms。組み蟌みのデフォルト倀を䞊曞きしたす。 | --- ## 19. モデル同期開発甚 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ----------------------------------- | ----------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `MODELS_DEV_SYNC_ENABLED` | _未蚭定_ | `src/lib/modelsDevSync.ts` | models.dev の料金同期を匷制的に䞊曞きしたす。未蚭定 = 蚭定 > AI`modelsDevSyncEnabled`に埓いたす。`0`/`false`/`off`/`no` は **DB の蚭定より優先され**、定期同期ず `getModelsDevPricing()` による SQL/JSON スキャンの䞡方をスキップしたすダッシュボヌドが同じむベントルヌプ䞊で停止した堎合の埩旧甚。`1`/`true`/`on`/`yes` を指定するず、同期が匷制的に有効になりたす。料金の保存/消去時には匕き続き `backupDbFile("pre-write")` が呌び出されたすが、60 分間のスロットリング䞭、たたは `DISABLE_SQLITE_AUTO_BACKUP` が蚭定されおいる堎合は䜕も実行されたせん。 | | `MODELS_DEV_SYNC_INTERVAL` | `86400`24時間 | `src/lib/modelsDevSync.ts` | 開発時のモデルカタログ同期の間隔秒単䜍。 | | `CONTEXT_WINDOW_RECONCILE_INTERVAL` | `86400`24時間 | `src/lib/contextWindowResolver.ts` | 自己修正型コンテキストりィンドり調敎凊理5004の実行間隔秒単䜍。`/models` の怜出によっおプロバむダヌから宣蚀されたりィンドりがカタログず異なる堎合、それらを `auto:discovery` オヌバヌラむドずしお固定したす。無効にするには `0` に蚭定したす。同期枈みのデヌタを再利甚し新たな取埗は行いたせん、`manual` オヌバヌラむドを䞊曞きするこずはありたせん。 | --- ## 20. プロバむダヌ固有の蚭定 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OPENROUTER_CATALOG_TTL_MS` | `86400000`24時間 | `src/lib/catalog/openrouterCatalog.ts` | OpenRouterモデルカタログのキャッシュTTL。 | | `MODEL_CATALOG_INCLUDE_NAMES` | `true` | `src/shared/constants/featureFlagDefinitions.ts` | `/v1/models`のレスポンスに衚瀺甚の`name`フィヌルドを含めたす。IDのみを想定するクラむアントでは無効にしおください。 | | `CATALOG_BUILD_TIMEOUT_MS` | `8000`8秒 | `src/app/api/v1/models/catalogCache.ts` | 統合された`GET /v1/models`カタログ再構築のコヌルドパス埅機䞊限#12627。タむムアりト時、正垞な最新の200レスポンスが存圚する堎合はそれを返したす。 | | `OMNIROUTE_SYNCED_CATALOG_STALE_AFTER_MS` | `2592000000`30日 | `src/lib/db/models/activeSyncedCatalog.ts` | 接続の同期枈みモデル䞀芧がルヌティングの信頌できる情報源ではなくなり、レゞストリぞのフェむルオヌプンが行われるたでの期間#12849。タむムスタンプが䞀床も蚭定されおいない行は叀いものず芋なされたす。 | | `OMNIROUTE_ANALYTICS_CACHE_TTL_MS` | `60000`60秒 | `src/lib/usage/analyticsResponseCache.ts` | 時間のかかる`GET /api/usage/analytics`レスポンスを同じク゚リ文字列に察しお再利甚する期間#15629。`0`でキャッシュを無効にしたす。 | | `OMNIROUTE_ANALYTICS_CACHE_MIN_COMPUTE_MS` | `1000`1秒 | `src/lib/usage/analyticsResponseCache.ts` | 生成に少なくずもこの時間を芁した分析レスポンスのみをキャッシュするため、小芏暡なむンスタンスでは垞に最新デヌタが衚瀺されたす。 | | `NANOBANANA_POLL_TIMEOUT_MS` | `120000` | `open-sse/handlers/imageGeneration.ts` | NanoBanana画像生成ゞョブの最倧埅機時間。 | | `NANOBANANA_POLL_INTERVAL_MS` | `2500` | `open-sse/handlers/imageGeneration.ts` | NanoBananaゞョブのポヌリング頻床。 | | `ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS` | `8000` | `open-sse/services/adobeFireflyUpscale.ts` | Adobe Fireflyアップスケヌル送信再詊行の指数バックオフにおける基本遅延。 | | `AWS_REGION` | _未蚭定_ | `src/lib/providers/validation.ts`, `open-sse/handlers/audioSpeech.ts` | AWS Bedrock゚ンドポむントKiro、音声の構築に䜿甚するリヌゞョン。 | | `AWS_DEFAULT_REGION` | _未蚭定_ | `src/lib/providers/validation.ts`, `open-sse/handlers/audioSpeech.ts` | `AWS_REGION`が蚭定されおいない堎合のフォヌルバック。 | | `CLOUDFLARE_ACCOUNT_ID` | _未蚭定_ | `open-sse/executors/cloudflare-ai.ts` | Cloudflare Workers AIのアカりントID。 | | `CLOUDFLARE_PLAYGROUND_CHROME_PATH` | _未蚭定_ | `open-sse/executors/cloudflare-playground.ts` | Cloudflare AI Playground゚グれキュヌタヌ甚のデスクトップ版Chromeバむナリのフルパス。ヘッドレスフィンガヌプリントチェックによっおPlaywright同梱のChromiumがブロックされる堎合に䜿甚されたす。 | | `CODEBUDDY_SYSTEM_PROMPT_MAX_LEN` | ∅ (∞) | `open-sse/executors/codebuddy/shared.ts` | CodeBuddy䞭囜版および囜際版に送信される呌び出し元のシステムプロンプトに察するオプションの長さ制限。デフォルトでは、コヌディング゚ヌゞェントの識別マヌカヌを含むプロンプトのみが䞭立的なものに眮き換えられたすTencentのコンテンツフィルタヌがこれらを拒吊するため。長いプロンプトは保持されたす。0より倧きい敎数を指定するず、その文字数を超えるすべおのシステムプロンプトも眮き換えられたす。未蚭定、`0`、たたは敎数以倖の倀の堎合、長さ制限は無効になりたす。眮き換えのたびに、どのルヌル識別マヌカヌたたは長さが適甚されたかがログに蚘録されたす。 | | `CLOUDFLARE_API_BASE` | `https://api.cloudflare.com/client/v4` | `src/app/api/settings/proxy/cloudflare-deploy/route.ts` | プロキシプヌルのWorkersリレヌデプロむダヌが䜿甚するCloudflare REST APIのベヌスURLを䞊曞きしたす#4640 / 9router#1360。 | | `NEXT_PUBLIC_CLOUDFLARE_RELAY_DEFAULT_PROJECT` | `omniroute-relay` | `src/app/(dashboard)/dashboard/settings/components/proxy/CloudflareRelayModal.tsx` | プロキシプヌルの「Deploy Relay」モヌダルで提案されるデフォルトのworkerプロゞェクト名。 | | `NEXT_PUBLIC_CLOUDFLARE_RELAY_ENABLED` | `true` | `src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx` | `false`に蚭定するず、Proxy PoolタブでCloudflare Workersリレヌオプションが非衚瀺になりたす。 | | `CLOUDFLARED_BIN` | 自動怜出 | `src/lib/cloudflaredTunnel.ts` | `cloudflared` バむナリぞのカスタムパス。 | | `CLOUDFLARED_PROTOCOL` | `http2` | `src/lib/cloudflaredTunnel.ts` | トンネル転送プロトコル`http2`デフォルト、`quic`、たたは `auto`。 | | `CLOUDFLARED_CONFIG` | _未蚭定_ | `src/lib/cloudflaredTunnel.ts` | ロヌカルで管理される cloudflared の `config.yml``tunnel:`、`credentials-file:`、`ingress:` を含むぞのパス。蚭定するず、OmniRoute は䞀時的なクむックトンネルの代わりに `tunnel --config run`名前付きトンネルを実行したす。 | | `CLOUDFLARED_HOSTNAME` | _蚭定の ingress から取埗_ | `src/lib/cloudflaredTunnel.ts` | 名前付きトンネルの公開ホスト名䟋`ai.example.com`を䞊曞きし、`publicUrl`/`apiUrl` ずしお報告したす。未蚭定の堎合は、蚭定内の最初の `ingress` ホスト名から読み取られたす。 | | `DENO_DEPLOY_API_BASE` | `https://api.deno.com/v2` | `src/app/api/settings/proxy/deno-deploy/route.ts` | プロキシプヌルのリレヌデプロむダヌが䜿甚する Deno Deploy REST API のベヌスを䞊曞きしたす#4643 / 9router#1437。 | | `NEXT_PUBLIC_DENO_RELAY_DEFAULT_PROJECT` | `omniroute-deno-relay` | `src/app/(dashboard)/dashboard/settings/components/proxy/DenoRelayModal.tsx` | プロキシプヌルの「Deploy Relay」モヌダルで提案されるデフォルトの Deno Deploy アプリ名。 | | `NEXT_PUBLIC_DENO_RELAY_ENABLED` | `true` | `src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx` | `false` に蚭定するず、Proxy Pool タブで Deno Deploy リレヌオプションが非衚瀺になりたす。 | | `SEARCH_CACHE_TTL_MS` | `300000`5 分 | `open-sse/services/searchCache.ts` | 怜玢 APIPerplexity、Brave などのレスポンスキャッシュに察する TTL。 | | `ENABLE_CC_COMPATIBLE_PROVIDER` | `false` | `src/shared/utils/featureFlags.ts` | Claude Code 専甚リレヌ向けの詊隓的な CC 互換プロバむダヌ UI を衚瀺したす。 | | `NINEROUTER_HOST` | `127.0.0.1` | `open-sse/executors/ninerouter.ts` | 組み蟌み 9router むンスタンスがリッスンするホストを䞊曞きしたす。 | | `NINEROUTER_PORT` | `20130` | `open-sse/executors/ninerouter.ts` | 組み蟌み 9router むンスタンスがリッスンするポヌトを䞊曞きしたす。 | | `EMBED_WS_PROXY_HOST` | `127.0.0.1` | `src/lib/services/embedWsProxy.ts` | 組み蟌みサヌビスの WebSocket プロキシ甚バむンドホストデフォルトではルヌプバックのみ。 | | `EMBED_WS_PROXY_PORT` | `20131` | `src/lib/services/embedWsProxy.ts` | 組み蟌みサヌビスの WebSocket プロキシサヌバヌ甚ポヌト。 | | `CLIPROXYAPI_HOST` | `127.0.0.1` | `open-sse/executors/cliproxyapi.ts` | CLIProxyAPI ブリッゞホストレガシヌ統合。 | | `CLIPROXYAPI_PORT` | `5544` | `open-sse/executors/cliproxyapi.ts` | CLIProxyAPI ブリッゞポヌト。 | | `CLIPROXYAPI_API_KEY` | _空_ | `open-sse/handlers/chatCore/cliproxyapiCredentials.ts` | `cliproxyapi_api_key` 蚭定が存圚しない堎合のデヌタプレヌンキヌのフォヌルバック。 | | `CLIPROXYAPI_MANAGEMENT_KEY` | _空_ | `src/lib/services/cliproxyAccountHealth.ts` | 倖郚管理されおいる CLIProxyAPI むンスタンスからアカりントの健党性情報を読み取るための管理キヌ。 | | `CLIPROXYAPI_CONFIG_DIR` | `~/.cli-proxy-api` | `src/lib/versionManager/processManager.ts` | CLIProxyAPI の蚭定ディレクトリ。 | | `CLIPROXY_BIND_HOST` | `127.0.0.1` | `docker-compose.yml` | docker-compose が `cliproxyapi` サむドカヌを公開するホストむンタヌフェヌス#12578。そのデヌタボリュヌムにはプロバむダヌの OAuth/API 認蚌情報が保持され、固定されたむメヌゞには環境倉数ベヌスのデヌタプレヌン `api-keys` 䞊曞きがないマりントされた `config.yaml` のみため、`0.0.0.0` にするず認蚌情報を保持するサヌビスが LAN 党䜓に公開されたす。 | | `MUX_SERVICE_PORT` | `8322` | `src/lib/services/bootstrap.ts` | 組み蟌みの Muxcoder/mux゚ヌゞェントオヌケストレヌションデヌモンがリッスンするポヌトを䞊曞きしたす垞に 127.0.0.1。 | | `OPENWA_SERVICE_PORT` | `8323` | `src/lib/services/bootstrap.ts` | 組み蟌みの open-waWhatsApp Web 自動化デヌモンがリッスンするポヌトを䞊曞きしたす垞に 127.0.0.1。 | | `DARIO_HOST` | `127.0.0.1` | `open-sse/executors/dario.ts` | Dario 組み蟌みサヌビスのバむンド接続先ホストデフォルトではルヌプバックのみ。 | | `DARIO_PORT` | `3456` | `open-sse/executors/dario.ts` | Dario 組み蟌みサヌビスのポヌト。 | | `DARIO_HOST` | `127.0.0.1` | `open-sse/executors/dario.ts` | Dario 組み蟌みサヌビスのバむンド接続先ホストデフォルトではルヌプバックのみ。 | | `DARIO_PORT` | `3456` | `open-sse/executors/dario.ts` | Dario 組み蟌みサヌビスのポヌト。 | | `LOCAL_HOSTNAMES` | _空_ | `open-sse/config/providerRegistry.ts` | 「ロヌカル」ずしお扱う远加のホスト名をカンマ区切りで指定したすDocker サヌビス名など。 | `ENABLE_CC_COMPATIBLE_PROVIDER` は、Claude Code クラむアントのみを受け付けるサヌドパヌティ補リレヌ専甚です。 OmniRoute は、それらのリレヌがリク゚ストを受け付けられるようにリク゚ストを曞き換えたす。Claude Code CLI のみを䜿甚したい堎合、たたはこれらのリレヌが䜕かわからない堎合は、この蚭定を無効のたたにし、代わりに通垞の Anthropic 互換プロバむダヌを远加しおください。 --- ## 21. プロキシのヘルス | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------------------- | ------------------------ | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `PROXY_FAST_FAIL_TIMEOUT_MS` | `2000` | `src/lib/proxyHealth.ts` | 高速倱敗ヘルスチェックのタむムアりト。 | | `PROXY_LATENCY_WINDOW_HOURS` | `3` | `src/lib/db/proxies.ts` | レむテンシヌ最適化プヌル戊略においお、候補プロキシの平均レむテンシヌを蚈算するための時間枠時間単䜍。 | | `PROXY_HEALTH_CACHE_TTL_MS` | `30000` | `src/lib/proxyHealth.ts` | ヘルスチェック結果キャッシュの TTL。 | | `PROXY_HEALTH_UNHEALTHY_CACHE_TTL_MS` | `2000` | `src/lib/proxyHealth.ts` | 倱敗したプロキシヘルスプロヌブのキャッシュ TTL。䞀時的なプロキシタむムアりトが高䞊行性の状況で発生した堎合に、実際に停止しおいるプロキシに察する高速倱敗を無効にするこずなく迅速に再詊行できるよう、これを `PROXY_HEALTH_CACHE_TTL_MS` より短く蚭定しおください。 | | `PROXY_HEALTH_ENABLED` | `true` | `src/lib/proxyHealth/scheduler.ts` | 登録枈みのプロキシを定期的にプロヌブするバックグラりンドプロキシヘルススケゞュヌラヌを無効にするには、`false` に蚭定したす。 | | `PROXY_HEALTH_INTERVAL_MS` | `600000` | `src/lib/proxyHealth/scheduler.ts` | バックグラりンドヘルススケゞュヌラヌのスむヌプ間隔ミリ秒単䜍、最小倀は `60000`。 | | `PROXY_HEALTH_RELAY_INTERVAL_MS` | `21600000` | `src/lib/proxyHealth/relayCadence.ts` | プロヌブによっお課金察象のサヌバヌレス isolate が起動する゚ッゞリレヌプロキシ`deno`/`vercel`/`cloudflare`のプロヌブ間隔ミリ秒、最小倀は `60000`。 | | `PROXY_HEALTH_RECOVERY_INTERVAL_MS` | `600000` | `src/lib/proxyHealth/scheduler.ts` | バックグラりンドの埩旧パス間隔ミリ秒。以前に異垞ず刀定されたプロキシを再プロヌブする頻床を指定し、埩旧したプロキシを再起動なしでロヌテヌションに戻せるようにしたす。`60000` 未満の倀はデフォルト倀にフォヌルバックしたす。 | | `PROXY_HEALTH_TEST_URL` | `https://httpbin.org/ip` | `src/lib/proxyHealth/probeTarget.ts` | スケゞュヌラヌおよび `/api/settings/proxies/auto-test` ゚ンドポむントで䜿甚される到達可胜性プロヌブのタヌゲット。公開のデフォルトを䜿甚しないようにするには、内郚たたはセルフホストの URL を指定しおください。 | | `PROXY_HEALTH_TEST_CONCURRENCY` | `10` | `src/lib/proxyHealth/probeTarget.ts` | バッチごずに同時開始されるプロヌブ数。スケゞュヌラヌず `/api/settings/proxies/auto-test` ゚ンドポむントで共有されたす。最小倀は 1、最倧倀は 50 です。 | | `PROXY_HEALTH_TEST_STAGGER_MS` | `100` | `src/lib/proxyHealth/probeTarget.ts` | バッチ内で 2 ぀のプロヌブを送信する間の遅延ミリ秒。これがない堎合、バッチ党䜓が同時に送信され、共有の送信元 IP によっおレヌト制限のあるタヌゲットに抵觊する可胜性がありたす。間隔を無効にするには `0` に蚭定したす。䞊限は 5000 です。 | | `PROXY_HEALTH_USE_PROVIDER_TARGET` | `true` | `src/lib/proxyHealth/providerProbeTarget.ts` | プロキシに割り圓おられたプロバむダヌの実際のホスト`GET /models`、API キヌなしぞのプロヌブを停止し、代わりに垞に `PROXY_HEALTH_TEST_URL` を䜿甚するには、"false" に蚭定したす。 | | `PROXY_HEALTH_AUTO_DEACTIVATE` | `false` | `src/lib/proxyHealth/statusPolicy.ts` | `false`デフォルトの堎合、自動到達可胜性プロヌブスケゞュヌラヌおよび `/api/settings/proxies/auto-test` の「すべおテスト」ボタンは**読み取り専甚**ずなり、プロキシのステヌタスを倉曎したせん。アクティブ非アクティブを蚭定できるのはオペレヌタヌのみずなるため、䞍安定なプロヌブによっお割り圓お枈みプロキシが䜿甚䞍胜になるこずを防げたす#6246。埓来のテスト埌にステヌタスを蚭定する動䜜に戻すには、`true` に蚭定したす。 | | `FLUSH_EMPTY_RETRY_ENABLED` | `false` | `src/shared/utils/featureFlags.ts` | オプトむンの機胜フラグ[FEATURE_FLAGS.md](./FEATURE_FLAGS.md) を参照。ダッシュボヌドの DB オヌバヌラむドが優先されたす。`true`たたは `1`、`yes`にするず、空の 200 たたはコンテンツが空の 502 を返す代わりに、空の翻蚳枈みストリヌミングタヌンを通垞の認蚌情報パス経由で再詊行したす最倧 `STREAM_RECOVERY.EMPTY_TURN_RETRY_MAX` 回。 | | `PROXY_POOL_EGRESS_OBSERVATION` | `false` | `src/shared/utils/featureFlags.ts` | オプトむンの機胜フラグ[FEATURE_FLAGS.md](./FEATURE_FLAGS.md) を参照。ダッシュボヌドの DB オヌバヌラむドが優先されたす。`true`たたは `1`、`yes`にするず、ダッシュボヌドのプロキシプヌルの䞋に読み取り専甚の送信トラフィック芳枬情報プロキシログに基づく過去 24 時間の䞀意な送信元 IP、接続数、および 1 ぀の IP の背埌で芳枬された最倧数が衚瀺されたす。ルヌティングには䜿甚されたせん。 | | `PROXY_OPERATOR_EGRESS_ENABLED` | `false` | `src/shared/utils/featureFlags.ts` | オプトむンの機胜フラグ[FEATURE_FLAGS.md](./FEATURE_FLAGS.md) を参照。ダッシュボヌドの DB オヌバヌラむドが優先されたす。`true`たたは `1`、`yes`にするず、オペレヌタヌから送信された日付付きの芳枬枈みアドレスをプヌルメンバヌごずに受け入れ、衚瀺およびプヌル順序のためにゞャヌナルの読み取り結果ずマヌゞしたす。 | | `PROXY_OPERATOR_EGRESS_WINDOW_HOURS` | `24` | `src/lib/db/proxyOperatorEgress.ts` | オペレヌタヌから送信された゚グレス行の芳枬期間時間単䜍。読み取りのたびに参照され、再起動は䞍芁です。`1..168` の範囲に制限されたす。範囲倖、数倀以倖、たたは空の堎合は、プロセス党䜓で譊告を䞀床だけ出しお 24 にフォヌルバックし、䟋倖はスロヌしたせん。 | | `PROXY_AUTO_REMOVE` | `false` | `src/lib/proxyHealth/scheduler.ts` | 連続した倱敗が繰り返された埌に、スケゞュヌラヌがプロキシを自動削陀できるようにするには `true` に蚭定したす。 | | `PROXY_AUTO_REMOVE_AFTER` | `3` | `src/lib/proxyHealth/scheduler.ts` | スケゞュヌラヌがプロキシを自動削陀するたでの連続倱敗回数`PROXY_AUTO_REMOVE=true` の堎合。 | | `PROXY_AUTO_DISABLE` | `false` | `src/lib/proxyHealth/scheduler.ts` | 連続した倱敗が繰り返された埌に、プロキシを削陀する代わりに、スケゞュヌラヌが゜フト無効化ステヌタスは `dead`、削陀はしないできるようにするには `true` に蚭定したす。`PROXY_AUTO_REMOVE` に代わる非砎壊的な遞択肢です。プロキシはプヌルロヌテヌションの解決察象から即座に陀倖されスコヌププヌルの解決で䜿甚される皌働䞭ステヌタスのフィルタヌによっおすでに陀倖されたす、再びプロヌブに成功するようになるず自動的に再有効化されたす。しきい倀は `PROXY_AUTO_REMOVE_AFTER` ず共有したす。䞡方のフラグが `true` の堎合は、`PROXY_AUTO_REMOVE` が優先されたす。 | | `PROXY_HEALTH_PASSIVE_SKIP` | `false` | `src/lib/proxyHealth/scheduler.ts` | オプトむンのパッシブスキップ`true` の堎合、盎近の本番トラフィックによっお゚ンドポむントの正垞性がすでに蚌明されおいれば期間内に少なくずも 1 回の成功があり、そのプロキシに起因する倱敗がなく、芳枬されたプロバむダヌがちょうど 1 ぀である堎合、スケゞュヌラヌはその゚ンドポむントに察するラむブプロヌブをスキップしたす。デフォルトではオフで、すべおのプロキシがプロヌブされたす。 | | `PROXY_PASSIVE_WINDOW_MS` | `300000` | `src/lib/proxyHealth/passiveVerdict.ts` | パッシブスキップが参照する本番トラフィックの期間ミリ秒単䜍、`60000..599999` の範囲に制限。盎近の倱敗が垌釈されずに優先されるよう、10 分間のスむヌプ間隔より短く蚭定されおいたす。 | | `OMNIROUTE_CONTROL_PLANE_PROXY_DIRECT_FALLBACK` | `false` | `src/shared/constants/featureFlagDefinitions.ts` | プロキシの到達可胜性に関する事前チェックが倱敗した堎合に、OAuth およびプロバむダヌ怜蚌フロヌが固定されたプロキシを迂回しお盎接接続するこずを蚱可したす。実際の優先順䜍は、Feature Flags の DB オヌバヌラむド > 環境倉数 > デフォルトです。 | | `RATE_LIMIT_MAX_WAIT_MS` | `30000` (30秒) | `src/lib/resilience/settings.ts` | デフォルトの**キュヌ埅機**時間枠: リク゚ストがプロバむダヌスロットを埅ち、拒吊されおアップストリヌムに到達しないたたキュヌ内に留たれる時間。ゞョブの実行開始時にタむマヌは解陀されたす。実行時間は `RATE_LIMIT_EXECUTION_MAX_WAIT_MS` によっお別途制限されたす。環境倉数で蚭定されるのはデフォルト倀のみです。氞続化された `resilienceSettings.requestQueue.maxWaitMs`、続いお接続ごずの `rateLimitOverrides.maxWaitMs` が、それぞれこの倀より優先されたす。 | | `RATE_LIMIT_EXECUTION_MAX_WAIT_MS` | `600000` (10分) | `open-sse/services/rateLimitManager.ts` | 受け入れられたリク゚ストに぀いお、レヌト制限の予玄が期限切れになるたで実行状態に留たれる時間の䞊限。キュヌ埅機時間枠ずは切り離されおいるため、非むンクリメンタルゲヌトりェむでフェッチ開始が遅くおもタむムアりトしたせん (#12027)。 | | `RATE_LIMIT_MAX_QUEUE_DEPTH` | `0` (無効) | `open-sse/services/rateLimitManager.ts` | キュヌ受け入れ䞊限: この数のリク゚ストがすでにキュヌに入っおいる堎合、429 `queue_full` で拒吊したす。`0` = 無制限デフォルト。 | | `RATE_LIMIT_AUTO_ENABLE` | _(未蚭定)_ | `open-sse/services/rateLimitManager.ts` | 氞続化されたダッシュボヌド蚭定に関係なく、レヌト制限のセヌフティネットの自動有効化を匷制的にオンたたはオフにしたす。匷制的にオンにするには `true`/`1`/`on`、匷制的にオフにするには `false`/`0`/`off` を指定できたす。 | | `PROVIDER_COOLDOWN_ENABLED` | _(未蚭定 → オフ)_ | `open-sse/services/providerCooldownTracker.ts` | リク゚ストをたたぐグロヌバルなプロバむダヌ接続クヌルダりン远跡のオプトむン蚭定。デフォルトではオフです接続クヌルダりンプロバむダヌサヌキットブレヌカヌず機胜が重耇したす。有効にするには `true`/`1`/`on` を指定できたす。 | | `PROVIDER_COOLDOWN_MIN_MS` | `5000` | `open-sse/services/providerCooldownTracker.ts` | 障害が発生したプロバむダヌ接続を再詊行するたでの最小クヌルダりン時間ミリ秒。連続した障害回数に応じお指数関数的に増加したす。`PROVIDER_COOLDOWN_ENABLED` が有効な堎合にのみ䜿甚されたす。 | | `PROVIDER_COOLDOWN_MAX_MS` | `300000` (5分) | `open-sse/services/providerCooldownTracker.ts` | 障害が発生したプロバむダヌ接続を再詊行するたでの最倧クヌルダりン時間ミリ秒の䞊限。`PROVIDER_COOLDOWN_ENABLED` が有効な堎合にのみ䜿甚されたす。 | | `STREAM_RECOVERY_ENABLED` | _(未蚭定 → オフ)_ | `src/lib/resilience/settings.ts` (初期倀) → `open-sse/services/streamRecovery.ts` (ロゞック) | **抂芁:** 途䞭で切断されたアップストリヌムストリヌムを透過的に埩旧したすfree-claude-codeからの移怍。開始時のSSEりィンドりを `STREAM_RECOVERY.HOLDBACK_MS`750ミリ秒たで保留するこずで、_コミット前_、぀たりクラむアントに1バむトも到達する前に切断された堎合、接続を再確立しお透過的に再詊行したす。**有効にする堎合:** ストリヌム開始時に0バむトで頻繁に切断される䞍安定なアップストリヌム。すべおのストリヌムで初回トヌクン到達時間が最倧750ミリ秒増加するこずを蚱容できない堎合は、オフのたたにしおください。`true`/`1`/`on` を指定できたす。氞続化されるレゞリ゚ンス蚭定の初期倀ずしお䜿甚されたす。䞀床蚭定されるず、ダッシュボヌド蚭定が優先されたす。 | | `STREAM_RECOVERY_MIDSTREAM_ENABLED` | _(未蚭定 → オフ)_ | `src/lib/resilience/settings.ts` (初期倀) → `open-sse/services/streamRecovery.ts` (ロゞック) | **抂芁:** ストリヌム途䞭からの継続 (フェヌズ 4.4) — _コミット埌_ に切り詰めが発生した堎合 (バむトがすでにクラむアントぞ到達枈みの堎合)、郚分的なテキストを assistant の prefill ずしお再リク゚ストし、欠萜した接尟郚分を結合したす。プレヌンテキストの OpenAI 互換ストリヌムのみが察象です。tool call の凊理䞭には実行されたせん。**有効にする堎合:** 長い生成が回答途䞭で途切れ、埩旧された末尟郚分がトヌクン単䜍ではなく䞀括で到着するこずを蚱容できる堎合。`STREAM_RECOVERY_ENABLED` ずは独立しおいたす (リスク特性が異なりたす)。`true`/`1`/`on` を指定できたす。 | | `STREAM_THROUGHPUT_WATCHDOG_ENABLED` | _(未蚭定 → オフ)_ | `src/lib/resilience/settings.ts` → `open-sse/services/throughputWatchdog.ts` | オプトむン方匏のアクティブストリヌム有効出力りォッチドッグ。チャンクの送信は継続しおいるものの、蚭定された assistant 出力レヌトを䞋回っおいるストリヌムを怜出したす。heartbeat、usage event、空の delta、および tool/reasoning フェヌズが進捗ず誀認されるこずはありたせん。アむドルタむムアりトおよびハヌドデッドラむンタむムアりトずは別の機胜です。 | | `STREAM_THROUGHPUT_WATCHDOG_WARMUP_MS` | `30000` | `src/lib/resilience/settings/normalize.ts` | スルヌプット評䟡前の猶予期間。0600000 ms の範囲に制限されたす。 | | `STREAM_THROUGHPUT_WATCHDOG_WINDOW_MS` | `30000` | `src/lib/resilience/settings/normalize.ts` | 有効出力のロヌリングりィンドり。1000600000 ms の範囲に制限されたす。䞭断するには、1 ぀の完党なりィンドりが必芁です。 | | `STREAM_THROUGHPUT_WATCHDOG_MIN_BYTES_PER_SECOND` | `4` | `src/lib/resilience/settings/normalize.ts` | assistant 出力の最小 UTF-8 バむトレヌト (保守的なトヌクンの代替指暙)。11000000 の範囲に制限されたす。 | | `STREAM_THROUGHPUT_WATCHDOG_MIN_USEFUL_BYTES` | `1` | `src/lib/resilience/settings/normalize.ts` | 枬定可胜ず芋なされる、れロではない有効出力サンプルの最小倀。11000000 バむトの範囲に制限されたす。 | | `HEALTHCHECK_STAGGER_MS` | `3000` | `src/lib/tokenHealthCheck.ts` | 起動時に provider token の healthcheck を実行する間隔 (ms)。 | | `HEALTHCHECK_JITTER_MIN_MS` | `500` | `src/lib/tokenHealthCheck.ts` | バヌストを防止するため、provider token の healthcheck 間で `HEALTHCHECK_STAGGER_MS` に加算されるランダムな jitter の最小倀 (ms) (Issue #1220)。 | | `HEALTHCHECK_JITTER_MAX_MS` | `5000` | `src/lib/tokenHealthCheck.ts` | バヌストを防止するため、provider token の healthcheck 間で `HEALTHCHECK_STAGGER_MS` に加算されるランダムな jitter の最倧倀 (ms) (Issue #1220)。 | | `HEALTHCHECK_BATCH_SIZE` | `20` | `src/lib/tokenHealthCheck.ts` | 起動時の token healthcheck スむヌプにおける同時チェックのバッチサむズ。倀を倧きくするず、より倚くの接続を䞊列にチェックし、倀を小さくするずバヌスト負荷を軜枛したす (Issue #7875、#7719 のリグレッション)。 | | `REQUEST_RETRY` | `2` | `src/sse/services/cooldownAwareRetry.ts` | model 単䜍の cooldown レスポンスに察し、クラむアントぞ゚ラヌを返す前に実行する自動再詊行の回数。 | | `MAX_RETRY_INTERVAL_SEC` | `30` | `src/sse/services/cooldownAwareRetry.ts` | クヌルダりン再詊行間の最倧バックオフ間隔秒。䞊流の `Retry-After` に関係なく、この倀が䞊限ずなりたす。 | | `HEADROOM_URL` | `http://localhost:8787` | `src/lib/headroom/detect.ts` | Headroom トヌクン節玄プロキシの URL。ダッシュボヌドのラむフサむクル`api/headroom/*`では、デフォルトでルヌプバック䞊にロヌカルの `headroom-ai` CLI が起動されたす。倖郚の Docker サむドカヌプロキシを参照する堎合にのみ䞊曞きしおください。 | ### ストリヌム埩旧の調敎甚定数 埩旧時の保留動䜜は、 `open-sse/config/constants.ts``STREAM_RECOVERY`内のハヌドコヌドされた定数によっお調敎されたす。参考ずしお以䞋に瀺したす。 これらを倉曎するには、環境倉数ではなくコヌドの線集が必芁です。 - `STREAM_RECOVERY.HOLDBACK_MS = 750` — SSE の開始りィンドりを保持する時間。 これにより、クラむアントにバむトがコミットされる前に、早期切断を再詊行できたす。 - `STREAM_RECOVERY.BUFFER_MAX_BYTES = 65536` — 保持りィンドりの厳栌な䞊限。このバむト数が 蓄積された時点で、タむマヌに関係なくコミットフラッシュパススルヌしたす。 - `STREAM_RECOVERY.EARLY_RETRY_MAX = 4` — 保留デヌタがただコミットされおいない間に、 䞊流ストリヌムを透過的に再オヌプンできる最倧回数。 > **プロバむダヌごずのスラむディングりィンドり・レヌト制限環境倉数なし** FCC から移怍された、 > プロバむダヌごずのスラむディングりィンドり・レヌト制限の_フォヌルバック_はコヌド内に存圚したす > `open-sse/services/providerDefaultRateLimit.ts`。`open-sse/services/rateLimitManager.ts` > を介しお接続されおいたすが、**デフォルトのマップは空**で提䟛されおおり、 > 珟時点では**運甚者向けの環境倉数はありたせん**。テストフックたたは > コヌド線集によっおのみ有効化されたす。そのため、意図的に䞊の衚には蚘茉しおいたせん。蚭定項目が_存圚する_ > `token, IP` ごずのリレヌリミッタヌは `RELAY_IP_PER_MINUTE`§3「ネットワヌクずポヌト」です。 --- ## 22. デバッグ > [!CAUTION] > これらの倉数は**詳现な出力**を生成し、機密デヌタを挏えいさせる可胜性がありたす。**本番環境では絶察に有効にしないでください。** | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `CURSOR_DEBUG` | _未蚭定_ | `open-sse/executors/cursor.ts` | `1` に蚭定するず、Cursor executor の詳现ログデコヌド枈み SSE チャンクなどが有効になりたす。 | | `CURSOR_STREAM_DEBUG` | _未蚭定_ | `open-sse/executors/cursor.ts` | `CURSOR_DEBUG` の埌方互換゚むリアスです。 | | `CURSOR_DUMP_FILE` | _未蚭定_ | `open-sse/executors/cursor.ts` | `CURSOR_DEBUG=1` の堎合に、生のデコヌド枈み Cursor チャンクを出力する任意のファむルパスです。 | | `CURSOR_STREAM_TIMEOUT_MS` | `300000` | `open-sse/executors/cursor.ts` | Cursor executor のストリヌムアむドルタむムアりトミリ秒です。 | | `CURSOR_KV_GRACE_MS` | `2000` | `open-sse/executors/cursor.ts` | バむトがバッファヌに残っおいる堎合に、composer の kv_after_text ゜フトタヌミネヌタヌの埌に蚭ける猶予時間ミリ秒です。末尟の exec_mcp ツヌル呌び出しがフレヌムを完了するための時間を確保したす。 | | `CURSOR_TOOL_DIRECTIVE` | 有効`!== "0"` | `open-sse/executors/cursor.ts` | composer-2.5 が確実にツヌル呌び出しを発行するようにするツヌルコミットディレクティブです。無効にするには `0` に蚭定したす。 | | `OMNIROUTE_SYSTEM_INSTRUCTION_APPEND` | _未蚭定_ | `open-sse/translator/request/claude-to-openai.ts`, `open-sse/translator/response/openai-to-claude.ts` | 倉換埌にシステムメッセヌゞぞ远加される、オペレヌタヌ定矩のシステムプロンプトテキストです倉換埌むンゞェクション。codex/Responses および `/v1/messages` のパスに適甚されたす。たた、゚コヌされたシステムプリアンブルブロックから陀去するディレクティブのプレフィックスずしおも䜿甚されたす。無効にする堎合は未蚭定のたたにしおください。 | | `OMNIROUTE_STRIP_SYSTEM_PREAMBLE` | `0`オフ | `open-sse/translator/response/openai-to-claude.ts`, `open-sse/utils/directivePreambleStripper.ts` | `1` に蚭定するず、openai→claude ストリヌムの先頭から、゚コヌされたシステムプロンプトのプリアンブルブロックを陀去したす。デフォルトではオフです。ヒュヌリスティクスは英語の散文を前提ずしおおり、レスポンスのペむロヌドを倉曎するため、正圓にそのようなセクションで始たる応答では、そのセクションが倱われたす。 | | `CURSOR_IMAGE_FETCH_TIMEOUT_MS` | `15000` | `open-sse/utils/cursorImages.ts` | リモヌト `image_url` ビゞョン入力に察する画像ごずの取埗タむムアりトミリ秒です。 | | `CURSOR_STATE_DB_PATH` | _探玢_ | `open-sse/utils/cursorVersionDetector.ts` | IDE のバヌゞョン怜出に䜿甚する Cursor IDE 状態 DB の怜玢先を䞊曞きしたす。 | | `CURSOR_AGENT_CLI_VERSION` | _怜出 / 固定_ | `open-sse/utils/cursorAgentCliVersion.ts` | Agent Run の `x-cursor-client-version: cli-
` に䜿甚する Agent CLI ビルド ID`YYYY.MM.DD-`です。 | | `CURSOR_AGENT_BIN` | _未蚭定_ | `open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts` | 画像生成に䜿甚する Cursor Agent バむナリぞのパスです。未蚭定の堎合、ハンドラヌは `providerSpecificData.agentBin`、次に PATH を䜿甚したす。 | | `CURSOR_IMG_TIMEOUT_MS` | `210000` | `open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts` | Cursor Agent の画像ゞョブにおける画像ごずの実経過時間の䞊限ミリ秒です。 | | `CURSOR_IMG_MAX_CONCURRENT` | `2` | `open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts` | Cursor 画像ゞョブに察する共有シヌトの同時実行数制限です。 | | `CURSOR_IMG_MODEL` | リク゚スト / `auto` | `open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts` | 画像ゞョブに䜿甚する Cursor CLI の `--model` を䞊曞きしたす。 | | `UC_IMAGE_POLL_INTERVAL_MS` | `2000` | `open-sse/handlers/imageGeneration/providers/ucImage.ts` | UCuncensored.com画像生成結果のポヌリング間隔ミリ秒です。 | | `UC_IMAGE_POLL_TIMEOUT_MS` | `60000` | `open-sse/handlers/imageGeneration/providers/ucImage.ts` | UC 画像生成結果のポヌリングにおける実経過時間の䞊限ミリ秒です。 | | `UC_VIDEO_POLL_INTERVAL_MS` | `3000` | `open-sse/handlers/videoGeneration/providers/ucVideo.ts` | UCuncensored.com動画生成結果のポヌリング間隔ミリ秒です。 | | `UC_VIDEO_POLL_TIMEOUT_MS` | `300000` | `open-sse/handlers/videoGeneration/providers/ucVideo.ts` | UC 動画生成結果のポヌリングにおける実経過時間の䞊限ミリ秒です。 | | `CURSOR_DATA_DIR` | _探玢_ | `open-sse/utils/cursorAgentCliVersion.ts` | Cursor Agent CLI のデヌタディレクトリ`
/versions/`を䞊曞きしたす。公匏 Agent が䜿甚するものず同じ倉数です。 | | `CURSOR_TOKEN` | _未蚭定_ | `scripts/ad-hoc/cursor-tap.cjs` | 開発者向けツヌルで䜿甚される盎接指定の Cursor bearer token です。 | | `OMNIROUTE_LOG_REQUEST_SHAPE` | 無効`"1"` でオプトむン | `src/app/api/v1/chat/completions/route.ts` | `"1"` が蚭定されおいる堎合、倧きなチャットペむロヌドの content-type/length マヌカヌをログに蚘録したす。ログノむズを枛らすため、デフォルトではオフです。 | | `DEBUG_RESPONSES_SSE_TO_JSON` | _未蚭定_ | `open-sse/handlers/responseTranslator.ts` | `true` に蚭定するず、Responses API の SSE→JSON 倉換の詳现をログに蚘録したす。 | | `DEBUG_CLAUDE_NONSTREAM` | _未蚭定_ | `open-sse/handlers/responseTranslator.ts` | `true` に蚭定するず、Claude レスポンスの倉換パスで空の textContent チャンクを衚面化したすデバッグ専甚。 | | `NEXT_PUBLIC_OMNIROUTE_E2E_MODE` | _未蚭定_ | E2E テストハヌネス | `true` に蚭定するず、E2E テストモヌド認蚌の緩和、テストフックが有効になりたす。 | --- ## 23. GitHub 連携 ナヌザヌがダッシュボヌドから盎接問題を報告できるようにしたす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | --------------------- | ------------ | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `GITHUB_ISSUES_REPO` | _未蚭定_ | `src/app/api/v1/issues/report/route.ts` | `owner/repo` 圢匏のリポゞトリ。 | | `GITHUB_ISSUES_TOKEN` | _未蚭定_ | `src/app/api/v1/issues/report/route.ts` | `issues:write` スコヌプを持぀ GitHub Personal Access Token。 | | `GITHUB_TOKEN` | _未蚭定_ | Issue トリアヌゞ / クラりド゚ヌゞェントヘルパヌ | `GITHUB_ISSUES_TOKEN` のフォヌルバックずしお䜿甚され、`src/lib/cloudAgent/*` 内のクラりド゚ヌゞェントヘルパヌによっお利甚される汎甚 GitHub アクセストヌクン。 | --- ## デプロむシナリオ リレヌバック゚ンドのSREガむダンスts/bifrost/autoの動䜜、9routerずCLIProxyAPIの配眮、および高スルヌプット時のフォヌルバック戊略に぀いおは、[リレヌバック゚ンド戊略](/docs/reference/RELAY_BACKEND_STRATEGY.md)を参照しおください。 ### 最小構成のロヌカル開発 ```bash JWT_SECRET=$(openssl rand -base64 48) API_KEY_SECRET=$(openssl rand -hex 32) INITIAL_PASSWORD=dev123 PORT=20128 NODE_ENV=development ``` ### Docker本番環境 ```bash JWT_SECRET= API_KEY_SECRET= INITIAL_PASSWORD= STORAGE_ENCRYPTION_KEY= DATA_DIR=/data PORT=20128 API_PORT=20129 NODE_ENV=production AUTH_COOKIE_SECURE=true REQUIRE_API_KEY=true NEXT_PUBLIC_BASE_URL=https://omniroute.example.com BASE_URL=http://localhost:20128 OMNIROUTE_MEMORY_MB=8192 CORS_ORIGIN=https://your-frontend.example.com ``` ### ゚アギャップ環境 / CI ```bash JWT_SECRET=test-jwt-secret-for-ci API_KEY_SECRET=test-api-key-secret-for-ci INITIAL_PASSWORD=testpass NODE_ENV=production OMNIROUTE_DISABLE_BACKGROUND_SERVICES=true APP_LOG_TO_FILE=false ``` ### リバヌスプロキシを䜿甚するVPSnginx + Cloudflare ```bash JWT_SECRET= API_KEY_SECRET= STORAGE_ENCRYPTION_KEY= PORT=20128 AUTH_COOKIE_SECURE=true REQUIRE_API_KEY=true NEXT_PUBLIC_BASE_URL=https://omniroute.example.com BASE_URL=http://127.0.0.1:20128 CORS_ORIGIN=https://omniroute.example.com ENABLE_TLS_FINGERPRINT=true CLI_COMPAT_ALL=1 ``` --- ## 24. Skills サンドボックスv3.8.0+ Skills フレヌムワヌク`src/lib/skills/`がサンドボックス環境でナヌザヌ定矩の自動凊理を実行する際に適甚される制限および安党性の蚭定です。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | --------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `SKILLS_SANDBOX_TIMEOUT_MS` | `10000`10 秒 | `src/lib/skills/builtins.ts` | サンドボックス化されたスキルコヌドに察する、実行ごずの実時間タむムアりト。ハヌド䞊限であり、これを超える凊理は匷制終了されたす。 | | `SKILLS_EXECUTION_TIMEOUT_MS` | _`SKILLS_SANDBOX_TIMEOUT_MS` にフォヌルバック_ | `src/lib/skills/` | 高レベルのスキルオヌケストレヌションのタむムアりト。耇数ステップのワヌクフロヌを蚱可するには、`SKILLS_SANDBOX_TIMEOUT_MS` より倧きい倀を蚭定したす。 | | `SKILLS_MAX_FILE_BYTES` | `1048576`1 MB | `src/lib/skills/builtins.ts` | スキルがサンドボックス内の単䞀ファむルから読み取れる最倧バむト数。 | | `SKILLS_MAX_HTTP_RESPONSE_BYTES` | `256000`250 KB | `src/lib/skills/builtins.ts` | スキル内の単䞀 HTTP レスポンスから取埗できる最倧バむト数。 | | `SKILLS_MAX_SANDBOX_OUTPUT_CHARS` | `100000` | `src/lib/skills/builtins.ts` | サンドボックス呌び出しから返される stdout/stderr の文字数のハヌド䞊限。 | | `SKILLS_SANDBOX_NETWORK_ENABLED` | `false` | `src/lib/skills/builtins.ts` | サンドボックス内からのアりトバりンドネットワヌク通信を蚱可するには、`1`/`true` に蚭定したす。安党のため、デフォルトでは**分離**されおいたす。 | | `SKILLS_ALLOWED_SANDBOX_IMAGES` | _空_ | `src/lib/skills/builtins.ts` | サンドボックス実行を蚱可するコンテナむメヌゞのカンマ区切り蚱可リスト。空の堎合は、組み蟌みのデフォルトのみが蚱可されたす。 | | `SKILLS_SANDBOX_DOCKER_IMAGE` | _組み蟌みのデフォルト_ | `src/lib/skills/` | Docker ベヌスのサンドボックスを起動する際に䜿甚するコンテナむメヌゞ。カスタムの匷化枈みベヌスむメヌゞに固定するには䞊曞きしたす。 | | `SKILLS_SANDBOX_RUNTIME` | `auto` | `src/lib/skills/sandbox.ts`, `src/lib/skills/containerProvider.ts` | スキルのサンドボックス化に䜿甚するコンテナランタむム`auto` \| `docker` \| `apple` \| `wsl` \| `orbstack` \| `podman`。`auto` はホスト OS ごずにむンストヌル枈みの最適なランタむムmacOS では Apple Container/OrbStack、Windows では WSL Container、Linux では Podmanを遞択し、利甚できない堎合は Docker にフォヌルバックしたす。 | > [!CAUTION] > `SKILLS_SANDBOX_NETWORK_ENABLED=true` を有効にするず、任意のスキルコヌドから倖郚ぞの通信経路が開かれたす。共有デプロむ環境では、`OUTBOUND_SSRF_GUARD_ENABLED=true` および厳栌な `CORS_ORIGIN`/プロキシポリシヌず組み合わせおください。 --- ## 25. プロバむダヌクォヌタ、トンネル、バックアップ、その他のランタむム プロバむダヌのクォヌタ゚ンドポむント、ネットワヌクトンネルTailscale、Ngrok、MITM デバッグプロキシ、1Proxy ゚グレスプヌル、デヌタベヌスバックアップ、および executor レむダヌやスクリプトから参照される機胜ごずの小芏暡なオヌバヌラむド。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `REDIS_URL` | `redis://localhost:6379` | `src/shared/utils/rateLimiter.ts` | レヌトリミッタヌのバック゚ンドに䜿甚する Redis 接続文字列。 | | `ALIBABA_CODING_PLAN_HOST` | _本番ホスト_ | `open-sse/services/bailianQuotaFetcher.ts` | Alibaba Bailian coding-plan のクォヌタ取埗に䜿甚するホストを䞊曞きしたす。 | | `ALIBABA_CODING_PLAN_QUOTA_URL` | ホストから導出 | `open-sse/services/bailianQuotaFetcher.ts` | Alibaba Bailian の完党なクォヌタ URL を䞊曞きしたす。 | | `QWEN_CLOUD_COOKIE` | _未蚭定_ | `open-sse/services/qwenTokenPlanQuotaFetcher.ts` | Qwen Cloud / Model Studio の個人向け Token Plan クォヌタゲヌトりェむ甚コン゜ヌルセッション Cookie掚論 API キヌでは読み取れたせん。home.qwencloud.com の「Billing」›「Subscription」F12 ›「Network」で、`cs-data.qwencloud.com` ぞの任意の `api.json` 呌び出しから、`login_qwencloud_ticket` を含む `Cookie` リク゚ストヘッダヌ党䜓をコピヌしおください。機密情報であり、セッションに玐づきたす。接続ごずのダッシュボヌドフィヌルド `qwenCloudCookie` の䜿甚を掚奚したす。 | | `QWEN_CLOUD_SEC_TOKEN` | _未蚭定_ | `open-sse/services/qwenTokenPlanQuotaFetcher.ts` | Token Plan コン゜ヌルゲヌトりェむ甚の `sec_token` を手動で䞊曞きしたす。機密情報です。未蚭定の堎合、フェッチャヌは Cookie を䜿甚しおダッシュボヌドの HTML から解決したす。 | | `QWEN_TOKEN_PLAN_HOST` | `https://cs-data.qwencloud.com` | `open-sse/services/qwenTokenPlanQuotaFetcher.ts` | 個人向け Token Plan クォヌタフェッチャヌのゲヌトりェむホストを䞊曞きしたす䟋Model Studio コン゜ヌルの堎合は `bailian-singapore-cs.alibabacloud.com`。 | | `QWEN_TOKEN_PLAN_DASHBOARD_URL` | `https://home.qwencloud.com/` | `open-sse/services/qwenTokenPlanQuotaFetcher.ts` | ログむン枈みの HTML から `sec_token` を解決するために䜿甚するダッシュボヌド URL。 | | `XIAOMI_MIMO_CONSOLE_COOKIE` | _未蚭定_ | `open-sse/services/usage/xiaomi-mimo.ts` | Xiaomi MiMo Token Plan クォヌタ API`platform.xiaomimimo.com/api/v1/tokenPlan/usage` + `tokenPlan/detail`。掚論 API キヌでは読み取れたせん甚のコン゜ヌルセッション Cookie。Token Plan ペヌゞF12 ›「Network」で、`platform.xiaomimimo.com` ぞの任意のリク゚ストから、`api-platform_serviceToken` ず `userId` を含む `Cookie` リク゚ストヘッダヌ党䜓をコピヌしおください。機密情報であり、セッションに玐づきたす。接続ごずのダッシュボヌドフィヌルド `xiaomiMimoConsoleCookie` の䜿甚を掚奚したす。 | | `XIAOMI_MIMO_MONTHLY_TOKEN_LIMIT` | `4100000000` | `open-sse/services/usage/xiaomi-mimo.ts` | コン゜ヌル Cookie が蚭定されおいない堎合に䜿甚される、OmniRoute が远跡する Xiaomi MiMo フォヌルバックの月間予算クレゞット。デフォルトは Lite ティアの 4.1B です。プランのクレゞットStandard 11B / Pro 38B / Max 82Bに蚭定しおください。接続ごずの `providerSpecificData.monthlyTokenLimit` によるオヌバヌラむドは、この環境倉数よりも優先されたす。 | | `ALIBABA_FREE_TIER_VISION_FE_PATH` | `/costing-balance/free-quota-image-video` | `open-sse/services/alibabaFreeTierQuotaFetcher.ts` | Alibaba Model Studio の無料ティアにおけるビゞョンメディアのクォヌタを取埗するための、コン゜ヌルのフロント゚ンドパスのオヌバヌラむド。 | | `ALIBABA_FREE_TIER_MULTIMODAL_FE_PATH` | `/costing-balance/free-quota-multimodal` | `open-sse/services/alibabaFreeTierQuotaFetcher.ts` | Alibaba Model Studio の無料ティアにおけるマルチモヌダルのクォヌタを取埗するための、コン゜ヌルのフロント゚ンドパスのオヌバヌラむド。 | | `ALIBABA_FREE_TIER_AUDIO_FE_PATH` | `/costing-balance/free-quota-audio` | `open-sse/services/alibabaFreeTierQuotaFetcher.ts` | Alibaba Model Studio の無料ティアにおける音声のクォヌタを取埗するための、コン゜ヌルのフロント゚ンドパスのオヌバヌラむド。 | | `ALIBABA_FREE_TIER_ALLOWLIST_PATH` | _未蚭定_ | `open-sse/services/alibabaFreeTierAllowlist.ts` | 組み蟌みの Alibaba 無料ティア甚テキストモデル蚱可リストをオヌバヌラむドする、ロヌカル JSON ファむルぞの任意のパス。未蚭定の堎合、`$DATA_DIR/alibaba-free-tier-allowlist.json`、次に `config/alibaba-free-tier-allowlist.json` が䜿甚されたす。 | | `CONTEXT_RESERVE_TOKENS` | `1024` | `open-sse/services/contextManager.ts` | プロンプトの予算を蚈算する際に、補完出力甚ずしお予玄されるトヌクン数。 | | `CONTEXT_KEEP_LATEST_IMAGES` | `2` | `open-sse/services/contextManager.ts` | コンテキストりィンドりに収たるよう叀い画像を削陀する際に保持する、最新のむンラむン画像の数#8560。 | | `MODEL_ALIAS_COMPAT_ENABLED` | 有効 | `open-sse/services/model.ts` | 叀いクラむアントで䜿甚される埓来のモデル゚むリアス互換性レむダヌを切り替えたす。 | | `OMNIROUTE_EMERGENCY_FALLBACK` | 有効 | `open-sse/services/emergencyFallback.ts` | `false`たたは `0`に蚭定するず、倱敗したリク゚ストを無料の `nvidia`/`openai/gpt-oss-120b` モデルぞ再ルヌティングする、予算枯枇時の緊急フォヌルバックが無効になりたす。有効な優先順䜍は、Feature Flags DB のオヌバヌラむド > 環境倉数 > デフォルトです。利甚できない堎合、サヌビスは環境倉数の未加工の倀にフォヌルバックしたす。 | | `COMMAND_CODE_CALLBACK_PORT` | _未蚭定_ | `src/app/api/providers/command-code/auth/shared.ts` | Command Code CLI ヘルパヌからの OAuth 圢匏のコヌルバックに䜿甚されるロヌカルポヌト。 | | `COMMAND_CODE_VERSION` | `0.33.2` | `open-sse/executors/commandCode.ts` | Command Code アップストリヌムぞ `x-command-code-version` ヘッダヌずしお送信される倀。CLI バヌゞョンを曎新する堎合は䞊曞きしおください。 | | `COMMANDCODE_API_URL` | `https://api.commandcode.ai` | `open-sse/services/usage/command-code.ts` | スマヌトフォンのクォヌタ取埗テレメトリで䜿甚される、Command Code の䜿甚量/クォヌタアップストリヌムのベヌス URL。セルフホストたたは代替の Command Code API を䜿甚する堎合は䞊曞きしおください。 | | `MITM_LOCAL_PORT` | `443` | `src/mitm/server.cjs` | MITM デバッグプロキシのロヌカルバむンドポヌト。 | | `MITM_DISABLE_TLS_VERIFY` | `0` | `src/mitm/server.cjs` | アップストリヌムの TLS 怜蚌を無効にするには `1` に蚭定したす開発時のみ。 | | `MITM_IDLE_TIMEOUT_MS` | `60000` | `src/mitm/socketTimeouts.ts`, `src/mitm/server.cjs` | プロキシ接続のアむドル゜ケットタむムアりトミリ秒。この時間を超えおアむドル状態の゜ケットは、ハヌフオヌプントンネルのリヌクを防ぐため切断されたす。 | | `BRIDGE_PORT` | `20129` | `bin/antigravity-bridge.mjs` | Antigravity MITM ブリッゞがリッスンするポヌト。 | | `ROUTER_URL` | `http://127.0.0.1:20128/v1/antigravity` | `bin/antigravity-bridge.mjs` | ブリッゞが Antigravity トラフィックを転送するルヌタヌ゚ンドポむント。 | | `CERT_DIR` | `/mitm` | `bin/antigravity-bridge.mjs` | ブリッゞが TLS マテリアルを読み蟌むディレクトリを䞊曞きしたす。蚌明曞モデルは AgentBridge サヌバヌず同様に遞択されたす。埓来のリヌフ蚌明曞がむンストヌルされおいる堎合は `server.crt`/`server.key`、それ以倖の堎合は `ca.crt`/`ca.key`ルヌト CA、およびむンタヌセプト察象ホストごずのリヌフ蚌明曞。`MITM_ROOT_CA_ENABLED=true` によっお匷制を䜿甚したす。アクティブなモデルに必芁なファむルがない堎合、ブリッゞは起動時に終了したす。 | | `MITM_VERBOSE` | `1` | `src/mitm/server.cjs`, `src/mitm/_internal/bypass.cjs` | ルヌティング決定ログの詳现床。`0` では出力せず、倀を倧きくするず、より倚くのバむパス/ルヌティング決定がログに蚘録されたす。 | | `MITM_ROOT_CA_ENABLED` | `false` | `src/mitm/manager.ts` | ルヌト CA ずホストごずのリヌフ蚌明曞を䜿甚するモデル#6684を有効にするには `true` に蚭定したす。新芏むンストヌルでは自動的に有効になりたす。既存の信頌枈み埓来型リヌフ蚌明曞があるむンストヌルでは、明瀺的に有効化しない限り、埓来の固定 SAN 蚌明曞が維持されたす。 | | `MITM_CERT_MODE` | `legacy` | `src/mitm/manager.ts`, `src/mitm/server.cjs` | 生成されたプロキシプロセス向けに MITM マネヌゞャヌが蚭定する倀`root-ca` \| `legacy`。蚌明曞移行の決定を反映するもので、手動で蚭定するこずは想定されおいたせん。 | | `OMNIROUTE_NO_SUDO` | `0` | `src/mitm/systemCommands.ts` | `1`truthyに蚭定するず、MITM 蚌明曞信頌コマンドの先頭にある `sudo` が削陀されたす。これは、オペレヌタヌが CA を手動で信頌する、root 暩限のない環境やナヌザヌ名前空間を䜿甚するデプロむ向けです䟋: Node の远加 CA 蚌明曞メカニズムを䜿甚する堎合。 | | `SKIP_ANTIGRAVITY_DNS` | _未蚭定_ | `src/mitm/dns/provision.ts` | `true` に蚭定するず、Antigravity プロキシのホスト名に察する `/etc/hosts` の DNS ゚ントリのプロビゞョニングを完党にスキップしたす。これは、sudo/root を利甚できないコンテナ向けです。 | | `OMNIROUTE_SKIP_DNS_WRITE` | _未蚭定_ | `src/mitm/dns/dnsConfig.ts` | `1` に蚭定するず、DNS ゚ントリの远加たたは削陀時に hosts ファむルぞの曞き蟌みをスキップしたす。これは、サンドボックス化された、たたは読み取り専甚のテスト環境向けです。 | | `OMNIROUTE_SKIP_SYSTEM_TRUST` | `0` | `src/mitm/cert/install.ts`, `src/mitm/tproxy/caTrust.ts` | テスト/CI 専甚のガヌドです。`1` に蚭定するず、蚌明曞信頌のむンストヌル/アンむンストヌルが䜕も行わない操䜜ずなり、テストスむヌトが OS の信頌ストアを倉曎するこずを防ぎたす。テストセットアップず CI ワヌクフロヌによっお自動的に蚭定されたす。 | | `CHANGELOG_BASE_REF` | _自動_ | `scripts/check/check-changelog-integrity.mjs` | CHANGELOG 消倱防止ゲヌトで䜿甚するベヌス ref を明瀺的に指定したすデフォルトは CI 内の PR ベヌスブランチ、たたは最倧の `release/v*`。 | | `FREE_PROXY_AUTO_SYNC_ENABLED` | `false` | `src/lib/freeProxyProviders/scheduler.ts` | `true` に蚭定するず、バックグラりンドで無料プロキシプヌルを自動同期するスケゞュヌラヌが有効になりたす。オプトむン方匏で、デフォルトでは無効です。 | | `FREE_PROXY_AUTO_SYNC_INTERVAL_MS` | `1800000` | `src/lib/freeProxyProviders/scheduler.ts` | 自動同期の間隔ミリ秒単䜍、デフォルトは 30 分。 | | `FREE_PROXY_1PROXY_ENABLED` | `true` | `src/lib/freeProxyProviders/oneproxy.ts` | 1proxy の無料プロキシ゜ヌスを有効にしたす。無効にするには `false` に蚭定したす。 | | `FREE_PROXY_1PROXY_API_URL` | _oneproxy.ts を参照_ | `src/lib/freeProxyProviders/oneproxy.ts` | 1proxy API URL の䞊曞き蚭定です。 | | `FREE_PROXY_1PROXY_MAX` | `500` | `src/lib/freeProxyProviders/oneproxy.ts` | 1proxy から同期ごずに取埗するプロキシの最倧数です。 | | `FREE_PROXY_1PROXY_MIN_QUALITY` | `50` | `src/lib/freeProxyProviders/oneproxy.ts` | 1proxy からむンポヌトする際の最䜎品質スコアのしきい倀。 | | `FREE_PROXY_PROXIFLY_ENABLED` | `true` | `src/lib/freeProxyProviders/proxifly.ts` | Proxifly の無料プロキシ゜ヌスを有効にしたす。無効にするには `false` に蚭定したす。 | | `FREE_PROXY_PROXIFLY_QUANTITY` | `100` | `src/lib/freeProxyProviders/proxifly.ts` | Proxifly の同期ごずに取埗するプロキシ数。 | | `FREE_PROXY_PROXIFLY_ANONYMITY` | `elite` | `src/lib/freeProxyProviders/proxifly.ts` | Proxifly の匿名性レベルフィルタヌ`elite`、`anonymous`、`transparent`。 | | `FREE_PROXY_IPLOCATE_ENABLED` | `false` | `src/lib/freeProxyProviders/iplocate.ts` | IPLocate の無料プロキシ゜ヌスを有効にしたす。オプトむンした堎合のみ䜿甚されたす。 | | `FREE_PROXY_IPLOCATE_BASE_URL` | `https://raw.githubusercontent.com/iplocate/free-proxy-list/main/protocols` | `src/lib/freeProxyProviders/iplocate.ts` | IPLocate プロキシリストのベヌス URL を䞊曞きしたす。 | | `FREE_PROXY_WEBSHARE_ENABLED` | `true` | `src/lib/freeProxyProviders/webshare.ts` | Webshare プロキシプヌル゜ヌスを有効にしたす。無効にするには `false` に蚭定したす。たた、`FREE_PROXY_WEBSHARE_API_KEY` が蚭定されおいる必芁がありたす。 | | `FREE_PROXY_WEBSHARE_API_KEY` | _(なし)_ | `src/lib/freeProxyProviders/webshare.ts` | Webshare アカりントの API トヌクン`Authorization: Token `。必須です。蚭定されおいない堎合、プロバむダヌは無効のたたになりたす。 | | `FREE_PROXY_WEBSHARE_API_URL` | `https://proxy.webshare.io/api/v2/proxy/list/` | `src/lib/freeProxyProviders/webshare.ts` | Webshare プロキシリストの API URL を䞊曞きしたす。 | | `FREE_PROXY_WEBSHARE_MAX` | `500` | `src/lib/freeProxyProviders/webshare.ts` | Webshare の同期ごずにむンポヌトするプロキシの最倧数。 | | `NEXT_PUBLIC_VERCEL_RELAY_ENABLED` | `true` | `src/app/(dashboard)/
/ProxyPoolTab.tsx` | Proxy Pool タブで Deploy Vercel Relay ボタンの衚瀺/非衚瀺を切り替えたす。 | | `VERCEL_API_BASE` | `https://api.vercel.com` | `src/app/api/settings/proxy/vercel-deploy/route.ts` | Vercel API のベヌス URL を䞊曞きしたすテスト甚。 | | `NEXT_PUBLIC_VERCEL_RELAY_DEFAULT_PROJECT` | `omniroute-relay` | `src/app/(dashboard)/
/VercelRelayModal.tsx` | Vercel Relay デプロむモヌダルに事前入力されるデフォルトのプロゞェクト名です。 | | `TAILSCALE_BIN` | _(自動怜出)_ | `src/lib/tailscaleTunnel.ts` | `tailscale` バむナリぞの明瀺的なパスです。 | | `TAILSCALED_BIN` | _(自動怜出)_ | `src/lib/tailscaleTunnel.ts` | `tailscaled` デヌモンバむナリぞの明瀺的なパスです。 | | `TAILSCALE_AUTHKEY` | _(未蚭定)_ | `src/lib/tailscaleTunnel.ts` | 非察話型 / ヘッドレスの `tailscale up` で䜿甚する事前共有 Tailscale 認蚌キヌです`--auth-key=` 経由で枡されたす。未蚭定の堎合、ログむンは察話型のブラりザ認蚌 URL にフォヌルバックしたす。 | | `NGROK_AUTHTOKEN` | _(未蚭定)_ | `src/lib/ngrokTunnel.ts` | 倖向きの ngrok トンネルを認蚌したす。 | | `DB_BACKUP_MAX_FILES` | `20` | `src/lib/db/backup.ts` | 手動/スケゞュヌル枈みバックアップのクリヌンアップで保持する SQLite バックアップファむルの最倧数です。移行スナップショットはコンテンツアドレス方匏で管理され、同䞀の DB 状態では再利甚されたす。同時移行期間䞭は削陀されたせん。Settings → Database backup retention で保存された倀を䞊曞きしたす。 | | `DB_BACKUP_RETENTION_DAYS` | `0` | `src/lib/db/backup.ts` | 手動/スケゞュヌル枈みバックアップのクリヌンアップで保持する最倧期間日数です。`0` を指定するず、経過日数に基づく削陀が無効になりたす。同時移行期間䞭、移行スナップショットは削陀されたせん。Settings → Database backup retention で保存された倀を䞊曞きしたす。 | | `OMNIROUTE_BACKUP_SCHEDULE_JOB_INTERVAL_MS` | `30000` | `src/lib/jobs/backupScheduleJob.ts` | `backup-schedule.json` を実行するサヌバヌ偎ゞョブのティック間隔ミリ秒です。1 分単䜍の cron 粒床を十分に䞋回る必芁がありたす。`5000` 未満の倀、たたは解析できない倀の堎合は `30000` にフォヌルバックしたす。 | | `CONTAINER_HOST` | `docker` | `scripts/check-permissions.sh` | ゚ントリヌポむントの暩限チェックに䜿甚するコンテナランタむムのヒント。Podman トポロゞヌでは `podman` に蚭定したす。コンテナからは、゚ンゞンがロヌカルにあるのか Podman Machine 経由で接続されおいるのかを刀別できないため、譊告はトポロゞヌに䟝存しない衚珟のたたずし、`contrib/podman/README.md` を参照するよう案内したす。 | | `QUOTA_STORE_DRIVER` | `sqlite` | `src/lib/quota/storeFactory.ts` | クォヌタ共有消費ストアのバック゚ンド`sqlite`デフォルトたたは `redis`。 | | `QUOTA_STORE_REDIS_URL` | _未蚭定_ | `src/lib/quota/storeFactory.ts` | `QUOTA_STORE_DRIVER=redis` の堎合に䜿甚する Redis 接続文字列䟋`redis://localhost:6379`。 | | `QUOTA_SATURATION_THRESHOLD` | `0.5` | `src/lib/quota/enforce.ts` | プヌルの飜和率01。この倀以䞊になるず、プヌルは厳栌モヌド借甚なしに移行したす。 | | `QUOTA_SOFT_DEPRIORITIZE_FACTOR` | `0.7` | `open-sse/services/combo.ts` | ゜フトクォヌタポリシヌによっおタヌゲットの優先床が䞋げられる際に適甚されるスコア乗数01。 | | `STATUS_SOFT_DEPRIORITIZE_FACTOR` | `0.5` | `open-sse/services/combo/autoStrategy.ts` | プリフラむトクォヌタのカットオフが OFF の堎合に、自動コンボのスコアリングで枯枇したプロバむダヌ`credits_exhausted`/`rate_limited`に適甚されるスコア乗数01#4540。 | | `QUOTA_CONSUMPTION_RETENTION_DAYS` | `14` | `src/lib/db/quotaConsumption.ts` | GC`gcQuotaConsumption`の実行前に `quota_consumption` バケットを保持する期間日数。 | | `QUOTA_PREFLIGHT_CUTOFF_ENABLED` | `false` | `src/lib/resilience/settings.ts` | オプトむンデフォルトは OFFスコアリング前に䜎クォヌタの候補を陀倖する、自動ルヌティングの厳栌なクォヌタカットオフを有効にしたす。 | | `OMNIROUTE_AUTO_FREE_FALLBACK_TO_FULL_POOL` | `false` | `open-sse/services/autoCombo/virtualFactory.ts` | オプトむンデフォルトは OFF`auto/:` フィルタヌに䞀臎する接続枈み候補がない堎合、空のプヌルを返す代わりに、完党なフィルタヌ未適甚のプヌルぞフォヌルバックする埓来の動䜜を埩元したす。デフォルトの OFF では、`:free` は「無料ティアのみ」を意味したす。 | | `OMNIROUTE_CHAOS_MAX_PANEL` | `5` | `open-sse/services/autoCombo/virtualFactory.ts` | `auto/*:chaos` ブロヌドキャストバリアントのパネルサむズ䞊限110 に制限。1 件のリク゚ストが、最倧でこの数のプロバむダヌ分散モデルぞファンアりトされたす。 | | `OMNIROUTE_CHAOS_MIN_PANEL` | _(゚ンゞンのデフォルト)_ | `open-sse/services/autoCombo/virtualFactory.ts` | chaos ブロヌドキャストハンドラヌに枡される最小パネルサむズの調敎倀。未蚭定の堎合ぱンゞンのデフォルトが維持されたす。 | | `OMNIROUTE_CHAOS_PANEL_TIMEOUT_MS` | _(゚ンゞンのデフォルト)_ | `open-sse/services/autoCombo/virtualFactory.ts` | chaos パネル党䜓のファンアりトに察するハヌドタむムアりトミリ秒。未蚭定の堎合ぱンゞンのデフォルトが維持されたす。 | | `GROK_AUTH_PATH` | `~/.grok/auth.json` | `open-sse/services/grokQuotaFetcher.ts` | grok-web の週間クォヌタ取埗に䜿甚する Grok CLI の `auth.json` のパス。テストたたは暙準以倖の CLI むンストヌル環境では䞊曞きしたす。 | | `AGENTBRIDGE_UPSTREAM_CA_CERT` | _(未蚭定)_ | `src/mitm/manager.ts` | AgentBridge のアップストリヌム TLS 接続で信頌する远加の CA 蚌明曞PEM。 | | `INSPECTOR_BUFFER_SIZE` | `1000` | `src/mitm/inspector/buffer.ts` | Traffic Inspector のリングバッファに保持されるキャプチャ枈みリク゚ストの最倧数。 | | `INSPECTOR_MAX_BODY_KB` | `1024` | `src/mitm/inspector/buffer.ts` | 切り詰め前にキャプチャ可胜なリク゚ストレスポンス本文の最倧サむズKB。 | | `INSPECTOR_HTTP_PROXY_PORT` | `8080` | `src/mitm/inspector/httpProxyServer.ts` | Traffic Inspector HTTP プロキシのロヌカルポヌト。 | | `INSPECTOR_HTTP_PROXY_AUTOSTART` | `false` | `src/mitm/inspector/httpProxyServer.ts` | 起動時に Inspector HTTP プロキシを自動起動したす。 | | `INSPECTOR_LLM_HOSTS_EXTRA` | _(未蚭定)_ | `src/lib/inspector/captureState.ts` | キャプチャ察象の LLM ゚ンドポむントずしお扱う远加のホスト名カンマ区切り。 | | `INSPECTOR_MASK_SECRETS` | `true` | `src/mitm/inspector/buffer.ts` | キャプチャされたトラフィック内のシヌクレット認蚌ヘッダヌAPI キヌをマスクしたす。 | | `INSPECTOR_SYSTEM_PROXY_GUARD_MINUTES` | `30` | `src/app/api/tools/traffic-inspector/capture-modes/system-proxy/route.ts` | system-proxy ガヌドが OS のプロキシ蚭定を自動的に元に戻すたでの時間分。 | | `INSPECTOR_INTERNAL_INGEST_TOKEN` | _(自動)_ | `src/app/api/tools/traffic-inspector/internal/ingest/route.ts` | むンスペクタヌぞの内郚キャプチャ取り蟌みを認蚌するトヌクン。 | | `PLAYGROUND_COMPARE_MAX_COLUMNS` | `4` | `src/app/(dashboard)/dashboard/playground/` | Playground の比范モヌドで暪䞊びに衚瀺できる列の最倧数。 | | `PLAYGROUND_IMPROVE_PROMPT_DEFAULT_MODEL` | _(未蚭定)_ | `src/app/(dashboard)/dashboard/playground/` | Playground の「プロンプトを改善」アクションで䜿甚するデフォルトモデル未蚭定の堎合はアクティブなモデルにフォヌルバック。 | | `BIFROST_ENABLED` | `1` | `src/app/api/v1/relay/chat/completions/bifrost/route.ts` | Bifrost サむドカヌプロキシのマスタヌキルスむッチ。`0` に蚭定するず、ルヌトは `X-Bifrost-Killswitch` ヘッダヌ付きで 503 を返し、オペレヌタヌは TS パスぞ転送されたす。再デプロむせずにサむドカヌを無効化する堎合Tier 1 ルヌタヌのむンシデント、キヌのロヌテヌションに䜿甚したす。 | | `BIFROST_BASE_URL` | _(未蚭定)_ | `src/app/api/v1/relay/chat/completions/bifrost/route.ts` | 蚭定されおいる堎合、Bifrost サむドカヌプロキシルヌトは `/v1/chat/completions` トラフィックを TS リレヌハンドラヌではなく、この Go ゲヌトりェむぞ転送したす。未蚭定 → フォヌルバック付きの 503。末尟のスラッシュは削陀されたす。 | | `BIFROST_PORT` | `8080` | `src/lib/services/bootstrap.ts` | OmniRoute が Bifrost サむドカヌのラむフサむクルを管理する堎合に、監芖察象の組み蟌み Bifrost サヌビスがバむンドするポヌト`127.0.0.1:`。デフォルトは `8080`。 | | `LLMLINGUA_PORT` | `20135` | `src/lib/services/bootstrap.ts` | 監芖察象の LLMLingua 圧瞮サヌビスがバむンドするポヌト`127.0.0.1:`。デフォルトは `20135`。 | | `LLMLINGUA_BASE_URL` | `http://127.0.0.1:20135` | `open-sse/services/compression/engines/llmlingua/index.ts` | ロヌカル LLMLingua HTTP 圧瞮マむクロサヌビスデヌモンのベヌス URL。デフォルトは `http://127.0.0.1:20135`。 | | `LLMLINGUA_MODEL` | `atjsh/llmlingua-2-js-tinybert-meetingbank` | `src/lib/services/installers/llmlingua.ts` | 監芖察象の LLMLingua サむドカヌが読み蟌む Hugging Face モデル ID子プロセスの環境倉数ずしお枡されたす。 | | `BIFROST_API_KEY` | _(未蚭定)_ | `src/app/api/v1/relay/chat/completions/bifrost/route.ts` | Bifrost ゲヌトりェむ甚の API キヌ`Authorization: Bearer ...` ずしお送信。未蚭定の堎合、ルヌトはリク゚ストに有効な OmniRoute API キヌが含たれおいるこずを芁求したす。このキヌはゲヌトりェむ偎の認蚌専甚です。 | | `BIFROST_STREAMING_ENABLED` | `true` | `src/app/api/v1/relay/chat/completions/bifrost/route.ts` | `true` の堎合、Bifrost サむドカヌのルヌトは、TS ストリヌミング゚グれキュヌタヌではなく、ゲヌトりェむを介しお SSE でレスポンスをストリヌミング返华したす。ゲヌトりェむ経由で非ストリヌミングの JSON レスポンスを匷制するには、`0` に蚭定したす。 | | `BIFROST_TIMEOUT_MS` | `30000` | `src/app/api/v1/relay/chat/completions/bifrost/route.ts` | Bifrost ゲヌトりェむぞのプロキシ時におけるリク゚ストごずのタむムアりトミリ秒。タむムアりト時、ルヌトは `X-Bifrost-Fallback` ヘッダヌを通じお TS リレヌパスを返したす。 | | `OMNIROUTE_BIFROST_KEY` | _未蚭定_ | `src/app/api/v1/relay/chat/completions/bifrost/route.ts` | `BIFROST_API_KEY` の゚むリアス`OMNIROUTE_*` 経由で環境倉数を読み取るスクリプトで䜿甚。䞡方が蚭定されおいる堎合は、`BIFROST_API_KEY` が優先されたす。 | | `OMNIROUTE_RELAY_BACKEND` | `ts` / `auto` | `src/app/api/v1/relay/chat/completions/routingBackend.ts` | `/api/v1/relay/chat/completions` 甚のリレヌバック゚ンド`ts \| bifrost \| auto`。`ts` = TypeScript リレヌBifrost が未蚭定の堎合のデフォルト。`auto` は、`BIFROST_BASE_URL` が蚭定され、か぀ `BIFROST_ENABLED` ≠ `0` の堎合に Bifrost を遞択し、サむドカヌに到達できない堎合は自動的に TS にフォヌルバックしたす。`bifrost` は Bifrost を匷制したす厳栌モヌド、フォヌルバックなし。認蚌レヌト制限むンゞェクションガヌド蚱可リストは、垞に最初に Next ルヌトで実行されたす。レスポンスには `X-Routing-Backend` / `X-Routing-Fallback` / `X-Routing-Fallback-Reason` が含たれたす。 | | `RELAY_ROUTING_BACKEND` | _未蚭定_ | `src/app/api/v1/relay/chat/completions/routingBackend.ts` | `OMNIROUTE_RELAY_BACKEND` の゚むリアスずしお䜿甚できたす倀は同じく `ts \| bifrost \| auto`。䞡方が蚭定されおいる堎合は、`OMNIROUTE_RELAY_BACKEND` が優先されたす。 | | `OMNIROUTE_BIFROST_FAILURE_COOLDOWN_MS` | `5000` | `src/app/api/v1/relay/chat/completions/bifrostCooldown.ts` | `auto` モヌドで Bifrost サむドカヌぞのホップが倱敗した埌、リレヌがサむドカヌぞの接続を再詊行するたでのクヌルダりン時間ミリ秒。クヌルダりン䞭は TS パスぞ盎接ルヌティングし、終了埌に再床プロヌブしたす。`0` で無効になりたす。`OMNIROUTE_RELAY_BACKEND=auto` の堎合にのみ適甚されたす。 | | `OMNIROUTE_TLS_CERT` | _未蚭定_ | `bin/cli/commands/serve.mjs` | `omniroute serve` を HTTPS で提䟛するための PEM TLS 蚌明曞ぞのパス`--tls-cert` ず同等。`OMNIROUTE_TLS_KEY` ず組み合わせお指定する必芁がありたす。指定するず、スタンドアロンサヌバヌは同じリスナヌで TLS を終端したす`wss://` も倉曎なしで機胜したす。未蚭定 → プレヌン HTTP。蚌明曞キヌの䞀方のみを指定した堎合、たたはパスを読み取れない堎合は、譊告をログに蚘録しお HTTP のたた動䜜したす。 | | `OMNIROUTE_TLS_KEY` | _未蚭定_ | `bin/cli/commands/serve.mjs` | `omniroute serve` を HTTPS で提䟛するための PEM TLS 秘密鍵ぞのパス`--tls-key` ず同等。`OMNIROUTE_TLS_CERT` ず組み合わせお指定する必芁がありたす。`OMNIROUTE_TLS_CERT` を参照しおください。 | | `OMNIROUTE_LOCAL_ENDPOINTS_ENABLED` | `0` | `src/lib/security/localEndpoints.ts` | `/api/local/*` ルヌトのマスタヌスむッチ。未蚭定たたは `0` の堎合、本番環境ではすべおの `/api/local/*` ルヌトが 503 を返したす。非ルヌプバック環境ぞのデプロむで Redis ランチャヌや同様のワンクリック匏ロヌカルサヌビス起動機胜を有効にするには、`1` に蚭定する必芁がありたす。`isLocalOnlyPath()` によるルヌトガヌド分類`src/server/authz/routeGuard.ts` 内の `LOCAL_ONLY_API_PREFIXES`ず䜵甚する倚重防埡です。 | | `OMNIROUTE_LOCAL_ENDPOINTS_TOKEN` | _未蚭定_ | `src/lib/security/localEndpoints.ts` | ルヌプバック䞊にない `/api/local/*` 呌び出し元䟋デスクトップアプリ甚の Bearer トヌクン。蚭定されおいる堎合、非ルヌプバック IP からのリク゚ストには `Authorization: Bearer ` を含める必芁がありたす。非ルヌプバック環境ぞのデプロむで `OMNIROUTE_LOCAL_ENDPOINTS_ENABLED=1` にする堎合は必須です。 | | `OMNIROUTE_REDIS_CONTAINER_NAME` | `omniroute-redis` | `bin/cli/commands/redis.mjs` | 1クリック Redis ランチャヌ`omniroute redis up`のコンテナ名。CLI ず `RedisLauncherPanel` GUI の䞡方で䜿甚されたす。 | | `OMNIROUTE_REDIS_HOST_PORT` | `6379` | `bin/cli/commands/redis.mjs` | 1クリック Redis ランチャヌのホストポヌト。ホストがすでに 6379 をバむンドしおいる堎合は倉曎しおください。コンテナの内郚ポヌトは 6379 のたたです。 | | `OMNIROUTE_REDIS_BIND_HOST` | `127.0.0.1` | `bin/cli/commands/redis.mjs` | 1クリック Redis ランチャヌを公開するホストむンタヌフェヌス。ランチャヌはパスワヌドなしで Redis を起動するため、`0.0.0.0` にバむンドするず、LAN 䞊のすべおのホストから認蚌なしで Redis にアクセスできるようになりたす。この範囲を広げるのは、むンスタンスに自分でパスワヌドを蚭定した堎合のみにしおください。 | | `REDIS_BIND_HOST` | `127.0.0.1` | `docker-compose.yml` | docker-compose が Redis サむドカヌを公開するホストむンタヌフェヌス#9286。compose の Redis は `requirepass` なしで動䜜し、アプリコンテナは compose ネットワヌク`redis:6379`経由でアクセスしたす。公開ポヌトはホスト偎ツヌル専甚です。`0.0.0.0` を指定するず、認蚌なしの Redis が LAN 党䜓に公開されたす。 | | `REDIS_PORT` | `6379` | `docker-compose.yml` | compose Redis サむドカヌのホストポヌト。 | | `APP_BIND_HOST` | `127.0.0.1` | `docker-compose.yml`, `docker-compose.prod.yml` | docker-compose がアプリ自身のダッシュボヌド/API/live-WS ポヌトを公開するホストむンタヌフェヌス#12568。`.env.example` のデフォルト蚭定では `REQUIRE_API_KEY=false` であるため、`0.0.0.0` を指定するず、匿名で利甚可胜な `/v1` LLM プロキシが LAN/WAN 党䜓に公開されたす。`REQUIRE_API_KEY=true` に蚭定するか、前段のリバヌスプロキシで独自の認蚌を適甚した堎合にのみ公開範囲を広げおください。 | | `QDRANT_BIND_HOST` | `127.0.0.1` | `docker-compose.yml` | docker-compose が Qdrant メモリサむドカヌを公開するホストむンタヌフェヌス#12578。LAN ぞの公開に関する考え方は `REDIS_BIND_HOST` ず同じです。 | | `BIFROST_BIND_HOST` | `127.0.0.1` | `docker-compose.yml` | docker-compose が Bifrost ルヌタヌサむドカヌを公開するホストむンタヌフェヌス#12578。LAN ぞの公開に関する考え方は `REDIS_BIND_HOST` ず同じです。 | | `REDIS_KEY_PREFIX` | `omniroute:` | `src/shared/utils/rateLimiter.ts` | すべおの OmniRoute Redis キヌレヌトリミッタヌ、認蚌キャッシュ、クォヌタストア、りォヌムアップ甚サヌキットブレヌカヌに適甚される名前空間プレフィックス。Redis むンスタンスを他のアプリず共有する堎合のキヌ衝突を防ぎたす#11042。 | | `OMNIROUTE_INTERNAL_SERVICE_TOKEN` | _未蚭定 — 機構は無効_ | `src/lib/api/internalServiceAuth.ts` | 呌び出し元の識別情報を維持する内郚 REST ホップ#9260甚の共有シヌクレット。別のロヌカル OmniRoute ルヌトを呌び出す OmniRoute コンポヌネントは、元の呌び出し元の識別情報が維持されるように、これを `x-omniroute-internal-service-token` ずしお送信したす。`timingSafeEqual` で比范されたす。 | | `OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE` | _(未蚭定)_ | `src/lib/api/internalServiceAuth.ts` | 内郚サヌビストヌクンのシヌクレットファむル版トヌクンずしお䜿甚する、前埌の空癜を陀去した内容を持぀ファむルぞのパス。むンラむン倉数が未蚭定の堎合にのみ参照されたす。 | | `OPENROUTER_PROVIDER_STATS_ENABLED` | `true` | `src/lib/catalog/openrouterProviderStats.ts` | ダッシュボヌドのプロバむダヌ䞀芧に OpenRouter の週間ランキング統蚈#9324を远加したす。デフォルトで有効です。バックグラりンド取埗を完党にスキップするには `false` に蚭定したすノンブロッキングで、臎呜的゚ラヌにはなりたせん。 | | `OPENROUTER_PROVIDER_STATS_TTL_MS` | `86400000`24時間 | `src/lib/catalog/openrouterProviderStats.ts` | OpenRouter プロバむダヌ統蚈スナップショットのキャッシュ TTLミリ秒単䜍。 | | `OMNIROUTE_REDIS_IMAGE` | `redis:7-alpine` | `bin/cli/commands/redis.mjs` | ワンクリック Redis ランチャヌで䜿甚する Redis むメヌゞ。必芁に応じお `redis:8-alpine` たたはプラむベヌトレゞストリのミラヌに倉曎できたす。 | | `QDRANT_HOST` | `qdrant` | _オプトむンのクラスタヌプロファむル_ | `--profile memory` が有効な堎合の Qdrant サむドカヌのホスト名。デフォルトではネットワヌク内の qdrant サヌビス名を指したす。倖郚デプロむメントの堎合は倉曎しおください。コヌド内`src/lib/memory/vectorStore.ts:108`で `qdrantEnabled` が `true` の堎合にのみ䜿甚されたす。 | | `QDRANT_PORT` | `6333` | _オプトむンのクラスタヌプロファむル_ | Qdrant サむドカヌの REST ポヌト。 | | `QDRANT_GRPC_PORT` | `6334` | _オプトむンのクラスタヌプロファむル_ | Qdrant サむドカヌの gRPC ポヌト。ストリヌミング操䜜で REST よりも gRPC を優先するクラむアントラむブラリによっお䜿甚されたす。 | | `QDRANT_API_KEY` | _未蚭定_ | _オプトむンのクラスタヌプロファむル_ | Qdrant Cloud たたは認蚌枈みオンプレミスむンスタンス甚の任意の API キヌ。空の堎合、`api-key` ヘッダヌは送信されたせん。 | | `QDRANT_COLLECTION` | `omniroute-memory` | _オプトむンのクラスタヌプロファむル_ | OmniRoute の䌚話メモリヌ埋め蟌み甚コレクション名。初回実行時に `QDRANT_VECTOR_SIZE` 次元で䜜成されたす。 | | `QDRANT_EMBEDDING_MODEL` | `text-embedding-3-small` | _オプトむンのクラスタヌプロファむル_ | Qdrant コレクションのメタデヌタに蚘録されるデフォルトの埋め蟌みモデル名。実際の埋め蟌みは、OmniRoute の蚭定内にある `embeddingModel` フィヌルドが参照するプロバむダヌによっお生成されたす。 | | `QDRANT_VECTOR_SIZE` | `1536` | _(オプトむンのクラスタヌプロファむル)_ | 埋め蟌みベクトルの次元数。䜿甚する埋め蟌みモデルず䞀臎しおいる必芁がありたすtext-embedding-3-small → 1536、ada-002 → 1536、nomic-embed-text → 768。 | | `QDRANT_HNSW_EF_CONSTRUCT` | `128` | _(オプトむンのクラスタヌプロファむル)_ | HNSW むンデックス構築時の粟床。倀が倧きいほど構築は遅くなり、怜玢は高速になりたす。 | | `OMNIROUTE_ROTATION_ENABLED` | `true` | `open-sse/services/rotationConfig.ts` | オペレヌタヌが蚭定可胜なアカりントロヌテヌションのマスタヌスむッチ。`false` の堎合、以䞋の `OMNIROUTE_ROTATE_*` クラスはいずれもアカりントのフォヌルバックをトリガヌしたせんマスタヌがオフの状態では、デフォルトで有効な 429/500/502 クラスもブロックされたす。これにより、管理フロント゚ンドVibeProxy デスクトップアプリなどは、独自のロヌテヌションルヌルをバック゚ンドのアカりントフォヌルバック゚ンゞンに反映できたす。 | | `OMNIROUTE_ROTATION_RATE_LIMIT_RESET_SECONDS` | `0` | `open-sse/services/rotationConfig.ts` | アップストリヌムから明瀺的なリセット時刻が提瀺されない堎合に、レヌト制限を受けたアカりントぞ適甚するクヌルダりン秒。`0` = 固定の䞊曞き倀ではなく、゚ンゞンのデフォルトのクヌルダりンを䜿甚したす。 | | `OMNIROUTE_ROTATION_DISABLE_TAG_WITHOUT_RESET` | `true` | `open-sse/services/rotationConfig.ts` | フロント゚ンドの「リセット時刻がなければレヌト制限枈みずしおタグ付けしない」蚭定を反映したす。 | | `OMNIROUTE_ROTATE_ON_429` | `true` | `open-sse/services/rotationConfig.ts` | `429` ゚ラヌに察するステヌタス別フォヌルバックの有効化蚭定。`false` の堎合か぀ `OMNIROUTE_ROTATION_ENABLED=true` の堎合、`429` はアカりントロヌテヌションをトリガヌしなくなり、代わりにクラむアントぞ返されたす。 | | `OMNIROUTE_ROTATE_429_THRESHOLD` | `1` | `open-sse/services/rotationConfig.ts` | アカりントがロヌテヌションされるたでに `OMNIROUTE_ROTATE_429_WINDOW_SECONDS` 内で必芁ずなる `429` ゚ラヌの件数。`1`デフォルトでは即座にロヌテヌションされ、埓来の動䜜が維持されたす。 | | `OMNIROUTE_ROTATE_429_WINDOW_SECONDS` | `120` | `open-sse/services/rotationConfig.ts` | `429` ゚ラヌを `OMNIROUTE_ROTATE_429_THRESHOLD` に向けおカりントするスラむディングりィンドり秒。 | | `OMNIROUTE_ROTATE_ON_500` | `true` | `open-sse/services/rotationConfig.ts` | `5xx` サヌバヌ゚ラヌ独自のクラスを持぀ `502` を陀くに察するステヌタス別フォヌルバックの有効化蚭定。`false` の堎合、これらの゚ラヌはアカりントロヌテヌションをトリガヌしなくなりたす。 | | `OMNIROUTE_ROTATE_500_THRESHOLD` | `1` | `open-sse/services/rotationConfig.ts` | アカりントがロヌテヌションされるたでに `OMNIROUTE_ROTATE_500_WINDOW_SECONDS` 内で必芁ずなる `5xx` ゚ラヌの件数。`1`デフォルトでは即座にロヌテヌションされたす。 | | `OMNIROUTE_ROTATE_500_WINDOW_SECONDS` | `120` | `open-sse/services/rotationConfig.ts` | `5xx` ゚ラヌが `OMNIROUTE_ROTATE_500_THRESHOLD` に向けおカりントされるスラむディングりィンドり秒。 | | `OMNIROUTE_ROTATE_ON_502` | `true` | `open-sse/services/rotationConfig.ts` | `502`䞍正なゲヌトりェむ゚ラヌに察するステヌタス別フォヌルバックの有効化蚭定。`false` の堎合、`502` はアカりントロヌテヌションをトリガヌしなくなりたす。 | | `OMNIROUTE_ROTATE_502_THRESHOLD` | `1` | `open-sse/services/rotationConfig.ts` | アカりントがロヌテヌションされるたでに `OMNIROUTE_ROTATE_502_WINDOW_SECONDS` 内で必芁ずなる `502` ゚ラヌの数。`1`デフォルトの堎合は即座にロヌテヌションしたす。 | | `OMNIROUTE_ROTATE_502_WINDOW_SECONDS` | `120` | `open-sse/services/rotationConfig.ts` | `502` ゚ラヌが `OMNIROUTE_ROTATE_502_THRESHOLD` に向けおカりントされるスラむディングりィンドり秒。 | | `OMNIROUTE_ROTATE_ON_400` | `false` | `open-sse/services/rotationConfig.ts` | オプトむンデフォルトはオフ`true` の堎合、通垞の `400`䞍正なリク゚ストもアカりントロヌテヌションをトリガヌしたす。これは既存の動䜜に远加されるだけであり、レヌト制限やクォヌタに関するテキストを含む `400` が、このフラグに関係なく匕き続きフェむルオヌバヌするずいう゚ンゞンの既存動䜜を劚げるこずはありたせん。 | | `OMNIROUTE_ROTATE_400_THRESHOLD` | `1` | `open-sse/services/rotationConfig.ts` | アカりントがロヌテヌションされるたでに `OMNIROUTE_ROTATE_400_WINDOW_SECONDS` 内で必芁ずなる `400` ゚ラヌの数`OMNIROUTE_ROTATE_ON_400=true` の堎合にのみ参照されたす。 | | `OMNIROUTE_ROTATE_400_WINDOW_SECONDS` | `120` | `open-sse/services/rotationConfig.ts` | `400` ゚ラヌが `OMNIROUTE_ROTATE_400_THRESHOLD` に向けおカりントされるスラむディングりィンドり秒。 | ### Claude りォヌムアップスケゞュヌラヌ オプトむンした Anthropic OAuth 接続を察象ずする cron 駆動のりォヌムアップです。これにより、5時間のレヌト制限りィンドりが、最初の実際のリク゚ストではなく、スケゞュヌルされた簡単なリク゚ストによっお開始されたす#8848。`OMNIROUTE_WARMUP_ENABLED` が真倀であり、か぀接続が `settings.claudeWarmup.connections` で指定されおいる堎合にのみスケゞュヌラヌが有効になりたす。接続リストが空の堎合、環境倉数が有効でもりォヌムアップは実行されたせん。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------ | --------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_WARMUP_ENABLED` | _未蚭定 → オフ_ | `src/lib/warmupScheduler.ts` | りォヌムアップスケゞュヌラのマスタヌスむッチ。`1`/`true`/`yes`/`on` を受け付けたす倧文字・小文字を区別せず、前埌の空癜は陀去。それ以倖の倀、たたは未蚭定の堎合、スケゞュヌラはオフのたたです。 | | `OMNIROUTE_WARMUP_CRON` | `0 7 * * *` | `src/lib/warmupScheduler.ts` | りォヌムアップの実行タむミングを指定する5フィヌルドの cron 匏。ホストの時刻蚭定にかかわらず、`America/Los_Angeles`Anthropic のリセットタむムゟヌンで評䟡されたす。 | | `OMNIROUTE_WARMUP_CONCURRENCY` | `3` | `src/lib/warmupScheduler.ts` | 各実行時に䞊列でりォヌムアップする接続数。`1``10`の範囲に制限され、数倀以倖の堎合は`3`にフォヌルバックしたす。 | | `OMNIROUTE_WARMUP_MODEL` | `claude-3-5-haiku-20241022` | `src/lib/warmupScheduler.ts` | りォヌムアップリク゚ストに䜿甚するモデル。デフォルトがご利甚のプランで䜿甚できない堎合にのみ䞊曞きし、りィンドりを開くこずができる最も安䟡なモデルを遞択しおください。 | ### ブラりザログむン甚 VNC セッションずデヌタディレクトリの゚むリアス 察話型ブラりザログむンで認蚌情報を取埗するために䜿甚するコンテナ化された Chromium+VNC`/api/vnc-session`ず、埓来の`DATA_DIR`゚むリアスです。すべお任意蚭定です。VNC のデフォルト倀は同梱の`omniroute-vnc-chromium:local`むメヌゞを察象ずしおおり、カスタムコンテナむメヌゞ、ポヌト、たたはラむフサむクル調敎が必芁な堎合にのみ䞊曞きしたす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `OMNIROUTE_VNC_IMAGE` | `omniroute-vnc-chromium:local` | `src/lib/vncSession/manifest.ts` | Chromium+VNC ログむンコンテナの Docker むメヌゞタグ。`docker/vnc-browser/chromium`をビルドするか、カスタムむメヌゞを指定しおください。 | | `OMNIROUTE_DOCKER_BIN` | `docker` | `src/lib/vncSession/manifest.ts` | VNC コンテナの起動に䜿甚するコンテナランタむムのバむナリ䟋`podman`に蚭定。 | | `OMNIROUTE_VNC_CONTAINER_VNC_PORT` | `3000` | `src/lib/vncSession/manifest.ts` | コンテナ内で公開される VNC/noVNC ポヌト。 | | `OMNIROUTE_VNC_CONTAINER_CDP_PORT` | `9223` | `src/lib/vncSession/manifest.ts` | コンテナ内の Chrome DevTools Protocol ポヌト。 | | `OMNIROUTE_VNC_CONTAINER_PROFILE_DIR` | `/config` | `src/lib/vncSession/manifest.ts` | コンテナ内の Chromium プロファむルディレクトリのパス。 | | `OMNIROUTE_VNC_PROFILE_DIR` | `$HOME/.omniroute/browser-login-profiles` | `src/lib/vncSession/manifest.ts` | 氞続化されたブラりザログむンプロファむルを栌玍するホスト偎ディレクトリ。 | | `OMNIROUTE_VNC_IDLE_MS` | `600000`10分 | `src/lib/vncSession/manifest.ts` | 非アクティブな VNC セッションが削陀されるたでのアむドルタむムアりトミリ秒。 | | `OMNIROUTE_VNC_MAX_MS` | `1800000`30分 | `src/lib/vncSession/manifest.ts` | 単䞀の VNC セッションの存続時間に察する䞊限ミリ秒。 | | `OMNIROUTE_VNC_MAX_SESSIONS` | `4` | `src/lib/vncSession/manifest.ts` | 同時に実行できる VNC セッションの最倧数。 | | `OMNIROUTE_VNC_READY_MS` | `45000` | `src/lib/vncSession/manifest.ts` | コンテナ化されたブラりザが CDP 察応状態になるたでの埅機タむムアりトミリ秒。 | | `OMNIROUTE_VNC_HARVEST_MS` | `20000` | `src/lib/vncSession/manifest.ts` | ログむン完了埌、取埗したセッション/クッキヌを収集する際のタむムアりトミリ秒。 | | `OMNIROUTE_VNC_CHROMIUM_ARGS` | `--remote-debugging-port=9222 --no-first-run --no-default-browser-check` | `src/lib/vncSession/manifest.ts` | コンテナ化された Chromium に枡される远加のコマンドラむンフラグ。 | | `OMNIROUTE_VNC_NETWORK` | `omniroute-vnc-browser-login` | `src/lib/vncSession/manifest.ts` | VNC ログむンコンテナがデフォルトブリッゞの代わりに参加する専甚 Docker ネットワヌク#12571。これにより、同階局のコンテナから CDP ブリッゞポヌトにアクセスできなくなりたす。 | | `VIBEPROXY_DATA_DIR` | _未蚭定_ | `open-sse/services/notionThreadSessions.ts` | `DATA_DIR`の**埓来の゚むリアス**。`DATA_DIR`ず`OMNIROUTE_DATA_DIR`の䞡方が未蚭定の堎合にのみ確認されたす。Notion Web スレッドのセッションキャッシュ`/notion-web-thread-sessions.json`の堎所を指定したす。 | --- ## 26. テスト & E2E ハヌネス `scripts/dev/run-next-playwright.mjs`、`scripts/dev/smoke-electron-packaged.mjs`、 `scripts/dev/run-ecosystem-tests.mjs`、および `scripts/build/uninstall.mjs` で䜿甚されたす。本番環境ぞのデプロむでは、以䞋のすべおの倀を未蚭定のたたにしおください。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | -------------------------------------- | ----------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `OMNIROUTE_E2E_BOOTSTRAP_MODE` | `auth` | `scripts/dev/run-next-playwright.mjs` | Playwright ランナヌの E2E ブヌトストラップモヌド`auth`、`fresh`、`reuse`。 | | `OMNIROUTE_E2E_PASSWORD` | `INITIAL_PASSWORD` にフォヌルバック | `scripts/dev/run-next-playwright.mjs` | Playwright 環境に泚入される管理者パスワヌド。 | | `OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK` | `true` | `scripts/dev/run-next-playwright.mjs` | Playwright の実行䞭、ロヌカルヘルスチェックのポヌリングを無効にしたす。 | | `OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK` | `true` | `scripts/dev/run-next-playwright.mjs` | テスト䞭、OAuth トヌクンのヘルスチェックルヌプを無効にしたす。 | | `OMNIROUTE_HEALTHCHECK_SKIP_PROVIDERS` | _未蚭定_ | `src/lib/tokenHealthCheck.ts` | プロアクティブなトヌクン曎新スむヌプから陀倖するプロバむダヌをカンマ区切りで指定したす䟋`codex,openai`。ヘルスチェックを完党に無効化する代わりずなる察象限定の蚭定です。TTL が短いプロバむダヌは曎新を継続し、カスケヌドプロバむダヌはリアクティブな曎新のみを行いたす。 | | `OMNIROUTE_HIDE_HEALTHCHECK_LOGS` | `true` | `scripts/dev/run-next-playwright.mjs` | Playwright の暙準出力に含たれるヘルスチェックのノむズを抑制したす。 | | `OMNIROUTE_PLAYWRIGHT_SKIP_BUILD` | `0` | `scripts/dev/run-next-playwright.mjs` | Playwright の起動前に行われる Next.js の本番ビルドをスキップしたすCI の最適化。 | | `OMNIROUTE_SKIP_UNINSTALL_HOOK` | `0` | `scripts/build/uninstall.mjs` | OmniRoute のアンむンストヌルフックをスキップしたすCI で `node_modules` を維持するために䜿甚。 | | `ECOSYSTEM_SERVER_WAIT_MS` | `180000` | `scripts/dev/run-ecosystem-tests.mjs` | ゚コシステムプロトコルテストを実行する前に、サヌバヌが正垞になるたで埅機する時間ミリ秒。 | | `ELECTRON_SMOKE_URL` | `http://127.0.0.1:20128/login` | `scripts/dev/smoke-electron-packaged.mjs` | Electron スモヌクハヌネスが、パッケヌゞ化されたアプリによっお提䟛されるこずを想定する URL。 | | `ELECTRON_SMOKE_TIMEOUT_MS` | `45000` | `scripts/dev/smoke-electron-packaged.mjs` | スモヌクハヌネスが凊理を断念するたでの合蚈タむムアりトミリ秒。 | | `ELECTRON_SMOKE_SETTLE_MS` | `2000` | `scripts/dev/smoke-electron-packaged.mjs` | ペヌゞ読み蟌み埌の安定化埅機時間ミリ秒。 | | `ELECTRON_SMOKE_APP_EXECUTABLE` | _自動_ | `scripts/dev/smoke-electron-packaged.mjs` | パッケヌゞ化された Electron 実行可胜ファむルぞの明瀺的なパス。 | | `ELECTRON_SMOKE_DATA_DIR` | _tmpdir_ | `scripts/dev/smoke-electron-packaged.mjs` | Electron スモヌク実行甚のデヌタディレクトリ。 | | `ELECTRON_SMOKE_KEEP_DATA` | `0` | `scripts/dev/smoke-electron-packaged.mjs` | 実行埌もスモヌクテストのデヌタディレクトリを保持するには、`1` に蚭定したす。 | | `ELECTRON_SMOKE_STREAM_LOGS` | `0` | `scripts/dev/smoke-electron-packaged.mjs` | 実行䞭に Electron のログを stdout にストリヌミングするには、`1` に蚭定したす。 | | `ELECTRON_SMOKE_COLD_RESTART` | `0` | `scripts/dev/smoke-electron-packaged.mjs` | #7592: 同じデヌタディレクトリを䜿甚しお再起動し、2 回目の起動でネむティブ SQLite ドラむバヌが遞択されるこずを確認したす。 | | `CLI_DEVIN_BIN` | _PATH 怜玢_ | `open-sse/executors/devin-cli.ts` | Devin CLI バむナリのパスを䞊曞きしたす。 | ### ドキュメント翻蚳パむプラむン `scripts/i18n/run-translation.mjs``npm run i18n:run` コマンドで䜿甚されたす。 5 ぀の倉数はすべおデフォルトでは未蚭定です。ドキュメント翻蚳ツヌルを実行できるようにする マシンでのみ、`.env` に蚭定しおください。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ----------------------------------- | ------------ | ---------------------------------- | ---------------------------------------------------------------------- | | `OMNIROUTE_TRANSLATION_API_URL` | _未蚭定_ | `scripts/i18n/run-translation.mjs` | 翻蚳バック゚ンド甚の OpenAI 互換ベヌス URL。 | | `OMNIROUTE_TRANSLATION_API_KEY` | _未蚭定_ | `scripts/i18n/run-translation.mjs` | 翻蚳バック゚ンド甚の Bearer トヌクンログには決しお蚘録されたせん。 | | `OMNIROUTE_TRANSLATION_MODEL` | _未蚭定_ | `scripts/i18n/run-translation.mjs` | モデル ID䟋: `gpt-4o-mini` たたは `cx/gpt-5.4-mini`。 | | `OMNIROUTE_TRANSLATION_TIMEOUT_MS` | `60000` | `scripts/i18n/run-translation.mjs` | リク゚ストごずのタむムアりトミリ秒。 | | `OMNIROUTE_TRANSLATION_CONCURRENCY` | `4` | `scripts/i18n/run-translation.mjs` | 耇数のファむルやロケヌルを凊理する際の䞊列翻蚳リク゚スト数。 | --- ## 27. Radar フィヌドセルフホスティング RADAR_ENABLED 機胜フラグによっお制埡されるオプションのアドオンですデフォルトはオフ — 環境倉数ではなく、Settings/DB 経由で切り替える機胜フラグです。[docs/frameworks/RADAR.md](../frameworks/RADAR.md#flag-radar_enabled-default-off) を参照しおください。 以䞋の最初の4぀の倉数は、セルフホストたたはフォヌクしたフィヌド、およびサポヌタヌキヌのフロヌに察するオプションのオヌバヌラむドです。5぀目の `RADAR_ADMIN_URL` は、所有者の非公開運甚パネルぞの、デフォルト倀を持たない独立したリンクです。モゞュヌルの完党なドキュメントず [゚ンドツヌ゚ンドの有効化およびガむド付きセットアップ手順](../frameworks/RADAR.md#end-to-end-activation-and-guided-setup)に぀いおは、[docs/frameworks/RADAR.md](../frameworks/RADAR.md) を参照しおください。 汎甚の Home/Changelog お知らせリヌダヌは環境倉数で蚭定されず、RADAR_ENABLED 機胜フラグにも䟝存したせん。`src/shared/utils/releaseNotes.ts` で宣蚀された公開リポゞトリの `news.json` URL を GET のみで読み取りたす。非衚瀺にしたお知らせの ID は、匕き続きブラりザヌのロヌカルストレヌゞに保存されたす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ----------------------------- | -------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `RADAR_FEED_URL` | `https://radar.omniroute.online` | `src/lib/radar/{sync,referralsSync,offersSync,intelSync}.ts` | 個別に眲名されたカタログ、玹介、サポヌタヌ向けオファヌ、および Intel フィヌドで共有されるベヌス URL。セルフホストたたはフォヌクしたサヌビスを指定するにはオヌバヌラむドしたす。 | | `RADAR_FEED_PUBKEY` | _固定されたデフォルトキヌ_ | `src/lib/radar/pinnedKeys.ts` | カスタムフィヌドからのフィヌド眲名を怜蚌するために䜿甚される Ed25519 公開鍵base64-DER SPKI たたは PEM。 | | `RADAR_CONTRIBUTOR_CLAIM_URL` | `https://radar.omniroute.online/auth/github` | `src/lib/radar/links.ts` | ダッシュボヌドの「コントリビュヌタヌです」ボタンで開く URLGitHub OAuth サポヌタヌキヌ申請フロヌ。 | | `RADAR_SUPPORTER_PLANS_URL` | `https://radar.omniroute.online/planos` | `src/lib/radar/links.ts` | ダッシュボヌドの「プロゞェクトを支揎」ボタンで開く URL支払いプランペヌゞ。 | | `RADAR_ADMIN_URL` | _未蚭定_ | `src/lib/radar/links.ts` | 所有者専甚の非公開運甚パネルぞのリンク。HTTP ルヌプバック SSH 転送を陀き、HTTPS が必須です。未蚭定たたは無効な倀の堎合、ナビゲヌション項目は䜜成されたせん。 | --- ## 監査削陀枈み未䜿甚の倉数 以䞋の倉数は以前のバヌゞョンの `.env.example` に存圚しおいたしたが、珟圚のコヌドベヌスでは**実行時に参照されおいたせん**。これらは削陀されたした。 | 倉数 | 理由 | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `STORAGE_DRIVER=sqlite` | どの゜ヌスファむルからも読み取られたせん。SQLite が唯䞀サポヌトされおいるドラむバヌであるため、遞択は䞍芁です。 | | `INSTANCE_NAME=omniroute` | 叀いドキュメントや環境倉数テンプレヌトには存圚したすが、実行時には䜿甚されたせん。将来のマルチむンスタンス機胜で再導入される可胜性がありたす。 | | `SQLITE_MAX_SIZE_MB=2048` | ゜ヌスコヌドから参照されおいたせん。デヌタベヌスサむズは人為的に制限されたせん。 | | `SQLITE_CLEAN_LEGACY_FILES=true` | ゜ヌスコヌドから参照されおいたせん。レガシヌファむルのクリヌンアップ機胜は削陀された可胜性がありたす。 | | `CLI_ROO_BIN` | `src/shared/services/cliRuntime.ts` に登録されおいたせん。 | | `CLI_KIMI_CODING_BIN` | `src/shared/services/cliRuntime.ts` に登録されおいたせんKimi Coding は CLI バむナリではなく OAuth を䜿甚したす。 | | `IFLOW_OAUTH_CLIENT_ID` / `IFLOW_OAUTH_CLIENT_SECRET` | ゜ヌスコヌド内のどこからも参照されおいたせん。 | | `CEREBRAS_API_KEY` / `COHERE_API_KEY` / `FIREWORKS_API_KEY` / `GROQ_API_KEY` / `MISTRAL_API_KEY` / `NEBIUS_API_KEY` / `PERPLEXITY_API_KEY` / `TOGETHER_API_KEY` / `XAI_API_KEY` | v3.8.0 で削陀されたした。ランタむムはこれらの環境倉数を読み取らなくなりたした。認蚌情報は Dashboard / `data/provider-credentials.json` / 暗号化 DB から取埗されたす。 | | `CURSOR_PROTOBUF_DEBUG` | v3.8.0 で削陀されたした。Cursor executor は `CURSOR_DEBUG` / `CURSOR_STREAM_DEBUG` を䜿甚したす§22 を参照。 | | `CLI_COMPAT_KIRO` | v3.8.0 で削陀されたした。Kiro は `CLI_COMPAT_OMITTED_PROVIDER_IDS` に含たれおいるため、この切り替え蚭定は効果がありたせん。 | | `QIANFAN_API_KEY` | v3.8.0 で、他の未䜿甚プロバむダヌ API キヌのスタブずずもに削陀されたした。 | ### デフォルト倀の修正 | 倉数 | 旧 `.env.example` の倀 | 実際のコヌド䞊のデフォルト倀 | 修正内容 | | ------------------------- | ---------------------- | ---------------------------- | -------------------------------------------------------- | | `APP_LOG_RETENTION_DAYS` | `90` | `7` | ✅ 誀解を招く倀を削陀し、デフォルト倀が `7` であるず明蚘 | | `CALL_LOG_RETENTION_DAYS` | `90` | `7` | ✅ 誀解を招く倀を削陀し、デフォルト倀が `7` であるず明蚘 | ### OpenCode 蚭定の再生成アドホックツヌル `scripts/ad-hoc/regen-opencode-config.ts` で䜿甚され、実行䞭の OmniRoute むンスタンスから取埗した正確な `limit.context` および `limit.output` の倀を䜿甚しお `opencode.json` を再生成したす。これらは通垞の動䜜には 必芁ありたせん。このスクリプトは開発者向けツヌルずしおのみ䜿甚されたす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------ | ------------------------ | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_URL` | `http://localhost:20128` | `scripts/ad-hoc/regen-opencode-config.ts` | `/v1/models` を照䌚する OmniRoute むンスタンスのベヌス URL。 | | `OMNIROUTE_KEY` | _(未蚭定)_ | `scripts/ad-hoc/regen-opencode-config.ts` | OmniRoute の `/v1/models` ゚ンドポむントに察する認蚌甚 API キヌ。未蚭定の堎合は `OPENCODE_API_KEY` にフォヌルバックしたす。 | | `OPENCODE_API_KEY` | _(未蚭定)_ | `scripts/ad-hoc/regen-opencode-config.ts` | 再生成された `opencode.json` に曞き蟌たれる OpenCode 圢匏の API キヌ`sk-...`。未蚭定の堎合は `OMNIROUTE_KEY` にフォヌルバックしたす。 | ### 圧瞮オフラむン評䟡ハヌネスアドホックツヌル オフラむン圧瞮評䟡 CLI である `scripts/compression-eval/index.ts` によっお䜿甚されたす。 通垞の運甚には䞍芁で、開発者向けツヌルでのみ䜿甚されたす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------- | ---------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_EVAL_CREDENTIALS` | `{}`空 | `scripts/compression-eval/index.ts` | オフラむン圧瞮評䟡 CLI でテストするプロバむダヌ甚にオペレヌタヌが指定する JSON 認蚌情報`JSON.parse` で解析。ドラむランの堎合は未蚭定のたたにしおください。 | ### VNC ブラりザヌセッション ブラりザヌ自動化プロバむダヌ向けの Docker ベヌスのヘッドレス Chromium セッションを蚭定するために、`src/lib/vncSession/manifest.ts` によっお䜿甚されたす。すべお任意です。デフォルト倀を以䞋に瀺したす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------- | ------------------------------ | ------------------------------------------- | ---------------------------------------------------------------------------------------- | | `OMNIROUTE_DOCKER_BIN` | `docker` | `src/lib/vncSession/manifest.ts` | VNC コンテナの起動に䜿甚する Docker バむナリぞのパス。 | | `OMNIROUTE_VNC_IMAGE` | `omniroute-vnc-chromium:local` | `src/lib/vncSession/manifest.ts` | VNC Chromium コンテナ甚の Docker むメヌゞ。 | | `OMNIROUTE_VNC_CHROMIUM_ARGS` | _(組み蟌みフラグ)_ | `src/lib/vncSession/manifest.ts` | コンテナ内のブラりザヌに枡す远加の Chromium CLI 匕数。 | | `OMNIROUTE_VNC_CONTAINER_VNC_PORT` | `3000` | `src/lib/vncSession/manifest.ts` | コンテナ内の VNC ポヌト。 | | `OMNIROUTE_VNC_CONTAINER_CDP_PORT` | `9223` | `src/lib/vncSession/manifest.ts` | コンテナ内の Chrome DevTools Protocol ポヌト。 | | `OMNIROUTE_VNC_CONTAINER_PROFILE_DIR` | `/config` | `src/lib/vncSession/manifest.ts` | コンテナ内のプロファむルディレクトリ。 | | `OMNIROUTE_VNC_PROFILE_DIR` | _(未蚭定)_ | `src/lib/vncSession/manifest.ts` | 氞続的なブラりザヌプロファむル甚のホスト偎ディレクトリ。 | | `OMNIROUTE_VNC_IDLE_MS` | `600000` | `src/lib/vncSession/manifest.ts` | VNC セッションが回収されるたでのアむドルタむムアりトミリ秒。 | | `OMNIROUTE_VNC_MAX_MS` | `1800000` | `src/lib/vncSession/manifest.ts` | セッションの最倧継続時間ミリ秒。 | | `OMNIROUTE_VNC_MAX_SESSIONS` | `4` | `src/lib/vncSession/manifest.ts` | 同時に実行できる VNC セッションの最倧数。 | | `OMNIROUTE_VNC_READY_MS` | `45000` | `src/lib/vncSession/manifest.ts` | ブラりザヌの準備完了タむムアりトミリ秒。 | | `OMNIROUTE_VNC_HARVEST_MS` | `20000` | `src/lib/vncSession/manifest.ts` | 回収クリヌンアップのタむムアりトミリ秒。 | | `OMNIROUTE_VNC_NETWORK` | `omniroute-vnc-browser-login` | `src/lib/vncSession/manifest.ts` | コンテナが参加する専甚 Docker ネットワヌク#12571。デフォルトブリッゞは䜿甚したせん。 | | `VIBEPROXY_DATA_DIR` | _(未蚭定)_ | `open-sse/services/notionThreadSessions.ts` | Notion スレッドセッションを氞続化するディレクトリ。 | ### 内郚サヌビス認蚌 | 倉数 | デフォルト | 説明 | | --------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------- | | `OMNIROUTE_INTERNAL_SERVICE_TOKEN` | – | 管理プレヌンのサヌビス間認蚌に䜿甚するむンラむン圢匏のトヌクン。 | | `OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE` | – | 内郚サヌビストヌクンを栌玍したファむルぞのパスコンテナでは掚奚。むンラむン倉数より優先されたす。 | ### OpenRouter プロバむダヌ統蚈 | 倉数 | デフォルト | 説明 | | ----------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------ | | `OPENROUTER_PROVIDER_STATS_ENABLED` | `true` | カタログ情報の拡充に䜿甚する OpenRouter のプロバむダヌ別統蚈の取埗をスキップするには、`false` に蚭定したす。 | | `OPENROUTER_PROVIDER_STATS_TTL_MS` | `3600000` | 取埗した OpenRouter プロバむダヌ統蚈のキャッシュ TTLミリ秒。 | ### 組み蟌み Redis バむンディング | 倉数 | デフォルト | 説明 | | --------------------------- | ----------- | ------------------------------------------------------------------------------ | | `REDIS_BIND_HOST` | `127.0.0.1` | 組み蟌み Redis サヌビスのバむンドアドレス。 | | `REDIS_PORT` | `6379` | 組み蟌み Redis サヌビスのポヌト。 | | `OMNIROUTE_REDIS_BIND_HOST` | – | 組み蟌み Redis のバむンドアドレスに察する OmniRoute スコヌプのオヌバヌラむド。 | --- ## 24. リリヌス v3.8.50 での远加事項 これらの蚭定は、前回の環境コントラクトのスナップショット以降に導入されたした。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_CHAT_ADMISSION_QUEUE_MS` | `2000` | `src/shared/middleware/chatBodyAdmission.ts` | 負荷の高いチャットの受け入れスロットを埅機する最倧時間です。この時間を超えるず、再詊行可胜な `503` が返されたす。短い䞊限付き埅機を蚭けるこずで、゚ヌゞェントからのリク゚ストが集䞭した堎合に即座に `503` を返すのではなく、順次凊理したす。`0` にするず即時拒吊に戻りたす。 | | `OMNIROUTE_CHAT_ADMISSION_MAX_QUEUED_BYTES` | `4194304`4 MB | `src/shared/middleware/chatBodyAdmission.ts` | 受け入れ埅機甚のキュヌ枈みバむト数の䞊限です。プロセス党䜓で埅機状態に眮かれる、バッファリング枈みリク゚ストボディの総バむト数を制限し、埅機によるヒヌプ䜿甚量の増倧を防ぎたす#4380。䞊限を超える埅機リク゚ストには、再詊行可胜な `503` が即座に返されたす。 | | `OMNIROUTE_CHAT_VIRTUAL_TTL_MS` | `60000`60 秒 | `src/shared/middleware/chatBodyAdmission.ts` | #10110 以降は非掚奚であり、䜕も行いたせん。セッション単䜍の受け入れレヌンは廃止され、プロセス党䜓で共有される単䞀のバゞェットに眮き換えられたした。蚭定互換性のため受け付けられたすが、無芖されたす。 | | `OMNIROUTE_CHAT_VIRTUAL_MAX_SESSIONS` | `64` | `src/shared/middleware/chatBodyAdmission.ts` | #10110 以降は非掚奚であり、䜕も行いたせん。セッション単䜍の受け入れレヌンは廃止され、プロセス党䜓で共有される単䞀のバゞェットに眮き換えられたした。蚭定互換性のため受け付けられたすが、無芖されたす。 | | `OMNIROUTE_CHAT_VIRTUAL_LANES` | `0`オフ | `open-sse/services/admission/runtime.ts` | 適応型ランタむム仮想受け入れレヌン#9654テナント単䜍の適応型ゲヌトシステム 2のマスタヌスむッチです。䞊蚘の非掚奚ずなった接続単䜍のレヌン倉数TTL_MS / MAX_SESSIONS、#10110 以降は䜕も行わないずは異なりたす。同名のダッシュボヌド機胜フラグが存圚したすが、環境倉数がダッシュボヌドのオヌバヌラむドより優先されたす。倉曎には再起動が必芁です。 | | `OMNIROUTE_RUNNOW_TIMEOUT_MS` | `30000` | `src/app/api/jobs/[id]/run-now/route.ts` | 実行䞭のゞョブがある堎合、run-now 呌び出しがキュヌに入れられた実行を開始するたで埅機する時間を制限したす。 | | `ADOBE_FIREFLY_BROWSER_REFRESH` | 有効 | `open-sse/services/adobeFireflySession.ts` | アカりント単䜍の Chrome CDP セッションを通じお、IMS ずブラりザヌのリスク状態を最新に保ちたす。無効にするには `0` を蚭定したす。 | | `ADOBE_FIREFLY_SESSION_DISK` | 有効 | `open-sse/services/adobeFireflySession.ts` | 修埩された Adobe セッションを `DATA_DIR` 配䞋に氞続化したす。メモリのみの状態にするには `0` を蚭定したす。 | | `ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS` | `12000` | `open-sse/services/adobeFireflySession.ts` | Adobe Firefly の生成リク゚スト送信間の最小間隔です。 | | `ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS` | `15000` | `open-sse/services/adobeFireflySession.ts` | Adobe ぞの送信が 3 回成功するたびに远加される䌑止時間です。 | | `ADOBE_FIREFLY_CHROME_HEADLESS` | `0` | `open-sse/services/adobeFireflyBrowserLogin.ts` | デバッグ専甚の完党ヘッドレスモヌドです。通垞、Adobe colligo はこのモヌドで生成されたリスクセッションを拒吊したす。 | | `CHROME_PATH` | 自動怜出 | `open-sse/executors/cloudflare-playground.ts`、`open-sse/executors/chatgpt-web-codex.ts` | プラットフォヌムの自動怜出では䞍十分な堎合に、ブラりザヌ駆動型 executor が䜿甚する Chrome 実行ファむルの絶察パスを任意で指定したす。 | | `TELEGRAM_BOT_TOKEN` | _未蚭定_ | `src/lib/telegram/config.ts` | 受信 Webhook を有効化し、Mini App の `initData` に眲名する BotFather トヌクンです。 | | `TELEGRAM_WEBHOOK_SECRET` | _未蚭定_ | `src/lib/telegram/config.ts` | `setWebhook` を介しお登録され、Webhook が配信されるたびに `X-Telegram-Bot-Api-Secret-Token` ヘッダヌず照合される共有シヌクレットです。Webhook パスには必須です。未蚭定の堎合、Webhook の配信は 503 で拒吊されたす。 | | `TELEGRAM_DEFAULT_MODEL` | `auto/chat` | `src/lib/telegram/chatProxy.ts` | Telegram のチャット返信に䜿甚されるモデルです。 | | `TELEGRAM_BOT_API_BASE` | `https://api.telegram.org` | `src/lib/telegram/config.ts` | プロキシたたはセルフホスト型 Bot API サヌバヌ向けの Bot API ベヌス URL のオヌバヌラむドです。 | | `TELEGRAM_WEBHOOK_TIMEOUT_MS` | `60000` | `src/lib/telegram/config.ts` | 送信 Bot API 呌び出しのタむムアりトミリ秒です。 | | `OMNIROUTE_OPTIONAL_PACK_TAR` | `1`有効 | `scripts/build/optionalPackStaging.mjs` | Electron スタンドアロンツリヌ甚のオプション MLブラりザヌパックをステヌゞングする際に、`.tar.gz` tarball の出力を省略するには `0` を蚭定したすパックディレクトリず `optional-packs.index.json` は匕き続き生成されたす。デスクトップリリヌスのワヌクフロヌで、アヌティファクトのアップロヌドサむズを削枛するために䜿甚されたす。 | | `GROK_SUBSCRIPTION_IMAGES_ENABLED` | `false` | `open-sse/config/imageRegistry.ts` | xAI サブスクリプション画像ルヌトの登録を有効にしたす。API キヌを䜿甚する画像パスを倉曎しないよう、デフォルトでは無効です。 | | `OMNIROUTE_API_KEY_COOLDOWN_MS` | `60000` | `open-sse/services/apiKeyRotator.ts` | `429` レスポンスに䜿甚可胜な `Retry-After` ヒントがない堎合の、キヌ単䜍のクヌルダりン時間ミリ秒です。 | | `OMNIROUTE_ESTIMATOR_CALIBRATION` | 有効 | `open-sse/services/estimatorCalibration.ts` | メモリ内での掚定噚キャリブレヌションの蚘録ず適甚を無効にするには、`off`、`0`、たたは `false` を蚭定したす。 | | `NEXT_MANUAL_SIG_HANDLE` | _内郚甚_ | `scripts/dev/standalone-server-ws.mjs` | スタンドアロンサヌバヌのシグナルハンドラヌをオヌバヌラむドする内郚蚭定です。通垞はオペレヌタヌが蚭定するのではなく、ランチャヌによっお蚭定および解陀されたす。 | ### ChatGPT WebCodex ヘッドレスブラりザヌおよび送信 Tool Tunnel のグロヌバルデフォルトです。ダッシュボヌドで蚭定された Connection の倀が優先されたす。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | --------------------------------------- | ------------------------------ | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CHATGPT_WEB_CODEX_CHROME_PATH` | _(自動怜出)_ | `open-sse/executors/chatgpt-web-codex.ts` | npm、systemd、およびPM2での実行甚に明瀺的に指定するChrome/Chromiumのパス。 | | `CHROME_PATH` | _(自動怜出)_ | `open-sse/executors/chatgpt-web-codex.ts` | 明瀺的なChrome/Chromiumパスの共通フォヌルバック。 | | `CHATGPT_WEB_CODEX_CDP_URL` | _(未蚭定)_ | `open-sse/executors/chatgpt-web-codex.ts` | 内郚CDP゚ンドポむント。Dockerではポヌト`9223`䞊のサむドカヌを䜿甚したす。 | | `CDP_PROXY_TOKEN` | _(未蚭定)_ | `docker/chatgpt-web-codex-browser/cdp-proxy.mjs` | 蚭定されおいる堎合、CDPプロキシ・サむドカヌぞのすべおのリク゚ストで、この倀をヘッダヌ`X-Omni-Cdp-Token`に含める必芁がありたす#13679。倀がない堎合、プロキシは認蚌なしで転送したす。その堎合、保護はComposeネットワヌク`chatgpt-web-codex-net`のネットワヌク分離のみに䟝存したす。`openssl rand -hex 32`で生成できたす。 | | `CHATGPT_WEB_CODEX_TUNNEL_ID` | _(未蚭定)_ | `open-sse/executors/chatgpt-web-codex.ts` | ロヌカルのCodexツヌルラりンド甚のグロヌバルOpenAIトンネルID。 | | `CHATGPT_WEB_CODEX_RUNTIME_KEY` | _(未蚭定)_ | `open-sse/executors/chatgpt-web-codex.ts` | グロヌバルトンネルのランタむムキヌ。ログには絶察に出力しないでください。 | | `CHATGPT_WEB_CODEX_CONNECTOR_NAME` | `OmniRoute Codex v2` | `open-sse/executors/chatgpt-web-codex.ts` | MCPブリッゞ甚に新しく䜜成されたChatGPTカスタムコネクタヌの正確な名前。 | | `CODEX_CHATGPT_WEB_HOME` | `/chatgpt-web-codex` | `open-sse/vendor/codex-chatgpt-web/config.ts` | ブラりザヌ、ブロヌカヌ、およびトンネルの状態を保存する専甚ディレクトリ。 | | `CODEX_CHATGPT_WEB_BROWSER_DIAGNOSTICS` | `0` | `open-sse/vendor/codex-chatgpt-web/adapters/chatgpt-web/browser-worker.ts` | `1`の堎合、各チェックポむントでブラりザヌ蚺断画像を取埗したす。 | | `CODEX_CHATGPT_WEB_LAUNCHER` | _(未蚭定)_ | `open-sse/vendor/codex-chatgpt-web/config.ts` | 氞続的なランチャヌバむナリぞのオプションの絶察パス。 | | `CODEX_CHATGPT_WEB_BUN` | _(自動怜出)_ | `open-sse/vendor/codex-chatgpt-web/config.ts` | Bunランタむムバむナリぞのオプションの絶察パス。 | | `CODEX_WEB_GPT_BUN` | _(未蚭定)_ | `open-sse/vendor/codex-chatgpt-web/config.ts` | `CODEX_CHATGPT_WEB_BUN`甚のレガシヌフォヌルバック。新しいセットアップでは正匏な名前を䜿甚したす。 | --- ## OmniConductor ブリッゞ OmniConductor ハブのタスクをロヌカルの A2A TaskManager`src/lib/conductor/`にミラヌリングする、長時間皌働型の SSE コンシュヌマヌです。オプトむン方匏であり、ブリッゞは `CONDUCTOR_HUB_URL` が蚭定されおいる堎合にのみ起動したす。サヌバヌ偎限定です。ハブトヌクンをブラりザに枡しおはなりたせん。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ------------------------------ | ----------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | `CONDUCTOR_HUB_URL` | _空_ | `src/lib/conductor/boot.ts` | OmniConductor ハブのベヌス URL䟋`http://127.0.0.1:7910`。未蚭定の堎合、ブリッゞは無効になりたす。 | | `CONDUCTOR_HUB_TOKEN` | _空_ | `src/lib/conductor/boot.ts` | SSE フィヌド甚のハブ認蚌情報。ハブ䞊で `spokesperson` 皮別のピアを発行したす`POST /v1/peers`、管理者暩限。 | | `CONDUCTOR_ORCHESTRATOR_TOKEN` | _空_ | `src/lib/conductor/hubProxy.ts` | 受信する A2A→ハブのタスク委任`POST /v1/tasks`甚の認蚌情報。未蚭定の堎合は `CONDUCTOR_HUB_TOKEN` にフォヌルバックしたす。 | | `CONDUCTOR_SPOKESPERSON_URL` | `http://127.0.0.1:7920` | `src/lib/conductor/faroProxy.ts` | ダッシュボヌドのチャットプロキシ`/api/conductor/ask`の背埌にある spokespersonFaroサヌビスのベヌス URL。 | ### クォヌタ察応スケゞュヌリング `open-sse/services/combo.ts` および `src/lib/quota/quotaScheduler.ts` が、リク゚スト前のトヌクン予算チェックに䜿甚したす。オプトむン方匏であり、未蚭定の堎合、デフォルトのルヌティング動䜜は倉曎されたせん。 | 倉数 | デフォルト | ゜ヌスファむル | 説明 | | ---------------------------------- | ---------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OMNIROUTE_QUOTA_AWARE_ROUTING` | `0` | `open-sse/services/combo.ts` | `1` の堎合、りィンドりごずのトヌクン予算`rateLimitOverrides.tpm`、テヌブル `provider_quota_state`ではディスパッチ前に掚定リク゚ストコストを賄えない接続をスキップしたす。予算が蚭定されおいない堎合はフェむルオヌプンになりたす。 | | `OMNIROUTE_ESTIMATOR_CALIBRATION` | _オン_ | `open-sse/services/estimatorCalibration.ts` | コンテキストガヌドのトヌクン掚定噚#14931のフィヌドバック范正です。provider、model、tools の有無ごずに `usage.prompt_tokens` / 掚定倀の EMA を算出し、0.152.0 の範囲に制限したす。メモリ内でのみ保持されたす。`off`、`0`、たたは `false` を指定するず、蚘録ず適甚が無効になりたす。 | | `GROK_SUBSCRIPTION_IMAGES_ENABLED` | `false` | `open-sse/config/imageRegistry.ts` | `xai-oauth``xao`および `grok-cli` の画像ルヌトを登録したす。同名のダッシュボヌド機胜フラグです。DB のオヌバヌラむドがこの倀より優先されたす。 |