Files
OmniRoute/docs/i18n/lv/docs/reference/ENVIRONMENT.md
Diego Rodrigues de Sa e Souza 8feea123bb feat(docs): mirror every docs/ page in all 65 locales (#14106)
* feat(docs): mirror every docs/ page in all 65 locales

Extends the documentation mirrors from the 22-page core set (#13940) to
every Markdown page under docs/: 152 sources x 65 locales = 9,880 mirrors
(6,208 new), language bars rewritten for the full locale list, state
adopted so the blocking drift gate now covers all 152 pages.

run-translation.mjs: an oversized block made only of table rows or list
items (PROVIDER_REFERENCE.md 244-row table, FREE_TIERS.md 71-item list) is
cut at item boundaries and rejoined without a blank line — the single
16-40 KB request outlived the backend socket for verbose scripts. 48
older mirrors whose tables had lost rows were retranslated with --force.

* docs(i18n): refresh mirrors for the sources the base changed since the branch cut

Section-level retranslation of the 29 docs (and README.md) whose source
or mirrors moved on release/v3.8.51 during the run, then state adoption;
the drift gate is green again on the merged tree.
2026-09-18 13:16:46 -03:00

635 KiB
Raw Blame History

Environment Variables Reference (Latviešu)

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


Pilnīga atsauce uz visiem OmniRoute atpazītajiem vides mainīgajiem. Ātrās sākšanas veidni skatiet failā .env.example.

Important

Katram šeit dokumentētajam mainīgajam jābūt norādītam arī failā .env.example, un katram failā .env.example norādītajam mainīgajam jābūt dokumentētam šeit. npm run check:env-doc-sync to pārbauda komita izveides laikā un CI vidē. Lai apzināti izlaistu kādu mainīgo, pievienojiet to atļauto vienumu sarakstam failā scripts/check/check-env-doc-sync.mjs.


Satura rādītājs


1. Obligātie noslēpumi

Tie obligāti jāiestata pirms pirmās palaišanas. Bez tiem lietojumprogramma vai nu atteiksies startēt, vai darbosies ar nedrošām noklusējuma vērtībām.

Mainīgais Obligāts Noklusējums Avota fails Apraksts
JWT_SECRET (nav) src/lib/auth Paraksta/pārbauda visus informācijas paneļa sesijas sīkfailus (JWT). Ģenerējiet ar openssl rand -base64 48.
API_KEY_SECRET (nav) src/lib/db/apiKeys.ts AES šifrēšanas atslēga API atslēgu vērtību šifrēšanai SQLite datubāzē. Ģenerējiet ar openssl rand -hex 32.
INITIAL_PASSWORD CHANGEME Sākotnējās iestatīšanas skripts Iestata sākotnējo administratora informācijas paneļa paroli (atbilst .env.example noklusējumam — tā ir apzināti nedroša, lai piespiestu to nomainīt). Nomainiet pirms pirmās lietošanas reizes. Pēc pieteikšanās nomainiet to sadaļā Informācijas panelis → Iestatījumi → Drošība.
OMNIROUTE_WS_BRIDGE_SECRET (produkcijā) (nav iestatīts) src/app/api/internal/codex-responses-ws/route.ts Koplietojams noslēpums iekšējam Codex Responses WebSocket tiltam. Autentificē tilta pieprasījumus starp Electron/pārlūkprogrammas WS retranslētāju un OmniRoute. ⚠️ OBLIGĀTS produkcijā — ja tas nav iestatīts, visi WS tilta pieprasījumi tiek noraidīti. Ģenerējiet ar openssl rand -base64 32.
OMNIROUTE_SW_BUILD_ID (git SHA) next.config.mjs, scripts/build/assembleStandalone.mjs Nepārprotams servisa darbinieka kešatmiņas apiešanas identifikators PWA čaulai (#11779); pirmais noteikšanas ķēdē.
SOURCE_VERSION (nav iestatīts) next.config.mjs, scripts/build/assembleStandalone.mjs Otrais ķēdē — to izvietošanas būvējuma kompilētāji (piemēram, Heroku tipa) iestata uz izvietotā komita vērtību.
NEXT_PUBLIC_SW_BUILD_ID (atvasināts) src/shared/components/PwaRegister.tsx Būvēšanas laikā noteikta publiska vērtība, ko klients izmanto, lai reģistrētu /sw.js?v=…; tā tiek atvasināta no abām iepriekš minētajām vērtībām un pēc tam no git SHA.
OMNIROUTE_PEER_STAMP_TOKEN Nē (automātiski) (automātiski katrā palaišanas reizē) src/server/authz/policies/management.ts Katra procesa noslēpums, kas apliecina, ka uzticamais vienādranga IP zīmogs ir saņemts no paša OmniRoute HTTP servera (scripts/dev/peer-stamp.mjs). Autorizācijas starpprogrammatūra uzticas pieprasījuma lokālumam (LOCAL_ONLY maršrutu ierobežošana līdz atgriezeniskās cilpas/LAN savienojumiem) tikai tad, ja zīmogs ietver šo pilnvaru. Tas tiek automātiski ģenerēts katrā palaišanas reizē — atstājiet neiestatītu; fiksējiet to tikai vairāku procesu konfigurācijās, kurām zīmogs ir jākoplieto.

Ģenerēšanas komandas

# Ģenerējiet visus četrus noslēpumus vienlaikus:
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

Nekad neiekļaujiet .env failus ar īstiem noslēpumiem versiju kontroles sistēmā. .gitignore jau izslēdz .env, taču pirms izmaiņu nosūtīšanas to pārbaudiet.


2. Krātuve un datubāze

OmniRoute visai pastāvīgajai datu glabāšanai izmanto SQLite (ar better-sqlite3). Šie mainīgie nosaka datu atrašanās vietu, šifrēšanu un dzīves ciklu.

Mainīgais Noklusējums Avota fails Apraksts
DATA_DIR ~/.omniroute/ src/lib/db/core.ts SQLite datubāzes, dublējumkopiju un datu failu saknes direktorijs. Norādiet citu vērtību Docker sējumiem vai pielāgotiem ceļiem.
OMNIROUTE_ALLOW_DEFAULT_DATA_DIR (nav iestatīts) src/lib/dataPaths.ts Īpaša atkāpšanās iespēja testu/izvērtēšanas DATA_DIR aizsargmehānismam (#10428). Testi un Node izvērtēšanas/izvades pārbaudes (-e/--eval/-p/--print, tostarp --eval=/--print= formas), kuriem nav norādīts DATA_DIR, tiek novirzīti uz vienreizlietojamu pagaidu direktoriju, lai tie nevarētu atvērt operatora īsto datubāzi; iestatiet uz 1, lai atkal izmantotu īsto direktoriju.
OMNIROUTE_BUILD_SHA (nav iestatīts) src/lib/monitoring/buildSha.ts Darbināmā artefakta Git SHA. To pievieno npm run build:release; to var ievadīt konteineros, kas tiek piegādāti bez dist/BUILD_SHA kontrolfaila. Tas tiek parādīts kā system.buildSha galapunktā /api/monitoring/health.
OMNIROUTE_RELEASE_REF origin/main scripts/build/buildProvenance.ts Atsauce, pret kuru artefakta pakošanas izcelsmes pārbaude pārbauda būvējuma SHA (#10427).
OMNIROUTE_ALLOW_CANARY_BUILD (nav iestatīts) scripts/build/buildProvenance.ts Iestatiet uz 1, lai atļautu pakot būvējumu, kura SHA neatrodas laidiena zarā, reģistrējot to kā apzinātu izmēģinājuma būvējumu, nevis pārtraucot pārbaudi ar kļūdu (#10427).
OMNIROUTE_SMOKE_API_KEY (nav iestatīts) scripts/ops/deploy-canary.mjs API atslēga izmēģinājuma izvietošanas ātrajai pārbaudei, kas uz /v1/chat/completions tiek nosūtīta kā Authorization: Bearer. To izmanto tikai izvietošanas skripts (#10429), bet nekad serveris. Tā nav saistīta ar izvēles CLI ātro pārbaužu ietvara OMNIROUTE_SMOKE_* mainīgajiem (RUN_CLI_SMOKE=1, OMNIROUTE_SMOKE_BASE_URL/MODEL/API_KEY_ENV/TARGETS/TIMEOUT_MS failā tests/integration/upstream-cli-smoke.int.test.ts) — skatiet CLI integrācijas → Reāla ātro pārbaužu izpilde.
OMNIROUTE_BUILDING (nav iestatīts) src/lib/buildPhase.ts Būvēšanas posma signāls (#10060): scripts/build/build-next-isolated.mjs to iestata uz 1, un to pārmanto katrs palaistais būvēšanas darbinieks, lai datubāzes slānis atgrieztu tukšas darbības aizstājēju, nevis ielādētu vietējo better-sqlite3 papildinājumu (kas, beidzot darbu, avarē darbinieku). Tas nekad netiek iestatīts darbībā esošajam serverim.
OMNIROUTE_SKIP_NATIVE_DEP_CHECK 0 scripts/check/check-native-deps.mjs Iestatiet uz 1, lai neparastiem piegādātāja iekļautiem kokiem izlaistu neobligāto vietējo atkarību pirmsbūvēšanas pārbaudi. Tas nepadara trūkstošu atkarību būvējamu; izmantojiet tikai tad, ja vietējās atkarības tiek nodrošinātas ārpus standarta procesa.
OMNIROUTE_DATA_DIR (nav iestatīts) open-sse/executors/promptql/threadSticky.ts Rezerves aizstājvārds mainīgajam DATA_DIR, kas tiek pārbaudīts tikai tad, ja DATA_DIR nav iestatīts. To izmanto, lai atrastu PromptQL izpildītāja diskā glabāto pavedienam piesaistīto sesiju kešatmiņu (<dir>/promptql-thread-sessions.json); ja nav iestatīts neviens no mainīgajiem, kešatmiņa paliek tikai atmiņā (tā netiek saglabāta starp restartēšanas reizēm).
OMNIROUTE_PLUGINS_DIR (nav iestatīts) src/lib/plugins/scanner.ts Direktorijs, kuru lasa izpildlaika spraudņu skeneris un kurā spraudņu pārvaldnieks instalē spraudņus, ignorējot no mājas direktorija atvasināto noklusējumu (#11827). Norādiet tam Docker/K8s piesaistīto spraudņu koku, nevis pārvietojiet HOME tikai tādēļ, lai mainītu skenēšanas ceļu (HOME nosaka arī visu pārējo ar mājas direktoriju saistīto darbību). Nav iestatīts = ~/.omniroute/plugins vai /tmp/.omniroute/plugins, ja process vispār neeksportē mājas direktoriju — šis mainīgais novērš kluso spraudņu neatrašanu. Atrisinātais direktorijs palaišanas laikā tiek vienreiz reģistrēts žurnālā kā scanner.dir_resolved kopā ar izmantoto ievadi. Tikai servera pusē: CLI komandu spraudņi turpina izmantot savu OMNIROUTE_PLUGIN_PATH (9. sadaļa).
STORAGE_ENCRYPTION_KEY (tukšs = atspējots) src/lib/db/encryption.ts AES atslēga pilnas SQLite datubāzes šifrēšanai miera stāvoklī. Ģenerējiet ar openssl rand -hex 32.
STORAGE_ENCRYPTION_KEY_VERSION v1 scripts/build/bootstrap-env.mjs, electron/main.js Šifrēšanas atslēgas versijas apzīmējums. Palieliniet to, veicot atslēgas rotāciju, lai nodrošinātu veco dublējumkopiju atšifrēšanu.
DISABLE_SQLITE_AUTO_BACKUP false src/lib/db/backup.ts Ja vērtība ir true, regulārās/pirmsrakstīšanas SQLite faila dublējumkopijas tiek izlaistas (models.dev cenu saglabāšana/notīrīšana, iestatījumu ierakstīšana). Manuālās un pirmsatjaunošanas dublējumkopijas joprojām tiek veidotas. Tas neatspējo migrāciju izpildītāja obligāto noturīgo drošības momentuzņēmumu vai masveida migrācijas aizsardzību esošai pastāvīgai DB. Nemanulālo dublējumkopiju izveide tiek ierobežota līdz ne vairāk kā vienai reizei 60 minūtēs. Informācijas paneļa sadaļā Iestatījumi → Krātuve regulāro automātisko dublēšanu var atspējot neatkarīgi.
OMNIROUTE_CRYPT_KEY (nav iestatīts) src/lib/db/encryption.ts STORAGE_ENCRYPTION_KEY mantotais aizstājvārds. Tiek pieņemts kā rezerves variants, ja primārā mainīgā nav.
OMNIROUTE_API_KEY_BASE64 (nav iestatīts) src/lib/db/encryption.ts Mantotais aizstājvārds (Base64 kodētā formā), kas tiek pieņemts kā rezerves variants. Pirms lietošanas tiek automātiski dekodēts.
OMNIROUTE_DB_HEALTHCHECK_INTERVAL_MS (nav iestatīts) src/lib/db/core.ts Pārraksta periodiskās SQLite darbspējas pārbaudes intervālu (ms). Ja nav iestatīts, noklusējuma vērtības tiek atvasinātas no NODE_ENV.
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS 21600000 (6 h) src/lib/db/walMaintenance.ts Pārraksta periodiskā wal_checkpoint(TRUNCATE) intervālu (ms). Automātiskā kontrolpunkta izveide nekad nesamazina paša WAL faila izmēru, un ilgstoši darbojošs serveris nekad neaizver savu DB. 0 atspējo.
OMNIROUTE_WAL_PASSIVE_INTERVAL_MS 300000 (5 min.) src/lib/db/walMaintenance.ts Pārraksta biežā wal_checkpoint(PASSIVE) intervālu (ms). Uztur neapstrādāto WAL kadru skaitu mazu, lai periodiskā TRUNCATE operācija galvenajā pavedienā nekad nekopētu vairāku GB uzkrājumu. 0 atspējo.
OMNIROUTE_WAL_GUARD_MAX_MB 256 src/lib/db/walMaintenance.ts Ja PASSIVE cikls konstatē, ka WAL fails pārsniedz šo izmēru, nekavējoties pāriet uz wal_checkpoint(TRUNCATE), nevis gaida lēno ciklu.
OMNIROUTE_PRESSURE_SELF_RESTART false open-sse/utils/resourcePressure.ts Iestatiet uz 1/true/yes/on, lai izbeigtu procesu pēc tam, kad kritisks resursu noslogojums ir saglabājies OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS ilgi, ļaujot pārraugam (systemd Restart=always, Docker restartēšanas politikai) palaist tīru procesu, nevis bezgalīgi atgriezt 503 atbildes.
OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS 120000 (2 min.) open-sse/utils/resourcePressure.ts Cik ilgi kritiskajam noslogojumam jāsaglabājas, pirms tiek aktivizēta iziešana pašrestartēšanas nolūkā.
OMNIROUTE_SQLJS_WASM_PATH (automātiska noteikšana) src/lib/db/adapters/sqljsAdapter.ts Skaidri norādīts ceļš (absolūts vai relatīvs pret cwd) uz sql-wasm.wasm, izmantojot sql.js WASM rezerves adapteri. Ja nav iestatīts, tas tiek automātiski noteikts, izmantojot pakotņu atkarības un iespējamos izkārtojumus.
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS 21600000 (6 h) src/lib/db/core.ts Pārraksta periodiskā wal_checkpoint(TRUNCATE) intervālu (ms). Automātiskā kontrolpunkta izveide nekad nesamazina paša WAL faila izmēru, un ilgstoši darbojošs serveris nekad neaizver savu DB. 0 atspējo.
OMNIROUTE_BATCH_RETENTION_DAYS 30 src/lib/db/cleanup.ts Dienu skaits, cik ilgi pabeigta (completed/failed/cancelled/expired) Batch API uzdevuma kontrolpunkti, atsauču ievades/izvades/kļūdu faili un rinda tiek glabāti pirms dzēšanas, ko veic automātiskā tīrīšana. Stājas spēkā tikai tad, kad ir ieslēgts BATCH_AND_FILE_AUTO_CLEANUP_ENABLED; atbilst paša OpenAI Batch API izvades saglabāšanas periodam. Neietekmē operatora aktivizēto maršrutu DELETE /api/v1/batches/delete-completed, kas pēc konstrukcijas paliek beznosacījuma (bez vecuma filtra).
BATCH_AND_FILE_AUTO_CLEANUP_ENABLED false src/lib/db/cleanup.ts Ja vērtība ir true, automātiskās tīrīšanas process drīkst dzēst pabeigtos Batch API darbus (un to kontrolpunktus), kas ir vecāki par OMNIROUTE_BATCH_RETENTION_DAYS, kā arī notīrīt augšupielādēto failu BLOB saturu pēc to expires_at termiņa beigām. Pēc noklusējuma izslēgts: ikvienā esošajā instalācijā šie dati tiek saglabāti tieši tāpat kā iepriekš, līdz operators šo funkciju iespējo. Tas ir arī informācijas panelī rediģējams funkcijas karogs — skatiet docs/reference/FEATURE_FLAGS.md → Izpildlaiks.
OMNIROUTE_SKIP_DB_HEALTHCHECK 0 src/lib/db/core.ts, src/lib/db/healthCheck.ts Iestatiet uz 1, lai palaišanas laikā pilnībā izlaistu DB darbspējas pārbaudi. Noder īslaicīgiem uzdevumiem un integrācijas testiem.
OMNIROUTE_FORCE_DB_HEALTHCHECK 0 src/lib/db/core.ts Iestatiet uz 1, lai piespiedu kārtā iespējotu DB darbspējas pārbaudes ciklu pat tad, ja parasti tas tiktu izlaists (piem., īslaicīgiem uzdevumiem).
OMNIROUTE_SKIP_POSTINSTALL 0 scripts/postinstall.mjs Iestatiet uz 1, lai npm install laikā izlaistu vietējās izpildvides iesildīšanu. Noder CI/bezgalvas instalācijās, kur sqlite jau ir kompilēts.
OMNIROUTE_MIGRATIONS_DIR (automātiska noteikšana) src/lib/db/migrationRunner.ts Norādiet citu direktoriju, ko skenē migrāciju izpildītājs. Noder, ja pielāgotos būvējumos tiek piegādātas komplektā iekļautas migrācijas.
OMNIROUTE_EXTRA_MIGRATIONS_DIRS (nav iestatīts) src/lib/db/migrationRunner/extraDirs.ts Papildu migrāciju direktoriji kā namespace=dir ieraksti, kas atdalīti ar platformas ceļu atdalītāju (piem., ee=/opt/app/enterprise/db/migrations). Tajos atrastie faili tiek reģistrēti kā <namespace>-<number>, tādēļ distribūcija, kas piegādā savas migrācijas, nekad nekonfliktē ar augšupstraumes skaitliskajām pozīcijām. Nepareizi veidots ieraksts, nederīga nosaukumvieta vai neesošs direktorijs palaišanas laikā izraisa kļūdu, nevis klusi izlaiž shēmu.
OMNIROUTE_MAX_PENDING_MIGRATIONS 50 src/lib/db/migrationRunner.ts Drošības slieksnis lielam neizpildīto migrāciju skaitam (#3416). Palaišana tiek pārtraukta, ja esošā DB gaida vairāk migrāciju par šo skaitu (aizsardzība pret notīrītu uzskaites tabulu). Palieliniet to, lai atjaunotu vecāku dublējumu; iestatiet uz 0, lai atspējotu pārbaudi.
OMNIROUTE_INSTALL_UPGRADE_WORKDIR (<repo>/.install-upgrade) scripts/check/check-install-upgrade.mjs Darba direktorijs check:install-upgrade laidiena kontroles posmam. Tam nepieciešami aptuveni 12 GB (divi ~3 GB instalācijas koki un tar arhīvs), tādēļ to nedrīkst palaist mazā tmpfs — pašmitinātajā izpildītājā /tmp ir 12 GB RAM atbalstīts tmpfs, un kontroles posms to izsmēla, saīsinot pakotni.
OMNIROUTE_SPEND_FLUSH_INTERVAL_MS (noklusējums kodā) src/lib/spend/batchWriter.ts Buferizētā tēriņu/izmaksu rakstītāja iztukšošanas intervāls (ms). Mazākas vērtības samazina rakstīšanas darbību apvienošanu; lielākas vērtības samazina DB noslodzi.
OMNIROUTE_SPEND_MAX_BUFFER_SIZE (noklusējums kodā) src/lib/spend/batchWriter.ts Maksimālais buferēto tēriņu ierakstu skaits pirms piespiedu iztukšošanas. Palieliniet izvietojumos ar lielu QPS; samaziniet, ja ierobežots atmiņas patēriņš ir svarīgāks.
OMNIROUTE_PROXY_FETCH_DEBUG (nav iestatīts) open-sse/utils/proxyFetch.ts Iestatiet uz "true", lai Vercel releja ceļā izvadītu [ProxyFetch] atkļūdošanas žurnālus. Pēc noklusējuma izslēgts, lai neizpaustu maršrutēšanas norādes.
PROXY_LOG_INCLUDE_IPS false src/lib/proxyLogger.ts Iestatiet uz "true" vai "1", lai detalizētajā [ProxyEgress] procesa žurnāla rindā iekļautu klienta/izejošās IP adreses un konta prefiksu. Pēc noklusējuma atstāts IZSLĒGTS, lai procesa žurnāls neizpaustu IP adreses vai konta prefiksu.
OMNIROUTE_DEBUG (nav iestatīts) bin/cli/commands/quota.mjs Iestatiet uz 1, lai no CLI kvotu komandām stderr izvadē drukātu katra pieprasījuma laika diagnostiku ([omniroute] GET <path> completed in Nms).
OMNIROUTE_HEALTHCHECK_PATH (automātiski) scripts/dev/healthcheck.mjs Konteinera darbspējas pārbaudes laikā pārbaudāmais konkrētais ceļš. Ja nav iestatīts, pārbaude to atvasina no OMNIROUTE_BASE_PATH; tā iestatīšana atkārtoti iespējo padziļinātās pārraudzības galapunktu.
OMNIROUTE_DEBUG_COMPLETION (nav iestatīts) bin/cli/commands/completion.mjs Iestatiet jebkuru netukšu vērtību, lai no CLI čaulas pabeigšanas kešatmiņas ceļiem (lasīšana/atsvaidzināšana/rakstīšana) izvadītu [omniroute completion] diagnostiku. Pēc noklusējuma izslēgts — šo kešatmiņu kļūmes notiek bez paziņojuma, lai trūkstoša/bojāta kešatmiņa nekad netraucētu pabeigšanu ar tabulēšanas taustiņu.
BATCH_RETRY_DURATION_MS 86400000 (24 h) open-sse/services/batchProcessor.ts Maksimālais atkārtotu mēģinājumu periods atsevišķiem paketes elementiem (ms). Elementi, kas pārsniedz šo periodu, tiek atzīmēti kā neizdevušies.
BATCH_BACKOFF_BASE_MS 5000 open-sse/services/batchProcessor.ts Pamata aizkave (ms) eksponenciālajai nogaidīšanai, atkārtoti mēģinot apstrādāt paketes elementus.
BATCH_BACKOFF_MAX_MS 3600000 (1 h) open-sse/services/batchProcessor.ts Eksponenciālās nogaidīšanas maksimālā robeža (ms) starp paketes elementu atkārtotas apstrādes mēģinājumiem.
BATCH_MAX_CONCURRENT 1 open-sse/services/batchProcessor.ts Maksimālais vienlaikus apstrādājamo pakešu skaits. Palieliniet, lai uzlabotu caurlaidspēju; saglabājiet zemu vērtību, lai izvairītos no masveida pieprasījumu biežuma ierobežojumu sasniegšanas.

Important

Pirms esošas pastāvīgās datubāzes mainīšanas migrācijas izpildītājs direktorijā DATA_DIR/db_backups/ publicē pilnīgu, pēc satura adresētu momentuzņēmumu. Publicēšanai ir nepieciešama failu sistēma, kas atbalsta tajā pašā failu sistēmā izveidotas, bez pārrakstīšanas cietās saites, kā arī noturīgu failu sinhronizāciju. POSIX resursdatoriem ir nepieciešama arī direktoriju sinhronizācija; operētājsistēmā Windows Node var noraidīt direktoriju turus, tāpēc OmniRoute iztukšo publicētā faila buferi un direktorija ieraksta sinhronizāciju veic, cik iespējams. Ja montētais DATA_DIR nevar nodrošināt šīs garantijas, palaišana tiek droši pārtraukta pirms migrācijas piemērošanas. Pārvietojiet DATA_DIR uz sējumu, kas atbalsta šos mehānismus; neizmantojiet DISABLE_SQLITE_AUTO_BACKUP, lai apietu migrācijas drošības prasības.

Scenāriji

Scenārijs Konfigurācija
Lokālā izstrāde Atstājiet visas noklusējuma vērtības. DB atrodas ~/.omniroute/omniroute.db.
Docker DATA_DIR=/data + montējiet sējumu pie /data.
Šifrēts miera stāvoklī Iestatiet STORAGE_ENCRYPTION_KEY + glabājiet atslēgas dublējumkopijas! Tās zaudēšana = datu zaudēšana.
CI/Testēšana DATA_DIR=/tmp/omniroute-test — īslaicīgs, šifrēšana nav nepieciešama.

3. Tīkls un porti

Mainīgais Noklusējums Avota fails Apraksts
PORT 20128 src/lib/runtime/ports.ts Galvenais ports gan informācijas paneļa lietotāja saskarnei, gan API galapunktiem (viena porta režīmā).
OMNIROUTE_BASE_PATH (tukšs = sakne) next.config.mjs, scripts/docker/ensure-docker-base-path.mjs URL apakšceļš OmniRoute apkalpošanai aiz reversā starpniekservera (iestata Next.js basePath; autentifikācijas novirzīšanā tiek ņemts vērā basePath). Piemēram, /omniroute. Docker vidē vērtība tiek iekļauta docker build laikā (ARG OMNIROUTE_BASE_PATH); iepriekš izveidotiem saknes attēliem citu izpildlaika vērtību var lietot vienreiz konteinera palaišanas brīdī, pirms tiek startēts Next.js. Iestatiet NEXT_PUBLIC_BASE_URL uz publisko izcelsmes adresi, iekļaujot to pašu apakšceļu.
NEXT_PUBLIC_OMNIROUTE_BASE_PATH (tukšs = sakne) src/shared/hooks/useDisplayBaseUrl.ts Pārlūkā redzams OMNIROUTE_BASE_PATH spoguļattēls, kas būvēšanas laikā tiek iegults, lai informācijas paneļa galapunkta attēlojumā būtu redzams https://host/omniroute/v1, nevis https://host/v1. Ja nav iestatīts, izmanto OMNIROUTE_BASE_PATH. Pēc izmaiņām veiciet atkārtotu būvēšanu (Next basePath tiek noteikts būvēšanas laikā).
DASHBOARD_ALLOW_EMBED (nav iestatīts = nekad nevar ievietot ietvarā) next.config.mjs, scripts/build/dashboardEmbed.mjs Izvēles iespēja HTML lapu iegulšanai iframe. Ja nav iestatīts, katrs maršruts tiek piegādāts ar frame-ancestors 'none' + X-Frame-Options: DENY. Iestatiet uz vscode, lai lapas (informācijas paneli, pieteikšanos, dokumentāciju, sākumlapu) apkalpotu ar frame-ancestors 'self' vscode-webview: un bez X-Frame-Options, tādējādi VS Code Simple Browser varētu tās atveidot (OmniCopilot režīms dashboardOpen: "editor"). API virsma (/api, /v1, /v1beta, /a2a, /healthz, saknes līmeņa aizstājvārdi) jebkurā gadījumā saglabā stingrās galvenes. Tiek atpazīts tikai vscode1/true to neiespējo. Būvēšanas laika iestatījums: pēc izmaiņām veiciet atkārtotu būvēšanu (docker build --build-arg DASHBOARD_ALLOW_EMBED=vscode attēliem; tā iestatīšana iepriekš izveidotā instalācijā neko neietekmē).
API_PORT (nav iestatīts) src/lib/runtime/ports.ts Ja iestatīts, apkalpo /v1/* starpniekservera API šajā atsevišķajā portā.
API_HOST 0.0.0.0 src/lib/runtime/ports.ts API porta piesaistes adrese.
DASHBOARD_PORT (nav iestatīts) src/lib/runtime/ports.ts Ja iestatīts, apkalpo informācijas paneļa lietotāja saskarni šajā atsevišķajā portā.
OMNI_MAX_CONCURRENT_CONNECTIONS 0 (atspējots) src/sse/utils/backpressure.ts Ierobežo vienlaicīgo aktīvo tērzēšanas savienojumu skaitu; pieprasījumi virs ierobežojuma saņem 503 ar Retry-After. Pozitīvs vesels skaitlis iespējo aizsardzību; neiestatīta vērtība/0 to atspējo.
OMNIROUTE_INSTANCE_ID (nav iestatīts) src/shared/resilience/peerRouting.ts Stabils un unikāls šīs vārtejas ID, savienojot OmniRoute instances ķēdē. Iespējo ienākošo vienādranga cilpu pārbaudes. Atļautās rakstzīmes: burti, cipari, ., _, : un -; ne vairāk kā 64 rakstzīmes.
OMNIROUTE_PEER_URLS (nav iestatīts) src/shared/resilience/peerRouting.ts, open-sse/executors/base.ts Ar komatiem atdalīti OmniRoute bāzes URL, kas var saņemt X-OmniRoute-Peer-Trace. Vienādranga metadatus saņem tikai nepārprotami atļauto resursu sarakstā iekļautie augšupstraumes URL; visi pārējie pakalpojumu sniedzēji netiek ietekmēti.
OMNIROUTE_PEER_MAX_HOPS 4 src/shared/resilience/peerRouting.ts Maksimālais iepriekš apmeklēto OmniRoute instanču skaits, kas tiek pieņemts ķēdētā pieprasījumā (132). Atkārtotas instances vai izsmelts limits atgriež HTTP 508 Loop Detected.
PROD_DASHBOARD_PORT 20130 docker-compose.prod.yml Resursdatora pusē publicētais informācijas paneļa ports Docker produkcijas režīmā.
PROD_API_PORT 20131 docker-compose.prod.yml Resursdatora pusē publicētais API ports Docker produkcijas režīmā.
OMNIROUTE_PORT (nav iestatīts) src/lib/runtime/ports.ts Darbojoties Electron vai citās ietverošajās lietotnēs, tam ir prioritāte pār PORT.
LIVE_WS_PORT 20129 src/server/ws/liveServer.ts Reāllaika WebSocket uzraudzības servera ports.
LIVE_WS_HOST 127.0.0.1 src/server/ws/liveServer.ts Reāllaika WebSocket servera piesaistes adrese. Iestatiet uz 0.0.0.0, lai padarītu to pieejamu LAN tīklā (konfigurējiet arī LIVE_WS_ALLOWED_ORIGINS).
LIVE_WS_ALLOWED_ORIGINS (nav iestatīts) src/server/ws/liveServer.ts Ar komatiem atdalītas papildu izcelsmes vietas, kurām atļauts atvērt reāllaika WebSocket savienojumu. Atgriezeniskās cilpas informācijas paneļa izcelsmes vietas jau ir atļautas pēc noklusējuma.
LIVE_WS_ALLOWED_HOSTS (nav iestatīts) src/server/ws/liveServerAllowList.ts Ar komatiem atdalīti papildu resursdatoru nosaukumi, kas atļauti reāllaika WebSocket izcelsmes vietām. Atšķirībā no LIVE_WS_ALLOWED_ORIGINS (pilniem izcelsmes vietu URL) tiek salīdzināta tikai resursdatora daļa — noderīgi LAN/Tailscale konfigurācijām.
NEXT_PUBLIC_LIVE_WS_PUBLIC_URL (nav iestatīts) src/hooks/useLiveDashboard.ts Reāllaika informācijas paneļa WebSocket publiskais URL (pārlūkprogrammas pusē). Iestatiet, ja WS serveris tiek izvietots aiz reversā starpniekservera vai Cloudflare Tunnel (piemēram, wss://ws.my-ai.com/live-ws); pārlūkprogramma izveidos savienojumu ar šo adresi, nevis ws://hostname:20132. Ceļa daļa tiek izmantota arī kā WebSocket jaunināšanas ceļš (noklusējums: /live-ws).
OMNIROUTE_ENABLE_LIVE_WS true src/server/ws/liveServer.ts un scripts/start-ws-server.mjs Iestatiet uz 0 vai false, lai atspējotu reāllaika WebSocket serveri (pēc noklusējuma iespējots un piesaistīts atgriezeniskās cilpas adresei). CI/testēšanas ietvara slēdzis, kas atspējo savrupo reāllaika WebSocket palīgskriptu.
RELAY_IP_PER_MINUTE 30 src/app/api/v1/relay/chat/completions/route.ts Releja ātruma ierobežojums katram (marķiera, IP) pārim, pieprasījumi minūtē. Atmiņā glabāts, katrai instancei atsevišķs. 0 vai negatīva vērtība atspējo IP dimensijas ierobežojumu (katra marķiera datubāzes ierobežojums joprojām ir spēkā).
NODE_ENV production Next.js kodols Kontrolē žurnalēšanas detalizācijas līmeni, kešatmiņu, kļūdu informācijas atklāšanu un Next.js optimizācijas.
OMNIROUTE_USE_TURBOPACK 1 (Turbopack — noklusējums kodā) package.json / Next.js 16 Turbopack ir noklusējuma komplektētājs komandām npm run dev un npm run build (saskaņā ar veiktspējas testiem būvējumi ir 23× ātrāki). Iestatiet uz 0, lai Windows vidē pārslēgtos atpakaļ uz webpack, ja rodas vietējo saistījumu / komplektētāja saderības problēmas, vai datoros ar ierobežotu RAM apjomu — ir zināms, ka Turbopack produkcijas būvējumi šajā Next.js versiju līnijā (16.2.x) lielos moduļu grafos sasniedz daudz lielāku maksimālo atmiņas patēriņu nekā webpack (Next 16.3 Turbopack atmiņas atbrīvošanas labojums vēl nav stabils); izmantojot webpack kā rezerves variantu, maksimālais patēriņš ir daudz mazāks. Skatiet #6409.
OMNIROUTE_SKIP_DB_HEALTHCHECK (nav iestatīts) src/lib/db/core.ts / src/lib/db/healthCheck.ts Iestatiet uz 1, lai palaišanas laikā izlaistu SQLite integritātes veselības pārbaudi. Noder ātrākai palaišanai ar lielām datubāzēm.
NOTIFY_SOCKET (nav iestatīts) systemd (sd_notify protokols) To iestata systemd, kad process darbojas pakalpojuma vienībā ar sd_notify integrāciju; OmniRoute to nolasa (skatiet OMNIROUTE_DISABLE_SD_NOTIFY), lai nosūtītu READY/WATCHDOG paziņojumus. Lietotājs to nekad neiestata.
OMNIROUTE_DISABLE_SD_NOTIFY (nav iestatīts) scripts/dev/systemd-notify.mjs Iestatiet uz 1, lai atspējotu systemd sd_notify (Type=notify / WatchdogSec=) pat tad, ja process darbojas systemd vienībā. Ārpus systemd paziņotājs jebkurā gadījumā neveic nekādas darbības.
CREDENTIAL_HEALTH_CHECK_INTERVAL 300000 open-sse/config/constants.ts / src/lib/credentialHealth/scheduler.ts Fona akreditācijas datu veselības pārbaudes plānotāja intervāls (ms). Minimums: 10000 (10 s).
CREDENTIAL_HEALTH_CACHE_TTL 300000 open-sse/config/constants.ts / src/lib/credentialHealth/cache.ts Kešatmiņā saglabātā akreditācijas datu veselības statusa TTL (ms).
OMNIROUTE_DISABLE_CREDENTIAL_HEALTH_CHECK false src/lib/credentialHealth/scheduler.ts Iestatiet uz 1 vai true, lai atspējotu periodisku pakalpojumu sniedzēju savienojumu testēšanu fonā. Meklēšanas pakalpojumu sniedzēji (SEARCH_VALIDATOR_CONFIGS failā src/lib/providers/validation/searchProviders.ts, piemēram, tavily-search) vienmēr tiek izslēgti no pārbaudes — to „validācija” ir reāls maksas vaicājums augšupējam pakalpojumam, tāpēc tiem nekad netiek veiktas veselības pārbaudes pēc taimera (#9970).
HOST 0.0.0.0 scripts/dev/run-next.mjs Next.js izstrādes/palaišanas servera piesaistes adrese. Ja iestatīta, aizstāj noklusējuma vērtību 0.0.0.0.
HOSTNAME 127.0.0.1 scripts/dev/run-next-playwright.mjs Piesaistes adrese, ko izmanto Playwright izpildītājs, palaižot Next.js. Hermētiskiem testiem noklusējuma vērtība ir 127.0.0.1. Neizmantojiet komandai omniroute serve — tās vietā izmantojiet OMNIROUTE_SERVER_HOST (POSIX čaulas automātiski iestata HOSTNAME kā datora nosaukumu; .env to nevar pārrakstīt).
OMNIROUTE_SERVER_HOST 0.0.0.0 bin/cli/commands/serve.mjs Piesaistes adrese komandai omniroute serve. Novērš konfliktu ar POSIX čaulas mainīgo HOSTNAME (bash/zsh to vienmēr iestata kā datora nosaukumu). Ja nav iestatīts, tiek izmantota rezerves vērtība 0.0.0.0. (#6194)

Portu režīmi

┌────────────────────────── Viens ports (noklusējums) ───────────────────────┐
│  PORT=20128                                                                 │
│  → Vadības panelis: http://localhost:20128                                  │
│  → API:             http://localhost:20128/v1/chat/completions              │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────── Atsevišķi porti ─────────────────────────────────┐
│  DASHBOARD_PORT=20128                                                       │
│  API_PORT=20129                                                             │
│  API_HOST=0.0.0.0                                                           │
│  → Vadības panelis: http://localhost:20128                                  │
│  → API:             http://0.0.0.0:20129/v1/chat/completions               │
│  Pielietojums: API pieejams LAN, bet vadības panelis — tikai localhost.     │
└─────────────────────────────────────────────────────────────────────────────┘

┌──────────────────────── Docker ražošanas vide ─────────────────────────────┐
│  PROD_DASHBOARD_PORT=443   PROD_API_PORT=8443                              │
│  → Konteinera portus kartē uz resursdatora portiem docker-compose.prod.yml.│
└─────────────────────────────────────────────────────────────────────────────┘

4. Drošība un autentifikācija

Mainīgais Noklusējuma vērtība Avota fails Apraksts
MACHINE_ID_SALT endpoint-proxy-salt src/lib/auth Sāls, kas tiek kombinēts ar aparatūras identifikatoriem, lai izveidotu ierīces digitālo nospiedumu. Izolācijas nolūkā mainiet to katrai izvietošanas videi.
OMNIROUTE_CLI_SALT (nav iestatīts = nejaušs katras instalācijas sāls, kas tiek pastāvīgi glabāts failā <DATA_DIR>/cli-token-salt.json) src/lib/machineToken.ts HMAC sāls lokālā CLI autentifikācijas marķiera atvasināšanai. Iestatot šo vērtību, tiek nomainīti visi ierīces CLI marķieri, un tai vienmēr ir prioritāte pār pastāvīgi saglabāto sāli. Skatiet docs/security/CLI_TOKEN.md.
AUTH_COOKIE_SECURE false src/lib/auth Sesijas sīkfailiem iestata karogu Secure. Darbojoties aiz HTTPS, šai vērtībai jābūt true.
REQUIRE_API_KEY false API starpprogrammatūra Ja vērtība ir true, visos /v1/* starpniekservera pieprasījumos jāiekļauj derīga API atslēga.
ALLOW_API_KEY_REVEAL false src/shared/constants/featureFlagDefinitions.ts Ļauj informācijas paneļa lietotāja saskarnē atklāt pilnas API atslēgu vērtības. Konfigurējams informācijas paneļa funkciju karogu sadaļā; koplietojamās instancēs rada drošības risku.
NO_LOG_API_KEY_IDS (tukšs) src/lib/compliance/index.ts Ar komatiem atdalīti API atslēgu ID, kuriem netiek veikta pieprasījumu reģistrēšana (atbilstībai VDAR).
DEFAULT_RATE_LIMIT_PER_DAY (nav iestatīts = neierobežots) src/shared/utils/apiKeyPolicy.ts Rezerves dienas pieprasījumu budžets, kas tiek piemērots API atslēgām, kuru kolonnas rate_limits vērtība ir null. Nav iestatīts vai ir tukšs: nav netieša ierobežojuma (#2289, #11017). 0 nozīmē to pašu (neierobežots). Pozitīvs vesels skaitlis N iespējo N/dienā, 5N/nedēļā, 20N/mēnesī. Nepareizi formatētām vērtībām, kas nav tukšas, tiek izmantoti mantotie ierobežojumi: 1000/dienā, 5000/nedēļā, 20000/mēnesī.
MAX_BODY_SIZE_BYTES 10485760 (10 MB) src/shared/middleware/bodySizeGuard.ts Maksimālais atļautais pieprasījuma pamatteksta lielums. Noraida lietderīgās slodzes, kas pārsniedz šo ierobežojumu.
OMNIROUTE_CHAT_LARGE_BODY_BYTES 262144 (256 KB) src/shared/middleware/chatBodyAdmission.ts Faktiskie pieprasījumu pamatteksti, kuru lielums sasniedz vai pārsniedz šo slieksni, pirms JSON parsēšanas iegūst atomāro procesa lokālo resursietilpīgās uzņemšanas nomu (BYTE ceļš, tostarp POST /v1/responses). Tā pati #10437 atkāpe pietiekamas brīvās kapacitātes gadījumā kā struktūras ziņā apjomīgiem pieprasījumiem; to joprojām ierobežo OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110, lai neatkārtotos #7849.
OMNIROUTE_CHAT_HARD_MAX_BODY_BYTES 52428800 (50 MB) src/shared/middleware/chatBodyAdmission.ts Tērzēšanas maršruta absolūtais ierobežojums, kas tiek piemērots ierobežotas ievades laikā nolasīto baitu skaitam, tostarp pieprasījumiem ar trūkstošu, nederīgu vai nepatiesu Content-Length; pārsniegšanas gadījumā tiek atgriezts 413.
OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT (nav iestatīts — nav pieprasījumu skaita ierobežojuma) src/shared/middleware/chatBodyAdmission.ts #503-fanout: šis mantotais pieprasījumu SKAITA ierobežojums tagad tiek piemērots tikai tad, ja tas ir skaidri iestatīts. Ja tas nav iestatīts (noklusējums), smagsvara tērzēšanas pieprasījumu uzņemšanu tā vietā ierobežo OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES — automātiski atvasināts BAITU budžets, kura lielumu nosaka procesa reālais atmiņas ierobežojums vienā procesā (vienā V8 kaudzē). Divi vienlaicīgi ~750k tokenu /v1/responses pieprasījumi avarē ~12Gi kaudzes (#7849) — tas ir atmiņas budžeta brīdinājums, nevis stingrs produkta maksimums 2. Vesels process (kaudze zem atmešanas attiecības) VAR uzņemt vairāk vienlaicīgu ilgu /v1/responses pieprasījumu, izmantojot OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM. Desmitiem ilgu SSE klientu (4050) ierobežojumu nosaka kaudze + OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110, nevis “maksimums 2”. Akli palielinot šo vērtību, lai “izmantotu resursdatoru”, atkal tiek ieviesta #7849 problēma. Vairojiet kaudzes, izmantojot N neatkarīgus DATA_DIR (#11024); nekad neizmantojiet replicas>1 vienam SQLite failam.
OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES (automātiski atvasināts) src/shared/middleware/admissionBudget.ts #503-fanout: automātiski atvasinātā ievades baitu budžeta ignorēšana (25% no stingrākā V8/cgroup atmiņas ierobežojuma, dalīti ar 8x pārejošās amplifikācijas koeficientu). Atvasinātās un tieši norādītās vērtības tiek ierobežotas diapazonā no 8 MiB līdz 2 GiB. Pamatteksts, kas pārsniedz faktisko budžetu, nekavējoties izraisa 413 body_exceeds_budget; konkurence starp atsevišķi apkalpojamiem pamattekstiem joprojām izraisa atkārtojamu 503. 4050 vienlaicīgu ilgu SSE klientu ierobežojumu nosaka šis budžets + kaudze, nevis stingrs “maksimums 2”. Pirms pielāgošanas skatiet chatAdmission.maxInflightBytes / budgetSource / pressureSeverity adresē /api/monitoring/health.
OMNIROUTE_CHAT_ADMISSION_HEAP_SHED_RATIO 0.75 src/shared/middleware/chatBodyAdmission.ts Kaudzes spiediena atmešanas attiecība (heapUsed / heap_size_limit) BAITU un STRUKTŪRAS smagsvara pieprasījumu uzņemšanai (#10183, #10268, #10437). Vienlaicīgs smagsvara pieprasījums, kas pārsniedz OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT, tiek atmests ar atkārtojamo 503 tikai tad, ja kaudze ARĪ ir sasniegusi vai pārsniegusi šo attiecību; ja kaudze ir vesela, tas tiek uzņemts, izmantojot veselās kaudzes rezerves kapacitāti.
OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT (noklusējums 1) src/shared/middleware/chatBodyAdmission.ts Ierobežota papildu kapacitāte veselās kaudzes ātrajam ceļam (#10437) gan STRUKTŪRAS, gan BAITU gadījumā (admitChatRequest, tostarp pamattekstiem ≥ OMNIROUTE_CHAT_LARGE_BODY_BYTES). Bez šī ierobežojuma katrs pieprasījums, kas saņemts noslodzes laikā, bet pie veselas kaudzes, apietu uzņemšanas kontroli bez jebkādas augšējās robežas. Tiklīdz veselās kaudzes ceļā ir aktīvs šāds vienlaicīgu nomu skaits, turpmāki noslodzes laikā saņemtie pieprasījumi pāriet uz TO PAŠU ierobežotas gaidīšanas/atmešanas ceļu, kas tiek izmantots reāla kaudzes spiediena apstākļos. 0 pilnībā atspējo apiešanu.
OMNIROUTE_CHAT_HEAVY_MESSAGE_COUNT 200 src/shared/middleware/chatBodyAdmission.ts Ziņojumu skaits, pie kura tērzēšanas pieprasījums tiek klasificēts kā smagsvara pieprasījums pat tad, ja tā pamatteksts ir mazāks par baitu slieksni.
OMNIROUTE_CHAT_HEAVY_TOOL_COUNT 64 src/shared/middleware/chatBodyAdmission.ts Rīku skaits, pie kura tērzēšanas pieprasījums tiek klasificēts kā smagsvara pieprasījums pat tad, ja tā pamatteksts ir mazāks par baitu slieksni.
OMNIROUTE_CHAT_HEAVY_ESTIMATED_TOKENS 32000 src/shared/middleware/chatBodyAdmission.ts Konservatīvs uz virknes lielumu balstīts tokenu aprēķins, pēc kura pieprasījums tiek klasificēts kā smagsvara pieprasījums; tas ir uzņemšanas izmaksu aizstājējrādītājs, nevis pakalpojuma sniedzēja norēķinu tokenizācija.
OMNIROUTE_CHAT_HARD_MAX_MESSAGES 0 (atspējots) src/shared/middleware/chatBodyAdmission.ts Neobligāts tērzēšanas vēstures ierobežojums, kas jāiespējo apzināti. Pēc noklusējuma atspējots: ziņojumu skaits ir izvietošanas politika, nevis universāla pieprasījuma īpašība, un ierobežošana šeit noraida sarunas ar galīgu 413, pirms saspiešanas konveijers var tās padarīt apkalpojamas. Kaudzes pieaugumu ierobežo OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT un kaudzes spiediena atmešana. Izvietojumos ar ierobežotu atmiņu, kuros nepieciešama stingra augšējā robeža, iestatiet pozitīvu vērtību; pārsnieguma gadījumā tad tiek saņemts strukturēts 413, kas pieprasa saspiešanu.
OMNIROUTE_MAX_NONSTREAMING_RESPONSE_BYTES 67108864 (64 MB) open-sse/handlers/chatCore/nonStreamingResponseBody.ts Stingrs ierobežojums pilnībā atmiņā buferētai upstream atbildei bez straumēšanas. Pārsniedzot šo robežu, upstream lasītājs tiek atcelts un pieprasījums ātri beidzas ar kļūdu, nevis neierobežoti palielina virkni, līdz kaudze ir izsmelta.
OMNIROUTE_FORWARDING_HEADER_BUDGET_BYTES 768 open-sse/handlers/chatCore/responseHeaders.ts Maksimālais no upstream atbildes galvenēm pārsūtīto vada baitu skaits. Kad budžets tiek pārsniegts, zemākas prioritātes galvenes (piemēram, pielāgotās x-codex-*, x-oai-request-id) tiek atmestas, lai iekļautos izplatītajos reversā starpniekservera galveņu ierobežojumos. Iestatiet lielāku vērtību, lai pārsūtītu vairāk upstream metadatu, palielinot atbildes galveņu izmēru.
CORS_ORIGIN (nav iestatīts) src/server/cors/origins.ts Novecojis vienas izcelsmes CORS atļauto adrešu saraksts. Jaunās izvietošanās reizēs ieteicams izmantot CORS_ALLOWED_ORIGINS. CORS ir paredzēts tikai citas izcelsmes pārlūkprogrammu API klientiem; autentificēti informācijas paneļa rakstīšanas pieprasījumi tā vietā izmanto tās pašas izcelsmes pieprasījumus kopā ar sesijai piesaistītu CSRF aizsardzību.
CORS_ALLOWED_ORIGINS (nav iestatīts) src/server/cors/origins.ts Ar komatiem atdalīts CORS atļauto adrešu saraksts. Aizstājējzīme netiek nosūtīta, ja vien nav skaidri konfigurēts CORS_ALLOW_ALL=true.
CORS_ALLOW_ALL false src/server/cors/origins.ts Tikai izstrādei paredzēta apiešanas iespēja, kas atbalso jebkuru pārlūkprogrammas Origin. Neiespējojiet koplietojamās vai produkcijas izvietošanās vidēs.
OUTBOUND_SSRF_GUARD_ENABLED true src/shared/network/outboundUrlGuard.ts Bloķēt pakalpojumu sniedzēju izsaukumus, kuru mērķis ir privāti, cilpas vai lokālās saites IP diapazoni. Atspējojiet tikai izolētās testa vidēs.
OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS false src/shared/network/outboundUrlGuard.ts Atļaut pakalpojumu sniedzēju URL, kas norāda uz privātiem/lokāliem tīkliem (localhost, 192.168.x.x, 10.x.x.x utt.). OBLIGĀTS pašmitinātiem pakalpojumu sniedzējiem (LM Studio, Ollama, vLLM, Llamafile, Triton, SearXNG). Ja vērtība ir false, informācijas panelis noraida lokālo URL validāciju.
OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS true src/shared/network/outboundUrlGuard.ts Atļaut pievienot/validēt pakalpojumu sniedzējus lokālās/privātās adresēs (127.0.0.1, localhost, LAN, privātie diapazoni) — attiecas tikai uz pakalpojumu sniedzēja validācijas ceļu. Noklusējuma vērtība ir true (priekšroka lokālai darbībai); iestatiet false, lai piemērotu stingru tikai publisko adrešu politiku. Mākoņa metadatu galapunkti (169.254.169.254, metadata.google.internal) vienmēr paliek bloķēti. (#5066)
AUDIO_REMOTE_PROVIDER_NODES false src/app/api/v1/_shared/audioProviderNodes.ts Atļaut /v1/audio/* maršrutiem (transkripcijām, runai, tulkojumiem) izmantot ar OpenAI saderīgu pakalpojumu sniedzēja mezglu, kas mitināts ārpus localhost. Pēc noklusējuma izslēgts — audio maršrutēšana uz attālu resursdatoru maina izejošās datplūsmas identitāti, un tam jābūt skaidram operatora lēmumam. Cilpas/privātie mezgli (localhost, 127.0.0.1, 172.16-31.x) vienmēr ir atļauti un netiek ietekmēti. (#3963)
OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN false src/app/api/auth/login/route.ts Kad OIDC ir iespējots, atspējot pieteikšanos ar paroli, lai lietotāji varētu autentificēties tikai ar OIDC vienoto pierakstīšanos. Tiek pieņemts arī vienkāršais aizstājvārds OIDC_DISABLE_PASSWORD_LOGIN; priekšroka ir informācijas paneļa funkcijas karogam ar tādu pašu atslēgu. (#10889)
OIDC_DISABLE_PASSWORD_LOGIN false src/app/api/auth/login/route.ts Vienkāršais OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN aizstājvārds (#10889).

Drošības pastiprināšanas kontrolsaraksts

# Produkcijas vides drošības minimums:
AUTH_COOKIE_SECURE=true        # Nepieciešams HTTPS
REQUIRE_API_KEY=true           # Autentificēt visus starpniekservera izsaukumus
ALLOW_API_KEY_REVEAL=false     # Nekad neatklāt atslēgas lietotāja saskarnē
CORS_ALLOWED_ORIGINS=https://your.domain.com
MAX_BODY_SIZE_BYTES=5242880    # 5 MB ierobežojums

5. Ievades sanitizācija un PII aizsardzība

OmniRoute nodrošina divu līmeņu aizsardzību: pieprasījumu puses injekciju pārbaudi un atbilžu puses PII noņemšanu.

⚠️ Ierobežojumi: Šie aizsardzības mehānismi ir uz heiristiku balstīti, maksimālo iespēju robežās veikti noteikšanas pasākumi, nevis pilnvērtīgs uzvedņu injekciju ugunsmūris vai PII DLP sistēma. Tie var radīt kļūdaini pozitīvus rezultātus (atzīmējot nekaitīgas personāžu/RPG uzvednes) un kļūdaini negatīvus rezultātus (leetspeak, atstarpes, raksti valodās, kas nav angļu valoda). Ar tiem vien nepietiek atbilstības prasību izpildei. Pirms paļaušanās uz tiem pielāgojiet režīmus un pārbaudiet tos ar savu datplūsmu.

Pieprasījumu puse: uzvedņu injekciju aizsardzība

Mainīgais Noklusējums Avota fails Apraksts
INPUT_SANITIZER_ENABLED true src/middleware/promptInjectionGuard.ts Iespējo ienākošo ziņojumu pārbaudi, lai noteiktu uzvedņu injekciju modeļus.
INPUT_SANITIZER_MODE warn src/middleware/promptInjectionGuard.ts Injekciju politika: warn = tikai reģistrēt žurnālā, block = noraidīt pieprasījumu ar statusu 400. Mantotais režīms redact nenoņem injekcijas tekstu; pieprasījumu PII pārrakstīšanai izmantojiet PII_REDACTION_ENABLED.
INJECTION_GUARD_MODE (nav iestatīts) src/middleware/promptInjectionGuard.ts Mantots INPUT_SANITIZER_MODE aizstājvārds — darbība ir tāda pati.
INPUT_SANITIZER_BLOCK_THRESHOLD high src/shared/utils/injectionSeverity.ts Minimālais nopietnības līmenis, kuru noraida MODE=block: high (noklusējums), medium vai low. Vidēja līmeņa modeļi ir paredzēti tikai novērošanai, ja vien slieksnis netiek pazemināts.
INJECTION_GUARD_BLOCK_THRESHOLD (nav iestatīts) src/shared/utils/injectionSeverity.ts Mantots INPUT_SANITIZER_BLOCK_THRESHOLD aizstājvārds — darbība ir tāda pati.
PII_REDACTION_ENABLED false src/lib/guardrails/piiMasker.ts Ja vērtība ir true, aizklāj PII ienākošajos pieprasījumos (neatkarīgi no injekciju režīma).
CREDENTIAL_REDACTION_ENABLED false src/lib/guardrails/credentialMasker.ts Aizklāj pieprasījumu/atbilžu datos plaši pazīstamus API atslēgu un slepeno pilnvaru marķieru modeļus. Jāiespējo atsevišķi; darbojas analogi PII_REDACTION_ENABLED.

Atbilžu puse: PII sanitizētājs

Mainīgais Noklusējums Avota fails Apraksts
PII_RESPONSE_SANITIZATION false src/lib/piiSanitizer.ts Pirms atbildes nosūtīšanas klientam pārbauda, vai LLM atbildēs nav noplūdušu PII.
PII_RESPONSE_SANITIZATION_MODE redact src/lib/piiSanitizer.ts redact = aizklāt PII, warn = tikai reģistrēt žurnālā, block = atmest visu atbildi.

VS Code marķierizēto maršrutu konteksta sanitizētājs

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_VSCODE_SANITIZE_CONTEXT 1 src/app/api/v1/vscode/contextSanitizer.ts No /v1/vscode/[token]/* pieprasījumiem noņem netiešo aktīvā redaktora kontekstu (editorContext, activeEditor, currentFile, selection, openTabs…) un aizklāj nepārprotami pievienoto sensitīvo failu saturu. Drošs pēc noklusējuma; iestatiet uz 0, lai atspējotu.

Scenāriji

Scenārijs Konfigurācija
Uzņēmuma atbilstības prasības INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=block, PII_REDACTION_ENABLED=true, PII_RESPONSE_SANITIZATION=true (injekcijas tiek bloķētas un PII pieprasījumos/atbildēs tiek aizklāti; režīmi ir neatkarīgi)
Tikai uzraudzība INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=warn — reģistrē žurnālā, bet nekad nebloķē
Personīga lietošana Atstājiet visu atspējotu — nekādas papildu slodzes

6. Rīku un maršrutēšanas politikas

Mainīgais Noklusējums Avota fails Apraksts
TOOL_POLICY_MODE disabled src/lib/toolPolicy.ts Kontrolē LLM piekļuvi rīku/funkciju izsaukšanai. allowlist = tikai sarakstā norādītie rīki, denylist = visi, izņemot sarakstā norādītos, disabled = bez ierobežojumiem.
OMNIROUTE_PAYLOAD_RULES_PATH ./config/payloadRules.json open-sse/services/payloadRules.ts Ceļš uz lietderīgās slodzes manipulācijas kārtulu JSON failu (katram modelim/protokolam paredzēti augšupstraumes pielāgojumi).
OMNIROUTE_PAYLOAD_RULES_RELOAD_MS 5000 open-sse/services/payloadRules.ts Pārlādes intervāls (ms) lietderīgās slodzes kārtulu faila dinamiskai pārlādēšanai. Minimums 1000.
OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS false open-sse/services/model.ts Izvēles iestatījums: maršrutēt Claude Code klientu modeļu ID bez prefiksa claude-* caur Claude Code OAuth kontu, nevis pieprasīt nodrošinātāja prefiksu. Skaidri norādītiem nodrošinātāja prefiksiem joprojām ir priekšroka. Konfigurējams arī ar slēdzi Claude nodrošinātāja lapas informācijas panelī.
COMBO_CONCURRENCY_PER_MODEL 3 open-sse/services/comboConfig.ts Vienlaicīguma ierobežojums katram modelim cikliskās secības kombinācijām (#9100). Cikliskās secības kombināciju semaforam bija stingrs 3 vienlaicīgu pieprasījumu ierobežojums katram modelim bez iespējas to mainīt, tādēļ lielākas vienlaicīguma pakāpes datplūsma tika apstrādāta secīgi aiz šī ierobežojuma. Validēts kā >= 1, ierobežots līdz <= 32.
DISABLE_CONTEXT_WINDOW_CHECKS false open-sse/handlers/chatCore.ts Bīstams izvēles iestatījums, kas tiešiem viena modeļa pieprasījumiem izlaiž OmniRoute lokālo konteksta loga / maksimālā ievades marķieru skaita pārbaudi. Augšupstraumes nodrošinātāji joprojām piemēro savus faktiskos ierobežojumus; uzvednes saspiešana un paša modeļa izvades marķieru ierobežojums paliek aktīvs. Spēkā esošā prioritāte ir funkciju karogu datubāzes ignorēšana > vides mainīgais > noklusējums; restartēšana nav nepieciešama.
OMNIROUTE_DISABLE_CONVERSATION_TRACKING (nav iestatīts) open-sse/services/conversationTracker.ts Iestatiet 1, lai pārtrauktu sarunu vēstures apkopošanu. resolveConversationId() atgriež neizsekotu rezultātu, pirms tā nolasa SQLite vai parsē ziņojumu vēsturi, un tas attiecas arī uz klienta norādītiem sesiju ID. Maršrutēšanas sesiju apstrāde nemainās, un esošie ieraksti netiek dzēsti. Paredzēts izvietojumiem, kuri neizmanto informācijas paneļa sarunu skatu un vēlas apturēt kārtu tabulas palielināšanos.

7. URL adreses un mākoņa sinhronizācija

Mainīgais Noklusējuma vērtība Avota fails Apraksts
BASE_URL http://localhost:20128 src/lib/cloudSync.ts Servera puses URL, ko iekšējie sinhronizācijas uzdevumi izmanto, lai izsauktu /api/sync/cloud. Saglabājiet to kā atgriezeniskās cilpas/konteinera URL pat tad, ja lietotne ir publiski pieejama, izmantojot starpniekserveri.
CLOUD_URL (tukšs) src/lib/cloudSync.ts Mākoņa retranslācijas galapunkta URL (premium funkcija).
CLOUD_SYNC_TIMEOUT_MS 12000 src/lib/cloudSync.ts HTTP noildze mākoņa sinhronizācijas pieprasījumiem.
OMNIROUTE_BUILD_PROFILE full Webpack būvējuma konfigurācija Būvēšanas laika profils (iestatiet uz minimal, lai fiziski izslēgtu privileģētos moduļus no pakotnes).
OMNIROUTE_STANDALONE_DIR .build/ savrupais izvades direktorijs scripts/build/colocate-standalone.mjs Būvēšanas laika pārrakstīšana savrupajam izvades direktorijam, ko izmanto pēcbūvēšanas kopizvietošanas darbība. Tas nav izpildlaika iestatījums.
OMNIROUTE_CLOUD_SYNC_SECRET (tukšs) src/lib/cloudSync.ts Koplietots noslēpums, ko izmanto, lai pārbaudītu mākoņa sinhronizācijas atbilžu HMAC-SHA256 parakstu.
OMNIROUTE_CLOUD_SYNC_SECRETS false src/lib/cloudSync.ts Iestatiet uz true, lai atļautu mākoņa sinhronizācijas galapunktam pārrakstīt lokālos akreditācijas datus. Noklusējuma vērtība ir false.
OMNIROUTE_CLOUD_SYNC_ENFORCE_SIGNATURE false src/lib/cloudSync.ts Iestatiet uz true, lai noraidītu neparakstītu mākoņa sinhronizācijas atbildi, ja nav konfigurēts lokāls noslēpums (#13679). Esošs paraksts vienmēr tiek pārbaudīts un vienmēr tiek noraidīts, ja OMNIROUTE_CLOUD_SYNC_SECRET nav iestatīts, neatkarīgi no šī karoga. Sākot ar v3.9, pārbaude pēc noklusējuma būs obligāta.
OMNIROUTE_ZED_IMPORT_LEGACY_ONE_STEP false src/app/api/providers/zed/import/route.ts Iestatiet uz true, lai bez lietotāja apstiprinājuma atgrieztos pie v3.8.5 vienas darbības „importēt visu” darbības.
NEXT_PUBLIC_BASE_URL http://localhost:20128 OAuth, informācijas panelis, sinhronizācija Publiski pieejams URL OAuth redirect_uri, informācijas paneļa saitēm un ģenerētajiem publiskajiem URL. Iestatiet to uz stabilu publisko URL, ja OAuth atzvaniem vai ģenerētajām pārlūkprogrammas saitēm jāizmanto kanonisks reversā starpniekservera resursdators.
NEXT_PUBLIC_CLOUD_URL (tukšs) Klienta puse CLOUD_URL klienta puses spoguļvērtība.
NEXT_PUBLIC_APP_URL (nav iestatīts) src/shared/services/cloudSyncScheduler.ts Mantotā atkāpšanās opcija mainīgajam NEXT_PUBLIC_BASE_URL.
OMNIROUTE_PUBLIC_BASE_URL (nav iestatīts) Publiskās izcelsmes atrisinātājs, attēlu URL Augstākās prioritātes pārlūkprogrammai paredzētā OmniRoute izcelsme, ko izmanto publisko URL ģenerēšanai un ārpus informācijas paneļa esošās pārlūkprogrammas izcelsmes validācijai. Iestatiet to, ja OpenWebUI vai cits relejs sasniedz OmniRoute, izmantojot iekšēju URL, bet lietotāja pārlūkprogrammai ģenerētais multivides saturs jāielādē no LAN, tuneļa vai publiskas izcelsmes. Neiekļaujiet /v1.
OMNIROUTE_PROVIDER_MANIFEST_URL (nav iestatīts) open-sse/config/providerPluginManifestUrl.ts Absolūts nodrošinātāja spraudņa manifesta URL, kas tiek paziņots blakusprocesa klientiem. Ja tas nav iestatīts, OmniRoute atvasina /api/v1/provider-plugin-manifest no pieprasījuma izcelsmes vai HOST/PORT.
OMNIROUTE_PUBLIC_PROTOCOL http open-sse/config/providerPluginManifestUrl.ts Protokols, ko izmanto, atvasinot nodrošinātāja spraudņa manifesta URL no HOST/PORT bez pieprasījuma izcelsmes. Iestatiet uz https, ja tiek izmantots publisks starpniekserveris, kas terminē TLS, un nav iestatīts nepārprotams OMNIROUTE_PROVIDER_MANIFEST_URL.
OMNIROUTE_TRUST_PROXY (nav iestatīts) src/server/origin/publicOrigin.ts Neobligāts uzticamības režīms pārsūtītajām publiskās izcelsmes galvenēm. Nav iestatīts = drošības lēmumiem neuzticēties Forwarded / X-Forwarded-*. true / loopback uzticas pārsūtītajam resursdatoram/protokolam tikai no ar marķieri apzīmogota atgriezeniskās cilpas starpniekservera. private / lan uzticas arī privātā LAN starpniekserveru vienādranga mezgliem. Produkcijas vidē dodiet priekšroku nepārprotamam NEXT_PUBLIC_BASE_URL.
KIE_CALLBACK_URL (nav iestatīts) open-sse/utils/kieTask.ts Publisks atzvanīšanas URL asinhroniem kie.ai darbiem. Augstākās prioritātes pārrakstīšana pirms OMNIROUTE_KIE_CALLBACK_URL un OMNIROUTE_PUBLIC_URL.
OMNIROUTE_KIE_CALLBACK_URL (nav iestatīts) open-sse/utils/kieTask.ts Alternatīvs KIE_CALLBACK_URL pieraksts. Tiek izmantots kā atkāpšanās opcija, ja primārais mainīgais nav iestatīts.
OMNIROUTE_PUBLIC_URL (nav iestatīts) open-sse/utils/kieTask.ts Publiskā izcelsme, ko izmanto asinhrono atzvanīšanas URL izveidei. Zemākās prioritātes atkāpšanās opcija kie.ai atzvanīšanām; tiek izmantota arī kā vispārīgs publiskais URL citiem relejiem.
OMNIROUTE_CROF_USAGE_URL https://crof.ai/usage_api/ open-sse/services/usage.ts CrofAI kvotas uzmeklēšanas galapunkts, ko izmanto lapā Usage. Pārrakstiet relejiem / testa armatūrām.
OMNIROUTE_OPENCODE_QUOTA_URL https://opencode.ai/zen/go/v1/usage open-sse/services/opencodeQuotaFetcher.ts Oficiālais ar API atslēgu autentificētais OpenCode Go lietojuma galapunkts, ko izmanto lapā Usage. Pārrakstiet relejiem / testa armatūrām.
OPENCODE_SYNTHESIZE_CLI_HEADERS true open-sse/executors/opencode.ts Sintezē OpenCode CLI identitātes galvenes (User-Agent, x-opencode-client/project, pieprasījuma/sesijas UUID) opencode-go/zen augšupstraumes pieprasījumiem, kurus klients nav nosūtījis, lai Cloudflare tos pieņemtu VPS izejošajā trafikā (#6210/#5997). Pēc noklusējuma ieslēgts kopš #10571; atspējojiet ar false/0/no/off.
OPENCODE_USER_AGENT opencode open-sse/executors/opencode.ts Noklusējuma User-Agent, ko izmanto, ja OPENCODE_SYNTHESIZE_CLI_HEADERS ir ieslēgts un nav iestatīta katram nodrošinātājam paredzēta <PROVIDER>_USER_AGENT pārrakstīšana. Tiek lietots tikai opencode izpildītājiem.
OPENCODE_CLIENT desktop open-sse/executors/opencode.ts Sintezētās x-opencode-client galvenes vērtība, ja OPENCODE_SYNTHESIZE_CLI_HEADERS ir ieslēgts.
OPENCODE_PROJECT global open-sse/executors/opencode.ts Sintezētās x-opencode-project galvenes vērtība, kad ir ieslēgts OPENCODE_SYNTHESIZE_CLI_HEADERS.
OMNIROUTE_OLLAMA_CLOUD_USAGE_URL https://ollama.com/settings open-sse/services/usage.ts Ollama Cloud iestatījumu URL, ko izmanto kvotas datu iegūšanai. Mainiet to relejiem/testu datiem.
OLLAMA_USAGE_COOKIE (nav iestatīts) open-sse/services/usage.ts Ollama Cloud __Secure-session sīkfails, ko izmanto kvotas datu iegūšanai no iestatījumu lapas. Sensitīvs; ja ir konfigurēti vairāki konti, ieteicams izmantot katram savienojumam paredzēto informācijas paneļa lauku.
OLLAMA_CLOUD_USAGE_COOKIE (nav iestatīts) open-sse/services/usage.ts Alternatīvs Ollama Cloud __Secure-session sīkfaila vides mainīgais. Sensitīvs; ja ir konfigurēti vairāki konti, ieteicams izmantot katram savienojumam paredzēto informācijas paneļa lauku.
OMNIROUTE_OLLAMA_USAGE_COOKIE (nav iestatīts) open-sse/services/usage.ts Alternatīvs Ollama Cloud __Secure-session sīkfaila vides mainīgais, kas tiek izmantots pirms īsākajiem aizstājvārdiem. Sensitīvs; ja ir konfigurēti vairāki konti, ieteicams izmantot katram savienojumam paredzēto informācijas paneļa lauku.
OMNIROUTE_CODEWHISPERER_BASE_URL https://codewhisperer.us-east-1.amazonaws.com open-sse/services/usage.ts CodeWhisperer (AWS Kiro) lietojuma ierobežojumu galapunkts. Mainiet to relejiem/testu datiem.

Important

Izvietojot aiz reversā starpniekservera (nginx, Caddy), iestatiet NEXT_PUBLIC_BASE_URL uz savu stabilo publisko URL (piemēram, https://omniroute.example.com), ja OAuth atzvaniem vai ģenerētajām publiskajām saitēm jāizmanto šis resursdatora nosaukums. Bez tā OAuth atzvani var neizdoties, jo redirect_uri nesakritīs, un ģenerētās publiskās saites var norādīt uz iekšējā konteinera izcelsmi.

Saglabājiet BASE_URL kā iekšēju atgriezeniskās cilpas/konteinera URL darbiem starp serveriem. Iekšējām pašizguvēm, kas ietver akreditācijas datus, neizmantojiet pārlūka Origin vai publisku resursdatora nosaukumu.

Autentificētiem informācijas paneļa rakstīšanas pieprasījumiem nav nepieciešams statisks publiskais bāzes URL: informācijas panelis sūta tās pašas izcelsmes nedrošos pieprasījumus ar sesijai piesaistītu CSRF marķieri. OmniRoute joprojām centralizē publiskās izcelsmes validāciju pārlūka integrācijām, kas nav saistītas ar informācijas paneli: vispirms tiek uzticēti skaidri norādītie publiskā URL vides mainīgie; neapstrādātas Forwarded / X-Forwarded-* galvenes tiek ignorētas, ja vien nav iespējots OMNIROUTE_TRUST_PROXY un tiešais starpniekservera mezgls nav ar marķieri atzīmēts kā uzticams. Neizmantojiet CORS iestatījumus, lai labotu tās pašas izcelsmes informācijas paneļa pieprasījumus; CORS ir paredzēts tikai citas izcelsmes pārlūka klientiem.


8. Izejošais starpniekserveris

Novirziet izsaukumus uz ārējiem LLM nodrošinātājiem caur HTTP vai SOCKS5 starpniekserveri, lai kontrolētu izejošo datplūsmu, veiktu ģeogrāfisko maršrutēšanu vai maskētu IP adresi.

Mainīgais Noklusējums Avota fails Apraksts
ENABLE_SOCKS5_PROXY true open-sse/executors Iespējo SOCKS5 starpniekservera aģentu ārējiem izsaukumiem. Lai atteiktos, iestatiet false.
NEXT_PUBLIC_ENABLE_SOCKS5_PROXY true Klienta puse Klienta puses informētība par SOCKS5 pieejamību.
PROXY_SKIP_RECENTLY_FAILED false src/shared/utils/featureFlags.ts Izvēles funkcionalitātes karogs (skatiet FEATURE_FLAGS.md; informācijas paneļa DB pārrakstīšana ir prioritāra). Starpniekserveru pūli un rotācija katram kontam uz laiku pārtrauc atkārtoti izmantot elementu, kam tikko radās kļūme (noraidīta TCP pārbaude vai caur to saņemts 429); šis periods pēc katras atkārtotas kļūmes divkāršojas līdz noteiktai robežai. To iespējo true (vai 1, yes).
HTTP_PROXY (nav iestatīts) Node.js standarts HTTP starpniekserveris ārējiem izsaukumiem.
HTTPS_PROXY (nav iestatīts) Node.js standarts HTTPS starpniekserveris ārējiem izsaukumiem.
ALL_PROXY (nav iestatīts) Node.js standarts Universāls starpniekserveris (atbalsta socks5://).
OMNIROUTE_PROXY_ECHO_URL (nav iestatīts) src/lib/proxyEchoTarget.ts Piesaista starpniekservera izejošās datplūsmas pārbaužu atbalss IP mērķi vienam URL. Ja nav iestatīts, pārbaude vispirms mēģina api64.ipify.org, pēc tam api4.ipify.org, lai tikai IPv4 tuneļi netiktu kļūdaini uzskatīti par nedarbojošiem (#9694).
NO_PROXY (nav iestatīts) Node.js standarts Ar komatiem atdalīti resursdatoru nosaukumi/IP adreses, kam jāapiet starpniekserveris.
OMNIROUTE_PROXY_DISPATCHER_CONNECTIONS 32 open-sse/utils/proxyDispatcher.ts Maksimālais vienlaicīgo ligzdu skaits katram kešotajam HTTP/SOCKS starpniekservera dispečeram. Ilglaicīgām SSE straumēm, piemēram, Codex /v1/responses, nepieciešams vairāk nekā viens savienojums, ja vairāki pieprasījumi koplieto vienu konta līmeņa starpniekserveri. Vērtībām virs 256 tiek piemērots ierobežojums.
SOCKS_HANDSHAKE_TIMEOUT_MS 10000 open-sse/utils/socksConnectorWithFamily.ts SOCKS5 rokasspiediena (savienojuma izveides) taimauts milisekundēs. Palieliniet to, ja vienam dzīvojamo IP vārtejas resursdatoram ir liela vienlaicīgā slodze (piemēram, 100 vienlaicīgi pieprasījumi) — pārslogotā pūlā faktiskais rokasspiediens var ilgt vairāk nekā 10 s, pat ja starpniekserveris ir sasniedzams; pretējā gadījumā kļūdaini tiek parādīts [Proxy Fast-Fail] Proxy unreachable. Ierobežots līdz 120000.
PROXY_FAIL_OPEN false src/sse/handlers/chatHelpers.ts Ja vērtība ir false (noklusējums), pieprasījums, kura piešķirto starpniekserveri neizdodas atrisināt, tiek noraidīts (slēgta atteice), nevis pārslēgts uz tiešu savienojumu — tas novērš īstās IP adreses noplūdi. Iestatiet true, lai atjaunotu iepriekšējo DIRECT atkāpšanās mehānismu.
ENABLE_TLS_FINGERPRINT false open-sse/executors Vilto TLS ciparnospiedumu, izmantojot wreq-js (atdarina Chrome 124). Novērš JA3/JA4 bloķēšanu.
TLS_FINGERPRINT_PROVIDERS (nav iestatīts) open-sse/utils/proxyFetch.ts Ar komatiem atdalīts pakalpojumu sniedzēju atļauto vienumu saraksts jaunajai starpniekota TLS maršrutēšanai (open-sse/utils/proxyFetch.ts). Ja vērtība nav iestatīta, tiešais TLS saglabā savu iepriekšējo darbību; tikai šie pakalpojumu sniedzēji tiek maršrutēti caur Chrome-124 ciparnospieduma tiltu.
OMNIROUTE_TURNSTILE_IGNORE_TLS_ERRORS false open-sse/services/claudeTurnstileSolver.ts Ļauj Claude Turnstile Playwright pārlūkprogrammas kontekstam ignorēt HTTPS sertifikāta kļūdas.

Scenāriji

Scenārijs Konfigurācija
SOCKS5 caur SSH tuneli ALL_PROXY=socks5://127.0.0.1:7890, ENABLE_SOCKS5_PROXY=true
Korporatīvais HTTP starpniekserveris HTTP_PROXY=http://proxy.corp.com:3128, HTTPS_PROXY=http://proxy.corp.com:3128, NO_PROXY=localhost,internal.corp.com
Aizsardzība pret ciparnospiedumu noteikšanu ENABLE_TLS_FINGERPRINT=true — nepieciešams wreq-js (iekļauts)
Kontrolēta izejošā trafika vide / nav tiešas piekļuves Atstājiet PROXY_FAIL_OPEN=false (noklusējums). Ja starpniekserveris nav pieejams, pieprasījumi tiek pārtraukti ar kļūdu, nevis nopludināti pa tiešo savienojumu.
Mantotā / izstrādes vide — atļaut tiešo atkāpšanos PROXY_FAIL_OPEN=true. Atjauno darbību pirms drošības pastiprināšanas: ja starpniekservera noteikšana neizdodas, tiek izmantots tiešais savienojums.

Piezīme (NVIDIA validācijas apiešana — #3226): NVIDIA API atslēgas validācijas galapunkts pārstāj reaģēt, ja tas tiek maršrutēts caur globālo starpniekserveri/TLS modificēto fetch (undici dispečers → 504). src/lib/providers/validation.ts::directHttpsRequest() apzināti apiet starpniekservera modifikāciju šim vienīgajam validācijas izsaukumam, izmantojot safeOutboundFetch({ bypassProxyPatch: true }). Tas ir dokumentēts, ierobežota tvēruma izņēmums — tas neietekmē tērzēšanas/lietošanas izejošo trafiku. Apiešanas tvērumu ierobežo tests/unit/proxy-bypass-scope-guard-3226.test.ts.


9. CLI rīku integrācija

Nosaka, kā OmniRoute atrod un palaiž CLI blakusprocesus (Claude Code, Codex u. c.).

Mainīgais Noklusējuma vērtība Avota fails Apraksts
CLI_MODE auto src/shared/services/cliRuntime.ts auto = meklēt sistēmas PATH; manual = izmantot tikai skaidri norādītus ceļus.
CLI_EXTRA_PATHS (nav iestatīts) src/shared/services/cliRuntime.ts Papildu PATH ieraksti CLI bināro failu atrašanai (atdalīti ar koliem).
CLI_CONFIG_HOME (nav iestatīts) src/shared/services/cliRuntime.ts Pārraksta mājas direktoriju, ko izmanto CLI konfigurāciju (~/.claude, ~/.codex) lasīšanai. Tai jābūt absolūtai un jāatrodas procesa mājas direktorijā — vai konteinerā jābūt ceļam, kas piesaistīts ar bind mount (tā darbojas /host-home). Visos citos gadījumos tiek izmantots mājas direktorijs.
CLI_ALLOW_CONFIG_WRITES true src/shared/services/cliRuntime.ts Ļauj OmniRoute rakstīt CLI konfigurācijas failos (pilnvaras atsvaidzināšana, sesijas dati). Iestatiet uz false, lai katrs mēģinājums rakstīt CLI konfigurācijā beigtos ar nepārprotamu kļūdu „rakstīšana atspējota”.
CLI_CLAUDE_BIN claude src/shared/services/cliRuntime.ts Pielāgots ceļš uz Claude CLI bināro failu.
CLI_CODEX_BIN codex src/shared/services/cliRuntime.ts Pielāgots ceļš uz Codex CLI bināro failu.
CLI_DROID_BIN droid src/shared/services/cliRuntime.ts Pielāgots ceļš uz Droid CLI bināro failu.
CLI_OPENCLAW_BIN openclaw src/shared/services/cliRuntime.ts Pielāgots ceļš uz OpenClaw CLI bināro failu.
CLI_CURSOR_BIN agent, pēc tam cursor src/shared/services/cliRuntime.ts Pielāgots ceļš uz Cursor aģenta bināro failu. Ja tas nav norādīts, noteikšana vispirms izmēģina agent un pēc tam izmanto cursor.
CLI_CLINE_BIN cline src/shared/services/cliRuntime.ts Pielāgots ceļš uz Cline CLI bināro failu.
CLI_5DIVE_BIN 5dive src/shared/services/cliRuntime.ts Pielāgots ceļš uz 5dive CLI bināro failu.
CLI_5DIVE_STATE_DIR /var/lib/5dive src/shared/services/cliRuntime.ts 5dive sistēmas stāvokļa direktorijs (root piederoši autentifikācijas profili); atbilst 5dive paša STATE_DIR noklusējuma vērtībai.
CLI_CONTINUE_BIN cn src/shared/services/cliRuntime.ts Pielāgots ceļš uz Continue CLI bināro failu.
CLI_QODER_BIN qodercli src/shared/services/cliRuntime.ts Pielāgots ceļš uz Qoder CLI bināro failu.
CLI_QWEN_BIN qwen src/shared/services/cliRuntime.ts Pielāgots ceļš uz Qwen Code CLI bināro failu.
CLI_AIDER_BIN aider src/shared/services/cliRuntime.ts Pielāgots ceļš uz Aider CLI bināro failu.
CLI_GOOSE_BIN goose src/shared/services/cliRuntime.ts Pielāgots ceļš uz Goose CLI bināro failu.
CLI_GEMINI_BIN gemini src/shared/services/cliRuntime.ts Pielāgots ceļš uz Google Gemini CLI bināro failu — tikai servera puses noteikšanai un darbspējas pārbaudēm; omniroute run gemini atrod gemini bināro failu sistēmas PATH.
CLI_KILO_BIN kilocode src/shared/services/cliRuntime.ts Pielāgots ceļš uz Kilo Code CLI bināro failu.
CLI_OPENCODE_BIN opencode src/shared/services/cliRuntime.ts Pielāgots ceļš uz OpenCode CLI bināro failu.
CLI_HERMES_BIN hermes src/shared/services/cliRuntime.ts Pielāgots ceļš uz Hermes bināro failu. Kopīgs abiem kataloga ierakstiem (hermes un hermes-agent).
CLI_FORGE_BIN forge src/shared/services/cliRuntime.ts Pielāgots ceļš uz ForgeCode CLI bināro failu.
CLI_JCODE_BIN jcode src/shared/services/cliRuntime.ts Pielāgots ceļš uz jcode CLI bināro failu.
CLI_DEEPSEEK_TUI_BIN deepseek-tui src/shared/services/cliRuntime.ts Pielāgots ceļš uz DeepSeek TUI bināro failu.
CLI_CODEWHALE_BIN codewhale src/shared/services/cliRuntime.ts Pielāgots ceļš uz CodeWhale CLI bināro failu.
CLI_SMELT_BIN smelt src/shared/services/cliRuntime.ts Pielāgots ceļš uz Smelt CLI bināro failu.
CLI_PI_BIN pi src/shared/services/cliRuntime.ts Pielāgots ceļš uz Pi (pi-coding-agent) bināro failu.
CLI_CRUSH_BIN crush src/shared/services/cliRuntime.ts Pielāgots ceļš uz Crush CLI bināro failu.
CLI_OMP_BIN omp src/shared/services/cliRuntime.ts Pielāgots ceļš uz Oh My Pi (omp) aģenta bināro failu.
CLI_LETTA_BIN letta src/shared/services/cliRuntime.ts Pielāgots ceļš uz Letta CLI bināro failu.
CLI_PRIME_AGENT_BIN prime-agent src/shared/services/cliRuntime.ts Pielāgots ceļš uz Prime Agent (Prime Intellect) bināro failu.
CLI_WINDSURF_BIN (nav) src/shared/services/cliRuntime.ts Pielāgots ceļš uz Windsurf bināro failu. Windsurf tiek piegādāts bez noklusējuma komandas — binārā faila noteikšana paliek atspējota, līdz šī vērtība tiek iestatīta.
CLI_DEVIN_BIN devin open-sse/executors/devin-cli.ts Pielāgots ceļš uz Devin CLI bināro failu (v3.8.0). To izmanto Windsurf/Devin izpildītājs.
DEVIN_DESKTOP_VERSION 3.6.27 open-sse/executors/devin-desktop.ts Devin Desktop ide_version. Pārrakstīšanas vērtībām jāizmanto formāts x.y.z; nederīgu vērtību gadījumā tiek izmantota pārbaudītā noklusējuma vērtība.
DEVIN_DESKTOP_EXTENSION_VERSION 1.48.2 open-sse/executors/devin-desktop.ts Komplektā iekļautā Codeium/language-server extension_version, kas atšķiras no Desktop ide_version. Pārrakstīšanas vērtībām jāizmanto x.y.z; nederīgu vērtību gadījumā tiek izmantota komplektā iekļautā noklusējuma vērtība.
CLI_DEVIN_AGENTIC_BIN devin open-sse/executors/devin-cli-agentic.ts Tikai aģentiskajam tiltam paredzēta Devin CLI pārrakstīšanas vērtība. Izpildītājs pieņem tikai lokālo ACP stdio augšupstraumi.
DEVIN_AGENTIC_HOME (obligāts) open-sse/executors/devin-cli-agentic.ts Absolūts izolēts mājas direktorijs aģentiskajam Devin apakšprocesam; pieņemtie tilta ceļi ir /home/bridge un uzdevuma lokālie .sandbox ceļi (operētājsistēmā Windows — C:\...\.sandbox\...).
DEVIN_AGENTIC_ACP_TIMEOUT_MS 120000 open-sse/executors/devin-cli-agentic.ts Viena Devin ACP cikla maksimālais ilgums, pirms tilts pārtrauc bērnprocesu un atgriež nepārprotamu taimautu.
DEVIN_BRIDGE_MODEL devin-cli-agentic/swe-1-7 docker/devin-bridge/compose.yml Galvenais Claude Code modeļa aizstājvārds izolētajam tiltam. Aktīvā testēšanas vide piemēru aizstāj ar modeli, ko atgriež pašreizējais Devin konts.
DEVIN_BRIDGE_SONNET_MODEL DEVIN_BRIDGE_MODEL docker/devin-bridge/compose.yml Izolētā tilta aizstājvārds, ko izmanto, kad Claude Code pieprasa savu noklusējuma Sonnet modeli.
DEVIN_BRIDGE_OPUS_MODEL DEVIN_BRIDGE_MODEL docker/devin-bridge/compose.yml Izolētā tilta aizstājvārds, ko izmanto, kad Claude Code pieprasa savu noklusējuma Opus modeli.
DEVIN_BRIDGE_HAIKU_MODEL DEVIN_BRIDGE_MODEL docker/devin-bridge/compose.yml Izolētā tilta aizstājvārds, ko izmanto, kad Claude Code pieprasa savu noklusējuma Haiku modeli.
DEVIN_BRIDGE_SUBAGENT_MODEL DEVIN_BRIDGE_MODEL docker/devin-bridge/compose.yml Izolētā tilta aizstājvārds, ko izmanto Claude Code apakšaģentiem.
DEVIN_SEAT_API_URL https://server.codeium.com open-sse/services/usage/devinCli.ts Neobligāta Codeium licenču pārvaldības API pārrakstīšana, ko izmanto Devin CLI kvotai (GetUserStatus).
AUGGIE_BIN auggie open-sse/executors/auggie.ts Absolūtā ceļa pārrakstīšana Augment (Auggie) CLI binārajam failam, ko izmanto lokālais auggie nodrošinātājs. Ja nav norādīts, izmanto CLI_AUGGIE_BIN, pēc tam veic meklēšanu PATH.
CLI_AUGGIE_BIN auggie open-sse/executors/auggie.ts Alternatīva Augment (Auggie) CLI binārā faila ceļa pārrakstīšana (tiek pārbaudīta pēc AUGGIE_BIN).
ZCODE_BIN zcode open-sse/executors/zcode.ts Binārais fails, ko izmanto lokālā zcode nodrošinātāja stdio klients. Ja nav norādīts, izmanto zcode no PATH.
ZCODE_ARGS open-sse/executors/zcode.ts JSON masīvs (≤16 virknes) ar papildu argumentiem, kas tiek nodoti zcode binārajam failam, kad tas tiek palaists, izmantojot cliTools.
ZCODE_CWD process.cwd() open-sse/executors/zcode.ts Darba direktorijs ZCode lietojumprogrammu servera apakšprocesam.
ZCODE_PROVIDER_ID builtin:zai-coding-plan open-sse/executors/zcode.ts Lietojumprogrammu serverim nosūtītā nodrošinātāja ID pārrakstīšana.
ZCODE_SERVER_RUNTIME_ROOT ~/.zcode/server open-sse/executors/zcode.ts ZCode lietojumprogrammu servera izpildlaika saknes direktorijs (kur atrodas komplektā iekļautie node un zcode-server.cjs).
ZCODE_SERVER_NODE <runtimeRoot>/node open-sse/executors/zcode.ts Node izpildāmais fails, ko izmanto ZCode lietojumprogrammu servera darbināšanai.
ZCODE_SERVER_ENTRY <runtimeRoot>/zcode-server.cjs open-sse/executors/zcode.ts Lietojumprogrammu servera ieejas skripts, ko izmanto ZCode servera darbināšanai.
ZCODE_STARTUP_TIMEOUT_MS 10000 open-sse/executors/zcode.ts Palaišanas taimauts (ms), pēc kura ZCode lietojumprogrammu servera palaišana tiek uzskatīta par neveiksmīgu.
ZCODE_RPC_TIMEOUT_MS 30000 open-sse/executors/zcode.ts Katra pieprasījuma RPC taimauts (ms) ZCode lietojumprogrammu servera izsaukumam.
ZCODE_TURN_TIMEOUT_MS 120000 open-sse/executors/zcode.ts Viena ZCode gājiena maksimālais ilgums (ms), pirms uzraugs to pārtrauc taimauta dēļ.
ZCODE_POLL_INTERVAL_MS 250 open-sse/executors/zcode.ts Aptaujas intervāls (ms), lai pārbaudītu ZCode gājiena pabeigšanu.
HERMES_HOME ~/.hermes src/lib/cli-helper/config-generator/hermesHome.ts Hermes Agent mājas direktorijs, kurā OmniRoute lasa/raksta Hermes CLI konfigurāciju. Atbilst vides mainīgajam, ko Hermes PowerShell instalētājs iestata sistēmā Windows (%LOCALAPPDATA%\hermes).

CLI profilu automātiskā sinhronizācija

Šie funkciju karodziņi ir brīvprātīgi jāiespējo, un pēc noklusējuma tie ir izslēgti. Tos var arī pārslēgt CLI Code informācijas panelī.

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_AUTO_SYNC_CODEX_PROFILES false src/shared/constants/featureFlagDefinitions.ts Pēc nodrošinātāja modeļu sinhronizācijas automātiski pārraksta ~/.codex/*.config.toml profilu failus no aktuālā kataloga. Nepieciešams CLI_ALLOW_CONFIG_WRITES; nekad nemaina aktīvo/noklusējuma Codex konfigurāciju, autentifikāciju, Codex-lb iestatījumus vai nodrošinātāja izvēli.
OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES false src/shared/constants/featureFlagDefinitions.ts Pēc nodrošinātāja modeļu sinhronizācijas automātiski pārraksta ~/.claude/profiles/<name>/settings.json Claude Code profilu failus no aktuālā kataloga. Nepieciešams CLI_ALLOW_CONFIG_WRITES; nekad nemaina aktīvo/noklusējuma Claude konfigurāciju, autentifikāciju vai nodrošinātāja izvēli.

Docker piemērs

# Piemontējiet resursdatora bināros failus konteinerā un norādiet OmniRoute, kur tie atrodas:
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 stājas spēkā tikai tad, ja ceļš faktiski ir saistīti montēts no resursdatora — izmantojiet to kopā ar tādiem montējumiem kā ~/.codex:/host-home/.codex:rw (skatiet host profilu failā docker-compose.yml). Ceļš, kas neatrodas ne konteinera lietotāja mājas direktorijā, ne saistītajā montējumā, tiek ignorēts, jo tajā veiktās izmaiņas tiktu zaudētas, atkārtoti izveidojot konteineru.

Attēls darbojas kā USER node, tādēļ nemontēts /root nav derīga aizstāšanas vērtība.

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_CONTAINER (automātiski) src/shared/utils/containerEnv.ts Piespiedu kārtā ieslēdziet (1/true) vai izslēdziet (0/false) konteinera noteikšanu. Nepieciešams tikai izpildvidēs, kuras automātiskā noteikšana neatpazīst.
OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE false src/shared/services/cliRuntime.ts Atļaujiet CLI rīka konfigurācijas ierakstīšanu nemontētā konteinera ceļā. CLI ekvivalents ir --allow-container-write.

CLI binārā faila (omniroute) palīgrīki

Šie mainīgie pielāgo paša omniroute CLI binārā faila darbību (nevis iepriekš aprakstīto blakusprocesa noteikšanu).

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_LANG (sistēma) bin/cli/i18n.mjs Piespiedu kārtā iestata CLI izvades valodu. BCP-47 lokalizācija (piem., en, pt-BR). Ignorē sistēmas lokalizācijas vides mainīgos (LC_ALL, LC_MESSAGES).
OMNIROUTE_SHOW_LOG (nav iestatīts) bin/cli/runtime/processSupervisor.mjs Iestatiet uz 1, lai pārraudzītajā režīmā pārsūtītu servera stdout/stderr uz termināli. Atbilst omniroute serve karogam --log.
OMNIROUTE_CLI_TOKEN (nav iestatīts) bin/cli/api.mjs Mašīnas autentifikācijas pilnvara, kas tiek ievietota kā x-omniroute-cli-token galvene. Automātiski ģenerēta uzdevumā 8.12.
OMNIROUTE_HTTP_TIMEOUT_MS 30000 bin/cli/api.mjs Katra mēģinājuma HTTP noildze (ms) CLI → servera pieprasījumiem.
OMNIROUTE_READY_TIMEOUT_MS 60000 bin/cli/utils/pid.mjs Maksimālais laiks (ms), ko CLI gaida servera darbspējas galapunktu, pirms izdrukā noildzes brīdinājumu. Noder lēnas aukstās palaišanas gadījumos (piem., Windows). Var iestatīt arī ar --ready-timeout.
OMNIROUTE_VERBOSE 0 bin/cli/api.mjs Iestatiet uz 1, lai CLI komandu izpildes laikā stderr izdrukātu atkārtotu mēģinājumu/gaidīšanas intervālu diagnostiku.
OMNIROUTE_PLUGIN_PATH (nav iestatīts) bin/cli/plugins.mjs Pielāgots direktorijs CLI spraudņu atrašanai (omniroute-cmd-* pakotnes). Ja nav iestatīts, pēc noklusējuma izmanto ~/.omniroute/plugins/. Tikai CLI — tas nekad nenonāk servera puses spraudņu skenerī, kuru norāda OMNIROUTE_PLUGINS_DIR (2. sadaļa).

10. Iekšējā aģenta un MCP integrācijas

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_BASE_URL automātiska noteikšana open-sse/mcp-server/server.ts Tiešs URL, ar kuru MCP/A2A rīki var sasniegt OmniRoute. Aizstāj localhost automātisko noteikšanu.
OMNIROUTE_API_KEY (nav iestatīts) MCP/A2A moduļi API atslēga iekšējā MCP rīka un A2A prasmju izsaukumiem.
OMNIROUTE_API_KEY_ID (nav iestatīts) open-sse/mcp-server/audit.ts Atslēgas ID MCP audita žurnāla ierakstu attiecināšanai.
ROUTER_API_KEY (nav iestatīts) Mantotā funkcionalitāte Mantots OMNIROUTE_API_KEY aizstājvārds.
OMNIROUTE_A2A_HISTORY_RETENTION_DAYS 30 src/lib/a2a/taskManager.ts Dienu skaits, cik ilgi A2A uzdevumu vēsture tiek glabāta lokālajā datubāzē, pirms ikdienas tīrīšana izdzēš attiecīgo rindu. Ja vērtība nav iestatīta, nav skaitlis vai ir <= 0, tiek izmantota rezerves vērtība 30.
OMNIROUTE_A2A_MEMORY_HITS 1 src/lib/a2a/taskExecution.ts A2A atmiņas trāpījumu novērojamības funkcijas avārijas slēdzis. Iestatiet uz 0, lai uzdevumam pilnībā izlaistu atmiņas atsaukšanas uzmeklēšanu; jebkura cita vērtība (tostarp neiestatīta) saglabā šo funkciju iespējotu.
OMNIROUTE_ISSUE_AGENT_ENABLED false src/app/api/issue-agent/runs/route.ts Iespējo bezsaistes/lokālo Issue Agent ierakstītās sākotnējās izvērtēšanas galapunktu. Atstājiet atspējotu, ja vien netiek īpaši izpildītas lokālas ierakstītās sākotnējās izvērtēšanas darbplūsmas.
OMNIROUTE_ISSUE_AGENT_TIMEOUT_MS (nav iestatīts) src/lib/issueAgent/execution.ts Noildze (ms) vienai Issue Agent ierakstītās sākotnējās izvērtēšanas izpildei. Tā tiek ierobežota līdz iekšējam maksimumam; ja vērtība nav iestatīta vai nav derīga, tiek izmantota iebūvētā noklusējuma vērtība.
OMNIROUTE_CONTEXT (aktīvais konteksts) bin/cli/program.mjs, bin/cli/api.mjs CLI attālā režīma konteksts/profils omniroute komandām; aizstāj aktīvo kontekstu lokālajā kontekstu krātuvē. Ekvivalents opcijai --context <name>.
OMNIROUTE_CONTEXT_KEYCHAIN_DISABLED 0 bin/cli/contexts.mjs Atspējo neobligāto keytar operētājsistēmas atslēgu saišķa aizmugursistēmu CLI konteksta akreditācijas datiem. Kad tas ir iespējots, akreditācijas dati paliek config.json failā ar režīmu 0600, un CLI vienreiz parāda brīdinājumu par rezerves risinājuma izmantošanu; paredzēts apzinātai darbībai bez grafiskās saskarnes vai konteinerā.
OMNIROUTE_MCP_ENFORCE_SCOPES true open-sse/mcp-server/server.ts Piemēro tvērumos balstītu piekļuves kontroli MCP rīku izsaukumiem.
OMNIROUTE_MCP_SCOPES (visi) open-sse/mcp-server/server.ts Ar komatiem atdalīti tvērumi: admin, combos, health, models, routing, budget, metrics, pricing, memory, skills.
OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS false open-sse/mcp-server/descriptionCompressor.ts Saspiež MCP rīku aprakstus pirms manifesta serializēšanas. Iespējojošās vērtības: 1, true, on.
OMNIROUTE_MCP_DESCRIPTION_COMPRESSION rtk open-sse/mcp-server/descriptionCompressor.ts Saspiešanas algoritms/profils. Atspējojošās vērtības: 0, false, off.
OMNIROUTE_MCP_FETCH_TIMEOUT_MS 10000 open-sse/mcp-server/fetchTimeout.ts Pārtraukšanas laika ierobežojums (ms) MCP servera iekšējās pārvaldības nolasīšanas darbībām (veselības stāvoklis, noturība, kombinācijas, kvota, lietojums).
OMNIROUTE_MCP_UPSTREAM_TIMEOUT_MS 60000 open-sse/mcp-server/fetchTimeout.ts Pārtraukšanas laika limits (ms) MCP pārejām, kas gaida pakalpojumu sniedzēju (route_request, web_search, web_fetch).
OMNIROUTE_CORPUS_CACHE_SIZE 5 src/lib/localCorpus/configured.ts Maksimālais atmiņā kešoto lokālā korpusa indeksa instanču skaits (LRU, viena katram indeksētajam saknes direktorijam). Ierobežots līdz vismaz 1.
MODEL_SYNC_INTERVAL_HOURS 24 src/shared/services/modelSyncScheduler.ts Modeļu kataloga sinhronizācijas intervāls stundās.
PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES 70 src/lib/usage/providerLimits.ts Pakalpojumu sniedzēja ātruma ierobežojumu un kvotu aptaujas intervāls.
PROVIDER_LIMITS_SYNC_SPACING_MS 1500 src/lib/usage/providerLimits.ts Intervāls (ms) starp secīgiem OAuth kvotu pieprasījumiem masveida sinhronizācijā; OAuth savienojumu dati tiek iegūti pa vienam, lai izvairītos no strauja pieprasījumu pieplūduma augšupstraumes sistēmai. 0 to atspējo (vienlaicīga izpilde).
OMNIROUTE_QUOTA_FETCH_MIN_INTERVAL_MS 250 open-sse/services/quotaFetchThrottle.ts Minimālais intervāls (ms) starp secīgiem augšupstraumes kvotu pieprasījumiem katra pieprasījuma priekšpārbaudes/pārraudzības ceļā; sadala vienlaicīgos tīkla izsaukumus laikā, lai daudzi konti no vienas IP adreses neradītu strauju pieprasījumu pieplūdumu augšupstraumes sistēmai. Integrēts Codex (/wham/usage), DeepSeek, Bailian (abās pieprasījumu vietās), OpenCode un Crof kvotu izgūšanas komponentos (#6009, #6911). Vispārīgais usage.ts::getUsageForProvider maršrutēšanas ceļš (github/glm/minimax/nanogpt/xai/u.c.) vēl nav aptverts — tas tiek izsekots atsevišķi. Kešatmiņas trāpījumi netiek ietekmēti. 0 atspējo; ierobežots diapazonā 0..5000.
PROVIDER_LIMITS_POST_USAGE_REFRESH_DELAY_MS 5000 src/lib/usage/providerLimits.ts Aizkave (ms) pirms pakalpojumu sniedzēja ierobežojumu atsvaidzināšanas pēc reāla lietojuma notikuma, dodot augšupstraumes kvotu API laiku reģistrēt patēriņu.
OMNIROUTE_LOGIN_BROWSER_PATH automātiska noteikšana open-sse/services/adobeFireflyBrowserLogin.ts Absolūtais ceļš uz sistēmas Chrome vai Edge izpildāmo failu, kas tiek izmantots interaktīvai Adobe Firefly pierakstīšanai un atjaunošanai ārpus ekrāna.
ADOBE_FIREFLY_BROWSER_REFRESH iespējots open-sse/services/adobeFireflySession.ts Uztur IMS un pārlūkprogrammas riska stāvokli aktuālu, izmantojot kontam piesaistītas Chrome CDP sesijas. Iestatiet uz 0, lai atspējotu pārlūkprogrammas atjaunošanu.
ADOBE_FIREFLY_SESSION_DISK iespējots open-sse/services/adobeFireflySession.ts Saglabā atjaunotās Adobe sesijas direktorijā DATA_DIR starp procesa restartēšanas reizēm. Iestatiet uz 0, lai sesijas glabātu tikai atmiņā.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS 12000 open-sse/services/adobeFireflySession.ts Minimālais intervāls milisekundēs starp Adobe Firefly ģenerēšanas iesniegumiem; 0 atspējo intervālu.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS 15000 open-sse/services/adobeFireflySession.ts Papildu klusuma periods milisekundēs pēc katra trešā veiksmīgā Adobe iesnieguma.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS 8000 open-sse/services/adobeFireflyClient.ts Atkārtota mēģinājuma bāzes aizkave milisekundēs pēc pārejošām Adobe 408 atbildēm; apvienota ar iesniegumu intervāliem ne vairāk kā piecos mēģinājumos.
OMNIROUTE_DISABLE_BACKGROUND_SERVICES false src/instrumentation-node.ts Atspējo visus fona pakalpojumus (sinhronizāciju, cenu noteikšanu, modeļu atsvaidzināšanu). Noderīgi CI/testēšanai.
OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS (nav iestatīts) src/lib/config/runtimeSettings.ts Piespiedu kārtā iespējo fona uzdevumus, ja konstatēta automatizēta testēšana. Iestatiet 1, lai ignorētu testēšanas heiristiku.
OMNIROUTE_BUDGET_RESET_JOB_INTERVAL_MS 600000 src/lib/jobs/budgetResetJob.ts Budžeta atiestatīšanas pārbaudes periodiskums (ms). Minimālā vērtība ir 10000.
OMNIROUTE_CONNECTION_RECOVERY_INTERVAL_MS 60000 src/lib/quota/connectionRecovery.ts Proaktīvās savienojumu atdzišanas atkopšanas periodiskums (ms): atkārtoti validē savienojumus, kuru īslaicīgais rate_limited_until ir beidzies, ārpus pieprasījumu kritiskā izpildes ceļa. Minimums 5000.
OMNIROUTE_DISABLE_CONNECTION_RECOVERY false src/lib/quota/connectionRecovery.ts Atspējot proaktīvo savienojumu atdzišanas atkopšanas plānotāju (slinkā atkopšana funkcijā getProviderCredentials joprojām darbojas).
OMNIROUTE_REASONING_CACHE_CLEANUP_INTERVAL_MS 1800000 src/lib/jobs/reasoningCacheCleanupJob.ts Spriešanas kešatmiņas tīrīšanas periodiskums (ms). Minimums 60000.
OMNIROUTE_REASONING_MIN_BUDGET nav iestatīts (atspējots) open-sse/services/reasoningTokenBuffer.ts Izvēles minimums domāšanas modeļu izvades budžetiem: izsaucēja max_tokens diapazonā [256, minimums) tiek palielināts līdz minimumam (ievērojot modeļa izvades ierobežojumu). Nav iestatīts = klienta budžeti nekad netiek palielināti (#9507).
OMNIROUTE_LOG_EXPORT_CRON 0 * * * * src/lib/jobs/logExportJob.ts Cron izteiksme (UTC) izsaukumu žurnāla eksportēšanas uzdevumam, kas iztukšo katru iespējoto žurnāla eksportēšanas galamērķi.
OMNIROUTE_CONFIG_HOT_RELOAD_MS 5000 src/lib/config/hotReload.ts Konfigurācijas karstās pārlādes aptaujas intervāls (ms). Vērtības, kas mazākas par 1000, tiek noraidītas.
OMNIROUTE_DISABLE_REDIS_AUTH_CACHE (iespējots) src/lib/db/apiKeys.ts Iestatiet 1, lai apietu Redis API atslēgu autentifikācijas kešatmiņu (piespiedu kārtā veic datubāzes lasījumus).
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS 0 open-sse/services/compression/engines/rtk/filterLoader.ts Uzticēties lietotāju pārvaldītajiem RTK projektu filtru noteikumiem bez stingrām paraksta pārbaudēm.
OMNIROUTE_LITE_MAX_TOOL_LENGTH 2000 open-sse/services/compression/lite.ts Rakstzīmju ierobežojums Lite proaktīvai rīku rezultātu saīsināšanai, ja lite.maxToolLength nav iestatīts. Diapazons 2561000000. Informācijas paneļa iestatījumam ir priekšroka pār šo vides mainīgo.
OMNI_COMPRESSION_WORKERS 2 open-sse/services/compression/compressionWorkerPool.ts Maksimālais vienlaicīgo sinhrono RTK/Caveman darbprocesu skaits; papildu uzdevumi gaida FIFO secībā.
OMNI_COMPRESSION_WORKER_TIMEOUT_MS 120000 open-sse/services/compression/compressionWorkerPool.ts Katra uzdevuma noildze milisekundēs. Darbprocesi, kuriem iestājusies noildze, tiek pārtraukti, un pieprasījums kļūmes gadījumā tiek turpināts bez izmaiņām.
OMNI_COMPRESSION_WORKER_IDLE_MS 60000 open-sse/services/compression/compressionWorkerPool.ts Dīkstāves ilgums milisekundēs, pēc kura neizmantots saspiešanas darbprocess tiek pārtraukts.
COMPRESSION_PIPELINE_BREAKER_ENABLED false open-sse/services/compression/pipelineEngineBreaker.ts T02 vairākslāņu konveijera katra dziņa slēdža galvenais slēdzis. Izvēles funkcija (pēc noklusējuma izslēgta) — ja tā ir ieslēgta, dzinis, kas atkārtoti izraisa izņēmumu vairākos pieprasījumos, atdzišanas periodā tiek izlaists (kļūmes gadījumā turpinot darbu); izslēgts = baitos identiska mantotā darbība.
COMPRESSION_PIPELINE_BREAKER_THRESHOLD 3 open-sse/services/compression/pipelineEngineBreaker.ts Secīgu kļūmju skaits dažādos pieprasījumos, pēc kura atveras dziņa slēdzis.
COMPRESSION_PIPELINE_BREAKER_COOLDOWN_MS 30000 open-sse/services/compression/pipelineEngineBreaker.ts Laiks milisekundēs, cik ilgi atvērts dzinis tiek izlaists pirms daļēji atvērtas pārbaudes.
COMPRESSION_CCR_RETRIEVAL_RAMP_FACTOR 2 open-sse/services/compression/engines/ccr/index.ts T08/H8 CCR izgūšanas atgriezeniskās saites kāpums: katra iepriekšējā saglabātā bloka izgūšana lineāri palielina tā efektīvo minChars (bieži izgūts saturs tiek saspiests mazāk; >=3 izgūšanas reizes = nekad netiek saspiests). 1 atspējo kāpumu (bināra izlaišana tikai pie sliekšņa).
COMPRESSION_CCR_DURABLE_STORE true open-sse/services/compression/engines/ccr/index.ts CCR pastāvīgā bloku krātuve (#9061). Papildina atmiņas krātuvi ar SQLite, lai bloks saglabātos pēc LRU izstumšanas, TTL beigām, restartēšanas vai izgūšanas pieprasījuma nonākšanas citā instancē. Iestatiet false, lai blokus glabātu tikai atmiņā. Bloki, kas pārsniedz 512 KB, un mākoņa izpildvides neatkarīgi no šī iestatījuma izmanto tikai atmiņu.
COMPRESSION_PREFIX_FREEZE_ENABLED false open-sse/services/compression/prefixFreeze.ts T08/H5 lietojuma novērojumos balstītās prefiksa iesaldēšanas galvenais slēdzis. Pēc izvēles (pēc noklusējuma izslēgts) — ja tas ir ieslēgts, sistēmas uzvedne, kas novērota >= sliekšņa reižu skaitu, tiek uzskatīta par stabilu, kešojamu prefiksu un kompresijas laikā tiek saglabāta pat tiem nodrošinātājiem, kurus statiskā keša heiristika neaptver (iesaldēšana tikai saglabā, nekad nemodificē).
COMPRESSION_PREFIX_FREEZE_THRESHOLD 3 open-sse/services/compression/prefixFreeze.ts Sistēmas uzvednes novērojumu skaits, pirms tā tiek uzskatīta par iesaldētu, stabilu prefiksu.
OMNIROUTE_BOOTSTRAPPED false src/app/(dashboard)/dashboard/page.tsx Sākotnējās iestatīšanas laikā sāknēšanas skripts iestata vērtību true. Kontrolē iestatīšanas vedņa redzamību.
OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE 0 open-sse/executors/antigravity.ts Avārijas risinājums: ļauj pieprasījuma pamattekstam pārrakstīt Antigravity projekta lauku.
ANTIGRAVITY_CREDITS off open-sse/services/antigravityCredits.ts Google One AI kredītu politika: off nekad nepievieno kredītus, retry tos pievieno vienreiz pēc atbilstošas kvotas kļūdas 429, bet always tos pievieno pirmajam pieprasījumam.
ANTIGRAVITY_ALLOW_SIGNATURE_BYPASS 0 open-sse/translator/request/openai-to-gemini.ts Ļauj Antigravity pieprasījumu tulkotājam izlaist stingro CLI pieprasījuma paraksta validāciju, ja augšupstraumes pakalpojums noraida īstus parakstus (atkļūdošanas/novecojuša CLI režīms). Vērtība, kas nav nulle, iespējo apiešanu.
AGY_TOKEN_FILE ~/.gemini/antigravity-cli/antigravity-oauth-token src/app/api/providers/agy-auth/apply-local/route.ts Pārraksta Antigravity CLI (agy) pilnvaras faila ceļu automātiski noteiktās lokālās pieteikšanās importēšanai.

OAuth CLI tilts (iekšējs)

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_SERVER automātiska noteikšana src/lib/oauth/config/index.ts Servera URL CLI↔OmniRoute autentifikācijas tiltam.
OMNIROUTE_TOKEN (nav iestatīts) src/lib/oauth/config/index.ts Autentifikācijas pilnvara CLI tiltam.
OMNIROUTE_USER_ID cli src/lib/oauth/config/index.ts Lietotāja ID CLI tilta sesijām.
SERVER_URL (nav iestatīts) src/lib/oauth/config/index.ts Novecojis OMNIROUTE_SERVER aizstājvārds.
CLI_TOKEN (nav iestatīts) src/lib/oauth/config/index.ts Novecojis OMNIROUTE_TOKEN aizstājvārds.
CLI_USER_ID (nav iestatīts) src/lib/oauth/config/index.ts Novecojis OMNIROUTE_USER_ID aizstājvārds.

11. OAuth nodrošinātāju akreditācijas dati

Iebūvēti akreditācijas dati izstrādei localhost vidē. Attālinātām izvietošanām reģistrējiet savus datus katra nodrošinātāja izstrādātāju konsolē.

Mainīgais Nodrošinātājs Piezīmes
CLAUDE_OAUTH_CLIENT_ID Claude Code (Anthropic) Publisks klients — noslēpums nav nepieciešams.
CLAUDE_CODE_REDIRECT_URI Claude Code Novirzīšanas URI pārrakstīšana. Noklusējums: https://platform.claude.com/oauth/code/callback
CODEX_OAUTH_CLIENT_ID Codex / OpenAI Publisks klients.
GEMINI_OAUTH_CLIENT_ID Gemini (Google) Nepieciešams atbilstošs _SECRET.
GEMINI_OAUTH_CLIENT_SECRET Gemini (Google)
KIMI_CODING_OAUTH_CLIENT_ID Kimi Coding (Moonshot) Publisks klients.
ANTIGRAVITY_OAUTH_CLIENT_ID Antigravity (Google) Nepieciešams atbilstošs _SECRET.
ANTIGRAVITY_OAUTH_CLIENT_SECRET Antigravity (Google)
GITHUB_OAUTH_CLIENT_ID GitHub Copilot Publisks klients.
GHE_COPILOT_OAUTH_CLIENT_ID GHE Copilot Neobligāta GitHub Enterprise Copilot OAuth klienta ID pārrakstīšana. Ja nav iestatīts, tiek izmantota GITHUB_OAUTH_CLIENT_ID publiskā noklusējuma vērtība.
WINDSURF_API_KEY Windsurf / Devin (v3.8) Rezerves API atslēga, ko open-sse/executors/devin-cli.ts izmanto, ja nav pieejami konkrētā savienojuma akreditācijas dati. Neobligāta.
CLI_DEVIN_BIN Devin CLI (v3.8) Pielāgots ceļš uz Devin CLI bināro failu (devin). To nosaka open-sse/executors/devin-cli.ts.
GITLAB_DUO_OAUTH_CLIENT_ID GitLab Duo (v3.8) GitLab Duo OAuth klienta ID. Reģistrējiet lietotni vietnē https://gitlab.com/-/profile/applications, norādot novirzīšanas URI <NEXT_PUBLIC_BASE_URL>/callback un tvērumus api, read_user, openid, profile, email. Rezerves vērtība ir GITLAB_OAUTH_CLIENT_ID.
GITLAB_DUO_OAUTH_CLIENT_SECRET GitLab Duo (v3.8) GitLab Duo OAuth klienta noslēpums. Neobligāts — PKCE plūsmai noslēpums nav nepieciešams. Rezerves vērtība ir GITLAB_OAUTH_CLIENT_SECRET.
GITLAB_DUO_BASE_URL GitLab Duo (v3.8) GitLab bāzes URL pārrakstīšana (pašmitinātam GitLab). Noklusējums ir https://gitlab.com. Rezerves vērtība ir GITLAB_BASE_URL.
GITLAB_BASE_URL GitLab Duo (v3.8) Mantotā rezerves vērtība mainīgajam GITLAB_DUO_BASE_URL. Tiek izmantota, ja _DUO_ variants nav iestatīts.
GITLAB_OAUTH_CLIENT_ID GitLab Duo (v3.8) Mantotā rezerves vērtība mainīgajam GITLAB_DUO_OAUTH_CLIENT_ID, ko izmanto src/lib/oauth/constants/oauth.ts.
GITLAB_OAUTH_CLIENT_SECRET GitLab Duo (v3.8) Mantotā atkāpšanās opcija GITLAB_DUO_OAUTH_CLIENT_SECRET, ko izmanto src/lib/oauth/constants/oauth.ts.
QODER_OAUTH_CLIENT_SECRET Qoder
QODER_OAUTH_AUTHORIZE_URL Qoder Iestatiet, lai iespējotu Qoder OAuth.
QODER_OAUTH_TOKEN_URL Qoder
QODER_OAUTH_USERINFO_URL Qoder
QODER_OAUTH_CLIENT_ID Qoder
QODER_PERSONAL_ACCESS_TOKEN Qoder Tiešās API atslēgas atkāpšanās opcija (apiet OAuth).
QODER_CLI_WORKSPACE Qoder Qoder CLI darbvietas ID.
OMNIROUTE_QODER_WORKSPACE Qoder QODER_CLI_WORKSPACE aizstājvārds.
QODER_CLI_CONFIG_DIR Qoder Aizstāj Qoder CLI konfigurācijas direktoriju (izolēta PAT sesija, novērš pārlūkprogrammas pieteikšanās datu pārrakstīšanu).
BLACKBOX_WEB_VALIDATED_TOKEN Blackbox Web Priekšgala tk marķieris, kas jānosūta kā validated uz /api/chat. Nepieciešams, ja Blackbox uzspiež marķieru atbilstību; pretējā gadījumā OmniRoute izmanto nejaušu UUID. Skatiet problēmu #2252.
VISION_BRIDGE_BASE_URL Vision Bridge aizsargsistēma Ar OpenAI saderīgs bāzes URL ne-Anthropic vision-bridge izsaukumiem. Pēc noklusējuma izmanto mantoto OpenAI URL vides mainīgo vai api.openai.com. Norādiet uz OmniRoute /v1 pašcilpu vai jebkuru ar OpenAI saderīgu galapunktu (Gemini OpenAI-compat, OpenRouter). Problēma #2232. Ja URL ir paša OmniRoute /v1, aprakstīšanas apakšpieprasījums nosūta x-omniroute-admission-bypass: internal un autentificējas ar atrisināto pašcilpas akreditācijas informāciju (sk_omniroute sargvērtība lokālajā režīmā vai OMNIROUTE_API_KEY / ROUTER_API_KEY — #1350), lai darbotos izvietojumi ar REQUIRE_API_KEY=true.
VISION_BRIDGE_API_KEY Vision Bridge aizsargsistēma API atslēga iepriekš norādītajam URL. Ne-Anthropic vision-bridge izsaukumiem tai ir priekšroka pār katram nodrošinātājam paredzētajiem OpenAI / Google vides mainīgajiem. Anthropic modeļi turpina izmantot tiem paredzēto Anthropic atslēgas ceļu. Problēma #2232.

Warning

  1. Dodieties uz Google Cloud Console → Akreditācijas dati
  2. Izveidojiet OAuth 2.0 klienta ID (tips: "Tīmekļa lietojumprogramma")
  3. Pievienojiet sava servera URL kā autorizēto novirzīšanas URI
  4. Aizstājiet akreditācijas datu vērtības failā .env.

12. Pakalpojumu sniedzēju User-Agent pārrakstīšana

Pārrakstiet User-Agent galveni, kas tiek nosūtīta katram augšupējam pakalpojumu sniedzējam. Izpildes laikā to dinamiski nosaka izpildītāja bāzes klase:

process.env[`${PROVIDER_ID}_USER_AGENT`]

Avots: open-sse/executors/base.tsbuildHeaders()

Mainīgais Noklusējuma vērtība Kad atjaunināt
CLAUDE_USER_AGENT claude-cli/2.1.258 (external, cli) Kad Anthropic izlaiž jaunu CLI versiju
CLAUDE_DISABLE_TOOL_NAME_CLOAK false executors/base.ts + executors/cliproxyapi.ts Iestatiet uz 1/true, lai abos uz Anthropic vērstajos ceļos (vietējais OAuth un CLIProxyAPI) trešo pušu ietvaru rīku nosaukumus pārsūtītu Anthropic nemainītā veidā. Pēc noklusējuma izpildītājs deterministiski piešķir aizstājvārdus rīku nosaukumiem, kas nepieder Claude Code (izmantojot Claude Code kanonisko kartējumu, ja tāds pastāv, pretējā gadījumā — PascalCase), un atbildē atjauno tos, izmantojot _toolNameMap, lai ietvari ar snake_case rīkiem netiktu noraidīti kā identificēti trešo pušu klienti. Tikai atkļūdošanai.
CODEX_USER_AGENT codex-cli/0.142.0 (Windows 10.0.26200; x64) Kad OpenAI atjaunina Codex CLI
CODEX_CLIENT_VERSION 0.131.0 Pārrakstīt Codex klienta versiju neatkarīgi no pilnās UA virknes
CLAUDE_CODE_CLIENT_VERSION 2.1.258 Pārrakstīt norādīto Claude Code versiju neatkarīgi no CLAUDE_USER_AGENT. Anthropic ierobežo piekļuvi dažiem modeļiem, pamatojoties uz šo vērtību (#12417).
GITHUB_COPILOT_CLI_VERSION 1.0.81-6 Pārrakstīt norādīto Copilot CLI versiju neatkarīgi no GITHUB_USER_AGENT
GITHUB_USER_AGENT GitHubCopilotChat/0.54.0 Kad GitHub Copilot Chat tiek atjaunināts
ANTIGRAVITY_USER_AGENT antigravity/2.0.1 darwin/arm64 Kad Antigravity IDE tiek atjaunināta
KIRO_USER_AGENT AWS-SDK-JS/3.0.0 kiro-ide/1.0.0 Kad Kiro IDE tiek atjaunināta
KIRO_OAUTH_CLIENT_ID kiro-cli Pārrakstīt Kiro sociālās ierīces koda clientId (publisko ID)
KIRO_VERIFY_FULL_CRC false Pēc izvēles: pilna katra kadra ziņojuma CRC validācija Kiro notikumu straumē (bojātu straumju atkļūdošanai)
QODER_USER_AGENT Qoder-Cli Kad Qoder CLI tiek atjaunināta
CURSOR_USER_AGENT Cursor/3.3 Kad Cursor tiek atjaunināts

Tip

Varat pievienot User-Agent pārrakstīšanu jebkuram pakalpojumu sniedzējam, izmantojot modeli {PROVIDER_ID}_USER_AGENT. Izpildītājs dinamiski izveido vides mainīgā nosaukumu.


13. CLI digitālā nospieduma saderība

Kad šī funkcija ir iespējota, OmniRoute pārkārto HTTP galvenes un JSON pamatteksta laukus, lai tie precīzi atbilstu oficiālo CLI rīku signatūrai. Tas samazina konta atzīmēšanas risku, vienlaikus saglabājot jūsu starpniekservera IP adresi.

Avots: open-sse/config/cliFingerprints.ts, open-sse/executors/base.ts

Katram nodrošinātājam

Mainīgais Aktivizēšana Efekts
CLI_COMPAT_CODEX =1 Atdarina Codex CLI pieprasījuma signatūru
CLI_COMPAT_CLAUDE =1 Atdarina Claude Code pieprasījuma signatūru
CLI_COMPAT_GITHUB =1 Atdarina GitHub Copilot pieprasījuma signatūru
CLI_COMPAT_ANTIGRAVITY =1 Atdarina Antigravity pieprasījuma signatūru
CLI_COMPAT_CURSOR =1 Atdarina Cursor pieprasījuma signatūru
CLI_COMPAT_KIMI_CODING =1 Atdarina Kimi Coding pieprasījuma signatūru
CLI_COMPAT_KILOCODE =1 Atdarina Kilo Code pieprasījuma signatūru
CLI_COMPAT_CLINE =1 Atdarina Cline pieprasījuma signatūru

Globāli

Mainīgais Aktivizēšana Efekts
CLI_COMPAT_ALL =1 Iespējo digitālā nospieduma saderību visiem nodrošinātājiem reizē.

Kimi Coding CLI identitātes pārrakstīšana

Mainīgais Noklusējums Avota fails Apraksts
KIMI_CLI_VERSION 1.36.0 src/lib/oauth/providers/kimi-coding.ts Pārraksta OAuth/API izsaukumu laikā nosūtīto Kimi CLI versiju.
KIMI_CODING_DEVICE_ID (tvertā noklusējuma vērtība) src/lib/oauth/providers/kimi-coding.ts Pārraksta tverto Kimi ierīces ID, kas tiek izmantots klienta galvenēs.

Note

Šī funkcija darbojas kopā ar User-Agent pārrakstīšanu (§12). Digitālā nospieduma sistēma pārvalda galveņu un pamatteksta lauku secību, savukārt User-Agent pārrakstīšana pārvalda konkrēto UA virkni. Abas funkcijas var iespējot neatkarīgi.


14. API atslēgu nodrošinātāji

API atslēgas nodrošinātājiem, kuri izmanto tiešo autentifikāciju. Ieteicamā iestatīšana: Informācijas panelis → Nodrošinātāji → Pievienot API atslēgu.

Iestatīšana, izmantojot vides mainīgos, ir alternatīva Docker vai bezgalvas izvietojumiem.

Atpazītais formāts: {PROVIDER_ID}_API_KEY

Mainīgais Nodrošinātājs
DEEPSEEK_API_KEY DeepSeek
NVIDIA_API_KEY NVIDIA NIM
JINA_AI_API_KEY Jina AI (Foundation API + Reader atkāpšanās mehānisms)
JINA_API_KEY Jina AI (JINA_AI_API_KEY aizstājvārds)
GEMINI_API_KEY Gemini (Google AI Studio) iegulšanas + tērzēšanas atkāpšanās mehānisms
GOOGLE_API_KEY Gemini (GEMINI_API_KEY aizstājvārds)

Note

Statiskie ${PROVIDER}_API_KEY ieraksti Groq, xAI, Mistral, Perplexity, Together AI, Fireworks, Cerebras, Cohere, Nebius un Qianfan nodrošinātājiem tika noņemti versijā v3.8.0, jo izpildlaika vide tos vairs nenolasa — šie nodrošinātāji izmanto tikai informācijas paneli / data/provider-credentials.json / šifrēto datubāzi. Migrācijas norādes skatiet sadaļā Audits: noņemtie / neizmantotie mainīgie šī dokumenta beigās.

Tip

Informācijas panelī iestatītās atslēgas tiek glabātas šifrētā veidā SQLite datubāzē, un tām ir prioritāte pār vides mainīgajiem.

Jina: jina-ai/… iegulšanas, pārkārtošanas, klasificēšanas un segmentēšanas modeļi, kā arī jina-search, neizmanto klastera vides atslēgu norēķiniem, ja pastāv informācijas paneļa jina-ai (vai koplietots jina-reader) savienojums — getProviderCredentials vispirms aizpilda trūkstošās vērtības. JINA_AI_API_KEY / JINA_API_KEY tiek izmantoti tikai tad, ja nav pieejama lietojama informācijas paneļa atslēga. Izsaukumu žurnālos vides atkāpšanās mehānisms tiek norādīts kā connection_id=env:JINA_AI_API_KEY. Reader kartīte (jina-reader, r.jina.ai) nekad neapkalpo /v1/embeddings vai /v1/rerank.

Gemini: gemini/gemini-embedding-2 (aizstājvārds google/gemini-embedding-2) vispirms izmanto informācijas paneļa gemini savienojumu. GEMINI_API_KEY / GOOGLE_API_KEY tiek izmantoti tikai tad, ja nav pieejama lietojama informācijas paneļa atslēga. Izsaukumu žurnālos vides atkāpšanās mehānisms tiek norādīts kā connection_id=env:GEMINI_API_KEY. Vietējā multimodālā datplūsma izmanto x-goog-api-key ar :embedContent / :batchEmbedContents — N OpenAI input vienumi kļūst par N vektoriem.


15. Taimauta iestatījumi

Visas vērtības ir norādītas milisekundēs. Centralizēta vērtību noteikšana failā src/shared/utils/runtimeTimeouts.ts.

Taimautu hierarhija

REQUEST_TIMEOUT_MS (globāla pārrakstīšana)
├─→ FETCH_TIMEOUT_MS (ārējo pakalpojumu sniedzēju izsaukumi, noklusējums: 600000)
│   ├─→ FETCH_HEADERS_TIMEOUT_MS (manto no FETCH_TIMEOUT_MS)
│   ├─→ FETCH_BODY_TIMEOUT_MS (manto no FETCH_TIMEOUT_MS)
│   ├─→ TLS_CLIENT_TIMEOUT_MS (manto no FETCH_TIMEOUT_MS)
│   │   └── TLS_FIRST_BYTE_WATCHDOG_MS (neatkarīgs, noklusējums: 10000)
│   ├── RESPONSES_FIRST_BYTE_TIMEOUT_MS (neatkarīgs, noklusējums: 15000)
│   ├── FETCH_CONNECT_TIMEOUT_MS (neatkarīgs, noklusējums: 30000)
│   └── FETCH_KEEPALIVE_TIMEOUT_MS (neatkarīgs, noklusējums: 4000)
├─→ STREAM_IDLE_TIMEOUT_MS (manto no REQUEST_TIMEOUT_MS, noklusējums: 600000)
├─→ STREAM_ACTIVE_TIMEOUT_MS (neatkarīgs, noklusējums: 1260000; 0 atspējo)
├─→ STREAM_READINESS_TIMEOUT_MS (manto no REQUEST_TIMEOUT_MS, noklusējums: 80000)
├─→ STREAM_READINESS_MAX_TIMEOUT_MS (ierobežo adaptīvos gatavības pagarinājumus, noklusējums: 180000)
└─→ API_BRIDGE_PROXY_TIMEOUT_MS (manto no REQUEST_TIMEOUT_MS, noklusējums: 30000)
    ├─→ API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS (atvasināts, noklusējums: 300000)
    ├── API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS (noklusējums: 60000)
    ├── API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS (noklusējums: 5000)
    └── API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS (noklusējums: 0 = atspējots)
Mainīgais Noklusējums Apraksts
REQUEST_TIMEOUT_MS (nav iestatīts) Globāla saīsne — pārraksta gan FETCH_TIMEOUT_MS, gan STREAM_IDLE_TIMEOUT_MS noklusējuma vērtības.
FETCH_TIMEOUT_MS 600000 Kopējais HTTP pieprasījuma taimauts augšupstraumes nodrošinātāja izsaukumiem.
STREAM_IDLE_TIMEOUT_MS 600000 Maksimālais klusuma periods starp neapstrādātiem augšupstraumes baitiem, pirms darbība tiek pārtraukta. Modeļi ar paplašināto spriešanu reti apstājas uz >90 s.
STREAM_ACTIVE_TIMEOUT_MS 1260000 Maksimālais kopējais aktīvās SSE straumes darbības ilgums; tas nekad netiek atiestatīts, saņemot augšupstraumes baitus, un nav atkarīgs no REQUEST_TIMEOUT_MS. Atvasināts no reģistrā lielākās katram modelim noteiktās timeoutMs vērtības (1200000, Codex), pieskaitot 60000 rezervi, tādēļ modelis, kuram atļauts izmantot visu tam piešķirto laiku, nekad netiek apturēts atbildes vidū. Iestatiet uz 0, lai atspējotu.
OMNIROUTE_SSE_COMMENTS (atspējots) Nosaka, vai OmniRoute drīkst izvadīt SSE : komentāru rindas (piem., : keepalive sirdspukstu un x-omniroute-* metadatu beigu ierakstus). Pēc noklusējuma atspējots (#10524), jo stingri ar OpenAI saderīgi klienti katrai SSE rindai izsauc JSON.parse un avarē, sastopot : komentārus; data: sirdspuksti netiek ietekmēti. Iestatiet on/true/1/yes, lai atkal iespējotu. Izmanto open-sse/utils/sseHeartbeat.ts.
STREAM_READINESS_TIMEOUT_MS 80000 Laiks līdz pirmā SSE notikuma, kas nav ping, saņemšanai. Ja ir iestatīts REQUEST_TIMEOUT_MS, manto tā vērtību.
STREAM_READINESS_MAX_TIMEOUT_MS 180000 Maksimālais adaptīvais pirmā notikuma gatavības gaidīšanas periods lieliem straumēšanas pieprasījumiem, pieprasījumiem ar daudziem rīkiem vai intensīvu spriešanu.
OMNIROUTE_AGENT_GOAL_POLICY_ENABLED true Avārijas slēdzis /goal heiristikai. Iestatiet false/0/off, lai pilnībā atspējotu noteikšanu — gatavības taimauti un straumes atkopšana nekad netiek palielināti, pamatojoties uz pieprasījuma pamattekstu/galvenēm, tādējādi mazinot klienta kontrolētas taimauta palielināšanas risku.
OMNIROUTE_AGENT_GOAL_READINESS_MAX_TIMEOUT_MS 600000 Maksimālais pirmā notikuma gatavības gaidīšanas periods noteiktām /goal aģenta izpildēm vai pieprasījumiem, kas piespiedu kārtā atzīmēti ar x-omniroute-agent-goal.
OMNIROUTE_AGENT_GOAL_STREAM_RECOVERY true Automātiski iespējot agrīnu straumes atkopšanu noteiktām /goal aģenta izpildēm. Iestatiet false/0/off, lai atspējotu tieši mērķim paredzēto izvēles iespējošanu. Tas var tikai PIEVIENOT atkopšanu papildus operatora noklusējuma iestatījumam — tas nekad nepārraksta skaidru atteikšanos, kas norādīta STREAM_RECOVERY_ENABLED/DB iestatījumos.
OMNIROUTE_CODEX_DROP_NONSTANDARD_EVENTS true Noņemt nestandarta codex.* SSE notikumus (piem., codex.rate_limits), kuru dēļ OpenAI SDK responses.stream() darbība beidzas ar 502. Pēc noklusējuma IESLĒGTS (#11014). Iestatiet 0/false/no/off, lai tos pārsūtītu.
OMNIROUTE_CODEX_APPSERVER_WS (nav iestatīts) Izvēles Codex app-server transports. Lokāla codex app-server blakusprocesa WebSocket galapunkts (ws:///wss://). Ja tas ir iestatīts kopā ar pilnvaru, Codex pieprasījumi tiek maršrutēti uz blakusprocesu, izmantojot JSON-RPC, nevis HTTP Responses API. Var iestatīt arī katram savienojumam atsevišķi, izmantojot providerSpecificData.codexAppServerUrl. Izmanto open-sse/executors/codex/appServerConfig.ts.
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN (nav iestatīts) Iekļauta iespēju/nesēja pilnvara, kas tiek uzrādīta app-server. Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerToken.
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN_FILE (nav iestatīts) Ceļš uz failu, kurā glabājas app-server iespēju pilnvara (no codex app-server --ws-token-file). Tiek izmantots, ja OMNIROUTE_CODEX_APPSERVER_WS_TOKEN nav iestatīts. Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerTokenFile.
OMNIROUTE_CODEX_APPSERVER_CWD /tmp Darba direktorijs, kurā tiek izpildīts app-server solis. Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerCwd.
OMNIROUTE_CODEX_APPSERVER_APPROVAL (nav iestatīts) Apstiprināšanas politika, kas tiek nodota app-server solim (piem., never, on-request). Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerApprovalPolicy.
OMNIROUTE_CODEX_APPSERVER_SANDBOX (nav iestatīts) Smilškastes politika, kas tiek nodota app-server solim (piem., read-only, workspace-write, danger-full-access). Ja tā nav iestatīta, izpildītājs pēc noklusējuma izmanto workspace-write (pastiprināti aizsargāts; iepriekš danger-full-access). Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerSandbox.
OMNIROUTE_CODEX_APPSERVER_AUTO_APPROVE false Automātiski apstiprināt paša app-server apstiprināšanas uzvednes (komandu/failu/atļauju izpilde resursdatorā). Pēc noklusējuma izslēgts — uzvednes tiek automātiski noraidītas; ietvara rīku izsaukumi netiek ietekmēti (tie tiek pārsūtīti pa atsevišķo item/tool/call caurlaides kanālu). Pieņem true/1/yes. Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerAutoApprove.
FETCH_HEADERS_TIMEOUT_MS = FETCH_TIMEOUT_MS Laiks līdz atbildes galveņu saņemšanai.
OMNIROUTE_DIRECT_HEADERS_TIMEOUT_MS 30000 (30s) Maksimālais atbildes sākuma gaidīšanas laiks (ms) katram tiešajam mēģinājumam bez starpniekservera. Pēc taimauta mēģinājums tiek vienreiz atkārtots jaunā ligzdā; iestatiet 0, lai atspējotu ierobežojumu un saglabātu iepriekšējo darbību.
FETCH_BODY_TIMEOUT_MS = FETCH_TIMEOUT_MS Laiks pilna atbildes pamatteksta saņemšanai.
FETCH_CONNECT_TIMEOUT_MS 30000 TCP savienojuma izveides taimauts.
FETCH_KEEPALIVE_TIMEOUT_MS 4000 Keep-alive ligzdas dīkstāves taimauts.
TLS_CLIENT_TIMEOUT_MS = FETCH_TIMEOUT_MS TLS digitālnospieduma starpniekservera (wreq-js) taimauts.
TLS_FIRST_BYTE_WATCHDOG_MS 10000 Ierobežo laiku līdz pirmajam baitam tieši wreq-js TLS digitālnospieduma transporta pamattekstam; TLS_CLIENT_TIMEOUT_MS viens pats nevar konstatēt iestrēgušu pamattekstu, jo tas tiek izpildīts, tiklīdz saņemtas galvenes (#12656). Taimauta gadījumā wreq lasītājs tiek atcelts un notiek pārslēgšanās uz tiešo/starpniekservera dispečeru; 0 atspējo uzraugu.
RESPONSES_FIRST_BYTE_TIMEOUT_MS 15000 Tikai OpenCode izpildītājam un tikai tad, kamēr funkcijas karogs OPENCODE_RESPONSES_STALL_ROTATION ir ieslēgts (pēc noklusējuma izslēgts): ierobežo pirmā pamatteksta baita gaidīšanas laiku straumētai Responses atbildei pēc tās galveņu saņemšanas (#13484). Responses straume sākas ar response.created, tādēļ klusums pēc šī perioda nozīmē iestrēgšanu: kontam tiek piemērots nogaidīšanas periods, un pieprasījums vienreiz tiek novirzīts uz nākamo kontu; otrās iestrēgšanas gadījumā darbība nekavējoties neizdodas. 0 atspējo aizsardzību pat tad, ja karogs ir ieslēgts.
API_BRIDGE_PROXY_TIMEOUT_MS 30000 Starpniekservera posma taimauts /v1 tilta pieprasījumiem.
FIRECRAWL_BASE_URL https://api.firecrawl.dev Novirza Firecrawl tīmekļa izgūšanas izpildītāju uz pašmitinātu instanci (ārpus mākoņa API atslēga nav obligāta).
FIRECRAWL_TIMEOUT_MS 30000 Katra pieprasījuma taimauts Firecrawl tīmekļa izgūšanas izpildītājam.
API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS 300000 Kopējais tilta servera pieprasījuma taimauts.
API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS 60000 Atbildes galveņu nosūtīšanai caur tiltu atvēlētais laiks.
API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS 5000 Tilta keep-alive dīkstāves taimauts.
API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS 0 Neapstrādātas ligzdas taimauts (0 = atspējots).
SHUTDOWN_TIMEOUT_MS 30000 Labvēlības periods pēc SIGTERM/SIGINT pirms piespiedu iziešanas.
OMNIROUTE_DEFAULT_FETCH_TIMEOUT_MS 120000 Rezerves vērtība, ko izmanto src/shared/utils/fetchTimeout.ts, ja FETCH_TIMEOUT_MS nav iestatīts.
OMNIROUTE_PROVIDER_PROBE_TIMEOUT_MS 8000 Taimauts (ms) validationRead un modelsProbe priekšiestatījumiem failā src/shared/network/safeOutboundFetch.ts. Palieliniet lēniem galapunktiem (Cerebras, Cloudflare AI, Groq), lai informācijas panelī novērstu svārstības starp aktīvu un kļūdas stāvokli. Nederīgām (<1000) vai neskaitliskām vērtībām tiek izmantota rezerves vērtība 8000ms.
OMNIROUTE_RELAY_FETCH_TIMEOUT_MS 25000 Relejam specifisks izgūšanas taimauts failā open-sse/utils/proxyFetch.ts (#9158). Iestrēgušam relejam jābeidz darbība ar kļūdu pirms klienta/aģenta taimauta (~30s), lai izsaucēji vispārīga augšupstraumes taimauta vietā redzētu relejam specifisku kļūmi. Ierobežots līdz 29000, lai tas vienmēr nostrādātu pirmais.
OMNIROUTE_RETRY_BACKOFF_MS 10 Kopīga atkārtota mēģinājuma aizkave tiešajiem/releja/starpniekservera vienreizējas atkārtošanas ceļiem failā open-sse/utils/proxyFetch.ts (#9158). 0 = atkārtot nekavējoties.
OMNIROUTE_CLAUDE_TLS_TIMEOUT_MS 60000 Iebūvētais wreq-js pieprasījuma taimauts (claudeTlsClient.ts).
OMNIROUTE_CLAUDE_TLS_GRACE_MS 10000 Absolūta JS stingrā termiņa papildlaiks, kas tiek pievienots iebūvētajam taimautam.
OMNIROUTE_PPLX_TLS_TIMEOUT_MS 30000 Iebūvētais wreq-js pieprasījuma taimauts (perplexityTlsClient.ts).
OMNIROUTE_PPLX_TLS_GRACE_MS 10000 Absolūta JS stingrā termiņa papildlaiks, kas tiek pievienots iebūvētajam taimautam.
OMNIROUTE_PPLX_SEARCH_HINT 0 (izslēgts) Izsaucēja sistēmas ziņojumam pievieno tekstu "Jums ir iebūvēta meklēšana tīmeklī. Atbildiet uz jautājumiem tieši, izmantojot meklēšanas rezultātus." (perplexity-web/protocol.ts). Pēc noklusējuma izslēgts — Perplexity tik un tā veic meklēšanu, un šis teikums nonāk atbildēs kā metakomentārs kodēšanas klientiem. Iestatiet 1/true/yes/on, lai atjaunotu.
OMNIROUTE_GROK_TLS_TIMEOUT_MS 60000 Vietējā wreq-js pieprasījuma taimauts (grokTlsClient.ts).
OMNIROUTE_GROK_TLS_GRACE_MS 10000 Absolūtā JS stingrā termiņa rezerve, kas tiek pievienota vietējam taimautam.
OMNIROUTE_NOTION_TLS_TIMEOUT_MS 30000 Vietējā wreq-js pieprasījuma taimauts (notionTlsClient.ts); ilgām ģenerēšanām notion-web katram pieprasījumam to palielina līdz 180000.
OMNIROUTE_NOTION_TLS_GRACE_MS 10000 Absolūtā JS stingrā termiņa rezerve, kas tiek pievienota vietējam taimautam.
OMNIROUTE_BROWSER_POOL on Koplietojams Playwright pārlūkprogrammu pūls tīmekļa sīkfailu tērzēšanai, ko nodrošina pārlūkprogramma (browserPool.ts); iestatiet off, lai atspējotu.
OBSCURA_BIN auto-detect Ceļš uz obscura bināro failu, ko pārlūkprogrammu pūls un Cloudflare Playground izpildītājs izmanto kā primāro dzini (open-sse/services/obscura.ts); ja nav iestatīts, tas tiek automātiski atrasts sistēmas PATH.
OBSCURA_CDP_ENDPOINT (nav iestatīts) Norādiet uz jau palaistu Obscura instanci (http://host:port), nevis izveidojiet jaunu; modulis nepārvalda šo procesu (open-sse/services/obscura.ts).
OBSCURA_PORT nejaušs brīvs ports Konkrēts ports palaistajam obscura serve; ja tas nav iestatīts, automātiski tiek izvēlēts brīvs ports (open-sse/services/obscura.ts).
WEB_COOKIE_USE_BROWSER 0 Novirza tīmekļa sīkfailu tērzēšanas pieprasījumu uz pārlūkprogrammas nodrošināto ceļu (browserBackedChat.ts); iestatiet 1, lai iespējotu.
KIMI_WEB_BASE_URL https://www.kimi.ai Kimi Web (starptautiskā kimi.ai Connect-RPC) izpildītāja bāzes URL (kimi-web.ts); mainiet tikai spoguļa/starpniekservera galapunktiem.
KIMI_WEB_CHAT_URL <KIMI_WEB_BASE_URL>/apiv2/kimi.gateway.chat.v1.ChatService/Chat Pilns Kimi Web izpildītāja tērzēšanas galapunkts (kimi-web.ts).
OMNIROUTE_LOGIN_BROWSER_PATH (automātiski noteikts) Ceļš uz sistēmas Chrome/Edge izpildāmo failu Adobe Firefly interaktīvajai pierakstīšanai pārlūkprogrammā (adobeFireflyBrowserLogin.ts); aizstāj katrai OS paredzēto automātisko noteikšanu.
OMNIROUTE_STANDALONE_DIR .build/ autonomās izvades direktorijs Kompilēšanas laika aizstāšana autonomās izvades direktorijam, ko izmanto pēckompilēšanas līdzizvietošanas darbība (scripts/build/colocate-standalone.mjs); paredzēts kompilēšanas rīkiem, nevis izpildlaikam.

Kombinētā mērķa mēģinājumi pārmanto atrisināto augšupstraumes pieprasījuma taimautu (FETCH_TIMEOUT_MS vai REQUEST_TIMEOUT_MS, ja tas nodrošina fetch noklusējuma vērtību). Iestatiet targetTimeoutMs kombinācijā, kombinācijas noklusējuma iestatījumos vai nodrošinātāja aizstāšanā tikai tādēļ, lai paātrinātu kombinācijas pārslēgšanos uz rezerves variantu; vērtības, kas pārsniedz pašreizējo augšupstraumes taimautu, tiek ierobežotas līdz augšupstraumes taimautam.

comboTimeoutMs ir atsevišķs kopējās kombinācijas reālā laika budžets visiem kļūmjpārlēces mērķiem. Atstājiet to neiestatītu vai iestatiet uz 0, lai saglabātu neierobežotu iterāciju (10 minūšu COMBO_LOOP_SAFETY_TIMEOUT_MS aizsardzība pret iestrēgšanu joprojām ir spēkā). Pozitīva vērtība aizstāj šo kombinācijas drošības mehānismu. Iestatiet comboTimeoutMs ilgāku par targetTimeoutMs, lai kļūmjpārlēcei joprojām pietiktu laika pēc lēna pirmā mērķa.

Ķēdes pārtraucēja sliekšņi

Nodrošinātāja līmeņa ķēdes pārtraucēja pielāgošana. Noklusējuma vērtības atspoguļo mērogotās vērtības, kas kopš v3.6 tiek izmantotas vairāk nekā 500 savienojumiem.

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_THRESHOLD 8 open-sse/config/constants.ts Secīgu kļūmju slieksnis OAuth nodrošinātājiem, pēc kura tiek aktivizēts automātiskais slēdzis.
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_RESET_MS 60000 open-sse/config/constants.ts OAuth nodrošinātāja automātiskā slēdža atiestatīšanas intervāls (ms).
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_THRESHOLD 12 open-sse/config/constants.ts Secīgu kļūmju slieksnis API atslēgas nodrošinātājiem.
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_RESET_MS 30000 open-sse/config/constants.ts API atslēgas nodrošinātāja automātiskā slēdža atiestatīšanas intervāls (ms).
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_THRESHOLD 2 open-sse/config/constants.ts Secīgu kļūmju slieksnis lokālajiem nodrošinātājiem (Ollama, LM Studio, ...).
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_RESET_MS 15000 open-sse/config/constants.ts Lokālā nodrošinātāja automātiskā slēdža atiestatīšanas intervāls (ms).
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_THRESHOLD 10 open-sse/config/constants.ts Nodrošinātāja līmeņa automātiskais slēdzis: kļūmju skaits laika logā, pēc kura visam OAuth nodrošinātājam sākas nogaidīšanas periods.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_WINDOW_MS 900000 open-sse/config/constants.ts Nodrošinātāja līmeņa automātiskais slēdzis: slīdošais kļūmju uzskaites logs (ms) OAuth nodrošinātājiem.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_COOLDOWN_MS 300000 open-sse/config/constants.ts Nodrošinātāja līmeņa automātiskais slēdzis: nogaidīšanas periods (ms), kad sasniegts OAuth nodrošinātāja slieksnis.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_DEGRADATION_THRESHOLD 5 open-sse/config/constants.ts Pie šāda kļūmju skaita OAuth nodrošinātājs pāriet stāvoklī DEGRADED.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_MAX_BACKOFF_MULTIPLIER 8 open-sse/config/constants.ts OAuth nodrošinātāja maksimālais resetTimeout palielināšanas reizinātājs.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_BACKOFF_ESCALATION_COUNT 2 open-sse/config/constants.ts OAuth nodrošinātāja atkāpšanās līmenis tiek paaugstināts pēc šāda atvērtu ciklu skaita.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_THRESHOLD 15 open-sse/config/constants.ts Nodrošinātāja līmeņa automātiskais slēdzis: kļūmju skaits laika logā, pēc kura visam API atslēgas nodrošinātājam sākas nogaidīšanas periods.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_WINDOW_MS 1800000 open-sse/config/constants.ts Nodrošinātāja līmeņa automātiskais slēdzis: slīdošais kļūmju uzskaites logs (ms) API atslēgas nodrošinātājiem.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_COOLDOWN_MS 600000 open-sse/config/constants.ts Nodrošinātāja līmeņa automātiskais slēdzis: nogaidīšanas periods (ms), kad sasniegts API atslēgas nodrošinātāja slieksnis.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_DEGRADATION_THRESHOLD 7 open-sse/config/constants.ts Pie šāda kļūmju skaita API atslēgas nodrošinātājs pāriet stāvoklī DEGRADED.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_MAX_BACKOFF_MULTIPLIER 4 open-sse/config/constants.ts API atslēgas nodrošinātāja maksimālais resetTimeout palielināšanas reizinātājs.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_BACKOFF_ESCALATION_COUNT 3 open-sse/config/constants.ts API atslēgas nodrošinātāja atkāpšanās līmenis tiek paaugstināts pēc šāda atvērtu ciklu skaita.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_THRESHOLD 2 open-sse/config/constants.ts Nodrošinātāja līmeņa automātiskais slēdzis: kļūmju skaits, pēc kura visam lokālajam nodrošinātājam sākas nogaidīšanas periods.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_WINDOW_MS 300000 open-sse/config/constants.ts Nodrošinātāja līmeņa automātiskais slēdzis: slīdošais kļūmju uzskaites logs (ms) lokālajiem nodrošinātājiem.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_COOLDOWN_MS 60000 open-sse/config/constants.ts Nodrošinātāja līmeņa automātiskais slēdzis: nogaidīšanas periods (ms), kad sasniegts lokālā nodrošinātāja slieksnis.
PIN_DROP_BACKOFF_LEVEL 2 open-sse/services/combo.ts Atkāpšanās dziļums, pie kura konteksta kešatmiņas piesaistes nodrošinātājs tiek uzskatīts par ilgstoši neveselīgu un piesaiste tiek atmesta, lai pārslēgtos kļūmes gadījumā.
PIN_DROP_GRACE_MS 20000 open-sse/services/combo.ts Svārstību novēršanas logs (ms), kurā īslaicīgi pārejoši nogaidīšanas periodi tiek pieļauti, pirms tiek atmesta konteksta kešatmiņas piesaiste.

Scenāriji

Scenārijs Konfigurācija
Ilgstoša koda ģenerēšana REQUEST_TIMEOUT_MS=900000 (15 min)
Kopējā straumes darbības ilguma ierobežošana STREAM_ACTIVE_TIMEOUT_MS=1260000 (21 min)
Ātra kļūmes atgriešana produkcijas API API_BRIDGE_PROXY_TIMEOUT_MS=10000
Paplašinātas spriešanas modeļi STREAM_IDLE_TIMEOUT_MS=300000 (5 min starp fragmentiem)

16. Žurnalēšana

Žurnalēšanas sistēma raksta gan standarta izvadē (stdout), gan rotētos žurnālfailos. Visa konfigurācija tiek nolasīta no src/lib/logEnv.ts.

Mainīgais Noklusējums Apraksts
APP_LOG_LEVEL info Minimālais žurnāla līmenis: debug, info, warn, error.
APP_LOG_FORMAT text Izvades formāts: text (cilvēklasāms) vai json (strukturēts).
APP_LOG_TO_FILE true Rakstīt žurnālus failā papildus standarta izvadei.
APP_LOG_FILE_PATH logs/application/app.log Žurnālfaila ceļš (relatīvs pret projekta sakni vai DATA_DIR).
APP_LOG_MAX_FILE_SIZE 50M Maksimālais faila izmērs pirms rotācijas. Pieņem: 50M, 1G, 512K vai vienkāršu baitu skaitu.
APP_LOG_RETENTION_DAYS 7 Dienu skaits, cik ilgi glabāt rotētos lietojumprogrammas žurnālfailus.
APP_LOG_MAX_FILES 20 Maksimālais rotēto žurnālfailu dublējumkopiju skaits.
CALL_LOG_RETENTION_DAYS 7 Dienu skaits, cik ilgi datubāzē glabāt pieprasījumu/izsaukumu žurnāla ierakstus.
CALL_LOG_MAX_ENTRIES 10000 Maksimālais izsaukumu žurnāla ierakstu skaits atmiņas buferī.
CALL_LOGS_TABLE_MAX_ROWS 100000 Maksimālais rindu skaits SQLite tabulā call_logs pirms ierakstu dzēšanas.
ENABLE_REQUEST_LOGS (nav iestatīts) Piespiedu kārtā ieslēgt vai izslēgt detalizētu pieprasījumu žurnalēšanu, ignorējot informācijas paneļa iestatījumu.
MAX_PENDING_REQUEST_AGE_MS 3600000 (1 stunda) Maksimālais pamestu aktīvo pieprasījumu žurnāla ierakstu vecums pirms tīrīšanas no atmiņas.
CALL_LOG_PIPELINE_CAPTURE_STREAM_CHUNKS false Saglabāt straumes fragmentus konveijera artefaktos, ja call_log_pipeline_enabled=true. Jāiespējo apzināti (true) — pēc noklusējuma izslēgts, lai taupītu vietu diskā.
CALL_LOG_PIPELINE_MAX_SIZE_KB 512 Maksimālais konveijera izsaukumu žurnāla artefakta izmērs KB, ja call_log_pipeline_enabled=true.
PROXY_LOGS_TABLE_MAX_ROWS 100000 Maksimālais rindu skaits SQLite tabulā proxy_logs pirms ierakstu dzēšanas.
PROXY_LOG_INCLUDE_IPS false Iekļaut klienta/izejošās IP adreses un kontu prefiksus [ProxyEgress] konsoles žurnālos. Informācijas paneļa/datubāzes starpniekservera žurnāla ierakstos tiek saglabāta pilna informācija.
APP_LOG_ROTATION_CHECK_INTERVAL_MS 60000 (1 min.) Cik bieži src/lib/logRotation.ts atkārtoti pārbauda aktīvā žurnālfaila izmēru.
CHAT_LOG_TEXT_LIMIT 65536 Maksimālais virknes garums, kas tiek saglabāts tērzēšanas žurnāla artefaktos (pēc noklusējuma 64 KB).
CHAT_LOG_ARRAY_TAIL_ITEMS 128 Masīva elementu skaits, kas tiek saglabāts no beigām, saīsinot tērzēšanas žurnāla derīgo slodzi.
CHAT_LOG_MAX_DEPTH 6 Maksimālais ligzdošanas dziļums, pēc kura tērzēšanas žurnāla derīgās slodzes tiek saīsinātas.
CHAT_LOG_MAX_OBJECT_KEYS 80 Maksimālais objekta atslēgu skaits, kas tiek saglabāts tērzēšanas žurnāla derīgajās slodzēs (0 = neierobežots).
CHAT_LOG_MAX_BODY_KB 1024 Visa pieprasījuma/atbildes pamatteksta izmērs (KB), kuru pārsniedzot pilnas kopijas vietā tas tiek aizstāts ar vienkāršu kopsavilkumu. Palieliniet šo vērtību, ja garās aģentiskās sarunās informācijas panelī īsto ziņojumu vietā tiek rādīts vietturis.
CHAT_DEBUG_FILE false Ja vērtība ir true, serializeArtifactForStorage izlaiž uz izmēru balstītu saīsināšanu. Tikai atkļūdošanai.

17. Atmiņas optimizācija

Mainīgais Noklusējums Apraksts
OMNIROUTE_MEMORY_MB automātiski (fiziskā vidē); 1024 Docker attēlā Ieteicamais Docker/savrupā V8 kaudzes ierobežojums (MB). Ja nav iestatīts, tas tiek dinamiski kalibrēts (~35% no sistēmas RAM, ierobežojot diapazonā [512, 4096]); 512 ir tikai minimālā vērtība gadījumā, ja kopējo atmiņas apjomu nevar nolasīt. Izmantojot run-standalone.mjs (Docker CMD), skaidri norādīta vērtība tiek pievienota kā --max-old-space-size un tai ir priekšroka pār konfliktējošu NODE_OPTIONS kaudzes karodziņu (V8 pēdējā karodziņa princips). omniroute serve joprojām dod priekšroku esošam NODE_OPTIONS kaudzes iestatījumam (#5238). Neiestatiet abiem atšķirīgus skaitļus — process žurnālā reģistrē brīdinājumu, norādot abas vērtības un to, kurai ir priekšroka. Oficiālais Docker attēls vienmēr iestata 1024, tāpēc kalibrēšana tajā nekad netiek veikta. Kodēšanas aģenta /v1/responses darbībai nepieciešami 819212288, kā arī cgroup rezerve — skatiet Docker rokasgrāmatu — izpildlaika RAM.
PROMPT_CACHE_MAX_SIZE 50 Maksimālais kešoto sistēmas uzvedņu ierakstu skaits.
PROMPT_CACHE_MAX_BYTES 2097152 (2 MB) Maksimālais kopējais uzvedņu kešatmiņas lielums.
PROMPT_CACHE_TTL_MS 300000 (5 min) Uzvedņu kešatmiņas ieraksta TTL.
SEMANTIC_CACHE_MAX_SIZE 100 Maksimālais kešoto atbilžu ar temperature=0 skaits.
SEMANTIC_CACHE_MAX_BYTES 4194304 (4 MB) Maksimālais kopējais semantiskās kešatmiņas lielums.
SEMANTIC_CACHE_TTL_MS 1800000 (30 min) Semantiskās kešatmiņas ieraksta TTL.
OMNIROUTE_CORPUS_CACHE_SIZE 5 Lokālā korpusa saknes, kuru aktīvais atmiņā esošais indekss tiek vienlaikus uzturēts (src/lib/localCorpus/configured.ts). LRU: sasniedzot ierobežojumu, visilgāk neizmantotās saknes indekss tiek izmests un pārbūvēts nākamā vaicājuma laikā. Minimālā vērtība ir 1; ja vērtība nav skaitlis, tiek izmantota noklusējuma vērtība.
STREAM_HISTORY_MAX 50 Maksimālais neseno straumes notikumu skaits informācijas paneļa reāllaika skata buferī.
CONTEXT_LENGTH_DEFAULT 128000 Globālais rezerves maksimālais konteksta garums modeļiem bez skaidri norādītas konfigurācijas.
USAGE_TOKEN_BUFFER 100 Papildu marķieru rezerve, kas tiek atvēlēta lietojuma kvotu uzskaitei.

Saspiešana

Mainīgais Noklusējums Apraksts
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS nav iestatīts Uzticēties projekta .rtk/filters.json bez .rtk/trust.json jaucējvērtības. Izmantojiet tikai kontrolētā lokālās izstrādes vidē.

Atmiņas dzinis (21. plāns)

Atmiņas, prasmju un marķieru atsvaidzināšanas ietekme uz notikumu ciklu (#10349)

OmniRoute ir viens Node process. Atmiņas izgūšana/izguve, prasmju ievietošana un nodrošinātāja marķieru atsvaidzināšana darbojas tajā pašā notikumu ciklā, kurā darbojas GET /healthz un informācijas panelis. Tie nedarbojas darbinātāja pavedienā.

Darbība Kods Noklusējums Operatora vadība
Atmiņas izguve / izgūšana src/lib/memory/ Informācijas paneļa memoryEnabled (pēc noklusējuma ieslēgts) Izslēdziet sadaļā Iestatījumi → Atmiņa. Papildus funkcijas atspējošanai iestatījumos nav atsevišķa vides mainīgā avārijas slēdža.
Prasmju ievietošana src/lib/skills/injection.ts Informācijas paneļa skillsEnabled (pēc noklusējuma ieslēgts) Izslēdziet sadaļā Iestatījumi → Atmiņa/Prasmes (skillsEnabled). Tālāk norādītie smilškastes parametri tikai ierobežo izpildi pēc tam, kad ievietošana jau ir ieslēgta.
Pilnvaru atsvaidzināšana src/sse/services/tokenRefresh.ts Ieslēgta savienotajiem OAuth/tīmekļa pakalpojumu sniedzējiem Atvienojiet pakalpojumu sniedzēju vai ļaujiet pilnvarām palikt derīgām; pašlaik nav vides mainīgā TOKEN_REFRESH=0.

Ja /healthz klusā sistēmā darbojas lēni, vispirms atspējojiet atmiņu un prasmes, pēc tam pārbaudiet kataloga/saspiešanas slodzi (#10303, #9685). Šīs funkcijas atdod vadību await punktos, taču tik un tā konkurē par vienīgo pavedienu.

Iegulšanas slāņa, vektoru krātuves un pārkārtošanas parametri pastāvīgās atmiņas apakšsistēmai (src/lib/memory/).

Mainīgais Noklusējums Apraksts
MEMORY_EMBEDDING_CACHE_TTL_MS 300000 (5 min) Atmiņā esošās iegulšanas kešatmiņas TTL (katrai avota/modeļa/dimensijas signatūrai).
MEMORY_EMBEDDING_CACHE_MAX 1000 Maksimālais LRU ierakstu skaits, kas tiek glabāts iegulšanas kešatmiņā.
MEMORY_TRANSFORMERS_MODEL Xenova/all-MiniLM-L6-v2 HF repozitorija ID pēc izvēles iespējojamajam lokālajam @huggingface/transformers MiniLM konveijeram (~23 MB int8, ~400 MB RAM).
MEMORY_STATIC_MODEL minishlab/potion-base-8M HF repozitorija ID statiskajam potion/Model2Vec uzmeklēšanas tabulas iegulšanas modelim. Tas tiek atlikti lejupielādēts kešatmiņas direktorijā.
MEMORY_STATIC_CACHE_DIR <DATA_DIR>/embeddings Direktorijs, ko izmanto statiskā potion modeļa failu kešošanai. Ja nav iestatīts, pēc noklusējuma atrodas zem DATA_DIR.
HF_HUB_ENDPOINT https://huggingface.co Aizstāj Hugging Face Hub bāzes URL, ko izmanto staticPotion.ts (piem., spoguļservera galapunkts no tīkla izolētiem iestatījumiem).
MEMORY_VEC_TOP_K 20 Noklusējuma top-K, ko izmanto sqlite-vec pilnās pārlases vektoru meklēšanā failā src/lib/memory/vectorStore.ts.
MEMORY_RRF_K 60 Reciprocal Rank Fusion konstante k hibrīdajai FTS5 un vektoru izgūšanai (sqlite-vec recepte).
VECTOR_STORE_DISABLE_VEC false Testēšanas/diagnostikas pieslēgvieta funkcijā getVectorStore() (src/lib/memory/vectorStore.ts): ja vērtība ir true, vektoru krātuvei piespiedu kārtā tiek iestatīts null (simulē mākoņa/WASM vidi bez sqlite-vec), pazeminot atmiņas izgūšanu līdz FTS5 atslēgvārdu meklēšanai. Produkcijā atstājiet neiestatītu.
NOTION_API_KEY (nav iestatīts) API atslēga Notion aizmugursistēmai (to izmanto genericBackend.ts zināmās aizmugursistēmas sākotnējais iestatījums).
NOTION_API_URL https://api.notion.com/v1 Notion API bāzes URL (var aizstāt pašmitinātām Notion alternatīvām).
OBSIDIAN_API_KEY (nav iestatīts) API atslēga Obsidian Vault aizmugursistēmai (to izmanto genericBackend.ts zināmās aizmugursistēmas sākotnējais iestatījums).
OBSIDIAN_API_URL http://localhost:27123 Obsidian Vault API bāzes URL (var aizstāt attālai glabātavai).
MEMORY_TYPED_DECAY_ENABLED false TV6 tipizētās atmiņas dzēšanas galvenais slēdzis. Iespējojams pēc izvēles (pēc noklusējuma izslēgts) — tīrīšanas process dzēš novecojušās atmiņas. Ja tas ir izslēgts, access_count/last_accessed_at ir tikai telemetrija un nekas nekad netiek dzēsts.
MEMORY_TYPED_DECAY_EPISODIC_DAYS 30 TTL (dienās), pēc kura neizmantota episodic atmiņa noveco. 0 padara arī epizodisko atmiņu imūnu. Noturīgie tipi (factual/procedural/semantic) vienmēr ir imūni. Novecošanas laika atskaite tiek sākta no jauna atbilstoši last_accessed_at.
MEMORY_TYPED_DECAY_ACCESS_IMMUNITY 3 Atmiņa, kas ievietota vismaz (>=) tik reižu, kļūst imūna pret novecošanu neatkarīgi no tipa. 0 atspējo piekļuves imunitāti.
MEMORY_TYPED_DECAY_SWEEP_INTERVAL 0 (atspējots) Intervāls (sekundēs) izvēles periodiskajai novecojušo atmiņu tīrīšanai failā src/lib/memory/typedDecay.ts. 0/nav iestatīts = nav periodiskas tīrīšanas. Nepieciešama divkārša izvēles iespējošana: vajadzīgs arī MEMORY_TYPED_DECAY_ENABLED=true.
OMNIROUTE_STRICT_SYSTEM_PROVIDERS (nav iestatīts) Ar komatiem atdalīti pakalpojumu sniedzēju ID (nav reģistrjutīgi), kas pieņem system ziņojumu tikai ar indeksu 0 (src/lib/memory/injection.ts). Šiem pakalpojumu sniedzējiem kešatmiņai drošā atmiņas ievietošana masīva vidū vairāku dialoga kārtu sarunās nav droša, tāpēc atmiņa tiek apvienota/pievienota sākumā kā pirmais sistēmas ziņojums. Pēc noklusējuma ietver tikai xiaomi-mimo/mimo; papildiniet pašmitinātiem ar OpenAI saderīgiem galapunktiem (piem., Qwen3.5+/3.6), kuru tērzēšanas veidne nosaka tādu pašu ierobežojumu — viens sistēmas ziņojums sarunas sākumā.

Docker piemērs ar mazu RAM apjomu

128 ir paredzēts tikai informācijas panelim. Kodēšanas aģenti ar šādu steka atmiņas apjomu ilgstošu /v1/responses pieprasījumu laikā saņem FATAL ERROR. Neizmantojiet šo piemēru kā Claude/Codex/Grok vārteju.

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. Cenu sinhronizācija

Automātiska modeļu cenu datu sinhronizācija no ārējiem avotiem.

Mainīgais Noklusējums Avota fails Apraksts
PRICING_SYNC_ENABLED false src/lib/pricingSync.ts Periodiska cenu sinhronizācija pēc izvēles.
PRICING_SYNC_INTERVAL 86400 (24 h) src/lib/pricingSync.ts Sinhronizācijas intervāls sekundēs.
PRICING_SYNC_SOURCES litellm src/lib/pricingSync.ts Ar komatiem atdalīti datu avoti.

Arena ELO sinhronizācija

Mainīgais Noklusējums Avota fails Apraksts
ARENA_ELO_SYNC_ENABLED true src/shared/constants/featureFlagDefinitions.ts Periodiska Arena AI līderu saraksta ELO sinhronizācija, ko var konfigurēt informācijas paneļa funkciju karogos vai atspējot ar false.
MODELS_CATALOG_PREFIX_MODE dual src/shared/constants/featureFlagDefinitions.ts, src/app/api/v1/models/catalog.ts Prefiksa forma, kas tiek izmantota modeļu ID pieprasījumā GET /v1/models. dual katram modelim piedāvā gan īso aizstājvārda prefiksu, gan kanonisko nodrošinātāja prefiksu (atpakaļsaderībai — katalogs kļūst aptuveni divreiz lielāks); alias izvada vienu ID katram modelim; canonical izvada tikai pilno nodrošinātāja ID prefiksu (nodrošinātājiem, kuru aizstājvārds jau ir kanoniskais ID, tiek saglabāts vienīgais ieraksts). Klienti to var pārrakstīt katram pieprasījumam ar ?prefix=alias. Skatiet API_REFERENCE.
ARENA_ELO_SYNC_INTERVAL 86400 (24 h) src/lib/arenaEloSync.ts Sinhronizācijas intervāls sekundēs.

PromptQL Playground nodrošinātājs (neoficiāls/eksperimentāls)

Ar reverso inženieriju izveidots GraphQL sesiju tilts vietnei prompt.ql.app (src/shared/constants/providers/web-cookie.ts). Visi iestatījumi nav obligāti — pēc noklusējuma tiek izmantoti publiskie izmēģinājumu vides galapunkti; pārrakstiet tos tikai pašmitinātam vai alternatīvam PromptQL izvietojumam.

Mainīgais Noklusējums Avota fails Apraksts
PROMPTQL_GRAPHQL_ENDPOINT https://data.prompt.ql.app/promptql/playground-v2-hge/v1/graphql open-sse/executors/promptql.ts GraphQL galapunkts, ko izmanto tērzēšanas un sesiju darbībām.
PROMPTQL_CREDITS_ENDPOINT https://data.pro.ql.app/v1/graphql open-sse/executors/promptql.ts, open-sse/services/usage/promptql.ts GraphQL galapunkts kredītu atlikuma un izlietojuma vaicājumiem.
PROMPTQL_TOKEN_REFRESH_URL https://auth.pro.ql.app/ddn/project/token open-sse/executors/promptql.ts Galapunkts, ko izmanto iespēju robežās veiktai pilnvaras atsvaidzināšanai.
PROMPTQL_POLL_TIMEOUT_MS 180000 open-sse/executors/promptql.ts Maksimālais laiks (ms), cik ilgi aptaujāt thread_events pirms taimauta.

HyperAgent tīmekļa nodrošinātājs (neoficiāls/eksperimentāls)

Reversās inženierijas ceļā izveidots sesijas tilts vietnei hyperagent.com (src/shared/constants/providers/web-cookie.ts). Nav obligāts — pēc noklusējuma tiek izmantots publiskais norēķinu/lietojuma galapunkts; mainiet to tikai pašmitinātam vai alternatīvam HyperAgent izvietojumam.

Mainīgais Noklusējums Avota fails Apraksts
HYPERAGENT_USAGE_URL https://hyperagent.com/api/settings/billing/usage open-sse/services/usage/hyperagent.ts Galapunkts, ko izmanto norēķinu/lietojuma kredīta bloku iegūšanai.

Kilo Code lietojuma kvotas

Personīgā USD atlikuma un Kilo Pass lietojuma pārbaude Kilo Code nodrošinātājam. Nav obligāta — pēc noklusējuma tiek izmantota publiskā Kilo API; mainiet to tikai starpniekserverim/testa fiksācijai. Autentifikācijai tiek izmantots savienojuma esošais OAuth piekļuves marķieris.

Mainīgais Noklusējums Avota fails Apraksts
KILO_API_URL https://api.kilo.ai open-sse/services/usage/kilocode.ts Bāzes URL, ko izmanto personīgā Kilo Code atlikuma un Kilo Pass lietojuma datu iegūšanai.

Adobe Firefly tīmekļa nodrošinātājs (neoficiāls/eksperimentāls)

Pārlūkprogrammas vadīta sesijas atsvaidzināšana Adobe Firefly tīmekļa nodrošinātājam (open-sse/services/adobeFireflyBrowserLogin.ts, open-sse/services/adobeFireflySession.ts, open-sse/services/adobeFireflyClient.ts). Nav obligāta — visi noklusējumi ir pielāgoti parastai darbvirsmas instalācijai.

Noņemts versijā #9255. Veco ar CDP savienoto Chrome izpildvidi (adobeFireflyChromeRuntime.ts) aizstāja Playwright pārlūkprogrammas pieteikšanās pakalpojums, un tās iestatījumi vairs nepastāv. ADOBE_FIREFLY_CHROME_ CDP_PORT / VISIBLE / HEADED / PING / FORCE_RESTART mainīgie, kā arī ADOBE_FIREFLY_LOGIN_WAIT_MS un ADOBE_FIREFLY_FORTER_WAIT_MS, nekur kodu bāzē netiek nolasīti — to iestatīšanai nav nekādas ietekmes.

Mainīgais Noklusējums Avota fails Apraksts
ADOBE_FIREFLY_CHROME_HEADLESS 0 open-sse/services/adobeFireflyBrowserLogin.ts Iestatiet uz 1, lai izmantotu īstu bezgalvas Chrome režīmu (zināms, ka ģenerēšana tajā nedarbojas; paredzēts tikai atkļūdošanai).
ADOBE_FIREFLY_BROWSER_REFRESH 1 open-sse/services/adobeFireflySession.ts Proaktīvas pārlūkprogrammas iesildīšanas ieslēgšana/izslēgšana. 0 atspējo proaktīvo iesildīšanu (408 kļūdas atkopšana paketes vidū joprojām darbojas).
ADOBE_FIREFLY_SESSION_DISK 1 open-sse/services/adobeFireflySession.ts Iestatiet uz 0, lai atspējotu Adobe Firefly sesijas saglabāšanu diskā.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS (nav iestatīts) open-sse/services/adobeFireflySession.ts Minimālais intervāls (ms), kas tiek piemērots starp secīgiem iesniegumiem, aizstājot iebūvēto noklusējumu.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS (nav iestatīts) open-sse/services/adobeFireflySession.ts Papildu intervāls (ms), kas tiek pievienots pēc veiksmīgas paketes, aizstājot iebūvēto noklusējumu.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS (nav iestatīts) open-sse/services/adobeFireflyClient.ts Pamata aizkave (ms) pirms ģenerēšanas pieprasījuma iesniegšanas, aizstājot iebūvēto noklusējumu.

19. Modeļu sinhronizācija (izstrāde)

Mainīgais Noklusējums Avota fails Apraksts
MODELS_DEV_SYNC_ENABLED (nav iestatīts) src/lib/modelsDevSync.ts Stingra models.dev cenu sinhronizācijas pārrakstīšana. Ja nav iestatīts, tiek ņemts vērā Iestatījumi > MI (modelsDevSyncEnabled). 0/false/off/no ir prioritāte pār DB un izlaiž gan periodisko sinhronizāciju, gan getModelsDevPricing() SQL/JSON skenēšanu (atkopšanai, ja informācijas panelis ir iestrēdzis tajā pašā notikumu ciklā). 1/true/on/yes piespiedu kārtā ieslēdz sinhronizāciju. Cenu saglabāšana/notīrīšana joprojām izsauc backupDbFile("pre-write"), kas 60 minūšu ierobežojuma vai DISABLE_SQLITE_AUTO_BACKUP gadījumā neveic nekādas darbības.
MODELS_DEV_SYNC_INTERVAL 86400 (24 h) src/lib/modelsDevSync.ts Izstrādes laika modeļu kataloga sinhronizācijas intervāls sekundēs.
CONTEXT_WINDOW_RECONCILE_INTERVAL 86400 (24 h) src/lib/contextWindowResolver.ts Intervāls (sekundēs) pašlabojošajam konteksta loga saskaņotājam (5004): pakalpojumu sniedzēja deklarētos logus no /models atklāšanas fiksē kā auto:discovery pārrakstījumus, ja tie atšķiras no kataloga. Iestatiet uz 0, lai atspējotu. Atkārtoti izmanto jau sinhronizētos datus (bez jaunas izgūšanas); nekad nepārraksta manual pārrakstījumus.

20. Pakalpojumu sniedzējiem specifiski iestatījumi

Mainīgais Noklusējuma vērtība Avota fails Apraksts
OPENROUTER_CATALOG_TTL_MS 86400000 (24 h) src/lib/catalog/openrouterCatalog.ts OpenRouter modeļu kataloga kešatmiņas derīguma termiņš.
MODEL_CATALOG_INCLUDE_NAMES true src/shared/constants/featureFlagDefinitions.ts Iekļauj lietotājam saprotamus name laukus /v1/models atbildēs. Atspējojiet klientiem, kuri sagaida tikai ID.
CATALOG_BUILD_TIMEOUT_MS 8000 (8 s) src/app/api/v1/models/catalogCache.ts Aukstā ceļa gaidīšanas ierobežojums apvienotai GET /v1/models kataloga atkārtotai izveidei (#12627). Iestājoties noildzei, tiek atgriezta pēdējā derīgā 200 atbilde, ja tāda pastāv.
OMNIROUTE_SYNCED_CATALOG_STALE_AFTER_MS 2592000000 (30 dienas) src/lib/db/models/activeSyncedCatalog.ts Laiks, pēc kura savienojuma sinhronizētais modeļu saraksts vairs netiek uzskatīts par autoritatīvu maršrutēšanai un kļūmes gadījumā tiek izmantots reģistrs (#12849). Ieraksti, kuriem nekad nav piešķirts laikspiedols, tiek uzskatīti par novecojušiem.
NANOBANANA_POLL_TIMEOUT_MS 120000 open-sse/handlers/imageGeneration.ts Maksimālais NanoBanana attēlu ģenerēšanas uzdevumu gaidīšanas laiks.
NANOBANANA_POLL_INTERVAL_MS 2500 open-sse/handlers/imageGeneration.ts NanoBanana uzdevumu aptaujas biežums.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS 8000 open-sse/services/adobeFireflyUpscale.ts Pamata aizkave Adobe Firefly mērogošanas iesniegšanas atkārtoto mēģinājumu eksponenciālajai nogaidīšanai.
AWS_REGION (nav iestatīts) src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts Reģions, ko izmanto AWS Bedrock galapunktu izveidei (Kiro, audio).
AWS_DEFAULT_REGION (nav iestatīts) src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts Rezerves vērtība, ja AWS_REGION nav iestatīts.
CLOUDFLARE_ACCOUNT_ID (nav iestatīts) open-sse/executors/cloudflare-ai.ts Cloudflare Workers AI konta ID.
CLOUDFLARE_PLAYGROUND_CHROME_PATH (nav iestatīts) open-sse/executors/cloudflare-playground.ts Pilns darbvirsmas Chrome binārā faila ceļš Cloudflare AI Playground izpildītājam; tiek izmantots, ja bezgalvas režīma digitālā nospieduma pārbaude bloķē Playwright komplektācijā iekļauto Chromium.
CLOUDFLARE_API_BASE https://api.cloudflare.com/client/v4 src/app/api/settings/proxy/cloudflare-deploy/route.ts Aizstāj Cloudflare REST API bāzes adresi, ko izmanto starpniekserveru pūla Workers releja izvietošanas rīks (#4640 / 9router#1360).
NEXT_PUBLIC_CLOUDFLARE_RELAY_DEFAULT_PROJECT omniroute-relay src/app/(dashboard)/dashboard/settings/components/proxy/CloudflareRelayModal.tsx Noklusējuma Worker projekta nosaukums, kas tiek ieteikts starpniekserveru pūla modalajā logā „Izvietot releju”.
NEXT_PUBLIC_CLOUDFLARE_RELAY_ENABLED true src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx Iestatiet uz false, lai cilnē Starpniekserveru pūls paslēptu Cloudflare Workers releja opciju.
CLOUDFLARED_BIN automātiska noteikšana src/lib/cloudflaredTunnel.ts Pielāgots ceļš uz cloudflared bināro failu.
CLOUDFLARED_PROTOCOL http2 src/lib/cloudflaredTunnel.ts Tuneļa transporta protokols: http2 (noklusējums), quic vai auto.
CLOUDFLARED_CONFIG (nav iestatīts) src/lib/cloudflaredTunnel.ts Ceļš uz lokāli pārvaldītu cloudflared config.yml (ar tunnel:, credentials-file:, ingress:). Ja tas ir iestatīts, OmniRoute izpilda tunnel --config <path> run (nosaukts tunelis), nevis īslaicīgu ātro tuneli.
CLOUDFLARED_HOSTNAME (no konfigurācijas ingress) src/lib/cloudflaredTunnel.ts Nosauktā tuneļa publiskā resursdatora nosaukuma aizstāšana (piem., ai.example.com), kas tiek norādīts kā publicUrl/apiUrl. Ja tas nav iestatīts, vērtība tiek nolasīta no konfigurācijas pirmā ingress resursdatora nosaukuma.
DENO_DEPLOY_API_BASE https://api.deno.com/v2 src/app/api/settings/proxy/deno-deploy/route.ts Pārraksta Deno Deploy REST API bāzes adresi, ko izmanto starpniekserveru pūla releja izvietotājs (#4643 / 9router#1437).
NEXT_PUBLIC_DENO_RELAY_DEFAULT_PROJECT omniroute-deno-relay src/app/(dashboard)/dashboard/settings/components/proxy/DenoRelayModal.tsx Noklusējuma Deno Deploy lietotnes nosaukums, kas tiek ieteikts starpniekserveru pūla modālajā logā "Izvietot releju".
NEXT_PUBLIC_DENO_RELAY_ENABLED true src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx Iestatiet uz false, lai paslēptu Deno Deploy releja opciju cilnē Starpniekserveru pūls.
SEARCH_CACHE_TTL_MS 300000 (5 min) open-sse/services/searchCache.ts TTL meklēšanas API (Perplexity, Brave u.c.) atbilžu kešošanai.
ENABLE_CC_COMPATIBLE_PROVIDER false src/shared/utils/featureFlags.ts Parāda eksperimentālo ar CC saderīgā nodrošinātāja saskarni relejiem, kas paredzēti tikai Claude Code.
NINEROUTER_HOST 127.0.0.1 open-sse/executors/ninerouter.ts Pārraksta resursdatoru, kurā klausās iegultā 9router instance.
NINEROUTER_PORT 20130 open-sse/executors/ninerouter.ts Pārraksta portu, kurā klausās iegultā 9router instance.
EMBED_WS_PROXY_HOST 127.0.0.1 src/lib/services/embedWsProxy.ts Saistīšanas resursdators iegultā pakalpojuma WebSocket starpniekserverim (pēc noklusējuma tikai atgriezeniskā cilpa).
EMBED_WS_PROXY_PORT 20131 src/lib/services/embedWsProxy.ts Iegultā pakalpojuma WebSocket starpniekservera ports.
CLIPROXYAPI_HOST 127.0.0.1 open-sse/executors/cliproxyapi.ts CLIProxyAPI tilta resursdators (mantotā integrācija).
CLIPROXYAPI_PORT 5544 open-sse/executors/cliproxyapi.ts CLIProxyAPI tilta ports.
CLIPROXYAPI_API_KEY (tukšs) open-sse/handlers/chatCore/cliproxyapiCredentials.ts Datu plaknes rezerves atslēga, ja nav iestatījuma cliproxyapi_api_key.
CLIPROXYAPI_MANAGEMENT_KEY (tukšs) src/lib/services/cliproxyAccountHealth.ts Pārvaldības atslēga konta stāvokļa datu nolasīšanai no ārēji pārvaldītas CLIProxyAPI instances.
CLIPROXYAPI_CONFIG_DIR ~/.cli-proxy-api src/lib/versionManager/processManager.ts CLIProxyAPI konfigurācijas direktorijs.
CLIPROXY_BIND_HOST 127.0.0.1 docker-compose.yml Resursdatora saskarne, kurā docker-compose publicē cliproxyapi blakusprocesu (#12578). Tā datu sējumā glabājas nodrošinātāju OAuth/API akreditācijas dati, un piesaistītajam attēlam nav uz vides mainīgajiem balstītas datu plaknes api-keys pārrakstīšanas iespējas (tikai piemontēts config.yaml), tāpēc 0.0.0.0 padara akreditācijas datus saturošu pakalpojumu pieejamu visā LAN.
MUX_SERVICE_PORT 8322 src/lib/services/bootstrap.ts Pārraksta portu, kurā klausās iegultais Mux (coder/mux) aģentu orķestrēšanas dēmons (vienmēr 127.0.0.1).
DARIO_HOST 127.0.0.1 open-sse/executors/dario.ts Dario iegultā pakalpojuma saistīšanas/savienojuma resursdators (pēc noklusējuma tikai atgriezeniskā cilpa).
DARIO_PORT 3456 open-sse/executors/dario.ts Dario iegultā pakalpojuma ports.
DARIO_HOST 127.0.0.1 open-sse/executors/dario.ts Dario iegultā pakalpojuma saistīšanas/savienojuma resursdators (pēc noklusējuma tikai atgriezeniskā cilpa).
DARIO_PORT 3456 open-sse/executors/dario.ts Dario iegultā pakalpojuma ports.
LOCAL_HOSTNAMES (tukšs) open-sse/config/providerRegistry.ts Ar komatiem atdalīti papildu resursdatoru nosaukumi, kas tiek uzskatīti par “lokāliem” (Docker servisu nosaukumi utt.).

ENABLE_CC_COMPATIBLE_PROVIDER ir paredzēts tikai trešo pušu starpniekserveriem, kas pieņem vienīgi Claude Code klientus. OmniRoute pārraksta pieprasījumus, lai šie starpniekserveri tos pieņemtu. Ja vēlaties izmantot tikai Claude Code CLI vai neesat pārliecināts, kas ir šie starpniekserveri, atstājiet šo opciju atspējotu un tā vietā pievienojiet parastu ar Anthropic saderīgu pakalpojumu sniedzēju.


21. Starpniekserveru darbspēja

Mainīgais Noklusējuma vērtība Avota fails Apraksts
PROXY_FAST_FAIL_TIMEOUT_MS 2000 src/lib/proxyHealth.ts Ātrās atteices darbspējas pārbaudes noildze.
PROXY_LATENCY_WINDOW_HOURS 3 src/lib/db/proxies.ts Laika logs (stundās), ko izmanto kandidātstarpniekserveru vidējā latentuma aprēķināšanai latentumam optimizētajā pūla stratēģijā.
PROXY_HEALTH_CACHE_TTL_MS 30000 src/lib/proxyHealth.ts Darbspējas pārbaudes rezultātu kešatmiņas TTL.
PROXY_HEALTH_UNHEALTHY_CACHE_TTL_MS 2000 src/lib/proxyHealth.ts Kešatmiņas TTL neveiksmīgām starpniekservera darbspējas pārbaudēm. Saglabājiet to īsāku par PROXY_HEALTH_CACHE_TTL_MS, lai īslaicīgu starpniekservera noildžu gadījumā pie augstas paralēlās slodzes pārbaudes tiktu ātri atkārtotas, neatspējojot ātro atteici patiešām nestrādājošiem starpniekserveriem.
PROXY_HEALTH_ENABLED true src/lib/proxyHealth/scheduler.ts Iestatiet uz false, lai atspējotu fona starpniekserveru darbspējas plānotāju, kas periodiski pārbauda reģistrētos starpniekserverus.
PROXY_HEALTH_INTERVAL_MS 600000 src/lib/proxyHealth/scheduler.ts Fona darbspējas plānotāja pārbaudes cikla intervāls milisekundēs (minimums 60000).
PROXY_HEALTH_TEST_URL https://httpbin.org/ip src/lib/proxyHealth/probeTarget.ts Sasniedzamības pārbaudes mērķis, ko izmanto plānotājs un galapunkts /api/settings/proxies/auto-test. Norādiet iekšēju/pašmitinātu URL, lai neizmantotu publisko noklusējuma mērķi.
PROXY_HEALTH_TEST_CONCURRENCY 10 src/lib/proxyHealth/probeTarget.ts Vienlaikus katrā paketē sākto pārbaužu skaits, ko kopīgi izmanto plānotājs un galapunkts /api/settings/proxies/auto-test. Minimālā vērtība ir 1, bet maksimālā — 50.
PROXY_HEALTH_TEST_STAGGER_MS 100 src/lib/proxyHealth/probeTarget.ts Aizkave milisekundēs starp divu pārbaužu sākšanu vienā paketē. Bez tās visa pakete tiek nosūtīta vienlaikus, un koplietota izejošā IP adrese var aktivizēt mērķa ātruma ierobežojumu. Iestatiet 0, lai atspējotu intervālu; maksimālā vērtība ir 5000.
PROXY_HEALTH_USE_PROVIDER_TARGET true src/lib/proxyHealth/providerProbeTarget.ts Iestatiet "false", lai pārtrauktu pārbaudīt starpniekserverim piešķirtā pakalpojumu sniedzēja faktisko resursdatoru (GET /models, bez API atslēgas) un tā vietā vienmēr izmantotu PROXY_HEALTH_TEST_URL.
PROXY_HEALTH_AUTO_DEACTIVATE false src/lib/proxyHealth/statusPolicy.ts Ja iestatīts false (noklusējums), automatizētās sasniedzamības pārbaudes (plānotājs + /api/settings/proxies/auto-test poga "Pārbaudīt visus") ir tikai lasāmas un nekad nemaina starpniekservera statusu — tikai operators iestata to kā aktīvu/neaktīvu, tāpēc nestabila pārbaude nevar padarīt piešķirto starpniekserveri nepieejamu (#6246). Iestatiet true, lai atjaunotu iepriekšējo pārbaudīšanas un statusa iestatīšanas darbību.
PROXY_POOL_EGRESS_OBSERVATION false src/shared/utils/featureFlags.ts Izvēles funkcionalitātes karodziņš (skatiet FEATURE_FLAGS.md; informācijas paneļa DB pārrakstīšanas vērtībai ir prioritāte). true (vai 1, yes) informācijas panelī zem starpniekserveru pūla parāda tikai lasāmu pūla izejošās datplūsmas novērojumu (atšķirīgas izejošās IP adreses, savienojumus un lielāko aiz vienas IP adreses novēroto skaitu pēdējo 24 h laikā, pamatojoties uz starpniekservera žurnālu). Tas nekad netiek izmantots maršrutēšanai.
PROXY_AUTO_REMOVE false src/lib/proxyHealth/scheduler.ts Iestatiet true, lai ļautu plānotājam automātiski noņemt starpniekserverus pēc atkārtotām secīgām kļūmēm.
PROXY_AUTO_REMOVE_AFTER 3 src/lib/proxyHealth/scheduler.ts Secīgo kļūmju skaits, pēc kura plānotājs automātiski noņem starpniekserveri (ja PROXY_AUTO_REMOVE=true).
PROXY_AUTO_DISABLE false src/lib/proxyHealth/scheduler.ts Iestatiet true, lai plānotājs pēc atkārtotām secīgām kļūmēm starpniekserveri daļēji atspējotu (statuss dead, nekad netiek dzēsts), nevis noņemtu. Nesagraujoša PROXY_AUTO_REMOVE alternatīva: starpniekserveris nekavējoties tiek izslēgts no pūla/rotācijas noteikšanas (tvēruma pūla noteikšanā izmantotais aktīvā statusa filtrs to jau izslēdz) un tiek automātiski atkārtoti aktivizēts, tiklīdz tas atkal sekmīgi iztur pārbaudes. Izmanto to pašu PROXY_AUTO_REMOVE_AFTER slieksni. Ja abi karogi ir true, prioritāte ir PROXY_AUTO_REMOVE.
OMNIROUTE_CONTROL_PLANE_PROXY_DIRECT_FALLBACK false src/shared/constants/featureFlagDefinitions.ts Ļauj OAuth un nodrošinātāja validācijas plūsmām apiet piesaistītu starpniekserveri un izveidot tiešu savienojumu, ja starpniekservera sasniedzamības sākotnējās pārbaudes neizdodas. Spēkā esošā prioritāte ir: funkciju karogu datubāzes pārrakstījums > vides mainīgais > noklusējuma vērtība.
RATE_LIMIT_MAX_WAIT_MS 30000 (30 s) open-sse/services/rateLimitManager.ts Maksimālais laiks, cik ilgi gaidīt pēc 429 atbildes, pirms pieprasījums tiek uzskatīts par neizdevušos.
RATE_LIMIT_EXECUTION_MAX_WAIT_MS 600000 (10 min) open-sse/services/rateLimitManager.ts Maksimālais laiks, cik ilgi pieņemts pieprasījums drīkst palikt izpildē, pirms beidzas tā ātruma ierobežojuma rezervācija; tas ir nodalīts no rindas gaidīšanas laika budžeta, lai lēna izgūšanas sākšana neinkrementālās vārtejās neizraisītu taimautu (#12027).
RATE_LIMIT_MAX_QUEUE_DEPTH 0 (atspējots) open-sse/services/rateLimitManager.ts Rindas uzņemšanas ierobežojums: noraida ar 429 queue_full, tiklīdz rindā jau ir šāds pieprasījumu skaits. 0 = neierobežots (noklusējums).
RATE_LIMIT_AUTO_ENABLE (nav iestatīts) open-sse/services/rateLimitManager.ts Piespiedu kārtā ieslēdz vai izslēdz automātiskās ātruma ierobežošanas drošības mehānismu neatkarīgi no informācijas panelī saglabātā iestatījuma. Pieņem true/1/on, lai piespiedu kārtā ieslēgtu, un false/0/off, lai piespiedu kārtā izslēgtu.
PROVIDER_COOLDOWN_ENABLED (nav iestatīts → izslēgts) open-sse/services/providerCooldownTracker.ts Izvēles globāla, starp pieprasījumiem koplietota nodrošinātāja/savienojuma atdzišanas perioda izsekošana. Pēc noklusējuma IZSLĒGTA (pārklājas ar savienojuma atdzišanas periodu/nodrošinātāja automātisko slēdzi). Lai iespējotu, pieņem true/1/on.
PROVIDER_COOLDOWN_MIN_MS 5000 open-sse/services/providerCooldownTracker.ts Minimālais atdzišanas periods (ms), pirms atkārtoti mēģināt izmantot nodrošinātāju/savienojumu, kam radusies kļūme. Tas tiek eksponenciāli palielināts līdz ar secīgu kļūmju skaitu. Tiek izmantots tikai tad, ja ir iespējots PROVIDER_COOLDOWN_ENABLED.
PROVIDER_COOLDOWN_MAX_MS 300000 (5 min) open-sse/services/providerCooldownTracker.ts Maksimālais atdzišanas perioda ierobežojums (ms), pēc kura neizdevušos pakalpojumu sniedzēju/savienojumu mēģina izmantot atkārtoti neatkarīgi no citiem nosacījumiem. Tiek izmantots tikai tad, ja ir iespējots PROVIDER_COOLDOWN_ENABLED.
STREAM_RECOVERY_ENABLED (nav iestatīts → izslēgts) src/lib/resilience/settings.ts (sākotnējā vērtība) → open-sse/services/streamRecovery.ts (loģika) Kas tas ir: pārtrūkušu augšupstraumes straumju nemanāma atkopšana (free-claude-code ports). Sākotnējais SSE logs tiek aizturēts līdz STREAM_RECOVERY.HOLDBACK_MS (750 ms), lai pirms apstiprināšanas noticis pārrāvums — pirms kāds baits sasniedz klientu — tiktu nemanāmi atvērts no jauna un mēģināts vēlreiz. Kad iespējot: nestabilām augšupstraumēm, kas straumes sākumā bieži pārtrūkst, nenosūtot nevienu baitu; atstājiet IZSLĒGTU, ja nevarat atļauties līdz 750 ms ilgu papildu aizkavi līdz pirmajam marķierim katrā straumē. Pieņem true/1/on. Iestata sākotnējo saglabātā noturības iestatījuma vērtību; pēc konfigurēšanas prioritāte ir informācijas paneļa iestatījumam.
STREAM_RECOVERY_MIDSTREAM_ENABLED (nav iestatīts → izslēgts) src/lib/resilience/settings.ts (sākotnējā vērtība) → open-sse/services/streamRecovery.ts (loģika) Kas tas ir: turpināšana straumes vidū (4.4. fāze) — pēc pēc apstiprināšanas notikuša pārrāvuma (baiti jau sasnieguši klientu) pieprasījums tiek veikts atkārtoti, izmantojot daļējo tekstu kā asistenta iepriekšējo aizpildījumu, un trūkstošā beigu daļa tiek pievienota. Tikai ar OpenAI saderīgām vienkārša teksta straumēm; netiek aktivizēts, kamēr notiek rīka izsaukums. Kad iespējot: gariem ģenerēšanas procesiem, kas tiek pārtraukti atbildes vidū, ja piekrītat, ka atkoptā beigu daļa tiek saņemta vienā piegājienā, nevis marķieri pa vienam. Nav atkarīgs no STREAM_RECOVERY_ENABLED (atšķirīgs riska profils). Pieņem true/1/on.
STREAM_THROUGHPUT_WATCHDOG_ENABLED (nav iestatīts → izslēgts) src/lib/resilience/settings.tsopen-sse/services/throughputWatchdog.ts Pēc izvēles iespējojams aktīvās straumes lietderīgās izvades uzraugs. Nosaka straumes, kas turpina sūtīt fragmentus, bet nesasniedz konfigurēto asistenta izvades ātrumu; sirdspuksti, lietojuma notikumi, tukšas izmaiņas un rīku/spriešanas fāzes netiek kļūdaini uzskatītas par progresu. Darbojas atsevišķi no dīkstāves un absolūtā termiņa noildzēm.
STREAM_THROUGHPUT_WATCHDOG_WARMUP_MS 30000 src/lib/resilience/settings/normalize.ts Labvēlības periods pirms caurlaidspējas novērtēšanas; ierobežots līdz 0600000 ms.
STREAM_THROUGHPUT_WATCHDOG_WINDOW_MS 30000 src/lib/resilience/settings/normalize.ts Slīdošais lietderīgās izvades logs; ierobežots līdz 1000600000 ms. Pirms pārtraukšanas ir nepieciešams viens pilns logs.
STREAM_THROUGHPUT_WATCHDOG_MIN_BYTES_PER_SECOND 4 src/lib/resilience/settings/normalize.ts Minimālais UTF-8 asistenta izvades ātrums baitos (konservatīvs marķieru aizstājējrādītājs); ierobežots līdz 11000000.
STREAM_THROUGHPUT_WATCHDOG_MIN_USEFUL_BYTES 1 src/lib/resilience/settings/normalize.ts Minimālais lietderīgās izvades paraugs, kas nav nulle un tiek uzskatīts par izmērāmu; ierobežots līdz 11000000 baitiem.
HEALTHCHECK_STAGGER_MS 3000 src/lib/tokenHealthCheck.ts Nobīdes intervāls (ms) starp pakalpojumu sniedzēju marķieru darbspējas pārbaudēm palaišanas laikā.
HEALTHCHECK_JITTER_MIN_MS 500 src/lib/tokenHealthCheck.ts Minimālā nejaušinātā nobīde (ms), kas papildus HEALTHCHECK_STAGGER_MS tiek pievienota starp pakalpojumu sniedzēju marķieru darbspējas pārbaudēm, lai novērstu pieprasījumu uzplūdus (problēma #1220).
HEALTHCHECK_JITTER_MAX_MS 5000 src/lib/tokenHealthCheck.ts Maksimālā nejaušinātā nobīde (ms), kas papildus HEALTHCHECK_STAGGER_MS tiek pievienota starp pakalpojumu sniedzēju marķieru darbspējas pārbaudēm, lai novērstu pieprasījumu uzplūdus (problēma #1220).
HEALTHCHECK_BATCH_SIZE 20 src/lib/tokenHealthCheck.ts Vienlaicīgo pārbaužu paketes lielums startēšanas marķieru veselības pārbaudes ciklam; lielākas vērtības paralēli pārbauda vairāk savienojumu, savukārt mazākas vērtības samazina strauju slodzes pieaugumu (problēma #7875, #7719 regresija).
REQUEST_RETRY 2 src/sse/services/cooldownAwareRetry.ts Automātisko atkārtošanas mēģinājumu skaits modeļa tvērumā esošām nogaidīšanas atbildēm, pirms klientam tiek atgriezta kļūda.
MAX_RETRY_INTERVAL_SEC 30 src/sse/services/cooldownAwareRetry.ts Maksimālais atkāpšanās intervāls (sekundēs) starp atkārtotiem mēģinājumiem pēc nogaidīšanas. Neatkarīgi no augšupstraumes Retry-After to ierobežo šī vērtība.
HEADROOM_URL http://localhost:8787 src/lib/headroom/detect.ts Headroom marķieru taupīšanas starpniekservera URL. Informācijas paneļa dzīves cikls (api/headroom/*) pēc noklusējuma palaiž lokālu headroom-ai CLI atgriezeniskās cilpas interfeisā; mainiet tikai tad, ja jānorāda ārējs Docker blakusservisa starpniekserveris.

Straumes atkopšanas regulēšanas konstantes

Atkopšanas aiztures darbība tiek regulēta ar kodā fiksētām konstantēm failā open-sse/config/constants.ts (STREAM_RECOVERY), kas šeit parādītas uzziņai — to maiņai nepieciešams rediģēt kodu, nevis vides mainīgo:

  • STREAM_RECOVERY.HOLDBACK_MS = 750 — cik ilgi tiek aizturēts sākotnējais SSE logs, lai agrīnas apraušanas gadījumā varētu veikt atkārtotu mēģinājumu, pirms klientam tiek nosūtīts kaut viens baits.
  • STREAM_RECOVERY.BUFFER_MAX_BYTES = 65536 — aizturētā loga stingrais ierobežojums; veikt nosūtīšanu (bufera iztukšošanu + caurlaidi), tiklīdz ir uzkrāts šāds baitu skaits, neatkarīgi no taimera.
  • STREAM_RECOVERY.EARLY_RETRY_MAX = 4 — maksimālais caurspīdīgo augšupstraumes atkārtotas atvēršanas reižu skaits, kamēr aizture vēl nav nosūtīta.

Katram nodrošinātājam atsevišķs slīdošā loga ātruma ierobežojums (bez vides mainīgā): no FCC pārnestais katram nodrošinātājam atsevišķais slīdošā loga ātruma ierobežojuma rezerves mehānisms ir ietverts kodā (open-sse/services/providerDefaultRateLimit.ts, pieslēgts, izmantojot open-sse/services/rateLimitManager.ts), taču tiek piegādāts ar tukšu noklusējuma kartējumu un pašlaik tam nav operatora vides mainīgā — tas tiek iespējots tikai, izmantojot testēšanas āķi / koda labojumu. Tas ar nolūku nav iekļauts iepriekšējā tabulā. Katram (token, IP) atsevišķais releja ierobežotājs, kuram ir iestatījums, ir RELAY_IP_PER_MINUTE (§3 Tīkls un porti).


22. Atkļūdošana

Caution

Šie mainīgie rada detalizētu izvadi un var nopludināt sensitīvus datus. Nekad neiespējojiet tos produkcijas vidē.

Mainīgais Noklusējums Avota fails Apraksts
CURSOR_DEBUG (nav iestatīts) open-sse/executors/cursor.ts Iestatiet 1, lai iespējotu detalizētus Cursor izpildītāja žurnālus (atkodētus SSE fragmentus u.c.).
CURSOR_STREAM_DEBUG (nav iestatīts) open-sse/executors/cursor.ts Atpakaļsaderīgs CURSOR_DEBUG aizstājvārds.
CURSOR_DUMP_FILE (nav iestatīts) open-sse/executors/cursor.ts Neobligāts faila ceļš, kurā tiek ierakstīti neapstrādāti atkodētie Cursor fragmenti, ja CURSOR_DEBUG=1.
CURSOR_STREAM_TIMEOUT_MS 300000 open-sse/executors/cursor.ts Cursor izpildītāja straumes dīkstāves noildze (ms).
CURSOR_KV_GRACE_MS 2000 open-sse/executors/cursor.ts Pagarinājuma logs (ms) pēc composer kv_after_text mīkstā terminatora, ja buferī vēl ir baiti — dod noslēdzošajam exec_mcp rīka izsaukumam laiku pabeigt savu kadru.
CURSOR_TOOL_DIRECTIVE iespējots (!== "0") open-sse/executors/cursor.ts Rīka apstiprināšanas direktīva, kas liek composer-2.5 uzticami veikt rīku izsaukumus. Iestatiet 0, lai atspējotu.
OMNIROUTE_SYSTEM_INSTRUCTION_APPEND (nav iestatīts) open-sse/translator/request/claude-to-openai.ts, open-sse/translator/response/openai-to-claude.ts Operatora definēts sistēmas uzvednes teksts, kas tiek pievienots sistēmas ziņojumam PĒC tulkošanas (injekcija pēc tulkošanas), sasniedzot codex/Responses un /v1/messages ceļus. Tiek izmantots arī kā direktīvas prefikss, kas tiek noņemts no atbalsotajiem sistēmas preambulas blokiem. Atstājiet neiestatītu, lai atspējotu.
CURSOR_IMAGE_FETCH_TIMEOUT_MS 15000 open-sse/utils/cursorImages.ts Katra attēla ielādes noildze (ms) attālinātai image_url vizuālajai ievadei.
CURSOR_STATE_DB_PATH (noteikts pārbaudot) open-sse/utils/cursorVersionDetector.ts Aizstāj Cursor IDE stāvokļa datubāzes uzmeklēšanu, kas tiek izmantota IDE versijas noteikšanai.
CURSOR_AGENT_CLI_VERSION (noteikt / fiksēt) open-sse/utils/cursorAgentCliVersion.ts Agent CLI būvējuma identifikators (YYYY.MM.DD-<hash>) galvenei x-cursor-client-version: cli-…, izpildot Agent Run.
CURSOR_AGENT_BIN (nav iestatīts) open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts Ceļš uz Cursor Agent bināro failu, ko izmanto attēlu ģenerēšanai. Ja nav iestatīts, apstrādātājs izmanto providerSpecificData.agentBin un pēc tam PATH.
CURSOR_IMG_TIMEOUT_MS 210000 open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts Katra attēla kopējā laika ierobežojums (ms) Cursor Agent attēlu uzdevumiem.
CURSOR_IMG_MAX_CONCURRENT 2 open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts Koplietotās vietas vienlaicīguma ierobežotājs Cursor attēlu uzdevumiem.
CURSOR_IMG_MODEL pieprasījums / auto open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts Aizstāj Cursor CLI --model attēlu uzdevumiem.
UC_IMAGE_POLL_INTERVAL_MS 2000 open-sse/handlers/imageGeneration/providers/ucImage.ts UC (uncensored.com) attēlu ģenerēšanas rezultātu aptaujas intervāls (ms).
UC_IMAGE_POLL_TIMEOUT_MS 60000 open-sse/handlers/imageGeneration/providers/ucImage.ts UC attēlu ģenerēšanas rezultātu aptaujas kopējā laika ierobežojums (ms).
UC_VIDEO_POLL_INTERVAL_MS 3000 open-sse/handlers/videoGeneration/providers/ucVideo.ts UC (uncensored.com) video ģenerēšanas rezultātu aptaujas intervāls (ms).
UC_VIDEO_POLL_TIMEOUT_MS 300000 open-sse/handlers/videoGeneration/providers/ucVideo.ts UC video ģenerēšanas rezultātu aptaujas kopējā laika ierobežojums (ms).
CURSOR_DATA_DIR (noteikts pārbaudot) open-sse/utils/cursorAgentCliVersion.ts Aizstāj Cursor Agent CLI datu direktoriju (…/versions/<id>); tas ir tas pats mainīgais, ko izmanto oficiālais aģents.
CURSOR_TOKEN (nav iestatīts) scripts/ad-hoc/cursor-tap.cjs Tiešs Cursor nesēja marķieris, ko izmanto izstrādātāju rīki.
OMNIROUTE_LOG_REQUEST_SHAPE atspējots (jāiespējo ar "1") src/app/api/v1/chat/completions/route.ts Reģistrē satura tipa/garuma marķierus lielām tērzēšanas lietderīgajām slodzēm, ja ir iestatīts "1". Pēc noklusējuma izslēgts, lai samazinātu žurnāla troksni.
DEBUG_RESPONSES_SSE_TO_JSON (nav iestatīts) open-sse/handlers/responseTranslator.ts Iestatiet true, lai žurnalētu Responses API SSE→JSON tulkošanas informāciju.
DEBUG_CLAUDE_NONSTREAM (nav iestatīts) open-sse/handlers/responseTranslator.ts Iestatiet true, lai Claude atbildes tulkošanas ceļā parādītu tukšus textContent fragmentus (tikai atkļūdošanai).
NEXT_PUBLIC_OMNIROUTE_E2E_MODE (nav iestatīts) E2E testu sistēma Iestatiet true, lai iespējotu E2E testa režīmu (atvieglota autentifikācija, testa āķi).

23. GitHub integrācija

Ļaujiet lietotājiem ziņot par problēmām tieši no informācijas paneļa.

Mainīgais Noklusējums Avota fails Apraksts
GITHUB_ISSUES_REPO (nav iestatīts) src/app/api/v1/issues/report/route.ts Repozitorijs formātā owner/repo.
GITHUB_ISSUES_TOKEN (nav iestatīts) src/app/api/v1/issues/report/route.ts GitHub personiskās piekļuves pilnvara ar tvērumu issues:write.
GITHUB_TOKEN (nav iestatīts) problēmu izvērtēšanas / mākoņa aģenta palīgkomponenti Vispārīga GitHub piekļuves pilnvara, kas tiek izmantota kā GITHUB_ISSUES_TOKEN rezerves variants un ko izmanto mākoņa aģenta palīgkomponenti ceļā src/lib/cloudAgent/*.

Izvietošanas scenāriji

Norādījumus releja aizmugursistēmas SRE vajadzībām (ts/bifrost/auto darbība, 9router un CLIProxyAPI izvietojums, kā arī augstas caurlaidspējas atkāpšanās stratēģija) skatiet sadaļā Releja aizmugursistēmas stratēģija.

Minimāla lokālā izstrādes vide

JWT_SECRET=$(openssl rand -base64 48)
API_KEY_SECRET=$(openssl rand -hex 32)
INITIAL_PASSWORD=dev123
PORT=20128
NODE_ENV=development

Docker produkcijas vide

JWT_SECRET=<ģenerēts>
API_KEY_SECRET=<ģenerēts>
INITIAL_PASSWORD=<ģenerēts>
STORAGE_ENCRYPTION_KEY=<ģenerēts>
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

No tīkla izolēta vide / CI

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 ar reverso starpniekserveri (nginx + Cloudflare)

JWT_SECRET=<ģenerēts>
API_KEY_SECRET=<ģenerēts>
STORAGE_ENCRYPTION_KEY=<ģenerēts>
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. Prasmju smilškaste (v3.8.0+)

Ierobežojumi un drošības iestatījumi, kas tiek piemēroti, kad prasmju ietvars (src/lib/skills/) izpilda lietotāja definētas automatizācijas smilškastes vidē.

Mainīgais Noklusējums Avota fails Apraksts
SKILLS_SANDBOX_TIMEOUT_MS 10000 (10 s) src/lib/skills/builtins.ts Smilškastē izpildīta prasmes koda katras izpildes kopējā ilguma noildze. Stingrs ierobežojums; viss, kas darbojas ilgāk, tiek pārtraukts.
SKILLS_EXECUTION_TIMEOUT_MS (izmanto SKILLS_SANDBOX_TIMEOUT_MS, ja nav iestatīts) src/lib/skills/ Augsta līmeņa prasmju orķestrēšanas noildze. Iestatiet lielāku vērtību nekā SKILLS_SANDBOX_TIMEOUT_MS, lai atļautu daudzpakāpju darbplūsmas.
SKILLS_MAX_FILE_BYTES 1048576 (1 MB) src/lib/skills/builtins.ts Maksimālais baitu skaits, ko prasme drīkst nolasīt no viena smilškastes faila.
SKILLS_MAX_HTTP_RESPONSE_BYTES 256000 (250 KB) src/lib/skills/builtins.ts Maksimālais baitu skaits, ko drīkst tvert no vienas HTTP atbildes prasmes ietvaros.
SKILLS_MAX_SANDBOX_OUTPUT_CHARS 100000 src/lib/skills/builtins.ts Stingrs ierobežojums stdout/stderr rakstzīmju skaitam, ko atgriež smilškastes izsaukums.
SKILLS_SANDBOX_NETWORK_ENABLED false src/lib/skills/builtins.ts Iestatiet 1/true, lai atļautu izejošo tīkla savienojumu no smilškastes. Drošības nolūkos pēc noklusējuma tā ir izolēta.
SKILLS_ALLOWED_SANDBOX_IMAGES (tukšs) src/lib/skills/builtins.ts Ar komatiem atdalīts smilškastes izpildei atļauto konteineru attēlu saraksts. Tukša vērtība nozīmē, ka atļauts tikai iebūvētais noklusējuma attēls.
SKILLS_SANDBOX_DOCKER_IMAGE (iebūvētais noklusējums) src/lib/skills/ Konteinera attēls, kas tiek izmantots, palaižot Docker nodrošinātu smilškasti. Pārrakstiet, lai fiksētu pielāgotu, pastiprināti aizsargātu bāzes attēlu.
SKILLS_SANDBOX_RUNTIME auto src/lib/skills/sandbox.ts, src/lib/skills/containerProvider.ts Konteineru izpildlaika vide prasmju izolēšanai smilškastē: auto | docker | apple | wsl | orbstack | podman. auto izvēlas labāko instalēto izpildlaika vidi atbilstoši resursdatora operētājsistēmai (Apple Container/OrbStack operētājsistēmā macOS, WSL Container operētājsistēmā Windows, Podman operētājsistēmā Linux), kā rezerves variantu izmantojot Docker.

Caution

Iespējojot SKILLS_SANDBOX_NETWORK_ENABLED=true, patvaļīgam prasmes kodam tiek atvērts izejošās datplūsmas ceļš. Koplietojamos izvietojumos izmantojiet to kopā ar OUTBOUND_SSRF_GUARD_ENABLED=true un stingru CORS_ORIGIN/starpniekservera politiku.


25. Pakalpojumu sniedzēju kvotas, tuneļi, dublējumkopijas un dažādi izpildlaika iestatījumi

Pakalpojumu sniedzēju kvotu galapunkti, tīkla tuneļi (Tailscale, Ngrok, MITM atkļūdošanas starpniekserveris), 1Proxy izejošās trafika starpniekserveru kopa, datubāzes dublējumkopijas un nelieli atsevišķu funkciju pārrakstījumi, uz kuriem atsaucas izpildītāja slānis vai skripti.

Mainīgais Noklusējums Avota fails Apraksts
REDIS_URL redis://localhost:6379 src/shared/utils/rateLimiter.ts Redis savienojuma virkne ātruma ierobežotāja aizmugursistēmai.
ALIBABA_CODING_PLAN_HOST (produkcijas resursdators) open-sse/services/bailianQuotaFetcher.ts Pārraksta resursdatoru, kas tiek izmantots Alibaba Bailian programmēšanas plāna kvotu iegūšanai.
ALIBABA_CODING_PLAN_QUOTA_URL atvasināts no resursdatora open-sse/services/bailianQuotaFetcher.ts Pilnas kvotas URL pārrakstījums pakalpojumam Alibaba Bailian.
QWEN_CLOUD_COOKIE (nav iestatīts) open-sse/services/qwenTokenPlanQuotaFetcher.ts Konsoles sesijas sīkfails Qwen Cloud / Model Studio personīgā Token Plan kvotu vārtejai (secinājumu API atslēga to nevar nolasīt). Nokopējiet visu Cookie pieprasījuma galveni — tā satur login_qwencloud_ticket — no jebkura api.json izsaukuma uz cs-data.qwencloud.com vietnē home.qwencloud.com Billing Subscription (F12 Network). Sensitīvs un piesaistīts sesijai; ieteicams izmantot katram savienojumam paredzēto informācijas paneļa lauku qwenCloudCookie.
QWEN_CLOUD_SEC_TOKEN (nav iestatīts) open-sse/services/qwenTokenPlanQuotaFetcher.ts Manuāls sec_token pārrakstījums Token Plan konsoles vārtejai. Sensitīvs; ja nav iestatīts, ielādētājs to nosaka no informācijas paneļa HTML, izmantojot sīkfailu.
QWEN_TOKEN_PLAN_HOST https://cs-data.qwencloud.com open-sse/services/qwenTokenPlanQuotaFetcher.ts Vārtejas resursdatora pārrakstījums personīgā Token Plan kvotu ielādētājam (piem., bailian-singapore-cs.alibabacloud.com Model Studio konsolei).
QWEN_TOKEN_PLAN_DASHBOARD_URL https://home.qwencloud.com/ open-sse/services/qwenTokenPlanQuotaFetcher.ts Informācijas paneļa URL, kas tiek izmantots, lai noteiktu sec_token no pieteiktā lietotāja HTML.
ALIBABA_FREE_TIER_VISION_FE_PATH /costing-balance/free-quota-image-video open-sse/services/alibabaFreeTierQuotaFetcher.ts Konsoles priekšgala ceļa pārrakstījums Alibaba Model Studio bezmaksas līmeņa redzes/multivides kvotas iegūšanai.
ALIBABA_FREE_TIER_MULTIMODAL_FE_PATH /costing-balance/free-quota-multimodal open-sse/services/alibabaFreeTierQuotaFetcher.ts Konsoles priekšgala ceļa pārrakstīšana Alibaba Model Studio bezmaksas līmeņa multimodālās kvotas iegūšanai.
ALIBABA_FREE_TIER_AUDIO_FE_PATH /costing-balance/free-quota-audio open-sse/services/alibabaFreeTierQuotaFetcher.ts Konsoles priekšgala ceļa pārrakstīšana Alibaba Model Studio bezmaksas līmeņa audio kvotas iegūšanai.
ALIBABA_FREE_TIER_ALLOWLIST_PATH (nav iestatīts) open-sse/services/alibabaFreeTierAllowlist.ts Neobligāts ceļš uz lokālu JSON pārrakstīšanas failu iebūvētajam Alibaba bezmaksas līmeņa teksta modeļu atļauto vienumu sarakstam. Ja tas nav pieejams, tiek izmantots $DATA_DIR/alibaba-free-tier-allowlist.json, pēc tam config/alibaba-free-tier-allowlist.json.
CONTEXT_RESERVE_TOKENS 1024 open-sse/services/contextManager.ts Marķieri, kas, aprēķinot uzvednes budžetu, rezervēti pabeigšanas izvadei.
CONTEXT_KEEP_LATEST_IMAGES 2 open-sse/services/contextManager.ts Jaunāko iekļauto attēlu skaits, kas jāsaglabā, atmetot vecākos attēlus, lai iekļautos konteksta logā (#8560).
MODEL_ALIAS_COMPAT_ENABLED iespējots open-sse/services/model.ts Ieslēdz vai izslēdz mantoto modeļu aizstājvārdu saderības slāni, ko izmanto vecāki klienti.
OMNIROUTE_EMERGENCY_FALLBACK iespējots open-sse/services/emergencyFallback.ts Iestatiet false (vai 0), lai atspējotu ārkārtas atkāpšanās mehānismu budžeta izsmelšanas gadījumā, kas neveiksmīgos pieprasījumus pārmaršrutē uz bezmaksas nvidia/openai/gpt-oss-120b modeli. Spēkā esošā prioritāte ir: Feature Flags datubāzes pārrakstīšana > vides mainīgais > noklusējums; ja tā nav pieejama, pakalpojums atkāpjas uz neapstrādāto vides mainīgā vērtību.
COMMAND_CODE_CALLBACK_PORT (nav iestatīts) src/app/api/providers/command-code/auth/shared.ts Lokālais ports, ko izmanto OAuth stila atzvaniem no Command Code CLI palīgrīka.
COMMAND_CODE_VERSION 0.33.2 open-sse/executors/commandCode.ts Vērtība, kas tiek nosūtīta Command Code ārējam pakalpojumam kā x-command-code-version galvene. Pārrakstiet to, lai paaugstinātu CLI versiju.
COMMANDCODE_API_URL https://api.commandcode.ai open-sse/services/usage/command-code.ts Command Code lietojuma/kvotas ārējā pakalpojuma bāzes URL, ko izmanto viedtālruņa kvotu ieguvēja telemetrija. Pārrakstiet to pašmitinātai/alternatīvai Command Code API.
MITM_LOCAL_PORT 443 src/mitm/server.cjs MITM atkļūdošanas starpniekservera lokālais piesaistes ports.
MITM_DISABLE_TLS_VERIFY 0 src/mitm/server.cjs Iestatiet 1, lai atspējotu augšupstraumes TLS verifikāciju (tikai izstrādei).
MITM_IDLE_TIMEOUT_MS 60000 src/mitm/socketTimeouts.ts, src/mitm/server.cjs Dīkstāvē esoša ligzdas savienojuma taimauts (ms) starpniekotiem savienojumiem; dīkstāvē esošas ligzdas pēc šī laika tiek slēgtas, lai novērstu daļēji atvērtu tuneļu noplūdi.
MITM_VERBOSE 1 src/mitm/server.cjs, src/mitm/_internal/bypass.cjs Maršrutēšanas lēmumu žurnāla detalizācijas līmenis: 0 izslēdz žurnālu, bet lielākas vērtības reģistrē vairāk apiešanas/maršrutēšanas lēmumu.
MITM_ROOT_CA_ENABLED false src/mitm/manager.ts Iestatiet true, lai izvēlētos saknes CA un katram resursdatoram atsevišķa gala sertifikāta modeli (#6684). Jaunās instalācijās tas tiek izmantots automātiski; instalācijās ar jau esošu uzticamu mantoto gala sertifikātu tiek saglabāts mantotais fiksētais SAN sertifikāts, ja vien šis modelis netiek izvēlēts.
MITM_CERT_MODE legacy src/mitm/manager.ts, src/mitm/server.cjs MITM pārvaldnieks to iestata palaistajam starpniekservera procesam (root-ca | legacy) — tas atspoguļo sertifikātu migrācijas lēmumu un nav paredzēts manuālai iestatīšanai.
OMNIROUTE_NO_SUDO 0 src/mitm/systemCommands.ts Iestatiet 1 (patiesumvērtību), lai no MITM sertifikātu uzticamības komandām noņemtu sākumā esošo sudo — izvietojumiem bez root tiesībām vai lietotāju nosaukumtelpās, kur operators manuāli uzticas CA (piemēram, izmantojot Node papildu CA sertifikātu mehānismu).
SKIP_ANTIGRAVITY_DNS (nav iestatīts) src/mitm/dns/provision.ts Iestatiet true, lai pilnībā izlaistu /etc/hosts DNS ierakstu nodrošināšanu Antigravity starpniekservera resursdatoru nosaukumiem — konteineriem, kuros nav pieejams sudo/root.
OMNIROUTE_SKIP_DNS_WRITE (nav iestatīts) src/mitm/dns/dnsConfig.ts Iestatiet 1, lai, pievienojot vai noņemot DNS ierakstus, izlaistu rakstīšanu resursdatoru failā — smilškastes vai tikai lasāmām testēšanas vidēm.
OMNIROUTE_SKIP_SYSTEM_TRUST 0 src/mitm/cert/install.ts, src/mitm/tproxy/caTrust.ts Tikai testiem/CI paredzēts aizsargmehānisms: iestatiet 1, lai sertifikātu uzticamības instalēšana/atinstalēšana neveiktu nekādas darbības un testu komplekts nekad nemainītu OS uzticamības krātuvi. Testu iestatīšana un CI darbplūsmas to iestata automātiski.
CHANGELOG_BASE_REF (automātiski) scripts/check/check-changelog-integrity.mjs Tieša bāzes atsauces norāde pret CHANGELOG dzēšanas pārbaudei (pēc noklusējuma CI vidē tiek izmantots PR bāzes zars vai augstākais release/v*).
FREE_PROXY_AUTO_SYNC_ENABLED false src/lib/freeProxyProviders/scheduler.ts Iestatiet uz true, lai iespējotu bezmaksas starpniekserveru kopas automātiskās sinhronizācijas plānotāju fonā. Jāiespējo manuāli; pēc noklusējuma izslēgts.
FREE_PROXY_AUTO_SYNC_INTERVAL_MS 1800000 src/lib/freeProxyProviders/scheduler.ts Automātiskās sinhronizācijas intervāls milisekundēs (pēc noklusējuma 30 min).
FREE_PROXY_1PROXY_ENABLED true src/lib/freeProxyProviders/oneproxy.ts Iespējojiet 1proxy bezmaksas starpniekserveru avotu. Iestatiet uz false, lai atspējotu.
FREE_PROXY_1PROXY_API_URL (skatiet oneproxy.ts) src/lib/freeProxyProviders/oneproxy.ts 1proxy API URL pārrakstīšana.
FREE_PROXY_1PROXY_MAX 500 src/lib/freeProxyProviders/oneproxy.ts Maksimālais no 1proxy katrā sinhronizācijas reizē iegūstamo starpniekserveru skaits.
FREE_PROXY_1PROXY_MIN_QUALITY 50 src/lib/freeProxyProviders/oneproxy.ts Minimālais kvalitātes vērtējuma slieksnis importēšanai no 1proxy.
FREE_PROXY_PROXIFLY_ENABLED true src/lib/freeProxyProviders/proxifly.ts Iespējojiet Proxifly bezmaksas starpniekserveru avotu. Iestatiet uz false, lai atspējotu.
FREE_PROXY_PROXIFLY_QUANTITY 100 src/lib/freeProxyProviders/proxifly.ts Katrā Proxifly sinhronizācijas reizē iegūstamo starpniekserveru skaits.
FREE_PROXY_PROXIFLY_ANONYMITY elite src/lib/freeProxyProviders/proxifly.ts Proxifly anonimitātes līmeņa filtrs (elite, anonymous, transparent).
FREE_PROXY_IPLOCATE_ENABLED false src/lib/freeProxyProviders/iplocate.ts Iespējot IPLocate bezmaksas starpniekserveru avotu. Tikai pēc izvēles.
FREE_PROXY_IPLOCATE_BASE_URL https://raw.githubusercontent.com/iplocate/free-proxy-list/main/protocols src/lib/freeProxyProviders/iplocate.ts IPLocate starpniekserveru saraksta bāzes URL pārrakstīšana.
FREE_PROXY_WEBSHARE_ENABLED true src/lib/freeProxyProviders/webshare.ts Iespējot Webshare starpniekserveru pūla avotu. Iestatiet uz false, lai atspējotu; jābūt iestatītam arī FREE_PROXY_WEBSHARE_API_KEY.
FREE_PROXY_WEBSHARE_API_KEY (nav) src/lib/freeProxyProviders/webshare.ts Webshare konta API pilnvara (Authorization: Token <key>). Obligāta — bez tās nodrošinātājs paliek atspējots.
FREE_PROXY_WEBSHARE_API_URL https://proxy.webshare.io/api/v2/proxy/list/ src/lib/freeProxyProviders/webshare.ts Webshare starpniekserveru saraksta API URL pārrakstīšana.
FREE_PROXY_WEBSHARE_MAX 500 src/lib/freeProxyProviders/webshare.ts Maksimālais vienā Webshare sinhronizācijā importēto starpniekserveru skaits.
NEXT_PUBLIC_VERCEL_RELAY_ENABLED true src/app/(dashboard)/…/ProxyPoolTab.tsx Rādīt/slēpt pogu Izvietot Vercel Relay cilnē Starpniekserveru pūls.
VERCEL_API_BASE https://api.vercel.com src/app/api/settings/proxy/vercel-deploy/route.ts Vercel API bāzes URL pārrakstīšana (testēšanai).
NEXT_PUBLIC_VERCEL_RELAY_DEFAULT_PROJECT omniroute-relay src/app/(dashboard)/…/VercelRelayModal.tsx Noklusējuma projekta nosaukums, kas iepriekš aizpildīts Vercel Relay izvietošanas modālajā logā.
TAILSCALE_BIN (automātiska noteikšana) src/lib/tailscaleTunnel.ts Tiešs ceļš uz tailscale bināro failu.
TAILSCALED_BIN (automātiska noteikšana) src/lib/tailscaleTunnel.ts Precīzs ceļš uz tailscaled dēmona bināro failu.
TAILSCALE_AUTHKEY (nav iestatīts) src/lib/tailscaleTunnel.ts Iepriekš koplietota Tailscale autentifikācijas atslēga neinteraktīvai / bezgalvas tailscale up izpildei (nodota, izmantojot --auth-key=). Ja tā nav iestatīta, pieteikšanās izmanto interaktīvo pārlūkprogrammas autentifikācijas URL.
NGROK_AUTHTOKEN (nav iestatīts) src/lib/ngrokTunnel.ts Autentificē izejošos ngrok tuneļus.
DB_BACKUP_MAX_FILES 20 src/lib/db/backup.ts Maksimālais SQLite dublējuma failu skaits, kas tiek saglabāts manuālās/plānotās dublējumu tīrīšanas laikā. Migrācijas momentuzņēmumiem tiek izmantota satura adresācija, un identiska DB stāvokļa gadījumā tie tiek izmantoti atkārtoti; tie netiek dzēsti vienlaicīgās migrācijas loga ietvaros. Ignorē vērtību, kas saglabāta sadaļā Iestatījumi → Datubāzes dublējumu saglabāšana.
DB_BACKUP_RETENTION_DAYS 0 src/lib/db/backup.ts Maksimālais vecums (dienās) dublējumiem, kas tiek saglabāti manuālās/plānotās dublējumu tīrīšanas laikā. 0 atspējo dzēšanu pēc vecuma. Migrācijas momentuzņēmumi netiek dzēsti vienlaicīgās migrācijas loga ietvaros. Ignorē vērtību, kas saglabāta sadaļā Iestatījumi → Datubāzes dublējumu saglabāšana.
OMNIROUTE_BACKUP_SCHEDULE_JOB_INTERVAL_MS 30000 src/lib/jobs/backupScheduleJob.ts Servera puses uzdevuma, kas izpilda backup-schedule.json, cikla intervāls (ms). Tam jābūt ievērojami īsākam par cron 1 minūtes granularitāti; vērtībām, kas ir mazākas par 5000 vai nav parsējamas, tiek izmantota noklusējuma vērtība 30000.
CONTAINER_HOST docker scripts/check-permissions.sh Konteinera izpildlaika norāde ievades punkta atļauju pārbaudei. Iestatiet uz podman jebkurai Podman topoloģijai. Tā kā konteiners nevar noteikt, vai dzinis ir lokāls vai tam piekļūst, izmantojot Podman Machine, brīdinājums paliek topoloģiski neitrāls un norāda uz contrib/podman/README.md.
QUOTA_STORE_DRIVER sqlite src/lib/quota/storeFactory.ts Kvotas daļas patēriņa krātuves aizmugursistēma: sqlite (noklusējums) vai redis.
QUOTA_STORE_REDIS_URL (nav iestatīts) src/lib/quota/storeFactory.ts Redis savienojuma virkne, kas tiek izmantota, ja QUOTA_STORE_DRIVER=redis (piemēram, redis://localhost:6379).
QUOTA_SATURATION_THRESHOLD 0.5 src/lib/quota/enforce.ts Pūla piesātinājuma attiecība (0..1); sasniedzot vai pārsniedzot šo vērtību, pūls pāriet stingrajā režīmā (aizņemšanās nav atļauta).
QUOTA_SOFT_DEPRIORITIZE_FACTOR 0.7 open-sse/services/combo.ts Vērtējuma reizinātājs (0..1), kas tiek piemērots mērķim, kad elastīgā kvotu politika pazemina tā prioritāti.
STATUS_SOFT_DEPRIORITIZE_FACTOR 0.5 open-sse/services/combo/autoStrategy.ts Vērtējuma reizinātājs (0..1), kas automātiskās kombinācijas vērtēšanā tiek piemērots pakalpojumu sniedzējam ar izsmeltiem resursiem (credits_exhausted/rate_limited), ja priekšpārbaudes kvotas robežvērtība ir IZSLĒGTA (#4540).
QUOTA_CONSUMPTION_RETENTION_DAYS 14 src/lib/db/quotaConsumption.ts quota_consumption intervālu glabāšanas periods (dienās) pirms atkritumu savākšanas (gcQuotaConsumption).
QUOTA_PREFLIGHT_CUTOFF_ENABLED false src/lib/resilience/settings.ts Izvēles iestatījums (pēc noklusējuma IZSLĒGTS): iespējo automātiskās maršrutēšanas stingro kvotas robežvērtību, kas pirms vērtēšanas atmet kandidātus ar zemu kvotu.
OMNIROUTE_AUTO_FREE_FALLBACK_TO_FULL_POOL false open-sse/services/autoCombo/virtualFactory.ts Izvēles iestatījums (pēc noklusējuma IZSLĒGTS): ja auto/<category>:<tier> filtram neatbilst neviens savienots kandidāts, atjauno iepriekšējo darbību, kurā tukša kopuma atgriešanas vietā tiek izmantots pilnais (nefiltrētais) kopums. Noklusējuma iestatījums IZSLĒGTS nozīmē, ka :free ietver tikai bezmaksas līmeni.
OMNIROUTE_CHAOS_MAX_PANEL 5 open-sse/services/autoCombo/virtualFactory.ts Paneļa lieluma ierobežojums (diapazonā 110) auto/*:chaos apraides variantam — viens pieprasījums tiek izvērsts ne vairāk kā uz šo pakalpojumu sniedzēju ziņā daudzveidīgo modeļu skaitu.
OMNIROUTE_CHAOS_MIN_PANEL (dzinēja noklusējuma vērtība) open-sse/services/autoCombo/virtualFactory.ts Minimālā paneļa lieluma iestatījums, kas tiek pārsūtīts haosa apraides apstrādātājam; ja tas nav iestatīts, tiek saglabāta dzinēja noklusējuma vērtība.
OMNIROUTE_CHAOS_PANEL_TIMEOUT_MS (dzinēja noklusējuma vērtība) open-sse/services/autoCombo/virtualFactory.ts Stingrais noildzes ierobežojums (ms) visai haosa paneļa izvēršanai; ja tas nav iestatīts, tiek saglabāta dzinēja noklusējuma vērtība.
GROK_AUTH_PATH ~/.grok/auth.json open-sse/services/grokQuotaFetcher.ts Grok CLI faila auth.json ceļš, ko izmanto grok-web nedēļas kvotas iegūšanai; to var pārrakstīt testiem vai nestandarta CLI instalācijai.
AGENTBRIDGE_UPSTREAM_CA_CERT (nav iestatīts) src/mitm/manager.ts Papildu CA sertifikāts (PEM), kas tiek uzskatīts par uzticamu AgentBridge augšupstraumes TLS savienojumiem.
INSPECTOR_BUFFER_SIZE 1000 src/mitm/inspector/buffer.ts Maksimālais tverto pieprasījumu skaits, kas tiek glabāts Traffic Inspector cikliskajā buferī.
INSPECTOR_MAX_BODY_KB 1024 src/mitm/inspector/buffer.ts Maksimālais tvertā pieprasījuma/atbildes pamatteksta lielums (KB) pirms saīsināšanas.
INSPECTOR_HTTP_PROXY_PORT 8080 src/mitm/inspector/httpProxyServer.ts Traffic Inspector HTTP starpniekservera lokālais ports.
INSPECTOR_HTTP_PROXY_AUTOSTART false src/mitm/inspector/httpProxyServer.ts Automātiski palaist inspektora HTTP starpniekserveri sāknēšanas laikā.
INSPECTOR_TLS_INTERCEPT false src/lib/inspector/captureState.ts Iespējot TLS pārtveršanu (MITM) tvertajai HTTPS datplūsmai.
INSPECTOR_LLM_HOSTS_EXTRA (nav iestatīts) src/lib/inspector/captureState.ts Papildu resursdatoru nosaukumi (atdalīti ar komatiem), kas tveršanas nolūkos tiek uzskatīti par LLM galapunktiem.
INSPECTOR_MASK_SECRETS true src/mitm/inspector/buffer.ts Maskēt noslēpumus (autorizācijas galvenes/API atslēgas) tvertajā datplūsmā.
INSPECTOR_SYSTEM_PROXY_GUARD_MINUTES 30 src/app/api/tools/traffic-inspector/capture-modes/system-proxy/route.ts Minūšu skaits, pēc kura sistēmas starpniekservera aizsardzības mehānisms automātiski atjauno operētājsistēmas starpniekservera iestatījumus.
INSPECTOR_INTERNAL_INGEST_TOKEN (automātiski) src/app/api/tools/traffic-inspector/internal/ingest/route.ts Tokens, kas autentificē iekšēji tverto datu ievadi inspektorā.
PLAYGROUND_COMPARE_MAX_COLUMNS 4 src/app/(dashboard)/dashboard/playground/ Maksimālais blakus izvietoto kolonnu skaits Playground salīdzināšanas režīmā.
PLAYGROUND_IMPROVE_PROMPT_DEFAULT_MODEL (nav iestatīts) src/app/(dashboard)/dashboard/playground/ Noklusējuma modelis Playground darbībai “uzlabot uzvedni” (ja nav iestatīts, tiek izmantots aktīvais modelis).
BIFROST_ENABLED 1 src/app/api/v1/relay/chat/completions/bifrost/route.ts Galvenais Bifrost blakusprocesa starpniekservera avārijas izslēgšanas slēdzis. Ja iestatīts uz 0, maršruts atgriež 503 ar galveni X-Bifrost-Killswitch, un operators tiek novirzīts uz TS ceļu. Izmantojiet, lai atspējotu blakusprocesu bez atkārtotas izvietošanas (1. līmeņa maršrutētāja incidents, atslēgu rotācija).
BIFROST_BASE_URL (nav iestatīts) src/app/api/v1/relay/chat/completions/bifrost/route.ts Ja iestatīts, Bifrost blakusprocesa starpniekservera maršruts pārsūta /v1/chat/completions datplūsmu uz šo Go vārteju, nevis TS releja apstrādātāju. Nav iestatīts → 503 ar atkāpšanos. Beigu slīpsvītra tiek noņemta.
BIFROST_PORT 8080 src/lib/services/bootstrap.ts Ports, kuram piesaistās uzraudzītais iegultais Bifrost pakalpojums (127.0.0.1:<port>), kad OmniRoute pārvalda Bifrost blakusprocesa dzīves ciklu. Noklusējuma vērtība ir 8080.
BIFROST_API_KEY (nav iestatīts) src/app/api/v1/relay/chat/completions/bifrost/route.ts Bifrost vārtejas API atslēga (tiek nosūtīta kā Authorization: Bearer ...). Ja nav iestatīta, maršruts sagaida, ka pieprasījumā būs derīga OmniRoute API atslēga; šī atslēga paredzēta tikai autentifikācijai vārtejas pusē.
BIFROST_STREAMING_ENABLED true src/app/api/v1/relay/chat/completions/bifrost/route.ts Ja vērtība ir true, Bifrost blakusprocesa maršruts straumē atbildes atpakaļ, izmantojot SSE caur vārteju, nevis TS straumēšanas izpildītāju. Iestatiet uz 0, lai caur vārteju piespiedu kārtā izmantotu nestraumētas JSON atbildes.
BIFROST_TIMEOUT_MS 30000 src/app/api/v1/relay/chat/completions/bifrost/route.ts Katra pieprasījuma taimauts, veicot starpniekservera pārsūtīšanu uz Bifrost vārteju (ms). Iestājoties taimautam, maršruts atgriež TS releja ceļu, izmantojot galveni X-Bifrost-Fallback.
OMNIROUTE_BIFROST_KEY (nav iestatīts) src/app/api/v1/relay/chat/completions/bifrost/route.ts BIFROST_API_KEY aizstājvārds (izmanto skripti, kas nolasa vides mainīgos, izmantojot OMNIROUTE_*). Ja ir iestatīti abi, prioritāte ir BIFROST_API_KEY.
OMNIROUTE_RELAY_BACKEND ts / auto src/app/api/v1/relay/chat/completions/routingBackend.ts Releja aizmugursistēma maršrutam /api/v1/relay/chat/completions: ts | bifrost | auto. ts = TypeScript relejs (noklusējums, ja Bifrost nav konfigurēts); auto atlasa Bifrost, ja ir iestatīts BIFROST_BASE_URL un BIFROST_ENABLED0, automātiski atkāpjoties uz TS, ja blakusprocess nav sasniedzams; bifrost piespiedu kārtā izmanto Bifrost (stingri, bez atkāpšanās). Autentifikācija/ātruma ierobežošana/injekciju aizsardzība/atļauto vērtību saraksts vienmēr vispirms tiek izpildīti Next maršrutā. Atbildēs ir X-Routing-Backend / X-Routing-Fallback / X-Routing-Fallback-Reason.
RELAY_ROUTING_BACKEND (nav iestatīts) src/app/api/v1/relay/chat/completions/routingBackend.ts Pieņemts OMNIROUTE_RELAY_BACKEND aizstājvārds (tās pašas ts | bifrost | auto vērtības). Ja ir iestatīti abi, prioritāte ir OMNIROUTE_RELAY_BACKEND.
OMNIROUTE_BIFROST_FAILURE_COOLDOWN_MS 5000 src/app/api/v1/relay/chat/completions/bifrostCooldown.ts Atelpas laiks (ms) pēc Bifrost blakusprocesa pārejas kļūmes auto režīmā, pirms relejs atkārtoti mēģina izmantot blakusprocesu; kamēr ilgst atelpas laiks, pieprasījumi tiek maršrutēti tieši uz TS ceļu, bet pēc tam pārbaude tiek veikta vēlreiz. 0 atspējo. Attiecas tikai tad, ja OMNIROUTE_RELAY_BACKEND=auto.
OMNIROUTE_TLS_CERT (nav iestatīts) bin/cli/commands/serve.mjs Ceļš uz PEM TLS sertifikātu, lai apkalpotu omniroute serve, izmantojot HTTPS (līdzvērtīgs --tls-cert). Jāizmanto kopā ar OMNIROUTE_TLS_KEY; atsevišķais serveris tad terminē TLS tajā pašā klausītājā (wss:// turpina darboties bez izmaiņām). Nav iestatīts → parasts HTTP. Ja norādīts tikai sertifikāts vai atslēga vai arī ceļš nav nolasāms, tiek reģistrēts brīdinājums un tiek turpināts izmantot HTTP.
OMNIROUTE_TLS_KEY (nav iestatīts) bin/cli/commands/serve.mjs Ceļš uz PEM TLS privāto atslēgu, lai omniroute serve izmantotu HTTPS (līdzvērtīgs --tls-key). Jāizmanto kopā ar OMNIROUTE_TLS_CERT. Skatiet OMNIROUTE_TLS_CERT.
OMNIROUTE_LOCAL_ENDPOINTS_ENABLED 0 src/lib/security/localEndpoints.ts Galvenais slēdzis /api/local/* maršrutiem. Ja nav iestatīts vai tā vērtība ir 0, visi /api/local/* maršruti produkcijas vidē atgriež 503. Izvietojumos, kas neizmanto atgriezeniskās cilpas adresi, vērtībai jābūt 1, lai iespējotu Redis palaidēju un līdzīgus viena klikšķa lokālo pakalpojumu palaidējus. Papildu drošības slānis kopā ar isLocalOnlyPath() maršrutu aizsarga klasifikāciju (LOCAL_ONLY_API_PREFIXES failā src/server/authz/routeGuard.ts).
OMNIROUTE_LOCAL_ENDPOINTS_TOKEN (nav iestatīts) src/lib/security/localEndpoints.ts Bearer marķieris /api/local/* izsaucējiem, kuri neatrodas atgriezeniskās cilpas adresē (piemēram, darbvirsmas lietotnei). Ja tas ir iestatīts, pieprasījumos no IP adresēm, kas nav atgriezeniskās cilpas adreses, jābūt Authorization: Bearer <token>. Nepieciešams, ja izvietojumos, kas neizmanto atgriezeniskās cilpas adresi, ir iestatīts OMNIROUTE_LOCAL_ENDPOINTS_ENABLED=1.
OMNIROUTE_REDIS_CONTAINER_NAME omniroute-redis bin/cli/commands/redis.mjs Konteinera nosaukums viena klikšķa Redis palaidējam (omniroute redis up). To izmanto gan CLI, gan RedisLauncherPanel GUI.
OMNIROUTE_REDIS_HOST_PORT 6379 bin/cli/commands/redis.mjs Resursdatora ports viena klikšķa Redis palaidējam. Mainiet to, ja resursdators jau izmanto portu 6379. Konteinera iekšējais ports paliek 6379.
OMNIROUTE_REDIS_BIND_HOST 127.0.0.1 bin/cli/commands/redis.mjs Resursdatora saskarne, kurā viena klikšķa Redis palaidējs publicē pakalpojumu. Palaidējs startē Redis BEZ paroles, tāpēc piesaiste pie 0.0.0.0 nodrošina katram jūsu LAN resursdatoram neautentificētu piekļuvi Redis — paplašiniet piesaisti tikai tad, ja pats šai instancei iestatāt arī paroli.
REDIS_BIND_HOST 127.0.0.1 docker-compose.yml Resursdatora saskarne, kurā docker-compose publicē Redis blakusprocesu (#9286). Compose Redis darbojas bez requirepass; lietotņu konteineri tam piekļūst, izmantojot compose tīklu (redis:6379) — publicētais ports ir paredzēts tikai resursdatora puses rīkiem. 0.0.0.0 pakļauj neautentificētu Redis visam LAN.
REDIS_PORT 6379 docker-compose.yml Resursdatora ports compose Redis blakusprocesam.
APP_BIND_HOST 127.0.0.1 docker-compose.yml, docker-compose.prod.yml Resursdatora saskarne, kurā docker-compose publicē pašas lietotnes informācijas paneļa/API/live-WS portus (#12568). Tā kā .env.example pēc noklusējuma tiek piegādāts ar REQUIRE_API_KEY=false, 0.0.0.0 padara anonīmo /v1 LLM starpniekserveri pieejamu visā LAN/WAN — paplašiniet piekļuvi tikai pēc REQUIRE_API_KEY=true iestatīšanas vai tad, ja priekšā esošais reversais starpniekserveris nodrošina savu autentifikāciju.
QDRANT_BIND_HOST 127.0.0.1 docker-compose.yml Resursdatora saskarne, kurā docker-compose publicē Qdrant atmiņas blakuspakalpojumu (#12578). Uz LAN pieejamību attiecas tie paši apsvērumi kā REDIS_BIND_HOST gadījumā.
BIFROST_BIND_HOST 127.0.0.1 docker-compose.yml Resursdatora saskarne, kurā docker-compose publicē Bifrost maršrutētāja blakuspakalpojumu (#12578). Uz LAN pieejamību attiecas tie paši apsvērumi kā REDIS_BIND_HOST gadījumā.
REDIS_KEY_PREFIX omniroute: src/shared/utils/rateLimiter.ts Nosaukumvietas prefikss, kas tiek lietots katrai OmniRoute Redis atslēgai (ātruma ierobežotājam, autentifikācijas kešatmiņai, kvotu krātuvei, iesildīšanas ķēdes pārtraucējam). Novērš atslēgu kolīzijas, ja Redis instance tiek koplietota ar citām lietotnēm (#11042).
OMNIROUTE_INTERNAL_SERVICE_TOKEN (nav iestatīts — mehānisms atspējots) src/lib/api/internalServiceAuth.ts Koplietojams noslēpums identitāti saglabājošiem iekšējiem REST pārsūtījumiem (#9260): OmniRoute komponenti, kas izsauc citus lokālos OmniRoute maršrutus, nosūta to kā x-omniroute-internal-service-token, lai saglabātu sākotnējā izsaucēja identitāti. Tiek salīdzināts ar timingSafeEqual.
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE (nav iestatīts) src/lib/api/internalServiceAuth.ts Iekšējā pakalpojuma marķiera slepenā faila variants: ceļš uz failu, kura saturs pēc sākuma un beigu atstarpju noņemšanas ir marķieris. Tiek izmantots tikai tad, ja iekļautais mainīgais nav iestatīts.
OPENROUTER_PROVIDER_STATS_ENABLED true src/lib/catalog/openrouterProviderStats.ts Papildina informācijas paneļa pakalpojumu sniedzēju sarakstu ar OpenRouter nedēļas reitinga statistiku (#9324). Pēc noklusējuma ieslēgts; iestatiet false, lai pilnībā izlaistu fona izgūšanu (nebloķējoša un nekad nav fatāla).
OPENROUTER_PROVIDER_STATS_TTL_MS 86400000 (24 h) src/lib/catalog/openrouterProviderStats.ts OpenRouter pakalpojumu sniedzēju statistikas momentuzņēmuma kešatmiņas TTL milisekundēs.
OMNIROUTE_REDIS_IMAGE redis:7-alpine bin/cli/commands/redis.mjs Redis attēls, ko izmanto Redis viena klikšķa palaidējs. Pēc vajadzības aizstājiet ar redis:8-alpine vai privāta reģistra spoguli.
QDRANT_HOST qdrant (izvēles klastera profils) Qdrant blakuspakalpojuma resursdatora nosaukums, kad ir aktīvs --profile memory. Noklusējuma vērtība norāda uz tīklā esošā qdrant pakalpojuma nosaukumu; ārējai izvietošanai iestatiet citu vērtību. Tiek izmantots tikai tad, ja kodā qdrantEnabled ir true (src/lib/memory/vectorStore.ts:108).
QDRANT_PORT 6333 (izvēles klastera profils) Qdrant blakusservisa REST ports.
QDRANT_GRPC_PORT 6334 (izvēles klastera profils) Qdrant blakusservisa gRPC ports. To izmanto klientu bibliotēkas, kas straumēšanas operācijām dod priekšroku gRPC, nevis REST.
QDRANT_API_KEY (nav iestatīts) (izvēles klastera profils) Neobligāta API atslēga pakalpojumam Qdrant Cloud vai autentificētai lokālai instancei. Tukša vērtība → api-key galvene netiek nosūtīta.
QDRANT_COLLECTION omniroute-memory (izvēles klastera profils) Kolekcijas nosaukums OmniRoute sarunu atmiņas iegultnēm. Pirmajā palaišanas reizē tiek izveidota ar QDRANT_VECTOR_SIZE dimensijām.
QDRANT_EMBEDDING_MODEL text-embedding-3-small (izvēles klastera profils) Qdrant kolekcijas metadatos ierakstītais noklusējuma iegulšanas modeļa nosaukums. Faktiskās iegultnes ģenerē tas pakalpojumu sniedzējs, uz kuru norāda embeddingModel lauks OmniRoute iestatījumos.
QDRANT_VECTOR_SIZE 1536 (izvēles klastera profils) Iegulšanas vektora dimensija. Tai jāatbilst izmantotajam iegulšanas modelim (text-embedding-3-small → 1536; ada-002 → 1536; nomic-embed-text → 768).
QDRANT_HNSW_EF_CONSTRUCT 128 (izvēles klastera profils) HNSW indeksa precizitāte izveides laikā. Lielāka vērtība = lēnāka izveide, ātrāka meklēšana.
OMNIROUTE_ROTATION_ENABLED true open-sse/services/rotationConfig.ts Galvenais slēdzis operatora konfigurējamai kontu rotācijai. Ja vērtība ir false, neviena no tālāk norādītajām OMNIROUTE_ROTATE_* klasēm neaktivizē pārslēgšanos uz rezerves kontu (pilnībā izslēgtais stāvoklis bloķē arī pēc noklusējuma iespējotās 429/500/502 klases). Tas ļauj pārraugošajai priekšgalsistēmai (piemēram, VibeProxy darbvirsmas lietotnei) atspoguļot savus rotācijas noteikumus aizmugursistēmas kontu pārslēgšanas dzinējā.
OMNIROUTE_ROTATION_RATE_LIMIT_RESET_SECONDS 0 open-sse/services/rotationConfig.ts Atdzišanas periods (sekundēs), kas tiek piemērots ātruma ierobežojumu sasniegušam kontam, ja augšupstraumes pakalpojums nenorāda konkrētu atiestatīšanas laiku. 0 = fiksētas pārrakstīšanas vērtības vietā izmantot dzinēja noklusējuma atdzišanas periodu.
OMNIROUTE_ROTATION_DISABLE_TAG_WITHOUT_RESET true open-sse/services/rotationConfig.ts Priekšgalsistēmas iestatījuma „neatzīmēt kā ātruma ierobežojumu sasniegušu bez atiestatīšanas laika” atspoguļojums.
OMNIROUTE_ROTATE_ON_429 true open-sse/services/rotationConfig.ts Iespējo atkāpšanos konkrētajam statusam 429 kļūdu gadījumā. Ja iestatīts uz false (un OMNIROUTE_ROTATION_ENABLED=true), 429 vairs neizraisa konta rotāciju un tā vietā tiek atgriezts klientam.
OMNIROUTE_ROTATE_429_THRESHOLD 1 open-sse/services/rotationConfig.ts 429 kļūdu skaits periodā OMNIROUTE_ROTATE_429_WINDOW_SECONDS, kas nepieciešams, pirms tiek rotēts konts. 1 (noklusējums) izraisa tūlītēju rotāciju, saglabājot līdzšinējo darbību.
OMNIROUTE_ROTATE_429_WINDOW_SECONDS 120 open-sse/services/rotationConfig.ts Slīdošais laika logs (sekundēs), kurā 429 kļūdas tiek skaitītas attiecībā pret OMNIROUTE_ROTATE_429_THRESHOLD.
OMNIROUTE_ROTATE_ON_500 true open-sse/services/rotationConfig.ts Iespējo atkāpšanos konkrētajam statusam 5xx servera kļūdu gadījumā (izņemot 502, kam ir sava klase). Ja iestatīts uz false, šīs kļūdas vairs neizraisa konta rotāciju.
OMNIROUTE_ROTATE_500_THRESHOLD 1 open-sse/services/rotationConfig.ts 5xx kļūdu skaits periodā OMNIROUTE_ROTATE_500_WINDOW_SECONDS, kas nepieciešams, pirms tiek rotēts konts. 1 (noklusējums) izraisa tūlītēju rotāciju.
OMNIROUTE_ROTATE_500_WINDOW_SECONDS 120 open-sse/services/rotationConfig.ts Slīdošais laika logs (sekundēs), kurā 5xx kļūdas tiek skaitītas attiecībā pret OMNIROUTE_ROTATE_500_THRESHOLD.
OMNIROUTE_ROTATE_ON_502 true open-sse/services/rotationConfig.ts Iespējo atkāpšanos konkrētajam statusam 502 (nepareiza vārteja) kļūdu gadījumā. Ja iestatīts uz false, 502 kļūdas vairs neizraisa konta rotāciju.
OMNIROUTE_ROTATE_502_THRESHOLD 1 open-sse/services/rotationConfig.ts 502 kļūdu skaits periodā OMNIROUTE_ROTATE_502_WINDOW_SECONDS, kas nepieciešams, pirms tiek rotēts konts. 1 (noklusējums) izraisa tūlītēju rotāciju.
OMNIROUTE_ROTATE_502_WINDOW_SECONDS 120 open-sse/services/rotationConfig.ts Slīdošais laika logs (sekundēs), kurā 502 kļūdas tiek skaitītas attiecībā pret OMNIROUTE_ROTATE_502_THRESHOLD.
OMNIROUTE_ROTATE_ON_400 false open-sse/services/rotationConfig.ts Izvēles iestatījums (pēc noklusējuma IZSLĒGTS): ja iestatīts uz true, arī parasta 400 (nederīgs pieprasījums) kļūda izraisa konta rotāciju. Šī darbība ir tikai papildinoša — tā nekad nebloķē dzinēja esošo darbību, kurā 400, kas satur ātruma ierobežojuma vai kvotas tekstu, joprojām izraisa atkāpšanos neatkarīgi no šī karoga.
OMNIROUTE_ROTATE_400_THRESHOLD 1 open-sse/services/rotationConfig.ts 400 kļūdu skaits OMNIROUTE_ROTATE_400_WINDOW_SECONDS periodā, kas nepieciešams pirms konta rotācijas (tiek ņemts vērā tikai tad, ja OMNIROUTE_ROTATE_ON_400=true).
OMNIROUTE_ROTATE_400_WINDOW_SECONDS 120 open-sse/services/rotationConfig.ts Slīdošais logs (sekundēs), kurā 400 kļūdas tiek uzskaitītas OMNIROUTE_ROTATE_400_THRESHOLD sasniegšanai.

Claude iesildīšanas plānotājs

Cron vadīta iesildīšana Anthropic OAuth savienojumiem, kuriem tā ir iespējota, lai 5 stundu ātruma ierobežojuma logs tiktu atvērts ar vienkāršu ieplānotu pieprasījumu, nevis ar pirmo reālo pieprasījumu (#8848). Plānotājs ir izslēgts, ja vien OMNIROUTE_WARMUP_ENABLED nav patiess un savienojums nav atzīmēts sadaļā settings.claudeWarmup.connections; tukšs savienojumu saraksts nozīmē, ka nekas netiek iesildīts pat tad, ja vides mainīgais ir ieslēgts.

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_WARMUP_ENABLED (nav iestatīts → izslēgts) src/lib/warmupScheduler.ts Galvenais iesildīšanas plānotāja slēdzis. Pieņem 1/true/yes/on (nav reģistrjutīgs, atstarpes tiek noņemtas). Jebkura cita vērtība vai neiestatīta vērtība atstāj plānotāju izslēgtu.
OMNIROUTE_WARMUP_CRON 0 7 * * * src/lib/warmupScheduler.ts Piecu lauku cron izteiksme iesildīšanas aktivizēšanai, kas tiek izvērtēta laika joslā America/Los_Angeles (Anthropic atiestatīšanas laika josla) neatkarīgi no resursdatora pulksteņa.
OMNIROUTE_WARMUP_CONCURRENCY 3 src/lib/warmupScheduler.ts Savienojumu skaits, kas katrā aktivizēšanas reizē tiek iesildīti paralēli. Ierobežots diapazonā no 1 līdz 10; ja vērtība nav skaitlis, tiek izmantots 3.
OMNIROUTE_WARMUP_MODEL claude-3-5-haiku-20241022 src/lib/warmupScheduler.ts Iesildīšanas pieprasījumam izmantotais modelis. Mainiet tikai tad, ja noklusējuma modelis jūsu plānā nav pieejams; izvēlieties lētāko modeli, kas joprojām atver logu.

Pārlūkprogrammas pieteikšanās VNC sesijas un datu direktorija aizstājvārds

Konteinerizēts Chromium+VNC, ko izmanto interaktīvai pārlūkprogrammas pieteikšanās akreditācijas datu iegūšanai (/api/vnc-session), kā arī mantots DATA_DIR aizstājvārds. Viss ir neobligāts — VNC noklusējuma iestatījumi ir paredzēti komplektā iekļautajam omniroute-vnc-chromium:local attēlam un tiek mainīti tikai pielāgotam konteinera attēlam, portiem vai dzīves cikla pielāgošanai.

Mainīgais Noklusējuma vērtība Avota fails Apraksts
OMNIROUTE_VNC_IMAGE omniroute-vnc-chromium:local src/lib/vncSession/manifest.ts Docker attēla tags Chromium+VNC pieteikšanās konteineram. Izveidojiet docker/vnc-browser/chromium vai norādiet pielāgotu attēlu.
OMNIROUTE_DOCKER_BIN docker src/lib/vncSession/manifest.ts Konteinera izpildvides binārais fails, ko izmanto VNC konteinera palaišanai (piemēram, iestatiet uz podman).
OMNIROUTE_VNC_CONTAINER_VNC_PORT 3000 src/lib/vncSession/manifest.ts VNC/noVNC ports, kas pieejams konteinera iekšienē.
OMNIROUTE_VNC_CONTAINER_CDP_PORT 9223 src/lib/vncSession/manifest.ts Chrome DevTools Protocol ports konteinera iekšienē.
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR /config src/lib/vncSession/manifest.ts Chromium profila direktorija ceļš konteinera iekšienē.
OMNIROUTE_VNC_PROFILE_DIR $HOME/.omniroute/browser-login-profiles src/lib/vncSession/manifest.ts Resursdatora direktorija, kurā tiek glabāti pastāvīgie pārlūkprogrammas pieteikšanās profili.
OMNIROUTE_VNC_IDLE_MS 600000 (10 min) src/lib/vncSession/manifest.ts Dīkstāves taimauts (ms), pēc kura neaktīva VNC sesija tiek likvidēta.
OMNIROUTE_VNC_MAX_MS 1800000 (30 min) src/lib/vncSession/manifest.ts Vienas VNC sesijas maksimālā ilguma stingrais ierobežojums (ms).
OMNIROUTE_VNC_MAX_SESSIONS 4 src/lib/vncSession/manifest.ts Maksimālais vienlaicīgo VNC sesiju skaits.
OMNIROUTE_VNC_READY_MS 45000 src/lib/vncSession/manifest.ts Taimauts (ms), gaidot, līdz konteinerizētā pārlūkprogramma ir gatava CDP savienojumam.
OMNIROUTE_VNC_HARVEST_MS 20000 src/lib/vncSession/manifest.ts Taimauts (ms) tvertās sesijas/sīkdatņu iegūšanai pēc pieteikšanās pabeigšanas.
OMNIROUTE_VNC_CHROMIUM_ARGS --remote-debugging-port=9222 --no-first-run --no-default-browser-check src/lib/vncSession/manifest.ts Papildu komandrindas karodziņi, kas tiek nodoti konteinerizētajam Chromium.
OMNIROUTE_VNC_NETWORK omniroute-vnc-browser-login src/lib/vncSession/manifest.ts Atsevišķs Docker tīkls, kuram noklusējuma tilta vietā pievienojas VNC pieteikšanās konteiners (#12571), lai blakus esošie konteineri nevarētu piekļūt tā CDP tilta portam.
VIBEPROXY_DATA_DIR (nav iestatīts) open-sse/services/notionThreadSessions.ts Novecojis aizstājvārds mainīgajam DATA_DIR; tas tiek pārbaudīts tikai tad, ja nav iestatīts ne DATA_DIR, ne OMNIROUTE_DATA_DIR. Norāda Notion tīmekļa pavedienu sesiju kešatmiņas atrašanās vietu (<dir>/notion-web-thread-sessions.json).

26. Testu un E2E pārbaudes ietvars

Izmanto scripts/dev/run-next-playwright.mjs, scripts/dev/smoke-electron-packaged.mjs, scripts/dev/run-ecosystem-tests.mjs un scripts/build/uninstall.mjs. Produkcijas izvietojumos visas tālāk norādītās vērtības atstājiet neiestatītas.

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_E2E_BOOTSTRAP_MODE auth scripts/dev/run-next-playwright.mjs E2E inicializācijas režīms (auth, fresh, reuse) Playwright izpildītājam.
OMNIROUTE_E2E_PASSWORD izmanto INITIAL_PASSWORD scripts/dev/run-next-playwright.mjs Playwright vidē ievadītā administratora parole.
OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK true scripts/dev/run-next-playwright.mjs Atspējot lokālās darbspējas pārbaudes aptauju Playwright izpildes laikā.
OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK true scripts/dev/run-next-playwright.mjs Testu laikā atspējot OAuth marķieru darbspējas pārbaudes ciklu.
OMNIROUTE_HEALTHCHECK_SKIP_PROVIDERS (nav iestatīts) src/lib/tokenHealthCheck.ts Ar komatiem atdalīti pakalpojumu sniedzēji, kas izslēgti no proaktīvās marķieru atsvaidzināšanas pārbaudes (piem., codex,openai). Mērķēta alternatīva pilnīgai darbspējas pārbaudes atspējošanai — īsa TTL sniedzēji turpina atsvaidzināšanu, bet kaskādes sniedzēji darbojas tikai reaģējošā režīmā.
OMNIROUTE_HIDE_HEALTHCHECK_LOGS true scripts/dev/run-next-playwright.mjs Nerādīt darbspējas pārbaužu ziņojumus Playwright standarta izvadē.
OMNIROUTE_PLAYWRIGHT_SKIP_BUILD 0 scripts/dev/run-next-playwright.mjs Izlaist Next.js produkcijas būvējumu pirms Playwright palaišanas (CI optimizācija).
OMNIROUTE_SKIP_UNINSTALL_HOOK 0 scripts/build/uninstall.mjs Izlaist OmniRoute atinstalēšanas āķi (CI to izmanto, lai saglabātu node_modules neskartu).
ECOSYSTEM_SERVER_WAIT_MS 180000 scripts/dev/run-ecosystem-tests.mjs Gaidīšanas laiks (ms), līdz serveris kļūst darbspējīgs, pirms tiek palaisti ekosistēmas/protokola testi.
ELECTRON_SMOKE_URL http://127.0.0.1:20128/login scripts/dev/smoke-electron-packaged.mjs URL, kurā Electron ātrās pārbaudes ietvars sagaida iepakotās lietotnes darbību.
ELECTRON_SMOKE_TIMEOUT_MS 45000 scripts/dev/smoke-electron-packaged.mjs Kopējais taimauts (ms), pēc kura ātrās pārbaudes ietvars pārtrauc mēģinājumus.
ELECTRON_SMOKE_SETTLE_MS 2000 scripts/dev/smoke-electron-packaged.mjs Stabilizācijas periods (ms) pēc lapas ielādes.
ELECTRON_SMOKE_APP_EXECUTABLE (automātiski) scripts/dev/smoke-electron-packaged.mjs Precīzs ceļš uz iepakotās Electron lietotnes izpildāmo failu.
ELECTRON_SMOKE_DATA_DIR (tmpdir) scripts/dev/smoke-electron-packaged.mjs Datu direktorijs Electron ātrās pārbaudes izpildei.
ELECTRON_SMOKE_KEEP_DATA 0 scripts/dev/smoke-electron-packaged.mjs Iestatiet 1, lai pēc izpildes saglabātu pārbaudes datu direktoriju.
ELECTRON_SMOKE_STREAM_LOGS 0 scripts/dev/smoke-electron-packaged.mjs Iestatiet 1, lai izpildes laikā straumētu Electron žurnālus uz stdout.
ELECTRON_SMOKE_COLD_RESTART 0 scripts/dev/smoke-electron-packaged.mjs #7592: atkārtoti palaist ar to pašu datu direktoriju un pārbaudīt, ka otrajā palaišanas reizē tiek atlasīts vietējais SQLite draiveris.
CLI_DEVIN_BIN (PATH uzmeklēšana) open-sse/executors/devin-cli.ts Pārrakstīt Devin CLI binārā faila ceļu.

Dokumentācijas tulkošanas konveijers

Izmanto scripts/i18n/run-translation.mjs (komanda npm run i18n:run). Visi pieci mainīgie pēc noklusējuma nav iestatīti — iestatiet tos failā .env tikai tajās iekārtās, kurās jābūt iespējai palaist dokumentācijas tulkotāju.

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_TRANSLATION_API_URL (nav iestatīts) scripts/i18n/run-translation.mjs Ar OpenAI saderīgs tulkošanas aizmugursistēmas bāzes URL.
OMNIROUTE_TRANSLATION_API_KEY (nav iestatīts) scripts/i18n/run-translation.mjs Tulkošanas aizmugursistēmas Bearer pilnvara (nekad netiek reģistrēta žurnālā).
OMNIROUTE_TRANSLATION_MODEL (nav iestatīts) scripts/i18n/run-translation.mjs Modeļa ID, piemēram, gpt-4o-mini vai cx/gpt-5.4-mini.
OMNIROUTE_TRANSLATION_TIMEOUT_MS 60000 scripts/i18n/run-translation.mjs Katra pieprasījuma taimauts milisekundēs.
OMNIROUTE_TRANSLATION_CONCURRENCY 4 scripts/i18n/run-translation.mjs Paralēlie tulkošanas pieprasījumi, apstrādājot vairākus failus/lokalizācijas.

27. Radar plūsma (pašmitināšana)

Izvēles papildinājums, ko kontrolē RADAR_ENABLED funkcijas karodziņš (pēc noklusējuma izslēgts — funkcijas karodziņš, kas pārslēdzams sadaļā Settings/DB, nevis ar vides mainīgo; skatiet docs/frameworks/RADAR.md). Pirmie četri tālāk norādītie mainīgie ir neobligātas pārrakstīšanas vērtības pašmitinātai vai atzarotai plūsmai un atbalstītāja atslēgas darbplūsmām. Piektais, RADAR_ADMIN_URL, ir atsevišķa saite bez noklusējuma vērtības uz īpašnieka privāto operāciju paneli. Pilnu moduļa dokumentāciju un tā visaptverošo aktivizēšanas un vadītās iestatīšanas secību skatiet docs/frameworks/RADAR.md.

Vispārīgais Home/Changelog paziņojumu lasītājs netiek konfigurēts ar vides mainīgo un nav atkarīgs no RADAR_ENABLED funkcijas karodziņa. Tas tikai ar GET nolasa publiskā repozitorija news.json URL, kas norādīts failā src/shared/utils/releaseNotes.ts; noraidīšanas ID paliek pārlūkprogrammas lokālajā krātuvē.

Mainīgais Noklusējums Avota fails Apraksts
RADAR_FEED_URL https://radar.omniroute.online src/lib/radar/{sync,referralsSync,offersSync,intelSync}.ts Bāzes URL, ko kopīgi izmanto atsevišķi parakstītās kataloga, ieteikumu, atbalstītāju piedāvājumu un Intel plūsmas. Pārrakstiet to, lai norādītu uz pašmitinātu vai atzarotu pakalpojumu.
RADAR_FEED_PUBKEY (piesprausta noklusējuma atslēga) src/lib/radar/pinnedKeys.ts Ed25519 publiskā atslēga (base64-DER SPKI vai PEM), ko izmanto pielāgotas plūsmas parakstu pārbaudei.
RADAR_CONTRIBUTOR_CLAIM_URL https://radar.omniroute.online/auth/github src/lib/radar/links.ts URL, ko atver informācijas paneļa poga „Esmu līdzstrādnieks” (GitHub OAuth atbalstītāja atslēgas pieprasīšanas darbplūsma).
RADAR_SUPPORTER_PLANS_URL https://radar.omniroute.online/planos src/lib/radar/links.ts URL, ko atver informācijas paneļa poga „Atbalstīt projektu” (maksājumu/plānu lapa).
RADAR_ADMIN_URL (nav iestatīts) src/lib/radar/links.ts Tikai īpašniekam paredzēta saite uz privāto operāciju paneli. HTTPS ir obligāts, izņemot HTTP atgriezeniskās cilpas SSH pārsūtīšanu; neiestatītas vai nederīgas vērtības neizveido navigācijas vienumu.

Audits: noņemtie / neizmantotie mainīgie

Tālāk norādītie mainīgie bija iekļauti iepriekšējās .env.example versijās, taču pašreizējā kodu bāzē uz tiem nav izpildlaika atsauču. Tie ir noņemti:

Mainīgais Iemesls
STORAGE_DRIVER=sqlite Neviens avota fails to nelasa. SQLite ir vienīgais atbalstītais draiveris — izvēle nav nepieciešama.
INSTANCE_NAME=omniroute Ir atrodams vecajā dokumentācijā/vides veidnēs, taču izpildlaikā netiek izmantots. Tas var atgriezties nākotnes vairāku instanču funkcionalitātē.
SQLITE_MAX_SIZE_MB=2048 Avota kodā nav atsauču uz to. Datubāzes izmērs netiek mākslīgi ierobežots.
SQLITE_CLEAN_LEGACY_FILES=true Avota kodā nav atsauču uz to. Mantoto failu tīrīšana, visticamāk, tika noņemta.
CLI_ROO_BIN Nav reģistrēts failā src/shared/services/cliRuntime.ts.
CLI_KIMI_CODING_BIN Nav reģistrēts failā src/shared/services/cliRuntime.ts (Kimi Coding izmanto OAuth, nevis CLI bināro failu).
IFLOW_OAUTH_CLIENT_ID / IFLOW_OAUTH_CLIENT_SECRET Avota kodā nekur nav atsauču uz tiem.
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 Noņemti versijā v3.8.0. Izpildlaika vide vairs nelasa šos vides mainīgos — akreditācijas dati tiek iegūti no informācijas paneļa / data/provider-credentials.json / šifrētas DB.
CURSOR_PROTOBUF_DEBUG Noņemts versijā v3.8.0. Cursor izpildītājs izmanto CURSOR_DEBUG / CURSOR_STREAM_DEBUG (skatiet §22).
CLI_COMPAT_KIRO Noņemts versijā v3.8.0. Kiro ir iekļauts CLI_COMPAT_OMITTED_PROVIDER_IDS — tā pārslēgšana neko neietekmē.
QIANFAN_API_KEY Noņemts kopā ar citām neizmantotām pakalpojumu sniedzēju API atslēgu sagatavēm versijā v3.8.0.

Noklusējuma vērtību labojumi

Mainīgais Vecā .env.example vērtība Faktiskā koda noklusējuma vērtība Labojums
APP_LOG_RETENTION_DAYS 90 7 Maldinošā vērtība noņemta; 7 dokumentēta kā noklusējuma vērtība
CALL_LOG_RETENTION_DAYS 90 7 Maldinošā vērtība noņemta; 7 dokumentēta kā noklusējuma vērtība

OpenCode konfigurācijas atkārtota ģenerēšana (ad hoc rīki)

Skripts scripts/ad-hoc/regen-opencode-config.ts to izmanto, lai atkārtoti ģenerētu opencode.json ar precīzām limit.context un limit.output vērtībām, kas iegūtas no darbojošās OmniRoute instances. Nekas no tā nav nepieciešams normālai darbībai — šis skripts ir paredzēts tikai izstrādātāju rīkiem.

Mainīgais Noklusējuma vērtība Avota fails Apraksts
OMNIROUTE_URL http://localhost:20128 scripts/ad-hoc/regen-opencode-config.ts OmniRoute instances bāzes URL, kurā vaicāt /v1/models.
OMNIROUTE_KEY (nav iestatīts) scripts/ad-hoc/regen-opencode-config.ts API atslēga autentifikācijai OmniRoute galapunktā /v1/models. Ja nav iestatīta, tiek izmantota OPENCODE_API_KEY.
OPENCODE_API_KEY (nav iestatīts) scripts/ad-hoc/regen-opencode-config.ts OpenCode stila API atslēga (sk-...), kas tiek ierakstīta no jauna ģenerētajā opencode.json. Ja nav iestatīta, tiek izmantota OMNIROUTE_KEY.

Kompresijas bezsaistes novērtēšanas ietvars (ad-hoc rīki)

To izmanto scripts/compression-eval/index.ts — bezsaistes kompresijas novērtēšanas CLI. Nav nepieciešams normālai darbībai — paredzēts tikai izstrādātāju rīkiem.

Mainīgais Noklusējuma vērtība Avota fails Apraksts
OMNIROUTE_EVAL_CREDENTIALS {} (tukšs) scripts/compression-eval/index.ts Operatora nodrošināti JSON akreditācijas dati pakalpojuma sniedzējam, ko izmanto bezsaistes kompresijas novērtēšanas CLI (parsēti ar JSON.parse). Atstājiet neiestatītu izmēģinājuma palaišanai.

VNC pārlūka sesijas

To izmanto src/lib/vncSession/manifest.ts, lai konfigurētu uz Docker balstītas Chromium sesijas bez grafiskās saskarnes pārlūka automatizācijas pakalpojumu sniedzējiem. Visi mainīgie ir neobligāti — noklusējuma vērtības ir parādītas tālāk.

Mainīgais Noklusējuma vērtība Avota fails Apraksts
OMNIROUTE_DOCKER_BIN docker src/lib/vncSession/manifest.ts Ceļš uz Docker bināro failu, ko izmanto VNC konteineru palaišanai.
OMNIROUTE_VNC_IMAGE omniroute-vnc-chromium:local src/lib/vncSession/manifest.ts Docker attēls VNC Chromium konteineram.
OMNIROUTE_VNC_CHROMIUM_ARGS (iebūvētie karodziņi) src/lib/vncSession/manifest.ts Papildu Chromium CLI argumenti, kas tiek nodoti pārlūkam konteinerā.
OMNIROUTE_VNC_CONTAINER_VNC_PORT 3000 src/lib/vncSession/manifest.ts VNC ports konteinerā.
OMNIROUTE_VNC_CONTAINER_CDP_PORT 9223 src/lib/vncSession/manifest.ts Chrome DevTools Protocol ports konteinerā.
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR /config src/lib/vncSession/manifest.ts Profila direktorijs konteinerā.
OMNIROUTE_VNC_PROFILE_DIR (nav iestatīts) src/lib/vncSession/manifest.ts Resursdatora direktorijs pastāvīgiem pārlūka profiliem.
OMNIROUTE_VNC_IDLE_MS 600000 src/lib/vncSession/manifest.ts Dīkstāves taimauts (ms), pēc kura VNC sesija tiek savākta.
OMNIROUTE_VNC_MAX_MS 1800000 src/lib/vncSession/manifest.ts Maksimālais sesijas ilgums (ms).
OMNIROUTE_VNC_MAX_SESSIONS 4 src/lib/vncSession/manifest.ts Maksimālais vienlaicīgo VNC sesiju skaits.
OMNIROUTE_VNC_READY_MS 45000 src/lib/vncSession/manifest.ts Pārlūka gatavības taimauts (ms).
OMNIROUTE_VNC_HARVEST_MS 20000 src/lib/vncSession/manifest.ts Savākšanas/tīrīšanas taimauts (ms).
OMNIROUTE_VNC_NETWORK omniroute-vnc-browser-login src/lib/vncSession/manifest.ts Īpašais Docker tīkls, kuram pievienojas konteiners (#12571), apejot noklusējuma tiltu.
VIBEPROXY_DATA_DIR (nav iestatīts) open-sse/services/notionThreadSessions.ts Direktorijs Notion pavedienu sesiju pastāvīgai glabāšanai.

Iekšējo pakalpojumu autentifikācija

Mainīgais Noklusējuma vērtība Apraksts
OMNIROUTE_INTERNAL_SERVICE_TOKEN Iekļauts marķieris pārvaldības plaknes pakalpojumu savstarpējai autentifikācijai.
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE Ceļš uz failu, kurā ir iekšējā pakalpojuma marķieris (ieteicams konteineros; pārraksta iekļautā mainīgā vērtību).

OpenRouter pakalpojumu sniedzēju statistika

Mainīgais Noklusējuma vērtība Apraksts
OPENROUTER_PROVIDER_STATS_ENABLED true Iestatiet uz false, lai izlaistu OpenRouter atsevišķu pakalpojumu sniedzēju statistikas iegūšanu kataloga bagātināšanai.
OPENROUTER_PROVIDER_STATS_TTL_MS 3600000 Kešatmiņas TTL (ms) iegūtajai OpenRouter pakalpojumu sniedzēju statistikai.

Iegultā Redis piesaiste

Mainīgais Noklusējuma vērtība Apraksts
REDIS_BIND_HOST 127.0.0.1 Iegultā Redis pakalpojuma piesaistes adrese.
REDIS_PORT 6379 Iegultā Redis pakalpojuma ports.
OMNIROUTE_REDIS_BIND_HOST OmniRoute tvērumam specifiska ignorēšanas vērtība iegultā Redis piesaistes adresei.

24. Laidiena v3.8.50 papildinājumi

Šie iestatījumi tika ieviesti pēc iepriekšējā vides līguma momentuzņēmuma.

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_CHAT_ADMISSION_QUEUE_MS 2000 src/shared/middleware/chatBodyAdmission.ts Maksimālais gaidīšanas laiks resursietilpīgas tērzēšanas uzņemšanas vietas saņemšanai pirms atkārtojama 503; īsa, ierobežota gaidīšana serializē aģentu pieprasījumu uzplūdus, nevis nekavējoties atgriež 503. 0 atjauno tūlītēju noraidīšanu.
OMNIROUTE_CHAT_ADMISSION_MAX_QUEUED_BYTES 4194304 (4 MB) src/shared/middleware/chatBodyAdmission.ts Rindā ievietoto baitu budžets uzņemšanas gaidīšanai: ierobežo kopējo buferēto pieprasījumu pamattekstu baitu apjomu, kas aizturēts visa procesa mērogā, lai gaidīšana nevarētu palielināt kaudzes lietojumu (#4380). Gaidīšanas pieprasījumi, kas pārsniedz budžetu, nekavējoties saņem atkārtojamu 503.
OMNIROUTE_CHAT_VIRTUAL_TTL_MS 60000 (60 s) src/shared/middleware/chatBodyAdmission.ts Kopš #10110 novecojis un neko neveic: katras sesijas uzņemšanas joslas tika noņemtas par labu vienam visa procesa budžetam. Tiek pieņemts konfigurācijas saderībai, bet ignorēts.
OMNIROUTE_CHAT_VIRTUAL_MAX_SESSIONS 64 src/shared/middleware/chatBodyAdmission.ts Kopš #10110 novecojis un neko neveic: katras sesijas uzņemšanas joslas tika noņemtas par labu vienam visa procesa budžetam. Tiek pieņemts konfigurācijas saderībai, bet ignorēts.
OMNIROUTE_CHAT_VIRTUAL_LANES 0 (izslēgts) open-sse/services/admission/runtime.ts Adaptīvās izpildlaika virtuālās uzņemšanas joslas (#9654): galvenais slēdzis katra nomnieka adaptīvajai vārtejai (2. sistēma). Atšķiras no iepriekš minētajiem novecojušajiem katra savienojuma joslu mainīgajiem (TTL_MS / MAX_SESSIONS, kopš #10110 neko neveic). Informācijas paneļa funkcijas karodziņš ar tādu pašu nosaukumu; vides mainīgajam ir prioritāte pār informācijas paneļa pārrakstījumu; nepieciešama restartēšana.
OMNIROUTE_RUNNOW_TIMEOUT_MS 30000 src/app/api/jobs/[id]/run-now/route.ts Ierobežo, cik ilgi tūlītējas palaišanas izsaukums gaida notiekošu uzdevumu, pirms sāk rindā ievietoto izpildi.
ADOBE_FIREFLY_BROWSER_REFRESH iespējots open-sse/services/adobeFireflySession.ts Uztur IMS un pārlūkprogrammas riska stāvokli aktuālu, izmantojot kontam piesaistītas Chrome CDP sesijas; iestatiet 0, lai atspējotu.
ADOBE_FIREFLY_SESSION_DISK iespējots open-sse/services/adobeFireflySession.ts Saglabā salabotās Adobe sesijas zem DATA_DIR; iestatiet 0, lai stāvokli glabātu tikai atmiņā.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS 12000 open-sse/services/adobeFireflySession.ts Minimālais intervāls starp Adobe Firefly ģenerēšanas iesniegumiem.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS 15000 open-sse/services/adobeFireflySession.ts Papildu klusuma periods pēc katra trešā veiksmīgā Adobe iesnieguma.
ADOBE_FIREFLY_CHROME_HEADLESS 0 open-sse/services/adobeFireflyBrowserLogin.ts Tikai atkļūdošanai paredzēts pilnībā bezgalvas režīms; Adobe colligo parasti noraida tā rezultātā iegūto riska sesiju.
CHROME_PATH automātiska noteikšana open-sse/executors/cloudflare-playground.ts, open-sse/executors/chatgpt-web-codex.ts Neobligāts absolūtais ceļš uz Chrome izpildfailu, ko izmanto pārlūkprogrammas vadītie izpildītāji, ja platformas automātiskā noteikšana nav pietiekama.
TELEGRAM_BOT_TOKEN (nav iestatīts) src/lib/telegram/config.ts BotFather pilnvara, kas iespējo ienākošo tīmekļa aizķeri un paraksta Mini App initData.
TELEGRAM_WEBHOOK_SECRET (nav iestatīts) src/lib/telegram/config.ts Koplietotais noslēpums, kas reģistrēts, izmantojot setWebhook, un katrā tīmekļa aizķeres piegādē pārbaudīts pret galveni X-Telegram-Bot-Api-Secret-Token. Nepieciešams tīmekļa aizķeres ceļam; ja tas nav iestatīts, tīmekļa aizķeres piegādes tiek noraidītas ar 503.
TELEGRAM_DEFAULT_MODEL auto/chat src/lib/telegram/chatProxy.ts Telegram tērzēšanas atbildēm izmantotais modelis.
TELEGRAM_BOT_API_BASE https://api.telegram.org src/lib/telegram/config.ts Bot API bāzes URL pārrakstījums starpniekserveriem vai pašu mitinātiem Bot API serveriem.
TELEGRAM_WEBHOOK_TIMEOUT_MS 60000 src/lib/telegram/config.ts Izejošo Bot API izsaukumu taimauts milisekundēs.
OMNIROUTE_OPTIONAL_PACK_TAR 1 (iespējots) scripts/build/optionalPackStaging.mjs Iestatiet 0, lai, sagatavojot neobligātās ML/pārlūkprogrammas pakotnes Electron savrupās versijas kokam, netiktu izveidoti .tar.gz tar arhīvi (pakotņu direktoriji un optional-packs.index.json joprojām tiek izveidoti). Darbvirsmas laidiena darbplūsma to izmanto, lai samazinātu augšupielādējamo artefaktu apjomu.

ChatGPT Web (Codex)

Globālie noklusējumi bezgalvas pārlūkprogrammai un izejošajam rīku tunelim. Informācijas panelī iestatītajām savienojuma vērtībām ir prioritāte.

Mainīgais Noklusējums Avota fails Apraksts
CHATGPT_WEB_CODEX_CHROME_PATH (automātiska noteikšana) open-sse/executors/chatgpt-web-codex.ts Tiešs Chrome/Chromium ceļš npm, systemd un PM2 darbībai.
CHROME_PATH (automātiska noteikšana) open-sse/executors/chatgpt-web-codex.ts Kopīgs atkāpšanās variants tieši norādītam Chrome/Chromium ceļam.
CHATGPT_WEB_CODEX_CDP_URL (nav iestatīts) open-sse/executors/chatgpt-web-codex.ts Iekšējais CDP galapunkts; Docker izmanto blakusprocesu portā 9223.
CDP_PROXY_TOKEN (nav iestatīts) docker/chatgpt-web-codex-browser/cdp-proxy.mjs Ja iestatīts, katrā pieprasījumā CDP starpniekservera blakusprocesam šī vērtība jānosūta galvenē X-Omni-Cdp-Token (#13679). Ja vērtība nav iestatīta, starpniekserveris pārsūta pieprasījumus bez autentifikācijas — tādā gadījumā aizsardzību nodrošina tikai Compose tīkla chatgpt-web-codex-net izolācija. Ģenerējiet ar openssl rand -hex 32.
CHATGPT_WEB_CODEX_TUNNEL_ID (nav iestatīts) open-sse/executors/chatgpt-web-codex.ts Globālais OpenAI tuneļa ID lokālām Codex rīku kārtām.
CHATGPT_WEB_CODEX_RUNTIME_KEY (nav iestatīts) open-sse/executors/chatgpt-web-codex.ts Globālā tuneļa izpildlaika atslēga; nekad neizvadiet to žurnālos.
CHATGPT_WEB_CODEX_CONNECTOR_NAME OmniRoute Codex v2 open-sse/executors/chatgpt-web-codex.ts Precīzs jaunizveidotā ChatGPT pielāgotā savienotāja nosaukums MCP tiltam.
CODEX_CHATGPT_WEB_HOME <DATA_DIR>/chatgpt-web-codex open-sse/vendor/codex-chatgpt-web/config.ts Atsevišķs direktorijs pārlūka, brokera un tuneļa stāvoklim.
CODEX_CHATGPT_WEB_BROWSER_DIAGNOSTICS 0 open-sse/vendor/codex-chatgpt-web/adapters/chatgpt-web/browser-worker.ts Ja vērtība ir 1, katrā kontrolpunktā tiek uzņemti pārlūka diagnostikas attēli.
CODEX_CHATGPT_WEB_LAUNCHER (nav iestatīts) open-sse/vendor/codex-chatgpt-web/config.ts Neobligāts absolūtais ceļš uz pastāvīgu palaidēja bināro failu.
CODEX_CHATGPT_WEB_BUN (automātiska noteikšana) open-sse/vendor/codex-chatgpt-web/config.ts Neobligāts absolūtais ceļš uz Bun izpildlaika bināro failu.
CODEX_WEB_GPT_BUN (nav iestatīts) open-sse/vendor/codex-chatgpt-web/config.ts Mantotais atkāpšanās variants mainīgajam CODEX_CHATGPT_WEB_BUN; jaunās konfigurācijās izmanto kanonisko nosaukumu.

OmniConductor tilts

Ilgstošs SSE patērētājs, kas atspoguļo OmniConductor centrmezgla uzdevumus lokālajā A2A TaskManager (src/lib/conductor/). Izvēles funkcija — tilts tiek palaists tikai tad, ja ir iestatīts CONDUCTOR_HUB_URL. Tikai servera pusē: centrmezgla marķieris nekad nedrīkst nonākt pārlūkprogrammā.

Mainīgais Noklusējums Avota fails Apraksts
CONDUCTOR_HUB_URL (tukšs) src/lib/conductor/boot.ts OmniConductor centrmezgla bāzes URL (piem., http://127.0.0.1:7910). Nav iestatīts = tilts atspējots.
CONDUCTOR_HUB_TOKEN (tukšs) src/lib/conductor/boot.ts Centrmezgla akreditācijas dati SSE plūsmai — centrmezglā izveidojiet spokesperson veida līdzinieku (POST /v1/peers, administratora piekļuve).
CONDUCTOR_ORCHESTRATOR_TOKEN (tukšs) src/lib/conductor/hubProxy.ts Akreditācijas dati ienākošo A2A→centrmezgla uzdevumu deleģēšanai (POST /v1/tasks); ja nav iestatīts, tiek izmantots CONDUCTOR_HUB_TOKEN.
CONDUCTOR_SPOKESPERSON_URL http://127.0.0.1:7920 src/lib/conductor/faroProxy.ts Spokesperson (Faro) pakalpojuma bāzes URL, kas atrodas aiz informācijas paneļa tērzēšanas starpniekservera (/api/conductor/ask).

Kvotu ņemoša plānošana

Izmanto open-sse/services/combo.ts un src/lib/quota/quotaScheduler.ts, lai pirms pieprasījuma pārbaudītu marķieru budžetu. Izvēles funkcija — ja tā nav iestatīta, noklusējuma maršrutēšanas darbība nemainās.

Mainīgais Noklusējums Avota fails Apraksts
OMNIROUTE_QUOTA_AWARE_ROUTING 0 open-sse/services/combo.ts Ja vērtība ir 1, izlaiž savienojumus, kuru katra perioda marķieru budžets (rateLimitOverrides.tpm, tabula provider_quota_state) pirms nosūtīšanas nevar segt aplēstās pieprasījuma izmaksas. Ja budžets nav konfigurēts, pieprasījums netiek bloķēts.