OmniRoute/docs/i18n/lt/docs/reference/ENVIRONMENT.md

Environment Variables Reference (Lietuvių)

🌐 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 · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

Išsamus visų „OmniRoute“ atpažįstamų aplinkos kintamųjų žinynas. Greitosios pradžios šabloną rasite .env.example.

Important

Kiekvienas čia aprašytas kintamasis taip pat turi būti pateiktas faile .env.example, o kiekvienas .env.example kintamasis turi būti aprašytas čia. npm run check:env-doc-sync užtikrina šio reikalavimo laikymąsi atliekant commit ir CI procese. Jei kintamąjį norite sąmoningai praleisti, įtraukite jį į leidžiamųjų sąrašą faile scripts/check/check-env-doc-sync.mjs.

---

Turinys

• 1. Privalomos paslaptys
• 2. Saugykla ir duomenų bazė
• 3. Tinklas ir prievadai
• 4. Saugumas ir autentifikavimas
• 5. Įvesties valymas ir AII apsauga
• 6. Įrankių ir maršruto parinkimo strategijos
• 7. URL ir sinchronizavimas su debesija
• 8. Išeinantis tarpinis serveris
• 9. CLI įrankių integravimas
• 10. Vidinio agento ir MCP integracijos
• 11. OAuth teikėjų prisijungimo duomenys
• 12. Teikėjų User-Agent perrašymai
• 13. CLI kontrolinio kodo suderinamumas
• 14. API rakto teikėjai
• 15. Skirtojo laiko nuostatos
• 16. Žurnalų tvarkymas
• 17. Atminties optimizavimas
• 18. Kainodaros sinchronizavimas
• 19. Modelių sinchronizavimas (kūrimas)
• 20. Teikėjams būdingos nuostatos
• 21. Tarpinio serverio būklė
• 22. Derinimas
• 23. GitHub integracija
• 24. Įgūdžių smėlio dėžė (v3.8.0+)
• 27. „Radar“ sklaidos kanalas (savarankiškas priegloba)
• Diegimo scenarijai
• Auditas: pašalinti / nebenaudojami kintamieji

---

1. Privalomos paslaptys

Jos privalo būti nustatytos prieš pirmąjį paleidimą. Be jų programa arba atsisakys paleisti, arba veiks naudodama nesaugias numatytąsias nuostatas.

Kintamasis	Privalomas	Numatytoji reikšmė	Šaltinio failas	Aprašymas
JWT_SECRET	Taip	(nėra)	src/lib/auth	Pasirašo ir patikrina visus valdymo skydelio seanso slapukus (JWT). Sugeneruokite naudodami openssl rand -base64 48.
API_KEY_SECRET	Taip	(nėra)	src/lib/db/apiKeys.ts	AES šifravimo raktas, skirtas neaktyvioms API raktų reikšmėms SQLite duomenų bazėje. Sugeneruokite naudodami openssl rand -hex 32.
INITIAL_PASSWORD	Taip	CHANGEME	Paleidimo scenarijus	Nustato pradinį administratoriaus valdymo skydelio slaptažodį (atitinka numatytąją .env.example reikšmę — ji sąmoningai palikta akivaizdžiai nesaugi, kad būtų privaloma ją pakeisti). Pakeiskite prieš naudodami pirmą kartą. Prisijungę pakeiskite per Valdymo skydelis → Nustatymai → Saugumas.
OMNIROUTE_WS_BRIDGE_SECRET	Taip (gamyboje)	(nenustatyta)	src/app/api/internal/codex-responses-ws/route.ts	Bendrasis vidinio Codex Responses WebSocket tilto slaptasis raktas. Autentifikuoja tilto užklausas tarp Electron / naršyklės WS perdavimo modulio ir OmniRoute. ⚠️ PRIVALOMAS gamyboje — kai nenustatytas, visos WS tilto užklausos atmetamos. Sugeneruokite naudodami openssl rand -base64 32.
OMNIROUTE_SW_BUILD_ID	Ne	(git SHA)	next.config.mjs, scripts/build/assembleStandalone.mjs	Aiškiai nurodytas paslaugų modulio podėlio atnaujinimo identifikatorius, skirtas PWA apvalkalui (#11779); pirmasis reikšmės nustatymo grandinėje.
SOURCE_VERSION	Ne	(nenustatyta)	next.config.mjs, scripts/build/assembleStandalone.mjs	Antrasis grandinėje — jį PaaS kūrimo sistemos (pvz., Heroku tipo) nustato kaip įdiegtą įvykdymą.
NEXT_PUBLIC_SW_BUILD_ID	Ne	(išvedama)	src/shared/components/PwaRegister.tsx	Kūrimo metu nustatoma viešoji reikšmė, kurią klientas naudoja registruodamas /sw.js?v=…; išvedama iš dviejų pirmiau nurodytų reikšmių, o tada iš git SHA.
OMNIROUTE_PEER_STAMP_TOKEN	Ne (automatiškai)	(automatiškai kiekvieno paleidimo metu)	src/server/authz/policies/management.ts	Kiekvieno proceso slaptasis raktas, įrodantis, kad patikima lygiaverčio mazgo IP žyma gauta iš paties OmniRoute HTTP serverio (scripts/dev/peer-stamp.mjs). authz tarpinė programinė įranga užklausos vietiškumu (LOCAL_ONLY maršrutų ribojimu iki grįžtamosios sąsajos / LAN) pasitiki tik tada, kai žymoje yra šis prieigos raktas. Automatiškai sugeneruojamas kiekvieno paleidimo metu — palikite nenustatytą; fiksuokite tik kelių procesų konfigūracijose, kurioms būtina bendrinti šią žymą.

Generavimo komandos

# Sugeneruokite visus keturis slaptuosius raktus vienu metu:
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

Niekada neįtraukite .env failų su tikrais slaptaisiais raktais į versijų valdymo sistemą. .gitignore jau neįtraukia .env, tačiau prieš išsiųsdami pakeitimus tai patikrinkite.

---

2. Saugykla ir duomenų bazė

OmniRoute visiems nuolatiniams duomenims saugoti naudoja SQLite (per better-sqlite3). Šie kintamieji valdo duomenų vietą, šifravimą ir gyvavimo ciklą.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
DATA_DIR	~/.omniroute/	src/lib/db/core.ts	Šakninis SQLite DB, atsarginių kopijų ir duomenų failų katalogas. Nurodykite kitą reikšmę Docker tomams arba pasirinktiniams keliams.
OMNIROUTE_ALLOW_DEFAULT_DATA_DIR	(nenustatyta)	src/lib/dataPaths.ts	Išimties mechanizmas, skirtas testų / vertinimo DATA_DIR apsaugai (#10428). Testai ir Node vertinimo / išvedimo patikros (-e/--eval/-p/--print, įskaitant --eval=/--print= formas), kuriuose nėra DATA_DIR, nukreipiami į vienkartinį laikinąjį katalogą, kad negalėtų atverti tikrosios operatoriaus duomenų bazės; nustatykite 1, kad vėl būtų naudojamas tikrasis katalogas.
OMNIROUTE_BUILD_SHA	(nenustatyta)	src/lib/monitoring/buildSha.ts	Vykdomo artefakto Git SHA. Įrašomas vykdant npm run build:release; gali būti įterptas konteineriuose, pateikiamuose be dist/BUILD_SHA kontrolinio failo. Pateikiamas kaip system.buildSha adresu /api/monitoring/health.
OMNIROUTE_RELEASE_REF	origin/main	scripts/build/buildProvenance.ts	Nuoroda, su kuria artefakto pakavimo kilmės patikra palygina komponavimo SHA (#10427).
OMNIROUTE_ALLOW_CANARY_BUILD	(nenustatyta)	scripts/build/buildProvenance.ts	Nustatykite 1, kad būtų leidžiama supakuoti komponuotę, kurios SHA nėra leidimo šakoje, pažymint ją kaip sąmoningai sukurtą bandomąją versiją, užuot atmetus ją patikros metu (#10427).
OMNIROUTE_SMOKE_API_KEY	(nenustatyta)	scripts/ops/deploy-canary.mjs	API raktas, skirtas bandomojo diegimo bazinės patikros užklausai, siunčiamas kaip Authorization: Bearer į /v1/chat/completions. Naudojamas tik diegimo scenarijaus (#10429), o ne serverio. Nesusijęs su pasirenkamos CLI bazinių patikrų sistemos OMNIROUTE_SMOKE_* kintamaisiais (RUN_CLI_SMOKE=1, OMNIROUTE_SMOKE_BASE_URL/MODEL/API_KEY_ENV/TARGETS/TIMEOUT_MS, esančiais tests/integration/upstream-cli-smoke.int.test.ts) — žr. CLI integracijos → Tikroji bazinių patikrų serija.
OMNIROUTE_BUILDING	(nenustatyta)	src/lib/buildPhase.ts	Komponavimo etapo signalas (#10060): scripts/build/build-next-isolated.mjs nustato jį į 1, o reikšmę paveldi kiekvienas paleistas komponavimo vykdytojas, todėl DB sluoksnis grąžina nieko nedarantį pakaitalą, užuot įkėlęs savąjį better-sqlite3 papildinį (dėl kurio vykdytojas nutraukiamas baigiant darbą). Niekada nenustatomas veikiančiame serveryje.
OMNIROUTE_SKIP_NATIVE_DEP_CHECK	0	scripts/check/check-native-deps.mjs	Nustatykite 1, kad nestandartiniuose į projektą įtrauktuose priklausomybių medžiuose būtų praleista pasirinktinė savųjų priklausomybių išankstinė komponavimo patikra. Dėl to trūkstama priklausomybė netampa sukomponuojama; naudokite tik tada, kai savosios priklausomybės pateikiamos atskirai.
OMNIROUTE_DATA_DIR	(nenustatyta)	open-sse/executors/promptql/threadSticky.ts	Atsarginis pseudonimas, skirtas DATA_DIR; tikrinamas tik tada, kai DATA_DIR nenustatytas. Naudojamas PromptQL vykdytojo diske esančiai su gija susietų seansų podėlio vietai (<dir>/promptql-thread-sessions.json) nustatyti; jei nenustatytas nė vienas kintamasis, podėlis lieka tik atmintyje (neišsaugomas tarp paleidimų iš naujo).
OMNIROUTE_PLUGINS_DIR	(nenustatyta)	src/lib/plugins/scanner.ts	Katalogas, kurį skaito vykdymo metu veikiantis papildinių skaitytuvas, ir šakninis katalogas, į kurį papildinių tvarkytuvė diegia papildinius; ši reikšmė pakeičia pagal namų katalogą nustatomą numatytąją reikšmę (#11827). Docker/K8s aplinkoje nukreipkite jį į prijungtą papildinių medį, užuot keitę HOME vien tam, kad perkeltumėte nuskaitymo kelią (HOME taip pat valdo visą kitą su namų katalogu susijusią elgseną). Nenustatyta = ~/.omniroute/plugins arba /tmp/.omniroute/plugins, kai procesas apskritai neeksportuoja namų katalogo — šis kintamasis pašalina tylų papildinių neaptikimą. Nustatytas katalogas paleidžiant vieną kartą įrašomas žurnale kaip scanner.dir_resolved kartu su pasirinkta įvesties reikšme. Tik serverio pusėje: CLI komandų papildiniai ir toliau naudoja savo OMNIROUTE_PLUGIN_PATH (9 skyrius).
STORAGE_ENCRYPTION_KEY	(tuščia = išjungta)	src/lib/db/encryption.ts	AES raktas, skirtas visos SQLite duomenų bazės ramybės būsenos šifravimui. Sugeneruokite naudodami openssl rand -hex 32.
STORAGE_ENCRYPTION_KEY_VERSION	v1	scripts/build/bootstrap-env.mjs, electron/main.js	Šifravimo rakto versijos žyma. Atlikdami rakto rotaciją padidinkite ją, kad būtų galima iššifruoti senas atsargines kopijas.
DISABLE_SQLITE_AUTO_BACKUP	false	src/lib/db/backup.ts	Kai nustatyta true, praleidžiamas įprastas / prieš įrašymą atliekamas SQLite failo atsarginių kopijų kūrimas (models.dev kainodaros išsaugojimas / išvalymas, nustatymų įrašymas). Rankinės ir prieš atkūrimą kuriamos atsarginės kopijos vis tiek vykdomos. Tai neišjungia privalomos ilgalaikės saugos momentinės kopijos, kurią sukuria migracijų vykdyklė, ar masinės migracijos apsaugos esamai nuolatinei DB. Nerankinės atsarginės kopijos kuriamos ne dažniau kaip kartą per 60 minučių. Valdymo skydelyje Nustatymai → Saugykla galima nepriklausomai išjungti įprastą automatinį atsarginių kopijų kūrimą.
OMNIROUTE_CRYPT_KEY	(nenustatyta)	src/lib/db/encryption.ts	Pasenęs alternatyvus pavadinimas, skirtas STORAGE_ENCRYPTION_KEY. Naudojamas kaip atsarginė reikšmė, kai pagrindinio kintamojo nėra.
OMNIROUTE_API_KEY_BASE64	(nenustatyta)	src/lib/db/encryption.ts	Pasenęs alternatyvus pavadinimas (Base64 užkoduota forma), priimamas kaip atsarginė reikšmė. Prieš naudojant automatiškai iškoduojamas.
OMNIROUTE_DB_HEALTHCHECK_INTERVAL_MS	(nenustatyta)	src/lib/db/core.ts	Periodinio SQLite būklės tikrinimo intervalo (ms) perrašymas. Kai nenustatyta, numatytosios reikšmės nustatomos pagal NODE_ENV.
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS	21600000 (6 val.)	src/lib/db/walMaintenance.ts	Periodinio wal_checkpoint(TRUNCATE) intervalo (ms) perrašymas. Automatinis kontrolinio taško kūrimas niekada nesumažina paties WAL failo, o ilgai veikiantis serveris niekada neuždaro savo DB. 0 išjungia.
OMNIROUTE_WAL_PASSIVE_INTERVAL_MS	300000 (5 min.)	src/lib/db/walMaintenance.ts	Dažno wal_checkpoint(PASSIVE) intervalo (ms) perrašymas. Laukiančių WAL kadrų skaičius išlaikomas mažas, kad periodinė TRUNCATE operacija pagrindinėje gijoje niekada nekopijuotų kelių GB susikaupusių duomenų. 0 išjungia.
OMNIROUTE_WAL_GUARD_MAX_MB	256	src/lib/db/walMaintenance.ts	Kai PASSIVE ciklas aptinka, kad WAL failas viršija šį dydį, nedelsiant pereinama prie wal_checkpoint(TRUNCATE), užuot laukus lėtojo ciklo.
OMNIROUTE_PRESSURE_SELF_RESTART	false	open-sse/utils/resourcePressure.ts	Nustatykite 1/true/yes/on, kad procesas būtų užbaigtas po to, kai kritinis išteklių trūkumas tęsiasi OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS laikotarpį, taip leidžiant prižiūrinčiajai sistemai (systemd Restart=always, Docker paleidimo iš naujo strategijai) paleisti švarų procesą, užuot neribotai teikus 503 atsakymus.
OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS	120000 (2 min.)	open-sse/utils/resourcePressure.ts	Laikas, kurį turi tęstis kritinis išteklių trūkumas prieš suaktyvinant savarankiško paleidimo iš naujo užbaigimą.
OMNIROUTE_SQLJS_WASM_PATH	(automatinis aptikimas)	src/lib/db/adapters/sqljsAdapter.ts	Aiškiai nurodytas kelias (absoliutus arba santykinis cwd atžvilgiu) iki sql-wasm.wasm, kai naudojamas atsarginis sql.js WASM adapteris. Kai nenustatyta, automatiškai aptinkamas pagal paketo priklausomybes ir galimus išdėstymus.
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS	21600000 (6 val.)	src/lib/db/core.ts	Periodinio wal_checkpoint(TRUNCATE) intervalo (ms) perrašymas. Automatinis kontrolinio taško kūrimas niekada nesumažina paties WAL failo, o ilgai veikiantis serveris niekada neuždaro savo DB. 0 išjungia.
OMNIROUTE_BATCH_RETENTION_DAYS	30	src/lib/db/cleanup.ts	Dienų skaičius, kurį užbaigtos būsenos (įvykdytos / nepavykusios / atšauktos / pasibaigusios) Batch API užduoties kontroliniai taškai, nurodyti įvesties / išvesties / klaidų failai ir eilutė saugomi iki automatinio valymo metu atliekamo pašalinimo. Įsigalioja tik įjungus BATCH_AND_FILE_AUTO_CLEANUP_ENABLED; atitinka pačios OpenAI Batch API išvesties saugojimo laikotarpį. Tai neturi įtakos operatoriaus inicijuojamam maršrutui DELETE /api/v1/batches/delete-completed, kuris pagal numatytąją veikseną lieka besąlyginis (be amžiaus filtro).
BATCH_AND_FILE_AUTO_CLEANUP_ENABLED	false	src/lib/db/cleanup.ts	Kai nustatyta true, automatinio valymo procesui leidžiama ištrinti užbaigtas Batch API užduotis (ir jų kontrolinius taškus), senesnes nei OMNIROUTE_BATCH_RETENTION_DAYS, bei išvalyti įkeltų failų, kurių expires_at jau praėjo, BLOB turinį. Pagal numatytuosius nustatymus išjungta: visuose esamuose diegimuose šie duomenys išsaugomi lygiai taip pat kaip anksčiau, kol operatorius šios funkcijos neįjungia. Tai taip pat per valdymo skydelį redaguojamas funkcijos jungiklis — žr. docs/reference/FEATURE_FLAGS.md → Vykdymo aplinka.
OMNIROUTE_SKIP_DB_HEALTHCHECK	0	src/lib/db/core.ts, src/lib/db/healthCheck.ts	Nustatykite į 1, kad paleidimo metu būtų visiškai praleista DB būklės patikra. Naudinga trumpalaikėms užduotims ir integraciniams testams.
OMNIROUTE_FORCE_DB_HEALTHCHECK	0	src/lib/db/core.ts	Nustatykite į 1, kad DB būklės patikros ciklas būtų vykdomas priverstinai, net kai įprastai jis būtų praleistas (pvz., vykdant trumpalaikes užduotis).
OMNIROUTE_SKIP_POSTINSTALL	0	scripts/postinstall.mjs	Nustatykite į 1, kad vykdant npm install būtų praleistas savosios vykdymo aplinkos parengimas. Naudinga CI diegimuose ar diegimuose be grafinės sąsajos, kuriuose sqlite jau sukompiliuota.
OMNIROUTE_MIGRATIONS_DIR	(aptinkama automatiškai)	src/lib/db/migrationRunner.ts	Pakeiskite katalogą, kurį nuskaito migracijų vykdyklė. Naudinga pasirinktiniuose dariniuose pateikiant į paketą įtrauktas migracijas.
OMNIROUTE_EXTRA_MIGRATIONS_DIRS	(nenustatyta)	src/lib/db/migrationRunner/extraDirs.ts	Papildomi migracijų katalogai, nurodyti kaip namespace=dir įrašai ir atskirti platformos kelių skyrikliu (pvz., ee=/opt/app/enterprise/db/migrations). Ten rasti failai registruojami kaip <namespace>-<number>, todėl platinamas paketas su nuosavomis migracijomis niekada nesusiduria su pirminio projekto skaitiniais intervalais. Dėl netinkamai suformuoto įrašo, netinkamos vardų srities ar trūkstamo katalogo paleidimo metu pateikiama klaida, užuot tyliai praleidus schemą.
OMNIROUTE_MAX_PENDING_MIGRATIONS	50	src/lib/db/migrationRunner.ts	Didelio laukiančių migracijų skaičiaus saugos slenkstis (#3416). Paleidimas nutraukiamas, jei esamoje DB laukia daugiau migracijų nei nurodyta (tai apsaugo nuo išvalytos sekimo lentelės). Padidinkite reikšmę norėdami atkurti senesnę atsarginę kopiją; nustatykite į 0, kad patikra būtų išjungta.
OMNIROUTE_INSTALL_UPGRADE_WORKDIR	(<repo>/.install-upgrade)	scripts/check/check-install-upgrade.mjs	check:install-upgrade leidimo patikros darbo katalogas. Jam reikia maždaug 12 GB (dviejų ~3 GB diegimo medžių ir tar archyvo), todėl jo negalima vykdyti mažoje tmpfs — savarankiškai talpinamoje vykdyklėje /tmp yra 12 GB RAM pagrįsta tmpfs, kurią patikra perpildė, todėl paketas buvo sutrumpintas.
OMNIROUTE_SPEND_FLUSH_INTERVAL_MS	(numatytoji reikšmė kode)	src/lib/spend/batchWriter.ts	Paketinio išlaidų ir sąnaudų įrašymo modulio išvalymo intervalas (ms). Mažesnės reikšmės sumažina įrašų sujungimą, o didesnės — DB konkurenciją dėl išteklių.
OMNIROUTE_SPEND_MAX_BUFFER_SIZE	(numatytoji reikšmė kode)	src/lib/spend/batchWriter.ts	Didžiausias buferyje laikomų išlaidų įrašų skaičius prieš priverstinį išvalymą. Padidinkite didelio QPS diegimuose; sumažinkite, kai apribotas atminties naudojimas yra svarbesnis.
OMNIROUTE_PROXY_FETCH_DEBUG	(nenustatyta)	open-sse/utils/proxyFetch.ts	Nustatykite į "true", kad Vercel perdavimo kelyje būtų pateikiami [ProxyFetch] derinimo žurnalai. Pagal numatytuosius nustatymus išjungta, kad nebūtų atskleisti maršruto parinkimo duomenys.
PROXY_LOG_INCLUDE_IPS	false	src/lib/proxyLogger.ts	Nustatykite į "true" arba "1", kad į išsamią [ProxyEgress] proceso žurnalo eilutę būtų įtraukti kliento / išėjimo IP adresai ir paskyros prefiksas. Pagal numatytuosius nustatymus palikta IŠJUNGTA, kad proceso žurnale nebūtų atskleisti IP adresai ar paskyros prefiksas.
OMNIROUTE_DEBUG	(nenustatyta)	bin/cli/commands/quota.mjs	Nustatykite į 1, kad CLI kvotos komandos į stderr išvestų kiekvienos užklausos trukmės diagnostiką ([omniroute] GET <path> completed in Nms).
OMNIROUTE_HEALTHCHECK_PATH	(automatiškai)	scripts/dev/healthcheck.mjs	Aiškiai nurodytas kelias, kurį tikrina konteinerio būklės patikra. Jei nenustatyta, patikra jį išveda iš OMNIROUTE_BASE_PATH; nustačius šią reikšmę vėl naudojamas išsamus stebėsenos galinis taškas.
OMNIROUTE_DEBUG_COMPLETION	(nenustatyta)	bin/cli/commands/completion.mjs	Nustatykite bet kokią netuščią reikšmę, kad iš CLI apvalkalo automatinio užbaigimo podėlio kelių (skaitymo / atnaujinimo / rašymo) būtų pateikiama [omniroute completion] diagnostika. Pagal numatytuosius nustatymus išjungta — šių podėlių klaidos nutildomos, todėl trūkstamas ar sugadintas podėlis niekada nesutrikdo automatinio užbaigimo tabuliavimo klavišu.
BATCH_RETRY_DURATION_MS	86400000 (24 val.)	open-sse/services/batchProcessor.ts	Didžiausias atskirų paketinio apdorojimo elementų pakartotinių bandymų laikotarpis (ms). Šią trukmę viršiję elementai pažymimi kaip nepavykę.
BATCH_BACKOFF_BASE_MS	5000	open-sse/services/batchProcessor.ts	Bazinis delsos laikas (ms), taikomas eksponentiniam delsos didinimui pakartotinai apdorojant paketinio apdorojimo elementus.
BATCH_BACKOFF_MAX_MS	3600000 (1 val.)	open-sse/services/batchProcessor.ts	Didžiausia eksponentiškai didinamos delsos trukmė (ms) tarp pakartotinių paketinio apdorojimo elementų apdorojimo bandymų.
BATCH_MAX_CONCURRENT	1	open-sse/services/batchProcessor.ts	Didžiausias vienu metu apdorojamų paketų skaičius. Padidinkite, kad padidėtų pralaidumas; palikite mažą, kad išvengtumėte masinio spartos apribojimų suveikimo.

Important

Prieš keičiant esamą nuolatinę duomenų bazę, migravimo vykdyklė paskelbia išsamią, pagal turinį adresuojamą momentinę kopiją kataloge DATA_DIR/db_backups/. Paskelbimui reikalinga failų sistema, palaikanti toje pačioje failų sistemoje veikiančias, esamų failų neperrašančias standžiąsias nuorodas ir patvarų failų sinchronizavimą. POSIX pagrindu veikiančiose sistemose taip pat būtinas katalogų sinchronizavimas; sistemoje Windows Node gali atmesti katalogų deskriptorius, todėl OmniRoute išrašo paskelbto failo duomenis ir katalogo įrašo sinchronizavimą vykdo pagal galimybes. Jei prijungtas DATA_DIR negali suteikti šių garantijų, paleidimas saugiai nutraukiamas prieš pritaikant migravimą. Perkelkite DATA_DIR į tomis galimybėmis pasižymintį tomą; nenaudokite DISABLE_SQLITE_AUTO_BACKUP migravimo saugai apeiti.

Scenarijai

Scenarijus	Konfigūracija
Vietinis kūrimas	Palikite visas numatytąsias reikšmes. DB yra adresu ~/.omniroute/omniroute.db.
Docker	DATA_DIR=/data + prijunkite tomą ties /data.
Šifravimas saugykloje	Nustatykite STORAGE_ENCRYPTION_KEY + saugokite rakto atsargines kopijas! Jį praradus prarandami ir duomenys.
CI / testavimas	DATA_DIR=/tmp/omniroute-test — laikinas katalogas, šifravimo nereikia.

---

3. Tinklas ir prievadai

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
PORT	20128	src/lib/runtime/ports.ts	Pagrindinis prievadas, skirtas ir valdymo skydelio naudotojo sąsajai, ir API galiniams taškams (vieno prievado režimas).
OMNIROUTE_BASE_PATH	(tuščia = šakninis kelias)	next.config.mjs, scripts/docker/ensure-docker-base-path.mjs	URL pokelis, naudojamas OmniRoute pateikti už atvirkštinio tarpinio serverio (nustato Next.js basePath; autentifikavimo peradresavimai atsižvelgia į basePath). Pvz., /omniroute. Docker aplinkoje reikšmė įtraukiama vykdant docker build (ARG OMNIROUTE_BASE_PATH); iš anksto sukurti šakniniai atvaizdai gali vieną kartą pritaikyti kitą vykdymo aplinkos reikšmę paleidžiant konteinerį, prieš paleidžiant Next.js. Nustatykite NEXT_PUBLIC_BASE_URL į viešąjį šaltinį, apimantį tą patį pokelį.
NEXT_PUBLIC_OMNIROUTE_BASE_PATH	(tuščia = šakninis kelias)	src/shared/hooks/useDisplayBaseUrl.ts	Naršyklei matomas OMNIROUTE_BASE_PATH atitikmuo, įterpiamas kompiliavimo metu, kad valdymo skydelyje rodomas galinis taškas būtų https://host/omniroute/v1, o ne https://host/v1. Jei nenustatyta, naudojamas OMNIROUTE_BASE_PATH. Pakeitę reikšmę sukompiliuokite iš naujo (Next basePath nustatomas kompiliavimo metu).
DASHBOARD_ALLOW_EMBED	(nenustatyta = negalima įrėminti)	next.config.mjs, scripts/build/dashboardEmbed.mjs	Pasirenkamas HTML puslapių įterpimas naudojant iframe. Kai reikšmė nenustatyta, kiekvienas maršrutas pateikiamas su frame-ancestors 'none' ir X-Frame-Options: DENY. Nustačius vscode, puslapiai (valdymo skydelis, prisijungimo, dokumentacijos ir pradinis puslapiai) pateikiami su frame-ancestors 'self' vscode-webview: ir be X-Frame-Options, todėl VS Code Simple Browser gali juos atvaizduoti (OmniCopilot režimas dashboardOpen: "editor"). API sąsajoje (/api, /v1, /v1beta, /a2a, /healthz, šakninio lygio alternatyviuose keliuose) bet kuriuo atveju išlaikomos griežtos antraštės. Atpažįstama tik vscode — 1/true šios funkcijos neįjungia. Nustatoma kompiliavimo metu: pakeitę reikšmę sukompiliuokite iš naujo (atvaizdams naudokite docker build --build-arg DASHBOARD_ALLOW_EMBED=vscode; jos nustatymas iš anksto sukompiliuotame dieginyje neturi poveikio).
API_PORT	(nenustatyta)	src/lib/runtime/ports.ts	Kai nustatyta, /v1/* tarpinio serverio API pateikiama per šį atskirą prievadą.
API_HOST	0.0.0.0	src/lib/runtime/ports.ts	API prievado susiejimo adresas.
DASHBOARD_PORT	(nenustatyta)	src/lib/runtime/ports.ts	Kai nustatyta, valdymo skydelio naudotojo sąsaja pateikiama per šį atskirą prievadą.
OMNI_MAX_CONCURRENT_CONNECTIONS	0 (išjungta)	src/sse/utils/backpressure.ts	Apriboja vienu metu vykdomų pokalbių ryšių skaičių; ribą viršijusios užklausos gauna 503 su Retry-After. Teigiamas sveikasis skaičius įjungia apsaugą; nenustačius arba nustačius 0, ji išjungiama.
OMNIROUTE_INSTANCE_ID	(nenustatyta)	src/shared/resilience/peerRouting.ts	Stabilus, unikalus šliuzo ID, naudojamas jungiant OmniRoute egzempliorius į grandinę. Įjungia įeinančių lygiaverčių mazgų ciklų patikras. Leidžiami simboliai: raidės, skaitmenys, ., _, : ir -; daugiausia 64 simboliai.
OMNIROUTE_PEER_URLS	(nenustatyta)	src/shared/resilience/peerRouting.ts, open-sse/executors/base.ts	Kableliais atskirti baziniai OmniRoute URL, galintys gauti X-OmniRoute-Peer-Trace. Lygiaverčio mazgo metaduomenis gauna tik aiškiai į leidžiamųjų sąrašą įtraukti aukštesnio lygmens URL; visi kiti teikėjai lieka nepakeisti.
OMNIROUTE_PEER_MAX_HOPS	4	src/shared/resilience/peerRouting.ts	Didžiausias anksčiau aplankytų OmniRoute egzempliorių, priimamų grandininėje užklausoje, skaičius (1–32). Pasikartojantys egzemplioriai arba išnaudotas limitas grąžina HTTP 508 Loop Detected.
PROD_DASHBOARD_PORT	20130	docker-compose.prod.yml	Pagrindinio kompiuterio pusėje publikuojamas Dashboard prievadas, naudojamas Docker gamybinėje veiksenoje.
PROD_API_PORT	20131	docker-compose.prod.yml	Pagrindinio kompiuterio pusėje publikuojamas API prievadas, naudojamas Docker gamybinėje veiksenoje.
OMNIROUTE_PORT	(nenustatyta)	src/lib/runtime/ports.ts	Vykdant Electron ar kitose aplinkose turi pirmenybę prieš PORT.
LIVE_WS_PORT	20129	src/server/ws/liveServer.ts	Realaus laiko WebSocket stebėjimo serverio prievadas.
LIVE_WS_HOST	127.0.0.1	src/server/ws/liveServer.ts	Tiesioginio WebSocket serverio susiejimo adresas. Norėdami padaryti jį pasiekiamą LAN tinkle, nustatykite 0.0.0.0 (taip pat sukonfigūruokite LIVE_WS_ALLOWED_ORIGINS).
LIVE_WS_ALLOWED_ORIGINS	(nenustatyta)	src/server/ws/liveServer.ts	Kableliais atskirti papildomi šaltiniai, kuriems leidžiama atverti tiesioginį WebSocket ryšį. Atgalinio ryšio Dashboard šaltiniai pagal numatymą jau leidžiami.
LIVE_WS_ALLOWED_HOSTS	(nenustatyta)	src/server/ws/liveServerAllowList.ts	Kableliais atskirti papildomi pagrindinių kompiuterių vardai, leidžiami tiesioginio WebSocket šaltiniams. Kitaip nei LIVE_WS_ALLOWED_ORIGINS (visaverčiai šaltinių URL), tikrinama tik pagrindinio kompiuterio dalis — tai naudinga LAN/Tailscale sąrankoms.
NEXT_PUBLIC_LIVE_WS_PUBLIC_URL	(nenustatyta)	src/hooks/useLiveDashboard.ts	Viešasis tiesioginio Dashboard WebSocket URL (naršyklės pusėje). Nustatykite, kai prieš WS serverį naudojamas atvirkštinis tarpinis serveris arba Cloudflare Tunnel (pvz., wss://ws.my-ai.com/live-ws); naršyklė jungsis ten, o ne prie ws://hostname:20132. Kelio dalis taip pat naudojama kaip WebSocket protokolo atnaujinimo kelias (numatytoji reikšmė: /live-ws).
OMNIROUTE_ENABLE_LIVE_WS	true	src/server/ws/liveServer.ts ir scripts/start-ws-server.mjs	Norėdami išjungti realaus laiko WebSocket serverį, nustatykite 0 arba false (pagal numatymą jis įjungtas ir susietas su atgalinio ryšio sąsaja). CI / testavimo aplinkos perjungiklis, išjungiantis atskirą tiesioginio WebSocket pagalbinį scenarijų.
RELAY_IP_PER_MINUTE	30	src/app/api/v1/relay/chat/completions/route.ts	Perdavimo spartos apribojimas kiekvienai (prieigos rakto, IP) porai, užklausomis per minutę. Saugomas atmintyje, kiekvienam egzemplioriui atskirai. 0 arba neigiama reikšmė išjungia IP dimensijos ribojimą (prieigos raktui taikomas DB apribojimas išlieka).
NODE_ENV	production	Next.js branduolys	Valdo žurnalų išsamumą, podėlio naudojimą, klaidų informacijos atskleidimą ir Next.js optimizavimą.
OMNIROUTE_USE_TURBOPACK	1 (Turbopack — numatytoji kodo reikšmė)	package.json / Next.js 16	Turbopack yra numatytasis npm run dev ir npm run build paketų kūrimo įrankis (pagal našumo testus, kūrimas 2–3 kartus spartesnis). Nustatykite 0, kad būtų grįžta prie webpack sistemoje Windows, susidūrus su savųjų susiejimų ar paketų kūrimo įrankio suderinamumo problemomis, arba įrenginiuose, kuriuose trūksta RAM — žinoma, kad šios Next.js versijų linijos (16.2.x) Turbopack produkcinės komponuotės, apdorodamos didelius modulių grafus, sunaudoja gerokai daugiau atminties nei webpack (Next 16.3 Turbopack atminties atlaisvinimo pataisa dar nėra stabili); naudojant atsarginį webpack variantą didžiausias atminties naudojimas yra gerokai mažesnis. Žr. #6409.
OMNIROUTE_SKIP_DB_HEALTHCHECK	(nenustatyta)	src/lib/db/core.ts / src/lib/db/healthCheck.ts	Nustatykite 1, kad paleidimo metu būtų praleista SQLite vientisumo patikra. Naudinga norint sparčiau paleisti sistemą su didelėmis duomenų bazėmis.
NOTIFY_SOCKET	(nenustatyta)	systemd (sd_notify protokolas)	Nustato systemd, kai procesas vykdomas paslaugos vienete su sd_notify integracija; OmniRoute ją nuskaito (žr. OMNIROUTE_DISABLE_SD_NOTIFY), kad išsiųstų READY/WATCHDOG pranešimus. Naudotojas niekada neturėtų jos nustatyti.
OMNIROUTE_DISABLE_SD_NOTIFY	(nenustatyta)	scripts/dev/systemd-notify.mjs	Nustatykite 1, kad išjungtumėte systemd sd_notify (Type=notify / WatchdogSec=), net kai programa vykdoma systemd vienete. Už systemd ribų pranešimų siuntimo priemonė vis tiek neatlieka jokių veiksmų.
CREDENTIAL_HEALTH_CHECK_INTERVAL	300000	open-sse/config/constants.ts / src/lib/credentialHealth/scheduler.ts	Foninės prisijungimo duomenų būklės tikrinimo planuoklio intervalas (ms). Mažiausia reikšmė: 10000 (10 s).
CREDENTIAL_HEALTH_CACHE_TTL	300000	open-sse/config/constants.ts / src/lib/credentialHealth/cache.ts	Podėlyje saugomos prisijungimo duomenų būklės TTL (ms).
OMNIROUTE_DISABLE_CREDENTIAL_HEALTH_CHECK	false	src/lib/credentialHealth/scheduler.ts	Nustatykite 1 arba true, kad išjungtumėte periodinį foninį ryšių su teikėjais tikrinimą. Paieškos teikėjai (SEARCH_VALIDATOR_CONFIGS faile src/lib/providers/validation/searchProviders.ts, pvz., tavily-search) visada neįtraukiami į patikrą — jų „tikrinimas“ yra reali apmokestinama aukštesnio lygmens užklausa, todėl jų būklė niekada netikrinama pagal laikmatį (#9970).
HOST	0.0.0.0	scripts/dev/run-next.mjs	Next.js kūrimo / paleidimo serverio susiejimo adresas. Jei nustatyta, pakeičia numatytąjį 0.0.0.0.
HOSTNAME	127.0.0.1	scripts/dev/run-next-playwright.mjs	Susiejimo adresas, kurį Playwright vykdyklė naudoja paleisdama Next.js. Numatytasis adresas hermetiškiems testams yra 127.0.0.1. Nenaudokite su omniroute serve — vietoje jo naudokite OMNIROUTE_SERVER_HOST (POSIX apvalkalai automatiškai nustato HOSTNAME įrenginio pavadinimui; .env negali jo pakeisti).
OMNIROUTE_SERVER_HOST	0.0.0.0	bin/cli/commands/serve.mjs	omniroute serve susiejimo adresas. Padeda išvengti konflikto su POSIX apvalkalo kintamuoju HOSTNAME (bash/zsh visada nustato jį įrenginio pavadinimui). Jei nenustatyta, naudojamas 0.0.0.0. (#6194)

Prievadų režimai

┌─────────────────────────── Vienas prievadas (numatytasis) ─────────────────┐
│  PORT=20128                                                                 │
│  → Valdymo skydelis: http://localhost:20128                                 │
│  → API:               http://localhost:20128/v1/chat/completions            │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────── Atskiri prievadai ───────────────────────────────┐
│  DASHBOARD_PORT=20128                                                       │
│  API_PORT=20129                                                             │
│  API_HOST=0.0.0.0                                                           │
│  → Valdymo skydelis: http://localhost:20128                                 │
│  → API:               http://0.0.0.0:20129/v1/chat/completions             │
│  Paskirtis: API pasiekiama LAN, o skydelis – tik per localhost.             │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────── Docker gamybinė aplinka ─────────────────────────┐
│  PROD_DASHBOARD_PORT=443   PROD_API_PORT=8443                              │
│  → Susieja konteinerio prievadus su pagrindinio kompiuterio prievadais      │
│    faile docker-compose.prod.yml.                                           │
└─────────────────────────────────────────────────────────────────────────────┘

---

4. Saugumas ir autentifikavimas

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
MACHINE_ID_SALT	endpoint-proxy-salt	src/lib/auth	Druska, naudojama kartu su aparatinės įrangos identifikatoriais įrenginio kontroliniam atspaudui sukurti. Siekiant izoliavimo, kiekvienam diegimui ją pakeiskite.
OMNIROUTE_CLI_SALT	(nenustatyta = atsitiktinė kiekvieno diegimo druska, išsaugoma <DATA_DIR>/cli-token-salt.json)	src/lib/machineToken.ts	HMAC druska, skirta vietiniam CLI autentifikavimo prieigos raktui išvesti. Nustačius šią reikšmę, pakeičiami visi įrenginyje esantys CLI prieigos raktai, o jai visada teikiama pirmenybė prieš išsaugotą druską. Žr. docs/security/CLI_TOKEN.md.
AUTH_COOKIE_SECURE	false	src/lib/auth	Seanso slapukams nustato Secure požymį. Veikiant už HTTPS, reikšmė privalo būti true.
REQUIRE_API_KEY	false	API tarpinė programinė įranga	Kai reikšmė yra true, visose /v1/* tarpinio serverio užklausose turi būti pateiktas galiojantis API raktas.
ALLOW_API_KEY_REVEAL	false	src/shared/constants/featureFlagDefinitions.ts	Leidžia valdymo skydelio naudotojo sąsajoje atskleisti visas API raktų reikšmes. Konfigūruojama valdymo skydelio funkcijų žymose; bendrinamuose egzemplioriuose tai kelia saugumo riziką.
NO_LOG_API_KEY_IDS	(tuščia)	src/lib/compliance/index.ts	Kableliais atskirti API raktų ID, kurių užklausos neregistruojamos žurnale (BDAR atitiktis).
DEFAULT_RATE_LIMIT_PER_DAY	(nenustatyta = neribota)	src/shared/utils/apiKeyPolicy.ts	Atsarginis dienos užklausų limitas, taikomas API raktams, kurių rate_limits stulpelio reikšmė yra null. Nenustatyta arba tuščia reikšmė: numanomas limitas netaikomas (#2289, #11017). 0 reiškia tą patį (neribota). Teigiamas sveikasis skaičius N įjungia N per dieną, 5N per savaitę ir 20N per mėnesį. Netinkamai suformatuotoms netuščioms reikšmėms taikomi ankstesni limitai: 1000 per dieną, 5000 per savaitę ir 20000 per mėnesį.
MAX_BODY_SIZE_BYTES	10485760 (10 MB)	src/shared/middleware/bodySizeGuard.ts	Didžiausias leidžiamas užklausos turinio dydis. Šį limitą viršijantys duomenys atmetami.
OMNIROUTE_CHAT_LARGE_BODY_BYTES	262144 (256 KB)	src/shared/middleware/chatBodyAdmission.ts	Faktiniai užklausų turiniai, kurių dydis pasiekia arba viršija šią ribą, prieš analizuojant JSON gauna atominę, procesui vietinę didelio svorio priėmimo rezervaciją (BYTE kelias, įskaitant POST /v1/responses). Taikoma tokia pati #10437 sveikos laisvos talpos išimtis kaip ir struktūriškai sudėtingoms užklausoms; vis dar ribojama naudojant OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110, kad nepasikartotų #7849.
OMNIROUTE_CHAT_HARD_MAX_BODY_BYTES	52428800 (50 MB)	src/shared/middleware/chatBodyAdmission.ts	Griežtas pokalbių maršruto limitas, taikomas apriboto nuskaitymo metu perskaitytų baitų kiekiui, įskaitant užklausas, kuriose Content-Length nėra, jis netinkamas arba klaidinantis; viršijus limitą grąžinamas 413.
OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT	(nenustatyta — užklausų skaičiaus apribojimo nėra)	src/shared/middleware/chatBodyAdmission.ts	#503-fanout: šis senasis užklausų SKAIČIAUS apribojimas dabar taikomas tik tada, kai yra aiškiai nustatytas. Jei jis nenustatytas (numatytoji būsena), didelės apkrovos pokalbių priėmimą vietoje jo riboja OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES — automatiškai apskaičiuojamas BAITŲ biudžetas, nustatomas pagal realią proceso atminties ribą viename procese (viename V8 kaupe). Dvi persidengiančios maždaug 750 tūkst. prieigos ženklų /v1/responses užklausos nutraukia maždaug 12 GiB kaupų veikimą (#7849) — tai atminties biudžeto įspėjimas, o ne griežtas produkto maksimumas, lygus 2. Tvarkingai veikiantis procesas (kaupas nesiekia atmetimo santykio) GALI priimti daugiau lygiagrečių ilgų /v1/responses užklausų per OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM. Dešimtys ilgų SSE klientų (40–50) priklauso nuo kaupo + OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110, o ne nuo „maks. 2“. Aklai didinant šią vertę, kad būtų „išnaudotas pagrindinis kompiuteris“, vėl sukeliama #7849 problema. Dauginkite kaupus naudodami N nepriklausomų DATA_DIR (#11024); niekada nenaudokite replicas>1 su vienu SQLite failu.
OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES	(apskaičiuojama automatiškai)	src/shared/middleware/admissionBudget.ts	#503-fanout: automatiškai apskaičiuojamo priimamų duomenų baitų biudžeto perrašymas (25 % griežtesnės V8 / cgroup atminties ribos, padalytos iš 8 kartų laikinojo padidėjimo). Apskaičiuotos ir aiškiai nurodytos vertės apribojamos iki 8 MiB–2 GiB intervalo. Už efektyvųjį biudžetą didesnis turinys iš karto atmetamas su 413 body_exceeds_budget; konkurencija tarp atskirai aptarnaujamų turinių lieka pakartotinai bandytina su 503. 40–50 lygiagrečių ilgų SSE klientų skaičių lemia šis biudžetas + kaupas, o ne griežtas „maks. 2“ apribojimas. Prieš keisdami nustatymus, perskaitykite chatAdmission.maxInflightBytes / budgetSource / pressureSeverity adresu /api/monitoring/health.
OMNIROUTE_CHAT_ADMISSION_HEAP_SHED_RATIO	0.75	src/shared/middleware/chatBodyAdmission.ts	Kaupo apkrovos atmetimo santykis (heapUsed / heap_size_limit), taikomas BAITŲ ir STRUKTŪROS didelės apkrovos užklausų priėmimui (#10183, #10268, #10437). Lygiagreti didelės apkrovos užklausa, viršijanti OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT, atmetama su pakartotinai bandytinu 503 tik tada, kai kaupas TAIP PAT pasiekia arba viršija šį santykį; jei kaupas neperkrautas, ji priimama naudojant sveiko kaupo rezervą.
OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM	OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT (numatytoji vertė 1)	src/shared/middleware/chatBodyAdmission.ts	Ribota papildoma talpa, skirta neperkrauto kaupo sparčiajam keliui (#10437), taikoma ir STRUKTŪRAI, ir BAITAMS (admitChatRequest, įskaitant turinius ≥ OMNIROUTE_CHAT_LARGE_BODY_BYTES). Be šios ribos kiekviena užimto, bet neperkrauto kaupo užklausa apeidavo priėmimo valdymą be jokios viršutinės ribos. Kai per neperkrauto kaupo kelią aktyvių lygiagrečių nuomos leidimų skaičius pasiekia šią vertę, kitos užklausos nukreipiamos tuo PAČIU riboto laukimo / atmetimo keliu, kuris naudojamas esant realiai kaupo apkrovai. 0 visiškai išjungia šį apėjimą.
OMNIROUTE_CHAT_HEAVY_MESSAGE_COUNT	200	src/shared/middleware/chatBodyAdmission.ts	Pranešimų skaičius, kuriam esant pokalbio užklausa priskiriama didelės apkrovos užklausoms, net jei jos turinys nesiekia baitų ribos.
OMNIROUTE_CHAT_HEAVY_TOOL_COUNT	64	src/shared/middleware/chatBodyAdmission.ts	Įrankių skaičius, kuriam esant pokalbio užklausa priskiriama didelės apkrovos užklausoms, net jei jos turinys nesiekia baitų ribos.
OMNIROUTE_CHAT_HEAVY_ESTIMATED_TOKENS	32000	src/shared/middleware/chatBodyAdmission.ts	Konservatyvus prieigos ženklų skaičiaus įvertis pagal eilutės dydį, kuriam esant užklausa priskiriama didelės apkrovos užklausoms; tai yra priėmimo sąnaudų pakaitinis rodiklis, o ne paslaugų teikėjo atsiskaitymui naudojamas prieigos ženklų skaičiavimas.
OMNIROUTE_CHAT_HARD_MAX_MESSAGES	0 (išjungta)	src/shared/middleware/chatBodyAdmission.ts	Pasirenkamas pokalbio istorijos apribojimas, kurį reikia aiškiai įjungti. Pagal numatytuosius nustatymus išjungtas: pranešimų skaičius yra diegimo politika, o ne universali užklausos savybė, todėl čia pritaikius apribojimą pokalbiai atmetami su galutiniu 413 dar prieš glaudinimo konvejeriui suteikiant galimybę paversti juos aptarnaujamais. Kaupo augimą riboja OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT ir atmetimas dėl kaupo apkrovos. Ribotos atminties diegimuose, kuriems reikia griežtos viršutinės ribos, nustatykite teigiamą vertę; ją viršijus grąžinamas struktūrizuotas glaudinimo reikalaujantis 413.
OMNIROUTE_MAX_NONSTREAMING_RESPONSE_BYTES	67108864 (64 MB)	open-sse/handlers/chatCore/nonStreamingResponseBody.ts	Griežta nestreaminamo išorinio serverio atsakymo, visiškai buferizuojamo atmintyje, riba. Ją viršijus išorinio serverio duomenų skaitymas atšaukiamas ir užklausa greitai nutraukiama, užuot leidus neribotai eilutei augti tol, kol išsenka kaupas.
OMNIROUTE_FORWARDING_HEADER_BUDGET_BYTES	768	open-sse/handlers/chatCore/responseHeaders.ts	Didžiausias iš išorinio serverio atsakymo antraščių persiunčiamų baitų skaičius perdavimo kanale. Viršijus biudžetą, žemesnio prioriteto antraštės (pvz., pasirinktinės x-codex-*, x-oai-request-id) pašalinamos, kad būtų laikomasi įprastų atvirkštinių tarpinių serverių antraščių ribų. Nustatykite didesnę vertę, jei norite persiųsti daugiau išorinio serverio metaduomenų didesnių atsakymo antraščių sąskaita.
CORS_ORIGIN	(nenustatyta)	src/server/cors/origins.ts	Senasis vieno šaltinio CORS leidžiamųjų šaltinių sąrašas. Naujuose diegimuose verčiau naudokite CORS_ALLOWED_ORIGINS. CORS skirtas tik skirtingų šaltinių naršyklės API klientams; autentifikuoti valdymo skydelio rašymo veiksmai naudoja to paties šaltinio užklausas ir su sesija susietą CSRF apsaugą.
CORS_ALLOWED_ORIGINS	(nenustatyta)	src/server/cors/origins.ts	Kableliais atskirtas CORS leidžiamųjų šaltinių sąrašas. Pakaitos simbolis nesiunčiamas, nebent aiškiai sukonfigūruota CORS_ALLOW_ALL=true.
CORS_ALLOW_ALL	false	src/server/cors/origins.ts	Tik kūrimui skirta išimtinė parinktis, leidžianti atkartoti bet kokią naršyklės Origin reikšmę. Neįjunkite bendrinamuose ar produkciniuose diegimuose.
OUTBOUND_SSRF_GUARD_ENABLED	true	src/shared/network/outboundUrlGuard.ts	Blokuoti paslaugų teikėjų iškvietas, nukreiptas į privačių, grįžtamojo ryšio arba vietinio ryšio IP adresų diapazonus. Išjunkite tik izoliuotose testavimo aplinkose.
OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS	false	src/shared/network/outboundUrlGuard.ts	Leisti paslaugų teikėjų URL, nukreipiančius į privačius arba vietinius tinklus (localhost, 192.168.x.x, 10.x.x.x ir kt.). BŪTINA savarankiškai talpinamiems paslaugų teikėjams (LM Studio, Ollama, vLLM, Llamafile, Triton, SearXNG). Kai nustatyta false, valdymo skydelis atmeta vietinių URL patikrą.
OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS	true	src/shared/network/outboundUrlGuard.ts	Leisti pridėti ir tikrinti paslaugų teikėjus vietiniais arba privačiais adresais (127.0.0.1, localhost, LAN, privatūs diapazonai) — taikoma tik paslaugų teikėjo patikros keliui. Numatytoji reikšmė yra true (pirmenybė vietiniams ištekliams); nustatykite false, kad būtų griežtai leidžiami tik viešieji adresai. Debesijos metaduomenų galiniai taškai (169.254.169.254, metadata.google.internal) vis tiek lieka užblokuoti. (#5066)
AUDIO_REMOTE_PROVIDER_NODES	false	src/app/api/v1/_shared/audioProviderNodes.ts	Leisti /v1/audio/* maršrutams (transkripcijoms, kalbai, vertimams) naudoti su OpenAI suderinamą paslaugų teikėjo mazgą, talpinamą ne localhost. Pagal numatytąją nuostatą išjungta — garso srauto nukreipimas į nuotolinį pagrindinį kompiuterį pakeičia išeinančio srauto tapatybę, todėl operatorius turi priimti aiškų sprendimą. Grįžtamojo ryšio ir privatūs mazgai (localhost, 127.0.0.1, 172.16-31.x) visada leidžiami ir ši nuostata jiems įtakos neturi. (#3963)
OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN	false	src/app/api/auth/login/route.ts	Kai OIDC įjungtas, išjungti prisijungimą slaptažodžiu, kad naudotojai galėtų autentifikuotis tik naudodami OIDC bendrąjį prisijungimą. Taip pat priimamas trumpasis sinonimas OIDC_DISABLE_PASSWORD_LOGIN; valdymo skydelio funkcijos žyma tuo pačiu raktu turi pirmenybę. (#10889)
OIDC_DISABLE_PASSWORD_LOGIN	false	src/app/api/auth/login/route.ts	Trumpasis OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN sinonimas (#10889).

Saugumo sustiprinimo kontrolinis sąrašas

# Minimalūs produkcinės aplinkos saugumo reikalavimai:
AUTH_COOKIE_SECURE=true        # Reikalingas HTTPS
REQUIRE_API_KEY=true           # Autentifikuoti visus tarpinio serverio iškvietimus
ALLOW_API_KEY_REVEAL=false     # Niekada nerodyti raktų naudotojo sąsajoje
CORS_ALLOWED_ORIGINS=https://your.domain.com
MAX_BODY_SIZE_BYTES=5242880    # 5 MB riba

---

5. Įvesties sanitizavimas ir asmens duomenų apsauga

„OmniRoute“ suteikia dviejų sluoksnių apsaugą: užklausos pusės įterpimo atakų aptikimą ir atsakymo pusės asmens duomenų pašalinimą.

⚠️ Apribojimai: šios apsaugos priemonės yra euristiniai aptikimo mechanizmai, veikiantys geriausių pastangų principu, o ne visavertė užklausų įterpimo užkarda ar asmens duomenų DLP sistema. Jos gali pateikti klaidingai teigiamų rezultatų (pažymėti nepavojingas personažų / RPG užklausas) ir klaidingai neigiamų rezultatų (neaptikti „leetspeak“, tarpais atskirtų ar ne anglų kalbos šablonų). Vien jų nepakanka atitikčiai užtikrinti. Prieš jomis pasikliaudami sureguliuokite režimus ir išbandykite juos su savo srautu.

Užklausos pusė: užklausų įterpimo apsauga

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
INPUT_SANITIZER_ENABLED	true	src/middleware/promptInjectionGuard.ts	Įjungia gaunamų pranešimų tikrinimą dėl užklausų įterpimo šablonų.
INPUT_SANITIZER_MODE	warn	src/middleware/promptInjectionGuard.ts	Įterpimo politika: warn = tik registruoti žurnale, block = atmesti užklausą su 400 kodu. Senasis redact nepašalina įterpimo teksto; užklausų asmens duomenims perrašyti naudokite PII_REDACTION_ENABLED.
INJECTION_GUARD_MODE	(nenustatyta)	src/middleware/promptInjectionGuard.ts	Senasis INPUT_SANITIZER_MODE pseudonimas — veikimas toks pats.
INPUT_SANITIZER_BLOCK_THRESHOLD	high	src/shared/utils/injectionSeverity.ts	Mažiausias pavojingumo lygis, kurį atmeta MODE=block: high (numatytasis), medium arba low. Vidutinio pavojingumo šablonai skirti tik stebėjimui, nebent slenkstis sumažinamas.
INJECTION_GUARD_BLOCK_THRESHOLD	(nenustatyta)	src/shared/utils/injectionSeverity.ts	Senasis INPUT_SANITIZER_BLOCK_THRESHOLD pseudonimas — veikimas toks pats.
PII_REDACTION_ENABLED	false	src/lib/guardrails/piiMasker.ts	Kai nustatyta true, gaunamose užklausose paslepia asmens duomenis (nepriklausomai nuo įterpimo režimo).
CREDENTIAL_REDACTION_ENABLED	false	src/lib/guardrails/credentialMasker.ts	Užklausų ir atsakymų duomenyse paslepia gerai žinomus API raktų / slaptųjų prieigos raktų šablonus. Pasirenkama funkcija; atitinka PII_REDACTION_ENABLED veikimą.

Atsakymo pusė: asmens duomenų sanitizavimo priemonė

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
PII_RESPONSE_SANITIZATION	false	src/lib/piiSanitizer.ts	Prieš grąžinant LLM atsakymus klientui, tikrina, ar juose nėra nutekintų asmens duomenų.
PII_RESPONSE_SANITIZATION_MODE	redact	src/lib/piiSanitizer.ts	redact = paslėpti asmens duomenis, warn = tik registruoti žurnale, block = pašalinti visą atsakymą.

VS Code prieigos raktu identifikuojamo maršruto konteksto sanitizavimo priemonė

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_VSCODE_SANITIZE_CONTEXT	1	src/app/api/v1/vscode/contextSanitizer.ts	Iš /v1/vscode/[token]/* užklausų pašalina numanomą aktyviosios rengyklės kontekstą (editorContext, activeEditor, currentFile, selection, openTabs…) ir paslepia aiškiai pridėtų neskelbtinų failų turinį. Pagal numatytąją nuostatą saugu; norėdami išjungti, nustatykite 0.

Scenarijai

Scenarijus	Konfigūracija
Įmonės atitiktis	INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=block, PII_REDACTION_ENABLED=true, PII_RESPONSE_SANITIZATION=true (įterpimai blokuojami, o užklausų / atsakymų asmens duomenys paslepiami; režimai yra nepriklausomi)
Tik stebėjimas	INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=warn — registruoja žurnale, bet niekada neblokuoja
Asmeninis naudojimas	Palikite viską išjungta — jokių papildomų sąnaudų

---

6. Įrankių ir maršruto parinkimo strategijos

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
TOOL_POLICY_MODE	disabled	src/lib/toolPolicy.ts	Valdo LLM prieigą prie įrankių / funkcijų iškvietimo. allowlist = tik išvardyti įrankiai, denylist = visi, išskyrus išvardytus, disabled = jokių apribojimų.
OMNIROUTE_PAYLOAD_RULES_PATH	./config/payloadRules.json	open-sse/services/payloadRules.ts	Kelias į JSON failą su naudingosios apkrovos keitimo taisyklėmis (konkretiems modeliams / protokolams skirti siunčiamų užklausų pakeitimai).
OMNIROUTE_PAYLOAD_RULES_RELOAD_MS	5000	open-sse/services/payloadRules.ts	Naudingosios apkrovos taisyklių failo automatinio įkėlimo iš naujo intervalas (ms). Mažiausia reikšmė – 1000.
OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS	false	open-sse/services/model.ts	Pasirenkama parinktis: nukreipti Claude Code klientų modelių ID claude-* be prefikso per Claude Code OAuth paskyrą, užuot reikalavus teikėjo prefikso. Aiškiai nurodyti teikėjo prefiksai vis tiek turi pirmenybę. Taip pat galima konfigūruoti Claude teikėjo puslapyje esančiu valdymo skydelio perjungikliu.
COMBO_CONCURRENCY_PER_MODEL	3	open-sse/services/comboConfig.ts	Vienam modeliui taikoma lygiagretumo riba cikliniams deriniams (#9100). Ciklinių derinių semaforo riba buvo fiksuota ties 3 lygiagrečiomis užklausomis vienam modeliui ir jos nebuvo galima pakeisti, todėl didesnio lygiagretumo srautas buvo vykdomas nuosekliai, laikantis šios ribos. Patikrinama, kad reikšmė būtų >= 1, ir apribojama iki <= 32.
DISABLE_CONTEXT_WINDOW_CHECKS	false	open-sse/handlers/chatCore.ts	Pavojinga pasirenkama parinktis, praleidžianti „OmniRoute“ vietinę konteksto lango / didžiausio įvesties žetonų skaičiaus patikrą tiesioginėms vieno modelio užklausoms. Išoriniai teikėjai vis tiek taiko savo faktinius apribojimus; užklausos glaudinimas ir paties modelio išvesties žetonų riba lieka aktyvūs. Galiojanti pirmumo tvarka: funkcijų vėliavų DB perrašymas > aplinkos kintamasis > numatytoji reikšmė; paleisti iš naujo nereikia.
OMNIROUTE_DISABLE_CONVERSATION_TRACKING	(nenustatyta)	open-sse/services/conversationTracker.ts	Nustatykite 1, kad pokalbių istorija nebebūtų renkama. resolveConversationId() grąžina nesekamą rezultatą prieš nuskaitydama SQLite ar analizuodama pranešimų istoriją; tai taip pat taikoma kliento pateiktiems seanso ID. Maršruto parinkimo seansų apdorojimas nesikeičia, o esami įrašai neištrinami. Skirta diegimams, kuriuose nenaudojamas valdymo skydelio pokalbių rodinys ir norima sustabdyti pokalbio žingsnių lentelės augimą.

---

7. URL adresai ir sinchronizavimas su debesija

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
BASE_URL	http://localhost:20128	src/lib/cloudSync.ts	Serverio URL adresas, kuriuo vidinės sinchronizavimo užduotys kreipiasi į /api/sync/cloud. Net kai programa viešai pasiekiama per tarpinį serverį, čia palikite grįžtamosios kilpos arba konteinerio URL adresą.
CLOUD_URL	(tuščia)	src/lib/cloudSync.ts	Debesijos perdavimo tarpininko galinio taško URL adresas (mokama funkcija).
CLOUD_SYNC_TIMEOUT_MS	12000	src/lib/cloudSync.ts	Debesijos sinchronizavimo HTTP užklausų skirtasis laikas.
OMNIROUTE_BUILD_PROFILE	full	Webpack komponavimo konfigūracija	Komponavimo metu naudojamas profilis (nustatykite minimal, kad privilegijuoti moduliai fiziškai nebūtų įtraukti į paketą).
OMNIROUTE_STANDALONE_DIR	.build/ autonominė išvestis	scripts/build/colocate-standalone.mjs	Komponavimo metu naudojamas autonominės išvesties katalogo, kurį naudoja vietos nustatymo veiksmas po komponavimo, perrašymas. Tai nėra vykdymo aplinkos nuostata.
OMNIROUTE_CLOUD_SYNC_SECRET	(tuščia)	src/lib/cloudSync.ts	Bendrinama slapta reikšmė, naudojama „Cloud Sync“ atsakymų HMAC-SHA256 parašui patikrinti.
OMNIROUTE_CLOUD_SYNC_SECRETS	false	src/lib/cloudSync.ts	Nustatykite true, kad „Cloud Sync“ galinis taškas galėtų perrašyti vietinius prisijungimo duomenis. Numatytoji reikšmė yra false.
OMNIROUTE_CLOUD_SYNC_ENFORCE_SIGNATURE	false	src/lib/cloudSync.ts	Nustatykite true, kad nepasirašytas „Cloud Sync“ atsakymas būtų atmestas, kai nesukonfigūruota vietinė slapta reikšmė (#13679). Pateiktas parašas visada tikrinamas ir visada atmetamas, kai OMNIROUTE_CLOUD_SYNC_SECRET nenustatytas, neatsižvelgiant į šią žymą. Nuo v3.9 numatytoji reikšmė bus privalomas tikrinimas.
OMNIROUTE_ZED_IMPORT_LEGACY_ONE_STEP	false	src/app/api/providers/zed/import/route.ts	Nustatykite true, kad be naudotojo patvirtinimo būtų grįžtama prie v3.8.5 vieno veiksmo „importuoti viską“ veiksenos.
NEXT_PUBLIC_BASE_URL	http://localhost:20128	OAuth, valdymo skydelis, sinchronizavimas	Viešai pasiekiamas URL adresas, naudojamas OAuth redirect_uri, valdymo skydelio nuorodoms ir sugeneruotiems viešiesiems URL adresams. Nustatykite stabilų viešąjį URL adresą, kai OAuth atgaliniams iškvietimams ar sugeneruotoms naršyklės nuorodoms reikia naudoti kanoninį atvirkštinio tarpinio serverio pagrindinį kompiuterį.
NEXT_PUBLIC_CLOUD_URL	(tuščia)	Kliento pusė	Kliento pusėje naudojama CLOUD_URL kopija.
NEXT_PUBLIC_APP_URL	(nenustatyta)	src/shared/services/cloudSyncScheduler.ts	Senasis atsarginis NEXT_PUBLIC_BASE_URL variantas.
OMNIROUTE_PUBLIC_BASE_URL	(nenustatyta)	Viešosios kilmės nustatymo priemonė, vaizdų URL	Aukščiausio prioriteto naršyklei skirta OmniRoute kilmė, naudojama viešiesiems URL generuoti ir ne valdymo skydelio naršyklės kilmei tikrinti. Nustatykite ją, kai OpenWebUI ar kita perdavimo tarnyba pasiekia OmniRoute vidiniu URL, tačiau naudotojo naršyklė turi gauti sugeneruotą mediją iš LAN, tunelio arba viešosios kilmės. Neįtraukite /v1.
OMNIROUTE_PROVIDER_MANIFEST_URL	(nenustatyta)	open-sse/config/providerPluginManifestUrl.ts	Absoliutus teikėjo papildinio manifesto URL, skelbiamas pagalbiniams klientams. Kai nenustatyta, OmniRoute iš užklausos kilmės arba HOST/PORT išveda /api/v1/provider-plugin-manifest.
OMNIROUTE_PUBLIC_PROTOCOL	http	open-sse/config/providerPluginManifestUrl.ts	Protokolas, naudojamas teikėjo papildinio manifesto URL išvesti iš HOST/PORT, kai užklausos kilmė nenurodyta. Nustatykite https, jei naudojamas TLS užbaigiantis viešasis tarpinis serveris ir nėra nustatytas aiškus OMNIROUTE_PROVIDER_MANIFEST_URL.
OMNIROUTE_TRUST_PROXY	(nenustatyta)	src/server/origin/publicOrigin.ts	Pasirinktinis persiųstų viešosios kilmės antraščių pasitikėjimo režimas. Nenustatyta = priimant saugumo sprendimus nepasitikėti Forwarded / X-Forwarded-*. true / loopback pasitiki persiųstu pagrindinio kompiuterio vardu ir protokolu tik iš žetonu pažymėto vietinio ciklo tarpinio serverio. private / lan taip pat pasitiki privataus LAN tarpiniais mazgais. Gamybinėje aplinkoje pirmenybę teikite aiškiai nustatytam NEXT_PUBLIC_BASE_URL.
KIE_CALLBACK_URL	(nenustatyta)	open-sse/utils/kieTask.ts	Viešasis atgalinio iškvietimo URL asinchroninėms kie.ai užduotims. Aukščiausio prioriteto perrašymas, taikomas prieš OMNIROUTE_KIE_CALLBACK_URL ir OMNIROUTE_PUBLIC_URL.
OMNIROUTE_KIE_CALLBACK_URL	(nenustatyta)	open-sse/utils/kieTask.ts	Alternatyvus KIE_CALLBACK_URL užrašymo variantas. Naudojamas kaip atsarginis, kai pagrindinis kintamasis nenustatytas.
OMNIROUTE_PUBLIC_URL	(nenustatyta)	open-sse/utils/kieTask.ts	Viešoji kilmė, naudojama asinchroninių atgalinio iškvietimo URL sudaryti. Žemiausio prioriteto atsarginis variantas kie.ai atgaliniams iškvietimams; taip pat naudojama kaip bendrasis viešasis URL kitoms perdavimo tarnyboms.
OMNIROUTE_CROF_USAGE_URL	https://crof.ai/usage_api/	open-sse/services/usage.ts	CrofAI kvotos tikrinimo galinis taškas, naudojamas puslapyje „Naudojimas“. Perrašykite perdavimo tarnyboms / testų fikstūroms.
OMNIROUTE_OPENCODE_QUOTA_URL	https://opencode.ai/zen/go/v1/usage	open-sse/services/opencodeQuotaFetcher.ts	Oficialus API raktu autentifikuojamas OpenCode Go naudojimo galinis taškas, naudojamas puslapyje „Naudojimas“. Perrašykite perdavimo tarnyboms / testų fikstūroms.
OPENCODE_SYNTHESIZE_CLI_HEADERS	true	open-sse/executors/opencode.ts	Sugeneruoja OpenCode CLI tapatybės antraštes (User-Agent, x-opencode-client/project, užklausos / seanso UUID) opencode-go/zen pirminėms užklausoms, kurių klientas neatsiuntė, kad Cloudflare jas priimtų siunčiant iš VPS (#6210/#5997). Pagal numatytuosius nustatymus įjungta nuo #10571; išjunkite naudodami false/0/no/off.
OPENCODE_USER_AGENT	opencode	open-sse/executors/opencode.ts	Numatytasis User-Agent, naudojamas, kai OPENCODE_SYNTHESIZE_CLI_HEADERS įjungta ir nenustatytas konkrečiam teikėjui skirtas <PROVIDER>_USER_AGENT perrašymas. Taikoma tik opencode vykdyklėms.
OPENCODE_CLIENT	desktop	open-sse/executors/opencode.ts	Sugeneruotos x-opencode-client antraštės reikšmė, kai OPENCODE_SYNTHESIZE_CLI_HEADERS įjungta.
OPENCODE_PROJECT	global	open-sse/executors/opencode.ts	Susintetintos x-opencode-project antraštės reikšmė, kai įjungta OPENCODE_SYNTHESIZE_CLI_HEADERS.
OMNIROUTE_OLLAMA_CLOUD_USAGE_URL	https://ollama.com/settings	open-sse/services/usage.ts	Ollama Cloud nustatymų URL, naudojamas kvotos duomenims nuskaityti. Pakeiskite, jei naudojate reles / testavimo šablonus.
OLLAMA_USAGE_COOKIE	(nenustatyta)	open-sse/services/usage.ts	Ollama Cloud __Secure-session slapukas, naudojamas kvotos duomenims nuskaityti iš nustatymų puslapio. Konfidencialu; kai sukonfigūruotos kelios paskyros, pirmenybę teikite kiekvienam ryšiui skirtam laukui valdymo skydelyje.
OLLAMA_CLOUD_USAGE_COOKIE	(nenustatyta)	open-sse/services/usage.ts	Alternatyvus Ollama Cloud __Secure-session slapuko aplinkos kintamasis. Konfidencialu; kai sukonfigūruotos kelios paskyros, pirmenybę teikite kiekvienam ryšiui skirtam laukui valdymo skydelyje.
OMNIROUTE_OLLAMA_USAGE_COOKIE	(nenustatyta)	open-sse/services/usage.ts	Alternatyvus Ollama Cloud __Secure-session slapuko aplinkos kintamasis, naudojamas prieš trumpesnius alternatyvius pavadinimus. Konfidencialu; kai sukonfigūruotos kelios paskyros, pirmenybę teikite kiekvienam ryšiui skirtam laukui valdymo skydelyje.
OMNIROUTE_CODEWHISPERER_BASE_URL	https://codewhisperer.us-east-1.amazonaws.com	open-sse/services/usage.ts	CodeWhisperer (AWS Kiro) naudojimo limitų galinis taškas. Pakeiskite, jei naudojate reles / testavimo šablonus.

Important

Diegdami už atvirkštinio tarpinio serverio (nginx, Caddy), nustatykite NEXT_PUBLIC_BASE_URL į stabilų viešąjį URL (pvz., https://omniroute.example.com), kai OAuth atgalinio iškvietimo adresai arba sugeneruotos viešosios nuorodos turi naudoti šį pagrindinio kompiuterio vardą. To nepadarius, OAuth atgaliniai iškvietimai gali nepavykti, nes redirect_uri nesutaps, o sugeneruotos viešosios nuorodos gali nurodyti vidinę konteinerio kilmę.

Palikite BASE_URL kaip vidinį ciklo / konteinerio URL, skirtą užduotims tarp serverių. Vidinėms savikreipoms, perduodančioms prisijungimo duomenis, nenaudokite naršyklės Origin arba viešojo pagrindinio kompiuterio vardo.

Autentifikuotiems valdymo skydelio įrašymo veiksmams nereikia statinio viešojo bazinio URL: valdymo skydelis siunčia tos pačios kilmės nesaugiąsias užklausas su sesija susietu CSRF prieigos raktu. OmniRoute vis tiek centralizuoja viešosios kilmės patikrą ne valdymo skydelio naršyklės integracijoms: pirmiausia pasitikima aiškiai nurodytais viešojo URL aplinkos kintamaisiais; neapdorotos Forwarded / X-Forwarded-* antraštės ignoruojamos, nebent įjungta OMNIROUTE_TRUST_PROXY, o tiesioginis tarpinis serveris pažymėtas prieigos raktu kaip patikimas. Nenaudokite CORS nustatymų tos pačios kilmės valdymo skydelio užklausoms taisyti; CORS skirtas tik skirtingos kilmės naršyklės klientams.

---

8. Išeinantis tarpinis serveris

Nukreipkite iškvietimus į aukštesnio lygio LLM teikėjus per HTTP arba SOCKS5 tarpinį serverį, kad galėtumėte valdyti išeinantį srautą, geografinį maršruto parinkimą arba maskuoti IP adresą.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
ENABLE_SOCKS5_PROXY	true	open-sse/executors	Įjungia SOCKS5 tarpinio serverio agentą iškvietimams į aukštesnio lygio paslaugas. Norėdami jo atsisakyti, nustatykite false.
NEXT_PUBLIC_ENABLE_SOCKS5_PROXY	true	Kliento pusė	Leidžia kliento pusei žinoti apie SOCKS5 prieinamumą.
PROXY_SKIP_RECENTLY_FAILED	false	src/shared/utils/featureFlags.ts	Pasirenkama funkcijos žyma (žr. FEATURE_FLAGS.md; valdymo skydelio DB perrašymas turi pirmenybę). Tarpinių serverių telkiniai ir kiekvienos paskyros rotacija tam tikrą laiką pakartotinai neparinks ką tik sutrikusio nario (atmestas TCP bandymas arba per jį gautas 429); šis laikotarpis po kiekvieno pakartotinio sutrikimo dvigubėja iki nustatytos ribos. Ją įjungia true (arba 1, yes).
HTTP_PROXY	(nenustatyta)	Node.js standartas	HTTP tarpinis serveris iškvietimams į aukštesnio lygio paslaugas.
HTTPS_PROXY	(nenustatyta)	Node.js standartas	HTTPS tarpinis serveris iškvietimams į aukštesnio lygio paslaugas.
ALL_PROXY	(nenustatyta)	Node.js standartas	Universalus tarpinis serveris (palaiko socks5://).
OMNIROUTE_PROXY_ECHO_URL	(nenustatyta)	src/lib/proxyEchoTarget.ts	Nustato vieną echo-IP tikslinį URL, naudojamą tarpinio serverio išeinančio ryšio patikroms. Jei nenustatyta, patikra pirmiausia bando api64.ipify.org, tada api4.ipify.org, kad tik IPv4 palaikantys tuneliai nebūtų klaidingai laikomi neveikiančiais (#9694).
NO_PROXY	(nenustatyta)	Node.js standartas	Kableliais atskirti pagrindinių kompiuterių vardai arba IP adresai, kuriems tarpinis serveris neturi būti naudojamas.
OMNIROUTE_PROXY_DISPATCHER_CONNECTIONS	32	open-sse/utils/proxyDispatcher.ts	Didžiausias vienalaikių lizdų skaičius vienai talpykloje laikomai HTTP/SOCKS tarpinio serverio užklausų paskirstyklei. Ilgaamžiams SSE srautams, pvz., Codex /v1/responses, reikia daugiau nei vieno ryšio, kai kelios užklausos naudoja tą patį paskyros lygmens tarpinį serverį. Didesnės nei 256 reikšmės apribojamos.
SOCKS_HANDSHAKE_TIMEOUT_MS	10000	open-sse/utils/socksConnectorWithFamily.ts	SOCKS5 suderinimo (prisijungimo) skirtasis laikas milisekundėmis. Padidinkite jį, kai vienas gyvenamųjų IP šliuzo pagrindinis kompiuteris apkraunamas didele konkurencija (pvz., 100 vienalaikių užklausų) — prisotintame telkinyje tikrasis suderinimas gali trukti ilgiau nei 10 s, nors tarpinis serveris yra pasiekiamas; kitu atveju klaidingai pateikiama [Proxy Fast-Fail] Proxy unreachable. Apribojama iki 120000.
PROXY_FAIL_OPEN	false	src/sse/handlers/chatHelpers.ts	Kai nustatyta false (numatytoji reikšmė), užklausa, kurios priskirto tarpinio serverio nepavyksta nustatyti, yra atmetama (uždarai įvykus trikčiai), užuot grįžus prie tiesioginio ryšio — taip išvengiama tikrojo IP adreso nutekėjimo. Nustatykite true, kad atkurtumėte ankstesnę DIRECT atsarginę veikseną.
ENABLE_TLS_FINGERPRINT	false	open-sse/executors	Suklastoti TLS kontrolinį atspaudą naudojant wreq-js (imituoja Chrome 124). Padeda apeiti JA3/JA4 blokavimą.
TLS_FINGERPRINT_PROVIDERS	(nenustatyta)	open-sse/utils/proxyFetch.ts	Kableliais atskirtas leidžiamų teikėjų sąrašas naujam per tarpinį serverį vykdomam TLS maršrutizavimui (open-sse/utils/proxyFetch.ts). Kai reikšmė nenustatyta, tiesioginis TLS išlaiko ankstesnę elgseną; tik šie teikėjai maršrutizuojami per Chrome-124 kontrolinio atspaudo tarpinį sluoksnį.
OMNIROUTE_TURNSTILE_IGNORE_TLS_ERRORS	false	open-sse/services/claudeTurnstileSolver.ts	Leisti Claude Turnstile Playwright naršyklės kontekstui nepaisyti HTTPS sertifikato klaidų.

Scenarijai

Scenarijus	Konfigūracija
SOCKS5 per SSH tunelį	ALL_PROXY=socks5://127.0.0.1:7890, ENABLE_SOCKS5_PROXY=true
Įmonės HTTP tarpinis serveris	HTTP_PROXY=http://proxy.corp.com:3128, HTTPS_PROXY=http://proxy.corp.com:3128, NO_PROXY=localhost,internal.corp.com
Apsauga nuo kontrolinio atspaudo nustatymo	ENABLE_TLS_FINGERPRINT=true — reikalingas wreq-js (įtrauktas)
Valdomas išeinantis srautas / nėra tiesioginės prieigos	Palikite PROXY_FAIL_OPEN=false (numatytoji reikšmė). Kai tarpinis serveris nepasiekiamas, užklausos griežtai atmetamos, užuot nutekėjusios tiesioginiu ryšiu.
Senasis režimas / kūrimas — leisti tiesioginį atsarginį ryšį	PROXY_FAIL_OPEN=true. Atkuriama iki saugumo sustiprinimo buvusi elgsena: nepavykus nustatyti tarpinio serverio, naudojamas tiesioginis ryšys.

Pastaba (NVIDIA patikros apėjimas — #3226): NVIDIA API rakto patikros galinis taškas užstringa, kai užklausa nukreipiama per visuotinį tarpinį serverį / TLS modifikuotą „fetch“ (undici dispečeris → 504). src/lib/providers/validation.ts::directHttpsRequest() sąmoningai apeina tarpinio serverio pataisą tik šiam vienam patikros iškvietimui, naudodama safeOutboundFetch({ bypassProxyPatch: true }). Tai dokumentuota, ribotos apimties išimtis — ji neturi įtakos pokalbių / naudojimo išeinančiam srautui. Apėjimo apimtį apriboja tests/unit/proxy-bypass-scope-guard-3226.test.ts.

---

9. CLI įrankių integracija

Valdo, kaip „OmniRoute“ aptinka ir paleidžia CLI pagalbinius procesus („Claude Code“, „Codex“ ir kt.).

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
CLI_MODE	auto	src/shared/services/cliRuntime.ts	auto = ieškoti sistemos PATH; manual = naudoti tik aiškiai nurodytus kelius.
CLI_EXTRA_PATHS	(nenustatyta)	src/shared/services/cliRuntime.ts	Papildomi PATH įrašai, skirti CLI vykdomiesiems failams aptikti (atskirti dvitaškiais).
CLI_CONFIG_HOME	(nenustatyta)	src/shared/services/cliRuntime.ts	Pakeičia namų katalogą, iš kurio skaitomos CLI konfigūracijos (~/.claude, ~/.codex). Kelias turi būti absoliutus ir būti proceso namų kataloge — arba, konteineryje, būti prijungtas naudojant susiejimą (taip veikia /host-home). Visais kitais atvejais naudojamas namų katalogas.
CLI_ALLOW_CONFIG_WRITES	true	src/shared/services/cliRuntime.ts	Leidžia OmniRoute rašyti CLI konfigūracijos failus (atnaujinti prieigos raktus, įrašyti seanso duomenis). Nustačius false, kiekvienas bandymas rašyti CLI konfigūraciją nepavyks ir bus pateikta aiški klaida „rašymas išjungtas“.
CLI_CLAUDE_BIN	claude	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Claude CLI vykdomąjį failą.
CLI_CODEX_BIN	codex	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Codex CLI vykdomąjį failą.
CLI_DROID_BIN	droid	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Droid CLI vykdomąjį failą.
CLI_OPENCLAW_BIN	openclaw	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į OpenClaw CLI vykdomąjį failą.
CLI_CURSOR_BIN	agent, tada cursor	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Cursor agento vykdomąjį failą. Jei jis nenurodytas, pirmiausia bandoma aptikti agent, o nepavykus naudojamas cursor.
CLI_CLINE_BIN	cline	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Cline CLI vykdomąjį failą.
CLI_5DIVE_BIN	5dive	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į 5dive CLI vykdomąjį failą.
CLI_5DIVE_STATE_DIR	/var/lib/5dive	src/shared/services/cliRuntime.ts	5dive sistemos būsenos katalogas (root priklausantys autentifikavimo profiliai); atitinka paties 5dive numatytąją STATE_DIR reikšmę.
CLI_CONTINUE_BIN	cn	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Continue CLI vykdomąjį failą.
CLI_QODER_BIN	qodercli	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Qoder CLI vykdomąjį failą.
CLI_QWEN_BIN	qwen	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Qwen Code CLI vykdomąjį failą.
CLI_AIDER_BIN	aider	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Aider CLI vykdomąjį failą.
CLI_GOOSE_BIN	goose	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Goose CLI vykdomąjį failą.
CLI_GEMINI_BIN	gemini	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Google Gemini CLI vykdomąjį failą — naudojamas tik aptikimui ir būklės patikroms serverio pusėje; omniroute run gemini aptinka gemini vykdomąjį failą sistemos PATH.
CLI_KILO_BIN	kilocode	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į Kilo Code CLI vykdomąjį failą.
CLI_OPENCODE_BIN	opencode	src/shared/services/cliRuntime.ts	Pasirinktinis kelias į OpenCode CLI vykdomąjį failą.
CLI_HERMES_BIN	hermes	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki Hermes vykdomojo failo. Bendrinamas abiejų katalogo įrašų (hermes ir hermes-agent).
CLI_FORGE_BIN	forge	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki ForgeCode CLI vykdomojo failo.
CLI_JCODE_BIN	jcode	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki jcode CLI vykdomojo failo.
CLI_DEEPSEEK_TUI_BIN	deepseek-tui	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki DeepSeek TUI vykdomojo failo.
CLI_CODEWHALE_BIN	codewhale	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki CodeWhale CLI vykdomojo failo.
CLI_SMELT_BIN	smelt	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki Smelt CLI vykdomojo failo.
CLI_PI_BIN	pi	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki Pi (pi-coding-agent) vykdomojo failo.
CLI_CRUSH_BIN	crush	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki Crush CLI vykdomojo failo.
CLI_OMP_BIN	omp	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki Oh My Pi (omp) agento vykdomojo failo.
CLI_LETTA_BIN	letta	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki Letta CLI vykdomojo failo.
CLI_PRIME_AGENT_BIN	prime-agent	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki Prime Agent (Prime Intellect) vykdomojo failo.
CLI_WINDSURF_BIN	(nėra)	src/shared/services/cliRuntime.ts	Pasirinktinis kelias iki Windsurf vykdomojo failo. Windsurf pateikiamas be numatytosios komandos — vykdomojo failo aptikimas lieka išjungtas, kol ši reikšmė nenustatyta.
CLI_DEVIN_BIN	devin	open-sse/executors/devin-cli.ts	Pasirinktinis kelias iki Devin CLI vykdomojo failo (v3.8.0). Naudojamas Windsurf/Devin vykdyklėje.
DEVIN_DESKTOP_VERSION	3.6.27	open-sse/executors/devin-desktop.ts	Devin Desktop ide_version. Perrašomos reikšmės turi būti x.y.z formato; netinkamų reikšmių atveju naudojama patikrinta numatytoji reikšmė.
DEVIN_DESKTOP_EXTENSION_VERSION	1.48.2	open-sse/executors/devin-desktop.ts	Kartu pateikiama Codeium/language-server extension_version, kuri skiriasi nuo Desktop ide_version. Perrašomos reikšmės turi būti x.y.z formato; netinkamų reikšmių atveju naudojama kartu pateikiama numatytoji reikšmė.
CLI_DEVIN_AGENTIC_BIN	devin	open-sse/executors/devin-cli-agentic.ts	Tik agentinei sąsajai skirtas Devin CLI perrašymas. Vykdyklė priima tik vietinį ACP stdio pirminį srautą.
DEVIN_AGENTIC_HOME	(privaloma)	open-sse/executors/devin-cli-agentic.ts	Absoliutus izoliuotas agentinio Devin poprocesio namų katalogas; priimami sąsajos keliai yra /home/bridge ir užduočiai vietiniai .sandbox keliai (Windows sistemoje – C:\...\.sandbox\...).
DEVIN_AGENTIC_ACP_TIMEOUT_MS	120000	open-sse/executors/devin-cli-agentic.ts	Didžiausia vieno Devin ACP ciklo trukmė, po kurios sąsaja nutraukia antrinį procesą ir grąžina aiškų skirtojo laiko viršijimo pranešimą.
DEVIN_BRIDGE_MODEL	devin-cli-agentic/swe-1-7	docker/devin-bridge/compose.yml	Pagrindinis Claude Code modelio alternatyvusis pavadinimas izoliuotai sąsajai. Veikiantis testavimo mechanizmas pavyzdį pakeičia modeliu, kurį grąžina dabartinė Devin paskyra.
DEVIN_BRIDGE_SONNET_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Izoliuotos sąsajos alternatyvusis pavadinimas, naudojamas, kai Claude Code prašo numatytojo Sonnet modelio.
DEVIN_BRIDGE_OPUS_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Izoliuotos sąsajos alternatyvusis pavadinimas, naudojamas, kai Claude Code prašo numatytojo Opus modelio.
DEVIN_BRIDGE_HAIKU_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Izoliuotos sąsajos alternatyvusis pavadinimas, naudojamas, kai Claude Code prašo numatytojo Haiku modelio.
DEVIN_BRIDGE_SUBAGENT_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Izoliuotos sąsajos alternatyvusis pavadinimas, naudojamas Claude Code pagalbiniams agentams.
DEVIN_SEAT_API_URL	https://server.codeium.com	open-sse/services/usage/devinCli.ts	Pasirinktinis Codeium vietų valdymo API, kurį Devin CLI naudoja kvotai (GetUserStatus), perrašymas.
AUGGIE_BIN	auggie	open-sse/executors/auggie.ts	Absoliutaus kelio iki Augment (Auggie) CLI dvejetainio failo, kurį naudoja vietinis auggie teikėjas, perrašymas. Jei nenurodyta, naudojamas CLI_AUGGIE_BIN, tada ieškoma PATH.
CLI_AUGGIE_BIN	auggie	open-sse/executors/auggie.ts	Alternatyvus Augment (Auggie) CLI dvejetainio failo kelio perrašymas (tikrinamas po AUGGIE_BIN).
ZCODE_BIN	zcode	open-sse/executors/zcode.ts	Dvejetainis failas, naudojamas vietinio zcode teikėjo stdio klientui. Jei nenurodyta, naudojamas PATH esantis zcode.
ZCODE_ARGS	—	open-sse/executors/zcode.ts	Papildomų argumentų, perduodamų zcode dvejetainiam failui, kai jis paleidžiamas naudojant cliTools, JSON masyvas (≤16 eilučių).
ZCODE_CWD	process.cwd()	open-sse/executors/zcode.ts	ZCode programų serverio antrinio proceso darbinis katalogas.
ZCODE_PROVIDER_ID	builtin:zai-coding-plan	open-sse/executors/zcode.ts	Teikėjo ID, siunčiamo programų serveriui, perrašymas.
ZCODE_SERVER_RUNTIME_ROOT	~/.zcode/server	open-sse/executors/zcode.ts	ZCode programų serverio vykdymo aplinkos šakninis katalogas (jame yra kartu pateikiami node ir zcode-server.cjs).
ZCODE_SERVER_NODE	<runtimeRoot>/node	open-sse/executors/zcode.ts	Node vykdomasis failas, naudojamas ZCode programų serveriui paleisti.
ZCODE_SERVER_ENTRY	<runtimeRoot>/zcode-server.cjs	open-sse/executors/zcode.ts	Programų serverio pradinis scenarijus, naudojamas ZCode serveriui paleisti.
ZCODE_STARTUP_TIMEOUT_MS	10000	open-sse/executors/zcode.ts	Paleidimo skirtasis laikas (ms), kuriam pasibaigus ZCode programų serverio paleidimas laikomas nepavykusiu.
ZCODE_RPC_TIMEOUT_MS	30000	open-sse/executors/zcode.ts	Kiekvienos ZCode programų serverio RPC užklausos skirtasis laikas (ms).
ZCODE_TURN_TIMEOUT_MS	120000	open-sse/executors/zcode.ts	Ilgiausia vieno ZCode ciklo trukmė (ms), kuriai pasibaigus prižiūrėtojas jį nutraukia.
ZCODE_POLL_INTERVAL_MS	250	open-sse/executors/zcode.ts	ZCode ciklo užbaigimo tikrinimo intervalas (ms).
HERMES_HOME	~/.hermes	src/lib/cli-helper/config-generator/hermesHome.ts	Hermes Agent namų katalogas, kuriame OmniRoute skaito ir įrašo Hermes CLI konfigūraciją. Atitinka aplinkos kintamąjį, kurį Hermes PowerShell diegimo programa nustato Windows sistemoje (%LOCALAPPDATA%\hermes).

Automatinis CLI profilių sinchronizavimas

Šios funkcijų žymos yra pasirenkamos ir pagal numatytąsias nuostatas išjungtos. Jas taip pat galima įjungti arba išjungti CLI Code valdymo skydelyje.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_AUTO_SYNC_CODEX_PROFILES	false	src/shared/constants/featureFlagDefinitions.ts	Sinchronizavus teikėjo modelius, automatiškai perrašo ~/.codex/*.config.toml profilių failus pagal esamą katalogą. Reikalingas CLI_ALLOW_CONFIG_WRITES; niekada nekeičia aktyviosios arba numatytosios Codex konfigūracijos, autentifikavimo, Codex-lb nuostatų ar teikėjo pasirinkimo.
OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES	false	src/shared/constants/featureFlagDefinitions.ts	Sinchronizavus teikėjo modelius, automatiškai perrašo ~/.claude/profiles/<name>/settings.json Claude Code profilių failus pagal esamą katalogą. Reikalingas CLI_ALLOW_CONFIG_WRITES; niekada nekeičia aktyviosios arba numatytosios Claude konfigūracijos, autentifikavimo ar teikėjo pasirinkimo.

Docker pavyzdys

# Prijunkite pagrindinio kompiuterio dvejetainius failus prie konteinerio ir nurodykite OmniRoute, kur jie yra:
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 įsigalioja tik tada, kai kelias iš tiesų prijungtas iš pagrindinio kompiuterio naudojant bind tipo prijungimą — naudokite jį kartu su tokiais prijungimais kaip ~/.codex:/host-home/.codex:rw (žr. host profilį faile docker-compose.yml). Kelias, kuris nėra nei konteinerio naudotojo namų kataloge, nei prijungtas naudojant bind tipo prijungimą, ignoruojamas, nes į jį įrašyti duomenys būtų prarasti iš naujo sukūrus konteinerį.

Atvaizdis vykdomas kaip USER node, todėl neprijungtas /root nėra tinkamas perrašymas.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_CONTAINER	(automatinė)	src/shared/utils/containerEnv.ts	Priverstinai įjungti (1/true) arba išjungti (0/false) konteinerio aptikimą. Reikalinga tik vykdymo aplinkose, kurių automatinis aptikimas neatpažįsta.
OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE	false	src/shared/services/cliRuntime.ts	Vis tiek leisti CLI įrankio konfigūraciją įrašyti į neprijungtą konteinerio kelią. CLI atitikmuo yra --allow-container-write.

CLI vykdomojo failo (omniroute) pagalbiniai kintamieji

Šie kintamieji reguliuoja paties omniroute CLI vykdomojo failo veikimą (ne anksčiau aprašytą pagalbinio konteinerio aptikimą).

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_LANG	(sistemos)	bin/cli/i18n.mjs	Priverstinai nustatyti CLI išvesties kalbą. BCP-47 lokalė (pvz., en, pt-BR). Perrašo sistemos lokalės aplinkos kintamuosius (LC_ALL, LC_MESSAGES).
OMNIROUTE_SHOW_LOG	(nenustatyta)	bin/cli/runtime/processSupervisor.mjs	Nustatykite į 1, kad prižiūrimu režimu serverio stdout/stderr būtų perduodami į terminalą. Atitinka omniroute serve parametrą --log.
OMNIROUTE_CLI_TOKEN	(nenustatyta)	bin/cli/api.mjs	Įrenginio autentifikavimo prieigos raktas, įterpiamas kaip x-omniroute-cli-token antraštė. Automatiškai sugeneruojamas atliekant 8.12 užduotį.
OMNIROUTE_HTTP_TIMEOUT_MS	30000	bin/cli/api.mjs	Kiekvieno CLI → serverio užklausos bandymo HTTP skirtasis laikas (ms).
OMNIROUTE_READY_TIMEOUT_MS	60000	bin/cli/utils/pid.mjs	Ilgiausias laikas (ms), kurį CLI laukia serverio būklės patikros galinio taško prieš išvesdamas įspėjimą apie pasibaigusį skirtąjį laiką. Naudinga esant lėtam šaltajam paleidimui (pvz., Windows). Taip pat galima nustatyti naudojant --ready-timeout.
OMNIROUTE_VERBOSE	0	bin/cli/api.mjs	Nustatykite į 1, kad vykdant CLI komandas į stderr būtų išvedama pakartotinių bandymų / delsos diagnostika.
OMNIROUTE_PLUGIN_PATH	(nenustatyta)	bin/cli/plugins.mjs	Pasirinktinis CLI papildinių aptikimo katalogas (omniroute-cmd-* paketai). Jei nenustatyta, numatytoji reikšmė yra ~/.omniroute/plugins/. Skirta tik CLI — ji niekada nepasiekia serverio pusės papildinių skaitytuvo, kurio vietą nurodo OMNIROUTE_PLUGINS_DIR (2 skyrius).

---

10. Vidinio agento ir MCP integracijos

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašas
OMNIROUTE_BASE_URL	automatinis aptikimas	open-sse/mcp-server/server.ts	Aiškiai nurodytas URL, kuriuo MCP/A2A įrankiai pasiekia OmniRoute. Pakeičia automatinį localhost aptikimą.
OMNIROUTE_API_KEY	(nenustatyta)	MCP/A2A moduliai	API raktas, skirtas vidinio MCP įrankio ir A2A įgūdžių iškvietimams.
OMNIROUTE_API_KEY_ID	(nenustatyta)	open-sse/mcp-server/audit.ts	Rakto ID, skirtas MCP audito žurnalo įrašams priskirti.
ROUTER_API_KEY	(nenustatyta)	Senstelėjusi sistema	Senstelėjęs OMNIROUTE_API_KEY pseudonimas.
OMNIROUTE_A2A_HISTORY_RETENTION_DAYS	30	src/lib/a2a/taskManager.ts	Dienų skaičius, kiek A2A užduočių istorija saugoma vietinėje duomenų bazėje, kol kasdienis valymas pašalina eilutę. Jei reikšmė nenustatyta, nėra skaitinė arba yra <= 0, naudojama 30.
OMNIROUTE_A2A_MEMORY_HITS	1	src/lib/a2a/taskExecution.ts	A2A atminties atitikčių stebimumo funkcijos avarinis išjungiklis. Nustatykite 0, kad užduočiai būtų visiškai praleista paieška atmintyje; bet kuri kita reikšmė (įskaitant nenustatytą) palieka ją įjungtą.
OMNIROUTE_ISSUE_AGENT_ENABLED	false	src/app/api/issue-agent/runs/route.ts	Įjungia autonominį / vietinį Issue Agent įrašyto pirminio įvertinimo galinį tašką. Palikite išjungtą, nebent aiškiai vykdomos vietinės įrašyto pirminio įvertinimo darbo eigos.
OMNIROUTE_ISSUE_AGENT_TIMEOUT_MS	(nenustatyta)	src/lib/issueAgent/execution.ts	Vieno Issue Agent įrašyto pirminio įvertinimo vykdymo skirtasis laikas (ms). Apribojamas vidine didžiausia reikšme; jei nenustatyta arba netinkama, naudojama įtaisytoji numatytoji reikšmė.
OMNIROUTE_CONTEXT	(aktyvus kontekstas)	bin/cli/program.mjs, bin/cli/api.mjs	CLI nuotolinio režimo kontekstas / profilis, skirtas omniroute komandoms; pakeičia aktyvų kontekstą vietinėje kontekstų saugykloje. Lygiavertis --context <name>.
OMNIROUTE_CONTEXT_KEYCHAIN_DISABLED	0	bin/cli/contexts.mjs	Išjungia pasirinktinę CLI konteksto prisijungimo duomenų keytar OS raktinės posistemę. Įjungus prisijungimo duomenys lieka config.json faile, kurio režimas yra 0600, o CLI pateikia vienkartinį įspėjimą apie atsarginį režimą; skirta sąmoningam naudojimui begalvėse sistemose / konteineriuose.
OMNIROUTE_MCP_ENFORCE_SCOPES	true	open-sse/mcp-server/server.ts	MCP įrankių iškvietimams taiko apimtimis pagrįstą prieigos kontrolę.
OMNIROUTE_MCP_SCOPES	(visos)	open-sse/mcp-server/server.ts	Kableliais atskirtos apimtys: admin, combos, health, models, routing, budget, metrics, pricing, memory, skills.
OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS	false	open-sse/mcp-server/descriptionCompressor.ts	Suglaudina MCP įrankių aprašus prieš serializuojant manifestą. Įjungiančios reikšmės: 1, true, on.
OMNIROUTE_MCP_DESCRIPTION_COMPRESSION	rtk	open-sse/mcp-server/descriptionCompressor.ts	Glaudinimo algoritmas / profilis. Išjungiančios reikšmės: 0, false, off.
OMNIROUTE_MCP_FETCH_TIMEOUT_MS	10000	open-sse/mcp-server/fetchTimeout.ts	Nutraukimo laiko limitas (ms), skirtas MCP serverio vidinėms valdymo užklausoms (būsenos, atsparumo, derinių, kvotos, naudojimo).
OMNIROUTE_MCP_UPSTREAM_TIMEOUT_MS	60000	open-sse/mcp-server/fetchTimeout.ts	Nutraukimo laukimo limitas (ms), taikomas MCP užklausoms, kurios laukia teikėjo (route_request, web_search, web_fetch).
OMNIROUTE_CORPUS_CACHE_SIZE	5	src/lib/localCorpus/configured.ts	Didžiausias atmintyje laikomų vietinio tekstyno indekso egzempliorių skaičius (LRU, po vieną kiekvienam indeksuotam šakniniam katalogui). Apribojama iki ne mažesnės nei 1 reikšmės.
MODEL_SYNC_INTERVAL_HOURS	24	src/shared/services/modelSyncScheduler.ts	Modelių katalogo sinchronizavimo intervalas valandomis.
PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES	70	src/lib/usage/providerLimits.ts	Teikėjo spartos apribojimų ir kvotos tikrinimo intervalas.
PROVIDER_LIMITS_SYNC_SPACING_MS	1500	src/lib/usage/providerLimits.ts	Tarpas (ms) tarp nuoseklių OAuth kvotos gavimų vykdant masinį sinchronizavimą; OAuth ryšiai apdorojami po vieną, kad pirminė sistema nebūtų užtvindyta užklausomis. 0 šį ribojimą išjungia (vykdoma lygiagrečiai).
OMNIROUTE_QUOTA_FETCH_MIN_INTERVAL_MS	250	open-sse/services/quotaFetchThrottle.ts	Minimalus intervalas (ms) tarp nuoseklių pirminės sistemos kvotos gavimų kiekvienos užklausos išankstinės patikros / stebėjimo kelyje; išskirsto lygiagrečius tinklo kreipinius, kad daug paskyrų iš vieno IP neužtvindytų pirminės sistemos. Integruota į Codex (/wham/usage), DeepSeek, Bailian (abiejose gavimo vietose), OpenCode ir Crof kvotos gavimo priemones (#6009, #6911). Bendrasis usage.ts::getUsageForProvider nukreipimo kelias (github/glm/minimax/nanogpt/xai/ir kt.) dar neapimtas — stebimas atskirai. Podėlio atitiktys nepaveikiamos. 0 išjungia; ribojama iki 0..5000.
PROVIDER_LIMITS_POST_USAGE_REFRESH_DELAY_MS	5000	src/lib/usage/providerLimits.ts	Delsa (ms) prieš atnaujinant teikėjo apribojimus po faktinio naudojimo įvykio, kad pirminės sistemos kvotos API spėtų užregistruoti naudojimą.
OMNIROUTE_LOGIN_BROWSER_PATH	automatinis aptikimas	open-sse/services/adobeFireflyBrowserLogin.ts	Absoliutusis kelias iki sistemos Chrome arba Edge vykdomojo failo, naudojamo interaktyviai prisijungti prie Adobe Firefly ir foniniam atnaujinimui.
ADOBE_FIREFLY_BROWSER_REFRESH	įjungta	open-sse/services/adobeFireflySession.ts	Palaiko IMS ir naršyklės rizikos būsenos aktualumą naudodama paskyrai priskirtas Chrome CDP sesijas. Norėdami išjungti naršyklės atnaujinimą, nustatykite 0.
ADOBE_FIREFLY_SESSION_DISK	įjungta	open-sse/services/adobeFireflySession.ts	Išsaugo atkurtas Adobe sesijas kataloge DATA_DIR, kad jos išliktų po proceso paleidimo iš naujo. Nustatykite 0, kad sesijos būtų laikomos tik atmintyje.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS	12000	open-sse/services/adobeFireflySession.ts	Minimalus intervalas milisekundėmis tarp Adobe Firefly generavimo pateikimų; 0 išjungia intervalą.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS	15000	open-sse/services/adobeFireflySession.ts	Papildomas ramybės laikotarpis milisekundėmis po kas trečio sėkmingo pateikimo Adobe sistemai.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS	8000	open-sse/services/adobeFireflyClient.ts	Bazinis kartojimo delsos laikas milisekundėmis po trumpalaikių Adobe 408 atsakymų; derinamas su pateikimų intervalais per ne daugiau kaip penkis bandymus.
OMNIROUTE_DISABLE_BACKGROUND_SERVICES	false	src/instrumentation-node.ts	Išjungia visas fonines paslaugas (sinchronizavimą, kainodarą, modelių atnaujinimą). Naudinga CI / testavimui.
OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS	(nenustatyta)	src/lib/config/runtimeSettings.ts	Priverstinai įjungia fonines užduotis, kai aptinkamas automatizuotas testavimas. Nustatykite 1, kad nepaisytumėte testavimo euristikos.
OMNIROUTE_BUDGET_RESET_JOB_INTERVAL_MS	600000	src/lib/jobs/budgetResetJob.ts	Biudžeto nustatymo iš naujo tikrinimo periodiškumas (ms). Mažiausia reikšmė – 10000.
OMNIROUTE_CONNECTION_RECOVERY_INTERVAL_MS	60000	src/lib/quota/connectionRecovery.ts	Aktyvaus ryšio atvėsimo atkūrimo periodiškumas (ms): pakartotinai patvirtinami ryšiai, kurių laikinasis rate_limited_until jau praėjo, nevykdant to pagrindiniame užklausų apdorojimo kelyje. Mažiausia reikšmė – 5000.
OMNIROUTE_DISABLE_CONNECTION_RECOVERY	false	src/lib/quota/connectionRecovery.ts	Išjungti aktyvaus ryšio atvėsimo atkūrimo planuoklę (atidėtasis atkūrimas funkcijoje getProviderCredentials vis tiek taikomas).
OMNIROUTE_REASONING_CACHE_CLEANUP_INTERVAL_MS	1800000	src/lib/jobs/reasoningCacheCleanupJob.ts	Samprotavimo podėlio valymo periodiškumas (ms). Mažiausia reikšmė – 60000.
OMNIROUTE_REASONING_MIN_BUDGET	nenustatyta (išjungta)	open-sse/services/reasoningTokenBuffer.ts	Pasirenkama minimali mąstančių modelių išvesties biudžeto riba: iškvietėjo max_tokens, patenkantis į intervalą [256, minimali riba), padidinamas iki minimalios ribos (neviršijant modelio išvesties ribos). Nenustatyta = kliento biudžetai niekada nedidinami (#9507).
OMNIROUTE_LOG_EXPORT_CRON	0 * * * *	src/lib/jobs/logExportJob.ts	Iškvietimų žurnalo eksportavimo užduoties, kuri apdoroja kiekvieną įjungtą žurnalo eksportavimo paskirties vietą, cron išraiška (UTC).
OMNIROUTE_CONFIG_HOT_RELOAD_MS	5000	src/lib/config/hotReload.ts	Konfigūracijos karštojo įkėlimo iš naujo apklausos intervalas (ms). Mažesnė nei 1000 reikšmė atmetama.
OMNIROUTE_DISABLE_REDIS_AUTH_CACHE	(įjungta)	src/lib/db/apiKeys.ts	Nustatykite 1, kad būtų apeitas Redis pagrįstas API rakto autentifikavimo podėlis (priverstinai skaitoma iš DB).
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS	0	open-sse/services/compression/engines/rtk/filterLoader.ts	Pasitikėti naudotojų valdomomis RTK projekto filtravimo taisyklėmis neatliekant griežtų parašo patikrų.
OMNIROUTE_LITE_MAX_TOOL_LENGTH	2000	open-sse/services/compression/lite.ts	Lite aktyvaus įrankio rezultato trumpinimo simbolių riba, kai lite.maxToolLength nenustatyta. Diapazonas 256–1000000. Valdymo skydelio nuostata turi pirmenybę prieš šį aplinkos kintamąjį.
OMNI_COMPRESSION_WORKERS	2	open-sse/services/compression/compressionWorkerPool.ts	Didžiausias vienu metu veikiančių sinchroninių RTK/Caveman vykdyklių skaičius; perteklinės užduotys laukia FIFO tvarka.
OMNI_COMPRESSION_WORKER_TIMEOUT_MS	120000	open-sse/services/compression/compressionWorkerPool.ts	Kiekvienos užduoties skirtasis laikas milisekundėmis. Skirtąjį laiką viršiję vykdykliai nutraukiami, o užklausa paliekama nepakeista pagal atvirojo gedimo principą.
OMNI_COMPRESSION_WORKER_IDLE_MS	60000	open-sse/services/compression/compressionWorkerPool.ts	Neveiklos trukmė milisekundėmis, po kurios nenaudojamas glaudinimo vykdyklis nutraukiamas.
COMPRESSION_PIPELINE_BREAKER_ENABLED	false	open-sse/services/compression/pipelineEngineBreaker.ts	T02 sudėtinio konvejerio kiekvieno variklio grandinės pertraukiklio pagrindinis jungiklis. Pasirenkama funkcija (pagal numatymą išjungta) — įjungus variklis, kuris pakartotinai sukelia klaidas skirtingose užklausose, atvėsimo laikotarpiu praleidžiamas (atvirasis gedimas); išjungus išlaikoma baitų lygmeniu identiška ankstesnė elgsena.
COMPRESSION_PIPELINE_BREAKER_THRESHOLD	3	open-sse/services/compression/pipelineEngineBreaker.ts	Iš eilės skirtingose užklausose įvykstančių klaidų skaičius, po kurio atidaromas variklio grandinės pertraukiklis.
COMPRESSION_PIPELINE_BREAKER_COOLDOWN_MS	30000	open-sse/services/compression/pipelineEngineBreaker.ts	Laikas milisekundėmis, kurį atidarytas variklis praleidžiamas prieš pusiau atviro režimo bandymą.
COMPRESSION_CCR_RETRIEVAL_RAMP_FACTOR	2	open-sse/services/compression/engines/ccr/index.ts	T08/H8 CCR gavimu pagrįstas laipsniškas didinimas: kiekvienas ankstesnis išsaugoto bloko gavimas tiesiškai padidina jo faktinę minChars reikšmę (dažnai gaunamas turinys glaudinamas mažiau; >=3 gavimai = niekada neglaudinama). 1 išjungia laipsnišką didinimą (tik dvejetainis praleidimas pasiekus slenkstį).
COMPRESSION_CCR_DURABLE_STORE	true	open-sse/services/compression/engines/ccr/index.ts	CCR patvari blokų saugykla (#9061). Atmintyje esančios saugyklos duomenys išsaugomi SQLite, todėl blokas išlieka po LRU pašalinimo, TTL galiojimo pabaigos, paleidimo iš naujo arba gavimo užklausai patekus į kitą egzempliorių. Nustatykite false, kad blokai būtų laikomi tik atmintyje. Didesni nei 512 KB blokai ir debesijos vykdymo aplinkos visada naudoja tik atmintį.
COMPRESSION_PREFIX_FREEZE_ENABLED	false	open-sse/services/compression/prefixFreeze.ts	T08/H5 naudojimo stebėjimu pagrįsto prefikso fiksavimo pagrindinis jungiklis. Pasirenkama funkcija (pagal numatytuosius nustatymus išjungta) — kai įjungta, sisteminis raginimas, pastebėtas >= slenkstinį skaičių kartų, laikomas stabiliu podėliuojamu prefiksu ir apsaugomas nuo glaudinimo net tiems teikėjams, kurių neaptinka statinė podėlio euristika (fiksavimas tik išsaugo, niekada nekeičia).
COMPRESSION_PREFIX_FREEZE_THRESHOLD	3	open-sse/services/compression/prefixFreeze.ts	Sisteminio raginimo stebėjimų skaičius, po kurio jis laikomas fiksuotu stabiliu prefiksu.
OMNIROUTE_BOOTSTRAPPED	false	src/app/(dashboard)/dashboard/page.tsx	Po pradinės sąrankos paleisties scenarijus nustato true. Valdo sąrankos vediklio matomumą.
OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE	0	open-sse/executors/antigravity.ts	Avarinė išimtis: leidžia užklausos turiniui pakeisti Antigravity projekto lauką.
ANTIGRAVITY_CREDITS	off	open-sse/services/antigravityCredits.ts	Google One AI kreditų politika: off niekada neįterpia kreditų, retry įterpia vieną kartą po tinkamos kvotos 429 klaidos, o always įterpia pirmoje užklausoje.
ANTIGRAVITY_ALLOW_SIGNATURE_BYPASS	0	open-sse/translator/request/openai-to-gemini.ts	Leidžia Antigravity užklausų vertikliui praleisti griežtą CLI užklausos parašo tikrinimą, kai aukštesnio lygio paslauga atmeta tikrus parašus (derinimo / pasenusio CLI režimas). Ne nulinė reikšmė įjungia apėjimą.
AGY_TOKEN_FILE	~/.gemini/antigravity-cli/antigravity-oauth-token	src/app/api/providers/agy-auth/apply-local/route.ts	Pakeičia Antigravity CLI (agy) prieigos rakto failo kelią, naudojamą automatiškai aptinkamam vietinio prisijungimo importavimui.

OAuth CLI tiltas (vidinis)

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašas
OMNIROUTE_SERVER	automatinis aptikimas	src/lib/oauth/config/index.ts	CLI↔OmniRoute autentifikavimo tilto serverio URL.
OMNIROUTE_TOKEN	(nenustatyta)	src/lib/oauth/config/index.ts	CLI tilto autentifikavimo prieigos raktas.
OMNIROUTE_USER_ID	cli	src/lib/oauth/config/index.ts	CLI tilto seansų naudotojo ID.
SERVER_URL	(nenustatyta)	src/lib/oauth/config/index.ts	Senasis OMNIROUTE_SERVER alternatyvus pavadinimas.
CLI_TOKEN	(nenustatyta)	src/lib/oauth/config/index.ts	Senasis OMNIROUTE_TOKEN alternatyvus pavadinimas.
CLI_USER_ID	(nenustatyta)	src/lib/oauth/config/index.ts	Senasis OMNIROUTE_USER_ID alternatyvus pavadinimas.

---

11. „OAuth“ teikėjų prisijungimo duomenys

Integruoti prisijungimo duomenys, skirti localhost kūrimo aplinkai. Diegdami nuotolinėje aplinkoje, kiekvieno teikėjo kūrėjų konsolėje užregistruokite savo prisijungimo duomenis.

Kintamasis	Teikėjas	Pastabos
CLAUDE_OAUTH_CLIENT_ID	Claude Code (Anthropic)	Viešasis klientas — slaptasis raktas nereikalingas.
CLAUDE_CODE_REDIRECT_URI	Claude Code	Perrašomas peradresavimo URI. Numatytoji reikšmė: https://platform.claude.com/oauth/code/callback
CODEX_OAUTH_CLIENT_ID	Codex / OpenAI	Viešasis klientas.
GEMINI_OAUTH_CLIENT_ID	Gemini (Google)	Reikalingas atitinkamas _SECRET.
GEMINI_OAUTH_CLIENT_SECRET	Gemini (Google)	—
KIMI_CODING_OAUTH_CLIENT_ID	Kimi Coding (Moonshot)	Viešasis klientas.
ANTIGRAVITY_OAUTH_CLIENT_ID	Antigravity (Google)	Reikalingas atitinkamas _SECRET.
ANTIGRAVITY_OAUTH_CLIENT_SECRET	Antigravity (Google)	—
GITHUB_OAUTH_CLIENT_ID	GitHub Copilot	Viešasis klientas.
GHE_COPILOT_OAUTH_CLIENT_ID	GHE Copilot	Pasirinktinis „GitHub Enterprise Copilot“ OAuth kliento ID perrašymas. Jei nenustatyta, naudojama viešoji numatytoji GITHUB_OAUTH_CLIENT_ID reikšmė.
WINDSURF_API_KEY	Windsurf / Devin (v3.8)	Atsarginis API raktas, kurį naudoja open-sse/executors/devin-cli.ts, kai nėra konkrečiam ryšiui skirtų prisijungimo duomenų. Pasirinktinis.
CLI_DEVIN_BIN	Devin CLI (v3.8)	Pasirinktinis kelias iki Devin CLI vykdomojo failo (devin). Nustatomas faile open-sse/executors/devin-cli.ts.
GITLAB_DUO_OAUTH_CLIENT_ID	GitLab Duo (v3.8)	„GitLab Duo“ OAuth kliento ID. Užregistruokite programą adresu https://gitlab.com/-/profile/applications, nurodydami peradresavimo URI <NEXT_PUBLIC_BASE_URL>/callback ir aprėptis api, read_user, openid, profile, email. Jei nenustatyta, naudojama GITLAB_OAUTH_CLIENT_ID.
GITLAB_DUO_OAUTH_CLIENT_SECRET	GitLab Duo (v3.8)	„GitLab Duo“ OAuth kliento slaptasis raktas. Pasirinktinis — PKCE eigai slaptasis raktas nereikalingas. Jei nenustatyta, naudojama GITLAB_OAUTH_CLIENT_SECRET.
GITLAB_DUO_BASE_URL	GitLab Duo (v3.8)	Perrašomas bazinis „GitLab“ URL (savarankiškai talpinamam „GitLab“). Numatytoji reikšmė yra https://gitlab.com. Jei nenustatyta, naudojama GITLAB_BASE_URL.
GITLAB_BASE_URL	GitLab Duo (v3.8)	Ankstesnės versijos atsarginė GITLAB_DUO_BASE_URL reikšmė. Naudojama, kai _DUO_ variantas nenustatytas.
GITLAB_OAUTH_CLIENT_ID	GitLab Duo (v3.8)	Ankstesnės versijos atsarginė GITLAB_DUO_OAUTH_CLIENT_ID reikšmė, naudojama faile src/lib/oauth/constants/oauth.ts.
GITLAB_OAUTH_CLIENT_SECRET	GitLab Duo (v3.8)	Senasis atsarginis GITLAB_DUO_OAUTH_CLIENT_SECRET variantas, naudojamas faile src/lib/oauth/constants/oauth.ts.
QODER_OAUTH_CLIENT_SECRET	Qoder	—
QODER_OAUTH_AUTHORIZE_URL	Qoder	Nustatykite, kad įjungtumėte Qoder OAuth.
QODER_OAUTH_TOKEN_URL	Qoder	—
QODER_OAUTH_USERINFO_URL	Qoder	—
QODER_OAUTH_CLIENT_ID	Qoder	—
QODER_PERSONAL_ACCESS_TOKEN	Qoder	Tiesioginis atsarginis API rakto variantas (apeina OAuth).
QODER_CLI_WORKSPACE	Qoder	Qoder CLI darbo srities ID.
OMNIROUTE_QODER_WORKSPACE	Qoder	QODER_CLI_WORKSPACE alternatyvusis pavadinimas.
QODER_CLI_CONFIG_DIR	Qoder	Perrašo Qoder CLI konfigūracijos katalogą (izoliuota PAT sesija, neleidžianti perrašyti naršyklės prisijungimo).
BLACKBOX_WEB_VALIDATED_TOKEN	Blackbox Web	Sąsajos tk prieigos raktas, siunčiamas kaip validated į /api/chat. Būtinas, kai Blackbox reikalauja prieigos raktų atitikties; kitu atveju OmniRoute naudoja atsitiktinį UUID. Žr. problemą #2252.
VISION_BRIDGE_BASE_URL	Vision Bridge apsauga	Su OpenAI suderinamas bazinis URL, skirtas ne Anthropic vision-bridge iškvietoms. Pagal numatytąsias nuostatas naudojamas ankstesnis OpenAI URL aplinkos kintamasis arba api.openai.com. Nurodykite OmniRoute /v1 ciklinį iškvietimą į save arba bet kurį su OpenAI suderinamą galinį tašką (Gemini OpenAI-compat, OpenRouter). Problema #2232. Kai URL yra paties OmniRoute /v1, aprašymo antrinė užklausa siunčia x-omniroute-admission-bypass: internal ir autentifikuojama naudojant nustatytą ciklinio iškvietimo į save prisijungimo duomenį (sk_omniroute žymenį vietiniu režimu arba OMNIROUTE_API_KEY / ROUTER_API_KEY — #1350), kad veiktų diegimai su REQUIRE_API_KEY=true.
VISION_BRIDGE_API_KEY	Vision Bridge apsauga	Anksčiau nurodyto URL API raktas. Ne Anthropic vision-bridge iškvietoms perrašo kiekvienam teikėjui skirtus OpenAI / Google aplinkos kintamuosius. Anthropic modeliams ir toliau naudojamas jiems skirtas Anthropic rakto kelias. Problema #2232.

Warning

1. Eikite į Google Cloud Console → Credentials
2. Sukurkite OAuth 2.0 kliento ID (tipas: „Web application“)
3. Pridėkite savo serverio URL kaip įgaliotąjį peradresavimo URI
4. Pakeiskite prisijungimo duomenų reikšmes faile .env.

---

12. Teikėjų User-Agent perrašymai

Perrašykite kiekvienam aukštesnio lygio teikėjui siunčiamą User-Agent antraštę. Vykdytojo bazinė klasė ją dinamiškai nustato vykdymo metu:

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

Šaltinis: open-sse/executors/base.ts → buildHeaders()

Kintamasis	Numatytoji reikšmė	Kada atnaujinti
CLAUDE_USER_AGENT	claude-cli/2.1.258 (external, cli)	Kai Anthropic išleidžia naują CLI versiją
CLAUDE_DISABLE_TOOL_NAME_CLOAK	false	executors/base.ts + executors/cliproxyapi.ts	Nustatykite į 1/true, kad trečiųjų šalių vykdymo aplinkos įrankių pavadinimai būtų pažodžiui perduodami Anthropic abiem į Anthropic nukreiptais keliais (vietiniu OAuth ir CLIProxyAPI). Pagal numatytąją nuostatą vykdytojas deterministiškai suteikia alternatyvius pavadinimus ne Claude Code įrankiams (kai yra atitinkamas kanoninis Claude Code atitikmuo, naudojamas jis, kitu atveju – PascalCase) ir atsakyme juos atkuria naudodamas _toolNameMap, todėl vykdymo aplinkos su snake_case įrankiais nėra atmetamos kaip pagal skaitmeninį pėdsaką atpažinti trečiųjų šalių klientai. Skirta tik derinimui.
CODEX_USER_AGENT	codex-cli/0.142.0 (Windows 10.0.26200; x64)	Kai OpenAI atnaujina Codex CLI
CODEX_CLIENT_VERSION	0.131.0	Perrašyti Codex kliento versiją nepriklausomai nuo visos UA eilutės
CLAUDE_CODE_CLIENT_VERSION	2.1.258	Perrašyti skelbiamą Claude Code versiją nepriklausomai nuo CLAUDE_USER_AGENT. Anthropic riboja prieigą prie kai kurių modelių pagal šią reikšmę (#12417).
GITHUB_COPILOT_CLI_VERSION	1.0.81-6	Perrašyti skelbiamą Copilot CLI versiją nepriklausomai nuo GITHUB_USER_AGENT
GITHUB_USER_AGENT	GitHubCopilotChat/0.54.0	Kai atnaujinamas GitHub Copilot Chat
ANTIGRAVITY_USER_AGENT	antigravity/2.0.1 darwin/arm64	Kai atnaujinama Antigravity IDE
KIRO_USER_AGENT	AWS-SDK-JS/3.0.0 kiro-ide/1.0.0	Kai atnaujinama Kiro IDE
KIRO_OAUTH_CLIENT_ID	kiro-cli	Perrašyti Kiro socialinio įrenginio kodo clientId (viešąjį identifikatorių)
KIRO_VERIFY_FULL_CRC	false	Pasirinktinai įjungti visišką kiekvieno kadro pranešimo CRC tikrinimą Kiro įvykių sraute (sugadintiems srautams derinti)
QODER_USER_AGENT	Qoder-Cli	Kai atnaujinama Qoder CLI
CURSOR_USER_AGENT	Cursor/3.3	Kai atnaujinama Cursor

Tip

Galite pridėti User-Agent perrašymus bet kuriam teikėjui naudodami šabloną {PROVIDER_ID}_USER_AGENT. Vykdytojas dinamiškai sukonstruoja aplinkos kintamojo pavadinimą.

---

13. CLI skaitmeninio atspaudo suderinamumas

Kai ši funkcija įjungta, „OmniRoute“ pakeičia HTTP antraščių ir JSON turinio laukų tvarką, kad ji tiksliai atitiktų oficialių CLI įrankių parašą. Tai sumažina paskyros pažymėjimo riziką ir kartu išsaugo jūsų tarpinio serverio IP.

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

Pagal teikėją

Kintamasis	Aktyvinimas	Poveikis
CLI_COMPAT_CODEX	=1	Imituoja „Codex CLI“ užklausos parašą
CLI_COMPAT_CLAUDE	=1	Imituoja „Claude Code“ užklausos parašą
CLI_COMPAT_GITHUB	=1	Imituoja „GitHub Copilot“ užklausos parašą
CLI_COMPAT_ANTIGRAVITY	=1	Imituoja „Antigravity“ užklausos parašą
CLI_COMPAT_CURSOR	=1	Imituoja „Cursor“ užklausos parašą
CLI_COMPAT_KIMI_CODING	=1	Imituoja „Kimi Coding“ užklausos parašą
CLI_COMPAT_KILOCODE	=1	Imituoja „Kilo Code“ užklausos parašą
CLI_COMPAT_CLINE	=1	Imituoja „Cline“ užklausos parašą

Visuotinis nustatymas

Kintamasis	Aktyvinimas	Poveikis
CLI_COMPAT_ALL	=1	Vienu metu įjungia skaitmeninio atspaudo suderinamumą visiems teikėjams.

„Kimi Coding CLI“ tapatybės reikšmių perrašymas

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
KIMI_CLI_VERSION	1.36.0	src/lib/oauth/providers/kimi-coding.ts	Perrašo „Kimi CLI“ versiją, siunčiamą vykdant OAuth/API iškvietimus.
KIMI_CODING_DEVICE_ID	(užfiksuota numatytoji reikšmė)	src/lib/oauth/providers/kimi-coding.ts	Perrašo užfiksuotą „Kimi“ įrenginio ID, naudojamą kliento antraštėse.

Note

Ši funkcija veikia kartu su User-Agent reikšmių perrašymu (§12). Skaitmeninio atspaudo sistema tvarko antraščių ir turinio laukų tvarką, o User-Agent reikšmių perrašymas nustato konkrečią UA eilutę. Abi funkcijas galima įjungti nepriklausomai.

---

14. API raktų teikėjai

API raktai, skirti teikėjams, naudojantiems tiesioginį autentifikavimą. Rekomenduojamas nustatymo būdas: Valdymo skydas → Teikėjai → Pridėti API raktą.

Nustatymas naudojant aplinkos kintamuosius yra alternatyva „Docker“ arba be grafinės sąsajos veikiantiems diegimams.

Atpažįstamas šablonas: {PROVIDER_ID}_API_KEY

Kintamasis	Teikėjas
DEEPSEEK_API_KEY	DeepSeek
NVIDIA_API_KEY	NVIDIA NIM
JINA_AI_API_KEY	Jina AI („Foundation API“ + atsarginis „Reader“)
JINA_API_KEY	Jina AI (JINA_AI_API_KEY alternatyvus pavadinimas)
GEMINI_API_KEY	Gemini („Google AI Studio“) įterpiniai + atsarginis pokalbių režimas
GOOGLE_API_KEY	Gemini (GEMINI_API_KEY alternatyvus pavadinimas)

Note

Statiniai ${PROVIDER}_API_KEY įrašai, skirti „Groq“, „xAI“, „Mistral“, „Perplexity“, „Together AI“, „Fireworks“, „Cerebras“, „Cohere“, „Nebius“ ir „Qianfan“, buvo pašalinti v3.8.0 versijoje, nes vykdymo aplinka jų nebeskaito — šie teikėjai naudoja tik Valdymo skydą / data/provider-credentials.json / šifruotą DB. Perėjimo instrukcijas rasite šio dokumento apačioje esančiame skyriuje Auditas: pašalinti / nebenaudojami kintamieji.

Tip

Per Valdymo skydą nustatyti raktai šifruoti saugomi SQLite duomenų bazėje ir turi pirmenybę prieš aplinkos kintamuosius.

Jina: jina-ai/… įterpiniai, pakartotinis reitingavimas, klasifikavimas, segmentavimas ir jina-search nenaudoja klasterio aplinkos rakto apmokestinimui, kai egzistuoja Valdymo skydo jina-ai (arba bendrinamas jina-reader) ryšys — getProviderCredentials pirmiausia užpildo trūkstamas reikšmes. JINA_AI_API_KEY / JINA_API_KEY naudojami tik tada, kai nėra tinkamo Valdymo skydo rakto. Iškvietimų žurnaluose aplinkos kintamojo atsarginis variantas priskiriamas kaip connection_id=env:JINA_AI_API_KEY. „Reader“ kortelė (jina-reader, r.jina.ai) niekada neaptarnauja /v1/embeddings arba /v1/rerank.

Gemini: gemini/gemini-embedding-2 (alternatyvus pavadinimas google/gemini-embedding-2) pirmiausia naudoja Valdymo skydo gemini ryšį. GEMINI_API_KEY / GOOGLE_API_KEY naudojami tik tada, kai nėra tinkamo Valdymo skydo rakto. Iškvietimų žurnaluose aplinkos kintamojo atsarginis variantas priskiriamas kaip connection_id=env:GEMINI_API_KEY. Pirminis daugiarūšis srautas naudoja x-goog-api-key su :embedContent / :batchEmbedContents — N „OpenAI“ input elementų tampa N vektorių.

---

15. Skirtojo laiko nustatymai

Visos reikšmės pateiktos milisekundėmis. Centralizuotas reikšmių nustatymas atliekamas faile src/shared/utils/runtimeTimeouts.ts.

Skirtojo laiko hierarchija

REQUEST_TIMEOUT_MS (visuotinis perrašymas)
├─→ FETCH_TIMEOUT_MS (išorinių paslaugų teikėjų iškvietimai, numatytoji reikšmė: 600000)
│   ├─→ FETCH_HEADERS_TIMEOUT_MS (paveldima iš FETCH_TIMEOUT_MS)
│   ├─→ FETCH_BODY_TIMEOUT_MS (paveldima iš FETCH_TIMEOUT_MS)
│   ├─→ TLS_CLIENT_TIMEOUT_MS (paveldima iš FETCH_TIMEOUT_MS)
│   │   └── TLS_FIRST_BYTE_WATCHDOG_MS (nepriklausoma, numatytoji reikšmė: 10000)
│   ├── RESPONSES_FIRST_BYTE_TIMEOUT_MS (nepriklausoma, numatytoji reikšmė: 15000)
│   ├── FETCH_CONNECT_TIMEOUT_MS (nepriklausoma, numatytoji reikšmė: 30000)
│   └── FETCH_KEEPALIVE_TIMEOUT_MS (nepriklausoma, numatytoji reikšmė: 4000)
├─→ STREAM_IDLE_TIMEOUT_MS (paveldima iš REQUEST_TIMEOUT_MS, numatytoji reikšmė: 600000)
├─→ STREAM_ACTIVE_TIMEOUT_MS (nepriklausoma, numatytoji reikšmė: 1260000; 0 išjungia)
├─→ STREAM_READINESS_TIMEOUT_MS (paveldima iš REQUEST_TIMEOUT_MS, numatytoji reikšmė: 80000)
├─→ STREAM_READINESS_MAX_TIMEOUT_MS (apriboja adaptyvius parengties laiko pratęsimus, numatytoji reikšmė: 180000)
└─→ API_BRIDGE_PROXY_TIMEOUT_MS (paveldima iš REQUEST_TIMEOUT_MS, numatytoji reikšmė: 30000)
    ├─→ API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS (išvestinė, numatytoji reikšmė: 300000)
    ├── API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS (numatytoji reikšmė: 60000)
    ├── API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS (numatytoji reikšmė: 5000)
    └── API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS (numatytoji reikšmė: 0 = išjungta)

Kintamasis	Numatytoji reikšmė	Aprašymas
REQUEST_TIMEOUT_MS	(nenustatyta)	Visuotinis trumpinys — pakeičia numatytąsias FETCH_TIMEOUT_MS ir STREAM_IDLE_TIMEOUT_MS reikšmes.
FETCH_TIMEOUT_MS	600000	Bendras HTTP užklausos, siunčiamos išoriniam teikėjui, skirtasis laikas.
STREAM_IDLE_TIMEOUT_MS	600000	Ilgiausias tylos intervalas tarp neapdorotų išorinio teikėjo baitų, kuriam praėjus procesas nutraukiamas. Išplėstinio samprotavimo modeliai retai pristabdo ilgiau nei 90 s.
STREAM_ACTIVE_TIMEOUT_MS	1260000	Ilgiausia bendra aktyvaus SSE srauto gyvavimo trukmė; ji niekada nenustatoma iš naujo gavus išorinio teikėjo baitų ir nepriklauso nuo REQUEST_TIMEOUT_MS. Apskaičiuojama pagal didžiausią registre esančią konkrečiam modeliui skirtą timeoutMs reikšmę (1200000, Codex), pridedant 60000 atsargą, todėl modeliui, kuriam leidžiama išnaudoti visą savo laiko limitą, atsakymo generavimas niekada nenutraukiamas. Norėdami išjungti, nustatykite 0.
OMNIROUTE_SSE_COMMENTS	(išjungta)	Ar OmniRoute gali siųsti SSE : komentarų eilutes (pvz., : keepalive periodinį signalą ir x-omniroute-* metaduomenų pabaigos įrašus). Pagal numatytąją nuostatą išjungta (#10524), nes griežtai su OpenAI suderinami klientai kiekvienai SSE eilutei taiko JSON.parse ir užstringa ties : komentarais; data: periodiniams signalams tai įtakos neturi. Norėdami vėl įjungti, nustatykite on/true/1/yes. Naudojama faile open-sse/utils/sseHeartbeat.ts.
STREAM_READINESS_TIMEOUT_MS	80000	Laikas, per kurį turi būti gautas pirmasis SSE įvykis, kuris nėra ping. Jei nustatytas REQUEST_TIMEOUT_MS, paveldima jo reikšmė.
STREAM_READINESS_MAX_TIMEOUT_MS	180000	Didžiausias adaptyvus pirmojo įvykio parengties laukimo intervalas didelėms, daug įrankių naudojančioms arba intensyvaus samprotavimo srautinėms užklausoms.
OMNIROUTE_AGENT_GOAL_POLICY_ENABLED	true	/goal euristikos avarinis išjungiklis. Nustatykite false/0/off, kad aptikimas būtų visiškai išjungtas — parengties skirtasis laikas ir srauto atkūrimas niekada nebus padidinami pagal užklausos turinį ar antraštes, taip sumažinant kliento valdomo skirtojo laiko didinimo riziką.
OMNIROUTE_AGENT_GOAL_READINESS_MAX_TIMEOUT_MS	600000	Didžiausias pirmojo įvykio parengties laukimo intervalas aptiktiems /goal agento vykdymams arba užklausoms, priverstinai pažymėtoms naudojant x-omniroute-agent-goal.
OMNIROUTE_AGENT_GOAL_STREAM_RECOVERY	true	Automatiškai įjungia ankstyvą srauto atkūrimą aptiktiems /goal agento vykdymams. Nustatykite false/0/off, kad išjungtumėte konkrečiai tikslui skirtą įjungimą. Ši nuostata gali tik PRIDĖTI atkūrimą prie operatoriaus numatytosios nuostatos — ji niekada nepaiso aiškaus išjungimo per STREAM_RECOVERY_ENABLED ar DB nuostatas.
OMNIROUTE_CODEX_DROP_NONSTANDARD_EVENTS	true	Pašalina nestandartinius codex.* SSE įvykius (pvz., codex.rate_limits), dėl kurių OpenAI SDK funkcija responses.stream() grąžina 502 klaidą. Pagal numatytąją nuostatą ĮJUNGTA (#11014). Nustatykite 0/false/no/off, kad jie būtų persiunčiami.
OMNIROUTE_CODEX_APPSERVER_WS	(nenustatyta)	Pasirenkamas Codex programų serverio transportas. Vietinio codex app-server pagalbinio proceso WebSocket galinis taškas (ws:///wss://). Kai jis nustatytas kartu su prieigos raktu, Codex užklausos per JSON-RPC nukreipiamos į pagalbinį procesą, o ne į HTTP Responses API. Taip pat galima nustatyti kiekvienam ryšiui atskirai naudojant providerSpecificData.codexAppServerUrl. Naudojama faile open-sse/executors/codex/appServerConfig.ts.
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN	(nenustatyta)	Tiesiogiai nurodytas galimybių / perdavimo prieigos raktas, pateikiamas programų serveriui. Konkretaus ryšio perrašymas: providerSpecificData.codexAppServerToken.
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN_FILE	(nenustatyta)	Kelias iki failo, kuriame saugomas programų serverio galimybių prieigos raktas (iš codex app-server --ws-token-file). Naudojama, kai OMNIROUTE_CODEX_APPSERVER_WS_TOKEN nenustatytas. Konkretaus ryšio perrašymas: providerSpecificData.codexAppServerTokenFile.
OMNIROUTE_CODEX_APPSERVER_CWD	/tmp	Darbinis katalogas, kuriame vykdomas programų serverio žingsnis. Konkretaus ryšio perrašymas: providerSpecificData.codexAppServerCwd.
OMNIROUTE_CODEX_APPSERVER_APPROVAL	(nenustatyta)	Patvirtinimo politika, perduodama programų serverio žingsniui (pvz., never, on-request). Konkretaus ryšio perrašymas: providerSpecificData.codexAppServerApprovalPolicy.
OMNIROUTE_CODEX_APPSERVER_SANDBOX	(nenustatyta)	Izoliuotosios aplinkos politika, perduodama programų serverio žingsniui (pvz., read-only, workspace-write, danger-full-access). Kai nenustatyta, vykdyklė pagal numatytąją nuostatą naudoja workspace-write (sustiprinta sauga; anksčiau buvo naudojama danger-full-access). Konkretaus ryšio perrašymas: providerSpecificData.codexAppServerSandbox.
OMNIROUTE_CODEX_APPSERVER_AUTO_APPROVE	false	Automatiškai patvirtina paties programų serverio patvirtinimo užklausas (komandų / failų / leidimų vykdymą pagrindiniame kompiuteryje). Pagal numatytąją nuostatą išjungta — užklausos automatiškai atmetamos; vykdymo aplinkos įrankių iškvietimams tai įtakos neturi (jie perduodami atskiru item/tool/call kanalu). Priimamos reikšmės true/1/yes. Konkretaus ryšio perrašymas: providerSpecificData.codexAppServerAutoApprove.
FETCH_HEADERS_TIMEOUT_MS	= FETCH_TIMEOUT_MS	Laikas, per kurį turi būti gautos atsakymo antraštės.
OMNIROUTE_DIRECT_HEADERS_TIMEOUT_MS	30000 (30s)	Ilgiausias atsako pradžios laukimo laikas (ms) kiekvienam tiesioginiam bandymui be įgaliotojo serverio. Pasibaigus skirtajam laikui, vieną kartą bandoma iš naujo naudojant naują lizdą; nustatykite 0, kad išjungtumėte šį apribojimą ir išlaikytumėte ankstesnę elgseną.
FETCH_BODY_TIMEOUT_MS	= FETCH_TIMEOUT_MS	Laikas, skirtas visam atsako turiniui gauti.
FETCH_CONNECT_TIMEOUT_MS	30000	TCP ryšio užmezgimo skirtasis laikas.
FETCH_KEEPALIVE_TIMEOUT_MS	4000	Nuolatinio ryšio lizdo neveiklos skirtasis laikas.
TLS_CLIENT_TIMEOUT_MS	= FETCH_TIMEOUT_MS	TLS kontrolinio atspaudo įgaliotojo serverio (wreq-js) skirtasis laikas.
TLS_FIRST_BYTE_WATCHDOG_MS	10000	Apriboja būtent wreq-js TLS kontrolinio atspaudo perdavimo atsako turinio pirmojo baito laukimo laiką; vien TLS_CLIENT_TIMEOUT_MS negali aptikti įstrigusio atsako turinio, nes jis užbaigiamas vos gavus antraštes (#12656). Pasibaigus skirtajam laikui, wreq skaitytuvas atšaukiamas ir pereinama prie tiesioginės arba įgaliotojo serverio perdavimo priemonės; 0 išjungia stebėjimo priemonę.
RESPONSES_FIRST_BYTE_TIMEOUT_MS	15000	Tik OpenCode vykdyklei ir tik tada, kai įjungta OPENCODE_RESPONSES_STALL_ROTATION funkcijos žyma (pagal numatytuosius nustatymus išjungta): apriboja srautinio Responses atsako pirmojo turinio baito laukimo laiką po to, kai gaunamos jo antraštės (#13484). Responses srautas pradedamas įvykiu response.created, todėl tyla, trunkanti ilgiau nei šis laikotarpis, laikoma strigtimi: paskyrai pritaikomas atvėsimo laikotarpis, o užklausa vieną kartą perjungiama į kitą paskyrą; antros strigties atveju iškart grąžinama klaida. 0 išjungia apsaugą net tada, kai žyma įjungta.
API_BRIDGE_PROXY_TIMEOUT_MS	30000	Įgaliotojo serverio etapo skirtasis laikas /v1 tilto užklausoms.
FIRECRAWL_BASE_URL	https://api.firecrawl.dev	Nukreipia Firecrawl žiniatinklio išteklių gavimo vykdyklę į savarankiškai priglobtą egzempliorių (už debesijos ribų API raktas neprivalomas).
FIRECRAWL_TIMEOUT_MS	30000	Kiekvienos Firecrawl žiniatinklio išteklių gavimo vykdyklės užklausos skirtasis laikas.
API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS	300000	Bendras tilto serverio užklausos skirtasis laikas.
API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS	60000	Laikas, skirtas atsako antraštėms išsiųsti per tiltą.
API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS	5000	Tilto nuolatinio ryšio neveiklos skirtasis laikas.
API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS	0	Neapdoroto lizdo skirtasis laikas (0 = išjungta).
SHUTDOWN_TIMEOUT_MS	30000	Atidėjimo laikotarpis gavus SIGTERM/SIGINT prieš priverstinai užbaigiant procesą.
OMNIROUTE_DEFAULT_FETCH_TIMEOUT_MS	120000	Atsarginė reikšmė, kurią naudoja src/shared/utils/fetchTimeout.ts, kai FETCH_TIMEOUT_MS nenustatytas.
OMNIROUTE_PROVIDER_PROBE_TIMEOUT_MS	8000	validationRead ir modelsProbe išankstinių nuostatų skirtasis laikas (ms), naudojamas faile src/shared/network/safeOutboundFetch.ts. Padidinkite lėtoms galinėms sistemoms (Cerebras, Cloudflare AI, Groq), kad valdymo skydelyje nebūtų nuolat perjungiama tarp aktyvios ir klaidos būsenų. Jei reikšmė netinkama (<1000) arba nėra skaitinė, naudojama atsarginė 8000ms reikšmė.
OMNIROUTE_RELAY_FETCH_TIMEOUT_MS	25000	Retransliavimo kanalui būdingas išteklių gavimo skirtasis laikas faile open-sse/utils/proxyFetch.ts (#9158). Įstrigęs retransliavimo kanalas turi grąžinti klaidą prieš pasibaigiant kliento arba agento skirtajam laikui (~30s), kad kvietėjai matytų retransliavimo kanalui būdingą klaidą, o ne bendrą aukštesnio lygio serverio skirtojo laiko klaidą. Apribota iki 29000, kad ši riba visada suveiktų pirmoji.
OMNIROUTE_RETRY_BACKOFF_MS	10	Bendras pakartotinio bandymo delsos laikas tiesioginio, retransliavimo kanalo ir įgaliotojo serverio keliams, kurie vieną kartą pakartotinai bando vykdyti užklausą faile open-sse/utils/proxyFetch.ts (#9158). 0 = kartoti nedelsiant.
OMNIROUTE_CLAUDE_TLS_TIMEOUT_MS	60000	Savasis wreq-js užklausos skirtasis laikas (claudeTlsClient.ts).
OMNIROUTE_CLAUDE_TLS_GRACE_MS	10000	Absoliutus JS galutinio termino atidėjimo laikotarpis, pridedamas prie savojo skirtojo laiko.
OMNIROUTE_PPLX_TLS_TIMEOUT_MS	30000	Savasis wreq-js užklausos skirtasis laikas (perplexityTlsClient.ts).
OMNIROUTE_PPLX_TLS_GRACE_MS	10000	Absoliutus JS galutinio termino atidėjimo laikotarpis, pridedamas prie savojo skirtojo laiko.
OMNIROUTE_PPLX_SEARCH_HINT	0 (išjungta)	Prie kviečiančiosios šalies sistemos pranešimo prideda „Turite integruotą žiniatinklio paiešką. Atsakykite į klausimus tiesiogiai, naudodami paieškos rezultatus.“ (perplexity-web/protocol.ts). Pagal numatytuosius nustatymus išjungta — Perplexity vis tiek atlieka paiešką, o šis sakinys patenka į atsakymus kaip metakomentaras, skirtas programavimo klientams. Norėdami atkurti, nustatykite 1/true/yes/on.
OMNIROUTE_GROK_TLS_TIMEOUT_MS	60000	Savosios wreq-js užklausos skirtasis laikas (grokTlsClient.ts).
OMNIROUTE_GROK_TLS_GRACE_MS	10000	Absoliutaus JS galutinio termino atidėjimas, pridedamas prie savosios užklausos skirtojo laiko.
OMNIROUTE_NOTION_TLS_TIMEOUT_MS	30000	Savosios wreq-js užklausos skirtasis laikas (notionTlsClient.ts); ilgoms generavimo užduotims notion-web kiekvienai užklausai jį padidina iki 180000.
OMNIROUTE_NOTION_TLS_GRACE_MS	10000	Absoliutaus JS galutinio termino atidėjimas, pridedamas prie savosios užklausos skirtojo laiko.
OMNIROUTE_BROWSER_POOL	on	Bendrinamas Playwright naršyklių telkinys naršykle pagrįstiems žiniatinklio slapukų pokalbiams (browserPool.ts); norėdami išjungti, nustatykite off.
OBSCURA_BIN	auto-detect	Kelias į obscura dvejetainį failą, kurį naršyklių telkinys ir Cloudflare Playground vykdyklė naudoja kaip pagrindinį variklį (open-sse/services/obscura.ts); jei nenustatyta, jis automatiškai aptinkamas sistemos PATH.
OBSCURA_CDP_ENDPOINT	(nenustatyta)	Nurodo jau veikiančią Obscura (http://host:port), užuot paleidus naują; modulis nevaldo šio proceso (open-sse/services/obscura.ts).
OBSCURA_PORT	random free port	Aiškiai nurodytas prievadas paleidžiamai komandai obscura serve; jei nenustatyta, laisvas prievadas parenkamas automatiškai (open-sse/services/obscura.ts).
WEB_COOKIE_USE_BROWSER	0	Nukreipia žiniatinklio slapukų pokalbio užklausą į naršykle pagrįstą kelią (browserBackedChat.ts); norėdami įjungti, nustatykite 1.
KIMI_WEB_BASE_URL	https://www.kimi.ai	Bazinis Kimi Web (tarptautinės kimi.ai Connect-RPC) vykdyklės URL (kimi-web.ts); keiskite tik veidrodiniams / tarpinio serverio galiniams taškams.
KIMI_WEB_CHAT_URL	<KIMI_WEB_BASE_URL>/apiv2/kimi.gateway.chat.v1.ChatService/Chat	Visas Kimi Web vykdyklės pokalbio galinio taško adresas (kimi-web.ts).
OMNIROUTE_LOGIN_BROWSER_PATH	(aptinkama automatiškai)	Kelias į sistemos Chrome/Edge vykdomąjį failą, skirtą Adobe Firefly interaktyviajam prisijungimui naršyklėje (adobeFireflyBrowserLogin.ts); pakeičia konkrečiai OS taikomą automatinį aptikimą.
OMNIROUTE_STANDALONE_DIR	.build/ autonominio paketo išvestis	Kompiliavimo metu taikomas autonominio paketo išvesties katalogo, kurį naudoja po kompiliavimo atliekamas bendrojo išdėstymo veiksmas, perrašymas (scripts/build/colocate-standalone.mjs); skirta kompiliavimo įrankiams, o ne vykdymo aplinkai.

Kombinuoto tikslo bandymai paveldi nustatytą aukštesnio lygmens užklausos skirtąjį laiką (FETCH_TIMEOUT_MS arba REQUEST_TIMEOUT_MS, kai jis pateikia numatytąją gavimo reikšmę). Nustatykite targetTimeoutMs kombinacijoje, kombinacijos numatytosiose reikšmėse arba teikėjo perrašyme tik tam, kad rezervinis perjungimas būtų greitesnis; reikšmės, viršijančios dabartinį aukštesnio lygmens skirtąjį laiką, apribojamos iki šio laiko.

comboTimeoutMs yra atskiras visos kombinacijos realiojo laiko biudžetas, taikomas visiems rezervinio perjungimo tikslams. Palikite jį nenustatytą arba nustatykite 0, kad iteracijų skaičius liktų neribotas (10 minučių COMBO_LOOP_SAFETY_TIMEOUT_MS apsauga nuo pakibimo vis tiek taikoma). Teigiama reikšmė pakeičia šią kombinacijos apsaugą. Nustatykite comboTimeoutMs ilgesnį už targetTimeoutMs, kad po lėto pirmojo tikslo dar liktų laiko rezerviniam perjungimui.

Grandinės pertraukiklio slenksčiai

Teikėjo lygmens grandinės pertraukiklio derinimas. Numatytosios reikšmės atitinka nuo v3.6 naudojamas mastelio reikšmes, skirtas daugiau nei 500 ryšių.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_THRESHOLD	8	open-sse/config/constants.ts	Nuoseklių OAuth teikėjų klaidų slenkstis, kurį pasiekus suveikia grandinės pertraukiklis.
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_RESET_MS	60000	open-sse/config/constants.ts	OAuth teikėjo grandinės pertraukiklio nustatymo iš naujo laikotarpis (ms).
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_THRESHOLD	12	open-sse/config/constants.ts	Nuoseklių API rakto teikėjų klaidų slenkstis.
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_RESET_MS	30000	open-sse/config/constants.ts	API rakto teikėjo grandinės pertraukiklio nustatymo iš naujo laikotarpis (ms).
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_THRESHOLD	2	open-sse/config/constants.ts	Nuoseklių vietinių teikėjų („Ollama“, „LM Studio“, ...) klaidų slenkstis.
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_RESET_MS	15000	open-sse/config/constants.ts	Vietinio teikėjo grandinės pertraukiklio nustatymo iš naujo laikotarpis (ms).
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_THRESHOLD	10	open-sse/config/constants.ts	Teikėjo lygio grandinės pertraukiklis: klaidų skaičius per laikotarpį, kurį pasiekus visas OAuth teikėjas pereina į atvėsimo būseną.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_WINDOW_MS	900000	open-sse/config/constants.ts	Teikėjo lygio grandinės pertraukiklis: slenkantis OAuth teikėjų klaidų skaičiavimo laikotarpis (ms).
OMNIROUTE_PROVIDER_BREAKER_OAUTH_COOLDOWN_MS	300000	open-sse/config/constants.ts	Teikėjo lygio grandinės pertraukiklis: atvėsimo laikotarpis (ms), kai pasiekiamas OAuth teikėjo slenkstis.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_DEGRADATION_THRESHOLD	5	open-sse/config/constants.ts	Pasiekęs šį klaidų skaičių OAuth teikėjas pereina į DEGRADED būseną.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_MAX_BACKOFF_MULTIPLIER	8	open-sse/config/constants.ts	Didžiausias OAuth teikėjo resetTimeout didinimo daugiklis.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_BACKOFF_ESCALATION_COUNT	2	open-sse/config/constants.ts	OAuth teikėjo atidėjimas padidinamas po šio atidarymo ciklų skaičiaus.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_THRESHOLD	15	open-sse/config/constants.ts	Teikėjo lygio grandinės pertraukiklis: klaidų skaičius per laikotarpį, kurį pasiekus visas API rakto teikėjas pereina į atvėsimo būseną.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_WINDOW_MS	1800000	open-sse/config/constants.ts	Teikėjo lygio grandinės pertraukiklis: slenkantis API rakto teikėjų klaidų skaičiavimo laikotarpis (ms).
OMNIROUTE_PROVIDER_BREAKER_API_KEY_COOLDOWN_MS	600000	open-sse/config/constants.ts	Teikėjo lygio grandinės pertraukiklis: atvėsimo laikotarpis (ms), kai pasiekiamas API rakto teikėjo slenkstis.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_DEGRADATION_THRESHOLD	7	open-sse/config/constants.ts	Pasiekęs šį klaidų skaičių API rakto teikėjas pereina į DEGRADED būseną.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_MAX_BACKOFF_MULTIPLIER	4	open-sse/config/constants.ts	Didžiausias API rakto teikėjo resetTimeout didinimo daugiklis.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_BACKOFF_ESCALATION_COUNT	3	open-sse/config/constants.ts	API rakto teikėjo atidėjimas padidinamas po šio atidarymo ciklų skaičiaus.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_THRESHOLD	2	open-sse/config/constants.ts	Teikėjo lygio grandinės pertraukiklis: klaidų skaičius, kurį pasiekus visas vietinis teikėjas pereina į atvėsimo būseną.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_WINDOW_MS	300000	open-sse/config/constants.ts	Teikėjo lygio grandinės pertraukiklis: slenkantis vietinių teikėjų klaidų skaičiavimo laikotarpis (ms).
OMNIROUTE_PROVIDER_BREAKER_LOCAL_COOLDOWN_MS	60000	open-sse/config/constants.ts	Teikėjo lygio grandinės pertraukiklis: atvėsimo laikotarpis (ms), kai pasiekiamas vietinio teikėjo slenkstis.
PIN_DROP_BACKOFF_LEVEL	2	open-sse/services/combo.ts	Atidėjimo gylis, kuriam esant konteksto podėlio fiksavimo teikėjas laikomas ilgą laiką neveiksniu, o fiksavimas panaikinamas, kad būtų galima persijungti į atsarginį teikėją.
PIN_DROP_GRACE_MS	20000	open-sse/services/combo.ts	Svyravimų slopinimo laikotarpis (ms), per kurį toleruojami trumpi laikini atvėsimo laikotarpiai prieš panaikinant konteksto podėlio fiksavimą.

Scenarijai

Scenarijus	Konfigūracija
Ilgai trunkantis kodo generavimas	REQUEST_TIMEOUT_MS=900000 (15 min.)
Bendros srauto veikimo trukmės apribojimas	STREAM_ACTIVE_TIMEOUT_MS=1260000 (21 min.)
Greitas klaidos grąžinimas gamybinei API	API_BRIDGE_PROXY_TIMEOUT_MS=10000
Išplėstinio samprotavimo modeliai	STREAM_IDLE_TIMEOUT_MS=300000 (5 min. tarp fragmentų)

---

16. Žurnalų registravimas

Žurnalų registravimo sistema įrašo duomenis ir į stdout, ir į rotuojamus žurnalų failus. Visa konfigūracija nuskaitoma iš src/lib/logEnv.ts.

Kintamasis	Numatytoji reikšmė	Aprašymas
APP_LOG_LEVEL	info	Mažiausias žurnalo lygis: debug, info, warn, error.
APP_LOG_FORMAT	text	Išvesties formatas: text (skaitomas žmogui) arba json (struktūrizuotas).
APP_LOG_TO_FILE	true	Įrašyti žurnalus į failą kartu su išvestimi į stdout.
APP_LOG_FILE_PATH	logs/application/app.log	Žurnalo failo kelias (projekto šakninio katalogo arba DATA_DIR atžvilgiu).
APP_LOG_MAX_FILE_SIZE	50M	Didžiausias failo dydis prieš rotaciją. Priimama: 50M, 1G, 512K arba paprastas baitų skaičius.
APP_LOG_RETENTION_DAYS	7	Dienų skaičius, kurį saugomi rotuoti programos žurnalų failai.
APP_LOG_MAX_FILES	20	Didžiausias rotuotų žurnalų failų atsarginių kopijų skaičius.
CALL_LOG_RETENTION_DAYS	7	Dienų skaičius, kurį užklausų / iškvietimų žurnalo įrašai saugomi duomenų bazėje.
CALL_LOG_MAX_ENTRIES	10000	Didžiausias iškvietimų žurnalo įrašų skaičius atminties buferyje.
CALL_LOGS_TABLE_MAX_ROWS	100000	Didžiausias eilučių skaičius SQLite lentelėje call_logs prieš jos valymą.
ENABLE_REQUEST_LOGS	(nenustatyta)	Priverstinai įjungti arba išjungti išsamų užklausų registravimą, nepaisant valdymo skydelio nuostatos.
MAX_PENDING_REQUEST_AGE_MS	3600000 (1 valanda)	Didžiausias atsietų aktyvių užklausų žurnalo įrašų amžius prieš pašalinant juos iš atminties.
CALL_LOG_PIPELINE_CAPTURE_STREAM_CHUNKS	false	Saugoti srauto fragmentus konvejerio artefaktuose, kai call_log_pipeline_enabled=true. Pasirenkama (true) — pagal numatytąją nuostatą išjungta, kad būtų taupoma vieta diske.
CALL_LOG_PIPELINE_MAX_SIZE_KB	512	Didžiausias konvejerio iškvietimų žurnalo artefakto dydis KB, kai call_log_pipeline_enabled=true.
PROXY_LOGS_TABLE_MAX_ROWS	100000	Didžiausias eilučių skaičius SQLite lentelėje proxy_logs prieš jos valymą.
PROXY_LOG_INCLUDE_IPS	false	Įtraukti kliento / išvesties IP adresus ir paskyrų prefiksus į [ProxyEgress] konsolės žurnalus. Valdymo skydelio / duomenų bazės tarpinio serverio žurnalo įrašuose išsaugoma visa informacija.
APP_LOG_ROTATION_CHECK_INTERVAL_MS	60000 (1 min.)	Kaip dažnai src/lib/logRotation.ts pakartotinai tikrina aktyvaus žurnalo failo dydį.
CHAT_LOG_TEXT_LIMIT	65536	Didžiausias pokalbių žurnalo artefaktuose išsaugomos eilutės ilgis (numatytoji reikšmė – 64 KB).
CHAT_LOG_ARRAY_TAIL_ITEMS	128	Masyvo elementų, išsaugomų nuo pabaigos trumpinant pokalbių žurnalo duomenis, skaičius.
CHAT_LOG_MAX_DEPTH	6	Didžiausias įdėjimo gylis, kurį viršijus pokalbių žurnalo duomenys trumpinami.
CHAT_LOG_MAX_OBJECT_KEYS	80	Didžiausias objekto raktų, išsaugomų pokalbių žurnalo duomenyse, skaičius (0 = neribojama).
CHAT_LOG_MAX_BODY_KB	1024	Visos užklausos / atsako turinio dydis (KB), kurį viršijus visa kopija pakeičiama glausta santrauka. Padidinkite šią reikšmę, jei ilgų agentinių pokalbių atveju valdymo skydelyje vietoje tikrųjų pranešimų rodoma vietos rezervavimo žyma.
CHAT_DEBUG_FILE	false	Kai nustatyta true, serializeArtifactForStorage netaiko dydžiu pagrįsto trumpinimo. Skirta tik derinimui.

---

17. Atminties optimizavimas

Kintamasis	Numatytoji reikšmė	Aprašymas
OMNIROUTE_MEMORY_MB	automatinė (fizinėje sistemoje); 1024 Docker atvaizde	Rekomenduojama Docker / autonominio V8 kaupo riba (MB). Jei nenustatyta, dinamiškai apskaičiuojama (~35 % sistemos RAM, apribojant iki [512, 4096]); 512 yra tik apatinė riba, kai nepavyksta nuskaityti bendro atminties kiekio. Naudojant run-standalone.mjs (Docker CMD), aiškiai nurodyta reikšmė pridedama kaip --max-old-space-size ir turi pirmenybę prieš prieštaraujantį NODE_OPTIONS kaupo parametrą (V8 taiko paskutinį parametrą). omniroute serve vis dar teikia pirmenybę esamam NODE_OPTIONS kaupo parametrui (#5238). Nenustatykite abiejų skirtingais skaičiais — procesas žurnale pateikia įspėjimą, nurodydamas abi reikšmes ir kuri iš jų turi pirmenybę. Oficialiame Docker atvaizde visada nustatoma 1024, todėl jame kalibravimas niekada nevykdomas. Programavimo agento /v1/responses reikia 8192–12288 ir papildomos cgroup atminties — žr. Docker vadovą — vykdymo aplinkos RAM.
PROMPT_CACHE_MAX_SIZE	50	Didžiausias talpykloje laikomų sistemos užklausų įrašų skaičius.
PROMPT_CACHE_MAX_BYTES	2097152 (2 MB)	Didžiausias bendras užklausų talpyklos dydis.
PROMPT_CACHE_TTL_MS	300000 (5 min.)	Užklausų talpyklos įrašo TTL.
SEMANTIC_CACHE_MAX_SIZE	100	Didžiausias talpykloje laikomų atsakymų, kurių temperature=0, skaičius.
SEMANTIC_CACHE_MAX_BYTES	4194304 (4 MB)	Didžiausias bendras semantinės talpyklos dydis.
SEMANTIC_CACHE_TTL_MS	1800000 (30 min.)	Semantinės talpyklos įrašo TTL.
OMNIROUTE_CORPUS_CACHE_SIZE	5	Vietinio tekstyno šaknų, kurių aktyvus indeksas vienu metu laikomas atmintyje, skaičius (src/lib/localCorpus/configured.ts). LRU: pasiekus ribą, pašalinamas seniausiai naudotos šaknies indeksas, o per kitą jos užklausą jis sukuriamas iš naujo. Mažiausia reikšmė apribojama iki 1; jei reikšmė nėra skaitinė, naudojama numatytoji reikšmė.
STREAM_HISTORY_MAX	50	Didžiausias naujausių srauto įvykių skaičius prietaisų skydelio tiesioginės peržiūros buferyje.
CONTEXT_LENGTH_DEFAULT	128000	Visuotinė atsarginė didžiausia konteksto apimtis modeliams, kuriems nėra aiškiai nurodytos konfigūracijos.
USAGE_TOKEN_BUFFER	100	Papildoma atpažinimo ženklų atsarga, rezervuojama naudojimo kvotoms stebėti.

Glaudinimas

Kintamasis	Numatytoji reikšmė	Aprašymas
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS	nenustatyta	Pasitikėti projekto .rtk/filters.json be .rtk/trust.json maišos. Naudokite tik kontroliuojamoje vietinėje kūrimo aplinkoje.

Atminties variklis (21 planas)

Atminties, įgūdžių ir prieigos rakto atnaujinimo poveikis įvykių ciklui (#10349)

OmniRoute yra vienas Node procesas. Atminties išgavimas / paieška, įgūdžių įterpimas ir teikėjo prieigos rakto atnaujinimas vykdomi tame pačiame įvykių cikle kaip GET /healthz ir prietaisų skydelis. Jie nevykdomi atskiroje vykdytojo gijoje.

Darbas	Kodas	Numatytoji reikšmė	Operatoriaus valdymas
Atminties išgavimas / paieška	src/lib/memory/	Valdymo skydelio memoryEnabled (pagal numatytuosius nustatymus įjungta)	Išjunkite Nustatymai → Atmintis. Atskiro aplinkos kintamojo avarinio išjungimo jungiklio nėra — funkciją galima išjungti tik nustatymuose.
Įgūdžių įterpimas	src/lib/skills/injection.ts	Valdymo skydelio skillsEnabled (pagal numatytuosius nustatymus įjungta)	Išjunkite Nustatymai → Atmintis / įgūdžiai (skillsEnabled). Toliau nurodyti smėlio dėžės parametrai tik apriboja vykdymą, kai įterpimas jau įjungtas.
Prieigos raktų atnaujinimas	src/sse/services/tokenRefresh.ts	Įjungta prijungtiems OAuth / žiniatinklio teikėjams	Atjunkite teikėją arba leiskite prieigos raktams likti galiojantiems; šiuo metu nėra aplinkos kintamojo TOKEN_REFRESH=0.

Jei mažai apkrautoje sistemoje /healthz veikia lėtai, pirmiausia išjunkite atmintį ir įgūdžius, tada patikrinkite katalogo / glaudinimo apkrovą (#10303, #9685). Šios funkcijos atlaisvina vykdymą ties await taškais, tačiau vis tiek konkuruoja dėl vienos gijos.

Įterpinių sluoksnio, vektorių saugyklos ir pakartotinio reitingavimo parametrai, skirti nuolatinės atminties posistemei (src/lib/memory/).

Kintamasis	Numatytoji reikšmė	Aprašymas
MEMORY_EMBEDDING_CACHE_TTL_MS	300000 (5 min.)	Atmintyje laikomos įterpinių podėlio reikšmės galiojimo trukmė (pagal šaltinio / modelio / matmenų parašą).
MEMORY_EMBEDDING_CACHE_MAX	1000	Didžiausias LRU įrašų, saugomų įterpinių podėlyje, skaičius.
MEMORY_TRANSFORMERS_MODEL	Xenova/all-MiniLM-L6-v2	HF saugyklos ID pasirenkamai vietinei @huggingface/transformers MiniLM eigai (~23 MB int8, ~400 MB RAM).
MEMORY_STATIC_MODEL	minishlab/potion-base-8M	Statinio potion / Model2Vec peržvalgos lentelės įterpinių generatoriaus HF saugyklos ID. Į podėlio katalogą atsisiunčiama atidėtuoju būdu.
MEMORY_STATIC_CACHE_DIR	<DATA_DIR>/embeddings	Katalogas, naudojamas statinio potion modelio failams laikyti podėlyje. Jei nenustatyta, pagal numatytuosius nustatymus naudojamas DATA_DIR poaplankis.
HF_HUB_ENDPOINT	https://huggingface.co	Pakeičia Hugging Face Hub bazinį URL, kurį naudoja staticPotion.ts (pvz., veidrodinio serverio galinis taškas nuo interneto izoliuotoms sistemoms).
MEMORY_VEC_TOP_K	20	Numatytoji top-K reikšmė, naudojama sqlite-vec pilno perrinkimo vektorių paieškoje, esančioje src/lib/memory/vectorStore.ts.
MEMORY_RRF_K	60	Reciprocal Rank Fusion konstanta k, skirta hibridinei FTS5 ir vektorių paieškai (sqlite-vec metodas).
VECTOR_STORE_DISABLE_VEC	false	Testavimo / diagnostikos tarpinė vieta funkcijoje getVectorStore() (src/lib/memory/vectorStore.ts): kai nustatyta true, vektorių saugykla priverstinai nustatoma į null (imituojama debesijos / WASM aplinka be sqlite-vec), todėl atminties paieškai lieka FTS5 raktažodžių paieška. Gamybinėje aplinkoje nenustatykite.
NOTION_API_KEY	(nenustatyta)	Notion posistemės API raktas (naudojamas genericBackend.ts žinomos posistemės išankstinėje parinktyje).
NOTION_API_URL	https://api.notion.com/v1	Notion API bazinis URL (galima pakeisti savarankiškai talpinamoms Notion alternatyvoms).
OBSIDIAN_API_KEY	(nenustatyta)	Obsidian Vault posistemės API raktas (naudojamas genericBackend.ts žinomos posistemės išankstinėje parinktyje).
OBSIDIAN_API_URL	http://localhost:27123	Obsidian Vault API bazinis URL (galima pakeisti nuotolinei saugyklai).
MEMORY_TYPED_DECAY_ENABLED	false	Pagrindinis TV6 tipizuotos atminties nykimo jungiklis. Pasirenkama funkcija (pagal numatytuosius nustatymus išjungta) — valymas pašalina sunykusius atminties įrašus. Kai išjungta, access_count / last_accessed_at yra tik telemetrija ir niekas niekada nepašalinama.
MEMORY_TYPED_DECAY_EPISODIC_DAYS	30	TTL (dienomis), kuriam praėjus nenaudojamas episodic atminties įrašas sunyksta. Nustačius 0, episodic įrašai taip pat tampa atsparūs. Ilgalaikiai tipai (factual / procedural / semantic) visada yra atsparūs. Nykimo laikmatis pradedamas iš naujo pagal last_accessed_at.
MEMORY_TYPED_DECAY_ACCESS_IMMUNITY	3	Atminties įrašas, įterptas >= tiek kartų, tampa atsparus nykimui nepriklausomai nuo jo tipo. 0 išjungia prieigos suteikiamą atsparumą.
MEMORY_TYPED_DECAY_SWEEP_INTERVAL	0 (išjungta)	Neprivalomo periodinio nykimo valymo intervalas (sekundėmis) faile src/lib/memory/typedDecay.ts. 0 / nenustatyta = periodinis valymas nevykdomas. Reikia dvigubo pasirinktinio įjungimo: taip pat būtina nustatyti MEMORY_TYPED_DECAY_ENABLED=true.
OMNIROUTE_STRICT_SYSTEM_PROVIDERS	(nenustatyta)	Kableliais atskirti teikėjų ID (neskiriant didžiųjų ir mažųjų raidžių), priimantys system pranešimą tik ties indeksu 0 (src/lib/memory/injection.ts). Šiems teikėjams podėliui saugus atminties įterpimas masyvo viduryje nėra saugus kelių žingsnių pokalbiuose, todėl atmintis sujungiama arba pridedama pradžioje kaip pirmasis sistemos pranešimas. Pagal numatytuosius nustatymus taikoma tik xiaomi-mimo / mimo; išplėskite savarankiškai talpinamiems su OpenAI suderinamiems galiniams taškams (pvz., Qwen3.5+/3.6), kurių pokalbių šablonas reikalauja tokio paties vienintelio pirmojo sistemos pranešimo apribojimo.

Mažai RAM naudojančio Docker pavyzdys

128 skirta tik valdymo skydeliui. Programavimo agentai su tokiu atminties kiekiu ilgų /v1/responses užklausų metu susiduria su FATAL ERROR. Nenaudokite šio pavyzdžio kaip Claude / Codex / Grok tinklų sietuvo.

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. Kainodaros sinchronizavimas

Automatinis modelių kainodaros duomenų sinchronizavimas iš išorinių šaltinių.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
PRICING_SYNC_ENABLED	false	src/lib/pricingSync.ts	Pasirinktinai įjungiamas periodinis kainodaros sinchronizavimas.
PRICING_SYNC_INTERVAL	86400 (24h)	src/lib/pricingSync.ts	Sinchronizavimo intervalas sekundėmis.
PRICING_SYNC_SOURCES	litellm	src/lib/pricingSync.ts	Kableliais atskirti duomenų šaltiniai.

---

Arena ELO sinchronizavimas

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
ARENA_ELO_SYNC_ENABLED	true	src/shared/constants/featureFlagDefinitions.ts	Periodinis Arena AI lyderių lentelės ELO sinchronizavimas, konfigūruojamas valdymo skydelio funkcijų žymose arba išjungiamas nustačius false.
MODELS_CATALOG_PREFIX_MODE	dual	src/shared/constants/featureFlagDefinitions.ts, src/app/api/v1/models/catalog.ts	Modelių ID priešdėlio forma, naudojama GET /v1/models. dual kiekvienam modeliui pateikia ir trumpojo pseudonimo priešdėlį, ir kanoninį teikėjo priešdėlį (atgalinis suderinamumas — katalogas tampa maždaug dvigubai didesnis); alias pateikia po vieną ID kiekvienam modeliui; canonical pateikia tik visą teikėjo ID priešdėlį (teikėjams, kurių pseudonimas jau yra kanoninis ID, paliekamas vienas įrašas). Klientai gali pakeisti šią nuostatą kiekvienai užklausai naudodami ?prefix=alias. Žr. API_REFERENCE.
ARENA_ELO_SYNC_INTERVAL	86400 (24h)	src/lib/arenaEloSync.ts	Sinchronizavimo intervalas sekundėmis.

---

PromptQL bandomosios aplinkos teikėjas (neoficialus / eksperimentinis)

Atvirkštinės inžinerijos būdu sukurta GraphQL seanso sąsaja, skirta prompt.ql.app (src/shared/constants/providers/web-cookie.ts). Visi parametrai neprivalomi — numatytosios reikšmės nurodo viešosios bandomosios aplinkos galinius taškus; keiskite jas tik naudodami savarankiškai talpinamą arba alternatyvų PromptQL diegimą.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
PROMPTQL_GRAPHQL_ENDPOINT	https://data.prompt.ql.app/promptql/playground-v2-hge/v1/graphql	open-sse/executors/promptql.ts	GraphQL galinis taškas, naudojamas pokalbių ir seansų operacijoms.
PROMPTQL_CREDITS_ENDPOINT	https://data.pro.ql.app/v1/graphql	open-sse/executors/promptql.ts, open-sse/services/usage/promptql.ts	GraphQL galinis taškas, naudojamas kreditų likučiui ir naudojimui užklausti.
PROMPTQL_TOKEN_REFRESH_URL	https://auth.pro.ql.app/ddn/project/token	open-sse/executors/promptql.ts	Galinis taškas, naudojamas bandant atnaujinti prieigos raktą.
PROMPTQL_POLL_TIMEOUT_MS	180000	open-sse/executors/promptql.ts	Ilgiausia trukmė (ms), kurią apklausiami thread_events prieš pasibaigiant skirtajam laikui.

---

„HyperAgent“ žiniatinklio teikėjas (neoficialus / eksperimentinis)

Atvirkštinės inžinerijos būdu sukurta hyperagent.com seanso sąsaja (src/shared/constants/providers/web-cookie.ts). Neprivaloma — pagal numatytąją nuostatą naudojamas viešas atsiskaitymo / naudojimo galinis taškas; keiskite tik savarankiškai talpinamam arba alternatyviam „HyperAgent“ diegimui.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašas
HYPERAGENT_USAGE_URL	https://hyperagent.com/api/settings/billing/usage	open-sse/services/usage/hyperagent.ts	Galinis taškas, naudojamas atsiskaitymo / naudojimo kreditų blokams gauti.

---

„Kilo Code“ naudojimo kvotos

Asmeninio USD likučio ir „Kilo Pass“ naudojimo duomenų gavimas „Kilo Code“ teikėjui. Neprivaloma — pagal numatytąją nuostatą naudojama vieša „Kilo“ API; keiskite tik tarpiniam serveriui arba bandomajai imitacijai. Autentifikavimui naudojamas esamas ryšio OAuth prieigos prieigos raktas.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašas
KILO_API_URL	https://api.kilo.ai	open-sse/services/usage/kilocode.ts	Bazinis URL, naudojamas asmeniniam „Kilo Code“ likučiui ir „Kilo Pass“ naudojimo duomenims gauti.

---

„Adobe Firefly“ žiniatinklio teikėjas (neoficialus / eksperimentinis)

Naršykle valdomas „Adobe Firefly“ žiniatinklio teikėjo seanso atnaujinimas (open-sse/services/adobeFireflyBrowserLogin.ts, open-sse/services/adobeFireflySession.ts, open-sse/services/adobeFireflyClient.ts). Neprivaloma — visos numatytosios nuostatos pritaikytos įprastam darbalaukio diegimui.

Pašalinta leidime #9255. Senoji prie CDP prijungta „Chrome“ vykdymo aplinka (adobeFireflyChromeRuntime.ts) buvo pakeista „Playwright“ prisijungimo per naršyklę paslauga, o jos nustatymai nebeegzistuoja. ADOBE_FIREFLY_CHROME_ CDP_PORT / VISIBLE / HEADED / PING / FORCE_RESTART kintamieji, taip pat ADOBE_FIREFLY_LOGIN_WAIT_MS ir ADOBE_FIREFLY_FORTER_WAIT_MS, niekur kodų bazėje neskaitomi — jų nustatymas neturi jokio poveikio.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašas
ADOBE_FIREFLY_CHROME_HEADLESS	0	open-sse/services/adobeFireflyBrowserLogin.ts	Nustatykite 1, kad „Chrome“ veiktų visiškai be grafinės sąsajos (žinoma, kad generavimas neveikia; skirta tik derinimui).
ADOBE_FIREFLY_BROWSER_REFRESH	1	open-sse/services/adobeFireflySession.ts	Įjungia arba išjungia aktyvų išankstinį naršyklės paruošimą. 0 išjungia aktyvų išankstinį paruošimą (atkūrimas po 408 klaidos paketo viduryje vis tiek taikomas).
ADOBE_FIREFLY_SESSION_DISK	1	open-sse/services/adobeFireflySession.ts	Nustatykite 0, kad „Adobe Firefly“ seansas nebūtų išsaugomas diske.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS	(nenustatyta)	open-sse/services/adobeFireflySession.ts	Minimalus privalomas intervalas (ms) tarp vienas po kito atliekamų pateikimų, pakeičiantis integruotąją numatytąją reikšmę.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS	(nenustatyta)	open-sse/services/adobeFireflySession.ts	Papildomas intervalas (ms), pridedamas sėkmingai apdorojus paketą ir pakeičiantis integruotąją numatytąją reikšmę.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS	(nenustatyta)	open-sse/services/adobeFireflyClient.ts	Bazinis delsos laikas (ms) prieš pateikiant generavimo užklausą, pakeičiantis integruotąją numatytąją reikšmę.

---

19. Modelių sinchronizavimas (kūrimo aplinka)

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
MODELS_DEV_SYNC_ENABLED	(nenustatyta)	src/lib/modelsDevSync.ts	Priverstinis models.dev kainodaros sinchronizavimo perrašymas. Nenustačius paisoma Nustatymai > DI parinkties (modelsDevSyncEnabled). 0/false/off/no turi pirmenybę prieš DB ir praleidžia tiek periodinį sinchronizavimą, tiek getModelsDevPricing() SQL/JSON nuskaitymus (atkūrimui, kai valdymo skydelis užstringa toje pačioje įvykių kilpoje). 1/true/on/yes priverstinai įjungia sinchronizavimą. Išsaugant ar išvalant kainodarą vis tiek iškviečiama backupDbFile("pre-write"); šis iškvietimas nieko neatlieka, kai taikomas 60 minučių ribojimas arba DISABLE_SQLITE_AUTO_BACKUP.
MODELS_DEV_SYNC_INTERVAL	86400 (24 val.)	src/lib/modelsDevSync.ts	Kūrimo metu naudojamas modelių katalogo sinchronizavimo intervalas sekundėmis.
CONTEXT_WINDOW_RECONCILE_INTERVAL	86400 (24 val.)	src/lib/contextWindowResolver.ts	Savaime pasitaisančio konteksto lango suderintuvo (5004) intervalas (sekundėmis): kai teikėjo per /models aptikimą deklaruoti langai skiriasi nuo katalogo, jie įtvirtinami kaip auto:discovery perrašymai. Norėdami išjungti, nustatykite 0. Pakartotinai naudojami jau sinchronizuoti duomenys (nauja užklausa nevykdoma); manual perrašymai niekada neperrašomi.

---

20. Konkretiems teikėjams skirti nustatymai

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašas
OPENROUTER_CATALOG_TTL_MS	86400000 (24 val.)	src/lib/catalog/openrouterCatalog.ts	OpenRouter modelių katalogo podėlio TTL.
MODEL_CATALOG_INCLUDE_NAMES	true	src/shared/constants/featureFlagDefinitions.ts	Į /v1/models atsakymus įtraukti patogiai rodomus name laukus. Išjunkite klientams, kurie tikisi tik ID.
CATALOG_BUILD_TIMEOUT_MS	8000 (8 sek.)	src/app/api/v1/models/catalogCache.ts	Šaltojo kelio laukimo riba sujungtam GET /v1/models katalogo perkūrimui (#12627). Pasibaigus skirtajam laikui, pateikiamas paskutinis tinkamas 200 atsakymas, jei toks yra.
OMNIROUTE_SYNCED_CATALOG_STALE_AFTER_MS	2592000000 (30 dienų)	src/lib/db/models/activeSyncedCatalog.ts	Laikotarpis, po kurio sinchronizuotas ryšio modelių sąrašas nebelaikomas autoritetingu maršrutizavimui ir, kilus neapibrėžtumui, naudojamas registras (#12849). Įrašai, kuriems niekada nebuvo priskirta laiko žyma, laikomi pasenusiais.
NANOBANANA_POLL_TIMEOUT_MS	120000	open-sse/handlers/imageGeneration.ts	Ilgiausia NanoBanana vaizdų generavimo užduočių laukimo trukmė.
NANOBANANA_POLL_INTERVAL_MS	2500	open-sse/handlers/imageGeneration.ts	NanoBanana užduočių būsenos tikrinimo dažnis.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS	8000	open-sse/services/adobeFireflyUpscale.ts	Bazinis Adobe Firefly raiškos didinimo pateikimo pakartotinių bandymų eksponentinio delsos didinimo laikas.
AWS_REGION	(nenustatyta)	src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts	Regionas, naudojamas AWS Bedrock galiniams taškams (Kiro, garsui) sudaryti.
AWS_DEFAULT_REGION	(nenustatyta)	src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts	Atsarginė reikšmė, kai AWS_REGION nenustatytas.
CLOUDFLARE_ACCOUNT_ID	(nenustatyta)	open-sse/executors/cloudflare-ai.ts	Cloudflare Workers AI paskyros ID.
CLOUDFLARE_PLAYGROUND_CHROME_PATH	(nenustatyta)	open-sse/executors/cloudflare-playground.ts	Visas darbalaukio Chrome vykdomojo failo kelias, skirtas Cloudflare AI Playground vykdyklei ir naudojamas, kai naršyklės kontrolinio atspaudo patikra blokuoja su Playwright platinamą Chromium.
CLOUDFLARE_API_BASE	https://api.cloudflare.com/client/v4	src/app/api/settings/proxy/cloudflare-deploy/route.ts	Perrašomas bazinis Cloudflare REST API adresas, kurį naudoja tarpinių serverių telkinio Workers perdavimo diegimo priemonė (#4640 / 9router#1360).
NEXT_PUBLIC_CLOUDFLARE_RELAY_DEFAULT_PROJECT	omniroute-relay	src/app/(dashboard)/dashboard/settings/components/proxy/CloudflareRelayModal.tsx	Numatytasis Worker projekto pavadinimas, siūlomas tarpinių serverių telkinio „Diegti perdavimą“ modale.
NEXT_PUBLIC_CLOUDFLARE_RELAY_ENABLED	true	src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx	Nustatykite false, kad tarpinių serverių telkinio skirtuke paslėptumėte Cloudflare Workers perdavimo parinktį.
CLOUDFLARED_BIN	automatinis aptikimas	src/lib/cloudflaredTunnel.ts	Pasirinktinis kelias iki cloudflared vykdomojo failo.
CLOUDFLARED_PROTOCOL	http2	src/lib/cloudflaredTunnel.ts	Tunelio perdavimo protokolas: http2 (numatytasis), quic arba auto.
CLOUDFLARED_CONFIG	(nenustatyta)	src/lib/cloudflaredTunnel.ts	Kelias iki vietoje valdomo cloudflared config.yml (su tunnel:, credentials-file:, ingress:). Kai nustatyta, OmniRoute vykdo tunnel --config <path> run (vardinį tunelį), o ne laikinąjį spartųjį tunelį.
CLOUDFLARED_HOSTNAME	(iš konfigūracijos ingress)	src/lib/cloudflaredTunnel.ts	Vardinio tunelio viešojo pagrindinio kompiuterio vardo perrašymas (pvz., ai.example.com), pateikiamas kaip publicUrl/apiUrl. Kai nenustatyta, reikšmė nuskaitoma iš pirmojo konfigūracijos ingress pagrindinio kompiuterio vardo.
DENO_DEPLOY_API_BASE	https://api.deno.com/v2	src/app/api/settings/proxy/deno-deploy/route.ts	Perrašo „Deno Deploy“ REST API bazinį adresą, kurį naudoja tarpinių serverių telkinio perdavimo diegimo priemonė (#4643 / 9router#1437).
NEXT_PUBLIC_DENO_RELAY_DEFAULT_PROJECT	omniroute-deno-relay	src/app/(dashboard)/dashboard/settings/components/proxy/DenoRelayModal.tsx	Numatytasis „Deno Deploy“ programos pavadinimas, siūlomas tarpinių serverių telkinio „Deploy Relay“ modaliniame lange.
NEXT_PUBLIC_DENO_RELAY_ENABLED	true	src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx	Nustatykite į false, kad skirtuke „Proxy Pool“ paslėptumėte „Deno Deploy“ perdavimo parinktį.
SEARCH_CACHE_TTL_MS	300000 (5 min.)	open-sse/services/searchCache.ts	Paieškos API („Perplexity“, „Brave“ ir kt.) atsakymų podėlio TTL.
ENABLE_CC_COMPATIBLE_PROVIDER	false	src/shared/utils/featureFlags.ts	Parodo eksperimentinę su CC suderinamo teikėjo naudotojo sąsają, skirtą tik „Claude Code“ perdavimo paslaugoms.
NINEROUTER_HOST	127.0.0.1	open-sse/executors/ninerouter.ts	Perrašo pagrindinį kompiuterį, kuriame klausosi įterptasis „9router“ egzempliorius.
NINEROUTER_PORT	20130	open-sse/executors/ninerouter.ts	Perrašo prievadą, kuriame klausosi įterptasis „9router“ egzempliorius.
EMBED_WS_PROXY_HOST	127.0.0.1	src/lib/services/embedWsProxy.ts	Įterptosios paslaugos „WebSocket“ tarpinio serverio susiejimo pagrindinis kompiuteris (pagal numatymą – tik grįžtamojo ryšio sąsaja).
EMBED_WS_PROXY_PORT	20131	src/lib/services/embedWsProxy.ts	Įterptosios paslaugos „WebSocket“ tarpinio serverio prievadas.
CLIPROXYAPI_HOST	127.0.0.1	open-sse/executors/cliproxyapi.ts	„CLIProxyAPI“ tilto pagrindinis kompiuteris (senoji integracija).
CLIPROXYAPI_PORT	5544	open-sse/executors/cliproxyapi.ts	„CLIProxyAPI“ tilto prievadas.
CLIPROXYAPI_API_KEY	(tuščia)	open-sse/handlers/chatCore/cliproxyapiCredentials.ts	Atsarginis duomenų plokštumos raktas, kai nėra cliproxyapi_api_key nuostatos.
CLIPROXYAPI_MANAGEMENT_KEY	(tuščia)	src/lib/services/cliproxyAccountHealth.ts	Valdymo raktas, skirtas paskyrų būsenos duomenims skaityti iš išoriškai valdomo „CLIProxyAPI“ egzemplioriaus.
CLIPROXYAPI_CONFIG_DIR	~/.cli-proxy-api	src/lib/versionManager/processManager.ts	„CLIProxyAPI“ konfigūracijos katalogas.
CLIPROXY_BIND_HOST	127.0.0.1	docker-compose.yml	Pagrindinio kompiuterio sąsaja, kurioje „docker-compose“ publikuoja cliproxyapi pagalbinį konteinerį (#12578). Jo duomenų tome saugomi teikėjo OAuth/API prisijungimo duomenys, o fiksuotoje atvaizdo versijoje nėra aplinkos kintamaisiais grindžiamo duomenų plokštumos api-keys perrašymo (tik prijungtas config.yaml), todėl 0.0.0.0 atveria paslaugą su prisijungimo duomenimis visam LAN.
MUX_SERVICE_PORT	8322	src/lib/services/bootstrap.ts	Perrašo prievadą, kuriame klausosi įterptasis „Mux“ (coder/mux) agentų koordinavimo demonas (visada 127.0.0.1).
DARIO_HOST	127.0.0.1	open-sse/executors/dario.ts	„Dario“ įterptosios paslaugos susiejimo / prisijungimo pagrindinis kompiuteris (pagal numatymą – tik grįžtamojo ryšio sąsaja).
DARIO_PORT	3456	open-sse/executors/dario.ts	„Dario“ įterptosios paslaugos prievadas.
DARIO_HOST	127.0.0.1	open-sse/executors/dario.ts	„Dario“ įterptosios paslaugos susiejimo / prisijungimo pagrindinis kompiuteris (pagal numatymą – tik grįžtamojo ryšio sąsaja).
DARIO_PORT	3456	open-sse/executors/dario.ts	„Dario“ įterptosios paslaugos prievadas.
LOCAL_HOSTNAMES	(tuščia)	open-sse/config/providerRegistry.ts	Kableliais atskirti papildomi pagrindinių kompiuterių vardai, laikomi „vietiniais“ („Docker“ paslaugų pavadinimai ir kt.).

ENABLE_CC_COMPATIBLE_PROVIDER skirta tik trečiųjų šalių tarpinėms paslaugoms, kurios priima išskirtinai „Claude Code“ klientus. „OmniRoute“ perrašo užklausas, kad šios tarpinės paslaugos jas priimtų. Jei norite naudoti tik „Claude Code“ CLI arba nesate tikri, kas yra šios tarpinės paslaugos, palikite šią parinktį išjungtą ir vietoje jos pridėkite įprastą su „Anthropic“ suderinamą teikėją.

---

21. Tarpinių serverių būklė

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
PROXY_FAST_FAIL_TIMEOUT_MS	2000	src/lib/proxyHealth.ts	Greito nesėkmės aptikimo būklės patikros skirtasis laikas.
PROXY_LATENCY_WINDOW_HOURS	3	src/lib/db/proxies.ts	Laiko intervalas (valandomis), naudojamas kandidatinių tarpinių serverių vidutinei delsai apskaičiuoti pagal delsą optimizuotoje telkinio strategijoje.
PROXY_HEALTH_CACHE_TTL_MS	30000	src/lib/proxyHealth.ts	Būklės patikros rezultatų podėlio TTL.
PROXY_HEALTH_UNHEALTHY_CACHE_TTL_MS	2000	src/lib/proxyHealth.ts	Nepavykusių tarpinio serverio būklės patikrų podėlio TTL. Nustatykite jį trumpesnį nei PROXY_HEALTH_CACHE_TTL_MS, kad esant didelei konkurencijai trumpalaikio tarpinio serverio skirtojo laiko viršijimo atveju pakartotiniai bandymai būtų atliekami greitai, neišjungiant greito nesėkmės aptikimo iš tiesų neveikiantiems tarpiniams serveriams.
PROXY_HEALTH_ENABLED	true	src/lib/proxyHealth/scheduler.ts	Nustatykite false, kad išjungtumėte foninę tarpinių serverių būklės planavimo priemonę, kuri periodiškai tikrina užregistruotus tarpinius serverius.
PROXY_HEALTH_INTERVAL_MS	600000	src/lib/proxyHealth/scheduler.ts	Foninės būklės planavimo priemonės tikrinimo intervalas milisekundėmis (mažiausiai 60000).
PROXY_HEALTH_TEST_URL	https://httpbin.org/ip	src/lib/proxyHealth/probeTarget.ts	Pasiekiamumo patikros tikslas, kurį naudoja planuoklis ir /api/settings/proxies/auto-test galinis taškas. Nurodykite vidinį / savarankiškai priglobtą URL, kad nebūtų naudojama numatytoji viešoji reikšmė.
PROXY_HEALTH_TEST_CONCURRENCY	10	src/lib/proxyHealth/probeTarget.ts	Vienu metu vienoje partijoje pradedamų patikrų skaičius, bendras planuokliui ir /api/settings/proxies/auto-test galiniam taškui. Suapvalinama žemyn iki ne mažiau kaip 1 ir apribojama iki 50.
PROXY_HEALTH_TEST_STAGGER_MS	100	src/lib/proxyHealth/probeTarget.ts	Delsa milisekundėmis tarp dviejų patikrų išsiuntimo vienoje partijoje. Be jos visa partija išsiunčiama tuo pačiu metu, todėl bendrinamas išeinantis IP adresas gali suaktyvinti tikslinio serverio užklausų dažnio ribojimą. Nustatykite 0, kad išjungtumėte intervalus; didžiausia reikšmė – 5000.
PROXY_HEALTH_USE_PROVIDER_TARGET	true	src/lib/proxyHealth/providerProbeTarget.ts	Nustatykite „false“, kad nebūtų tikrinamas tikrasis tarpiniam serveriui priskirto teikėjo pagrindinis kompiuteris (GET /models, be API rakto) ir vietoje jo visada būtų naudojamas PROXY_HEALTH_TEST_URL.
PROXY_HEALTH_AUTO_DEACTIVATE	false	src/lib/proxyHealth/statusPolicy.ts	Kai nustatyta false (numatytoji reikšmė), automatinės pasiekiamumo patikros (planuoklis ir /api/settings/proxies/auto-test mygtukas „Testuoti visus“) veikia tik skaitymo režimu ir niekada nekeičia tarpinio serverio būsenos — aktyvią / neaktyvią būseną nustato tik operatorius, todėl nestabili patikra negali palikti priskirto tarpinio serverio nenaudojamo (#6246). Nustatykite true, kad atkurtumėte ankstesnę tikrinimo ir būsenos nustatymo veikseną.
PROXY_POOL_EGRESS_OBSERVATION	false	src/shared/utils/featureFlags.ts	Pasirenkama funkcijos žyma (žr. FEATURE_FLAGS.md; valdymo skydelio DB perrašymas turi pirmenybę). true (arba 1, yes) valdymo skydelyje po tarpinių serverių telkiniu rodo tik skaityti skirtą išeinančio srauto stebėjimo informaciją (skirtingus išeinančius IP adresus, ryšius ir didžiausią jungčių skaičių per vieną IP per pastarąsias 24 val., remiantis tarpinių serverių žurnalu). Maršrutizavimui niekada nenaudojama.
PROXY_AUTO_REMOVE	false	src/lib/proxyHealth/scheduler.ts	Nustatykite true, kad planuoklis po pasikartojančių nuoseklių nesėkmių automatiškai pašalintų tarpinius serverius.
PROXY_AUTO_REMOVE_AFTER	3	src/lib/proxyHealth/scheduler.ts	Nuoseklių nesėkmių skaičius, po kurio planuoklis automatiškai pašalina tarpinį serverį (kai PROXY_AUTO_REMOVE=true).
PROXY_AUTO_DISABLE	false	src/lib/proxyHealth/scheduler.ts	Nustatykite true, kad planuoklis po pasikartojančių nuoseklių klaidų laikinai išjungtų tarpinį serverį (būsena dead, niekada neištrinamas), užuot jį pašalinęs. Tai neardanti PROXY_AUTO_REMOVE alternatyva: tarpinis serveris nedelsiant pašalinamas iš telkinio / rotacijos parinkimo (gyvos būsenos filtras, naudojamas srities telkinio parinkimui, jį jau atmeta) ir automatiškai vėl aktyvuojamas, kai pradeda sėkmingai įveikti patikras. Naudojama ta pati PROXY_AUTO_REMOVE_AFTER slenkstinė reikšmė. Jei abiejų žymų reikšmė yra true, pirmenybė teikiama PROXY_AUTO_REMOVE.
OMNIROUTE_CONTROL_PLANE_PROXY_DIRECT_FALLBACK	false	src/shared/constants/featureFlagDefinitions.ts	Leisti OAuth ir teikėjo tikrinimo procesams apeiti priskirtą tarpinį serverį ir prisijungti tiesiogiai, kai nepavyksta išankstinės tarpinio serverio pasiekiamumo patikros. Galiojanti pirmumo tvarka: funkcijų žymų DB perrašymas > aplinkos kintamasis > numatytoji reikšmė.
RATE_LIMIT_MAX_WAIT_MS	30000 (30 sek.)	open-sse/services/rateLimitManager.ts	Ilgiausias laukimo laikas gavus 429 atsaką, prieš laikant užklausą nepavykusia.
RATE_LIMIT_EXECUTION_MAX_WAIT_MS	600000 (10 min.)	open-sse/services/rateLimitManager.ts	Ilgiausias laikas, kurį priimta užklausa gali būti vykdoma prieš pasibaigiant jos spartos ribojimo rezervacijai — jis atskirtas nuo eilės laukimo laiko limito, kad lėtas gavimo pradėjimas neinkrementiniuose šliuzuose nesukeltų skirtojo laiko pabaigos (#12027).
RATE_LIMIT_MAX_QUEUE_DEPTH	0 (išjungta)	open-sse/services/rateLimitManager.ts	Priėmimo į eilę riba: jei eilėje jau yra tiek užklausų, atmesti pateikiant 429 queue_full. 0 = neribota (numatytoji reikšmė).
RATE_LIMIT_AUTO_ENABLE	(nenustatyta)	open-sse/services/rateLimitManager.ts	Priverstinai įjungti arba išjungti automatinio spartos ribojimo apsaugą, nepaisant išsaugoto Dashboard nustatymo. Priimamos true/1/on reikšmės priverstiniam įjungimui ir false/0/off reikšmės priverstiniam išjungimui.
PROVIDER_COOLDOWN_ENABLED	(nenustatyta → išjungta)	open-sse/services/providerCooldownTracker.ts	Pasirinktinai įjungti visuotinį, kelias užklausas apimantį teikėjo / ryšio atvėsimo laikotarpio sekimą. Pagal numatytuosius nustatymus IŠJUNGTA (dubliuoja Connection Cooldown / Provider Circuit Breaker). Norėdami įjungti, naudokite true/1/on.
PROVIDER_COOLDOWN_MIN_MS	5000	open-sse/services/providerCooldownTracker.ts	Mažiausias atvėsimo laikotarpis (ms), prieš pakartotinai bandant naudoti nesėkmingą teikėją / ryšį. Jis eksponentiškai didinamas su kiekviena nuoseklia klaida. Naudojama tik tada, kai įjungta PROVIDER_COOLDOWN_ENABLED.
PROVIDER_COOLDOWN_MAX_MS	300000 (5 min.)	open-sse/services/providerCooldownTracker.ts	Maksimali laukimo laikotarpio riba (ms), po kurios nepavykęs teikėjas / ryšys vis tiek bandomas iš naujo. Naudojama tik tada, kai įjungtas PROVIDER_COOLDOWN_ENABLED.
STREAM_RECOVERY_ENABLED	(nenustatyta → išjungta)	src/lib/resilience/settings.ts (pradinė reikšmė) → open-sse/services/streamRecovery.ts (logika)	Kas tai: skaidrus nutrūkusių pirminių srautų atkūrimas (free-claude-code prievadas). Pradinis SSE langas sulaikomas iki STREAM_RECOVERY.HOLDBACK_MS (750 ms), kad iki patvirtinimo įvykęs nutrūkimas — kai klientas dar negavo nė vieno baito — būtų nepastebimai atvertas ir bandomas iš naujo. Kada įjungti: kai pirminiai srautai nepatikimi arba dažnai nutrūksta srauto pradžioje neperdavę nė vieno baito; palikite IŠJUNGTĄ, jei negalite leisti, kad kiekvieno srauto pirmojo prieigos rakto laukimo trukmė padidėtų iki 750 ms. Priimamos reikšmės true/1/on. Nustato pradinę išsaugomo atsparumo parametro reikšmę; ją nustačius, pirmenybė teikiama valdymo skydelio parametrui.
STREAM_RECOVERY_MIDSTREAM_ENABLED	(nenustatyta → išjungta)	src/lib/resilience/settings.ts (pradinė reikšmė) → open-sse/services/streamRecovery.ts (logika)	Kas tai: tęsimas srauto viduryje (4.4 etapas) — po nutrūkimo po patvirtinimo (kai baitai jau pasiekė klientą) užklausa pateikiama iš naujo, dalinį tekstą naudojant kaip išankstinį asistento užpildą, o trūkstama pabaiga sujungiama. Skirta tik su OpenAI suderinamiems paprastojo teksto srautams; niekada nesuaktyvinama, kol vyksta įrankio iškvietimas. Kada įjungti: kai ilgi generavimai nutrūksta atsakymo viduryje ir sutinkate, kad atkurta pabaiga būtų pateikta vienu pliūpsniu, o ne po vieną prieigos raktą. Nepriklauso nuo STREAM_RECOVERY_ENABLED (skiriasi rizikos profilis). Priimamos reikšmės true/1/on.
STREAM_THROUGHPUT_WATCHDOG_ENABLED	(nenustatyta → išjungta)	src/lib/resilience/settings.ts → open-sse/services/throughputWatchdog.ts	Pasirinktinai įjungiamas aktyvaus srauto naudingojo išvesties pralaidumo stebėjimo mechanizmas. Aptinka srautus, kurie ir toliau siunčia fragmentus, tačiau nepasiekia sukonfigūruoto asistento išvesties greičio; veikimo signalai, naudojimo įvykiai, tušti pokyčiai ir įrankių / samprotavimo etapai nelaikomi pažanga. Veikia atskirai nuo neveiklos ir griežto galutinio termino skirtųjų laikų.
STREAM_THROUGHPUT_WATCHDOG_WARMUP_MS	30000	src/lib/resilience/settings/normalize.ts	Atidėjimo laikotarpis prieš vertinant pralaidumą, ribojamas nuo 0 iki 600000 ms.
STREAM_THROUGHPUT_WATCHDOG_WINDOW_MS	30000	src/lib/resilience/settings/normalize.ts	Slenkantysis naudingojo išvesties langas, ribojamas nuo 1000 iki 600000 ms; prieš nutraukiant būtinas vienas visas langas.
STREAM_THROUGHPUT_WATCHDOG_MIN_BYTES_PER_SECOND	4	src/lib/resilience/settings/normalize.ts	Mažiausias UTF-8 asistento išvesties baitų greitis (konservatyvus prieigos rakto pakaitinis rodiklis), ribojamas nuo 1 iki 1000000.
STREAM_THROUGHPUT_WATCHDOG_MIN_USEFUL_BYTES	1	src/lib/resilience/settings/normalize.ts	Mažiausias išmatuojamu laikomas nenulinis naudingojo išvesties mėginys, ribojamas nuo 1 iki 1000000 baitų.
HEALTHCHECK_STAGGER_MS	3000	src/lib/tokenHealthCheck.ts	Laiko intervalas (ms) tarp teikėjų prieigos raktų būklės patikrų paleidimo metu.
HEALTHCHECK_JITTER_MIN_MS	500	src/lib/tokenHealthCheck.ts	Mažiausias atsitiktinis laiko nuokrypis (ms), pridedamas prie HEALTHCHECK_STAGGER_MS tarp teikėjų prieigos raktų būklės patikrų, kad būtų išvengta staigaus užklausų antplūdžio (problema #1220).
HEALTHCHECK_JITTER_MAX_MS	5000	src/lib/tokenHealthCheck.ts	Didžiausias atsitiktinis laiko nuokrypis (ms), pridedamas prie HEALTHCHECK_STAGGER_MS tarp teikėjų prieigos raktų būklės patikrų, kad būtų išvengta staigaus užklausų antplūdžio (problema #1220).
HEALTHCHECK_BATCH_SIZE	20	src/lib/tokenHealthCheck.ts	Lygiagrečių patikrų paketo dydis paleidimo metu atliekant prieigos raktų būklės patikrą; didesnės reikšmės leidžia lygiagrečiai tikrinti daugiau ryšių, o mažesnės sumažina momentinę apkrovą (problema #7875, #7719 regresija).
REQUEST_RETRY	2	src/sse/services/cooldownAwareRetry.ts	Automatinių pakartotinių bandymų skaičius gavus modeliui taikomą laikino apribojimo atsaką, prieš grąžinant klaidą klientui.
MAX_RETRY_INTERVAL_SEC	30	src/sse/services/cooldownAwareRetry.ts	Maksimalus delsos intervalas (sekundėmis) tarp pakartotinių bandymų dėl laikino apribojimo. Neatsižvelgiant į aukštesnio lygmens Retry-After, intervalas apribojamas šia reikšme.
HEADROOM_URL	http://localhost:8787	src/lib/headroom/detect.ts	„Headroom“ prieigos raktus taupančio tarpinio serverio URL. Valdymo skydelio gyvavimo ciklas (api/headroom/*) pagal numatytąją nuostatą vietiniame grįžtamojo ryšio sąsajos adrese paleidžia headroom-ai CLI; keiskite tik norėdami nurodyti išorinį „Docker“ pagalbinį tarpinį serverį.

Srauto atkūrimo derinimo konstantos

Atkūrimo sulaikymo elgsena derinama naudojant programiniame kode įrašytas konstantas, esančias open-sse/config/constants.ts (STREAM_RECOVERY); jos čia pateiktos informaciniais tikslais — norint jas pakeisti, reikia redaguoti kodą, o ne aplinkos kintamąjį:

• STREAM_RECOVERY.HOLDBACK_MS = 750 — kiek laiko sulaikomas pradinis SSE langas, kad ankstyvo nutrūkimo atveju būtų galima bandyti dar kartą prieš perduodant klientui bent vieną baitą.
• STREAM_RECOVERY.BUFFER_MAX_BYTES = 65536 — griežta sulaikomo lango dydžio riba; sukaupus tiek baitų, duomenys iškart perduodami (išsiunčiant buferį ir įjungiant tiesioginį perdavimą), neatsižvelgiant į laikmatį.
• STREAM_RECOVERY.EARLY_RETRY_MAX = 4 — maksimalus skaidrių pakartotinių aukštesnio lygmens srauto atidarymų skaičius, kol sulaikyti duomenys dar neperduoti.

Atskiram teikėjui taikomas slenkančio lango užklausų dažnio ribojimas (be aplinkos kintamojo): iš FCC perkeltas atsarginis atskiram teikėjui taikomas slenkančio lango užklausų dažnio ribojimo mechanizmas yra kode (open-sse/services/providerDefaultRateLimit.ts, prijungtas per open-sse/services/rateLimitManager.ts), tačiau pateikiamas su tuščiu numatytuoju susiejimu ir šiuo metu neturi operatoriui skirto aplinkos kintamojo — jis įjungiamas tik per testavimo kablį / redaguojant kodą. Jis sąmoningai neįtrauktas į aukščiau pateiktą lentelę. Atskiram (token, IP) perdavimui taikomas ribotuvas, kuris turi nuostatą, yra RELAY_IP_PER_MINUTE (§3 Tinklas ir prievadai).

---

22. Derinimas

Caution

Šie kintamieji generuoja išsamią išvestį ir gali atskleisti neskelbtinus duomenis. Niekada neįjunkite jų produkcinėje aplinkoje.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
CURSOR_DEBUG	(nenustatyta)	open-sse/executors/cursor.ts	Nustatykite 1, kad įjungtumėte išsamius Cursor vykdyklės žurnalus (dekoduotus SSE fragmentus ir kt.).
CURSOR_STREAM_DEBUG	(nenustatyta)	open-sse/executors/cursor.ts	Su ankstesnėmis versijomis suderinamas CURSOR_DEBUG pseudonimas.
CURSOR_DUMP_FILE	(nenustatyta)	open-sse/executors/cursor.ts	Pasirinktinis failo kelias, į kurį įrašomi neapdoroti dekoduoti Cursor fragmentai, kai CURSOR_DEBUG=1.
CURSOR_STREAM_TIMEOUT_MS	300000	open-sse/executors/cursor.ts	Cursor vykdyklės neaktyvaus srauto skirtasis laikas (ms).
CURSOR_KV_GRACE_MS	2000	open-sse/executors/cursor.ts	Atidėjimo intervalas (ms) po composer kv_after_text negriežto užbaigimo žymeklio, kai buferyje dar likę baitų — taip paskesniam exec_mcp įrankio iškvietimui suteikiama laiko užbaigti savo kadrą.
CURSOR_TOOL_DIRECTIVE	įjungta (!== "0")	open-sse/executors/cursor.ts	Įrankio patvirtinimo direktyva, dėl kurios composer-2.5 patikimai vykdo įrankių iškvietimus. Nustatykite 0, kad išjungtumėte.
OMNIROUTE_SYSTEM_INSTRUCTION_APPEND	(nenustatyta)	open-sse/translator/request/claude-to-openai.ts, open-sse/translator/response/openai-to-claude.ts	Operatoriaus apibrėžtas sistemos raginimo tekstas, pridedamas prie sistemos pranešimo PO vertimo (įterpimas po vertimo), pasiekiantis codex/Responses ir /v1/messages kelius. Taip pat naudojamas kaip direktyvos prefiksas, pašalinamas iš pakartotų sistemos preambulės blokų. Palikite nenustatytą, kad išjungtumėte.
CURSOR_IMAGE_FETCH_TIMEOUT_MS	15000	open-sse/utils/cursorImages.ts	Kiekvieno nuotolinės image_url vaizdinės įvesties vaizdo gavimo skirtasis laikas (ms).
CURSOR_STATE_DB_PATH	(aptinkama)	open-sse/utils/cursorVersionDetector.ts	Perrašo Cursor IDE būsenos DB paiešką, naudojamą IDE versijai aptikti.
CURSOR_AGENT_CLI_VERSION	(aptikti / fiksuoti)	open-sse/utils/cursorAgentCliVersion.ts	Agent CLI komponavimo ID (YYYY.MM.DD-<hash>), skirtas x-cursor-client-version: cli-… antraštei vykdant Agent Run.
CURSOR_AGENT_BIN	(nenustatyta)	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Kelias į Cursor Agent dvejetainį failą, naudojamą vaizdams generuoti. Jei nenustatyta, apdorojimo programa pirmiausia naudoja providerSpecificData.agentBin, tada PATH.
CURSOR_IMG_TIMEOUT_MS	210000	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Kiekvienos Cursor Agent vaizdo užduoties faktinio vykdymo skirtasis laikas (ms).
CURSOR_IMG_MAX_CONCURRENT	2	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Bendros licencijos vietos lygiagretumo ribotuvas Cursor vaizdo užduotims.
CURSOR_IMG_MODEL	užklausa / auto	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Perrašo Cursor CLI --model reikšmę vaizdo užduotims.
UC_IMAGE_POLL_INTERVAL_MS	2000	open-sse/handlers/imageGeneration/providers/ucImage.ts	UC (uncensored.com) vaizdų generavimo rezultatų tikrinimo intervalas (ms).
UC_IMAGE_POLL_TIMEOUT_MS	60000	open-sse/handlers/imageGeneration/providers/ucImage.ts	UC vaizdų generavimo rezultatų tikrinimo faktinio vykdymo skirtasis laikas (ms).
UC_VIDEO_POLL_INTERVAL_MS	3000	open-sse/handlers/videoGeneration/providers/ucVideo.ts	UC (uncensored.com) vaizdo įrašų generavimo rezultatų tikrinimo intervalas (ms).
UC_VIDEO_POLL_TIMEOUT_MS	300000	open-sse/handlers/videoGeneration/providers/ucVideo.ts	UC vaizdo įrašų generavimo rezultatų tikrinimo faktinio vykdymo skirtasis laikas (ms).
CURSOR_DATA_DIR	(aptinkama)	open-sse/utils/cursorAgentCliVersion.ts	Perrašo Cursor Agent CLI duomenų katalogą (…/versions/<id>); tai tas pats kintamasis, kurį naudoja oficialus agentas.
CURSOR_TOKEN	(nenustatyta)	scripts/ad-hoc/cursor-tap.cjs	Tiesioginis Cursor prieigos raktas, naudojamas kūrėjų įrankiuose.
OMNIROUTE_LOG_REQUEST_SHAPE	išjungta (įjungiama naudojant "1")	src/app/api/v1/chat/completions/route.ts	Žurnale registruoja didelių pokalbių naudingųjų apkrovų turinio tipo ir ilgio žymeklius, kai nustatyta "1". Pagal numatytąją nuostatą išjungta, kad žurnale būtų mažiau triukšmo.
DEBUG_RESPONSES_SSE_TO_JSON	(nenustatyta)	open-sse/handlers/responseTranslator.ts	Nustatykite true, kad žurnale būtų registruojama Responses API SSE→JSON vertimo informacija.
DEBUG_CLAUDE_NONSTREAM	(nenustatyta)	open-sse/handlers/responseTranslator.ts	Nustatykite true, kad Claude atsakymo vertimo kelyje būtų pateikiami tušti textContent fragmentai (tik derinimui).
NEXT_PUBLIC_OMNIROUTE_E2E_MODE	(nenustatyta)	E2E testavimo aplinka	Nustatykite true, kad įjungtumėte E2E testavimo režimą (sušvelnintas autentifikavimas, testavimo kabliai).

---

23. GitHub integracija

Leiskite naudotojams pranešti apie problemas tiesiogiai iš valdymo skydelio.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
GITHUB_ISSUES_REPO	(nenustatyta)	src/app/api/v1/issues/report/route.ts	Saugykla owner/repo formatu.
GITHUB_ISSUES_TOKEN	(nenustatyta)	src/app/api/v1/issues/report/route.ts	GitHub asmeninės prieigos prieigos raktas su issues:write teisių sritimi.
GITHUB_TOKEN	(nenustatyta)	problemų rūšiavimo / debesijos agento pagalbinės priemonės	Bendrasis GitHub prieigos raktas, naudojamas kaip atsarginis GITHUB_ISSUES_TOKEN variantas ir debesijos agento pagalbinėse priemonėse, esančiose src/lib/cloudAgent/*.

---

Diegimo scenarijai

Dėl perdavimo serverio SRE gairių (ts/bifrost/auto veikimo, 9router ir CLIProxyAPI išdėstymo bei didelio pralaidumo atsarginės strategijos) žr. Perdavimo serverio strategiją.

Minimalus vietinis kūrimas

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

„Docker“ produkcinė aplinka

JWT_SECRET=<sugeneruota>
API_KEY_SECRET=<sugeneruota>
INITIAL_PASSWORD=<sugeneruota>
STORAGE_ENCRYPTION_KEY=<sugeneruota>
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

Izoliuota nuo tinklo / 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 su atvirkštiniu tarpiniu serveriu („nginx“ + „Cloudflare“)

JWT_SECRET=<sugeneruota>
API_KEY_SECRET=<sugeneruota>
STORAGE_ENCRYPTION_KEY=<sugeneruota>
PORT=20128
AUTH_COOKIE_SECURE=true
REQUIRE_API_KEY=true
NEXT_PUBLIC_BASE_URL=https://omniroute.example.com
BASE_URL=http://127.0.0.1:20128
CORS_ORIGIN=https://omniroute.example.com
ENABLE_TLS_FINGERPRINT=true
CLI_COMPAT_ALL=1

---

24. Skills smėlio dėžė (v3.8.0+)

Apribojimai ir saugos nustatymai, taikomi, kai Skills sistema (src/lib/skills/) vykdo naudotojų apibrėžtas automatizacijas smėlio dėžės aplinkoje.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
SKILLS_SANDBOX_TIMEOUT_MS	10000 (10 s)	src/lib/skills/builtins.ts	Kiekvieno vykdymo smėlio dėžėje faktinio laiko limitas. Griežtoji riba; ilgiau vykdomas procesas nutraukiamas.
SKILLS_EXECUTION_TIMEOUT_MS	(naudojama SKILLS_SANDBOX_TIMEOUT_MS reikšmė)	src/lib/skills/	Aukšto lygio Skills operacijų koordinavimo laiko limitas. Nustatykite didesnę reikšmę nei SKILLS_SANDBOX_TIMEOUT_MS, kad būtų leidžiamos kelių žingsnių darbo sekos.
SKILLS_MAX_FILE_BYTES	1048576 (1 MB)	src/lib/skills/builtins.ts	Didžiausias baitų skaičius, kurį Skills operacija gali nuskaityti iš vieno smėlio dėžėje esančio failo.
SKILLS_MAX_HTTP_RESPONSE_BYTES	256000 (250 KB)	src/lib/skills/builtins.ts	Didžiausias baitų skaičius, paimamas iš vieno HTTP atsako vykdant Skills operaciją.
SKILLS_MAX_SANDBOX_OUTPUT_CHARS	100000	src/lib/skills/builtins.ts	Griežtoji iš smėlio dėžės iškvietimo grąžinamų stdout/stderr simbolių skaičiaus riba.
SKILLS_SANDBOX_NETWORK_ENABLED	false	src/lib/skills/builtins.ts	Nustatykite 1/true, kad smėlio dėžėje būtų leidžiama prieiga prie išorinio tinklo. Saugumo sumetimais numatytoji būsena yra izoliuota.
SKILLS_ALLOWED_SANDBOX_IMAGES	(tuščia)	src/lib/skills/builtins.ts	Kableliais atskirtas konteinerių atvaizdų, leidžiamų vykdyti smėlio dėžėje, sąrašas. Tuščia reikšmė reiškia, kad leidžiama tik integruotoji numatytoji reikšmė.
SKILLS_SANDBOX_DOCKER_IMAGE	(integruotoji numatytoji reikšmė)	src/lib/skills/	Konteinerio atvaizdas, naudojamas paleidžiant Docker pagrindu veikiančią smėlio dėžę. Pakeiskite, kad prisegtumėte pasirinktinį sustiprinto saugumo bazinį atvaizdą.
SKILLS_SANDBOX_RUNTIME	auto	src/lib/skills/sandbox.ts, src/lib/skills/containerProvider.ts	Konteinerių vykdymo aplinka, skirta Skills smėlio dėžei: auto | docker | apple | wsl | orbstack | podman. auto pasirenka geriausią įdiegtą vykdymo aplinką pagal pagrindinio kompiuterio OS (Apple Container/OrbStack sistemoje macOS, WSL Container sistemoje Windows, Podman sistemoje Linux), o jei tokios nėra, naudoja Docker.

Caution

Įjungus SKILLS_SANDBOX_NETWORK_ENABLED=true, savavališkam Skills kodui atveriamas išeinančiojo ryšio kelias. Bendruose diegimuose naudokite kartu su OUTBOUND_SSRF_GUARD_ENABLED=true ir griežta CORS_ORIGIN / tarpinio serverio politika.

---

25. Teikėjų kvotos, tuneliai, atsarginės kopijos ir kita vykdymo aplinka

Teikėjų kvotų galiniai taškai, tinklo tuneliai („Tailscale“, „Ngrok“, MITM derinimo tarpinis serveris), „1Proxy“ išeinančio srauto telkinys, duomenų bazės atsarginės kopijos ir nedideli atskirų funkcijų perrašymai, kuriuos naudoja vykdytojo sluoksnis arba scenarijai.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
REDIS_URL	redis://localhost:6379	src/shared/utils/rateLimiter.ts	„Redis“ prisijungimo eilutė, skirta užklausų dažnio ribotuvo posistemei.
ALIBABA_CODING_PLAN_HOST	(gamybinis pagrindinis kompiuteris)	open-sse/services/bailianQuotaFetcher.ts	Perrašo pagrindinį kompiuterį, naudojamą „Alibaba Bailian“ programavimo plano kvotoms gauti.
ALIBABA_CODING_PLAN_QUOTA_URL	išvedamas iš pagrindinio kompiuterio	open-sse/services/bailianQuotaFetcher.ts	Viso „Alibaba Bailian“ kvotos URL perrašymas.
QWEN_CLOUD_COOKIE	(nenustatyta)	open-sse/services/qwenTokenPlanQuotaFetcher.ts	Konsolės seanso slapukas, skirtas „Qwen Cloud“ / „Model Studio“ asmeninio žetonų plano kvotų šliuzui (išvadų API raktas negali jo nuskaityti). Nukopijuokite visą Cookie užklausos antraštę — joje yra login_qwencloud_ticket — iš bet kurio api.json iškvietimo į cs-data.qwencloud.com, esančio home.qwencloud.com › Billing › Subscription (F12 › Network). Tai neskelbtina ir susieta su seansu; verčiau naudokite kiekvienam ryšiui skirtą prietaisų skydelio lauką qwenCloudCookie.
QWEN_CLOUD_SEC_TOKEN	(nenustatyta)	open-sse/services/qwenTokenPlanQuotaFetcher.ts	Rankinis sec_token perrašymas, skirtas žetonų plano konsolės šliuzui. Neskelbtina; kai nenustatyta, gaviklis nustato jo reikšmę iš prietaisų skydelio HTML, naudodamas slapuką.
QWEN_TOKEN_PLAN_HOST	https://cs-data.qwencloud.com	open-sse/services/qwenTokenPlanQuotaFetcher.ts	Asmeninio žetonų plano kvotų gaviklio šliuzo pagrindinio kompiuterio perrašymas (pvz., bailian-singapore-cs.alibabacloud.com, skirtas „Model Studio“ konsolei).
QWEN_TOKEN_PLAN_DASHBOARD_URL	https://home.qwencloud.com/	open-sse/services/qwenTokenPlanQuotaFetcher.ts	Prietaisų skydelio URL, naudojamas sec_token nustatyti iš prisijungusio naudotojo HTML.
ALIBABA_FREE_TIER_VISION_FE_PATH	/costing-balance/free-quota-image-video	open-sse/services/alibabaFreeTierQuotaFetcher.ts	Konsolės sąsajos kelio perrašymas, skirtas „Alibaba Model Studio“ nemokamo lygio vaizdų ir medijos kvotai gauti.
ALIBABA_FREE_TIER_MULTIMODAL_FE_PATH	/costing-balance/free-quota-multimodal	open-sse/services/alibabaFreeTierQuotaFetcher.ts	Konsolės išorinės sąsajos kelio perrašymas, skirtas „Alibaba Model Studio“ nemokamo lygio daugiarūšio modelio kvotai gauti.
ALIBABA_FREE_TIER_AUDIO_FE_PATH	/costing-balance/free-quota-audio	open-sse/services/alibabaFreeTierQuotaFetcher.ts	Konsolės išorinės sąsajos kelio perrašymas, skirtas „Alibaba Model Studio“ nemokamo lygio garso kvotai gauti.
ALIBABA_FREE_TIER_ALLOWLIST_PATH	(nenustatyta)	open-sse/services/alibabaFreeTierAllowlist.ts	Pasirinktinis kelias į vietinį JSON failą, perrašantį integruotą „Alibaba“ nemokamo lygio tekstinių modelių leidžiamųjų sąrašą. Jei jis nepasiekiamas, naudojamas $DATA_DIR/alibaba-free-tier-allowlist.json, o tada config/alibaba-free-tier-allowlist.json.
CONTEXT_RESERVE_TOKENS	1024	open-sse/services/contextManager.ts	Užbaigimo išvesčiai rezervuojami prieigos raktai, naudojami apskaičiuojant užklausos biudžetus.
CONTEXT_KEEP_LATEST_IMAGES	2	open-sse/services/contextManager.ts	Kiek naujausių įterptųjų vaizdų išsaugoti šalinant senesnius, kad būtų tilpstama į konteksto langą (#8560).
MODEL_ALIAS_COMPAT_ENABLED	įjungta	open-sse/services/model.ts	Įjungia arba išjungia senesnių klientų naudojamą ankstesnį modelių alternatyviųjų pavadinimų suderinamumo sluoksnį.
OMNIROUTE_EMERGENCY_FALLBACK	įjungta	open-sse/services/emergencyFallback.ts	Nustatykite false (arba 0), kad išjungtumėte avarinį atsarginį mechanizmą, kuris, išnaudojus biudžetą, nukreipia nepavykusias užklausas į nemokamą nvidia/openai/gpt-oss-120b modelį. Taikoma tokia pirmenybės tvarka: funkcijų žymų DB perrašymas > aplinkos kintamasis > numatytoji reikšmė; jei tai nepasiekiama, paslauga naudoja neapdorotą aplinkos kintamojo reikšmę.
COMMAND_CODE_CALLBACK_PORT	(nenustatyta)	src/app/api/providers/command-code/auth/shared.ts	Vietinis prievadas, naudojamas „OAuth“ tipo atgaliniams iškvietimams iš „Command Code“ CLI pagalbinės priemonės.
COMMAND_CODE_VERSION	0.33.2	open-sse/executors/commandCode.ts	Reikšmė, siunčiama „Command Code“ išorinei paslaugai kaip x-command-code-version antraštė. Pakeiskite ją, kad atnaujintumėte CLI versiją.
COMMANDCODE_API_URL	https://api.commandcode.ai	open-sse/services/usage/command-code.ts	Bazinis „Command Code“ naudojimo ir kvotų išorinės paslaugos URL, kurį naudoja išmaniojo telefono kvotų gavimo modulio telemetrija. Pakeiskite, jei naudojate savarankiškai priglobtą arba alternatyvią „Command Code“ API.
MITM_LOCAL_PORT	443	src/mitm/server.cjs	Vietinis prievadas, prie kurio susiejamas MITM derinimo tarpinis serveris.
MITM_DISABLE_TLS_VERIFY	0	src/mitm/server.cjs	Nustatykite 1, kad išjungtumėte išsiunčiamojo TLS ryšio tikrinimą (tik kūrimo aplinkoje).
MITM_IDLE_TIMEOUT_MS	60000	src/mitm/socketTimeouts.ts, src/mitm/server.cjs	Tarpinio serverio jungčių neaktyvaus lizdo skirtasis laikas (ms); ilgiau neaktyvūs lizdai uždaromi, kad neliktų neuždarytų pusiau atvirų tunelių.
MITM_VERBOSE	1	src/mitm/server.cjs, src/mitm/_internal/bypass.cjs	Maršruto parinkimo sprendimų žurnalo išsamumas: 0 nutildo žurnalą, o didesnės reikšmės registruoja daugiau apėjimo ir maršruto parinkimo sprendimų.
MITM_ROOT_CA_ENABLED	false	src/mitm/manager.ts	Nustatykite true, kad pasirinktumėte šakninės CA ir kiekvienam pagrindiniam kompiuteriui skirto galutinio sertifikato modelį (#6684). Naujuose diegimuose jis įjungiamas automatiškai; diegimuose su jau esančiu patikimu senuoju galutiniu sertifikatu išlaikomas senasis fiksuoto SAN sertifikatas, nebent aiškiai pasirenkamas naujasis modelis.
MITM_CERT_MODE	legacy	src/mitm/manager.ts, src/mitm/server.cjs	MITM tvarkytuvės NUSTATOMA reikšmė paleidžiamam tarpinio serverio procesui (root-ca | legacy) — atspindi sertifikatų migravimo sprendimą; neskirta nustatyti rankiniu būdu.
OMNIROUTE_NO_SUDO	0	src/mitm/systemCommands.ts	Nustatykite 1 (teisingą reikšmę), kad iš MITM sertifikatų patikimumo komandų būtų pašalintas pradinis sudo — diegimams be root teisių arba su naudotojų vardų erdvėmis, kai operatorius CA pažymi patikima rankiniu būdu (pvz., naudodamas Node papildomų CA sertifikatų mechanizmą).
SKIP_ANTIGRAVITY_DNS	(nenustatyta)	src/mitm/dns/provision.ts	Nustatykite true, kad būtų visiškai praleistas /etc/hosts DNS įrašų parengimas Antigravity tarpinio serverio pagrindinių kompiuterių vardams — konteineriams, kuriuose negalima naudoti sudo ar root teisių.
OMNIROUTE_SKIP_DNS_WRITE	(nenustatyta)	src/mitm/dns/dnsConfig.ts	Nustatykite 1, kad pridedant ar šalinant DNS įrašus būtų praleistas rašymas į pagrindinių kompiuterių failą — izoliuotoms arba tik skaitomoms testavimo aplinkoms.
OMNIROUTE_SKIP_SYSTEM_TRUST	0	src/mitm/cert/install.ts, src/mitm/tproxy/caTrust.ts	Tik testams / CI skirtas saugiklis: nustatykite 1, kad sertifikato patikimumo diegimas ir šalinimas neatliktų jokių veiksmų ir testų rinkinys niekada nekeistų OS patikimumo saugyklos. Automatiškai nustatoma testų sąrankos ir CI darbo eigų.
CHANGELOG_BASE_REF	(automatiškai)	scripts/check/check-changelog-integrity.mjs	Aiški bazinė nuoroda, skirta apsaugai nuo CHANGELOG turinio praradimo (pagal numatytuosius nustatymus CI aplinkoje naudojama PR bazinė šaka, kitu atveju – aukščiausia release/v*).
FREE_PROXY_AUTO_SYNC_ENABLED	false	src/lib/freeProxyProviders/scheduler.ts	Nustatykite true, kad įjungtumėte foninį nemokamų tarpinių serverių telkinio automatinio sinchronizavimo planuoklį. Funkcija pasirenkama ir pagal numatytuosius nustatymus yra išjungta.
FREE_PROXY_AUTO_SYNC_INTERVAL_MS	1800000	src/lib/freeProxyProviders/scheduler.ts	Automatinio sinchronizavimo intervalas milisekundėmis (numatytoji reikšmė – 30 min.).
FREE_PROXY_1PROXY_ENABLED	true	src/lib/freeProxyProviders/oneproxy.ts	Įjunkite nemokamų tarpinių serverių šaltinį 1proxy. Nustatykite false, kad jį išjungtumėte.
FREE_PROXY_1PROXY_API_URL	(žr. oneproxy.ts)	src/lib/freeProxyProviders/oneproxy.ts	1proxy API URL perrašymas.
FREE_PROXY_1PROXY_MAX	500	src/lib/freeProxyProviders/oneproxy.ts	Didžiausias iš 1proxy per vieną sinchronizavimą gaunamų tarpinių serverių skaičius.
FREE_PROXY_1PROXY_MIN_QUALITY	50	src/lib/freeProxyProviders/oneproxy.ts	Mažiausia kokybės įverčio riba importuojant iš 1proxy.
FREE_PROXY_PROXIFLY_ENABLED	true	src/lib/freeProxyProviders/proxifly.ts	Įjunkite nemokamų tarpinių serverių šaltinį Proxifly. Nustatykite false, kad jį išjungtumėte.
FREE_PROXY_PROXIFLY_QUANTITY	100	src/lib/freeProxyProviders/proxifly.ts	Per vieną Proxifly sinchronizavimą gaunamų tarpinių serverių skaičius.
FREE_PROXY_PROXIFLY_ANONYMITY	elite	src/lib/freeProxyProviders/proxifly.ts	Proxifly anonimiškumo lygio filtras (elite, anonymous, transparent).
FREE_PROXY_IPLOCATE_ENABLED	false	src/lib/freeProxyProviders/iplocate.ts	Įjungti nemokamų IPLocate tarpinių serverių šaltinį. Įjungiamas tik pasirinktinai.
FREE_PROXY_IPLOCATE_BASE_URL	https://raw.githubusercontent.com/iplocate/free-proxy-list/main/protocols	src/lib/freeProxyProviders/iplocate.ts	IPLocate tarpinių serverių sąrašo bazinio URL perrašymas.
FREE_PROXY_WEBSHARE_ENABLED	true	src/lib/freeProxyProviders/webshare.ts	Įjungti Webshare tarpinių serverių telkinio šaltinį. Norėdami išjungti, nustatykite false; taip pat būtina nustatyti FREE_PROXY_WEBSHARE_API_KEY.
FREE_PROXY_WEBSHARE_API_KEY	(nėra)	src/lib/freeProxyProviders/webshare.ts	Webshare paskyros API prieigos raktas (Authorization: Token <key>). Privalomas — be jo teikėjas lieka išjungtas.
FREE_PROXY_WEBSHARE_API_URL	https://proxy.webshare.io/api/v2/proxy/list/	src/lib/freeProxyProviders/webshare.ts	Webshare tarpinių serverių sąrašo API URL perrašymas.
FREE_PROXY_WEBSHARE_MAX	500	src/lib/freeProxyProviders/webshare.ts	Didžiausias per vieną Webshare sinchronizavimą importuojamų tarpinių serverių skaičius.
NEXT_PUBLIC_VERCEL_RELAY_ENABLED	true	src/app/(dashboard)/…/ProxyPoolTab.tsx	Rodyti arba slėpti mygtuką „Diegti Vercel Relay“ kortelėje „Tarpinių serverių telkinys“.
VERCEL_API_BASE	https://api.vercel.com	src/app/api/settings/proxy/vercel-deploy/route.ts	Vercel API bazinio URL perrašymas (testavimui).
NEXT_PUBLIC_VERCEL_RELAY_DEFAULT_PROJECT	omniroute-relay	src/app/(dashboard)/…/VercelRelayModal.tsx	Numatytasis projekto pavadinimas, iš anksto įrašytas Vercel Relay diegimo modaliniame lange.
TAILSCALE_BIN	(automatinis aptikimas)	src/lib/tailscaleTunnel.ts	Tikslus kelias iki tailscale vykdomojo failo.
TAILSCALED_BIN	(aptinkama automatiškai)	src/lib/tailscaleTunnel.ts	Aiškiai nurodytas kelias į tailscaled tarnybos dvejetainį failą.
TAILSCALE_AUTHKEY	(nenustatyta)	src/lib/tailscaleTunnel.ts	Iš anksto bendrinamas Tailscale autentifikavimo raktas, skirtas neinteraktyviai / be grafinės sąsajos vykdomai komandai tailscale up (perduodamas per --auth-key=). Jei nenustatyta, prisijungimui naudojamas interaktyvus autentifikavimo URL naršyklėje.
NGROK_AUTHTOKEN	(nenustatyta)	src/lib/ngrokTunnel.ts	Autentifikuoja išeinančius ngrok tunelius.
DB_BACKUP_MAX_FILES	20	src/lib/db/backup.ts	Didžiausias SQLite atsarginių kopijų failų, išsaugomų valant rankiniu būdu arba pagal tvarkaraštį sukurtas atsargines kopijas, skaičius. Perkėlimo momentinės kopijos adresuojamos pagal turinį ir pakartotinai naudojamos esant identiškai DB būsenai; jos nėra šalinamos lygiagretaus perkėlimo laikotarpiu. Pakeičia reikšmę, išsaugotą skiltyje „Nustatymai → Duomenų bazės atsarginių kopijų saugojimas“.
DB_BACKUP_RETENTION_DAYS	0	src/lib/db/backup.ts	Didžiausias amžius dienomis, taikomas valant rankiniu būdu arba pagal tvarkaraštį sukurtas atsargines kopijas. 0 išjungia šalinimą pagal amžių. Perkėlimo momentinės kopijos nėra šalinamos lygiagretaus perkėlimo laikotarpiu. Pakeičia reikšmę, išsaugotą skiltyje „Nustatymai → Duomenų bazės atsarginių kopijų saugojimas“.
OMNIROUTE_BACKUP_SCHEDULE_JOB_INTERVAL_MS	30000	src/lib/jobs/backupScheduleJob.ts	Serverio užduoties, vykdančios backup-schedule.json, ciklo intervalas (ms). Jis turi būti gerokai trumpesnis už 1 minutės cron detalumą; mažesnėms nei 5000 arba nenuskaitomoms reikšmėms naudojama numatytoji reikšmė 30000.
CONTAINER_HOST	docker	scripts/check-permissions.sh	Konteinerių vykdymo aplinkos nuoroda, naudojama paleidimo taško leidimų patikrai. Bet kuriai Podman topologijai nustatykite podman. Kadangi konteineris negali nustatyti, ar variklis yra vietinis, ar pasiekiamas per Podman Machine, įspėjimas išlieka neutralus topologijos atžvilgiu ir nukreipia į contrib/podman/README.md.
QUOTA_STORE_DRIVER	sqlite	src/lib/quota/storeFactory.ts	Kvotos dalies naudojimo saugyklos posistemė: sqlite (numatytoji) arba redis.
QUOTA_STORE_REDIS_URL	(nenustatyta)	src/lib/quota/storeFactory.ts	Redis ryšio eilutė, naudojama, kai QUOTA_STORE_DRIVER=redis (pvz., redis://localhost:6379).
QUOTA_SATURATION_THRESHOLD	0.5	src/lib/quota/enforce.ts	Telkinio prisotinimo santykis (0..1); jį pasiekus arba viršijus telkinys pereina į griežtąjį režimą (skolintis neleidžiama).
QUOTA_SOFT_DEPRIORITIZE_FACTOR	0.7	open-sse/services/combo.ts	Įverčio daugiklis (0..1), taikomas paskirties taškui, kai švelnioji kvotos politika sumažina jo prioritetą.
STATUS_SOFT_DEPRIORITIZE_FACTOR	0.5	open-sse/services/combo/autoStrategy.ts	Įverčio daugiklis (0..1), taikomas išteklius išnaudojusiam teikėjui (credits_exhausted/rate_limited) automatinio derinio įverčio skaičiavimo metu, kai išankstinės kvotos ribojimas yra IŠJUNGTAS (#4540).
QUOTA_CONSUMPTION_RETENTION_DAYS	14	src/lib/db/quotaConsumption.ts	quota_consumption segmentų saugojimo laikotarpis (dienomis) prieš šiukšlių surinkimą (gcQuotaConsumption).
QUOTA_PREFLIGHT_CUTOFF_ENABLED	false	src/lib/resilience/settings.ts	Pasirenkama funkcija (pagal numatytuosius nustatymus IŠJUNGTA): įjungia automatinio maršruto parinkimo griežtąjį kvotos ribojimą, kuris prieš įverčio skaičiavimą pašalina mažą kvotą turinčius kandidatus.
OMNIROUTE_AUTO_FREE_FALLBACK_TO_FULL_POOL	false	open-sse/services/autoCombo/virtualFactory.ts	Pasirenkama funkcija (pagal numatytuosius nustatymus IŠJUNGTA): kai auto/<category>:<tier> filtras neranda prijungtų kandidatų, atkuriamas ankstesnis veikimas, kai vietoje tuščio telkinio grąžinimo naudojamas visas (nefiltruotas) telkinys. Kai ši funkcija IŠJUNGTA, :free reiškia „tik nemokama pakopa“.
OMNIROUTE_CHAOS_MAX_PANEL	5	open-sse/services/autoCombo/virtualFactory.ts	auto/*:chaos transliavimo varianto grupės dydžio riba (apribota iki 1–10) — viena užklausa išsiunčiama ne daugiau kaip šiam skaičiui skirtingų teikėjų modelių.
OMNIROUTE_CHAOS_MIN_PANEL	(variklio numatytoji reikšmė)	open-sse/services/autoCombo/virtualFactory.ts	Mažiausio grupės dydžio derinimo reikšmė, perduodama chaotiško transliavimo apdorojimo programai; nenustačius paliekama variklio numatytoji reikšmė.
OMNIROUTE_CHAOS_PANEL_TIMEOUT_MS	(variklio numatytoji reikšmė)	open-sse/services/autoCombo/virtualFactory.ts	Griežtasis visos chaotiškos grupės lygiagretaus užklausų išsiuntimo skirtasis laikas (ms); nenustačius paliekama variklio numatytoji reikšmė.
GROK_AUTH_PATH	~/.grok/auth.json	open-sse/services/grokQuotaFetcher.ts	Grok CLI failo auth.json, naudojamo grok-web savaitinei kvotai gauti, kelias; pakeiskite testams arba nestandartiniam CLI diegimui.
AGENTBRIDGE_UPSTREAM_CA_CERT	(nenustatyta)	src/mitm/manager.ts	Papildomas CA sertifikatas (PEM), kuriuo pasitikima užmezgant AgentBridge TLS ryšius su aukštesnio lygio serveriais.
INSPECTOR_BUFFER_SIZE	1000	src/mitm/inspector/buffer.ts	Didžiausias užfiksuotų užklausų skaičius, saugomas „Traffic Inspector“ žiediniame buferyje.
INSPECTOR_MAX_BODY_KB	1024	src/mitm/inspector/buffer.ts	Didžiausias užfiksuotos užklausos / atsako turinio dydis (KB), kurį viršijus turinys sutrumpinamas.
INSPECTOR_HTTP_PROXY_PORT	8080	src/mitm/inspector/httpProxyServer.ts	Vietinis „Traffic Inspector“ HTTP tarpinio serverio prievadas.
INSPECTOR_HTTP_PROXY_AUTOSTART	false	src/mitm/inspector/httpProxyServer.ts	Automatiškai paleisti „Inspector“ HTTP tarpinį serverį įkrovos metu.
INSPECTOR_TLS_INTERCEPT	false	src/lib/inspector/captureState.ts	Įjungti užfiksuoto HTTPS srauto TLS perėmimą (MITM).
INSPECTOR_LLM_HOSTS_EXTRA	(nenustatyta)	src/lib/inspector/captureState.ts	Papildomi pagrindinių kompiuterių vardai (atskirti kableliais), kurie fiksuojant laikomi LLM galiniais taškais.
INSPECTOR_MASK_SECRETS	true	src/mitm/inspector/buffer.ts	Maskuoti paslaptis (autentifikavimo antraštes / API raktus) užfiksuotame sraute.
INSPECTOR_SYSTEM_PROXY_GUARD_MINUTES	30	src/app/api/tools/traffic-inspector/capture-modes/system-proxy/route.ts	Minučių skaičius, po kurio sistemos tarpinio serverio apsauga automatiškai atkuria operacinės sistemos tarpinio serverio nustatymus.
INSPECTOR_INTERNAL_INGEST_TOKEN	(automatiškai)	src/app/api/tools/traffic-inspector/internal/ingest/route.ts	Prieigos raktas, autentifikuojantis vidinį užfiksuotų duomenų perdavimą į „Inspector“.
PLAYGROUND_COMPARE_MAX_COLUMNS	4	src/app/(dashboard)/dashboard/playground/	Didžiausias greta rodomų stulpelių skaičius „Playground“ palyginimo režime.
PLAYGROUND_IMPROVE_PROMPT_DEFAULT_MODEL	(nenustatyta)	src/app/(dashboard)/dashboard/playground/	Numatytasis „Playground“ veiksmo „improve prompt“ modelis (jei nenustatyta, naudojamas aktyvus modelis).
BIFROST_ENABLED	1	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Pagrindinis „Bifrost“ pagalbinio tarpinio serverio avarinis išjungiklis. Nustačius 0, maršrutas grąžina 503 su X-Bifrost-Killswitch antrašte, o operatorius nukreipiamas į TS kelią. Naudokite pagalbiniam serveriui išjungti neperdiegiant sistemos (1 lygio maršrutizatoriaus incidento ar rakto keitimo atveju).
BIFROST_BASE_URL	(nenustatyta)	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Kai nustatyta, „Bifrost“ pagalbinio tarpinio serverio maršrutas persiunčia /v1/chat/completions srautą į šį „Go“ šliuzą, o ne į TS perdavimo apdorojimo programą. Nenustatyta → 503 su atsarginiu keliu. Galinis pasvirasis brūkšnys pašalinamas.
BIFROST_PORT	8080	src/lib/services/bootstrap.ts	Prievadas, prie kurio prižiūrima įterptoji „Bifrost“ paslauga prisijungia (127.0.0.1:<port>), kai „OmniRoute“ valdo „Bifrost“ pagalbinio serverio gyvavimo ciklą. Numatytoji reikšmė yra 8080.
BIFROST_API_KEY	(nenustatyta)	src/app/api/v1/relay/chat/completions/bifrost/route.ts	„Bifrost“ šliuzo API raktas (siunčiamas kaip Authorization: Bearer ...). Jei nenustatyta, maršrutas tikisi, kad užklausoje bus galiojantis „OmniRoute“ API raktas; šis raktas skirtas tik autentifikavimui šliuzo pusėje.
BIFROST_STREAMING_ENABLED	true	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Kai reikšmė yra „true“, „Bifrost“ pagalbinio serverio maršrutas perduoda atsakymus srautiniu būdu per SSE ir šliuzą, o ne per TS srautinio vykdymo modulį. Nustatykite 0, kad per šliuzą būtų priverstinai grąžinami nesrautiniai JSON atsakymai.
BIFROST_TIMEOUT_MS	30000	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Kiekvienos užklausos skirtasis laikas persiunčiant į „Bifrost“ šliuzą (ms). Viršijus skirtąjį laiką, maršrutas grąžina TS perdavimo kelią per X-Bifrost-Fallback antraštę.
OMNIROUTE_BIFROST_KEY	(nenustatyta)	src/app/api/v1/relay/chat/completions/bifrost/route.ts	BIFROST_API_KEY alternatyvusis pavadinimas (naudojamas scenarijų, kurie skaito aplinkos kintamuosius per OMNIROUTE_*). Kai nustatyti abu, pirmenybė teikiama BIFROST_API_KEY.
OMNIROUTE_RELAY_BACKEND	ts / auto	src/app/api/v1/relay/chat/completions/routingBackend.ts	/api/v1/relay/chat/completions perdavimo posistemė: ts | bifrost | auto. ts = „TypeScript“ perdavimas (numatytasis, kai „Bifrost“ nesukonfigūruotas); auto pasirenka „Bifrost“, kai BIFROST_BASE_URL yra nustatytas ir BIFROST_ENABLED ≠ 0, o jei pagalbinis serveris nepasiekiamas, automatiškai naudoja atsarginį TS kelią; bifrost priverstinai naudoja „Bifrost“ (griežtai, be atsarginio kelio). Autentifikavimas, užklausų dažnio ribojimas, įterpimo apsauga ir leidžiamųjų elementų sąrašas visada pirmiausia vykdomi „Next“ maršrute. Atsakymuose pateikiamos X-Routing-Backend / X-Routing-Fallback / X-Routing-Fallback-Reason antraštės.
RELAY_ROUTING_BACKEND	(nenustatyta)	src/app/api/v1/relay/chat/completions/routingBackend.ts	Priimtinas alternatyvusis OMNIROUTE_RELAY_BACKEND pavadinimas (tos pačios ts | bifrost | auto reikšmės). Kai nustatyti abu, pirmenybė teikiama OMNIROUTE_RELAY_BACKEND.
OMNIROUTE_BIFROST_FAILURE_COOLDOWN_MS	5000	src/app/api/v1/relay/chat/completions/bifrostCooldown.ts	Atvėsimo laikotarpis (ms) po nepavykusio „Bifrost“ pagalbinio proceso perėjimo auto režimu, prieš retransliatoriui dar kartą bandant naudoti pagalbinį procesą; kol trunka atvėsimo laikotarpis, užklausos nukreipiamos tiesiai į TS kelią, o jam pasibaigus bandoma dar kartą. 0 išjungia. Taikoma tik tada, kai OMNIROUTE_RELAY_BACKEND=auto.
OMNIROUTE_TLS_CERT	(nenustatyta)	bin/cli/commands/serve.mjs	Kelias į PEM TLS sertifikatą, skirtą omniroute serve teikti per HTTPS (atitinka --tls-cert). Turi būti naudojamas kartu su OMNIROUTE_TLS_KEY; tada autonominis serveris užbaigia TLS tame pačiame klausytojuje (wss:// veikia be pakeitimų). Nenustatyta → paprastas HTTP. Nurodžius tik sertifikatą arba raktą, ar neįskaitomą kelią, užregistruojamas įspėjimas ir toliau naudojamas HTTP.
OMNIROUTE_TLS_KEY	(nenustatyta)	bin/cli/commands/serve.mjs	Kelias į PEM TLS privatųjį raktą, skirtą omniroute serve HTTPS (atitinka --tls-key). Turi būti naudojamas kartu su OMNIROUTE_TLS_CERT. Žr. OMNIROUTE_TLS_CERT.
OMNIROUTE_LOCAL_ENDPOINTS_ENABLED	0	src/lib/security/localEndpoints.ts	Pagrindinis /api/local/* maršrutų jungiklis. Kai nenustatyta arba nustatyta į 0, visi /api/local/* maršrutai gamybinėje aplinkoje grąžina 503. Ne atgalinio ryšio sąsajoje veikiančiuose diegimuose turi būti nustatyta į 1, kad būtų įjungta Redis paleidyklė ir panašios vienu spustelėjimu paleidžiamos vietinės paslaugos. Papildoma apsauga kartu su isLocalOnlyPath() maršrutų apsaugos klasifikacija (LOCAL_ONLY_API_PREFIXES faile src/server/authz/routeGuard.ts).
OMNIROUTE_LOCAL_ENDPOINTS_TOKEN	(nenustatyta)	src/lib/security/localEndpoints.ts	Bearer prieigos raktas /api/local/* iškvietėjams, kurie nėra atgalinio ryšio sąsajoje (pvz., darbalaukio programai). Kai nustatyta, užklausose iš ne atgalinio ryšio IP adresų turi būti pateikta Authorization: Bearer <token>. Būtina, kai ne atgalinio ryšio sąsajoje veikiančiuose diegimuose nustatyta OMNIROUTE_LOCAL_ENDPOINTS_ENABLED=1.
OMNIROUTE_REDIS_CONTAINER_NAME	omniroute-redis	bin/cli/commands/redis.mjs	Vienu spustelėjimu paleidžiamos Redis paleidyklės konteinerio pavadinimas (omniroute redis up). Naudojamas ir CLI, ir RedisLauncherPanel grafinėje sąsajoje.
OMNIROUTE_REDIS_HOST_PORT	6379	bin/cli/commands/redis.mjs	Vienu spustelėjimu paleidžiamos Redis paleidyklės pagrindinio kompiuterio prievadas. Pakeiskite, jei pagrindiniame kompiuteryje jau susietas 6379 prievadas. Vidinis konteinerio prievadas lieka 6379.
OMNIROUTE_REDIS_BIND_HOST	127.0.0.1	bin/cli/commands/redis.mjs	Pagrindinio kompiuterio sąsaja, kurioje vienu spustelėjimu paleidžiama Redis paleidyklė publikuoja paslaugą. Paleidyklė paleidžia Redis BE slaptažodžio, todėl susiejus su 0.0.0.0 kiekvienas jūsų LAN pagrindinis kompiuteris gauna neautentifikuotą prieigą prie Redis — išplėskite šią prieigą tik jei patys nustatėte egzemplioriaus slaptažodį.
REDIS_BIND_HOST	127.0.0.1	docker-compose.yml	Pagrindinio kompiuterio sąsaja, kurioje docker-compose publikuoja Redis pagalbinį procesą (#9286). Compose Redis veikia be requirepass; programos konteineriai jį pasiekia per compose tinklą (redis:6379) — publikuotas prievadas skirtas tik pagrindinio kompiuterio įrankiams. 0.0.0.0 atveria neautentifikuotą Redis visam LAN.
REDIS_PORT	6379	docker-compose.yml	Compose Redis pagalbinio proceso pagrindinio kompiuterio prievadas.
APP_BIND_HOST	127.0.0.1	docker-compose.yml, docker-compose.prod.yml	Pagrindinio kompiuterio sąsaja, kurioje docker-compose publikuoja pačios programos valdymo skydelio/API/tiesioginio WS prievadus (#12568). Kadangi .env.example numatytoji reikšmė yra REQUIRE_API_KEY=false, 0.0.0.0 atveria anoniminį /v1 LLM tarpinį serverį visam LAN/WAN — išplėskite prieigą tik nustatę REQUIRE_API_KEY=true arba jei priešais esantis atvirkštinis tarpinis serveris užtikrina savo autentifikavimą.
QDRANT_BIND_HOST	127.0.0.1	docker-compose.yml	Pagrindinio kompiuterio sąsaja, kurioje docker-compose publikuoja Qdrant atminties pagalbinę tarnybą (#12578). Taikomi tie patys LAN pasiekiamumo argumentai kaip ir REDIS_BIND_HOST.
BIFROST_BIND_HOST	127.0.0.1	docker-compose.yml	Pagrindinio kompiuterio sąsaja, kurioje docker-compose publikuoja Bifrost maršruto parinktuvo pagalbinę tarnybą (#12578). Taikomi tie patys LAN pasiekiamumo argumentai kaip ir REDIS_BIND_HOST.
REDIS_KEY_PREFIX	omniroute:	src/shared/utils/rateLimiter.ts	Vardų srities priešdėlis, taikomas kiekvienam OmniRoute Redis raktui (greičio ribotuvui, autentifikavimo podėliui, kvotų saugyklai, parengiamojo paleidimo grandinės pertraukikliui). Neleidžia susidurti raktams, kai Redis egzempliorius bendrinamas su kitomis programomis (#11042).
OMNIROUTE_INTERNAL_SERVICE_TOKEN	(nenustatyta — mechanizmas išjungtas)	src/lib/api/internalServiceAuth.ts	Bendrinama paslaptis tapatybei išsaugoti atliekant vidines REST užklausas (#9260): OmniRoute komponentai, iškviesdami kitus vietinius OmniRoute maršrutus, siunčia ją kaip x-omniroute-internal-service-token, kad būtų išsaugota pradinio kvietėjo tapatybė. Palyginama naudojant timingSafeEqual.
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE	(nenustatyta)	src/lib/api/internalServiceAuth.ts	Vidinio tarnybos prieigos rakto paslapties failo variantas: kelias į failą, kurio turinys, pašalinus tarpus pradžioje ir pabaigoje, yra prieigos raktas. Naudojamas tik tada, kai tiesioginis kintamasis nenustatytas.
OPENROUTER_PROVIDER_STATS_ENABLED	true	src/lib/catalog/openrouterProviderStats.ts	Papildo valdymo skydelio teikėjų sąrašą OpenRouter savaitinio reitingo statistika (#9324). Įjungta pagal numatytuosius nustatymus; nustatykite false, kad foninė duomenų gavimo operacija būtų visiškai praleista (neblokuojanti ir niekada nesukelianti kritinės klaidos).
OPENROUTER_PROVIDER_STATS_TTL_MS	86400000 (24 val.)	src/lib/catalog/openrouterProviderStats.ts	OpenRouter teikėjų statistikos momentinės kopijos podėlio TTL milisekundėmis.
OMNIROUTE_REDIS_IMAGE	redis:7-alpine	bin/cli/commands/redis.mjs	Redis atvaizdis, naudojamas Redis paleidimo vienu spustelėjimu priemonėje. Jei reikia, pakeiskite į redis:8-alpine arba privataus registro veidrodį.
QDRANT_HOST	qdrant	(pasirenkamas klasterio profilis)	Qdrant pagalbinės tarnybos pagrindinio kompiuterio vardas, kai aktyvus --profile memory. Numatytoji reikšmė nurodo vidinio tinklo qdrant tarnybos pavadinimą; pakeiskite ją išorinio diegimo atveju. Naudojama tik tada, kai kode qdrantEnabled yra true (src/lib/memory/vectorStore.ts:108).
QDRANT_PORT	6333	(pasirenkamas klasterio profilis)	„Qdrant“ pagalbinio konteinerio REST prievadas.
QDRANT_GRPC_PORT	6334	(pasirenkamas klasterio profilis)	„Qdrant“ pagalbinio konteinerio gRPC prievadas. Naudojamas klientų bibliotekų, kurios srautinėms operacijoms teikia pirmenybę gRPC, o ne REST.
QDRANT_API_KEY	(nenustatyta)	(pasirenkamas klasterio profilis)	Pasirenkamas „Qdrant Cloud“ arba autentifikuoto vietinio egzemplioriaus API raktas. Tuščia reikšmė → api-key antraštė nesiunčiama.
QDRANT_COLLECTION	omniroute-memory	(pasirenkamas klasterio profilis)	„OmniRoute“ pokalbių atminties įterpinių kolekcijos pavadinimas. Pirmą kartą paleidus sukuriama su QDRANT_VECTOR_SIZE matmenų skaičiumi.
QDRANT_EMBEDDING_MODEL	text-embedding-3-small	(pasirenkamas klasterio profilis)	Numatytasis įterpinių modelio pavadinimas, įrašomas „Qdrant“ kolekcijos metaduomenyse. Faktinius įterpinius generuoja teikėjas, į kurį nurodo „OmniRoute“ nuostatų laukas embeddingModel.
QDRANT_VECTOR_SIZE	1536	(pasirenkamas klasterio profilis)	Įterpinio vektoriaus matmuo. Turi sutapti su naudojamu įterpinių modeliu (text-embedding-3-small → 1536; ada-002 → 1536; nomic-embed-text → 768).
QDRANT_HNSW_EF_CONSTRUCT	128	(pasirenkamas klasterio profilis)	HNSW indekso tikslumas kūrimo metu. Didesnė reikšmė = lėtesnis kūrimas, greitesnė paieška.
OMNIROUTE_ROTATION_ENABLED	true	open-sse/services/rotationConfig.ts	Pagrindinis operatoriaus konfigūruojamo paskyrų kaitaliojimo jungiklis. Kai reikšmė yra false, nė viena iš toliau pateiktų OMNIROUTE_ROTATE_* klasių neaktyvina atsarginės paskyros naudojimo (išjungta pagrindinė būsena taip pat blokuoja pagal numatytuosius nustatymus įgalintas 429/500/502 klases). Tai leidžia prižiūrinčiai naudotojo sąsajai (pvz., „VibeProxy“ darbalaukio programai) perkelti savo kaitaliojimo taisykles į serverio paskyrų perjungimo mechanizmą.
OMNIROUTE_ROTATION_RATE_LIMIT_RESET_SECONDS	0	open-sse/services/rotationConfig.ts	Atvėsimo laikotarpis (sekundėmis), taikomas užklausų dažnio apribotai paskyrai, kai išorinė paslauga nepateikia aiškios atstatymo nuorodos. 0 = vietoj fiksuoto perrašymo naudoti numatytąjį mechanizmo atvėsimo laikotarpį.
OMNIROUTE_ROTATION_DISABLE_TAG_WITHOUT_RESET	true	open-sse/services/rotationConfig.ts	Naudotojo sąsajos nuostatos „nežymėti kaip apriboto pagal užklausų dažnį, jei nėra atstatymo laiko“ atitikmuo.
OMNIROUTE_ROTATE_ON_429	true	open-sse/services/rotationConfig.ts	Atsarginio perjungimo įjungimas 429 klaidoms pagal būseną. Kai false (ir OMNIROUTE_ROTATION_ENABLED=true), 429 nebesukelia paskyros rotacijos ir vietoj to grąžinama klientui.
OMNIROUTE_ROTATE_429_THRESHOLD	1	open-sse/services/rotationConfig.ts	429 klaidų skaičius per OMNIROUTE_ROTATE_429_WINDOW_SECONDS, kurio reikia prieš rotuojant paskyrą. 1 (numatytoji reikšmė) rotuoja iš karto, išsaugant ankstesnę elgseną.
OMNIROUTE_ROTATE_429_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	Slenkantis langas (sekundėmis), per kurį 429 klaidos skaičiuojamos siekiant OMNIROUTE_ROTATE_429_THRESHOLD.
OMNIROUTE_ROTATE_ON_500	true	open-sse/services/rotationConfig.ts	Atsarginio perjungimo įjungimas 5xx serverio klaidoms pagal būseną (išskyrus 502, kuriai skirta atskira klasė). Kai false, šios klaidos nebesukelia paskyros rotacijos.
OMNIROUTE_ROTATE_500_THRESHOLD	1	open-sse/services/rotationConfig.ts	5xx klaidų skaičius per OMNIROUTE_ROTATE_500_WINDOW_SECONDS, kurio reikia prieš rotuojant paskyrą. 1 (numatytoji reikšmė) rotuoja iš karto.
OMNIROUTE_ROTATE_500_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	Slenkantis langas (sekundėmis), per kurį 5xx klaidos skaičiuojamos siekiant OMNIROUTE_ROTATE_500_THRESHOLD.
OMNIROUTE_ROTATE_ON_502	true	open-sse/services/rotationConfig.ts	Atsarginio perjungimo įjungimas 502 (netinkamo šliuzo) klaidoms pagal būseną. Kai false, 502 klaidos nebesukelia paskyros rotacijos.
OMNIROUTE_ROTATE_502_THRESHOLD	1	open-sse/services/rotationConfig.ts	502 klaidų skaičius per OMNIROUTE_ROTATE_502_WINDOW_SECONDS, kurio reikia prieš rotuojant paskyrą. 1 (numatytoji reikšmė) rotuoja iš karto.
OMNIROUTE_ROTATE_502_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	Slenkantis langas (sekundėmis), per kurį 502 klaidos skaičiuojamos siekiant OMNIROUTE_ROTATE_502_THRESHOLD.
OMNIROUTE_ROTATE_ON_400	false	open-sse/services/rotationConfig.ts	Pasirenkama funkcija (pagal numatymą IŠJUNGTA): kai true, paprasta 400 (netinkamos užklausos) klaida taip pat sukelia paskyros rotaciją. Tai tik papildoma funkcija — ji niekada neblokuoja esamos variklio elgsenos, kai 400 klaida su spartos apribojimo ar kvotos tekstu vis tiek perjungiama nepaisant šios žymos.
OMNIROUTE_ROTATE_400_THRESHOLD	1	open-sse/services/rotationConfig.ts	400 klaidų skaičius per OMNIROUTE_ROTATE_400_WINDOW_SECONDS, kurį pasiekus paskyra pakeičiama (tikrinama tik tada, kai OMNIROUTE_ROTATE_ON_400=true).
OMNIROUTE_ROTATE_400_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	Slankusis langas (sekundėmis), per kurį 400 klaidos skaičiuojamos siekiant OMNIROUTE_ROTATE_400_THRESHOLD.

Claude pašildymo planuoklė

Cron valdoma pašildymo funkcija, skirta pasirinktoms Anthropic OAuth jungtims, kad 5 valandų užklausų dažnio ribojimo langas būtų atvertas trivialia suplanuota užklausa, o ne pirmąja tikra užklausa (#8848). Planuoklė išjungta, nebent OMNIROUTE_WARMUP_ENABLED turi teisingą reikšmę ir jungtis pažymėta settings.claudeWarmup.connections; jei jungčių sąrašas tuščias, niekas nepašildoma, net jei aplinkos kintamasis įjungtas.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_WARMUP_ENABLED	(nenustatyta → išjungta)	src/lib/warmupScheduler.ts	Pagrindinis pašildymo planuoklės jungiklis. Priima 1/true/yes/on (neatsižvelgiant į didžiąsias ir mažąsias raides, pašalinus tarpus). Bet kokia kita reikšmė arba nenustatyta reikšmė palieka planuoklę išjungtą.
OMNIROUTE_WARMUP_CRON	0 7 * * *	src/lib/warmupScheduler.ts	Penkių laukų cron išraiška pašildymo ciklui, vertinama America/Los_Angeles laiko juostoje (Anthropic atkūrimo laiko juostoje), neatsižvelgiant į pagrindinio kompiuterio laikrodį.
OMNIROUTE_WARMUP_CONCURRENCY	3	src/lib/warmupScheduler.ts	Kiek jungčių pašildoma lygiagrečiai per vieną ciklą. Apribojama iki 1–10; jei reikšmė nėra skaitinė, naudojama 3.
OMNIROUTE_WARMUP_MODEL	claude-3-5-haiku-20241022	src/lib/warmupScheduler.ts	Pašildymo užklausai naudojamas modelis. Keiskite tik jei numatytasis modelis nepasiekiamas pagal jūsų planą; pasirinkite pigiausią modelį, kuris vis tiek atveria langą.

Naršyklinio prisijungimo VNC seansai ir duomenų katalogo alternatyvusis pavadinimas

Konteineryje veikiantys Chromium ir VNC, naudojami interaktyviai naršyklinio prisijungimo kredencialams gauti (/api/vnc-session), taip pat senasis DATA_DIR alternatyvusis pavadinimas. Visa tai neprivaloma — numatytosios VNC reikšmės skirtos integruotam omniroute-vnc-chromium:local atvaizdui ir keičiamos tik naudojant pasirinktinį konteinerio atvaizdą, prievadus arba koreguojant gyvavimo ciklą.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_VNC_IMAGE	omniroute-vnc-chromium:local	src/lib/vncSession/manifest.ts	„Docker“ atvaizdo žyma, skirta „Chromium“ ir VNC prisijungimo konteineriui. Sukurkite docker/vnc-browser/chromium arba čia nurodykite pasirinktinį atvaizdą.
OMNIROUTE_DOCKER_BIN	docker	src/lib/vncSession/manifest.ts	Konteinerių vykdymo aplinkos dvejetainis failas, naudojamas VNC konteineriui paleisti (pvz., nustatykite į podman).
OMNIROUTE_VNC_CONTAINER_VNC_PORT	3000	src/lib/vncSession/manifest.ts	VNC/noVNC prievadas, pasiekiamas konteinerio viduje.
OMNIROUTE_VNC_CONTAINER_CDP_PORT	9223	src/lib/vncSession/manifest.ts	„Chrome DevTools Protocol“ prievadas konteinerio viduje.
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR	/config	src/lib/vncSession/manifest.ts	„Chromium“ profilio katalogo kelias konteinerio viduje.
OMNIROUTE_VNC_PROFILE_DIR	$HOME/.omniroute/browser-login-profiles	src/lib/vncSession/manifest.ts	Pagrindinio kompiuterio katalogas, kuriame saugomi išliekamieji naršyklės prisijungimo profiliai.
OMNIROUTE_VNC_IDLE_MS	600000 (10 min.)	src/lib/vncSession/manifest.ts	Neveiklumo skirtasis laikas (ms), kuriam praėjus neaktyvi VNC sesija pašalinama.
OMNIROUTE_VNC_MAX_MS	1800000 (30 min.)	src/lib/vncSession/manifest.ts	Griežta vienos VNC sesijos trukmės riba (ms).
OMNIROUTE_VNC_MAX_SESSIONS	4	src/lib/vncSession/manifest.ts	Didžiausias vienu metu vykdomų VNC sesijų skaičius.
OMNIROUTE_VNC_READY_MS	45000	src/lib/vncSession/manifest.ts	Skirtasis laikas (ms), per kurį laukiama, kol konteineryje veikianti naršyklė bus parengta CDP ryšiui.
OMNIROUTE_VNC_HARVEST_MS	20000	src/lib/vncSession/manifest.ts	Skirtasis laikas (ms), skirtas užfiksuotai sesijai ir slapukams surinkti užbaigus prisijungimą.
OMNIROUTE_VNC_CHROMIUM_ARGS	--remote-debugging-port=9222 --no-first-run --no-default-browser-check	src/lib/vncSession/manifest.ts	Papildomos komandų eilutės parinktys, perduodamos konteineryje veikiančiai „Chromium“ naršyklei.
OMNIROUTE_VNC_NETWORK	omniroute-vnc-browser-login	src/lib/vncSession/manifest.ts	Specialus „Docker“ tinklas, prie kurio VNC prisijungimo konteineris prisijungia (#12571) vietoje numatytojo tilto, kad lygiagretūs konteineriai negalėtų pasiekti jo CDP tilto prievado.
VIBEPROXY_DATA_DIR	(nenustatyta)	open-sse/services/notionThreadSessions.ts	Pasenęs alternatyvus pavadinimas, skirtas DATA_DIR; tikrinamas tik tada, kai nenustatyti ir DATA_DIR, ir OMNIROUTE_DATA_DIR. Nurodo „Notion“ žiniatinklio gijų sesijų podėlio vietą (<dir>/notion-web-thread-sessions.json).

---

26. Testavimo ir E2E infrastruktūra

Naudojama scripts/dev/run-next-playwright.mjs, scripts/dev/smoke-electron-packaged.mjs, scripts/dev/run-ecosystem-tests.mjs ir scripts/build/uninstall.mjs. Produkcinėse aplinkose palikite visas toliau nurodytas reikšmes nenustatytas.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_E2E_BOOTSTRAP_MODE	auth	scripts/dev/run-next-playwright.mjs	E2E pradinio parengimo režimas (auth, fresh, reuse), skirtas Playwright vykdyklei.
OMNIROUTE_E2E_PASSWORD	grįžtama prie INITIAL_PASSWORD	scripts/dev/run-next-playwright.mjs	Administratoriaus slaptažodis, įterpiamas į Playwright aplinką.
OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK	true	scripts/dev/run-next-playwright.mjs	Išjungia vietinės būklės patikros apklausą vykdant Playwright.
OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK	true	scripts/dev/run-next-playwright.mjs	Išjungia OAuth prieigos rakto būklės patikros ciklą testų metu.
OMNIROUTE_HEALTHCHECK_SKIP_PROVIDERS	(nenustatyta)	src/lib/tokenHealthCheck.ts	Kableliais atskirtų teikėjų, neįtraukiamų į išankstinį prieigos raktų atnaujinimą, sąrašas (pvz., codex,openai). Tikslinė alternatyva visiškam būklės patikros išjungimui — trumpo galiojimo teikėjai toliau atnaujinami, o kaskadiniai teikėjai lieka tik reaktyvūs.
OMNIROUTE_HIDE_HEALTHCHECK_LOGS	true	scripts/dev/run-next-playwright.mjs	Nutildo būklės patikros pranešimus Playwright standartinėje išvestyje.
OMNIROUTE_PLAYWRIGHT_SKIP_BUILD	0	scripts/dev/run-next-playwright.mjs	Praleidžia Next.js produkcinį komponavimą prieš paleidžiant Playwright (CI optimizavimas).
OMNIROUTE_SKIP_UNINSTALL_HOOK	0	scripts/build/uninstall.mjs	Praleidžia OmniRoute pašalinimo kablį (naudojama CI, kad node_modules liktų nepakeistas).
ECOSYSTEM_SERVER_WAIT_MS	180000	scripts/dev/run-ecosystem-tests.mjs	Laukimo laikas (ms), per kurį serveris turi pradėti tinkamai veikti prieš vykdant ekosistemos arba protokolo testus.
ELECTRON_SMOKE_URL	http://127.0.0.1:20128/login	scripts/dev/smoke-electron-packaged.mjs	URL, kuriuo, kaip tikisi Electron bazinio patikrinimo infrastruktūra, supakuota programa teiks paslaugą.
ELECTRON_SMOKE_TIMEOUT_MS	45000	scripts/dev/smoke-electron-packaged.mjs	Bendrasis skirtasis laikas (ms), kuriam pasibaigus bazinio patikrinimo infrastruktūra nutraukia bandymą.
ELECTRON_SMOKE_SETTLE_MS	2000	scripts/dev/smoke-electron-packaged.mjs	Stabilizavimosi laikotarpis (ms) įkėlus puslapį.
ELECTRON_SMOKE_APP_EXECUTABLE	(automatiškai)	scripts/dev/smoke-electron-packaged.mjs	Aiškiai nurodytas kelias iki supakuoto Electron vykdomojo failo.
ELECTRON_SMOKE_DATA_DIR	(tmpdir)	scripts/dev/smoke-electron-packaged.mjs	Electron bazinio patikrinimo vykdymo duomenų katalogas.
ELECTRON_SMOKE_KEEP_DATA	0	scripts/dev/smoke-electron-packaged.mjs	Nustatykite 1, kad po vykdymo būtų išsaugotas bandomųjų duomenų katalogas.
ELECTRON_SMOKE_STREAM_LOGS	0	scripts/dev/smoke-electron-packaged.mjs	Nustatykite 1, kad vykdymo metu Electron žurnalai būtų srautiniu būdu siunčiami į stdout.
ELECTRON_SMOKE_COLD_RESTART	0	scripts/dev/smoke-electron-packaged.mjs	#7592: paleidžia iš naujo naudodamas tą patį duomenų katalogą ir patikrina, ar antrojo paleidimo metu pasirenkama savoji SQLite tvarkyklė.
CLI_DEVIN_BIN	(PATH paieška)	open-sse/executors/devin-cli.ts	Leidžia pakeisti Devin CLI dvejetainio failo kelią.

Dokumentacijos vertimo procesas

Naudojama scripts/i18n/run-translation.mjs (npm run i18n:run komanda). Pagal numatytuosius nustatymus visi penki kintamieji yra nenustatyti — nustatykite juos .env tik tuose kompiuteriuose, kuriuose turi būti galima vykdyti dokumentacijos vertimo įrankį.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašas
OMNIROUTE_TRANSLATION_API_URL	(nenustatyta)	scripts/i18n/run-translation.mjs	Su OpenAI suderinamas bazinis vertimo posistemės URL.
OMNIROUTE_TRANSLATION_API_KEY	(nenustatyta)	scripts/i18n/run-translation.mjs	Vertimo posistemės atpažinimo ženklas „Bearer“ (niekada neregistruojamas).
OMNIROUTE_TRANSLATION_MODEL	(nenustatyta)	scripts/i18n/run-translation.mjs	Modelio ID, pvz., gpt-4o-mini arba cx/gpt-5.4-mini.
OMNIROUTE_TRANSLATION_TIMEOUT_MS	60000	scripts/i18n/run-translation.mjs	Kiekvienos užklausos skirtasis laikas milisekundėmis.
OMNIROUTE_TRANSLATION_CONCURRENCY	4	scripts/i18n/run-translation.mjs	Lygiagrečios vertimo užklausos apdorojant kelis failus / lokales.

---

27. Radar srautas (savarankiškas talpinimas)

Pasirenkamas priedas, valdomas RADAR_ENABLED funkcijos vėliavėle (pagal numatytuosius nustatymus išjungta — funkcijos vėliavėlė keičiama per nustatymus / DB, o ne aplinkos kintamuoju; žr. docs/frameworks/RADAR.md). Pirmieji keturi toliau pateikti kintamieji yra pasirenkami savarankiškai talpinamo arba išsišakojusio srauto ir rėmėjo rakto procesų perrašymai. Penktasis, RADAR_ADMIN_URL, yra atskira, numatytosios reikšmės neturinti nuoroda į savininko privatų operacijų skydelį. Išsamius modulio dokumentus ir jo visą aktyvinimo bei vedamojo nustatymo seką žr. docs/frameworks/RADAR.md.

Bendrasis pradžios puslapio / pakeitimų žurnalo pranešimų skaitytuvas nėra konfigūruojamas aplinkos kintamuoju ir nepriklauso nuo RADAR_ENABLED funkcijos vėliavėlės. Jis tik per GET nuskaito viešosios saugyklos news.json URL, deklaruotą src/shared/utils/releaseNotes.ts; atmetimo ID lieka naršyklės vietinėje saugykloje.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
RADAR_FEED_URL	https://radar.omniroute.online	src/lib/radar/{sync,referralsSync,offersSync,intelSync}.ts	Bazinis URL, bendrai naudojamas atskirai pasirašytiems katalogo, rekomendacijų, rėmėjų pasiūlymų ir „Intel“ srautams. Pakeiskite, kad būtų naudojama savarankiškai talpinama arba išsišakojusi paslauga.
RADAR_FEED_PUBKEY	(įtvirtintas numatytasis raktas)	src/lib/radar/pinnedKeys.ts	Ed25519 viešasis raktas (base64-DER SPKI arba PEM), naudojamas pasirinktinio srauto parašams tikrinti.
RADAR_CONTRIBUTOR_CLAIM_URL	https://radar.omniroute.online/auth/github	src/lib/radar/links.ts	URL, kurį atveria valdymo skydelio mygtukas „Esu bendradarbis“ (rėmėjo rakto gavimo per GitHub OAuth procesas).
RADAR_SUPPORTER_PLANS_URL	https://radar.omniroute.online/planos	src/lib/radar/links.ts	URL, kurį atveria valdymo skydelio mygtukas „Paremti projektą“ (mokėjimo / planų puslapis).
RADAR_ADMIN_URL	(nenustatyta)	src/lib/radar/links.ts	Tik savininkui skirta privataus operacijų skydelio nuoroda. HTTPS privalomas, išskyrus HTTP grįžtamojo ryšio SSH persiuntimą; jei reikšmė nenustatyta arba netinkama, naršymo elementas nesukuriamas.

---

Auditas: pašalinti / nebenaudojami kintamieji

Toliau nurodyti kintamieji buvo ankstesnėse .env.example versijose, tačiau dabartinėje kodų bazėje vykdymo metu niekur nenaudojami. Jie buvo pašalinti:

Kintamasis	Priežastis
STORAGE_DRIVER=sqlite	Jo neskaito joks šaltinio failas. SQLite yra vienintelė palaikoma tvarkyklė, todėl pasirinkimas nereikalingas.
INSTANCE_NAME=omniroute	Yra senoje dokumentacijoje ir aplinkos šablonuose, tačiau vykdymo metu nenaudojamas. Gali būti grąžintas būsimoje kelių egzempliorių funkcijoje.
SQLITE_MAX_SIZE_MB=2048	Šaltinio kode nenurodomas. Duomenų bazės dydis nėra dirbtinai ribojamas.
SQLITE_CLEAN_LEGACY_FILES=true	Šaltinio kode nenurodomas. Tikėtina, kad pasenusių failų valymo funkcija buvo pašalinta.
CLI_ROO_BIN	Neužregistruotas faile src/shared/services/cliRuntime.ts.
CLI_KIMI_CODING_BIN	Neužregistruotas faile src/shared/services/cliRuntime.ts (Kimi Coding naudoja OAuth, o ne CLI dvejetainį failą).
IFLOW_OAUTH_CLIENT_ID / IFLOW_OAUTH_CLIENT_SECRET	Niekur šaltinio kode nenurodomi.
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	Pašalinti v3.8.0. Vykdymo aplinka šių aplinkos kintamųjų nebeskaito — prisijungimo duomenys gaunami iš Dashboard / data/provider-credentials.json / šifruotos DB.
CURSOR_PROTOBUF_DEBUG	Pašalintas v3.8.0. Cursor vykdyklė naudoja CURSOR_DEBUG / CURSOR_STREAM_DEBUG (žr. §22).
CLI_COMPAT_KIRO	Pašalintas v3.8.0. Kiro yra sąraše CLI_COMPAT_OMITTED_PROVIDER_IDS, todėl jo perjungiklis neturi jokio poveikio.
QIANFAN_API_KEY	Pašalintas kartu su kitais nenaudojamais teikėjų API raktų ruošiniais v3.8.0.

Numatytųjų reikšmių pataisymai

Kintamasis	Senoji .env.example reikšmė	Faktinė numatytoji reikšmė kode	Pataisyta
APP_LOG_RETENTION_DAYS	90	7	✅ Pašalinta klaidinanti reikšmė; 7 nurodyta kaip numatytoji
CALL_LOG_RETENTION_DAYS	90	7	✅ Pašalinta klaidinanti reikšmė; 7 nurodyta kaip numatytoji

OpenCode konfigūracijos generavimas iš naujo (specializuoti įrankiai)

Naudojama scenarijuje scripts/ad-hoc/regen-opencode-config.ts, kad būtų iš naujo sugeneruotas opencode.json su tiksliomis limit.context ir limit.output reikšmėmis, gautomis iš veikiančio OmniRoute egzemplioriaus. Nė vienas iš jų nėra būtinas įprastam veikimui — šis scenarijus yra skirtas tik kūrėjams.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_URL	http://localhost:20128	scripts/ad-hoc/regen-opencode-config.ts	Bazinis OmniRoute egzemplioriaus URL, naudojamas /v1/models užklausai.
OMNIROUTE_KEY	(nenustatyta)	scripts/ad-hoc/regen-opencode-config.ts	API raktas, skirtas autentifikuotis OmniRoute /v1/models galiniame taške. Jei nenustatyta, naudojamas OPENCODE_API_KEY.
OPENCODE_API_KEY	(nenustatyta)	scripts/ad-hoc/regen-opencode-config.ts	OpenCode formato API raktas (sk-...), įrašomas į iš naujo sugeneruotą opencode.json. Jei nenustatyta, naudojamas OMNIROUTE_KEY.

Glaudinimo vertinimo neprisijungus sistema (specialiosios paskirties įrankiai)

Naudojama scripts/compression-eval/index.ts – glaudinimo vertinimo neprisijungus CLI. Įprastam veikimui nereikalinga – skirta tik kūrėjų įrankiams.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_EVAL_CREDENTIALS	{} (tuščias)	scripts/compression-eval/index.ts	Operatoriaus pateikti JSON kredencialai teikėjui, kurį naudoja glaudinimo vertinimo neprisijungus CLI (analizuojami naudojant JSON.parse). Sausajam paleidimui palikite nenustatytą.

VNC naršyklės seansai

Naudojama src/lib/vncSession/manifest.ts, kad būtų konfigūruojami Docker pagrindu veikiantys Chromium seansai be grafinės sąsajos, skirti naršyklės automatizavimo teikėjams. Visi parametrai neprivalomi – numatytosios reikšmės pateiktos toliau.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_DOCKER_BIN	docker	src/lib/vncSession/manifest.ts	Kelias iki Docker vykdomojo failo, naudojamo VNC konteineriams paleisti.
OMNIROUTE_VNC_IMAGE	omniroute-vnc-chromium:local	src/lib/vncSession/manifest.ts	Docker atvaizdis, skirtas VNC Chromium konteineriui.
OMNIROUTE_VNC_CHROMIUM_ARGS	(įtaisytosios vėliavėlės)	src/lib/vncSession/manifest.ts	Papildomi Chromium CLI argumentai, perduodami konteinerio viduje veikiančiai naršyklei.
OMNIROUTE_VNC_CONTAINER_VNC_PORT	3000	src/lib/vncSession/manifest.ts	VNC prievadas konteinerio viduje.
OMNIROUTE_VNC_CONTAINER_CDP_PORT	9223	src/lib/vncSession/manifest.ts	Chrome DevTools Protocol prievadas konteinerio viduje.
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR	/config	src/lib/vncSession/manifest.ts	Profilio katalogas konteinerio viduje.
OMNIROUTE_VNC_PROFILE_DIR	(nenustatyta)	src/lib/vncSession/manifest.ts	Pagrindinio kompiuterio katalogas nuolatiniams naršyklės profiliams.
OMNIROUTE_VNC_IDLE_MS	600000	src/lib/vncSession/manifest.ts	Neveiklos skirtasis laikas (ms), kuriam praėjus VNC seansas surenkamas.
OMNIROUTE_VNC_MAX_MS	1800000	src/lib/vncSession/manifest.ts	Didžiausia seanso trukmė (ms).
OMNIROUTE_VNC_MAX_SESSIONS	4	src/lib/vncSession/manifest.ts	Didžiausias vienu metu veikiančių VNC seansų skaičius.
OMNIROUTE_VNC_READY_MS	45000	src/lib/vncSession/manifest.ts	Naršyklės parengties skirtasis laikas (ms).
OMNIROUTE_VNC_HARVEST_MS	20000	src/lib/vncSession/manifest.ts	Surinkimo / valymo skirtasis laikas (ms).
OMNIROUTE_VNC_NETWORK	omniroute-vnc-browser-login	src/lib/vncSession/manifest.ts	Specialus Docker tinklas, prie kurio prisijungia konteineris (#12571), atskirai nuo numatytojo tiltinio tinklo.
VIBEPROXY_DATA_DIR	(nenustatyta)	open-sse/services/notionThreadSessions.ts	Katalogas, skirtas ilgalaikiam Notion gijų seansų saugojimui.

Vidinės paslaugos autentifikavimas

Kintamasis	Numatytoji reikšmė	Aprašymas
OMNIROUTE_INTERNAL_SERVICE_TOKEN	–	Tiesiogiai nurodytas prieigos raktas, skirtas valdymo lygmens paslaugų tarpusavio autentifikavimui.
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE	–	Kelias iki failo, kuriame yra vidinės paslaugos prieigos raktas (pageidautina naudoti konteineriuose; turi pirmenybę prieš tiesiogiai nurodytą kintamąjį).

OpenRouter teikėjų statistika

Kintamasis	Numatytoji reikšmė	Aprašymas
OPENROUTER_PROVIDER_STATS_ENABLED	true	Nustatykite false, kad nebūtų gaunama kiekvieno OpenRouter teikėjo statistika katalogui papildyti.
OPENROUTER_PROVIDER_STATS_TTL_MS	3600000	Gautos OpenRouter teikėjų statistikos podėlio galiojimo trukmė (ms).

Įtaisytasis Redis susiejimas

Kintamasis	Numatytoji reikšmė	Aprašymas
REDIS_BIND_HOST	127.0.0.1	Integruotos Redis paslaugos susiejimo adresas.
REDIS_PORT	6379	Integruotos Redis paslaugos prievadas.
OMNIROUTE_REDIS_BIND_HOST	–	OmniRoute taikomas integruotos Redis paslaugos susiejimo adreso perrašymas.

---

24. „v3.8.50“ leidimo papildymai

Šie nustatymai buvo įtraukti po ankstesnės aplinkos sutarties momentinės kopijos.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
OMNIROUTE_CHAT_ADMISSION_QUEUE_MS	2000	src/shared/middleware/chatBodyAdmission.ts	Ilgiausias laukimo laikas, per kurį tikimasi gauti didelio išteklių poreikio pokalbio priėmimo vietą prieš grąžinant pakartotinai bandomą 503; trumpas ribotas laukimas nuosekliai apdoroja agentų užklausų pliūpsnius, užuot iškart grąžinęs 503. 0 atkuria neatidėliotiną atmetimą.
OMNIROUTE_CHAT_ADMISSION_MAX_QUEUED_BYTES	4194304 (4 MB)	src/shared/middleware/chatBodyAdmission.ts	Eilėje esančių baitų biudžetas priėmimo laukimui: apriboja bendrą buferyje laikomų užklausos turinio baitų kiekį visame procese, kad laukimas nepadidintų dinaminės atminties naudojimo (#4380). Biudžetą viršijantys laukimai iškart gauna pakartotinai bandomą 503.
OMNIROUTE_CHAT_VIRTUAL_TTL_MS	60000 (60 s)	src/shared/middleware/chatBodyAdmission.ts	Nuo #10110 nebenaudojama ir nieko neatliekanti parinktis: kiekvieno seanso priėmimo juostos buvo pašalintos ir pakeistos vienu visam procesui taikomu biudžetu. Priimama dėl konfigūracijos suderinamumo, tačiau ignoruojama.
OMNIROUTE_CHAT_VIRTUAL_MAX_SESSIONS	64	src/shared/middleware/chatBodyAdmission.ts	Nuo #10110 nebenaudojama ir nieko neatliekanti parinktis: kiekvieno seanso priėmimo juostos buvo pašalintos ir pakeistos vienu visam procesui taikomu biudžetu. Priimama dėl konfigūracijos suderinamumo, tačiau ignoruojama.
OMNIROUTE_CHAT_VIRTUAL_LANES	0 (išjungta)	open-sse/services/admission/runtime.ts	Adaptyviosios vykdymo aplinkos virtualios priėmimo juostos (#9654): pagrindinis kiekvienam nuomininkui taikomo adaptyviojo užkardo mechanizmo (2 sistema) jungiklis. Skiriasi nuo anksčiau pateiktų nebenaudojamų kiekvieno ryšio juostų kintamųjų (TTL_MS / MAX_SESSIONS, nuo #10110 nieko neatlieka). Valdymo skydo funkcijos vėliavėlė tokiu pačiu pavadinimu; aplinkos kintamasis turi pirmenybę prieš valdymo skydo perrašą; reikia paleisti iš naujo.
OMNIROUTE_RUNNOW_TIMEOUT_MS	30000	src/app/api/jobs/[id]/run-now/route.ts	Apriboja laiką, kurį „run-now“ iškvieta laukia vykdomos užduoties prieš pradėdama eilėje esančią vykdymo užklausą.
ADOBE_FIREFLY_BROWSER_REFRESH	įjungta	open-sse/services/adobeFireflySession.ts	Naudojant paskyrai priskirtus „Chrome“ CDP seansus palaikoma aktuali IMS ir naršyklės rizikos būsena; norėdami išjungti, nustatykite 0.
ADOBE_FIREFLY_SESSION_DISK	įjungta	open-sse/services/adobeFireflySession.ts	Atkurti „Adobe“ seansai išsaugomi kataloge DATA_DIR; norėdami būseną laikyti tik atmintyje, nustatykite 0.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS	12000	open-sse/services/adobeFireflySession.ts	Mažiausias intervalas tarp „Adobe Firefly“ generavimo užklausų pateikimų.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS	15000	open-sse/services/adobeFireflySession.ts	Papildomas ramybės laikotarpis po kas trečio sėkmingo „Adobe“ pateikimo.
ADOBE_FIREFLY_CHROME_HEADLESS	0	open-sse/services/adobeFireflyBrowserLogin.ts	Tik derinimui skirtas tikras veikimo be grafinės sąsajos režimas; „Adobe colligo“ paprastai atmeta taip sukurtą rizikos seansą.
CHROME_PATH	automatinis aptikimas	open-sse/executors/cloudflare-playground.ts, open-sse/executors/chatgpt-web-codex.ts	Pasirinktinis absoliutus kelias iki „Chrome“ vykdomojo failo, kurį naršykle valdomos vykdymo priemonės naudoja, kai platformos automatinio aptikimo nepakanka.
TELEGRAM_BOT_TOKEN	(nenustatyta)	src/lib/telegram/config.ts	„BotFather“ prieigos raktas, kuris įjungia gaunamų užklausų „webhook“ ir pasirašo „Mini App“ initData.
TELEGRAM_WEBHOOK_SECRET	(nenustatyta)	src/lib/telegram/config.ts	Bendrinama slaptoji reikšmė, užregistruota naudojant setWebhook ir kiekvieno „webhook“ pristatymo metu tikrinama pagal X-Telegram-Bot-Api-Secret-Token antraštę. Privaloma „webhook“ keliui; jei nenustatyta, „webhook“ pristatymai atmetami grąžinant 503.
TELEGRAM_DEFAULT_MODEL	auto/chat	src/lib/telegram/chatProxy.ts	„Telegram“ pokalbių atsakymams naudojamas modelis.
TELEGRAM_BOT_API_BASE	https://api.telegram.org	src/lib/telegram/config.ts	Bazinio „Bot API“ URL perrašymas, skirtas tarpiniams serveriams arba savarankiškai talpinamiems „Bot API“ serveriams.
TELEGRAM_WEBHOOK_TIMEOUT_MS	60000	src/lib/telegram/config.ts	Siunčiamų „Bot API“ iškvietų skirtasis laikas milisekundėmis.
OMNIROUTE_OPTIONAL_PACK_TAR	1 (įjungta)	scripts/build/optionalPackStaging.mjs	Nustatykite 0, kad ruošiant pasirinktinius ML / naršyklės paketus autonominiam „Electron“ medžiui nebūtų kuriami .tar.gz archyvai (paketų katalogai ir optional-packs.index.json vis tiek sukuriami). Naudojama darbalaukio leidimo darbo eigoje siekiant sumažinti įkeliamų artefaktų dydį.

„ChatGPT Web“ („Codex“)

Visuotinės numatytosios naršyklės be grafinės sąsajos ir siunčiamo įrankių tunelio nuostatos. Valdymo skyde nustatytos ryšio reikšmės turi pirmenybę.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašymas
CHATGPT_WEB_CODEX_CHROME_PATH	(aptinkama automatiškai)	open-sse/executors/chatgpt-web-codex.ts	Aiškiai nurodytas Chrome / Chromium kelias, skirtas veikimui su npm, systemd ir PM2.
CHROME_PATH	(aptinkama automatiškai)	open-sse/executors/chatgpt-web-codex.ts	Bendroji atsarginė aiškiai nurodyto Chrome / Chromium kelio reikšmė.
CHATGPT_WEB_CODEX_CDP_URL	(nenustatyta)	open-sse/executors/chatgpt-web-codex.ts	Vidinis CDP galinis taškas; Docker naudoja pagalbinį konteinerį per prievadą 9223.
CDP_PROXY_TOKEN	(nenustatyta)	docker/chatgpt-web-codex-browser/cdp-proxy.mjs	Jei nustatyta, kiekviena užklausa CDP tarpinio serverio pagalbiniam konteineriui turi perduoti šią reikšmę antraštėje X-Omni-Cdp-Token (#13679). Jei reikšmė nenustatyta, tarpinis serveris persiunčia užklausas be autentifikavimo — tokiu atveju apsaugą užtikrina tik Compose tinklo chatgpt-web-codex-net izoliacija. Sugeneruokite naudodami openssl rand -hex 32.
CHATGPT_WEB_CODEX_TUNNEL_ID	(nenustatyta)	open-sse/executors/chatgpt-web-codex.ts	Visuotinis OpenAI tunelio ID vietiniams Codex įrankių vykdymo ciklams.
CHATGPT_WEB_CODEX_RUNTIME_KEY	(nenustatyta)	open-sse/executors/chatgpt-web-codex.ts	Visuotinis tunelio vykdymo aplinkos raktas; niekada neįrašykite jo į žurnalus.
CHATGPT_WEB_CODEX_CONNECTOR_NAME	OmniRoute Codex v2	open-sse/executors/chatgpt-web-codex.ts	Tikslus naujai sukurto ChatGPT pasirinktinio jungiklio, skirto MCP tiltui, pavadinimas.
CODEX_CHATGPT_WEB_HOME	<DATA_DIR>/chatgpt-web-codex	open-sse/vendor/codex-chatgpt-web/config.ts	Specialus katalogas, skirtas naršyklės, tarpininko ir tunelio būsenai.
CODEX_CHATGPT_WEB_BROWSER_DIAGNOSTICS	0	open-sse/vendor/codex-chatgpt-web/adapters/chatgpt-web/browser-worker.ts	Nustačius 1, kiekviename kontroliniame taške užfiksuojami naršyklės diagnostikos vaizdai.
CODEX_CHATGPT_WEB_LAUNCHER	(nenustatyta)	open-sse/vendor/codex-chatgpt-web/config.ts	Pasirenkamas absoliutus kelias į nuolatinį paleidiklio dvejetainį failą.
CODEX_CHATGPT_WEB_BUN	(aptinkama automatiškai)	open-sse/vendor/codex-chatgpt-web/config.ts	Pasirenkamas absoliutus kelias į Bun vykdymo aplinkos dvejetainį failą.
CODEX_WEB_GPT_BUN	(nenustatyta)	open-sse/vendor/codex-chatgpt-web/config.ts	Senesnė atsarginė CODEX_CHATGPT_WEB_BUN reikšmė; naujos konfigūracijos naudoja kanoninį pavadinimą.

---

OmniConductor tiltas

Ilgaamžis SSE vartotojas, kuris atspindi OmniConductor centro užduotis vietinėje A2A TaskManager (src/lib/conductor/). Pasirenkama funkcija — tiltas paleidžiamas tik tada, kai nustatytas CONDUCTOR_HUB_URL. Tik serverio pusėje: centro prieigos raktas niekada neturi pasiekti naršyklės.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašas
CONDUCTOR_HUB_URL	(tuščia)	src/lib/conductor/boot.ts	Bazinis OmniConductor centro URL (pvz., http://127.0.0.1:7910). Nenustatyta = tiltas išjungtas.
CONDUCTOR_HUB_TOKEN	(tuščia)	src/lib/conductor/boot.ts	Centro kredencialas, skirtas SSE srautui — centre sukurkite spokesperson tipo lygiavertį mazgą (POST /v1/peers, administratorius).
CONDUCTOR_ORCHESTRATOR_TOKEN	(tuščia)	src/lib/conductor/hubProxy.ts	Kredencialas, skirtas gaunamų A2A→centras užduočių delegavimui (POST /v1/tasks); jei nenustatyta, naudojamas CONDUCTOR_HUB_TOKEN.
CONDUCTOR_SPOKESPERSON_URL	http://127.0.0.1:7920	src/lib/conductor/faroProxy.ts	Bazinis atstovo (Faro) paslaugos, veikiančios už valdymo skydelio pokalbių tarpinio serverio (/api/conductor/ask), URL.

Į kvotą atsižvelgiantis planavimas

Naudojama open-sse/services/combo.ts ir src/lib/quota/quotaScheduler.ts žetonų biudžetui patikrinti prieš užklausą. Pasirenkama funkcija — jei nenustatyta, numatytoji maršruto parinkimo elgsena nesikeičia.

Kintamasis	Numatytoji reikšmė	Šaltinio failas	Aprašas
OMNIROUTE_QUOTA_AWARE_ROUTING	0	open-sse/services/combo.ts	Kai nustatyta 1, prieš siunčiant užklausą praleidžiami ryšiai, kurių kiekvieno lango žetonų biudžeto (rateLimitOverrides.tpm, lentelė provider_quota_state) nepakanka apskaičiuotai užklausos kainai padengti. Jei biudžetas nesukonfigūruotas, leidžiama tęsti.