* feat(docs): mirror every docs/ page in all 65 locales Extends the documentation mirrors from the 22-page core set (#13940) to every Markdown page under docs/: 152 sources x 65 locales = 9,880 mirrors (6,208 new), language bars rewritten for the full locale list, state adopted so the blocking drift gate now covers all 152 pages. run-translation.mjs: an oversized block made only of table rows or list items (PROVIDER_REFERENCE.md 244-row table, FREE_TIERS.md 71-item list) is cut at item boundaries and rejoined without a blank line — the single 16-40 KB request outlived the backend socket for verbose scripts. 48 older mirrors whose tables had lost rows were retranslated with --force. * docs(i18n): refresh mirrors for the sources the base changed since the branch cut Section-level retranslation of the 29 docs (and README.md) whose source or mirrors moved on release/v3.8.51 during the run, then state adoption; the drift gate is green again on the merged tree.
635 KiB
Environment Variables Reference (Latviešu)
🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW
Pilnīga atsauce uz visiem OmniRoute atpazītajiem vides mainīgajiem. Ātrās sākšanas veidni skatiet failā
.env.example.
Important
Katram šeit dokumentētajam mainīgajam jābūt norādītam arī failā
.env.example, un katram failā.env.examplenorādītajam mainīgajam jābūt dokumentētam šeit.npm run check:env-doc-syncto pārbauda komita izveides laikā un CI vidē. Lai apzināti izlaistu kādu mainīgo, pievienojiet to atļauto vienumu sarakstam failāscripts/check/check-env-doc-sync.mjs.
Satura rādītājs
- 1. Obligātie noslēpumi
- 2. Krātuve un datubāze
- 3. Tīkls un porti
- 4. Drošība un autentifikācija
- 5. Ievades sanitizācija un PII aizsardzība
- 6. Rīku un maršrutēšanas politikas
- 7. URL un mākoņa sinhronizācija
- 8. Izejošais starpniekserveris
- 9. CLI rīku integrācija
- 10. Iekšējo aģentu un MCP integrācijas
- 11. OAuth nodrošinātāju akreditācijas dati
- 12. Nodrošinātāju User-Agent vērtību pārrakstīšana
- 13. CLI digitālnospieduma saderība
- 14. API atslēgu nodrošinātāji
- 15. Taimauta iestatījumi
- 16. Žurnalēšana
- 17. Atmiņas optimizācija
- 18. Cenu sinhronizācija
- 19. Modeļu sinhronizācija (izstrāde)
- 20. Nodrošinātājiem specifiski iestatījumi
- 21. Starpniekservera darbspēja
- 22. Atkļūdošana
- 23. GitHub integrācija
- 24. Prasmju smilškaste (v3.8.0+)
- 27. Radar plūsma (pašmitināšana)
- Izvietošanas scenāriji
- Audits: noņemtie / neizmantotie mainīgie
1. Obligātie noslēpumi
Tie obligāti jāiestata pirms pirmās palaišanas. Bez tiem lietojumprogramma vai nu atteiksies startēt, vai darbosies ar nedrošām noklusējuma vērtībām.
| Mainīgais | Obligāts | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|---|
JWT_SECRET |
Jā | (nav) | src/lib/auth |
Paraksta/pārbauda visus informācijas paneļa sesijas sīkfailus (JWT). Ģenerējiet ar openssl rand -base64 48. |
API_KEY_SECRET |
Jā | (nav) | src/lib/db/apiKeys.ts |
AES šifrēšanas atslēga API atslēgu vērtību šifrēšanai SQLite datubāzē. Ģenerējiet ar openssl rand -hex 32. |
INITIAL_PASSWORD |
Jā | CHANGEME |
Sākotnējās iestatīšanas skripts | Iestata sākotnējo administratora informācijas paneļa paroli (atbilst .env.example noklusējumam — tā ir apzināti nedroša, lai piespiestu to nomainīt). Nomainiet pirms pirmās lietošanas reizes. Pēc pieteikšanās nomainiet to sadaļā Informācijas panelis → Iestatījumi → Drošība. |
OMNIROUTE_WS_BRIDGE_SECRET |
Jā (produkcijā) | (nav iestatīts) | src/app/api/internal/codex-responses-ws/route.ts |
Koplietojams noslēpums iekšējam Codex Responses WebSocket tiltam. Autentificē tilta pieprasījumus starp Electron/pārlūkprogrammas WS retranslētāju un OmniRoute. ⚠️ OBLIGĀTS produkcijā — ja tas nav iestatīts, visi WS tilta pieprasījumi tiek noraidīti. Ģenerējiet ar openssl rand -base64 32. |
OMNIROUTE_SW_BUILD_ID |
Nē | (git SHA) | next.config.mjs, scripts/build/assembleStandalone.mjs |
Nepārprotams servisa darbinieka kešatmiņas apiešanas identifikators PWA čaulai (#11779); pirmais noteikšanas ķēdē. |
SOURCE_VERSION |
Nē | (nav iestatīts) | next.config.mjs, scripts/build/assembleStandalone.mjs |
Otrais ķēdē — to izvietošanas būvējuma kompilētāji (piemēram, Heroku tipa) iestata uz izvietotā komita vērtību. |
NEXT_PUBLIC_SW_BUILD_ID |
Nē | (atvasināts) | src/shared/components/PwaRegister.tsx |
Būvēšanas laikā noteikta publiska vērtība, ko klients izmanto, lai reģistrētu /sw.js?v=…; tā tiek atvasināta no abām iepriekš minētajām vērtībām un pēc tam no git SHA. |
OMNIROUTE_PEER_STAMP_TOKEN |
Nē (automātiski) | (automātiski katrā palaišanas reizē) | src/server/authz/policies/management.ts |
Katra procesa noslēpums, kas apliecina, ka uzticamais vienādranga IP zīmogs ir saņemts no paša OmniRoute HTTP servera (scripts/dev/peer-stamp.mjs). Autorizācijas starpprogrammatūra uzticas pieprasījuma lokālumam (LOCAL_ONLY maršrutu ierobežošana līdz atgriezeniskās cilpas/LAN savienojumiem) tikai tad, ja zīmogs ietver šo pilnvaru. Tas tiek automātiski ģenerēts katrā palaišanas reizē — atstājiet neiestatītu; fiksējiet to tikai vairāku procesu konfigurācijās, kurām zīmogs ir jākoplieto. |
Ģenerēšanas komandas
# Ģenerējiet visus četrus noslēpumus vienlaikus:
echo "JWT_SECRET=$(openssl rand -base64 48)"
echo "API_KEY_SECRET=$(openssl rand -hex 32)"
echo "INITIAL_PASSWORD=$(openssl rand -base64 16)"
echo "OMNIROUTE_WS_BRIDGE_SECRET=$(openssl rand -base64 32)"
Caution
Nekad neiekļaujiet
.envfailus ar īstiem noslēpumiem versiju kontroles sistēmā..gitignorejau izslēdz.env, taču pirms izmaiņu nosūtīšanas to pārbaudiet.
2. Krātuve un datubāze
OmniRoute visai pastāvīgajai datu glabāšanai izmanto SQLite (ar better-sqlite3). Šie mainīgie nosaka datu atrašanās vietu, šifrēšanu un dzīves ciklu.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
DATA_DIR |
~/.omniroute/ |
src/lib/db/core.ts |
SQLite datubāzes, dublējumkopiju un datu failu saknes direktorijs. Norādiet citu vērtību Docker sējumiem vai pielāgotiem ceļiem. |
OMNIROUTE_ALLOW_DEFAULT_DATA_DIR |
(nav iestatīts) | src/lib/dataPaths.ts |
Īpaša atkāpšanās iespēja testu/izvērtēšanas DATA_DIR aizsargmehānismam (#10428). Testi un Node izvērtēšanas/izvades pārbaudes (-e/--eval/-p/--print, tostarp --eval=/--print= formas), kuriem nav norādīts DATA_DIR, tiek novirzīti uz vienreizlietojamu pagaidu direktoriju, lai tie nevarētu atvērt operatora īsto datubāzi; iestatiet uz 1, lai atkal izmantotu īsto direktoriju. |
OMNIROUTE_BUILD_SHA |
(nav iestatīts) | src/lib/monitoring/buildSha.ts |
Darbināmā artefakta Git SHA. To pievieno npm run build:release; to var ievadīt konteineros, kas tiek piegādāti bez dist/BUILD_SHA kontrolfaila. Tas tiek parādīts kā system.buildSha galapunktā /api/monitoring/health. |
OMNIROUTE_RELEASE_REF |
origin/main |
scripts/build/buildProvenance.ts |
Atsauce, pret kuru artefakta pakošanas izcelsmes pārbaude pārbauda būvējuma SHA (#10427). |
OMNIROUTE_ALLOW_CANARY_BUILD |
(nav iestatīts) | scripts/build/buildProvenance.ts |
Iestatiet uz 1, lai atļautu pakot būvējumu, kura SHA neatrodas laidiena zarā, reģistrējot to kā apzinātu izmēģinājuma būvējumu, nevis pārtraucot pārbaudi ar kļūdu (#10427). |
OMNIROUTE_SMOKE_API_KEY |
(nav iestatīts) | scripts/ops/deploy-canary.mjs |
API atslēga izmēģinājuma izvietošanas ātrajai pārbaudei, kas uz /v1/chat/completions tiek nosūtīta kā Authorization: Bearer. To izmanto tikai izvietošanas skripts (#10429), bet nekad serveris. Tā nav saistīta ar izvēles CLI ātro pārbaužu ietvara OMNIROUTE_SMOKE_* mainīgajiem (RUN_CLI_SMOKE=1, OMNIROUTE_SMOKE_BASE_URL/MODEL/API_KEY_ENV/TARGETS/TIMEOUT_MS failā tests/integration/upstream-cli-smoke.int.test.ts) — skatiet CLI integrācijas → Reāla ātro pārbaužu izpilde. |
OMNIROUTE_BUILDING |
(nav iestatīts) | src/lib/buildPhase.ts |
Būvēšanas posma signāls (#10060): scripts/build/build-next-isolated.mjs to iestata uz 1, un to pārmanto katrs palaistais būvēšanas darbinieks, lai datubāzes slānis atgrieztu tukšas darbības aizstājēju, nevis ielādētu vietējo better-sqlite3 papildinājumu (kas, beidzot darbu, avarē darbinieku). Tas nekad netiek iestatīts darbībā esošajam serverim. |
OMNIROUTE_SKIP_NATIVE_DEP_CHECK |
0 |
scripts/check/check-native-deps.mjs |
Iestatiet uz 1, lai neparastiem piegādātāja iekļautiem kokiem izlaistu neobligāto vietējo atkarību pirmsbūvēšanas pārbaudi. Tas nepadara trūkstošu atkarību būvējamu; izmantojiet tikai tad, ja vietējās atkarības tiek nodrošinātas ārpus standarta procesa. |
OMNIROUTE_DATA_DIR |
(nav iestatīts) | open-sse/executors/promptql/threadSticky.ts |
Rezerves aizstājvārds mainīgajam DATA_DIR, kas tiek pārbaudīts tikai tad, ja DATA_DIR nav iestatīts. To izmanto, lai atrastu PromptQL izpildītāja diskā glabāto pavedienam piesaistīto sesiju kešatmiņu (<dir>/promptql-thread-sessions.json); ja nav iestatīts neviens no mainīgajiem, kešatmiņa paliek tikai atmiņā (tā netiek saglabāta starp restartēšanas reizēm). |
OMNIROUTE_PLUGINS_DIR |
(nav iestatīts) | src/lib/plugins/scanner.ts |
Direktorijs, kuru lasa izpildlaika spraudņu skeneris un kurā spraudņu pārvaldnieks instalē spraudņus, ignorējot no mājas direktorija atvasināto noklusējumu (#11827). Norādiet tam Docker/K8s piesaistīto spraudņu koku, nevis pārvietojiet HOME tikai tādēļ, lai mainītu skenēšanas ceļu (HOME nosaka arī visu pārējo ar mājas direktoriju saistīto darbību). Nav iestatīts = ~/.omniroute/plugins vai /tmp/.omniroute/plugins, ja process vispār neeksportē mājas direktoriju — šis mainīgais novērš kluso spraudņu neatrašanu. Atrisinātais direktorijs palaišanas laikā tiek vienreiz reģistrēts žurnālā kā scanner.dir_resolved kopā ar izmantoto ievadi. Tikai servera pusē: CLI komandu spraudņi turpina izmantot savu OMNIROUTE_PLUGIN_PATH (9. sadaļa). |
STORAGE_ENCRYPTION_KEY |
(tukšs = atspējots) | src/lib/db/encryption.ts |
AES atslēga pilnas SQLite datubāzes šifrēšanai miera stāvoklī. Ģenerējiet ar openssl rand -hex 32. |
STORAGE_ENCRYPTION_KEY_VERSION |
v1 |
scripts/build/bootstrap-env.mjs, electron/main.js |
Šifrēšanas atslēgas versijas apzīmējums. Palieliniet to, veicot atslēgas rotāciju, lai nodrošinātu veco dublējumkopiju atšifrēšanu. |
DISABLE_SQLITE_AUTO_BACKUP |
false |
src/lib/db/backup.ts |
Ja vērtība ir true, regulārās/pirmsrakstīšanas SQLite faila dublējumkopijas tiek izlaistas (models.dev cenu saglabāšana/notīrīšana, iestatījumu ierakstīšana). Manuālās un pirmsatjaunošanas dublējumkopijas joprojām tiek veidotas. Tas neatspējo migrāciju izpildītāja obligāto noturīgo drošības momentuzņēmumu vai masveida migrācijas aizsardzību esošai pastāvīgai DB. Nemanulālo dublējumkopiju izveide tiek ierobežota līdz ne vairāk kā vienai reizei 60 minūtēs. Informācijas paneļa sadaļā Iestatījumi → Krātuve regulāro automātisko dublēšanu var atspējot neatkarīgi. |
OMNIROUTE_CRYPT_KEY |
(nav iestatīts) | src/lib/db/encryption.ts |
STORAGE_ENCRYPTION_KEY mantotais aizstājvārds. Tiek pieņemts kā rezerves variants, ja primārā mainīgā nav. |
OMNIROUTE_API_KEY_BASE64 |
(nav iestatīts) | src/lib/db/encryption.ts |
Mantotais aizstājvārds (Base64 kodētā formā), kas tiek pieņemts kā rezerves variants. Pirms lietošanas tiek automātiski dekodēts. |
OMNIROUTE_DB_HEALTHCHECK_INTERVAL_MS |
(nav iestatīts) | src/lib/db/core.ts |
Pārraksta periodiskās SQLite darbspējas pārbaudes intervālu (ms). Ja nav iestatīts, noklusējuma vērtības tiek atvasinātas no NODE_ENV. |
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS |
21600000 (6 h) |
src/lib/db/walMaintenance.ts |
Pārraksta periodiskā wal_checkpoint(TRUNCATE) intervālu (ms). Automātiskā kontrolpunkta izveide nekad nesamazina paša WAL faila izmēru, un ilgstoši darbojošs serveris nekad neaizver savu DB. 0 atspējo. |
OMNIROUTE_WAL_PASSIVE_INTERVAL_MS |
300000 (5 min.) |
src/lib/db/walMaintenance.ts |
Pārraksta biežā wal_checkpoint(PASSIVE) intervālu (ms). Uztur neapstrādāto WAL kadru skaitu mazu, lai periodiskā TRUNCATE operācija galvenajā pavedienā nekad nekopētu vairāku GB uzkrājumu. 0 atspējo. |
OMNIROUTE_WAL_GUARD_MAX_MB |
256 |
src/lib/db/walMaintenance.ts |
Ja PASSIVE cikls konstatē, ka WAL fails pārsniedz šo izmēru, nekavējoties pāriet uz wal_checkpoint(TRUNCATE), nevis gaida lēno ciklu. |
OMNIROUTE_PRESSURE_SELF_RESTART |
false |
open-sse/utils/resourcePressure.ts |
Iestatiet uz 1/true/yes/on, lai izbeigtu procesu pēc tam, kad kritisks resursu noslogojums ir saglabājies OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS ilgi, ļaujot pārraugam (systemd Restart=always, Docker restartēšanas politikai) palaist tīru procesu, nevis bezgalīgi atgriezt 503 atbildes. |
OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS |
120000 (2 min.) |
open-sse/utils/resourcePressure.ts |
Cik ilgi kritiskajam noslogojumam jāsaglabājas, pirms tiek aktivizēta iziešana pašrestartēšanas nolūkā. |
OMNIROUTE_SQLJS_WASM_PATH |
(automātiska noteikšana) | src/lib/db/adapters/sqljsAdapter.ts |
Skaidri norādīts ceļš (absolūts vai relatīvs pret cwd) uz sql-wasm.wasm, izmantojot sql.js WASM rezerves adapteri. Ja nav iestatīts, tas tiek automātiski noteikts, izmantojot pakotņu atkarības un iespējamos izkārtojumus. |
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS |
21600000 (6 h) |
src/lib/db/core.ts |
Pārraksta periodiskā wal_checkpoint(TRUNCATE) intervālu (ms). Automātiskā kontrolpunkta izveide nekad nesamazina paša WAL faila izmēru, un ilgstoši darbojošs serveris nekad neaizver savu DB. 0 atspējo. |
OMNIROUTE_BATCH_RETENTION_DAYS |
30 |
src/lib/db/cleanup.ts |
Dienu skaits, cik ilgi pabeigta (completed/failed/cancelled/expired) Batch API uzdevuma kontrolpunkti, atsauču ievades/izvades/kļūdu faili un rinda tiek glabāti pirms dzēšanas, ko veic automātiskā tīrīšana. Stājas spēkā tikai tad, kad ir ieslēgts BATCH_AND_FILE_AUTO_CLEANUP_ENABLED; atbilst paša OpenAI Batch API izvades saglabāšanas periodam. Neietekmē operatora aktivizēto maršrutu DELETE /api/v1/batches/delete-completed, kas pēc konstrukcijas paliek beznosacījuma (bez vecuma filtra). |
BATCH_AND_FILE_AUTO_CLEANUP_ENABLED |
false |
src/lib/db/cleanup.ts |
Ja vērtība ir true, automātiskās tīrīšanas process drīkst dzēst pabeigtos Batch API darbus (un to kontrolpunktus), kas ir vecāki par OMNIROUTE_BATCH_RETENTION_DAYS, kā arī notīrīt augšupielādēto failu BLOB saturu pēc to expires_at termiņa beigām. Pēc noklusējuma izslēgts: ikvienā esošajā instalācijā šie dati tiek saglabāti tieši tāpat kā iepriekš, līdz operators šo funkciju iespējo. Tas ir arī informācijas panelī rediģējams funkcijas karogs — skatiet docs/reference/FEATURE_FLAGS.md → Izpildlaiks. |
OMNIROUTE_SKIP_DB_HEALTHCHECK |
0 |
src/lib/db/core.ts, src/lib/db/healthCheck.ts |
Iestatiet uz 1, lai palaišanas laikā pilnībā izlaistu DB darbspējas pārbaudi. Noder īslaicīgiem uzdevumiem un integrācijas testiem. |
OMNIROUTE_FORCE_DB_HEALTHCHECK |
0 |
src/lib/db/core.ts |
Iestatiet uz 1, lai piespiedu kārtā iespējotu DB darbspējas pārbaudes ciklu pat tad, ja parasti tas tiktu izlaists (piem., īslaicīgiem uzdevumiem). |
OMNIROUTE_SKIP_POSTINSTALL |
0 |
scripts/postinstall.mjs |
Iestatiet uz 1, lai npm install laikā izlaistu vietējās izpildvides iesildīšanu. Noder CI/bezgalvas instalācijās, kur sqlite jau ir kompilēts. |
OMNIROUTE_MIGRATIONS_DIR |
(automātiska noteikšana) | src/lib/db/migrationRunner.ts |
Norādiet citu direktoriju, ko skenē migrāciju izpildītājs. Noder, ja pielāgotos būvējumos tiek piegādātas komplektā iekļautas migrācijas. |
OMNIROUTE_EXTRA_MIGRATIONS_DIRS |
(nav iestatīts) | src/lib/db/migrationRunner/extraDirs.ts |
Papildu migrāciju direktoriji kā namespace=dir ieraksti, kas atdalīti ar platformas ceļu atdalītāju (piem., ee=/opt/app/enterprise/db/migrations). Tajos atrastie faili tiek reģistrēti kā <namespace>-<number>, tādēļ distribūcija, kas piegādā savas migrācijas, nekad nekonfliktē ar augšupstraumes skaitliskajām pozīcijām. Nepareizi veidots ieraksts, nederīga nosaukumvieta vai neesošs direktorijs palaišanas laikā izraisa kļūdu, nevis klusi izlaiž shēmu. |
OMNIROUTE_MAX_PENDING_MIGRATIONS |
50 |
src/lib/db/migrationRunner.ts |
Drošības slieksnis lielam neizpildīto migrāciju skaitam (#3416). Palaišana tiek pārtraukta, ja esošā DB gaida vairāk migrāciju par šo skaitu (aizsardzība pret notīrītu uzskaites tabulu). Palieliniet to, lai atjaunotu vecāku dublējumu; iestatiet uz 0, lai atspējotu pārbaudi. |
OMNIROUTE_INSTALL_UPGRADE_WORKDIR |
(<repo>/.install-upgrade) |
scripts/check/check-install-upgrade.mjs |
Darba direktorijs check:install-upgrade laidiena kontroles posmam. Tam nepieciešami aptuveni 12 GB (divi ~3 GB instalācijas koki un tar arhīvs), tādēļ to nedrīkst palaist mazā tmpfs — pašmitinātajā izpildītājā /tmp ir 12 GB RAM atbalstīts tmpfs, un kontroles posms to izsmēla, saīsinot pakotni. |
OMNIROUTE_SPEND_FLUSH_INTERVAL_MS |
(noklusējums kodā) | src/lib/spend/batchWriter.ts |
Buferizētā tēriņu/izmaksu rakstītāja iztukšošanas intervāls (ms). Mazākas vērtības samazina rakstīšanas darbību apvienošanu; lielākas vērtības samazina DB noslodzi. |
OMNIROUTE_SPEND_MAX_BUFFER_SIZE |
(noklusējums kodā) | src/lib/spend/batchWriter.ts |
Maksimālais buferēto tēriņu ierakstu skaits pirms piespiedu iztukšošanas. Palieliniet izvietojumos ar lielu QPS; samaziniet, ja ierobežots atmiņas patēriņš ir svarīgāks. |
OMNIROUTE_PROXY_FETCH_DEBUG |
(nav iestatīts) | open-sse/utils/proxyFetch.ts |
Iestatiet uz "true", lai Vercel releja ceļā izvadītu [ProxyFetch] atkļūdošanas žurnālus. Pēc noklusējuma izslēgts, lai neizpaustu maršrutēšanas norādes. |
PROXY_LOG_INCLUDE_IPS |
false |
src/lib/proxyLogger.ts |
Iestatiet uz "true" vai "1", lai detalizētajā [ProxyEgress] procesa žurnāla rindā iekļautu klienta/izejošās IP adreses un konta prefiksu. Pēc noklusējuma atstāts IZSLĒGTS, lai procesa žurnāls neizpaustu IP adreses vai konta prefiksu. |
OMNIROUTE_DEBUG |
(nav iestatīts) | bin/cli/commands/quota.mjs |
Iestatiet uz 1, lai no CLI kvotu komandām stderr izvadē drukātu katra pieprasījuma laika diagnostiku ([omniroute] GET <path> completed in Nms). |
OMNIROUTE_HEALTHCHECK_PATH |
(automātiski) | scripts/dev/healthcheck.mjs |
Konteinera darbspējas pārbaudes laikā pārbaudāmais konkrētais ceļš. Ja nav iestatīts, pārbaude to atvasina no OMNIROUTE_BASE_PATH; tā iestatīšana atkārtoti iespējo padziļinātās pārraudzības galapunktu. |
OMNIROUTE_DEBUG_COMPLETION |
(nav iestatīts) | bin/cli/commands/completion.mjs |
Iestatiet jebkuru netukšu vērtību, lai no CLI čaulas pabeigšanas kešatmiņas ceļiem (lasīšana/atsvaidzināšana/rakstīšana) izvadītu [omniroute completion] diagnostiku. Pēc noklusējuma izslēgts — šo kešatmiņu kļūmes notiek bez paziņojuma, lai trūkstoša/bojāta kešatmiņa nekad netraucētu pabeigšanu ar tabulēšanas taustiņu. |
BATCH_RETRY_DURATION_MS |
86400000 (24 h) |
open-sse/services/batchProcessor.ts |
Maksimālais atkārtotu mēģinājumu periods atsevišķiem paketes elementiem (ms). Elementi, kas pārsniedz šo periodu, tiek atzīmēti kā neizdevušies. |
BATCH_BACKOFF_BASE_MS |
5000 |
open-sse/services/batchProcessor.ts |
Pamata aizkave (ms) eksponenciālajai nogaidīšanai, atkārtoti mēģinot apstrādāt paketes elementus. |
BATCH_BACKOFF_MAX_MS |
3600000 (1 h) |
open-sse/services/batchProcessor.ts |
Eksponenciālās nogaidīšanas maksimālā robeža (ms) starp paketes elementu atkārtotas apstrādes mēģinājumiem. |
BATCH_MAX_CONCURRENT |
1 |
open-sse/services/batchProcessor.ts |
Maksimālais vienlaikus apstrādājamo pakešu skaits. Palieliniet, lai uzlabotu caurlaidspēju; saglabājiet zemu vērtību, lai izvairītos no masveida pieprasījumu biežuma ierobežojumu sasniegšanas. |
Important
Pirms esošas pastāvīgās datubāzes mainīšanas migrācijas izpildītājs direktorijā
DATA_DIR/db_backups/publicē pilnīgu, pēc satura adresētu momentuzņēmumu. Publicēšanai ir nepieciešama failu sistēma, kas atbalsta tajā pašā failu sistēmā izveidotas, bez pārrakstīšanas cietās saites, kā arī noturīgu failu sinhronizāciju. POSIX resursdatoriem ir nepieciešama arī direktoriju sinhronizācija; operētājsistēmā Windows Node var noraidīt direktoriju turus, tāpēc OmniRoute iztukšo publicētā faila buferi un direktorija ieraksta sinhronizāciju veic, cik iespējams. Ja montētaisDATA_DIRnevar nodrošināt šīs garantijas, palaišana tiek droši pārtraukta pirms migrācijas piemērošanas. PārvietojietDATA_DIRuz sējumu, kas atbalsta šos mehānismus; neizmantojietDISABLE_SQLITE_AUTO_BACKUP, lai apietu migrācijas drošības prasības.
Scenāriji
| Scenārijs | Konfigurācija |
|---|---|
| Lokālā izstrāde | Atstājiet visas noklusējuma vērtības. DB atrodas ~/.omniroute/omniroute.db. |
| Docker | DATA_DIR=/data + montējiet sējumu pie /data. |
| Šifrēts miera stāvoklī | Iestatiet STORAGE_ENCRYPTION_KEY + glabājiet atslēgas dublējumkopijas! Tās zaudēšana = datu zaudēšana. |
| CI/Testēšana | DATA_DIR=/tmp/omniroute-test — īslaicīgs, šifrēšana nav nepieciešama. |
3. Tīkls un porti
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
PORT |
20128 |
src/lib/runtime/ports.ts |
Galvenais ports gan informācijas paneļa lietotāja saskarnei, gan API galapunktiem (viena porta režīmā). |
OMNIROUTE_BASE_PATH |
(tukšs = sakne) | next.config.mjs, scripts/docker/ensure-docker-base-path.mjs |
URL apakšceļš OmniRoute apkalpošanai aiz reversā starpniekservera (iestata Next.js basePath; autentifikācijas novirzīšanā tiek ņemts vērā basePath). Piemēram, /omniroute. Docker vidē vērtība tiek iekļauta docker build laikā (ARG OMNIROUTE_BASE_PATH); iepriekš izveidotiem saknes attēliem citu izpildlaika vērtību var lietot vienreiz konteinera palaišanas brīdī, pirms tiek startēts Next.js. Iestatiet NEXT_PUBLIC_BASE_URL uz publisko izcelsmes adresi, iekļaujot to pašu apakšceļu. |
NEXT_PUBLIC_OMNIROUTE_BASE_PATH |
(tukšs = sakne) | src/shared/hooks/useDisplayBaseUrl.ts |
Pārlūkā redzams OMNIROUTE_BASE_PATH spoguļattēls, kas būvēšanas laikā tiek iegults, lai informācijas paneļa galapunkta attēlojumā būtu redzams https://host/omniroute/v1, nevis https://host/v1. Ja nav iestatīts, izmanto OMNIROUTE_BASE_PATH. Pēc izmaiņām veiciet atkārtotu būvēšanu (Next basePath tiek noteikts būvēšanas laikā). |
DASHBOARD_ALLOW_EMBED |
(nav iestatīts = nekad nevar ievietot ietvarā) | next.config.mjs, scripts/build/dashboardEmbed.mjs |
Izvēles iespēja HTML lapu iegulšanai iframe. Ja nav iestatīts, katrs maršruts tiek piegādāts ar frame-ancestors 'none' + X-Frame-Options: DENY. Iestatiet uz vscode, lai lapas (informācijas paneli, pieteikšanos, dokumentāciju, sākumlapu) apkalpotu ar frame-ancestors 'self' vscode-webview: un bez X-Frame-Options, tādējādi VS Code Simple Browser varētu tās atveidot (OmniCopilot režīms dashboardOpen: "editor"). API virsma (/api, /v1, /v1beta, /a2a, /healthz, saknes līmeņa aizstājvārdi) jebkurā gadījumā saglabā stingrās galvenes. Tiek atpazīts tikai vscode — 1/true to neiespējo. Būvēšanas laika iestatījums: pēc izmaiņām veiciet atkārtotu būvēšanu (docker build --build-arg DASHBOARD_ALLOW_EMBED=vscode attēliem; tā iestatīšana iepriekš izveidotā instalācijā neko neietekmē). |
API_PORT |
(nav iestatīts) | src/lib/runtime/ports.ts |
Ja iestatīts, apkalpo /v1/* starpniekservera API šajā atsevišķajā portā. |
API_HOST |
0.0.0.0 |
src/lib/runtime/ports.ts |
API porta piesaistes adrese. |
DASHBOARD_PORT |
(nav iestatīts) | src/lib/runtime/ports.ts |
Ja iestatīts, apkalpo informācijas paneļa lietotāja saskarni šajā atsevišķajā portā. |
OMNI_MAX_CONCURRENT_CONNECTIONS |
0 (atspējots) |
src/sse/utils/backpressure.ts |
Ierobežo vienlaicīgo aktīvo tērzēšanas savienojumu skaitu; pieprasījumi virs ierobežojuma saņem 503 ar Retry-After. Pozitīvs vesels skaitlis iespējo aizsardzību; neiestatīta vērtība/0 to atspējo. |
OMNIROUTE_INSTANCE_ID |
(nav iestatīts) | src/shared/resilience/peerRouting.ts |
Stabils un unikāls šīs vārtejas ID, savienojot OmniRoute instances ķēdē. Iespējo ienākošo vienādranga cilpu pārbaudes. Atļautās rakstzīmes: burti, cipari, ., _, : un -; ne vairāk kā 64 rakstzīmes. |
OMNIROUTE_PEER_URLS |
(nav iestatīts) | src/shared/resilience/peerRouting.ts, open-sse/executors/base.ts |
Ar komatiem atdalīti OmniRoute bāzes URL, kas var saņemt X-OmniRoute-Peer-Trace. Vienādranga metadatus saņem tikai nepārprotami atļauto resursu sarakstā iekļautie augšupstraumes URL; visi pārējie pakalpojumu sniedzēji netiek ietekmēti. |
OMNIROUTE_PEER_MAX_HOPS |
4 |
src/shared/resilience/peerRouting.ts |
Maksimālais iepriekš apmeklēto OmniRoute instanču skaits, kas tiek pieņemts ķēdētā pieprasījumā (1–32). Atkārtotas instances vai izsmelts limits atgriež HTTP 508 Loop Detected. |
PROD_DASHBOARD_PORT |
20130 |
docker-compose.prod.yml |
Resursdatora pusē publicētais informācijas paneļa ports Docker produkcijas režīmā. |
PROD_API_PORT |
20131 |
docker-compose.prod.yml |
Resursdatora pusē publicētais API ports Docker produkcijas režīmā. |
OMNIROUTE_PORT |
(nav iestatīts) | src/lib/runtime/ports.ts |
Darbojoties Electron vai citās ietverošajās lietotnēs, tam ir prioritāte pār PORT. |
LIVE_WS_PORT |
20129 |
src/server/ws/liveServer.ts |
Reāllaika WebSocket uzraudzības servera ports. |
LIVE_WS_HOST |
127.0.0.1 |
src/server/ws/liveServer.ts |
Reāllaika WebSocket servera piesaistes adrese. Iestatiet uz 0.0.0.0, lai padarītu to pieejamu LAN tīklā (konfigurējiet arī LIVE_WS_ALLOWED_ORIGINS). |
LIVE_WS_ALLOWED_ORIGINS |
(nav iestatīts) | src/server/ws/liveServer.ts |
Ar komatiem atdalītas papildu izcelsmes vietas, kurām atļauts atvērt reāllaika WebSocket savienojumu. Atgriezeniskās cilpas informācijas paneļa izcelsmes vietas jau ir atļautas pēc noklusējuma. |
LIVE_WS_ALLOWED_HOSTS |
(nav iestatīts) | src/server/ws/liveServerAllowList.ts |
Ar komatiem atdalīti papildu resursdatoru nosaukumi, kas atļauti reāllaika WebSocket izcelsmes vietām. Atšķirībā no LIVE_WS_ALLOWED_ORIGINS (pilniem izcelsmes vietu URL) tiek salīdzināta tikai resursdatora daļa — noderīgi LAN/Tailscale konfigurācijām. |
NEXT_PUBLIC_LIVE_WS_PUBLIC_URL |
(nav iestatīts) | src/hooks/useLiveDashboard.ts |
Reāllaika informācijas paneļa WebSocket publiskais URL (pārlūkprogrammas pusē). Iestatiet, ja WS serveris tiek izvietots aiz reversā starpniekservera vai Cloudflare Tunnel (piemēram, wss://ws.my-ai.com/live-ws); pārlūkprogramma izveidos savienojumu ar šo adresi, nevis ws://hostname:20132. Ceļa daļa tiek izmantota arī kā WebSocket jaunināšanas ceļš (noklusējums: /live-ws). |
OMNIROUTE_ENABLE_LIVE_WS |
true |
src/server/ws/liveServer.ts un scripts/start-ws-server.mjs |
Iestatiet uz 0 vai false, lai atspējotu reāllaika WebSocket serveri (pēc noklusējuma iespējots un piesaistīts atgriezeniskās cilpas adresei). CI/testēšanas ietvara slēdzis, kas atspējo savrupo reāllaika WebSocket palīgskriptu. |
RELAY_IP_PER_MINUTE |
30 |
src/app/api/v1/relay/chat/completions/route.ts |
Releja ātruma ierobežojums katram (marķiera, IP) pārim, pieprasījumi minūtē. Atmiņā glabāts, katrai instancei atsevišķs. 0 vai negatīva vērtība atspējo IP dimensijas ierobežojumu (katra marķiera datubāzes ierobežojums joprojām ir spēkā). |
NODE_ENV |
production |
Next.js kodols | Kontrolē žurnalēšanas detalizācijas līmeni, kešatmiņu, kļūdu informācijas atklāšanu un Next.js optimizācijas. |
OMNIROUTE_USE_TURBOPACK |
1 (Turbopack — noklusējums kodā) |
package.json / Next.js 16 |
Turbopack ir noklusējuma komplektētājs komandām npm run dev un npm run build (saskaņā ar veiktspējas testiem būvējumi ir 2–3× ātrāki). Iestatiet uz 0, lai Windows vidē pārslēgtos atpakaļ uz webpack, ja rodas vietējo saistījumu / komplektētāja saderības problēmas, vai datoros ar ierobežotu RAM apjomu — ir zināms, ka Turbopack produkcijas būvējumi šajā Next.js versiju līnijā (16.2.x) lielos moduļu grafos sasniedz daudz lielāku maksimālo atmiņas patēriņu nekā webpack (Next 16.3 Turbopack atmiņas atbrīvošanas labojums vēl nav stabils); izmantojot webpack kā rezerves variantu, maksimālais patēriņš ir daudz mazāks. Skatiet #6409. |
OMNIROUTE_SKIP_DB_HEALTHCHECK |
(nav iestatīts) | src/lib/db/core.ts / src/lib/db/healthCheck.ts |
Iestatiet uz 1, lai palaišanas laikā izlaistu SQLite integritātes veselības pārbaudi. Noder ātrākai palaišanai ar lielām datubāzēm. |
NOTIFY_SOCKET |
(nav iestatīts) | systemd (sd_notify protokols) | To iestata systemd, kad process darbojas pakalpojuma vienībā ar sd_notify integrāciju; OmniRoute to nolasa (skatiet OMNIROUTE_DISABLE_SD_NOTIFY), lai nosūtītu READY/WATCHDOG paziņojumus. Lietotājs to nekad neiestata. |
OMNIROUTE_DISABLE_SD_NOTIFY |
(nav iestatīts) | scripts/dev/systemd-notify.mjs |
Iestatiet uz 1, lai atspējotu systemd sd_notify (Type=notify / WatchdogSec=) pat tad, ja process darbojas systemd vienībā. Ārpus systemd paziņotājs jebkurā gadījumā neveic nekādas darbības. |
CREDENTIAL_HEALTH_CHECK_INTERVAL |
300000 |
open-sse/config/constants.ts / src/lib/credentialHealth/scheduler.ts |
Fona akreditācijas datu veselības pārbaudes plānotāja intervāls (ms). Minimums: 10000 (10 s). |
CREDENTIAL_HEALTH_CACHE_TTL |
300000 |
open-sse/config/constants.ts / src/lib/credentialHealth/cache.ts |
Kešatmiņā saglabātā akreditācijas datu veselības statusa TTL (ms). |
OMNIROUTE_DISABLE_CREDENTIAL_HEALTH_CHECK |
false |
src/lib/credentialHealth/scheduler.ts |
Iestatiet uz 1 vai true, lai atspējotu periodisku pakalpojumu sniedzēju savienojumu testēšanu fonā. Meklēšanas pakalpojumu sniedzēji (SEARCH_VALIDATOR_CONFIGS failā src/lib/providers/validation/searchProviders.ts, piemēram, tavily-search) vienmēr tiek izslēgti no pārbaudes — to „validācija” ir reāls maksas vaicājums augšupējam pakalpojumam, tāpēc tiem nekad netiek veiktas veselības pārbaudes pēc taimera (#9970). |
HOST |
0.0.0.0 |
scripts/dev/run-next.mjs |
Next.js izstrādes/palaišanas servera piesaistes adrese. Ja iestatīta, aizstāj noklusējuma vērtību 0.0.0.0. |
HOSTNAME |
127.0.0.1 |
scripts/dev/run-next-playwright.mjs |
Piesaistes adrese, ko izmanto Playwright izpildītājs, palaižot Next.js. Hermētiskiem testiem noklusējuma vērtība ir 127.0.0.1. Neizmantojiet komandai omniroute serve — tās vietā izmantojiet OMNIROUTE_SERVER_HOST (POSIX čaulas automātiski iestata HOSTNAME kā datora nosaukumu; .env to nevar pārrakstīt). |
OMNIROUTE_SERVER_HOST |
0.0.0.0 |
bin/cli/commands/serve.mjs |
Piesaistes adrese komandai omniroute serve. Novērš konfliktu ar POSIX čaulas mainīgo HOSTNAME (bash/zsh to vienmēr iestata kā datora nosaukumu). Ja nav iestatīts, tiek izmantota rezerves vērtība 0.0.0.0. (#6194) |
Portu režīmi
┌────────────────────────── Viens ports (noklusējums) ───────────────────────┐
│ PORT=20128 │
│ → Vadības panelis: http://localhost:20128 │
│ → API: http://localhost:20128/v1/chat/completions │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────── Atsevišķi porti ─────────────────────────────────┐
│ DASHBOARD_PORT=20128 │
│ API_PORT=20129 │
│ API_HOST=0.0.0.0 │
│ → Vadības panelis: http://localhost:20128 │
│ → API: http://0.0.0.0:20129/v1/chat/completions │
│ Pielietojums: API pieejams LAN, bet vadības panelis — tikai localhost. │
└─────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────── Docker ražošanas vide ─────────────────────────────┐
│ PROD_DASHBOARD_PORT=443 PROD_API_PORT=8443 │
│ → Konteinera portus kartē uz resursdatora portiem docker-compose.prod.yml.│
└─────────────────────────────────────────────────────────────────────────────┘
4. Drošība un autentifikācija
| Mainīgais | Noklusējuma vērtība | Avota fails | Apraksts |
|---|---|---|---|
MACHINE_ID_SALT |
endpoint-proxy-salt |
src/lib/auth |
Sāls, kas tiek kombinēts ar aparatūras identifikatoriem, lai izveidotu ierīces digitālo nospiedumu. Izolācijas nolūkā mainiet to katrai izvietošanas videi. |
OMNIROUTE_CLI_SALT |
(nav iestatīts = nejaušs katras instalācijas sāls, kas tiek pastāvīgi glabāts failā <DATA_DIR>/cli-token-salt.json) |
src/lib/machineToken.ts |
HMAC sāls lokālā CLI autentifikācijas marķiera atvasināšanai. Iestatot šo vērtību, tiek nomainīti visi ierīces CLI marķieri, un tai vienmēr ir prioritāte pār pastāvīgi saglabāto sāli. Skatiet docs/security/CLI_TOKEN.md. |
AUTH_COOKIE_SECURE |
false |
src/lib/auth |
Sesijas sīkfailiem iestata karogu Secure. Darbojoties aiz HTTPS, šai vērtībai jābūt true. |
REQUIRE_API_KEY |
false |
API starpprogrammatūra | Ja vērtība ir true, visos /v1/* starpniekservera pieprasījumos jāiekļauj derīga API atslēga. |
ALLOW_API_KEY_REVEAL |
false |
src/shared/constants/featureFlagDefinitions.ts |
Ļauj informācijas paneļa lietotāja saskarnē atklāt pilnas API atslēgu vērtības. Konfigurējams informācijas paneļa funkciju karogu sadaļā; koplietojamās instancēs rada drošības risku. |
NO_LOG_API_KEY_IDS |
(tukšs) | src/lib/compliance/index.ts |
Ar komatiem atdalīti API atslēgu ID, kuriem netiek veikta pieprasījumu reģistrēšana (atbilstībai VDAR). |
DEFAULT_RATE_LIMIT_PER_DAY |
(nav iestatīts = neierobežots) | src/shared/utils/apiKeyPolicy.ts |
Rezerves dienas pieprasījumu budžets, kas tiek piemērots API atslēgām, kuru kolonnas rate_limits vērtība ir null. Nav iestatīts vai ir tukšs: nav netieša ierobežojuma (#2289, #11017). 0 nozīmē to pašu (neierobežots). Pozitīvs vesels skaitlis N iespējo N/dienā, 5N/nedēļā, 20N/mēnesī. Nepareizi formatētām vērtībām, kas nav tukšas, tiek izmantoti mantotie ierobežojumi: 1000/dienā, 5000/nedēļā, 20000/mēnesī. |
MAX_BODY_SIZE_BYTES |
10485760 (10 MB) |
src/shared/middleware/bodySizeGuard.ts |
Maksimālais atļautais pieprasījuma pamatteksta lielums. Noraida lietderīgās slodzes, kas pārsniedz šo ierobežojumu. |
OMNIROUTE_CHAT_LARGE_BODY_BYTES |
262144 (256 KB) |
src/shared/middleware/chatBodyAdmission.ts |
Faktiskie pieprasījumu pamatteksti, kuru lielums sasniedz vai pārsniedz šo slieksni, pirms JSON parsēšanas iegūst atomāro procesa lokālo resursietilpīgās uzņemšanas nomu (BYTE ceļš, tostarp POST /v1/responses). Tā pati #10437 atkāpe pietiekamas brīvās kapacitātes gadījumā kā struktūras ziņā apjomīgiem pieprasījumiem; to joprojām ierobežo OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110, lai neatkārtotos #7849. |
OMNIROUTE_CHAT_HARD_MAX_BODY_BYTES |
52428800 (50 MB) |
src/shared/middleware/chatBodyAdmission.ts |
Tērzēšanas maršruta absolūtais ierobežojums, kas tiek piemērots ierobežotas ievades laikā nolasīto baitu skaitam, tostarp pieprasījumiem ar trūkstošu, nederīgu vai nepatiesu Content-Length; pārsniegšanas gadījumā tiek atgriezts 413. |
OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT |
(nav iestatīts — nav pieprasījumu skaita ierobežojuma) | src/shared/middleware/chatBodyAdmission.ts |
#503-fanout: šis mantotais pieprasījumu SKAITA ierobežojums tagad tiek piemērots tikai tad, ja tas ir skaidri iestatīts. Ja tas nav iestatīts (noklusējums), smagsvara tērzēšanas pieprasījumu uzņemšanu tā vietā ierobežo OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES — automātiski atvasināts BAITU budžets, kura lielumu nosaka procesa reālais atmiņas ierobežojums vienā procesā (vienā V8 kaudzē). Divi vienlaicīgi ~750k tokenu /v1/responses pieprasījumi avarē ~12 Gi kaudzes (#7849) — tas ir atmiņas budžeta brīdinājums, nevis stingrs produkta maksimums 2. Vesels process (kaudze zem atmešanas attiecības) VAR uzņemt vairāk vienlaicīgu ilgu /v1/responses pieprasījumu, izmantojot OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM. Desmitiem ilgu SSE klientu (40–50) ierobežojumu nosaka kaudze + OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110, nevis “maksimums 2”. Akli palielinot šo vērtību, lai “izmantotu resursdatoru”, atkal tiek ieviesta #7849 problēma. Vairojiet kaudzes, izmantojot N neatkarīgus DATA_DIR (#11024); nekad neizmantojiet replicas>1 vienam SQLite failam. |
OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES |
(automātiski atvasināts) | src/shared/middleware/admissionBudget.ts |
#503-fanout: automātiski atvasinātā ievades baitu budžeta ignorēšana (25% no stingrākā V8/cgroup atmiņas ierobežojuma, dalīti ar 8x pārejošās amplifikācijas koeficientu). Atvasinātās un tieši norādītās vērtības tiek ierobežotas diapazonā no 8 MiB līdz 2 GiB. Pamatteksts, kas pārsniedz faktisko budžetu, nekavējoties izraisa 413 body_exceeds_budget; konkurence starp atsevišķi apkalpojamiem pamattekstiem joprojām izraisa atkārtojamu 503. 40–50 vienlaicīgu ilgu SSE klientu ierobežojumu nosaka šis budžets + kaudze, nevis stingrs “maksimums 2”. Pirms pielāgošanas skatiet chatAdmission.maxInflightBytes / budgetSource / pressureSeverity adresē /api/monitoring/health. |
OMNIROUTE_CHAT_ADMISSION_HEAP_SHED_RATIO |
0.75 |
src/shared/middleware/chatBodyAdmission.ts |
Kaudzes spiediena atmešanas attiecība (heapUsed / heap_size_limit) BAITU un STRUKTŪRAS smagsvara pieprasījumu uzņemšanai (#10183, #10268, #10437). Vienlaicīgs smagsvara pieprasījums, kas pārsniedz OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT, tiek atmests ar atkārtojamo 503 tikai tad, ja kaudze ARĪ ir sasniegusi vai pārsniegusi šo attiecību; ja kaudze ir vesela, tas tiek uzņemts, izmantojot veselās kaudzes rezerves kapacitāti. |
OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM |
OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT (noklusējums 1) |
src/shared/middleware/chatBodyAdmission.ts |
Ierobežota papildu kapacitāte veselās kaudzes ātrajam ceļam (#10437) gan STRUKTŪRAS, gan BAITU gadījumā (admitChatRequest, tostarp pamattekstiem ≥ OMNIROUTE_CHAT_LARGE_BODY_BYTES). Bez šī ierobežojuma katrs pieprasījums, kas saņemts noslodzes laikā, bet pie veselas kaudzes, apietu uzņemšanas kontroli bez jebkādas augšējās robežas. Tiklīdz veselās kaudzes ceļā ir aktīvs šāds vienlaicīgu nomu skaits, turpmāki noslodzes laikā saņemtie pieprasījumi pāriet uz TO PAŠU ierobežotas gaidīšanas/atmešanas ceļu, kas tiek izmantots reāla kaudzes spiediena apstākļos. 0 pilnībā atspējo apiešanu. |
OMNIROUTE_CHAT_HEAVY_MESSAGE_COUNT |
200 |
src/shared/middleware/chatBodyAdmission.ts |
Ziņojumu skaits, pie kura tērzēšanas pieprasījums tiek klasificēts kā smagsvara pieprasījums pat tad, ja tā pamatteksts ir mazāks par baitu slieksni. |
OMNIROUTE_CHAT_HEAVY_TOOL_COUNT |
64 |
src/shared/middleware/chatBodyAdmission.ts |
Rīku skaits, pie kura tērzēšanas pieprasījums tiek klasificēts kā smagsvara pieprasījums pat tad, ja tā pamatteksts ir mazāks par baitu slieksni. |
OMNIROUTE_CHAT_HEAVY_ESTIMATED_TOKENS |
32000 |
src/shared/middleware/chatBodyAdmission.ts |
Konservatīvs uz virknes lielumu balstīts tokenu aprēķins, pēc kura pieprasījums tiek klasificēts kā smagsvara pieprasījums; tas ir uzņemšanas izmaksu aizstājējrādītājs, nevis pakalpojuma sniedzēja norēķinu tokenizācija. |
OMNIROUTE_CHAT_HARD_MAX_MESSAGES |
0 (atspējots) |
src/shared/middleware/chatBodyAdmission.ts |
Neobligāts tērzēšanas vēstures ierobežojums, kas jāiespējo apzināti. Pēc noklusējuma atspējots: ziņojumu skaits ir izvietošanas politika, nevis universāla pieprasījuma īpašība, un ierobežošana šeit noraida sarunas ar galīgu 413, pirms saspiešanas konveijers var tās padarīt apkalpojamas. Kaudzes pieaugumu ierobežo OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT un kaudzes spiediena atmešana. Izvietojumos ar ierobežotu atmiņu, kuros nepieciešama stingra augšējā robeža, iestatiet pozitīvu vērtību; pārsnieguma gadījumā tad tiek saņemts strukturēts 413, kas pieprasa saspiešanu. |
OMNIROUTE_MAX_NONSTREAMING_RESPONSE_BYTES |
67108864 (64 MB) |
open-sse/handlers/chatCore/nonStreamingResponseBody.ts |
Stingrs ierobežojums pilnībā atmiņā buferētai upstream atbildei bez straumēšanas. Pārsniedzot šo robežu, upstream lasītājs tiek atcelts un pieprasījums ātri beidzas ar kļūdu, nevis neierobežoti palielina virkni, līdz kaudze ir izsmelta. |
OMNIROUTE_FORWARDING_HEADER_BUDGET_BYTES |
768 |
open-sse/handlers/chatCore/responseHeaders.ts |
Maksimālais no upstream atbildes galvenēm pārsūtīto vada baitu skaits. Kad budžets tiek pārsniegts, zemākas prioritātes galvenes (piemēram, pielāgotās x-codex-*, x-oai-request-id) tiek atmestas, lai iekļautos izplatītajos reversā starpniekservera galveņu ierobežojumos. Iestatiet lielāku vērtību, lai pārsūtītu vairāk upstream metadatu, palielinot atbildes galveņu izmēru. |
CORS_ORIGIN |
(nav iestatīts) | src/server/cors/origins.ts |
Novecojis vienas izcelsmes CORS atļauto adrešu saraksts. Jaunās izvietošanās reizēs ieteicams izmantot CORS_ALLOWED_ORIGINS. CORS ir paredzēts tikai citas izcelsmes pārlūkprogrammu API klientiem; autentificēti informācijas paneļa rakstīšanas pieprasījumi tā vietā izmanto tās pašas izcelsmes pieprasījumus kopā ar sesijai piesaistītu CSRF aizsardzību. |
CORS_ALLOWED_ORIGINS |
(nav iestatīts) | src/server/cors/origins.ts |
Ar komatiem atdalīts CORS atļauto adrešu saraksts. Aizstājējzīme netiek nosūtīta, ja vien nav skaidri konfigurēts CORS_ALLOW_ALL=true. |
CORS_ALLOW_ALL |
false |
src/server/cors/origins.ts |
Tikai izstrādei paredzēta apiešanas iespēja, kas atbalso jebkuru pārlūkprogrammas Origin. Neiespējojiet koplietojamās vai produkcijas izvietošanās vidēs. |
OUTBOUND_SSRF_GUARD_ENABLED |
true |
src/shared/network/outboundUrlGuard.ts |
Bloķēt pakalpojumu sniedzēju izsaukumus, kuru mērķis ir privāti, cilpas vai lokālās saites IP diapazoni. Atspējojiet tikai izolētās testa vidēs. |
OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS |
false |
src/shared/network/outboundUrlGuard.ts |
Atļaut pakalpojumu sniedzēju URL, kas norāda uz privātiem/lokāliem tīkliem (localhost, 192.168.x.x, 10.x.x.x utt.). OBLIGĀTS pašmitinātiem pakalpojumu sniedzējiem (LM Studio, Ollama, vLLM, Llamafile, Triton, SearXNG). Ja vērtība ir false, informācijas panelis noraida lokālo URL validāciju. |
OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS |
true |
src/shared/network/outboundUrlGuard.ts |
Atļaut pievienot/validēt pakalpojumu sniedzējus lokālās/privātās adresēs (127.0.0.1, localhost, LAN, privātie diapazoni) — attiecas tikai uz pakalpojumu sniedzēja validācijas ceļu. Noklusējuma vērtība ir true (priekšroka lokālai darbībai); iestatiet false, lai piemērotu stingru tikai publisko adrešu politiku. Mākoņa metadatu galapunkti (169.254.169.254, metadata.google.internal) vienmēr paliek bloķēti. (#5066) |
AUDIO_REMOTE_PROVIDER_NODES |
false |
src/app/api/v1/_shared/audioProviderNodes.ts |
Atļaut /v1/audio/* maršrutiem (transkripcijām, runai, tulkojumiem) izmantot ar OpenAI saderīgu pakalpojumu sniedzēja mezglu, kas mitināts ārpus localhost. Pēc noklusējuma izslēgts — audio maršrutēšana uz attālu resursdatoru maina izejošās datplūsmas identitāti, un tam jābūt skaidram operatora lēmumam. Cilpas/privātie mezgli (localhost, 127.0.0.1, 172.16-31.x) vienmēr ir atļauti un netiek ietekmēti. (#3963) |
OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN |
false |
src/app/api/auth/login/route.ts |
Kad OIDC ir iespējots, atspējot pieteikšanos ar paroli, lai lietotāji varētu autentificēties tikai ar OIDC vienoto pierakstīšanos. Tiek pieņemts arī vienkāršais aizstājvārds OIDC_DISABLE_PASSWORD_LOGIN; priekšroka ir informācijas paneļa funkcijas karogam ar tādu pašu atslēgu. (#10889) |
OIDC_DISABLE_PASSWORD_LOGIN |
false |
src/app/api/auth/login/route.ts |
Vienkāršais OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN aizstājvārds (#10889). |
Drošības pastiprināšanas kontrolsaraksts
# Produkcijas vides drošības minimums:
AUTH_COOKIE_SECURE=true # Nepieciešams HTTPS
REQUIRE_API_KEY=true # Autentificēt visus starpniekservera izsaukumus
ALLOW_API_KEY_REVEAL=false # Nekad neatklāt atslēgas lietotāja saskarnē
CORS_ALLOWED_ORIGINS=https://your.domain.com
MAX_BODY_SIZE_BYTES=5242880 # 5 MB ierobežojums
5. Ievades sanitizācija un PII aizsardzība
OmniRoute nodrošina divu līmeņu aizsardzību: pieprasījumu puses injekciju pārbaudi un atbilžu puses PII noņemšanu.
⚠️ Ierobežojumi: Šie aizsardzības mehānismi ir uz heiristiku balstīti, maksimālo iespēju robežās veikti noteikšanas pasākumi, nevis pilnvērtīgs uzvedņu injekciju ugunsmūris vai PII DLP sistēma. Tie var radīt kļūdaini pozitīvus rezultātus (atzīmējot nekaitīgas personāžu/RPG uzvednes) un kļūdaini negatīvus rezultātus (leetspeak, atstarpes, raksti valodās, kas nav angļu valoda). Ar tiem vien nepietiek atbilstības prasību izpildei. Pirms paļaušanās uz tiem pielāgojiet režīmus un pārbaudiet tos ar savu datplūsmu.
Pieprasījumu puse: uzvedņu injekciju aizsardzība
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
INPUT_SANITIZER_ENABLED |
true |
src/middleware/promptInjectionGuard.ts |
Iespējo ienākošo ziņojumu pārbaudi, lai noteiktu uzvedņu injekciju modeļus. |
INPUT_SANITIZER_MODE |
warn |
src/middleware/promptInjectionGuard.ts |
Injekciju politika: warn = tikai reģistrēt žurnālā, block = noraidīt pieprasījumu ar statusu 400. Mantotais režīms redact nenoņem injekcijas tekstu; pieprasījumu PII pārrakstīšanai izmantojiet PII_REDACTION_ENABLED. |
INJECTION_GUARD_MODE |
(nav iestatīts) | src/middleware/promptInjectionGuard.ts |
Mantots INPUT_SANITIZER_MODE aizstājvārds — darbība ir tāda pati. |
INPUT_SANITIZER_BLOCK_THRESHOLD |
high |
src/shared/utils/injectionSeverity.ts |
Minimālais nopietnības līmenis, kuru noraida MODE=block: high (noklusējums), medium vai low. Vidēja līmeņa modeļi ir paredzēti tikai novērošanai, ja vien slieksnis netiek pazemināts. |
INJECTION_GUARD_BLOCK_THRESHOLD |
(nav iestatīts) | src/shared/utils/injectionSeverity.ts |
Mantots INPUT_SANITIZER_BLOCK_THRESHOLD aizstājvārds — darbība ir tāda pati. |
PII_REDACTION_ENABLED |
false |
src/lib/guardrails/piiMasker.ts |
Ja vērtība ir true, aizklāj PII ienākošajos pieprasījumos (neatkarīgi no injekciju režīma). |
CREDENTIAL_REDACTION_ENABLED |
false |
src/lib/guardrails/credentialMasker.ts |
Aizklāj pieprasījumu/atbilžu datos plaši pazīstamus API atslēgu un slepeno pilnvaru marķieru modeļus. Jāiespējo atsevišķi; darbojas analogi PII_REDACTION_ENABLED. |
Atbilžu puse: PII sanitizētājs
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
PII_RESPONSE_SANITIZATION |
false |
src/lib/piiSanitizer.ts |
Pirms atbildes nosūtīšanas klientam pārbauda, vai LLM atbildēs nav noplūdušu PII. |
PII_RESPONSE_SANITIZATION_MODE |
redact |
src/lib/piiSanitizer.ts |
redact = aizklāt PII, warn = tikai reģistrēt žurnālā, block = atmest visu atbildi. |
VS Code marķierizēto maršrutu konteksta sanitizētājs
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_VSCODE_SANITIZE_CONTEXT |
1 |
src/app/api/v1/vscode/contextSanitizer.ts |
No /v1/vscode/[token]/* pieprasījumiem noņem netiešo aktīvā redaktora kontekstu (editorContext, activeEditor, currentFile, selection, openTabs…) un aizklāj nepārprotami pievienoto sensitīvo failu saturu. Drošs pēc noklusējuma; iestatiet uz 0, lai atspējotu. |
Scenāriji
| Scenārijs | Konfigurācija |
|---|---|
| Uzņēmuma atbilstības prasības | INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=block, PII_REDACTION_ENABLED=true, PII_RESPONSE_SANITIZATION=true (injekcijas tiek bloķētas un PII pieprasījumos/atbildēs tiek aizklāti; režīmi ir neatkarīgi) |
| Tikai uzraudzība | INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=warn — reģistrē žurnālā, bet nekad nebloķē |
| Personīga lietošana | Atstājiet visu atspējotu — nekādas papildu slodzes |
6. Rīku un maršrutēšanas politikas
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
TOOL_POLICY_MODE |
disabled |
src/lib/toolPolicy.ts |
Kontrolē LLM piekļuvi rīku/funkciju izsaukšanai. allowlist = tikai sarakstā norādītie rīki, denylist = visi, izņemot sarakstā norādītos, disabled = bez ierobežojumiem. |
OMNIROUTE_PAYLOAD_RULES_PATH |
./config/payloadRules.json |
open-sse/services/payloadRules.ts |
Ceļš uz lietderīgās slodzes manipulācijas kārtulu JSON failu (katram modelim/protokolam paredzēti augšupstraumes pielāgojumi). |
OMNIROUTE_PAYLOAD_RULES_RELOAD_MS |
5000 |
open-sse/services/payloadRules.ts |
Pārlādes intervāls (ms) lietderīgās slodzes kārtulu faila dinamiskai pārlādēšanai. Minimums 1000. |
OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS |
false |
open-sse/services/model.ts |
Izvēles iestatījums: maršrutēt Claude Code klientu modeļu ID bez prefiksa claude-* caur Claude Code OAuth kontu, nevis pieprasīt nodrošinātāja prefiksu. Skaidri norādītiem nodrošinātāja prefiksiem joprojām ir priekšroka. Konfigurējams arī ar slēdzi Claude nodrošinātāja lapas informācijas panelī. |
COMBO_CONCURRENCY_PER_MODEL |
3 |
open-sse/services/comboConfig.ts |
Vienlaicīguma ierobežojums katram modelim cikliskās secības kombinācijām (#9100). Cikliskās secības kombināciju semaforam bija stingrs 3 vienlaicīgu pieprasījumu ierobežojums katram modelim bez iespējas to mainīt, tādēļ lielākas vienlaicīguma pakāpes datplūsma tika apstrādāta secīgi aiz šī ierobežojuma. Validēts kā >= 1, ierobežots līdz <= 32. |
DISABLE_CONTEXT_WINDOW_CHECKS |
false |
open-sse/handlers/chatCore.ts |
Bīstams izvēles iestatījums, kas tiešiem viena modeļa pieprasījumiem izlaiž OmniRoute lokālo konteksta loga / maksimālā ievades marķieru skaita pārbaudi. Augšupstraumes nodrošinātāji joprojām piemēro savus faktiskos ierobežojumus; uzvednes saspiešana un paša modeļa izvades marķieru ierobežojums paliek aktīvs. Spēkā esošā prioritāte ir funkciju karogu datubāzes ignorēšana > vides mainīgais > noklusējums; restartēšana nav nepieciešama. |
OMNIROUTE_DISABLE_CONVERSATION_TRACKING |
(nav iestatīts) | open-sse/services/conversationTracker.ts |
Iestatiet 1, lai pārtrauktu sarunu vēstures apkopošanu. resolveConversationId() atgriež neizsekotu rezultātu, pirms tā nolasa SQLite vai parsē ziņojumu vēsturi, un tas attiecas arī uz klienta norādītiem sesiju ID. Maršrutēšanas sesiju apstrāde nemainās, un esošie ieraksti netiek dzēsti. Paredzēts izvietojumiem, kuri neizmanto informācijas paneļa sarunu skatu un vēlas apturēt kārtu tabulas palielināšanos. |
7. URL adreses un mākoņa sinhronizācija
| Mainīgais | Noklusējuma vērtība | Avota fails | Apraksts |
|---|---|---|---|
BASE_URL |
http://localhost:20128 |
src/lib/cloudSync.ts |
Servera puses URL, ko iekšējie sinhronizācijas uzdevumi izmanto, lai izsauktu /api/sync/cloud. Saglabājiet to kā atgriezeniskās cilpas/konteinera URL pat tad, ja lietotne ir publiski pieejama, izmantojot starpniekserveri. |
CLOUD_URL |
(tukšs) | src/lib/cloudSync.ts |
Mākoņa retranslācijas galapunkta URL (premium funkcija). |
CLOUD_SYNC_TIMEOUT_MS |
12000 |
src/lib/cloudSync.ts |
HTTP noildze mākoņa sinhronizācijas pieprasījumiem. |
OMNIROUTE_BUILD_PROFILE |
full |
Webpack būvējuma konfigurācija | Būvēšanas laika profils (iestatiet uz minimal, lai fiziski izslēgtu privileģētos moduļus no pakotnes). |
OMNIROUTE_STANDALONE_DIR |
.build/ savrupais izvades direktorijs | scripts/build/colocate-standalone.mjs |
Būvēšanas laika pārrakstīšana savrupajam izvades direktorijam, ko izmanto pēcbūvēšanas kopizvietošanas darbība. Tas nav izpildlaika iestatījums. |
OMNIROUTE_CLOUD_SYNC_SECRET |
(tukšs) | src/lib/cloudSync.ts |
Koplietots noslēpums, ko izmanto, lai pārbaudītu mākoņa sinhronizācijas atbilžu HMAC-SHA256 parakstu. |
OMNIROUTE_CLOUD_SYNC_SECRETS |
false |
src/lib/cloudSync.ts |
Iestatiet uz true, lai atļautu mākoņa sinhronizācijas galapunktam pārrakstīt lokālos akreditācijas datus. Noklusējuma vērtība ir false. |
OMNIROUTE_CLOUD_SYNC_ENFORCE_SIGNATURE |
false |
src/lib/cloudSync.ts |
Iestatiet uz true, lai noraidītu neparakstītu mākoņa sinhronizācijas atbildi, ja nav konfigurēts lokāls noslēpums (#13679). Esošs paraksts vienmēr tiek pārbaudīts un vienmēr tiek noraidīts, ja OMNIROUTE_CLOUD_SYNC_SECRET nav iestatīts, neatkarīgi no šī karoga. Sākot ar v3.9, pārbaude pēc noklusējuma būs obligāta. |
OMNIROUTE_ZED_IMPORT_LEGACY_ONE_STEP |
false |
src/app/api/providers/zed/import/route.ts |
Iestatiet uz true, lai bez lietotāja apstiprinājuma atgrieztos pie v3.8.5 vienas darbības „importēt visu” darbības. |
NEXT_PUBLIC_BASE_URL |
http://localhost:20128 |
OAuth, informācijas panelis, sinhronizācija | Publiski pieejams URL OAuth redirect_uri, informācijas paneļa saitēm un ģenerētajiem publiskajiem URL. Iestatiet to uz stabilu publisko URL, ja OAuth atzvaniem vai ģenerētajām pārlūkprogrammas saitēm jāizmanto kanonisks reversā starpniekservera resursdators. |
NEXT_PUBLIC_CLOUD_URL |
(tukšs) | Klienta puse | CLOUD_URL klienta puses spoguļvērtība. |
NEXT_PUBLIC_APP_URL |
(nav iestatīts) | src/shared/services/cloudSyncScheduler.ts |
Mantotā atkāpšanās opcija mainīgajam NEXT_PUBLIC_BASE_URL. |
OMNIROUTE_PUBLIC_BASE_URL |
(nav iestatīts) | Publiskās izcelsmes atrisinātājs, attēlu URL | Augstākās prioritātes pārlūkprogrammai paredzētā OmniRoute izcelsme, ko izmanto publisko URL ģenerēšanai un ārpus informācijas paneļa esošās pārlūkprogrammas izcelsmes validācijai. Iestatiet to, ja OpenWebUI vai cits relejs sasniedz OmniRoute, izmantojot iekšēju URL, bet lietotāja pārlūkprogrammai ģenerētais multivides saturs jāielādē no LAN, tuneļa vai publiskas izcelsmes. Neiekļaujiet /v1. |
OMNIROUTE_PROVIDER_MANIFEST_URL |
(nav iestatīts) | open-sse/config/providerPluginManifestUrl.ts |
Absolūts nodrošinātāja spraudņa manifesta URL, kas tiek paziņots blakusprocesa klientiem. Ja tas nav iestatīts, OmniRoute atvasina /api/v1/provider-plugin-manifest no pieprasījuma izcelsmes vai HOST/PORT. |
OMNIROUTE_PUBLIC_PROTOCOL |
http |
open-sse/config/providerPluginManifestUrl.ts |
Protokols, ko izmanto, atvasinot nodrošinātāja spraudņa manifesta URL no HOST/PORT bez pieprasījuma izcelsmes. Iestatiet uz https, ja tiek izmantots publisks starpniekserveris, kas terminē TLS, un nav iestatīts nepārprotams OMNIROUTE_PROVIDER_MANIFEST_URL. |
OMNIROUTE_TRUST_PROXY |
(nav iestatīts) | src/server/origin/publicOrigin.ts |
Neobligāts uzticamības režīms pārsūtītajām publiskās izcelsmes galvenēm. Nav iestatīts = drošības lēmumiem neuzticēties Forwarded / X-Forwarded-*. true / loopback uzticas pārsūtītajam resursdatoram/protokolam tikai no ar marķieri apzīmogota atgriezeniskās cilpas starpniekservera. private / lan uzticas arī privātā LAN starpniekserveru vienādranga mezgliem. Produkcijas vidē dodiet priekšroku nepārprotamam NEXT_PUBLIC_BASE_URL. |
KIE_CALLBACK_URL |
(nav iestatīts) | open-sse/utils/kieTask.ts |
Publisks atzvanīšanas URL asinhroniem kie.ai darbiem. Augstākās prioritātes pārrakstīšana pirms OMNIROUTE_KIE_CALLBACK_URL un OMNIROUTE_PUBLIC_URL. |
OMNIROUTE_KIE_CALLBACK_URL |
(nav iestatīts) | open-sse/utils/kieTask.ts |
Alternatīvs KIE_CALLBACK_URL pieraksts. Tiek izmantots kā atkāpšanās opcija, ja primārais mainīgais nav iestatīts. |
OMNIROUTE_PUBLIC_URL |
(nav iestatīts) | open-sse/utils/kieTask.ts |
Publiskā izcelsme, ko izmanto asinhrono atzvanīšanas URL izveidei. Zemākās prioritātes atkāpšanās opcija kie.ai atzvanīšanām; tiek izmantota arī kā vispārīgs publiskais URL citiem relejiem. |
OMNIROUTE_CROF_USAGE_URL |
https://crof.ai/usage_api/ |
open-sse/services/usage.ts |
CrofAI kvotas uzmeklēšanas galapunkts, ko izmanto lapā Usage. Pārrakstiet relejiem / testa armatūrām. |
OMNIROUTE_OPENCODE_QUOTA_URL |
https://opencode.ai/zen/go/v1/usage |
open-sse/services/opencodeQuotaFetcher.ts |
Oficiālais ar API atslēgu autentificētais OpenCode Go lietojuma galapunkts, ko izmanto lapā Usage. Pārrakstiet relejiem / testa armatūrām. |
OPENCODE_SYNTHESIZE_CLI_HEADERS |
true |
open-sse/executors/opencode.ts |
Sintezē OpenCode CLI identitātes galvenes (User-Agent, x-opencode-client/project, pieprasījuma/sesijas UUID) opencode-go/zen augšupstraumes pieprasījumiem, kurus klients nav nosūtījis, lai Cloudflare tos pieņemtu VPS izejošajā trafikā (#6210/#5997). Pēc noklusējuma ieslēgts kopš #10571; atspējojiet ar false/0/no/off. |
OPENCODE_USER_AGENT |
opencode |
open-sse/executors/opencode.ts |
Noklusējuma User-Agent, ko izmanto, ja OPENCODE_SYNTHESIZE_CLI_HEADERS ir ieslēgts un nav iestatīta katram nodrošinātājam paredzēta <PROVIDER>_USER_AGENT pārrakstīšana. Tiek lietots tikai opencode izpildītājiem. |
OPENCODE_CLIENT |
desktop |
open-sse/executors/opencode.ts |
Sintezētās x-opencode-client galvenes vērtība, ja OPENCODE_SYNTHESIZE_CLI_HEADERS ir ieslēgts. |
OPENCODE_PROJECT |
global |
open-sse/executors/opencode.ts |
Sintezētās x-opencode-project galvenes vērtība, kad ir ieslēgts OPENCODE_SYNTHESIZE_CLI_HEADERS. |
OMNIROUTE_OLLAMA_CLOUD_USAGE_URL |
https://ollama.com/settings |
open-sse/services/usage.ts |
Ollama Cloud iestatījumu URL, ko izmanto kvotas datu iegūšanai. Mainiet to relejiem/testu datiem. |
OLLAMA_USAGE_COOKIE |
(nav iestatīts) | open-sse/services/usage.ts |
Ollama Cloud __Secure-session sīkfails, ko izmanto kvotas datu iegūšanai no iestatījumu lapas. Sensitīvs; ja ir konfigurēti vairāki konti, ieteicams izmantot katram savienojumam paredzēto informācijas paneļa lauku. |
OLLAMA_CLOUD_USAGE_COOKIE |
(nav iestatīts) | open-sse/services/usage.ts |
Alternatīvs Ollama Cloud __Secure-session sīkfaila vides mainīgais. Sensitīvs; ja ir konfigurēti vairāki konti, ieteicams izmantot katram savienojumam paredzēto informācijas paneļa lauku. |
OMNIROUTE_OLLAMA_USAGE_COOKIE |
(nav iestatīts) | open-sse/services/usage.ts |
Alternatīvs Ollama Cloud __Secure-session sīkfaila vides mainīgais, kas tiek izmantots pirms īsākajiem aizstājvārdiem. Sensitīvs; ja ir konfigurēti vairāki konti, ieteicams izmantot katram savienojumam paredzēto informācijas paneļa lauku. |
OMNIROUTE_CODEWHISPERER_BASE_URL |
https://codewhisperer.us-east-1.amazonaws.com |
open-sse/services/usage.ts |
CodeWhisperer (AWS Kiro) lietojuma ierobežojumu galapunkts. Mainiet to relejiem/testu datiem. |
Important
Izvietojot aiz reversā starpniekservera (nginx, Caddy), iestatiet
NEXT_PUBLIC_BASE_URLuz savu stabilo publisko URL (piemēram,https://omniroute.example.com), ja OAuth atzvaniem vai ģenerētajām publiskajām saitēm jāizmanto šis resursdatora nosaukums. Bez tā OAuth atzvani var neizdoties, jo redirect_uri nesakritīs, un ģenerētās publiskās saites var norādīt uz iekšējā konteinera izcelsmi.Saglabājiet
BASE_URLkā iekšēju atgriezeniskās cilpas/konteinera URL darbiem starp serveriem. Iekšējām pašizguvēm, kas ietver akreditācijas datus, neizmantojiet pārlūkaOriginvai publisku resursdatora nosaukumu.Autentificētiem informācijas paneļa rakstīšanas pieprasījumiem nav nepieciešams statisks publiskais bāzes URL: informācijas panelis sūta tās pašas izcelsmes nedrošos pieprasījumus ar sesijai piesaistītu CSRF marķieri. OmniRoute joprojām centralizē publiskās izcelsmes validāciju pārlūka integrācijām, kas nav saistītas ar informācijas paneli: vispirms tiek uzticēti skaidri norādītie publiskā URL vides mainīgie; neapstrādātas
Forwarded/X-Forwarded-*galvenes tiek ignorētas, ja vien nav iespējotsOMNIROUTE_TRUST_PROXYun tiešais starpniekservera mezgls nav ar marķieri atzīmēts kā uzticams. Neizmantojiet CORS iestatījumus, lai labotu tās pašas izcelsmes informācijas paneļa pieprasījumus; CORS ir paredzēts tikai citas izcelsmes pārlūka klientiem.
8. Izejošais starpniekserveris
Novirziet izsaukumus uz ārējiem LLM nodrošinātājiem caur HTTP vai SOCKS5 starpniekserveri, lai kontrolētu izejošo datplūsmu, veiktu ģeogrāfisko maršrutēšanu vai maskētu IP adresi.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
ENABLE_SOCKS5_PROXY |
true |
open-sse/executors |
Iespējo SOCKS5 starpniekservera aģentu ārējiem izsaukumiem. Lai atteiktos, iestatiet false. |
NEXT_PUBLIC_ENABLE_SOCKS5_PROXY |
true |
Klienta puse | Klienta puses informētība par SOCKS5 pieejamību. |
PROXY_SKIP_RECENTLY_FAILED |
false |
src/shared/utils/featureFlags.ts |
Izvēles funkcionalitātes karogs (skatiet FEATURE_FLAGS.md; informācijas paneļa DB pārrakstīšana ir prioritāra). Starpniekserveru pūli un rotācija katram kontam uz laiku pārtrauc atkārtoti izmantot elementu, kam tikko radās kļūme (noraidīta TCP pārbaude vai caur to saņemts 429); šis periods pēc katras atkārtotas kļūmes divkāršojas līdz noteiktai robežai. To iespējo true (vai 1, yes). |
HTTP_PROXY |
(nav iestatīts) | Node.js standarts | HTTP starpniekserveris ārējiem izsaukumiem. |
HTTPS_PROXY |
(nav iestatīts) | Node.js standarts | HTTPS starpniekserveris ārējiem izsaukumiem. |
ALL_PROXY |
(nav iestatīts) | Node.js standarts | Universāls starpniekserveris (atbalsta socks5://). |
OMNIROUTE_PROXY_ECHO_URL |
(nav iestatīts) | src/lib/proxyEchoTarget.ts |
Piesaista starpniekservera izejošās datplūsmas pārbaužu atbalss IP mērķi vienam URL. Ja nav iestatīts, pārbaude vispirms mēģina api64.ipify.org, pēc tam api4.ipify.org, lai tikai IPv4 tuneļi netiktu kļūdaini uzskatīti par nedarbojošiem (#9694). |
NO_PROXY |
(nav iestatīts) | Node.js standarts | Ar komatiem atdalīti resursdatoru nosaukumi/IP adreses, kam jāapiet starpniekserveris. |
OMNIROUTE_PROXY_DISPATCHER_CONNECTIONS |
32 |
open-sse/utils/proxyDispatcher.ts |
Maksimālais vienlaicīgo ligzdu skaits katram kešotajam HTTP/SOCKS starpniekservera dispečeram. Ilglaicīgām SSE straumēm, piemēram, Codex /v1/responses, nepieciešams vairāk nekā viens savienojums, ja vairāki pieprasījumi koplieto vienu konta līmeņa starpniekserveri. Vērtībām virs 256 tiek piemērots ierobežojums. |
SOCKS_HANDSHAKE_TIMEOUT_MS |
10000 |
open-sse/utils/socksConnectorWithFamily.ts |
SOCKS5 rokasspiediena (savienojuma izveides) taimauts milisekundēs. Palieliniet to, ja vienam dzīvojamo IP vārtejas resursdatoram ir liela vienlaicīgā slodze (piemēram, 100 vienlaicīgi pieprasījumi) — pārslogotā pūlā faktiskais rokasspiediens var ilgt vairāk nekā 10 s, pat ja starpniekserveris ir sasniedzams; pretējā gadījumā kļūdaini tiek parādīts [Proxy Fast-Fail] Proxy unreachable. Ierobežots līdz 120000. |
PROXY_FAIL_OPEN |
false |
src/sse/handlers/chatHelpers.ts |
Ja vērtība ir false (noklusējums), pieprasījums, kura piešķirto starpniekserveri neizdodas atrisināt, tiek noraidīts (slēgta atteice), nevis pārslēgts uz tiešu savienojumu — tas novērš īstās IP adreses noplūdi. Iestatiet true, lai atjaunotu iepriekšējo DIRECT atkāpšanās mehānismu. |
ENABLE_TLS_FINGERPRINT |
false |
open-sse/executors |
Vilto TLS ciparnospiedumu, izmantojot wreq-js (atdarina Chrome 124). Novērš JA3/JA4 bloķēšanu. |
TLS_FINGERPRINT_PROVIDERS |
(nav iestatīts) | open-sse/utils/proxyFetch.ts |
Ar komatiem atdalīts pakalpojumu sniedzēju atļauto vienumu saraksts jaunajai starpniekota TLS maršrutēšanai (open-sse/utils/proxyFetch.ts). Ja vērtība nav iestatīta, tiešais TLS saglabā savu iepriekšējo darbību; tikai šie pakalpojumu sniedzēji tiek maršrutēti caur Chrome-124 ciparnospieduma tiltu. |
OMNIROUTE_TURNSTILE_IGNORE_TLS_ERRORS |
false |
open-sse/services/claudeTurnstileSolver.ts |
Ļauj Claude Turnstile Playwright pārlūkprogrammas kontekstam ignorēt HTTPS sertifikāta kļūdas. |
Scenāriji
| Scenārijs | Konfigurācija |
|---|---|
| SOCKS5 caur SSH tuneli | ALL_PROXY=socks5://127.0.0.1:7890, ENABLE_SOCKS5_PROXY=true |
| Korporatīvais HTTP starpniekserveris | HTTP_PROXY=http://proxy.corp.com:3128, HTTPS_PROXY=http://proxy.corp.com:3128, NO_PROXY=localhost,internal.corp.com |
| Aizsardzība pret ciparnospiedumu noteikšanu | ENABLE_TLS_FINGERPRINT=true — nepieciešams wreq-js (iekļauts) |
| Kontrolēta izejošā trafika vide / nav tiešas piekļuves | Atstājiet PROXY_FAIL_OPEN=false (noklusējums). Ja starpniekserveris nav pieejams, pieprasījumi tiek pārtraukti ar kļūdu, nevis nopludināti pa tiešo savienojumu. |
| Mantotā / izstrādes vide — atļaut tiešo atkāpšanos | PROXY_FAIL_OPEN=true. Atjauno darbību pirms drošības pastiprināšanas: ja starpniekservera noteikšana neizdodas, tiek izmantots tiešais savienojums. |
Piezīme (NVIDIA validācijas apiešana — #3226): NVIDIA API atslēgas validācijas galapunkts pārstāj reaģēt, ja tas tiek maršrutēts caur globālo starpniekserveri/TLS modificēto fetch (undici dispečers → 504).
src/lib/providers/validation.ts::directHttpsRequest()apzināti apiet starpniekservera modifikāciju šim vienīgajam validācijas izsaukumam, izmantojotsafeOutboundFetch({ bypassProxyPatch: true }). Tas ir dokumentēts, ierobežota tvēruma izņēmums — tas neietekmē tērzēšanas/lietošanas izejošo trafiku. Apiešanas tvērumu ierobežotests/unit/proxy-bypass-scope-guard-3226.test.ts.
9. CLI rīku integrācija
Nosaka, kā OmniRoute atrod un palaiž CLI blakusprocesus (Claude Code, Codex u. c.).
| Mainīgais | Noklusējuma vērtība | Avota fails | Apraksts |
|---|---|---|---|
CLI_MODE |
auto |
src/shared/services/cliRuntime.ts |
auto = meklēt sistēmas PATH; manual = izmantot tikai skaidri norādītus ceļus. |
CLI_EXTRA_PATHS |
(nav iestatīts) | src/shared/services/cliRuntime.ts |
Papildu PATH ieraksti CLI bināro failu atrašanai (atdalīti ar koliem). |
CLI_CONFIG_HOME |
(nav iestatīts) | src/shared/services/cliRuntime.ts |
Pārraksta mājas direktoriju, ko izmanto CLI konfigurāciju (~/.claude, ~/.codex) lasīšanai. Tai jābūt absolūtai un jāatrodas procesa mājas direktorijā — vai konteinerā jābūt ceļam, kas piesaistīts ar bind mount (tā darbojas /host-home). Visos citos gadījumos tiek izmantots mājas direktorijs. |
CLI_ALLOW_CONFIG_WRITES |
true |
src/shared/services/cliRuntime.ts |
Ļauj OmniRoute rakstīt CLI konfigurācijas failos (pilnvaras atsvaidzināšana, sesijas dati). Iestatiet uz false, lai katrs mēģinājums rakstīt CLI konfigurācijā beigtos ar nepārprotamu kļūdu „rakstīšana atspējota”. |
CLI_CLAUDE_BIN |
claude |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Claude CLI bināro failu. |
CLI_CODEX_BIN |
codex |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Codex CLI bināro failu. |
CLI_DROID_BIN |
droid |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Droid CLI bināro failu. |
CLI_OPENCLAW_BIN |
openclaw |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz OpenClaw CLI bināro failu. |
CLI_CURSOR_BIN |
agent, pēc tam cursor |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Cursor aģenta bināro failu. Ja tas nav norādīts, noteikšana vispirms izmēģina agent un pēc tam izmanto cursor. |
CLI_CLINE_BIN |
cline |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Cline CLI bināro failu. |
CLI_5DIVE_BIN |
5dive |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz 5dive CLI bināro failu. |
CLI_5DIVE_STATE_DIR |
/var/lib/5dive |
src/shared/services/cliRuntime.ts |
5dive sistēmas stāvokļa direktorijs (root piederoši autentifikācijas profili); atbilst 5dive paša STATE_DIR noklusējuma vērtībai. |
CLI_CONTINUE_BIN |
cn |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Continue CLI bināro failu. |
CLI_QODER_BIN |
qodercli |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Qoder CLI bināro failu. |
CLI_QWEN_BIN |
qwen |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Qwen Code CLI bināro failu. |
CLI_AIDER_BIN |
aider |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Aider CLI bināro failu. |
CLI_GOOSE_BIN |
goose |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Goose CLI bināro failu. |
CLI_GEMINI_BIN |
gemini |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Google Gemini CLI bināro failu — tikai servera puses noteikšanai un darbspējas pārbaudēm; omniroute run gemini atrod gemini bināro failu sistēmas PATH. |
CLI_KILO_BIN |
kilocode |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Kilo Code CLI bināro failu. |
CLI_OPENCODE_BIN |
opencode |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz OpenCode CLI bināro failu. |
CLI_HERMES_BIN |
hermes |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Hermes bināro failu. Kopīgs abiem kataloga ierakstiem (hermes un hermes-agent). |
CLI_FORGE_BIN |
forge |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz ForgeCode CLI bināro failu. |
CLI_JCODE_BIN |
jcode |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz jcode CLI bināro failu. |
CLI_DEEPSEEK_TUI_BIN |
deepseek-tui |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz DeepSeek TUI bināro failu. |
CLI_CODEWHALE_BIN |
codewhale |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz CodeWhale CLI bināro failu. |
CLI_SMELT_BIN |
smelt |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Smelt CLI bināro failu. |
CLI_PI_BIN |
pi |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Pi (pi-coding-agent) bināro failu. |
CLI_CRUSH_BIN |
crush |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Crush CLI bināro failu. |
CLI_OMP_BIN |
omp |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Oh My Pi (omp) aģenta bināro failu. |
CLI_LETTA_BIN |
letta |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Letta CLI bināro failu. |
CLI_PRIME_AGENT_BIN |
prime-agent |
src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Prime Agent (Prime Intellect) bināro failu. |
CLI_WINDSURF_BIN |
(nav) | src/shared/services/cliRuntime.ts |
Pielāgots ceļš uz Windsurf bināro failu. Windsurf tiek piegādāts bez noklusējuma komandas — binārā faila noteikšana paliek atspējota, līdz šī vērtība tiek iestatīta. |
CLI_DEVIN_BIN |
devin |
open-sse/executors/devin-cli.ts |
Pielāgots ceļš uz Devin CLI bināro failu (v3.8.0). To izmanto Windsurf/Devin izpildītājs. |
DEVIN_DESKTOP_VERSION |
3.6.27 |
open-sse/executors/devin-desktop.ts |
Devin Desktop ide_version. Pārrakstīšanas vērtībām jāizmanto formāts x.y.z; nederīgu vērtību gadījumā tiek izmantota pārbaudītā noklusējuma vērtība. |
DEVIN_DESKTOP_EXTENSION_VERSION |
1.48.2 |
open-sse/executors/devin-desktop.ts |
Komplektā iekļautā Codeium/language-server extension_version, kas atšķiras no Desktop ide_version. Pārrakstīšanas vērtībām jāizmanto x.y.z; nederīgu vērtību gadījumā tiek izmantota komplektā iekļautā noklusējuma vērtība. |
CLI_DEVIN_AGENTIC_BIN |
devin |
open-sse/executors/devin-cli-agentic.ts |
Tikai aģentiskajam tiltam paredzēta Devin CLI pārrakstīšanas vērtība. Izpildītājs pieņem tikai lokālo ACP stdio augšupstraumi. |
DEVIN_AGENTIC_HOME |
(obligāts) | open-sse/executors/devin-cli-agentic.ts |
Absolūts izolēts mājas direktorijs aģentiskajam Devin apakšprocesam; pieņemtie tilta ceļi ir /home/bridge un uzdevuma lokālie .sandbox ceļi (operētājsistēmā Windows — C:\...\.sandbox\...). |
DEVIN_AGENTIC_ACP_TIMEOUT_MS |
120000 |
open-sse/executors/devin-cli-agentic.ts |
Viena Devin ACP cikla maksimālais ilgums, pirms tilts pārtrauc bērnprocesu un atgriež nepārprotamu taimautu. |
DEVIN_BRIDGE_MODEL |
devin-cli-agentic/swe-1-7 |
docker/devin-bridge/compose.yml |
Galvenais Claude Code modeļa aizstājvārds izolētajam tiltam. Aktīvā testēšanas vide piemēru aizstāj ar modeli, ko atgriež pašreizējais Devin konts. |
DEVIN_BRIDGE_SONNET_MODEL |
DEVIN_BRIDGE_MODEL |
docker/devin-bridge/compose.yml |
Izolētā tilta aizstājvārds, ko izmanto, kad Claude Code pieprasa savu noklusējuma Sonnet modeli. |
DEVIN_BRIDGE_OPUS_MODEL |
DEVIN_BRIDGE_MODEL |
docker/devin-bridge/compose.yml |
Izolētā tilta aizstājvārds, ko izmanto, kad Claude Code pieprasa savu noklusējuma Opus modeli. |
DEVIN_BRIDGE_HAIKU_MODEL |
DEVIN_BRIDGE_MODEL |
docker/devin-bridge/compose.yml |
Izolētā tilta aizstājvārds, ko izmanto, kad Claude Code pieprasa savu noklusējuma Haiku modeli. |
DEVIN_BRIDGE_SUBAGENT_MODEL |
DEVIN_BRIDGE_MODEL |
docker/devin-bridge/compose.yml |
Izolētā tilta aizstājvārds, ko izmanto Claude Code apakšaģentiem. |
DEVIN_SEAT_API_URL |
https://server.codeium.com |
open-sse/services/usage/devinCli.ts |
Neobligāta Codeium licenču pārvaldības API pārrakstīšana, ko izmanto Devin CLI kvotai (GetUserStatus). |
AUGGIE_BIN |
auggie |
open-sse/executors/auggie.ts |
Absolūtā ceļa pārrakstīšana Augment (Auggie) CLI binārajam failam, ko izmanto lokālais auggie nodrošinātājs. Ja nav norādīts, izmanto CLI_AUGGIE_BIN, pēc tam veic meklēšanu PATH. |
CLI_AUGGIE_BIN |
auggie |
open-sse/executors/auggie.ts |
Alternatīva Augment (Auggie) CLI binārā faila ceļa pārrakstīšana (tiek pārbaudīta pēc AUGGIE_BIN). |
ZCODE_BIN |
zcode |
open-sse/executors/zcode.ts |
Binārais fails, ko izmanto lokālā zcode nodrošinātāja stdio klients. Ja nav norādīts, izmanto zcode no PATH. |
ZCODE_ARGS |
— | open-sse/executors/zcode.ts |
JSON masīvs (≤16 virknes) ar papildu argumentiem, kas tiek nodoti zcode binārajam failam, kad tas tiek palaists, izmantojot cliTools. |
ZCODE_CWD |
process.cwd() |
open-sse/executors/zcode.ts |
Darba direktorijs ZCode lietojumprogrammu servera apakšprocesam. |
ZCODE_PROVIDER_ID |
builtin:zai-coding-plan |
open-sse/executors/zcode.ts |
Lietojumprogrammu serverim nosūtītā nodrošinātāja ID pārrakstīšana. |
ZCODE_SERVER_RUNTIME_ROOT |
~/.zcode/server |
open-sse/executors/zcode.ts |
ZCode lietojumprogrammu servera izpildlaika saknes direktorijs (kur atrodas komplektā iekļautie node un zcode-server.cjs). |
ZCODE_SERVER_NODE |
<runtimeRoot>/node |
open-sse/executors/zcode.ts |
Node izpildāmais fails, ko izmanto ZCode lietojumprogrammu servera darbināšanai. |
ZCODE_SERVER_ENTRY |
<runtimeRoot>/zcode-server.cjs |
open-sse/executors/zcode.ts |
Lietojumprogrammu servera ieejas skripts, ko izmanto ZCode servera darbināšanai. |
ZCODE_STARTUP_TIMEOUT_MS |
10000 |
open-sse/executors/zcode.ts |
Palaišanas taimauts (ms), pēc kura ZCode lietojumprogrammu servera palaišana tiek uzskatīta par neveiksmīgu. |
ZCODE_RPC_TIMEOUT_MS |
30000 |
open-sse/executors/zcode.ts |
Katra pieprasījuma RPC taimauts (ms) ZCode lietojumprogrammu servera izsaukumam. |
ZCODE_TURN_TIMEOUT_MS |
120000 |
open-sse/executors/zcode.ts |
Viena ZCode gājiena maksimālais ilgums (ms), pirms uzraugs to pārtrauc taimauta dēļ. |
ZCODE_POLL_INTERVAL_MS |
250 |
open-sse/executors/zcode.ts |
Aptaujas intervāls (ms), lai pārbaudītu ZCode gājiena pabeigšanu. |
HERMES_HOME |
~/.hermes |
src/lib/cli-helper/config-generator/hermesHome.ts |
Hermes Agent mājas direktorijs, kurā OmniRoute lasa/raksta Hermes CLI konfigurāciju. Atbilst vides mainīgajam, ko Hermes PowerShell instalētājs iestata sistēmā Windows (%LOCALAPPDATA%\hermes). |
CLI profilu automātiskā sinhronizācija
Šie funkciju karodziņi ir brīvprātīgi jāiespējo, un pēc noklusējuma tie ir izslēgti. Tos var arī pārslēgt CLI Code informācijas panelī.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_AUTO_SYNC_CODEX_PROFILES |
false |
src/shared/constants/featureFlagDefinitions.ts |
Pēc nodrošinātāja modeļu sinhronizācijas automātiski pārraksta ~/.codex/*.config.toml profilu failus no aktuālā kataloga. Nepieciešams CLI_ALLOW_CONFIG_WRITES; nekad nemaina aktīvo/noklusējuma Codex konfigurāciju, autentifikāciju, Codex-lb iestatījumus vai nodrošinātāja izvēli. |
OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES |
false |
src/shared/constants/featureFlagDefinitions.ts |
Pēc nodrošinātāja modeļu sinhronizācijas automātiski pārraksta ~/.claude/profiles/<name>/settings.json Claude Code profilu failus no aktuālā kataloga. Nepieciešams CLI_ALLOW_CONFIG_WRITES; nekad nemaina aktīvo/noklusējuma Claude konfigurāciju, autentifikāciju vai nodrošinātāja izvēli. |
Docker piemērs
# Piemontējiet resursdatora bināros failus konteinerā un norādiet OmniRoute, kur tie atrodas:
CLI_EXTRA_PATHS=/host-cli/bin
CLI_CONFIG_HOME=/host-home
CLI_ALLOW_CONFIG_WRITES=true
CLI_CLAUDE_BIN=/host-cli/bin/claude
CLI_CONFIG_HOME stājas spēkā tikai tad, ja ceļš faktiski ir saistīti montēts no
resursdatora — izmantojiet to kopā ar tādiem montējumiem kā ~/.codex:/host-home/.codex:rw (skatiet
host profilu failā docker-compose.yml). Ceļš, kas neatrodas ne
konteinera lietotāja mājas direktorijā, ne saistītajā montējumā, tiek ignorēts, jo tajā veiktās izmaiņas
tiktu zaudētas, atkārtoti izveidojot konteineru.
Attēls darbojas kā USER node, tādēļ nemontēts /root nav derīga
aizstāšanas vērtība.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_CONTAINER |
(automātiski) | src/shared/utils/containerEnv.ts |
Piespiedu kārtā ieslēdziet (1/true) vai izslēdziet (0/false) konteinera noteikšanu. Nepieciešams tikai izpildvidēs, kuras automātiskā noteikšana neatpazīst. |
OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE |
false |
src/shared/services/cliRuntime.ts |
Atļaujiet CLI rīka konfigurācijas ierakstīšanu nemontētā konteinera ceļā. CLI ekvivalents ir --allow-container-write. |
CLI binārā faila (omniroute) palīgrīki
Šie mainīgie pielāgo paša omniroute CLI binārā faila darbību (nevis iepriekš
aprakstīto blakusprocesa noteikšanu).
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_LANG |
(sistēma) | bin/cli/i18n.mjs |
Piespiedu kārtā iestata CLI izvades valodu. BCP-47 lokalizācija (piem., en, pt-BR). Ignorē sistēmas lokalizācijas vides mainīgos (LC_ALL, LC_MESSAGES). |
OMNIROUTE_SHOW_LOG |
(nav iestatīts) | bin/cli/runtime/processSupervisor.mjs |
Iestatiet uz 1, lai pārraudzītajā režīmā pārsūtītu servera stdout/stderr uz termināli. Atbilst omniroute serve karogam --log. |
OMNIROUTE_CLI_TOKEN |
(nav iestatīts) | bin/cli/api.mjs |
Mašīnas autentifikācijas pilnvara, kas tiek ievietota kā x-omniroute-cli-token galvene. Automātiski ģenerēta uzdevumā 8.12. |
OMNIROUTE_HTTP_TIMEOUT_MS |
30000 |
bin/cli/api.mjs |
Katra mēģinājuma HTTP noildze (ms) CLI → servera pieprasījumiem. |
OMNIROUTE_READY_TIMEOUT_MS |
60000 |
bin/cli/utils/pid.mjs |
Maksimālais laiks (ms), ko CLI gaida servera darbspējas galapunktu, pirms izdrukā noildzes brīdinājumu. Noder lēnas aukstās palaišanas gadījumos (piem., Windows). Var iestatīt arī ar --ready-timeout. |
OMNIROUTE_VERBOSE |
0 |
bin/cli/api.mjs |
Iestatiet uz 1, lai CLI komandu izpildes laikā stderr izdrukātu atkārtotu mēģinājumu/gaidīšanas intervālu diagnostiku. |
OMNIROUTE_PLUGIN_PATH |
(nav iestatīts) | bin/cli/plugins.mjs |
Pielāgots direktorijs CLI spraudņu atrašanai (omniroute-cmd-* pakotnes). Ja nav iestatīts, pēc noklusējuma izmanto ~/.omniroute/plugins/. Tikai CLI — tas nekad nenonāk servera puses spraudņu skenerī, kuru norāda OMNIROUTE_PLUGINS_DIR (2. sadaļa). |
10. Iekšējā aģenta un MCP integrācijas
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_BASE_URL |
automātiska noteikšana | open-sse/mcp-server/server.ts |
Tiešs URL, ar kuru MCP/A2A rīki var sasniegt OmniRoute. Aizstāj localhost automātisko noteikšanu. |
OMNIROUTE_API_KEY |
(nav iestatīts) | MCP/A2A moduļi | API atslēga iekšējā MCP rīka un A2A prasmju izsaukumiem. |
OMNIROUTE_API_KEY_ID |
(nav iestatīts) | open-sse/mcp-server/audit.ts |
Atslēgas ID MCP audita žurnāla ierakstu attiecināšanai. |
ROUTER_API_KEY |
(nav iestatīts) | Mantotā funkcionalitāte | Mantots OMNIROUTE_API_KEY aizstājvārds. |
OMNIROUTE_A2A_HISTORY_RETENTION_DAYS |
30 |
src/lib/a2a/taskManager.ts |
Dienu skaits, cik ilgi A2A uzdevumu vēsture tiek glabāta lokālajā datubāzē, pirms ikdienas tīrīšana izdzēš attiecīgo rindu. Ja vērtība nav iestatīta, nav skaitlis vai ir <= 0, tiek izmantota rezerves vērtība 30. |
OMNIROUTE_A2A_MEMORY_HITS |
1 |
src/lib/a2a/taskExecution.ts |
A2A atmiņas trāpījumu novērojamības funkcijas avārijas slēdzis. Iestatiet uz 0, lai uzdevumam pilnībā izlaistu atmiņas atsaukšanas uzmeklēšanu; jebkura cita vērtība (tostarp neiestatīta) saglabā šo funkciju iespējotu. |
OMNIROUTE_ISSUE_AGENT_ENABLED |
false |
src/app/api/issue-agent/runs/route.ts |
Iespējo bezsaistes/lokālo Issue Agent ierakstītās sākotnējās izvērtēšanas galapunktu. Atstājiet atspējotu, ja vien netiek īpaši izpildītas lokālas ierakstītās sākotnējās izvērtēšanas darbplūsmas. |
OMNIROUTE_ISSUE_AGENT_TIMEOUT_MS |
(nav iestatīts) | src/lib/issueAgent/execution.ts |
Noildze (ms) vienai Issue Agent ierakstītās sākotnējās izvērtēšanas izpildei. Tā tiek ierobežota līdz iekšējam maksimumam; ja vērtība nav iestatīta vai nav derīga, tiek izmantota iebūvētā noklusējuma vērtība. |
OMNIROUTE_CONTEXT |
(aktīvais konteksts) | bin/cli/program.mjs, bin/cli/api.mjs |
CLI attālā režīma konteksts/profils omniroute komandām; aizstāj aktīvo kontekstu lokālajā kontekstu krātuvē. Ekvivalents opcijai --context <name>. |
OMNIROUTE_CONTEXT_KEYCHAIN_DISABLED |
0 |
bin/cli/contexts.mjs |
Atspējo neobligāto keytar operētājsistēmas atslēgu saišķa aizmugursistēmu CLI konteksta akreditācijas datiem. Kad tas ir iespējots, akreditācijas dati paliek config.json failā ar režīmu 0600, un CLI vienreiz parāda brīdinājumu par rezerves risinājuma izmantošanu; paredzēts apzinātai darbībai bez grafiskās saskarnes vai konteinerā. |
OMNIROUTE_MCP_ENFORCE_SCOPES |
true |
open-sse/mcp-server/server.ts |
Piemēro tvērumos balstītu piekļuves kontroli MCP rīku izsaukumiem. |
OMNIROUTE_MCP_SCOPES |
(visi) | open-sse/mcp-server/server.ts |
Ar komatiem atdalīti tvērumi: admin, combos, health, models, routing, budget, metrics, pricing, memory, skills. |
OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS |
false |
open-sse/mcp-server/descriptionCompressor.ts |
Saspiež MCP rīku aprakstus pirms manifesta serializēšanas. Iespējojošās vērtības: 1, true, on. |
OMNIROUTE_MCP_DESCRIPTION_COMPRESSION |
rtk |
open-sse/mcp-server/descriptionCompressor.ts |
Saspiešanas algoritms/profils. Atspējojošās vērtības: 0, false, off. |
OMNIROUTE_MCP_FETCH_TIMEOUT_MS |
10000 |
open-sse/mcp-server/fetchTimeout.ts |
Pārtraukšanas laika ierobežojums (ms) MCP servera iekšējās pārvaldības nolasīšanas darbībām (veselības stāvoklis, noturība, kombinācijas, kvota, lietojums). |
OMNIROUTE_MCP_UPSTREAM_TIMEOUT_MS |
60000 |
open-sse/mcp-server/fetchTimeout.ts |
Pārtraukšanas laika limits (ms) MCP pārejām, kas gaida pakalpojumu sniedzēju (route_request, web_search, web_fetch). |
OMNIROUTE_CORPUS_CACHE_SIZE |
5 |
src/lib/localCorpus/configured.ts |
Maksimālais atmiņā kešoto lokālā korpusa indeksa instanču skaits (LRU, viena katram indeksētajam saknes direktorijam). Ierobežots līdz vismaz 1. |
MODEL_SYNC_INTERVAL_HOURS |
24 |
src/shared/services/modelSyncScheduler.ts |
Modeļu kataloga sinhronizācijas intervāls stundās. |
PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES |
70 |
src/lib/usage/providerLimits.ts |
Pakalpojumu sniedzēja ātruma ierobežojumu un kvotu aptaujas intervāls. |
PROVIDER_LIMITS_SYNC_SPACING_MS |
1500 |
src/lib/usage/providerLimits.ts |
Intervāls (ms) starp secīgiem OAuth kvotu pieprasījumiem masveida sinhronizācijā; OAuth savienojumu dati tiek iegūti pa vienam, lai izvairītos no strauja pieprasījumu pieplūduma augšupstraumes sistēmai. 0 to atspējo (vienlaicīga izpilde). |
OMNIROUTE_QUOTA_FETCH_MIN_INTERVAL_MS |
250 |
open-sse/services/quotaFetchThrottle.ts |
Minimālais intervāls (ms) starp secīgiem augšupstraumes kvotu pieprasījumiem katra pieprasījuma priekšpārbaudes/pārraudzības ceļā; sadala vienlaicīgos tīkla izsaukumus laikā, lai daudzi konti no vienas IP adreses neradītu strauju pieprasījumu pieplūdumu augšupstraumes sistēmai. Integrēts Codex (/wham/usage), DeepSeek, Bailian (abās pieprasījumu vietās), OpenCode un Crof kvotu izgūšanas komponentos (#6009, #6911). Vispārīgais usage.ts::getUsageForProvider maršrutēšanas ceļš (github/glm/minimax/nanogpt/xai/u.c.) vēl nav aptverts — tas tiek izsekots atsevišķi. Kešatmiņas trāpījumi netiek ietekmēti. 0 atspējo; ierobežots diapazonā 0..5000. |
PROVIDER_LIMITS_POST_USAGE_REFRESH_DELAY_MS |
5000 |
src/lib/usage/providerLimits.ts |
Aizkave (ms) pirms pakalpojumu sniedzēja ierobežojumu atsvaidzināšanas pēc reāla lietojuma notikuma, dodot augšupstraumes kvotu API laiku reģistrēt patēriņu. |
OMNIROUTE_LOGIN_BROWSER_PATH |
automātiska noteikšana | open-sse/services/adobeFireflyBrowserLogin.ts |
Absolūtais ceļš uz sistēmas Chrome vai Edge izpildāmo failu, kas tiek izmantots interaktīvai Adobe Firefly pierakstīšanai un atjaunošanai ārpus ekrāna. |
ADOBE_FIREFLY_BROWSER_REFRESH |
iespējots | open-sse/services/adobeFireflySession.ts |
Uztur IMS un pārlūkprogrammas riska stāvokli aktuālu, izmantojot kontam piesaistītas Chrome CDP sesijas. Iestatiet uz 0, lai atspējotu pārlūkprogrammas atjaunošanu. |
ADOBE_FIREFLY_SESSION_DISK |
iespējots | open-sse/services/adobeFireflySession.ts |
Saglabā atjaunotās Adobe sesijas direktorijā DATA_DIR starp procesa restartēšanas reizēm. Iestatiet uz 0, lai sesijas glabātu tikai atmiņā. |
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS |
12000 |
open-sse/services/adobeFireflySession.ts |
Minimālais intervāls milisekundēs starp Adobe Firefly ģenerēšanas iesniegumiem; 0 atspējo intervālu. |
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS |
15000 |
open-sse/services/adobeFireflySession.ts |
Papildu klusuma periods milisekundēs pēc katra trešā veiksmīgā Adobe iesnieguma. |
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS |
8000 |
open-sse/services/adobeFireflyClient.ts |
Atkārtota mēģinājuma bāzes aizkave milisekundēs pēc pārejošām Adobe 408 atbildēm; apvienota ar iesniegumu intervāliem ne vairāk kā piecos mēģinājumos. |
OMNIROUTE_DISABLE_BACKGROUND_SERVICES |
false |
src/instrumentation-node.ts |
Atspējo visus fona pakalpojumus (sinhronizāciju, cenu noteikšanu, modeļu atsvaidzināšanu). Noderīgi CI/testēšanai. |
OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS |
(nav iestatīts) | src/lib/config/runtimeSettings.ts |
Piespiedu kārtā iespējo fona uzdevumus, ja konstatēta automatizēta testēšana. Iestatiet 1, lai ignorētu testēšanas heiristiku. |
OMNIROUTE_BUDGET_RESET_JOB_INTERVAL_MS |
600000 |
src/lib/jobs/budgetResetJob.ts |
Budžeta atiestatīšanas pārbaudes periodiskums (ms). Minimālā vērtība ir 10000. |
OMNIROUTE_CONNECTION_RECOVERY_INTERVAL_MS |
60000 |
src/lib/quota/connectionRecovery.ts |
Proaktīvās savienojumu atdzišanas atkopšanas periodiskums (ms): atkārtoti validē savienojumus, kuru īslaicīgais rate_limited_until ir beidzies, ārpus pieprasījumu kritiskā izpildes ceļa. Minimums 5000. |
OMNIROUTE_DISABLE_CONNECTION_RECOVERY |
false |
src/lib/quota/connectionRecovery.ts |
Atspējot proaktīvo savienojumu atdzišanas atkopšanas plānotāju (slinkā atkopšana funkcijā getProviderCredentials joprojām darbojas). |
OMNIROUTE_REASONING_CACHE_CLEANUP_INTERVAL_MS |
1800000 |
src/lib/jobs/reasoningCacheCleanupJob.ts |
Spriešanas kešatmiņas tīrīšanas periodiskums (ms). Minimums 60000. |
OMNIROUTE_REASONING_MIN_BUDGET |
nav iestatīts (atspējots) | open-sse/services/reasoningTokenBuffer.ts |
Izvēles minimums domāšanas modeļu izvades budžetiem: izsaucēja max_tokens diapazonā [256, minimums) tiek palielināts līdz minimumam (ievērojot modeļa izvades ierobežojumu). Nav iestatīts = klienta budžeti nekad netiek palielināti (#9507). |
OMNIROUTE_LOG_EXPORT_CRON |
0 * * * * |
src/lib/jobs/logExportJob.ts |
Cron izteiksme (UTC) izsaukumu žurnāla eksportēšanas uzdevumam, kas iztukšo katru iespējoto žurnāla eksportēšanas galamērķi. |
OMNIROUTE_CONFIG_HOT_RELOAD_MS |
5000 |
src/lib/config/hotReload.ts |
Konfigurācijas karstās pārlādes aptaujas intervāls (ms). Vērtības, kas mazākas par 1000, tiek noraidītas. |
OMNIROUTE_DISABLE_REDIS_AUTH_CACHE |
(iespējots) | src/lib/db/apiKeys.ts |
Iestatiet 1, lai apietu Redis API atslēgu autentifikācijas kešatmiņu (piespiedu kārtā veic datubāzes lasījumus). |
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS |
0 |
open-sse/services/compression/engines/rtk/filterLoader.ts |
Uzticēties lietotāju pārvaldītajiem RTK projektu filtru noteikumiem bez stingrām paraksta pārbaudēm. |
OMNIROUTE_LITE_MAX_TOOL_LENGTH |
2000 |
open-sse/services/compression/lite.ts |
Rakstzīmju ierobežojums Lite proaktīvai rīku rezultātu saīsināšanai, ja lite.maxToolLength nav iestatīts. Diapazons 256–1000000. Informācijas paneļa iestatījumam ir priekšroka pār šo vides mainīgo. |
OMNI_COMPRESSION_WORKERS |
2 |
open-sse/services/compression/compressionWorkerPool.ts |
Maksimālais vienlaicīgo sinhrono RTK/Caveman darbprocesu skaits; papildu uzdevumi gaida FIFO secībā. |
OMNI_COMPRESSION_WORKER_TIMEOUT_MS |
120000 |
open-sse/services/compression/compressionWorkerPool.ts |
Katra uzdevuma noildze milisekundēs. Darbprocesi, kuriem iestājusies noildze, tiek pārtraukti, un pieprasījums kļūmes gadījumā tiek turpināts bez izmaiņām. |
OMNI_COMPRESSION_WORKER_IDLE_MS |
60000 |
open-sse/services/compression/compressionWorkerPool.ts |
Dīkstāves ilgums milisekundēs, pēc kura neizmantots saspiešanas darbprocess tiek pārtraukts. |
COMPRESSION_PIPELINE_BREAKER_ENABLED |
false |
open-sse/services/compression/pipelineEngineBreaker.ts |
T02 vairākslāņu konveijera katra dziņa slēdža galvenais slēdzis. Izvēles funkcija (pēc noklusējuma izslēgta) — ja tā ir ieslēgta, dzinis, kas atkārtoti izraisa izņēmumu vairākos pieprasījumos, atdzišanas periodā tiek izlaists (kļūmes gadījumā turpinot darbu); izslēgts = baitos identiska mantotā darbība. |
COMPRESSION_PIPELINE_BREAKER_THRESHOLD |
3 |
open-sse/services/compression/pipelineEngineBreaker.ts |
Secīgu kļūmju skaits dažādos pieprasījumos, pēc kura atveras dziņa slēdzis. |
COMPRESSION_PIPELINE_BREAKER_COOLDOWN_MS |
30000 |
open-sse/services/compression/pipelineEngineBreaker.ts |
Laiks milisekundēs, cik ilgi atvērts dzinis tiek izlaists pirms daļēji atvērtas pārbaudes. |
COMPRESSION_CCR_RETRIEVAL_RAMP_FACTOR |
2 |
open-sse/services/compression/engines/ccr/index.ts |
T08/H8 CCR izgūšanas atgriezeniskās saites kāpums: katra iepriekšējā saglabātā bloka izgūšana lineāri palielina tā efektīvo minChars (bieži izgūts saturs tiek saspiests mazāk; >=3 izgūšanas reizes = nekad netiek saspiests). 1 atspējo kāpumu (bināra izlaišana tikai pie sliekšņa). |
COMPRESSION_CCR_DURABLE_STORE |
true |
open-sse/services/compression/engines/ccr/index.ts |
CCR pastāvīgā bloku krātuve (#9061). Papildina atmiņas krātuvi ar SQLite, lai bloks saglabātos pēc LRU izstumšanas, TTL beigām, restartēšanas vai izgūšanas pieprasījuma nonākšanas citā instancē. Iestatiet false, lai blokus glabātu tikai atmiņā. Bloki, kas pārsniedz 512 KB, un mākoņa izpildvides neatkarīgi no šī iestatījuma izmanto tikai atmiņu. |
COMPRESSION_PREFIX_FREEZE_ENABLED |
false |
open-sse/services/compression/prefixFreeze.ts |
T08/H5 lietojuma novērojumos balstītās prefiksa iesaldēšanas galvenais slēdzis. Pēc izvēles (pēc noklusējuma izslēgts) — ja tas ir ieslēgts, sistēmas uzvedne, kas novērota >= sliekšņa reižu skaitu, tiek uzskatīta par stabilu, kešojamu prefiksu un kompresijas laikā tiek saglabāta pat tiem nodrošinātājiem, kurus statiskā keša heiristika neaptver (iesaldēšana tikai saglabā, nekad nemodificē). |
COMPRESSION_PREFIX_FREEZE_THRESHOLD |
3 |
open-sse/services/compression/prefixFreeze.ts |
Sistēmas uzvednes novērojumu skaits, pirms tā tiek uzskatīta par iesaldētu, stabilu prefiksu. |
OMNIROUTE_BOOTSTRAPPED |
false |
src/app/(dashboard)/dashboard/page.tsx |
Sākotnējās iestatīšanas laikā sāknēšanas skripts iestata vērtību true. Kontrolē iestatīšanas vedņa redzamību. |
OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE |
0 |
open-sse/executors/antigravity.ts |
Avārijas risinājums: ļauj pieprasījuma pamattekstam pārrakstīt Antigravity projekta lauku. |
ANTIGRAVITY_CREDITS |
off |
open-sse/services/antigravityCredits.ts |
Google One AI kredītu politika: off nekad nepievieno kredītus, retry tos pievieno vienreiz pēc atbilstošas kvotas kļūdas 429, bet always tos pievieno pirmajam pieprasījumam. |
ANTIGRAVITY_ALLOW_SIGNATURE_BYPASS |
0 |
open-sse/translator/request/openai-to-gemini.ts |
Ļauj Antigravity pieprasījumu tulkotājam izlaist stingro CLI pieprasījuma paraksta validāciju, ja augšupstraumes pakalpojums noraida īstus parakstus (atkļūdošanas/novecojuša CLI režīms). Vērtība, kas nav nulle, iespējo apiešanu. |
AGY_TOKEN_FILE |
~/.gemini/antigravity-cli/antigravity-oauth-token |
src/app/api/providers/agy-auth/apply-local/route.ts |
Pārraksta Antigravity CLI (agy) pilnvaras faila ceļu automātiski noteiktās lokālās pieteikšanās importēšanai. |
OAuth CLI tilts (iekšējs)
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_SERVER |
automātiska noteikšana | src/lib/oauth/config/index.ts |
Servera URL CLI↔OmniRoute autentifikācijas tiltam. |
OMNIROUTE_TOKEN |
(nav iestatīts) | src/lib/oauth/config/index.ts |
Autentifikācijas pilnvara CLI tiltam. |
OMNIROUTE_USER_ID |
cli |
src/lib/oauth/config/index.ts |
Lietotāja ID CLI tilta sesijām. |
SERVER_URL |
(nav iestatīts) | src/lib/oauth/config/index.ts |
Novecojis OMNIROUTE_SERVER aizstājvārds. |
CLI_TOKEN |
(nav iestatīts) | src/lib/oauth/config/index.ts |
Novecojis OMNIROUTE_TOKEN aizstājvārds. |
CLI_USER_ID |
(nav iestatīts) | src/lib/oauth/config/index.ts |
Novecojis OMNIROUTE_USER_ID aizstājvārds. |
11. OAuth nodrošinātāju akreditācijas dati
Iebūvēti akreditācijas dati izstrādei localhost vidē. Attālinātām izvietošanām reģistrējiet savus datus katra nodrošinātāja izstrādātāju konsolē.
| Mainīgais | Nodrošinātājs | Piezīmes |
|---|---|---|
CLAUDE_OAUTH_CLIENT_ID |
Claude Code (Anthropic) | Publisks klients — noslēpums nav nepieciešams. |
CLAUDE_CODE_REDIRECT_URI |
Claude Code | Novirzīšanas URI pārrakstīšana. Noklusējums: https://platform.claude.com/oauth/code/callback |
CODEX_OAUTH_CLIENT_ID |
Codex / OpenAI | Publisks klients. |
GEMINI_OAUTH_CLIENT_ID |
Gemini (Google) | Nepieciešams atbilstošs _SECRET. |
GEMINI_OAUTH_CLIENT_SECRET |
Gemini (Google) | — |
KIMI_CODING_OAUTH_CLIENT_ID |
Kimi Coding (Moonshot) | Publisks klients. |
ANTIGRAVITY_OAUTH_CLIENT_ID |
Antigravity (Google) | Nepieciešams atbilstošs _SECRET. |
ANTIGRAVITY_OAUTH_CLIENT_SECRET |
Antigravity (Google) | — |
GITHUB_OAUTH_CLIENT_ID |
GitHub Copilot | Publisks klients. |
GHE_COPILOT_OAUTH_CLIENT_ID |
GHE Copilot | Neobligāta GitHub Enterprise Copilot OAuth klienta ID pārrakstīšana. Ja nav iestatīts, tiek izmantota GITHUB_OAUTH_CLIENT_ID publiskā noklusējuma vērtība. |
WINDSURF_API_KEY |
Windsurf / Devin (v3.8) | Rezerves API atslēga, ko open-sse/executors/devin-cli.ts izmanto, ja nav pieejami konkrētā savienojuma akreditācijas dati. Neobligāta. |
CLI_DEVIN_BIN |
Devin CLI (v3.8) | Pielāgots ceļš uz Devin CLI bināro failu (devin). To nosaka open-sse/executors/devin-cli.ts. |
GITLAB_DUO_OAUTH_CLIENT_ID |
GitLab Duo (v3.8) | GitLab Duo OAuth klienta ID. Reģistrējiet lietotni vietnē https://gitlab.com/-/profile/applications, norādot novirzīšanas URI <NEXT_PUBLIC_BASE_URL>/callback un tvērumus api, read_user, openid, profile, email. Rezerves vērtība ir GITLAB_OAUTH_CLIENT_ID. |
GITLAB_DUO_OAUTH_CLIENT_SECRET |
GitLab Duo (v3.8) | GitLab Duo OAuth klienta noslēpums. Neobligāts — PKCE plūsmai noslēpums nav nepieciešams. Rezerves vērtība ir GITLAB_OAUTH_CLIENT_SECRET. |
GITLAB_DUO_BASE_URL |
GitLab Duo (v3.8) | GitLab bāzes URL pārrakstīšana (pašmitinātam GitLab). Noklusējums ir https://gitlab.com. Rezerves vērtība ir GITLAB_BASE_URL. |
GITLAB_BASE_URL |
GitLab Duo (v3.8) | Mantotā rezerves vērtība mainīgajam GITLAB_DUO_BASE_URL. Tiek izmantota, ja _DUO_ variants nav iestatīts. |
GITLAB_OAUTH_CLIENT_ID |
GitLab Duo (v3.8) | Mantotā rezerves vērtība mainīgajam GITLAB_DUO_OAUTH_CLIENT_ID, ko izmanto src/lib/oauth/constants/oauth.ts. |
GITLAB_OAUTH_CLIENT_SECRET |
GitLab Duo (v3.8) | Mantotā atkāpšanās opcija GITLAB_DUO_OAUTH_CLIENT_SECRET, ko izmanto src/lib/oauth/constants/oauth.ts. |
QODER_OAUTH_CLIENT_SECRET |
Qoder | — |
QODER_OAUTH_AUTHORIZE_URL |
Qoder | Iestatiet, lai iespējotu Qoder OAuth. |
QODER_OAUTH_TOKEN_URL |
Qoder | — |
QODER_OAUTH_USERINFO_URL |
Qoder | — |
QODER_OAUTH_CLIENT_ID |
Qoder | — |
QODER_PERSONAL_ACCESS_TOKEN |
Qoder | Tiešās API atslēgas atkāpšanās opcija (apiet OAuth). |
QODER_CLI_WORKSPACE |
Qoder | Qoder CLI darbvietas ID. |
OMNIROUTE_QODER_WORKSPACE |
Qoder | QODER_CLI_WORKSPACE aizstājvārds. |
QODER_CLI_CONFIG_DIR |
Qoder | Aizstāj Qoder CLI konfigurācijas direktoriju (izolēta PAT sesija, novērš pārlūkprogrammas pieteikšanās datu pārrakstīšanu). |
BLACKBOX_WEB_VALIDATED_TOKEN |
Blackbox Web | Priekšgala tk marķieris, kas jānosūta kā validated uz /api/chat. Nepieciešams, ja Blackbox uzspiež marķieru atbilstību; pretējā gadījumā OmniRoute izmanto nejaušu UUID. Skatiet problēmu #2252. |
VISION_BRIDGE_BASE_URL |
Vision Bridge aizsargsistēma | Ar OpenAI saderīgs bāzes URL ne-Anthropic vision-bridge izsaukumiem. Pēc noklusējuma izmanto mantoto OpenAI URL vides mainīgo vai api.openai.com. Norādiet uz OmniRoute /v1 pašcilpu vai jebkuru ar OpenAI saderīgu galapunktu (Gemini OpenAI-compat, OpenRouter). Problēma #2232. Ja URL ir paša OmniRoute /v1, aprakstīšanas apakšpieprasījums nosūta x-omniroute-admission-bypass: internal un autentificējas ar atrisināto pašcilpas akreditācijas informāciju (sk_omniroute sargvērtība lokālajā režīmā vai OMNIROUTE_API_KEY / ROUTER_API_KEY — #1350), lai darbotos izvietojumi ar REQUIRE_API_KEY=true. |
VISION_BRIDGE_API_KEY |
Vision Bridge aizsargsistēma | API atslēga iepriekš norādītajam URL. Ne-Anthropic vision-bridge izsaukumiem tai ir priekšroka pār katram nodrošinātājam paredzētajiem OpenAI / Google vides mainīgajiem. Anthropic modeļi turpina izmantot tiem paredzēto Anthropic atslēgas ceļu. Problēma #2232. |
Warning
- Dodieties uz Google Cloud Console → Akreditācijas dati
- Izveidojiet OAuth 2.0 klienta ID (tips: "Tīmekļa lietojumprogramma")
- Pievienojiet sava servera URL kā autorizēto novirzīšanas URI
- Aizstājiet akreditācijas datu vērtības failā
.env.
12. Pakalpojumu sniedzēju User-Agent pārrakstīšana
Pārrakstiet User-Agent galveni, kas tiek nosūtīta katram augšupējam pakalpojumu sniedzējam. Izpildes laikā to dinamiski nosaka izpildītāja bāzes klase:
process.env[`${PROVIDER_ID}_USER_AGENT`]
Avots:
open-sse/executors/base.ts→buildHeaders()
| Mainīgais | Noklusējuma vērtība | Kad atjaunināt | |
|---|---|---|---|
CLAUDE_USER_AGENT |
claude-cli/2.1.258 (external, cli) |
Kad Anthropic izlaiž jaunu CLI versiju | |
CLAUDE_DISABLE_TOOL_NAME_CLOAK |
false |
executors/base.ts + executors/cliproxyapi.ts |
Iestatiet uz 1/true, lai abos uz Anthropic vērstajos ceļos (vietējais OAuth un CLIProxyAPI) trešo pušu ietvaru rīku nosaukumus pārsūtītu Anthropic nemainītā veidā. Pēc noklusējuma izpildītājs deterministiski piešķir aizstājvārdus rīku nosaukumiem, kas nepieder Claude Code (izmantojot Claude Code kanonisko kartējumu, ja tāds pastāv, pretējā gadījumā — PascalCase), un atbildē atjauno tos, izmantojot _toolNameMap, lai ietvari ar snake_case rīkiem netiktu noraidīti kā identificēti trešo pušu klienti. Tikai atkļūdošanai. |
CODEX_USER_AGENT |
codex-cli/0.142.0 (Windows 10.0.26200; x64) |
Kad OpenAI atjaunina Codex CLI | |
CODEX_CLIENT_VERSION |
0.131.0 |
Pārrakstīt Codex klienta versiju neatkarīgi no pilnās UA virknes | |
CLAUDE_CODE_CLIENT_VERSION |
2.1.258 |
Pārrakstīt norādīto Claude Code versiju neatkarīgi no CLAUDE_USER_AGENT. Anthropic ierobežo piekļuvi dažiem modeļiem, pamatojoties uz šo vērtību (#12417). |
|
GITHUB_COPILOT_CLI_VERSION |
1.0.81-6 |
Pārrakstīt norādīto Copilot CLI versiju neatkarīgi no GITHUB_USER_AGENT |
|
GITHUB_USER_AGENT |
GitHubCopilotChat/0.54.0 |
Kad GitHub Copilot Chat tiek atjaunināts | |
ANTIGRAVITY_USER_AGENT |
antigravity/2.0.1 darwin/arm64 |
Kad Antigravity IDE tiek atjaunināta | |
KIRO_USER_AGENT |
AWS-SDK-JS/3.0.0 kiro-ide/1.0.0 |
Kad Kiro IDE tiek atjaunināta | |
KIRO_OAUTH_CLIENT_ID |
kiro-cli |
Pārrakstīt Kiro sociālās ierīces koda clientId (publisko ID) |
|
KIRO_VERIFY_FULL_CRC |
false |
Pēc izvēles: pilna katra kadra ziņojuma CRC validācija Kiro notikumu straumē (bojātu straumju atkļūdošanai) | |
QODER_USER_AGENT |
Qoder-Cli |
Kad Qoder CLI tiek atjaunināta | |
CURSOR_USER_AGENT |
Cursor/3.3 |
Kad Cursor tiek atjaunināts |
Tip
Varat pievienot User-Agent pārrakstīšanu jebkuram pakalpojumu sniedzējam, izmantojot modeli
{PROVIDER_ID}_USER_AGENT. Izpildītājs dinamiski izveido vides mainīgā nosaukumu.
13. CLI digitālā nospieduma saderība
Kad šī funkcija ir iespējota, OmniRoute pārkārto HTTP galvenes un JSON pamatteksta laukus, lai tie precīzi atbilstu oficiālo CLI rīku signatūrai. Tas samazina konta atzīmēšanas risku, vienlaikus saglabājot jūsu starpniekservera IP adresi.
Avots: open-sse/config/cliFingerprints.ts, open-sse/executors/base.ts
Katram nodrošinātājam
| Mainīgais | Aktivizēšana | Efekts |
|---|---|---|
CLI_COMPAT_CODEX |
=1 |
Atdarina Codex CLI pieprasījuma signatūru |
CLI_COMPAT_CLAUDE |
=1 |
Atdarina Claude Code pieprasījuma signatūru |
CLI_COMPAT_GITHUB |
=1 |
Atdarina GitHub Copilot pieprasījuma signatūru |
CLI_COMPAT_ANTIGRAVITY |
=1 |
Atdarina Antigravity pieprasījuma signatūru |
CLI_COMPAT_CURSOR |
=1 |
Atdarina Cursor pieprasījuma signatūru |
CLI_COMPAT_KIMI_CODING |
=1 |
Atdarina Kimi Coding pieprasījuma signatūru |
CLI_COMPAT_KILOCODE |
=1 |
Atdarina Kilo Code pieprasījuma signatūru |
CLI_COMPAT_CLINE |
=1 |
Atdarina Cline pieprasījuma signatūru |
Globāli
| Mainīgais | Aktivizēšana | Efekts |
|---|---|---|
CLI_COMPAT_ALL |
=1 |
Iespējo digitālā nospieduma saderību visiem nodrošinātājiem reizē. |
Kimi Coding CLI identitātes pārrakstīšana
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
KIMI_CLI_VERSION |
1.36.0 |
src/lib/oauth/providers/kimi-coding.ts |
Pārraksta OAuth/API izsaukumu laikā nosūtīto Kimi CLI versiju. |
KIMI_CODING_DEVICE_ID |
(tvertā noklusējuma vērtība) | src/lib/oauth/providers/kimi-coding.ts |
Pārraksta tverto Kimi ierīces ID, kas tiek izmantots klienta galvenēs. |
Note
Šī funkcija darbojas kopā ar User-Agent pārrakstīšanu (§12). Digitālā nospieduma sistēma pārvalda galveņu un pamatteksta lauku secību, savukārt User-Agent pārrakstīšana pārvalda konkrēto UA virkni. Abas funkcijas var iespējot neatkarīgi.
14. API atslēgu nodrošinātāji
API atslēgas nodrošinātājiem, kuri izmanto tiešo autentifikāciju. Ieteicamā iestatīšana: Informācijas panelis → Nodrošinātāji → Pievienot API atslēgu.
Iestatīšana, izmantojot vides mainīgos, ir alternatīva Docker vai bezgalvas izvietojumiem.
Atpazītais formāts: {PROVIDER_ID}_API_KEY
| Mainīgais | Nodrošinātājs |
|---|---|
DEEPSEEK_API_KEY |
DeepSeek |
NVIDIA_API_KEY |
NVIDIA NIM |
JINA_AI_API_KEY |
Jina AI (Foundation API + Reader atkāpšanās mehānisms) |
JINA_API_KEY |
Jina AI (JINA_AI_API_KEY aizstājvārds) |
GEMINI_API_KEY |
Gemini (Google AI Studio) iegulšanas + tērzēšanas atkāpšanās mehānisms |
GOOGLE_API_KEY |
Gemini (GEMINI_API_KEY aizstājvārds) |
Note
Statiskie
${PROVIDER}_API_KEYieraksti Groq, xAI, Mistral, Perplexity, Together AI, Fireworks, Cerebras, Cohere, Nebius un Qianfan nodrošinātājiem tika noņemti versijā v3.8.0, jo izpildlaika vide tos vairs nenolasa — šie nodrošinātāji izmanto tikai informācijas paneli /data/provider-credentials.json/ šifrēto datubāzi. Migrācijas norādes skatiet sadaļā Audits: noņemtie / neizmantotie mainīgie šī dokumenta beigās.
Tip
Informācijas panelī iestatītās atslēgas tiek glabātas šifrētā veidā SQLite datubāzē, un tām ir prioritāte pār vides mainīgajiem.
Jina:
jina-ai/…iegulšanas, pārkārtošanas, klasificēšanas un segmentēšanas modeļi, kā arījina-search, neizmanto klastera vides atslēgu norēķiniem, ja pastāv informācijas paneļajina-ai(vai koplietotsjina-reader) savienojums —getProviderCredentialsvispirms aizpilda trūkstošās vērtības.JINA_AI_API_KEY/JINA_API_KEYtiek izmantoti tikai tad, ja nav pieejama lietojama informācijas paneļa atslēga. Izsaukumu žurnālos vides atkāpšanās mehānisms tiek norādīts kāconnection_id=env:JINA_AI_API_KEY. Reader kartīte (jina-reader,r.jina.ai) nekad neapkalpo/v1/embeddingsvai/v1/rerank.Gemini:
gemini/gemini-embedding-2(aizstājvārdsgoogle/gemini-embedding-2) vispirms izmanto informācijas paneļageminisavienojumu.GEMINI_API_KEY/GOOGLE_API_KEYtiek izmantoti tikai tad, ja nav pieejama lietojama informācijas paneļa atslēga. Izsaukumu žurnālos vides atkāpšanās mehānisms tiek norādīts kāconnection_id=env:GEMINI_API_KEY. Vietējā multimodālā datplūsma izmantox-goog-api-keyar:embedContent/:batchEmbedContents— N OpenAIinputvienumi kļūst par N vektoriem.
15. Taimauta iestatījumi
Visas vērtības ir norādītas milisekundēs. Centralizēta vērtību noteikšana failā src/shared/utils/runtimeTimeouts.ts.
Taimautu hierarhija
REQUEST_TIMEOUT_MS (globāla pārrakstīšana)
├─→ FETCH_TIMEOUT_MS (ārējo pakalpojumu sniedzēju izsaukumi, noklusējums: 600000)
│ ├─→ FETCH_HEADERS_TIMEOUT_MS (manto no FETCH_TIMEOUT_MS)
│ ├─→ FETCH_BODY_TIMEOUT_MS (manto no FETCH_TIMEOUT_MS)
│ ├─→ TLS_CLIENT_TIMEOUT_MS (manto no FETCH_TIMEOUT_MS)
│ │ └── TLS_FIRST_BYTE_WATCHDOG_MS (neatkarīgs, noklusējums: 10000)
│ ├── RESPONSES_FIRST_BYTE_TIMEOUT_MS (neatkarīgs, noklusējums: 15000)
│ ├── FETCH_CONNECT_TIMEOUT_MS (neatkarīgs, noklusējums: 30000)
│ └── FETCH_KEEPALIVE_TIMEOUT_MS (neatkarīgs, noklusējums: 4000)
├─→ STREAM_IDLE_TIMEOUT_MS (manto no REQUEST_TIMEOUT_MS, noklusējums: 600000)
├─→ STREAM_ACTIVE_TIMEOUT_MS (neatkarīgs, noklusējums: 1260000; 0 atspējo)
├─→ STREAM_READINESS_TIMEOUT_MS (manto no REQUEST_TIMEOUT_MS, noklusējums: 80000)
├─→ STREAM_READINESS_MAX_TIMEOUT_MS (ierobežo adaptīvos gatavības pagarinājumus, noklusējums: 180000)
└─→ API_BRIDGE_PROXY_TIMEOUT_MS (manto no REQUEST_TIMEOUT_MS, noklusējums: 30000)
├─→ API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS (atvasināts, noklusējums: 300000)
├── API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS (noklusējums: 60000)
├── API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS (noklusējums: 5000)
└── API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS (noklusējums: 0 = atspējots)
| Mainīgais | Noklusējums | Apraksts |
|---|---|---|
REQUEST_TIMEOUT_MS |
(nav iestatīts) | Globāla saīsne — pārraksta gan FETCH_TIMEOUT_MS, gan STREAM_IDLE_TIMEOUT_MS noklusējuma vērtības. |
FETCH_TIMEOUT_MS |
600000 |
Kopējais HTTP pieprasījuma taimauts augšupstraumes nodrošinātāja izsaukumiem. |
STREAM_IDLE_TIMEOUT_MS |
600000 |
Maksimālais klusuma periods starp neapstrādātiem augšupstraumes baitiem, pirms darbība tiek pārtraukta. Modeļi ar paplašināto spriešanu reti apstājas uz >90 s. |
STREAM_ACTIVE_TIMEOUT_MS |
1260000 |
Maksimālais kopējais aktīvās SSE straumes darbības ilgums; tas nekad netiek atiestatīts, saņemot augšupstraumes baitus, un nav atkarīgs no REQUEST_TIMEOUT_MS. Atvasināts no reģistrā lielākās katram modelim noteiktās timeoutMs vērtības (1200000, Codex), pieskaitot 60000 rezervi, tādēļ modelis, kuram atļauts izmantot visu tam piešķirto laiku, nekad netiek apturēts atbildes vidū. Iestatiet uz 0, lai atspējotu. |
OMNIROUTE_SSE_COMMENTS |
(atspējots) | Nosaka, vai OmniRoute drīkst izvadīt SSE : komentāru rindas (piem., : keepalive sirdspukstu un x-omniroute-* metadatu beigu ierakstus). Pēc noklusējuma atspējots (#10524), jo stingri ar OpenAI saderīgi klienti katrai SSE rindai izsauc JSON.parse un avarē, sastopot : komentārus; data: sirdspuksti netiek ietekmēti. Iestatiet on/true/1/yes, lai atkal iespējotu. Izmanto open-sse/utils/sseHeartbeat.ts. |
STREAM_READINESS_TIMEOUT_MS |
80000 |
Laiks līdz pirmā SSE notikuma, kas nav ping, saņemšanai. Ja ir iestatīts REQUEST_TIMEOUT_MS, manto tā vērtību. |
STREAM_READINESS_MAX_TIMEOUT_MS |
180000 |
Maksimālais adaptīvais pirmā notikuma gatavības gaidīšanas periods lieliem straumēšanas pieprasījumiem, pieprasījumiem ar daudziem rīkiem vai intensīvu spriešanu. |
OMNIROUTE_AGENT_GOAL_POLICY_ENABLED |
true |
Avārijas slēdzis /goal heiristikai. Iestatiet false/0/off, lai pilnībā atspējotu noteikšanu — gatavības taimauti un straumes atkopšana nekad netiek palielināti, pamatojoties uz pieprasījuma pamattekstu/galvenēm, tādējādi mazinot klienta kontrolētas taimauta palielināšanas risku. |
OMNIROUTE_AGENT_GOAL_READINESS_MAX_TIMEOUT_MS |
600000 |
Maksimālais pirmā notikuma gatavības gaidīšanas periods noteiktām /goal aģenta izpildēm vai pieprasījumiem, kas piespiedu kārtā atzīmēti ar x-omniroute-agent-goal. |
OMNIROUTE_AGENT_GOAL_STREAM_RECOVERY |
true |
Automātiski iespējot agrīnu straumes atkopšanu noteiktām /goal aģenta izpildēm. Iestatiet false/0/off, lai atspējotu tieši mērķim paredzēto izvēles iespējošanu. Tas var tikai PIEVIENOT atkopšanu papildus operatora noklusējuma iestatījumam — tas nekad nepārraksta skaidru atteikšanos, kas norādīta STREAM_RECOVERY_ENABLED/DB iestatījumos. |
OMNIROUTE_CODEX_DROP_NONSTANDARD_EVENTS |
true |
Noņemt nestandarta codex.* SSE notikumus (piem., codex.rate_limits), kuru dēļ OpenAI SDK responses.stream() darbība beidzas ar 502. Pēc noklusējuma IESLĒGTS (#11014). Iestatiet 0/false/no/off, lai tos pārsūtītu. |
OMNIROUTE_CODEX_APPSERVER_WS |
(nav iestatīts) | Izvēles Codex app-server transports. Lokāla codex app-server blakusprocesa WebSocket galapunkts (ws:///wss://). Ja tas ir iestatīts kopā ar pilnvaru, Codex pieprasījumi tiek maršrutēti uz blakusprocesu, izmantojot JSON-RPC, nevis HTTP Responses API. Var iestatīt arī katram savienojumam atsevišķi, izmantojot providerSpecificData.codexAppServerUrl. Izmanto open-sse/executors/codex/appServerConfig.ts. |
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN |
(nav iestatīts) | Iekļauta iespēju/nesēja pilnvara, kas tiek uzrādīta app-server. Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerToken. |
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN_FILE |
(nav iestatīts) | Ceļš uz failu, kurā glabājas app-server iespēju pilnvara (no codex app-server --ws-token-file). Tiek izmantots, ja OMNIROUTE_CODEX_APPSERVER_WS_TOKEN nav iestatīts. Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerTokenFile. |
OMNIROUTE_CODEX_APPSERVER_CWD |
/tmp |
Darba direktorijs, kurā tiek izpildīts app-server solis. Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerCwd. |
OMNIROUTE_CODEX_APPSERVER_APPROVAL |
(nav iestatīts) | Apstiprināšanas politika, kas tiek nodota app-server solim (piem., never, on-request). Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerApprovalPolicy. |
OMNIROUTE_CODEX_APPSERVER_SANDBOX |
(nav iestatīts) | Smilškastes politika, kas tiek nodota app-server solim (piem., read-only, workspace-write, danger-full-access). Ja tā nav iestatīta, izpildītājs pēc noklusējuma izmanto workspace-write (pastiprināti aizsargāts; iepriekš danger-full-access). Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerSandbox. |
OMNIROUTE_CODEX_APPSERVER_AUTO_APPROVE |
false |
Automātiski apstiprināt paša app-server apstiprināšanas uzvednes (komandu/failu/atļauju izpilde resursdatorā). Pēc noklusējuma izslēgts — uzvednes tiek automātiski noraidītas; ietvara rīku izsaukumi netiek ietekmēti (tie tiek pārsūtīti pa atsevišķo item/tool/call caurlaides kanālu). Pieņem true/1/yes. Pārrakstīšana katram savienojumam: providerSpecificData.codexAppServerAutoApprove. |
FETCH_HEADERS_TIMEOUT_MS |
= FETCH_TIMEOUT_MS |
Laiks līdz atbildes galveņu saņemšanai. |
OMNIROUTE_DIRECT_HEADERS_TIMEOUT_MS |
30000 (30s) |
Maksimālais atbildes sākuma gaidīšanas laiks (ms) katram tiešajam mēģinājumam bez starpniekservera. Pēc taimauta mēģinājums tiek vienreiz atkārtots jaunā ligzdā; iestatiet 0, lai atspējotu ierobežojumu un saglabātu iepriekšējo darbību. |
FETCH_BODY_TIMEOUT_MS |
= FETCH_TIMEOUT_MS |
Laiks pilna atbildes pamatteksta saņemšanai. |
FETCH_CONNECT_TIMEOUT_MS |
30000 |
TCP savienojuma izveides taimauts. |
FETCH_KEEPALIVE_TIMEOUT_MS |
4000 |
Keep-alive ligzdas dīkstāves taimauts. |
TLS_CLIENT_TIMEOUT_MS |
= FETCH_TIMEOUT_MS |
TLS digitālnospieduma starpniekservera (wreq-js) taimauts. |
TLS_FIRST_BYTE_WATCHDOG_MS |
10000 |
Ierobežo laiku līdz pirmajam baitam tieši wreq-js TLS digitālnospieduma transporta pamattekstam; TLS_CLIENT_TIMEOUT_MS viens pats nevar konstatēt iestrēgušu pamattekstu, jo tas tiek izpildīts, tiklīdz saņemtas galvenes (#12656). Taimauta gadījumā wreq lasītājs tiek atcelts un notiek pārslēgšanās uz tiešo/starpniekservera dispečeru; 0 atspējo uzraugu. |
RESPONSES_FIRST_BYTE_TIMEOUT_MS |
15000 |
Tikai OpenCode izpildītājam un tikai tad, kamēr funkcijas karogs OPENCODE_RESPONSES_STALL_ROTATION ir ieslēgts (pēc noklusējuma izslēgts): ierobežo pirmā pamatteksta baita gaidīšanas laiku straumētai Responses atbildei pēc tās galveņu saņemšanas (#13484). Responses straume sākas ar response.created, tādēļ klusums pēc šī perioda nozīmē iestrēgšanu: kontam tiek piemērots nogaidīšanas periods, un pieprasījums vienreiz tiek novirzīts uz nākamo kontu; otrās iestrēgšanas gadījumā darbība nekavējoties neizdodas. 0 atspējo aizsardzību pat tad, ja karogs ir ieslēgts. |
API_BRIDGE_PROXY_TIMEOUT_MS |
30000 |
Starpniekservera posma taimauts /v1 tilta pieprasījumiem. |
FIRECRAWL_BASE_URL |
https://api.firecrawl.dev |
Novirza Firecrawl tīmekļa izgūšanas izpildītāju uz pašmitinātu instanci (ārpus mākoņa API atslēga nav obligāta). |
FIRECRAWL_TIMEOUT_MS |
30000 |
Katra pieprasījuma taimauts Firecrawl tīmekļa izgūšanas izpildītājam. |
API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS |
300000 |
Kopējais tilta servera pieprasījuma taimauts. |
API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS |
60000 |
Atbildes galveņu nosūtīšanai caur tiltu atvēlētais laiks. |
API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS |
5000 |
Tilta keep-alive dīkstāves taimauts. |
API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS |
0 |
Neapstrādātas ligzdas taimauts (0 = atspējots). |
SHUTDOWN_TIMEOUT_MS |
30000 |
Labvēlības periods pēc SIGTERM/SIGINT pirms piespiedu iziešanas. |
OMNIROUTE_DEFAULT_FETCH_TIMEOUT_MS |
120000 |
Rezerves vērtība, ko izmanto src/shared/utils/fetchTimeout.ts, ja FETCH_TIMEOUT_MS nav iestatīts. |
OMNIROUTE_PROVIDER_PROBE_TIMEOUT_MS |
8000 |
Taimauts (ms) validationRead un modelsProbe priekšiestatījumiem failā src/shared/network/safeOutboundFetch.ts. Palieliniet lēniem galapunktiem (Cerebras, Cloudflare AI, Groq), lai informācijas panelī novērstu svārstības starp aktīvu un kļūdas stāvokli. Nederīgām (<1000) vai neskaitliskām vērtībām tiek izmantota rezerves vērtība 8000ms. |
OMNIROUTE_RELAY_FETCH_TIMEOUT_MS |
25000 |
Relejam specifisks izgūšanas taimauts failā open-sse/utils/proxyFetch.ts (#9158). Iestrēgušam relejam jābeidz darbība ar kļūdu pirms klienta/aģenta taimauta (~30s), lai izsaucēji vispārīga augšupstraumes taimauta vietā redzētu relejam specifisku kļūmi. Ierobežots līdz 29000, lai tas vienmēr nostrādātu pirmais. |
OMNIROUTE_RETRY_BACKOFF_MS |
10 |
Kopīga atkārtota mēģinājuma aizkave tiešajiem/releja/starpniekservera vienreizējas atkārtošanas ceļiem failā open-sse/utils/proxyFetch.ts (#9158). 0 = atkārtot nekavējoties. |
OMNIROUTE_CLAUDE_TLS_TIMEOUT_MS |
60000 |
Iebūvētais wreq-js pieprasījuma taimauts (claudeTlsClient.ts). |
OMNIROUTE_CLAUDE_TLS_GRACE_MS |
10000 |
Absolūta JS stingrā termiņa papildlaiks, kas tiek pievienots iebūvētajam taimautam. |
OMNIROUTE_PPLX_TLS_TIMEOUT_MS |
30000 |
Iebūvētais wreq-js pieprasījuma taimauts (perplexityTlsClient.ts). |
OMNIROUTE_PPLX_TLS_GRACE_MS |
10000 |
Absolūta JS stingrā termiņa papildlaiks, kas tiek pievienots iebūvētajam taimautam. |
OMNIROUTE_PPLX_SEARCH_HINT |
0 (izslēgts) |
Izsaucēja sistēmas ziņojumam pievieno tekstu "Jums ir iebūvēta meklēšana tīmeklī. Atbildiet uz jautājumiem tieši, izmantojot meklēšanas rezultātus." (perplexity-web/protocol.ts). Pēc noklusējuma izslēgts — Perplexity tik un tā veic meklēšanu, un šis teikums nonāk atbildēs kā metakomentārs kodēšanas klientiem. Iestatiet 1/true/yes/on, lai atjaunotu. |
OMNIROUTE_GROK_TLS_TIMEOUT_MS |
60000 |
Vietējā wreq-js pieprasījuma taimauts (grokTlsClient.ts). |
OMNIROUTE_GROK_TLS_GRACE_MS |
10000 |
Absolūtā JS stingrā termiņa rezerve, kas tiek pievienota vietējam taimautam. |
OMNIROUTE_NOTION_TLS_TIMEOUT_MS |
30000 |
Vietējā wreq-js pieprasījuma taimauts (notionTlsClient.ts); ilgām ģenerēšanām notion-web katram pieprasījumam to palielina līdz 180000. |
OMNIROUTE_NOTION_TLS_GRACE_MS |
10000 |
Absolūtā JS stingrā termiņa rezerve, kas tiek pievienota vietējam taimautam. |
OMNIROUTE_BROWSER_POOL |
on |
Koplietojams Playwright pārlūkprogrammu pūls tīmekļa sīkfailu tērzēšanai, ko nodrošina pārlūkprogramma (browserPool.ts); iestatiet off, lai atspējotu. |
OBSCURA_BIN |
auto-detect |
Ceļš uz obscura bināro failu, ko pārlūkprogrammu pūls un Cloudflare Playground izpildītājs izmanto kā primāro dzini (open-sse/services/obscura.ts); ja nav iestatīts, tas tiek automātiski atrasts sistēmas PATH. |
OBSCURA_CDP_ENDPOINT |
(nav iestatīts) | Norādiet uz jau palaistu Obscura instanci (http://host:port), nevis izveidojiet jaunu; modulis nepārvalda šo procesu (open-sse/services/obscura.ts). |
OBSCURA_PORT |
nejaušs brīvs ports |
Konkrēts ports palaistajam obscura serve; ja tas nav iestatīts, automātiski tiek izvēlēts brīvs ports (open-sse/services/obscura.ts). |
WEB_COOKIE_USE_BROWSER |
0 |
Novirza tīmekļa sīkfailu tērzēšanas pieprasījumu uz pārlūkprogrammas nodrošināto ceļu (browserBackedChat.ts); iestatiet 1, lai iespējotu. |
KIMI_WEB_BASE_URL |
https://www.kimi.ai |
Kimi Web (starptautiskā kimi.ai Connect-RPC) izpildītāja bāzes URL (kimi-web.ts); mainiet tikai spoguļa/starpniekservera galapunktiem. |
KIMI_WEB_CHAT_URL |
<KIMI_WEB_BASE_URL>/apiv2/kimi.gateway.chat.v1.ChatService/Chat |
Pilns Kimi Web izpildītāja tērzēšanas galapunkts (kimi-web.ts). |
OMNIROUTE_LOGIN_BROWSER_PATH |
(automātiski noteikts) | Ceļš uz sistēmas Chrome/Edge izpildāmo failu Adobe Firefly interaktīvajai pierakstīšanai pārlūkprogrammā (adobeFireflyBrowserLogin.ts); aizstāj katrai OS paredzēto automātisko noteikšanu. |
OMNIROUTE_STANDALONE_DIR |
.build/ autonomās izvades direktorijs | Kompilēšanas laika aizstāšana autonomās izvades direktorijam, ko izmanto pēckompilēšanas līdzizvietošanas darbība (scripts/build/colocate-standalone.mjs); paredzēts kompilēšanas rīkiem, nevis izpildlaikam. |
Kombinētā mērķa mēģinājumi pārmanto atrisināto augšupstraumes pieprasījuma taimautu (FETCH_TIMEOUT_MS vai
REQUEST_TIMEOUT_MS, ja tas nodrošina fetch noklusējuma vērtību). Iestatiet targetTimeoutMs kombinācijā,
kombinācijas noklusējuma iestatījumos vai nodrošinātāja aizstāšanā tikai tādēļ, lai paātrinātu kombinācijas pārslēgšanos uz rezerves variantu; vērtības, kas pārsniedz
pašreizējo augšupstraumes taimautu, tiek ierobežotas līdz augšupstraumes taimautam.
comboTimeoutMs ir atsevišķs kopējās kombinācijas reālā laika budžets visiem kļūmjpārlēces mērķiem.
Atstājiet to neiestatītu vai iestatiet uz 0, lai saglabātu neierobežotu iterāciju (10 minūšu
COMBO_LOOP_SAFETY_TIMEOUT_MS aizsardzība pret iestrēgšanu joprojām ir spēkā). Pozitīva vērtība aizstāj šo
kombinācijas drošības mehānismu. Iestatiet comboTimeoutMs ilgāku par targetTimeoutMs, lai kļūmjpārlēcei
joprojām pietiktu laika pēc lēna pirmā mērķa.
Ķēdes pārtraucēja sliekšņi
Nodrošinātāja līmeņa ķēdes pārtraucēja pielāgošana. Noklusējuma vērtības atspoguļo mērogotās vērtības, kas kopš v3.6 tiek izmantotas vairāk nekā 500 savienojumiem.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_THRESHOLD |
8 |
open-sse/config/constants.ts |
Secīgu kļūmju slieksnis OAuth nodrošinātājiem, pēc kura tiek aktivizēts automātiskais slēdzis. |
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_RESET_MS |
60000 |
open-sse/config/constants.ts |
OAuth nodrošinātāja automātiskā slēdža atiestatīšanas intervāls (ms). |
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_THRESHOLD |
12 |
open-sse/config/constants.ts |
Secīgu kļūmju slieksnis API atslēgas nodrošinātājiem. |
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_RESET_MS |
30000 |
open-sse/config/constants.ts |
API atslēgas nodrošinātāja automātiskā slēdža atiestatīšanas intervāls (ms). |
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_THRESHOLD |
2 |
open-sse/config/constants.ts |
Secīgu kļūmju slieksnis lokālajiem nodrošinātājiem (Ollama, LM Studio, ...). |
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_RESET_MS |
15000 |
open-sse/config/constants.ts |
Lokālā nodrošinātāja automātiskā slēdža atiestatīšanas intervāls (ms). |
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_THRESHOLD |
10 |
open-sse/config/constants.ts |
Nodrošinātāja līmeņa automātiskais slēdzis: kļūmju skaits laika logā, pēc kura visam OAuth nodrošinātājam sākas nogaidīšanas periods. |
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_WINDOW_MS |
900000 |
open-sse/config/constants.ts |
Nodrošinātāja līmeņa automātiskais slēdzis: slīdošais kļūmju uzskaites logs (ms) OAuth nodrošinātājiem. |
OMNIROUTE_PROVIDER_BREAKER_OAUTH_COOLDOWN_MS |
300000 |
open-sse/config/constants.ts |
Nodrošinātāja līmeņa automātiskais slēdzis: nogaidīšanas periods (ms), kad sasniegts OAuth nodrošinātāja slieksnis. |
OMNIROUTE_PROVIDER_BREAKER_OAUTH_DEGRADATION_THRESHOLD |
5 |
open-sse/config/constants.ts |
Pie šāda kļūmju skaita OAuth nodrošinātājs pāriet stāvoklī DEGRADED. |
OMNIROUTE_PROVIDER_BREAKER_OAUTH_MAX_BACKOFF_MULTIPLIER |
8 |
open-sse/config/constants.ts |
OAuth nodrošinātāja maksimālais resetTimeout palielināšanas reizinātājs. |
OMNIROUTE_PROVIDER_BREAKER_OAUTH_BACKOFF_ESCALATION_COUNT |
2 |
open-sse/config/constants.ts |
OAuth nodrošinātāja atkāpšanās līmenis tiek paaugstināts pēc šāda atvērtu ciklu skaita. |
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_THRESHOLD |
15 |
open-sse/config/constants.ts |
Nodrošinātāja līmeņa automātiskais slēdzis: kļūmju skaits laika logā, pēc kura visam API atslēgas nodrošinātājam sākas nogaidīšanas periods. |
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_WINDOW_MS |
1800000 |
open-sse/config/constants.ts |
Nodrošinātāja līmeņa automātiskais slēdzis: slīdošais kļūmju uzskaites logs (ms) API atslēgas nodrošinātājiem. |
OMNIROUTE_PROVIDER_BREAKER_API_KEY_COOLDOWN_MS |
600000 |
open-sse/config/constants.ts |
Nodrošinātāja līmeņa automātiskais slēdzis: nogaidīšanas periods (ms), kad sasniegts API atslēgas nodrošinātāja slieksnis. |
OMNIROUTE_PROVIDER_BREAKER_API_KEY_DEGRADATION_THRESHOLD |
7 |
open-sse/config/constants.ts |
Pie šāda kļūmju skaita API atslēgas nodrošinātājs pāriet stāvoklī DEGRADED. |
OMNIROUTE_PROVIDER_BREAKER_API_KEY_MAX_BACKOFF_MULTIPLIER |
4 |
open-sse/config/constants.ts |
API atslēgas nodrošinātāja maksimālais resetTimeout palielināšanas reizinātājs. |
OMNIROUTE_PROVIDER_BREAKER_API_KEY_BACKOFF_ESCALATION_COUNT |
3 |
open-sse/config/constants.ts |
API atslēgas nodrošinātāja atkāpšanās līmenis tiek paaugstināts pēc šāda atvērtu ciklu skaita. |
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_THRESHOLD |
2 |
open-sse/config/constants.ts |
Nodrošinātāja līmeņa automātiskais slēdzis: kļūmju skaits, pēc kura visam lokālajam nodrošinātājam sākas nogaidīšanas periods. |
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_WINDOW_MS |
300000 |
open-sse/config/constants.ts |
Nodrošinātāja līmeņa automātiskais slēdzis: slīdošais kļūmju uzskaites logs (ms) lokālajiem nodrošinātājiem. |
OMNIROUTE_PROVIDER_BREAKER_LOCAL_COOLDOWN_MS |
60000 |
open-sse/config/constants.ts |
Nodrošinātāja līmeņa automātiskais slēdzis: nogaidīšanas periods (ms), kad sasniegts lokālā nodrošinātāja slieksnis. |
PIN_DROP_BACKOFF_LEVEL |
2 |
open-sse/services/combo.ts |
Atkāpšanās dziļums, pie kura konteksta kešatmiņas piesaistes nodrošinātājs tiek uzskatīts par ilgstoši neveselīgu un piesaiste tiek atmesta, lai pārslēgtos kļūmes gadījumā. |
PIN_DROP_GRACE_MS |
20000 |
open-sse/services/combo.ts |
Svārstību novēršanas logs (ms), kurā īslaicīgi pārejoši nogaidīšanas periodi tiek pieļauti, pirms tiek atmesta konteksta kešatmiņas piesaiste. |
Scenāriji
| Scenārijs | Konfigurācija |
|---|---|
| Ilgstoša koda ģenerēšana | REQUEST_TIMEOUT_MS=900000 (15 min) |
| Kopējā straumes darbības ilguma ierobežošana | STREAM_ACTIVE_TIMEOUT_MS=1260000 (21 min) |
| Ātra kļūmes atgriešana produkcijas API | API_BRIDGE_PROXY_TIMEOUT_MS=10000 |
| Paplašinātas spriešanas modeļi | STREAM_IDLE_TIMEOUT_MS=300000 (5 min starp fragmentiem) |
16. Žurnalēšana
Žurnalēšanas sistēma raksta gan standarta izvadē (stdout), gan rotētos žurnālfailos. Visa konfigurācija tiek nolasīta no src/lib/logEnv.ts.
| Mainīgais | Noklusējums | Apraksts |
|---|---|---|
APP_LOG_LEVEL |
info |
Minimālais žurnāla līmenis: debug, info, warn, error. |
APP_LOG_FORMAT |
text |
Izvades formāts: text (cilvēklasāms) vai json (strukturēts). |
APP_LOG_TO_FILE |
true |
Rakstīt žurnālus failā papildus standarta izvadei. |
APP_LOG_FILE_PATH |
logs/application/app.log |
Žurnālfaila ceļš (relatīvs pret projekta sakni vai DATA_DIR). |
APP_LOG_MAX_FILE_SIZE |
50M |
Maksimālais faila izmērs pirms rotācijas. Pieņem: 50M, 1G, 512K vai vienkāršu baitu skaitu. |
APP_LOG_RETENTION_DAYS |
7 |
Dienu skaits, cik ilgi glabāt rotētos lietojumprogrammas žurnālfailus. |
APP_LOG_MAX_FILES |
20 |
Maksimālais rotēto žurnālfailu dublējumkopiju skaits. |
CALL_LOG_RETENTION_DAYS |
7 |
Dienu skaits, cik ilgi datubāzē glabāt pieprasījumu/izsaukumu žurnāla ierakstus. |
CALL_LOG_MAX_ENTRIES |
10000 |
Maksimālais izsaukumu žurnāla ierakstu skaits atmiņas buferī. |
CALL_LOGS_TABLE_MAX_ROWS |
100000 |
Maksimālais rindu skaits SQLite tabulā call_logs pirms ierakstu dzēšanas. |
ENABLE_REQUEST_LOGS |
(nav iestatīts) | Piespiedu kārtā ieslēgt vai izslēgt detalizētu pieprasījumu žurnalēšanu, ignorējot informācijas paneļa iestatījumu. |
MAX_PENDING_REQUEST_AGE_MS |
3600000 (1 stunda) |
Maksimālais pamestu aktīvo pieprasījumu žurnāla ierakstu vecums pirms tīrīšanas no atmiņas. |
CALL_LOG_PIPELINE_CAPTURE_STREAM_CHUNKS |
false |
Saglabāt straumes fragmentus konveijera artefaktos, ja call_log_pipeline_enabled=true. Jāiespējo apzināti (true) — pēc noklusējuma izslēgts, lai taupītu vietu diskā. |
CALL_LOG_PIPELINE_MAX_SIZE_KB |
512 |
Maksimālais konveijera izsaukumu žurnāla artefakta izmērs KB, ja call_log_pipeline_enabled=true. |
PROXY_LOGS_TABLE_MAX_ROWS |
100000 |
Maksimālais rindu skaits SQLite tabulā proxy_logs pirms ierakstu dzēšanas. |
PROXY_LOG_INCLUDE_IPS |
false |
Iekļaut klienta/izejošās IP adreses un kontu prefiksus [ProxyEgress] konsoles žurnālos. Informācijas paneļa/datubāzes starpniekservera žurnāla ierakstos tiek saglabāta pilna informācija. |
APP_LOG_ROTATION_CHECK_INTERVAL_MS |
60000 (1 min.) |
Cik bieži src/lib/logRotation.ts atkārtoti pārbauda aktīvā žurnālfaila izmēru. |
CHAT_LOG_TEXT_LIMIT |
65536 |
Maksimālais virknes garums, kas tiek saglabāts tērzēšanas žurnāla artefaktos (pēc noklusējuma 64 KB). |
CHAT_LOG_ARRAY_TAIL_ITEMS |
128 |
Masīva elementu skaits, kas tiek saglabāts no beigām, saīsinot tērzēšanas žurnāla derīgo slodzi. |
CHAT_LOG_MAX_DEPTH |
6 |
Maksimālais ligzdošanas dziļums, pēc kura tērzēšanas žurnāla derīgās slodzes tiek saīsinātas. |
CHAT_LOG_MAX_OBJECT_KEYS |
80 |
Maksimālais objekta atslēgu skaits, kas tiek saglabāts tērzēšanas žurnāla derīgajās slodzēs (0 = neierobežots). |
CHAT_LOG_MAX_BODY_KB |
1024 |
Visa pieprasījuma/atbildes pamatteksta izmērs (KB), kuru pārsniedzot pilnas kopijas vietā tas tiek aizstāts ar vienkāršu kopsavilkumu. Palieliniet šo vērtību, ja garās aģentiskās sarunās informācijas panelī īsto ziņojumu vietā tiek rādīts vietturis. |
CHAT_DEBUG_FILE |
false |
Ja vērtība ir true, serializeArtifactForStorage izlaiž uz izmēru balstītu saīsināšanu. Tikai atkļūdošanai. |
17. Atmiņas optimizācija
| Mainīgais | Noklusējums | Apraksts |
|---|---|---|
OMNIROUTE_MEMORY_MB |
automātiski (fiziskā vidē); 1024 Docker attēlā |
Ieteicamais Docker/savrupā V8 kaudzes ierobežojums (MB). Ja nav iestatīts, tas tiek dinamiski kalibrēts (~35% no sistēmas RAM, ierobežojot diapazonā [512, 4096]); 512 ir tikai minimālā vērtība gadījumā, ja kopējo atmiņas apjomu nevar nolasīt. Izmantojot run-standalone.mjs (Docker CMD), skaidri norādīta vērtība tiek pievienota kā --max-old-space-size un tai ir priekšroka pār konfliktējošu NODE_OPTIONS kaudzes karodziņu (V8 pēdējā karodziņa princips). omniroute serve joprojām dod priekšroku esošam NODE_OPTIONS kaudzes iestatījumam (#5238). Neiestatiet abiem atšķirīgus skaitļus — process žurnālā reģistrē brīdinājumu, norādot abas vērtības un to, kurai ir priekšroka. Oficiālais Docker attēls vienmēr iestata 1024, tāpēc kalibrēšana tajā nekad netiek veikta. Kodēšanas aģenta /v1/responses darbībai nepieciešami 8192–12288, kā arī cgroup rezerve — skatiet Docker rokasgrāmatu — izpildlaika RAM. |
PROMPT_CACHE_MAX_SIZE |
50 |
Maksimālais kešoto sistēmas uzvedņu ierakstu skaits. |
PROMPT_CACHE_MAX_BYTES |
2097152 (2 MB) |
Maksimālais kopējais uzvedņu kešatmiņas lielums. |
PROMPT_CACHE_TTL_MS |
300000 (5 min) |
Uzvedņu kešatmiņas ieraksta TTL. |
SEMANTIC_CACHE_MAX_SIZE |
100 |
Maksimālais kešoto atbilžu ar temperature=0 skaits. |
SEMANTIC_CACHE_MAX_BYTES |
4194304 (4 MB) |
Maksimālais kopējais semantiskās kešatmiņas lielums. |
SEMANTIC_CACHE_TTL_MS |
1800000 (30 min) |
Semantiskās kešatmiņas ieraksta TTL. |
OMNIROUTE_CORPUS_CACHE_SIZE |
5 |
Lokālā korpusa saknes, kuru aktīvais atmiņā esošais indekss tiek vienlaikus uzturēts (src/lib/localCorpus/configured.ts). LRU: sasniedzot ierobežojumu, visilgāk neizmantotās saknes indekss tiek izmests un pārbūvēts nākamā vaicājuma laikā. Minimālā vērtība ir 1; ja vērtība nav skaitlis, tiek izmantota noklusējuma vērtība. |
STREAM_HISTORY_MAX |
50 |
Maksimālais neseno straumes notikumu skaits informācijas paneļa reāllaika skata buferī. |
CONTEXT_LENGTH_DEFAULT |
128000 |
Globālais rezerves maksimālais konteksta garums modeļiem bez skaidri norādītas konfigurācijas. |
USAGE_TOKEN_BUFFER |
100 |
Papildu marķieru rezerve, kas tiek atvēlēta lietojuma kvotu uzskaitei. |
Saspiešana
| Mainīgais | Noklusējums | Apraksts |
|---|---|---|
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS |
nav iestatīts | Uzticēties projekta .rtk/filters.json bez .rtk/trust.json jaucējvērtības. Izmantojiet tikai kontrolētā lokālās izstrādes vidē. |
Atmiņas dzinis (21. plāns)
Atmiņas, prasmju un marķieru atsvaidzināšanas ietekme uz notikumu ciklu (#10349)
OmniRoute ir viens Node process. Atmiņas izgūšana/izguve, prasmju ievietošana un nodrošinātāja marķieru atsvaidzināšana darbojas tajā pašā notikumu ciklā, kurā darbojas GET /healthz un informācijas panelis. Tie nedarbojas darbinātāja pavedienā.
| Darbība | Kods | Noklusējums | Operatora vadība |
|---|---|---|---|
| Atmiņas izguve / izgūšana | src/lib/memory/ |
Informācijas paneļa memoryEnabled (pēc noklusējuma ieslēgts) | Izslēdziet sadaļā Iestatījumi → Atmiņa. Papildus funkcijas atspējošanai iestatījumos nav atsevišķa vides mainīgā avārijas slēdža. |
| Prasmju ievietošana | src/lib/skills/injection.ts |
Informācijas paneļa skillsEnabled (pēc noklusējuma ieslēgts) | Izslēdziet sadaļā Iestatījumi → Atmiņa/Prasmes (skillsEnabled). Tālāk norādītie smilškastes parametri tikai ierobežo izpildi pēc tam, kad ievietošana jau ir ieslēgta. |
| Pilnvaru atsvaidzināšana | src/sse/services/tokenRefresh.ts |
Ieslēgta savienotajiem OAuth/tīmekļa pakalpojumu sniedzējiem | Atvienojiet pakalpojumu sniedzēju vai ļaujiet pilnvarām palikt derīgām; pašlaik nav vides mainīgā TOKEN_REFRESH=0. |
Ja /healthz klusā sistēmā darbojas lēni, vispirms atspējojiet atmiņu un prasmes, pēc tam pārbaudiet kataloga/saspiešanas slodzi (#10303, #9685). Šīs funkcijas atdod vadību await punktos, taču tik un tā konkurē par vienīgo pavedienu.
Iegulšanas slāņa, vektoru krātuves un pārkārtošanas parametri pastāvīgās atmiņas apakšsistēmai (src/lib/memory/).
| Mainīgais | Noklusējums | Apraksts |
|---|---|---|
MEMORY_EMBEDDING_CACHE_TTL_MS |
300000 (5 min) |
Atmiņā esošās iegulšanas kešatmiņas TTL (katrai avota/modeļa/dimensijas signatūrai). |
MEMORY_EMBEDDING_CACHE_MAX |
1000 |
Maksimālais LRU ierakstu skaits, kas tiek glabāts iegulšanas kešatmiņā. |
MEMORY_TRANSFORMERS_MODEL |
Xenova/all-MiniLM-L6-v2 |
HF repozitorija ID pēc izvēles iespējojamajam lokālajam @huggingface/transformers MiniLM konveijeram (~23 MB int8, ~400 MB RAM). |
MEMORY_STATIC_MODEL |
minishlab/potion-base-8M |
HF repozitorija ID statiskajam potion/Model2Vec uzmeklēšanas tabulas iegulšanas modelim. Tas tiek atlikti lejupielādēts kešatmiņas direktorijā. |
MEMORY_STATIC_CACHE_DIR |
<DATA_DIR>/embeddings |
Direktorijs, ko izmanto statiskā potion modeļa failu kešošanai. Ja nav iestatīts, pēc noklusējuma atrodas zem DATA_DIR. |
HF_HUB_ENDPOINT |
https://huggingface.co |
Aizstāj Hugging Face Hub bāzes URL, ko izmanto staticPotion.ts (piem., spoguļservera galapunkts no tīkla izolētiem iestatījumiem). |
MEMORY_VEC_TOP_K |
20 |
Noklusējuma top-K, ko izmanto sqlite-vec pilnās pārlases vektoru meklēšanā failā src/lib/memory/vectorStore.ts. |
MEMORY_RRF_K |
60 |
Reciprocal Rank Fusion konstante k hibrīdajai FTS5 un vektoru izgūšanai (sqlite-vec recepte). |
VECTOR_STORE_DISABLE_VEC |
false |
Testēšanas/diagnostikas pieslēgvieta funkcijā getVectorStore() (src/lib/memory/vectorStore.ts): ja vērtība ir true, vektoru krātuvei piespiedu kārtā tiek iestatīts null (simulē mākoņa/WASM vidi bez sqlite-vec), pazeminot atmiņas izgūšanu līdz FTS5 atslēgvārdu meklēšanai. Produkcijā atstājiet neiestatītu. |
NOTION_API_KEY |
(nav iestatīts) | API atslēga Notion aizmugursistēmai (to izmanto genericBackend.ts zināmās aizmugursistēmas sākotnējais iestatījums). |
NOTION_API_URL |
https://api.notion.com/v1 |
Notion API bāzes URL (var aizstāt pašmitinātām Notion alternatīvām). |
OBSIDIAN_API_KEY |
(nav iestatīts) | API atslēga Obsidian Vault aizmugursistēmai (to izmanto genericBackend.ts zināmās aizmugursistēmas sākotnējais iestatījums). |
OBSIDIAN_API_URL |
http://localhost:27123 |
Obsidian Vault API bāzes URL (var aizstāt attālai glabātavai). |
MEMORY_TYPED_DECAY_ENABLED |
false |
TV6 tipizētās atmiņas dzēšanas galvenais slēdzis. Iespējojams pēc izvēles (pēc noklusējuma izslēgts) — tīrīšanas process dzēš novecojušās atmiņas. Ja tas ir izslēgts, access_count/last_accessed_at ir tikai telemetrija un nekas nekad netiek dzēsts. |
MEMORY_TYPED_DECAY_EPISODIC_DAYS |
30 |
TTL (dienās), pēc kura neizmantota episodic atmiņa noveco. 0 padara arī epizodisko atmiņu imūnu. Noturīgie tipi (factual/procedural/semantic) vienmēr ir imūni. Novecošanas laika atskaite tiek sākta no jauna atbilstoši last_accessed_at. |
MEMORY_TYPED_DECAY_ACCESS_IMMUNITY |
3 |
Atmiņa, kas ievietota vismaz (>=) tik reižu, kļūst imūna pret novecošanu neatkarīgi no tipa. 0 atspējo piekļuves imunitāti. |
MEMORY_TYPED_DECAY_SWEEP_INTERVAL |
0 (atspējots) |
Intervāls (sekundēs) izvēles periodiskajai novecojušo atmiņu tīrīšanai failā src/lib/memory/typedDecay.ts. 0/nav iestatīts = nav periodiskas tīrīšanas. Nepieciešama divkārša izvēles iespējošana: vajadzīgs arī MEMORY_TYPED_DECAY_ENABLED=true. |
OMNIROUTE_STRICT_SYSTEM_PROVIDERS |
(nav iestatīts) | Ar komatiem atdalīti pakalpojumu sniedzēju ID (nav reģistrjutīgi), kas pieņem system ziņojumu tikai ar indeksu 0 (src/lib/memory/injection.ts). Šiem pakalpojumu sniedzējiem kešatmiņai drošā atmiņas ievietošana masīva vidū vairāku dialoga kārtu sarunās nav droša, tāpēc atmiņa tiek apvienota/pievienota sākumā kā pirmais sistēmas ziņojums. Pēc noklusējuma ietver tikai xiaomi-mimo/mimo; papildiniet pašmitinātiem ar OpenAI saderīgiem galapunktiem (piem., Qwen3.5+/3.6), kuru tērzēšanas veidne nosaka tādu pašu ierobežojumu — viens sistēmas ziņojums sarunas sākumā. |
Docker piemērs ar mazu RAM apjomu
128 ir paredzēts tikai informācijas panelim. Kodēšanas aģenti ar šādu steka atmiņas apjomu ilgstošu /v1/responses pieprasījumu laikā saņem FATAL ERROR. Neizmantojiet šo piemēru kā Claude/Codex/Grok vārteju.
OMNIROUTE_MEMORY_MB=128
PROMPT_CACHE_MAX_SIZE=20
PROMPT_CACHE_MAX_BYTES=524288 # 512 KB
SEMANTIC_CACHE_MAX_SIZE=25
SEMANTIC_CACHE_MAX_BYTES=1048576 # 1 MB
STREAM_HISTORY_MAX=10
18. Cenu sinhronizācija
Automātiska modeļu cenu datu sinhronizācija no ārējiem avotiem.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
PRICING_SYNC_ENABLED |
false |
src/lib/pricingSync.ts |
Periodiska cenu sinhronizācija pēc izvēles. |
PRICING_SYNC_INTERVAL |
86400 (24 h) |
src/lib/pricingSync.ts |
Sinhronizācijas intervāls sekundēs. |
PRICING_SYNC_SOURCES |
litellm |
src/lib/pricingSync.ts |
Ar komatiem atdalīti datu avoti. |
Arena ELO sinhronizācija
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
ARENA_ELO_SYNC_ENABLED |
true |
src/shared/constants/featureFlagDefinitions.ts |
Periodiska Arena AI līderu saraksta ELO sinhronizācija, ko var konfigurēt informācijas paneļa funkciju karogos vai atspējot ar false. |
MODELS_CATALOG_PREFIX_MODE |
dual |
src/shared/constants/featureFlagDefinitions.ts, src/app/api/v1/models/catalog.ts |
Prefiksa forma, kas tiek izmantota modeļu ID pieprasījumā GET /v1/models. dual katram modelim piedāvā gan īso aizstājvārda prefiksu, gan kanonisko nodrošinātāja prefiksu (atpakaļsaderībai — katalogs kļūst aptuveni divreiz lielāks); alias izvada vienu ID katram modelim; canonical izvada tikai pilno nodrošinātāja ID prefiksu (nodrošinātājiem, kuru aizstājvārds jau ir kanoniskais ID, tiek saglabāts vienīgais ieraksts). Klienti to var pārrakstīt katram pieprasījumam ar ?prefix=alias. Skatiet API_REFERENCE. |
ARENA_ELO_SYNC_INTERVAL |
86400 (24 h) |
src/lib/arenaEloSync.ts |
Sinhronizācijas intervāls sekundēs. |
PromptQL Playground nodrošinātājs (neoficiāls/eksperimentāls)
Ar reverso inženieriju izveidots GraphQL sesiju tilts vietnei prompt.ql.app (src/shared/constants/providers/web-cookie.ts). Visi iestatījumi nav obligāti — pēc noklusējuma tiek izmantoti publiskie izmēģinājumu vides galapunkti; pārrakstiet tos tikai pašmitinātam vai alternatīvam PromptQL izvietojumam.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
PROMPTQL_GRAPHQL_ENDPOINT |
https://data.prompt.ql.app/promptql/playground-v2-hge/v1/graphql |
open-sse/executors/promptql.ts |
GraphQL galapunkts, ko izmanto tērzēšanas un sesiju darbībām. |
PROMPTQL_CREDITS_ENDPOINT |
https://data.pro.ql.app/v1/graphql |
open-sse/executors/promptql.ts, open-sse/services/usage/promptql.ts |
GraphQL galapunkts kredītu atlikuma un izlietojuma vaicājumiem. |
PROMPTQL_TOKEN_REFRESH_URL |
https://auth.pro.ql.app/ddn/project/token |
open-sse/executors/promptql.ts |
Galapunkts, ko izmanto iespēju robežās veiktai pilnvaras atsvaidzināšanai. |
PROMPTQL_POLL_TIMEOUT_MS |
180000 |
open-sse/executors/promptql.ts |
Maksimālais laiks (ms), cik ilgi aptaujāt thread_events pirms taimauta. |
HyperAgent tīmekļa nodrošinātājs (neoficiāls/eksperimentāls)
Reversās inženierijas ceļā izveidots sesijas tilts vietnei hyperagent.com (src/shared/constants/providers/web-cookie.ts). Nav obligāts — pēc noklusējuma tiek izmantots publiskais norēķinu/lietojuma galapunkts; mainiet to tikai pašmitinātam vai alternatīvam HyperAgent izvietojumam.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
HYPERAGENT_USAGE_URL |
https://hyperagent.com/api/settings/billing/usage |
open-sse/services/usage/hyperagent.ts |
Galapunkts, ko izmanto norēķinu/lietojuma kredīta bloku iegūšanai. |
Kilo Code lietojuma kvotas
Personīgā USD atlikuma un Kilo Pass lietojuma pārbaude Kilo Code nodrošinātājam. Nav obligāta — pēc noklusējuma tiek izmantota publiskā Kilo API; mainiet to tikai starpniekserverim/testa fiksācijai. Autentifikācijai tiek izmantots savienojuma esošais OAuth piekļuves marķieris.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
KILO_API_URL |
https://api.kilo.ai |
open-sse/services/usage/kilocode.ts |
Bāzes URL, ko izmanto personīgā Kilo Code atlikuma un Kilo Pass lietojuma datu iegūšanai. |
Adobe Firefly tīmekļa nodrošinātājs (neoficiāls/eksperimentāls)
Pārlūkprogrammas vadīta sesijas atsvaidzināšana Adobe Firefly tīmekļa nodrošinātājam
(open-sse/services/adobeFireflyBrowserLogin.ts, open-sse/services/adobeFireflySession.ts,
open-sse/services/adobeFireflyClient.ts). Nav obligāta — visi noklusējumi ir pielāgoti parastai
darbvirsmas instalācijai.
Noņemts versijā #9255. Veco ar CDP savienoto Chrome izpildvidi (adobeFireflyChromeRuntime.ts) aizstāja Playwright pārlūkprogrammas pieteikšanās pakalpojums, un tās iestatījumi vairs nepastāv. ADOBE_FIREFLY_CHROME_ CDP_PORT / VISIBLE / HEADED / PING / FORCE_RESTART mainīgie, kā arī ADOBE_FIREFLY_LOGIN_WAIT_MS un ADOBE_FIREFLY_FORTER_WAIT_MS, nekur kodu bāzē netiek nolasīti — to iestatīšanai nav nekādas ietekmes.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
ADOBE_FIREFLY_CHROME_HEADLESS |
0 |
open-sse/services/adobeFireflyBrowserLogin.ts |
Iestatiet uz 1, lai izmantotu īstu bezgalvas Chrome režīmu (zināms, ka ģenerēšana tajā nedarbojas; paredzēts tikai atkļūdošanai). |
ADOBE_FIREFLY_BROWSER_REFRESH |
1 |
open-sse/services/adobeFireflySession.ts |
Proaktīvas pārlūkprogrammas iesildīšanas ieslēgšana/izslēgšana. 0 atspējo proaktīvo iesildīšanu (408 kļūdas atkopšana paketes vidū joprojām darbojas). |
ADOBE_FIREFLY_SESSION_DISK |
1 |
open-sse/services/adobeFireflySession.ts |
Iestatiet uz 0, lai atspējotu Adobe Firefly sesijas saglabāšanu diskā. |
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS |
(nav iestatīts) | open-sse/services/adobeFireflySession.ts |
Minimālais intervāls (ms), kas tiek piemērots starp secīgiem iesniegumiem, aizstājot iebūvēto noklusējumu. |
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS |
(nav iestatīts) | open-sse/services/adobeFireflySession.ts |
Papildu intervāls (ms), kas tiek pievienots pēc veiksmīgas paketes, aizstājot iebūvēto noklusējumu. |
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS |
(nav iestatīts) | open-sse/services/adobeFireflyClient.ts |
Pamata aizkave (ms) pirms ģenerēšanas pieprasījuma iesniegšanas, aizstājot iebūvēto noklusējumu. |
19. Modeļu sinhronizācija (izstrāde)
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
MODELS_DEV_SYNC_ENABLED |
(nav iestatīts) | src/lib/modelsDevSync.ts |
Stingra models.dev cenu sinhronizācijas pārrakstīšana. Ja nav iestatīts, tiek ņemts vērā Iestatījumi > MI (modelsDevSyncEnabled). 0/false/off/no ir prioritāte pār DB un izlaiž gan periodisko sinhronizāciju, gan getModelsDevPricing() SQL/JSON skenēšanu (atkopšanai, ja informācijas panelis ir iestrēdzis tajā pašā notikumu ciklā). 1/true/on/yes piespiedu kārtā ieslēdz sinhronizāciju. Cenu saglabāšana/notīrīšana joprojām izsauc backupDbFile("pre-write"), kas 60 minūšu ierobežojuma vai DISABLE_SQLITE_AUTO_BACKUP gadījumā neveic nekādas darbības. |
MODELS_DEV_SYNC_INTERVAL |
86400 (24 h) |
src/lib/modelsDevSync.ts |
Izstrādes laika modeļu kataloga sinhronizācijas intervāls sekundēs. |
CONTEXT_WINDOW_RECONCILE_INTERVAL |
86400 (24 h) |
src/lib/contextWindowResolver.ts |
Intervāls (sekundēs) pašlabojošajam konteksta loga saskaņotājam (5004): pakalpojumu sniedzēja deklarētos logus no /models atklāšanas fiksē kā auto:discovery pārrakstījumus, ja tie atšķiras no kataloga. Iestatiet uz 0, lai atspējotu. Atkārtoti izmanto jau sinhronizētos datus (bez jaunas izgūšanas); nekad nepārraksta manual pārrakstījumus. |
20. Pakalpojumu sniedzējiem specifiski iestatījumi
| Mainīgais | Noklusējuma vērtība | Avota fails | Apraksts |
|---|---|---|---|
OPENROUTER_CATALOG_TTL_MS |
86400000 (24 h) |
src/lib/catalog/openrouterCatalog.ts |
OpenRouter modeļu kataloga kešatmiņas derīguma termiņš. |
MODEL_CATALOG_INCLUDE_NAMES |
true |
src/shared/constants/featureFlagDefinitions.ts |
Iekļauj lietotājam saprotamus name laukus /v1/models atbildēs. Atspējojiet klientiem, kuri sagaida tikai ID. |
CATALOG_BUILD_TIMEOUT_MS |
8000 (8 s) |
src/app/api/v1/models/catalogCache.ts |
Aukstā ceļa gaidīšanas ierobežojums apvienotai GET /v1/models kataloga atkārtotai izveidei (#12627). Iestājoties noildzei, tiek atgriezta pēdējā derīgā 200 atbilde, ja tāda pastāv. |
OMNIROUTE_SYNCED_CATALOG_STALE_AFTER_MS |
2592000000 (30 dienas) |
src/lib/db/models/activeSyncedCatalog.ts |
Laiks, pēc kura savienojuma sinhronizētais modeļu saraksts vairs netiek uzskatīts par autoritatīvu maršrutēšanai un kļūmes gadījumā tiek izmantots reģistrs (#12849). Ieraksti, kuriem nekad nav piešķirts laikspiedols, tiek uzskatīti par novecojušiem. |
NANOBANANA_POLL_TIMEOUT_MS |
120000 |
open-sse/handlers/imageGeneration.ts |
Maksimālais NanoBanana attēlu ģenerēšanas uzdevumu gaidīšanas laiks. |
NANOBANANA_POLL_INTERVAL_MS |
2500 |
open-sse/handlers/imageGeneration.ts |
NanoBanana uzdevumu aptaujas biežums. |
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS |
8000 |
open-sse/services/adobeFireflyUpscale.ts |
Pamata aizkave Adobe Firefly mērogošanas iesniegšanas atkārtoto mēģinājumu eksponenciālajai nogaidīšanai. |
AWS_REGION |
(nav iestatīts) | src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts |
Reģions, ko izmanto AWS Bedrock galapunktu izveidei (Kiro, audio). |
AWS_DEFAULT_REGION |
(nav iestatīts) | src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts |
Rezerves vērtība, ja AWS_REGION nav iestatīts. |
CLOUDFLARE_ACCOUNT_ID |
(nav iestatīts) | open-sse/executors/cloudflare-ai.ts |
Cloudflare Workers AI konta ID. |
CLOUDFLARE_PLAYGROUND_CHROME_PATH |
(nav iestatīts) | open-sse/executors/cloudflare-playground.ts |
Pilns darbvirsmas Chrome binārā faila ceļš Cloudflare AI Playground izpildītājam; tiek izmantots, ja bezgalvas režīma digitālā nospieduma pārbaude bloķē Playwright komplektācijā iekļauto Chromium. |
CLOUDFLARE_API_BASE |
https://api.cloudflare.com/client/v4 |
src/app/api/settings/proxy/cloudflare-deploy/route.ts |
Aizstāj Cloudflare REST API bāzes adresi, ko izmanto starpniekserveru pūla Workers releja izvietošanas rīks (#4640 / 9router#1360). |
NEXT_PUBLIC_CLOUDFLARE_RELAY_DEFAULT_PROJECT |
omniroute-relay |
src/app/(dashboard)/dashboard/settings/components/proxy/CloudflareRelayModal.tsx |
Noklusējuma Worker projekta nosaukums, kas tiek ieteikts starpniekserveru pūla modalajā logā „Izvietot releju”. |
NEXT_PUBLIC_CLOUDFLARE_RELAY_ENABLED |
true |
src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx |
Iestatiet uz false, lai cilnē Starpniekserveru pūls paslēptu Cloudflare Workers releja opciju. |
CLOUDFLARED_BIN |
automātiska noteikšana | src/lib/cloudflaredTunnel.ts |
Pielāgots ceļš uz cloudflared bināro failu. |
CLOUDFLARED_PROTOCOL |
http2 |
src/lib/cloudflaredTunnel.ts |
Tuneļa transporta protokols: http2 (noklusējums), quic vai auto. |
CLOUDFLARED_CONFIG |
(nav iestatīts) | src/lib/cloudflaredTunnel.ts |
Ceļš uz lokāli pārvaldītu cloudflared config.yml (ar tunnel:, credentials-file:, ingress:). Ja tas ir iestatīts, OmniRoute izpilda tunnel --config <path> run (nosaukts tunelis), nevis īslaicīgu ātro tuneli. |
CLOUDFLARED_HOSTNAME |
(no konfigurācijas ingress) | src/lib/cloudflaredTunnel.ts |
Nosauktā tuneļa publiskā resursdatora nosaukuma aizstāšana (piem., ai.example.com), kas tiek norādīts kā publicUrl/apiUrl. Ja tas nav iestatīts, vērtība tiek nolasīta no konfigurācijas pirmā ingress resursdatora nosaukuma. |
DENO_DEPLOY_API_BASE |
https://api.deno.com/v2 |
src/app/api/settings/proxy/deno-deploy/route.ts |
Pārraksta Deno Deploy REST API bāzes adresi, ko izmanto starpniekserveru pūla releja izvietotājs (#4643 / 9router#1437). |
NEXT_PUBLIC_DENO_RELAY_DEFAULT_PROJECT |
omniroute-deno-relay |
src/app/(dashboard)/dashboard/settings/components/proxy/DenoRelayModal.tsx |
Noklusējuma Deno Deploy lietotnes nosaukums, kas tiek ieteikts starpniekserveru pūla modālajā logā "Izvietot releju". |
NEXT_PUBLIC_DENO_RELAY_ENABLED |
true |
src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx |
Iestatiet uz false, lai paslēptu Deno Deploy releja opciju cilnē Starpniekserveru pūls. |
SEARCH_CACHE_TTL_MS |
300000 (5 min) |
open-sse/services/searchCache.ts |
TTL meklēšanas API (Perplexity, Brave u.c.) atbilžu kešošanai. |
ENABLE_CC_COMPATIBLE_PROVIDER |
false |
src/shared/utils/featureFlags.ts |
Parāda eksperimentālo ar CC saderīgā nodrošinātāja saskarni relejiem, kas paredzēti tikai Claude Code. |
NINEROUTER_HOST |
127.0.0.1 |
open-sse/executors/ninerouter.ts |
Pārraksta resursdatoru, kurā klausās iegultā 9router instance. |
NINEROUTER_PORT |
20130 |
open-sse/executors/ninerouter.ts |
Pārraksta portu, kurā klausās iegultā 9router instance. |
EMBED_WS_PROXY_HOST |
127.0.0.1 |
src/lib/services/embedWsProxy.ts |
Saistīšanas resursdators iegultā pakalpojuma WebSocket starpniekserverim (pēc noklusējuma tikai atgriezeniskā cilpa). |
EMBED_WS_PROXY_PORT |
20131 |
src/lib/services/embedWsProxy.ts |
Iegultā pakalpojuma WebSocket starpniekservera ports. |
CLIPROXYAPI_HOST |
127.0.0.1 |
open-sse/executors/cliproxyapi.ts |
CLIProxyAPI tilta resursdators (mantotā integrācija). |
CLIPROXYAPI_PORT |
5544 |
open-sse/executors/cliproxyapi.ts |
CLIProxyAPI tilta ports. |
CLIPROXYAPI_API_KEY |
(tukšs) | open-sse/handlers/chatCore/cliproxyapiCredentials.ts |
Datu plaknes rezerves atslēga, ja nav iestatījuma cliproxyapi_api_key. |
CLIPROXYAPI_MANAGEMENT_KEY |
(tukšs) | src/lib/services/cliproxyAccountHealth.ts |
Pārvaldības atslēga konta stāvokļa datu nolasīšanai no ārēji pārvaldītas CLIProxyAPI instances. |
CLIPROXYAPI_CONFIG_DIR |
~/.cli-proxy-api |
src/lib/versionManager/processManager.ts |
CLIProxyAPI konfigurācijas direktorijs. |
CLIPROXY_BIND_HOST |
127.0.0.1 |
docker-compose.yml |
Resursdatora saskarne, kurā docker-compose publicē cliproxyapi blakusprocesu (#12578). Tā datu sējumā glabājas nodrošinātāju OAuth/API akreditācijas dati, un piesaistītajam attēlam nav uz vides mainīgajiem balstītas datu plaknes api-keys pārrakstīšanas iespējas (tikai piemontēts config.yaml), tāpēc 0.0.0.0 padara akreditācijas datus saturošu pakalpojumu pieejamu visā LAN. |
MUX_SERVICE_PORT |
8322 |
src/lib/services/bootstrap.ts |
Pārraksta portu, kurā klausās iegultais Mux (coder/mux) aģentu orķestrēšanas dēmons (vienmēr 127.0.0.1). |
DARIO_HOST |
127.0.0.1 |
open-sse/executors/dario.ts |
Dario iegultā pakalpojuma saistīšanas/savienojuma resursdators (pēc noklusējuma tikai atgriezeniskā cilpa). |
DARIO_PORT |
3456 |
open-sse/executors/dario.ts |
Dario iegultā pakalpojuma ports. |
DARIO_HOST |
127.0.0.1 |
open-sse/executors/dario.ts |
Dario iegultā pakalpojuma saistīšanas/savienojuma resursdators (pēc noklusējuma tikai atgriezeniskā cilpa). |
DARIO_PORT |
3456 |
open-sse/executors/dario.ts |
Dario iegultā pakalpojuma ports. |
LOCAL_HOSTNAMES |
(tukšs) | open-sse/config/providerRegistry.ts |
Ar komatiem atdalīti papildu resursdatoru nosaukumi, kas tiek uzskatīti par “lokāliem” (Docker servisu nosaukumi utt.). |
ENABLE_CC_COMPATIBLE_PROVIDER ir paredzēts tikai trešo pušu starpniekserveriem, kas pieņem vienīgi Claude Code klientus. OmniRoute pārraksta pieprasījumus, lai šie starpniekserveri tos pieņemtu. Ja vēlaties izmantot tikai Claude Code CLI vai neesat pārliecināts, kas ir šie starpniekserveri, atstājiet šo opciju atspējotu un tā vietā pievienojiet parastu ar Anthropic saderīgu pakalpojumu sniedzēju.
21. Starpniekserveru darbspēja
| Mainīgais | Noklusējuma vērtība | Avota fails | Apraksts |
|---|---|---|---|
PROXY_FAST_FAIL_TIMEOUT_MS |
2000 |
src/lib/proxyHealth.ts |
Ātrās atteices darbspējas pārbaudes noildze. |
PROXY_LATENCY_WINDOW_HOURS |
3 |
src/lib/db/proxies.ts |
Laika logs (stundās), ko izmanto kandidātstarpniekserveru vidējā latentuma aprēķināšanai latentumam optimizētajā pūla stratēģijā. |
PROXY_HEALTH_CACHE_TTL_MS |
30000 |
src/lib/proxyHealth.ts |
Darbspējas pārbaudes rezultātu kešatmiņas TTL. |
PROXY_HEALTH_UNHEALTHY_CACHE_TTL_MS |
2000 |
src/lib/proxyHealth.ts |
Kešatmiņas TTL neveiksmīgām starpniekservera darbspējas pārbaudēm. Saglabājiet to īsāku par PROXY_HEALTH_CACHE_TTL_MS, lai īslaicīgu starpniekservera noildžu gadījumā pie augstas paralēlās slodzes pārbaudes tiktu ātri atkārtotas, neatspējojot ātro atteici patiešām nestrādājošiem starpniekserveriem. |
PROXY_HEALTH_ENABLED |
true |
src/lib/proxyHealth/scheduler.ts |
Iestatiet uz false, lai atspējotu fona starpniekserveru darbspējas plānotāju, kas periodiski pārbauda reģistrētos starpniekserverus. |
PROXY_HEALTH_INTERVAL_MS |
600000 |
src/lib/proxyHealth/scheduler.ts |
Fona darbspējas plānotāja pārbaudes cikla intervāls milisekundēs (minimums 60000). |
PROXY_HEALTH_TEST_URL |
https://httpbin.org/ip |
src/lib/proxyHealth/probeTarget.ts |
Sasniedzamības pārbaudes mērķis, ko izmanto plānotājs un galapunkts /api/settings/proxies/auto-test. Norādiet iekšēju/pašmitinātu URL, lai neizmantotu publisko noklusējuma mērķi. |
PROXY_HEALTH_TEST_CONCURRENCY |
10 |
src/lib/proxyHealth/probeTarget.ts |
Vienlaikus katrā paketē sākto pārbaužu skaits, ko kopīgi izmanto plānotājs un galapunkts /api/settings/proxies/auto-test. Minimālā vērtība ir 1, bet maksimālā — 50. |
PROXY_HEALTH_TEST_STAGGER_MS |
100 |
src/lib/proxyHealth/probeTarget.ts |
Aizkave milisekundēs starp divu pārbaužu sākšanu vienā paketē. Bez tās visa pakete tiek nosūtīta vienlaikus, un koplietota izejošā IP adrese var aktivizēt mērķa ātruma ierobežojumu. Iestatiet 0, lai atspējotu intervālu; maksimālā vērtība ir 5000. |
PROXY_HEALTH_USE_PROVIDER_TARGET |
true |
src/lib/proxyHealth/providerProbeTarget.ts |
Iestatiet "false", lai pārtrauktu pārbaudīt starpniekserverim piešķirtā pakalpojumu sniedzēja faktisko resursdatoru (GET /models, bez API atslēgas) un tā vietā vienmēr izmantotu PROXY_HEALTH_TEST_URL. |
PROXY_HEALTH_AUTO_DEACTIVATE |
false |
src/lib/proxyHealth/statusPolicy.ts |
Ja iestatīts false (noklusējums), automatizētās sasniedzamības pārbaudes (plānotājs + /api/settings/proxies/auto-test poga "Pārbaudīt visus") ir tikai lasāmas un nekad nemaina starpniekservera statusu — tikai operators iestata to kā aktīvu/neaktīvu, tāpēc nestabila pārbaude nevar padarīt piešķirto starpniekserveri nepieejamu (#6246). Iestatiet true, lai atjaunotu iepriekšējo pārbaudīšanas un statusa iestatīšanas darbību. |
PROXY_POOL_EGRESS_OBSERVATION |
false |
src/shared/utils/featureFlags.ts |
Izvēles funkcionalitātes karodziņš (skatiet FEATURE_FLAGS.md; informācijas paneļa DB pārrakstīšanas vērtībai ir prioritāte). true (vai 1, yes) informācijas panelī zem starpniekserveru pūla parāda tikai lasāmu pūla izejošās datplūsmas novērojumu (atšķirīgas izejošās IP adreses, savienojumus un lielāko aiz vienas IP adreses novēroto skaitu pēdējo 24 h laikā, pamatojoties uz starpniekservera žurnālu). Tas nekad netiek izmantots maršrutēšanai. |
PROXY_AUTO_REMOVE |
false |
src/lib/proxyHealth/scheduler.ts |
Iestatiet true, lai ļautu plānotājam automātiski noņemt starpniekserverus pēc atkārtotām secīgām kļūmēm. |
PROXY_AUTO_REMOVE_AFTER |
3 |
src/lib/proxyHealth/scheduler.ts |
Secīgo kļūmju skaits, pēc kura plānotājs automātiski noņem starpniekserveri (ja PROXY_AUTO_REMOVE=true). |
PROXY_AUTO_DISABLE |
false |
src/lib/proxyHealth/scheduler.ts |
Iestatiet true, lai plānotājs pēc atkārtotām secīgām kļūmēm starpniekserveri daļēji atspējotu (statuss dead, nekad netiek dzēsts), nevis noņemtu. Nesagraujoša PROXY_AUTO_REMOVE alternatīva: starpniekserveris nekavējoties tiek izslēgts no pūla/rotācijas noteikšanas (tvēruma pūla noteikšanā izmantotais aktīvā statusa filtrs to jau izslēdz) un tiek automātiski atkārtoti aktivizēts, tiklīdz tas atkal sekmīgi iztur pārbaudes. Izmanto to pašu PROXY_AUTO_REMOVE_AFTER slieksni. Ja abi karogi ir true, prioritāte ir PROXY_AUTO_REMOVE. |
OMNIROUTE_CONTROL_PLANE_PROXY_DIRECT_FALLBACK |
false |
src/shared/constants/featureFlagDefinitions.ts |
Ļauj OAuth un nodrošinātāja validācijas plūsmām apiet piesaistītu starpniekserveri un izveidot tiešu savienojumu, ja starpniekservera sasniedzamības sākotnējās pārbaudes neizdodas. Spēkā esošā prioritāte ir: funkciju karogu datubāzes pārrakstījums > vides mainīgais > noklusējuma vērtība. |
RATE_LIMIT_MAX_WAIT_MS |
30000 (30 s) |
open-sse/services/rateLimitManager.ts |
Maksimālais laiks, cik ilgi gaidīt pēc 429 atbildes, pirms pieprasījums tiek uzskatīts par neizdevušos. |
RATE_LIMIT_EXECUTION_MAX_WAIT_MS |
600000 (10 min) |
open-sse/services/rateLimitManager.ts |
Maksimālais laiks, cik ilgi pieņemts pieprasījums drīkst palikt izpildē, pirms beidzas tā ātruma ierobežojuma rezervācija; tas ir nodalīts no rindas gaidīšanas laika budžeta, lai lēna izgūšanas sākšana neinkrementālās vārtejās neizraisītu taimautu (#12027). |
RATE_LIMIT_MAX_QUEUE_DEPTH |
0 (atspējots) |
open-sse/services/rateLimitManager.ts |
Rindas uzņemšanas ierobežojums: noraida ar 429 queue_full, tiklīdz rindā jau ir šāds pieprasījumu skaits. 0 = neierobežots (noklusējums). |
RATE_LIMIT_AUTO_ENABLE |
(nav iestatīts) | open-sse/services/rateLimitManager.ts |
Piespiedu kārtā ieslēdz vai izslēdz automātiskās ātruma ierobežošanas drošības mehānismu neatkarīgi no informācijas panelī saglabātā iestatījuma. Pieņem true/1/on, lai piespiedu kārtā ieslēgtu, un false/0/off, lai piespiedu kārtā izslēgtu. |
PROVIDER_COOLDOWN_ENABLED |
(nav iestatīts → izslēgts) | open-sse/services/providerCooldownTracker.ts |
Izvēles globāla, starp pieprasījumiem koplietota nodrošinātāja/savienojuma atdzišanas perioda izsekošana. Pēc noklusējuma IZSLĒGTA (pārklājas ar savienojuma atdzišanas periodu/nodrošinātāja automātisko slēdzi). Lai iespējotu, pieņem true/1/on. |
PROVIDER_COOLDOWN_MIN_MS |
5000 |
open-sse/services/providerCooldownTracker.ts |
Minimālais atdzišanas periods (ms), pirms atkārtoti mēģināt izmantot nodrošinātāju/savienojumu, kam radusies kļūme. Tas tiek eksponenciāli palielināts līdz ar secīgu kļūmju skaitu. Tiek izmantots tikai tad, ja ir iespējots PROVIDER_COOLDOWN_ENABLED. |
PROVIDER_COOLDOWN_MAX_MS |
300000 (5 min) |
open-sse/services/providerCooldownTracker.ts |
Maksimālais atdzišanas perioda ierobežojums (ms), pēc kura neizdevušos pakalpojumu sniedzēju/savienojumu mēģina izmantot atkārtoti neatkarīgi no citiem nosacījumiem. Tiek izmantots tikai tad, ja ir iespējots PROVIDER_COOLDOWN_ENABLED. |
STREAM_RECOVERY_ENABLED |
(nav iestatīts → izslēgts) | src/lib/resilience/settings.ts (sākotnējā vērtība) → open-sse/services/streamRecovery.ts (loģika) |
Kas tas ir: pārtrūkušu augšupstraumes straumju nemanāma atkopšana (free-claude-code ports). Sākotnējais SSE logs tiek aizturēts līdz STREAM_RECOVERY.HOLDBACK_MS (750 ms), lai pirms apstiprināšanas noticis pārrāvums — pirms kāds baits sasniedz klientu — tiktu nemanāmi atvērts no jauna un mēģināts vēlreiz. Kad iespējot: nestabilām augšupstraumēm, kas straumes sākumā bieži pārtrūkst, nenosūtot nevienu baitu; atstājiet IZSLĒGTU, ja nevarat atļauties līdz 750 ms ilgu papildu aizkavi līdz pirmajam marķierim katrā straumē. Pieņem true/1/on. Iestata sākotnējo saglabātā noturības iestatījuma vērtību; pēc konfigurēšanas prioritāte ir informācijas paneļa iestatījumam. |
STREAM_RECOVERY_MIDSTREAM_ENABLED |
(nav iestatīts → izslēgts) | src/lib/resilience/settings.ts (sākotnējā vērtība) → open-sse/services/streamRecovery.ts (loģika) |
Kas tas ir: turpināšana straumes vidū (4.4. fāze) — pēc pēc apstiprināšanas notikuša pārrāvuma (baiti jau sasnieguši klientu) pieprasījums tiek veikts atkārtoti, izmantojot daļējo tekstu kā asistenta iepriekšējo aizpildījumu, un trūkstošā beigu daļa tiek pievienota. Tikai ar OpenAI saderīgām vienkārša teksta straumēm; netiek aktivizēts, kamēr notiek rīka izsaukums. Kad iespējot: gariem ģenerēšanas procesiem, kas tiek pārtraukti atbildes vidū, ja piekrītat, ka atkoptā beigu daļa tiek saņemta vienā piegājienā, nevis marķieri pa vienam. Nav atkarīgs no STREAM_RECOVERY_ENABLED (atšķirīgs riska profils). Pieņem true/1/on. |
STREAM_THROUGHPUT_WATCHDOG_ENABLED |
(nav iestatīts → izslēgts) | src/lib/resilience/settings.ts → open-sse/services/throughputWatchdog.ts |
Pēc izvēles iespējojams aktīvās straumes lietderīgās izvades uzraugs. Nosaka straumes, kas turpina sūtīt fragmentus, bet nesasniedz konfigurēto asistenta izvades ātrumu; sirdspuksti, lietojuma notikumi, tukšas izmaiņas un rīku/spriešanas fāzes netiek kļūdaini uzskatītas par progresu. Darbojas atsevišķi no dīkstāves un absolūtā termiņa noildzēm. |
STREAM_THROUGHPUT_WATCHDOG_WARMUP_MS |
30000 |
src/lib/resilience/settings/normalize.ts |
Labvēlības periods pirms caurlaidspējas novērtēšanas; ierobežots līdz 0–600000 ms. |
STREAM_THROUGHPUT_WATCHDOG_WINDOW_MS |
30000 |
src/lib/resilience/settings/normalize.ts |
Slīdošais lietderīgās izvades logs; ierobežots līdz 1000–600000 ms. Pirms pārtraukšanas ir nepieciešams viens pilns logs. |
STREAM_THROUGHPUT_WATCHDOG_MIN_BYTES_PER_SECOND |
4 |
src/lib/resilience/settings/normalize.ts |
Minimālais UTF-8 asistenta izvades ātrums baitos (konservatīvs marķieru aizstājējrādītājs); ierobežots līdz 1–1000000. |
STREAM_THROUGHPUT_WATCHDOG_MIN_USEFUL_BYTES |
1 |
src/lib/resilience/settings/normalize.ts |
Minimālais lietderīgās izvades paraugs, kas nav nulle un tiek uzskatīts par izmērāmu; ierobežots līdz 1–1000000 baitiem. |
HEALTHCHECK_STAGGER_MS |
3000 |
src/lib/tokenHealthCheck.ts |
Nobīdes intervāls (ms) starp pakalpojumu sniedzēju marķieru darbspējas pārbaudēm palaišanas laikā. |
HEALTHCHECK_JITTER_MIN_MS |
500 |
src/lib/tokenHealthCheck.ts |
Minimālā nejaušinātā nobīde (ms), kas papildus HEALTHCHECK_STAGGER_MS tiek pievienota starp pakalpojumu sniedzēju marķieru darbspējas pārbaudēm, lai novērstu pieprasījumu uzplūdus (problēma #1220). |
HEALTHCHECK_JITTER_MAX_MS |
5000 |
src/lib/tokenHealthCheck.ts |
Maksimālā nejaušinātā nobīde (ms), kas papildus HEALTHCHECK_STAGGER_MS tiek pievienota starp pakalpojumu sniedzēju marķieru darbspējas pārbaudēm, lai novērstu pieprasījumu uzplūdus (problēma #1220). |
HEALTHCHECK_BATCH_SIZE |
20 |
src/lib/tokenHealthCheck.ts |
Vienlaicīgo pārbaužu paketes lielums startēšanas marķieru veselības pārbaudes ciklam; lielākas vērtības paralēli pārbauda vairāk savienojumu, savukārt mazākas vērtības samazina strauju slodzes pieaugumu (problēma #7875, #7719 regresija). |
REQUEST_RETRY |
2 |
src/sse/services/cooldownAwareRetry.ts |
Automātisko atkārtošanas mēģinājumu skaits modeļa tvērumā esošām nogaidīšanas atbildēm, pirms klientam tiek atgriezta kļūda. |
MAX_RETRY_INTERVAL_SEC |
30 |
src/sse/services/cooldownAwareRetry.ts |
Maksimālais atkāpšanās intervāls (sekundēs) starp atkārtotiem mēģinājumiem pēc nogaidīšanas. Neatkarīgi no augšupstraumes Retry-After to ierobežo šī vērtība. |
HEADROOM_URL |
http://localhost:8787 |
src/lib/headroom/detect.ts |
Headroom marķieru taupīšanas starpniekservera URL. Informācijas paneļa dzīves cikls (api/headroom/*) pēc noklusējuma palaiž lokālu headroom-ai CLI atgriezeniskās cilpas interfeisā; mainiet tikai tad, ja jānorāda ārējs Docker blakusservisa starpniekserveris. |
Straumes atkopšanas regulēšanas konstantes
Atkopšanas aiztures darbība tiek regulēta ar kodā fiksētām konstantēm failā
open-sse/config/constants.ts (STREAM_RECOVERY), kas šeit parādītas uzziņai —
to maiņai nepieciešams rediģēt kodu, nevis vides mainīgo:
STREAM_RECOVERY.HOLDBACK_MS = 750— cik ilgi tiek aizturēts sākotnējais SSE logs, lai agrīnas apraušanas gadījumā varētu veikt atkārtotu mēģinājumu, pirms klientam tiek nosūtīts kaut viens baits.STREAM_RECOVERY.BUFFER_MAX_BYTES = 65536— aizturētā loga stingrais ierobežojums; veikt nosūtīšanu (bufera iztukšošanu + caurlaidi), tiklīdz ir uzkrāts šāds baitu skaits, neatkarīgi no taimera.STREAM_RECOVERY.EARLY_RETRY_MAX = 4— maksimālais caurspīdīgo augšupstraumes atkārtotas atvēršanas reižu skaits, kamēr aizture vēl nav nosūtīta.
Katram nodrošinātājam atsevišķs slīdošā loga ātruma ierobežojums (bez vides mainīgā): no FCC pārnestais katram nodrošinātājam atsevišķais slīdošā loga ātruma ierobežojuma rezerves mehānisms ir ietverts kodā (
open-sse/services/providerDefaultRateLimit.ts, pieslēgts, izmantojotopen-sse/services/rateLimitManager.ts), taču tiek piegādāts ar tukšu noklusējuma kartējumu un pašlaik tam nav operatora vides mainīgā — tas tiek iespējots tikai, izmantojot testēšanas āķi / koda labojumu. Tas ar nolūku nav iekļauts iepriekšējā tabulā. Katram(token, IP)atsevišķais releja ierobežotājs, kuram ir iestatījums, irRELAY_IP_PER_MINUTE(§3 Tīkls un porti).
22. Atkļūdošana
Caution
Šie mainīgie rada detalizētu izvadi un var nopludināt sensitīvus datus. Nekad neiespējojiet tos produkcijas vidē.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
CURSOR_DEBUG |
(nav iestatīts) | open-sse/executors/cursor.ts |
Iestatiet 1, lai iespējotu detalizētus Cursor izpildītāja žurnālus (atkodētus SSE fragmentus u.c.). |
CURSOR_STREAM_DEBUG |
(nav iestatīts) | open-sse/executors/cursor.ts |
Atpakaļsaderīgs CURSOR_DEBUG aizstājvārds. |
CURSOR_DUMP_FILE |
(nav iestatīts) | open-sse/executors/cursor.ts |
Neobligāts faila ceļš, kurā tiek ierakstīti neapstrādāti atkodētie Cursor fragmenti, ja CURSOR_DEBUG=1. |
CURSOR_STREAM_TIMEOUT_MS |
300000 |
open-sse/executors/cursor.ts |
Cursor izpildītāja straumes dīkstāves noildze (ms). |
CURSOR_KV_GRACE_MS |
2000 |
open-sse/executors/cursor.ts |
Pagarinājuma logs (ms) pēc composer kv_after_text mīkstā terminatora, ja buferī vēl ir baiti — dod noslēdzošajam exec_mcp rīka izsaukumam laiku pabeigt savu kadru. |
CURSOR_TOOL_DIRECTIVE |
iespējots (!== "0") |
open-sse/executors/cursor.ts |
Rīka apstiprināšanas direktīva, kas liek composer-2.5 uzticami veikt rīku izsaukumus. Iestatiet 0, lai atspējotu. |
OMNIROUTE_SYSTEM_INSTRUCTION_APPEND |
(nav iestatīts) | open-sse/translator/request/claude-to-openai.ts, open-sse/translator/response/openai-to-claude.ts |
Operatora definēts sistēmas uzvednes teksts, kas tiek pievienots sistēmas ziņojumam PĒC tulkošanas (injekcija pēc tulkošanas), sasniedzot codex/Responses un /v1/messages ceļus. Tiek izmantots arī kā direktīvas prefikss, kas tiek noņemts no atbalsotajiem sistēmas preambulas blokiem. Atstājiet neiestatītu, lai atspējotu. |
CURSOR_IMAGE_FETCH_TIMEOUT_MS |
15000 |
open-sse/utils/cursorImages.ts |
Katra attēla ielādes noildze (ms) attālinātai image_url vizuālajai ievadei. |
CURSOR_STATE_DB_PATH |
(noteikts pārbaudot) | open-sse/utils/cursorVersionDetector.ts |
Aizstāj Cursor IDE stāvokļa datubāzes uzmeklēšanu, kas tiek izmantota IDE versijas noteikšanai. |
CURSOR_AGENT_CLI_VERSION |
(noteikt / fiksēt) | open-sse/utils/cursorAgentCliVersion.ts |
Agent CLI būvējuma identifikators (YYYY.MM.DD-<hash>) galvenei x-cursor-client-version: cli-…, izpildot Agent Run. |
CURSOR_AGENT_BIN |
(nav iestatīts) | open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts |
Ceļš uz Cursor Agent bināro failu, ko izmanto attēlu ģenerēšanai. Ja nav iestatīts, apstrādātājs izmanto providerSpecificData.agentBin un pēc tam PATH. |
CURSOR_IMG_TIMEOUT_MS |
210000 |
open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts |
Katra attēla kopējā laika ierobežojums (ms) Cursor Agent attēlu uzdevumiem. |
CURSOR_IMG_MAX_CONCURRENT |
2 |
open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts |
Koplietotās vietas vienlaicīguma ierobežotājs Cursor attēlu uzdevumiem. |
CURSOR_IMG_MODEL |
pieprasījums / auto |
open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts |
Aizstāj Cursor CLI --model attēlu uzdevumiem. |
UC_IMAGE_POLL_INTERVAL_MS |
2000 |
open-sse/handlers/imageGeneration/providers/ucImage.ts |
UC (uncensored.com) attēlu ģenerēšanas rezultātu aptaujas intervāls (ms). |
UC_IMAGE_POLL_TIMEOUT_MS |
60000 |
open-sse/handlers/imageGeneration/providers/ucImage.ts |
UC attēlu ģenerēšanas rezultātu aptaujas kopējā laika ierobežojums (ms). |
UC_VIDEO_POLL_INTERVAL_MS |
3000 |
open-sse/handlers/videoGeneration/providers/ucVideo.ts |
UC (uncensored.com) video ģenerēšanas rezultātu aptaujas intervāls (ms). |
UC_VIDEO_POLL_TIMEOUT_MS |
300000 |
open-sse/handlers/videoGeneration/providers/ucVideo.ts |
UC video ģenerēšanas rezultātu aptaujas kopējā laika ierobežojums (ms). |
CURSOR_DATA_DIR |
(noteikts pārbaudot) | open-sse/utils/cursorAgentCliVersion.ts |
Aizstāj Cursor Agent CLI datu direktoriju (…/versions/<id>); tas ir tas pats mainīgais, ko izmanto oficiālais aģents. |
CURSOR_TOKEN |
(nav iestatīts) | scripts/ad-hoc/cursor-tap.cjs |
Tiešs Cursor nesēja marķieris, ko izmanto izstrādātāju rīki. |
OMNIROUTE_LOG_REQUEST_SHAPE |
atspējots (jāiespējo ar "1") |
src/app/api/v1/chat/completions/route.ts |
Reģistrē satura tipa/garuma marķierus lielām tērzēšanas lietderīgajām slodzēm, ja ir iestatīts "1". Pēc noklusējuma izslēgts, lai samazinātu žurnāla troksni. |
DEBUG_RESPONSES_SSE_TO_JSON |
(nav iestatīts) | open-sse/handlers/responseTranslator.ts |
Iestatiet true, lai žurnalētu Responses API SSE→JSON tulkošanas informāciju. |
DEBUG_CLAUDE_NONSTREAM |
(nav iestatīts) | open-sse/handlers/responseTranslator.ts |
Iestatiet true, lai Claude atbildes tulkošanas ceļā parādītu tukšus textContent fragmentus (tikai atkļūdošanai). |
NEXT_PUBLIC_OMNIROUTE_E2E_MODE |
(nav iestatīts) | E2E testu sistēma | Iestatiet true, lai iespējotu E2E testa režīmu (atvieglota autentifikācija, testa āķi). |
23. GitHub integrācija
Ļaujiet lietotājiem ziņot par problēmām tieši no informācijas paneļa.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
GITHUB_ISSUES_REPO |
(nav iestatīts) | src/app/api/v1/issues/report/route.ts |
Repozitorijs formātā owner/repo. |
GITHUB_ISSUES_TOKEN |
(nav iestatīts) | src/app/api/v1/issues/report/route.ts |
GitHub personiskās piekļuves pilnvara ar tvērumu issues:write. |
GITHUB_TOKEN |
(nav iestatīts) | problēmu izvērtēšanas / mākoņa aģenta palīgkomponenti | Vispārīga GitHub piekļuves pilnvara, kas tiek izmantota kā GITHUB_ISSUES_TOKEN rezerves variants un ko izmanto mākoņa aģenta palīgkomponenti ceļā src/lib/cloudAgent/*. |
Izvietošanas scenāriji
Norādījumus releja aizmugursistēmas SRE vajadzībām (ts/bifrost/auto darbība, 9router un CLIProxyAPI izvietojums, kā arī augstas caurlaidspējas atkāpšanās stratēģija) skatiet sadaļā Releja aizmugursistēmas stratēģija.
Minimāla lokālā izstrādes vide
JWT_SECRET=$(openssl rand -base64 48)
API_KEY_SECRET=$(openssl rand -hex 32)
INITIAL_PASSWORD=dev123
PORT=20128
NODE_ENV=development
Docker produkcijas vide
JWT_SECRET=<ģenerēts>
API_KEY_SECRET=<ģenerēts>
INITIAL_PASSWORD=<ģenerēts>
STORAGE_ENCRYPTION_KEY=<ģenerēts>
DATA_DIR=/data
PORT=20128
API_PORT=20129
NODE_ENV=production
AUTH_COOKIE_SECURE=true
REQUIRE_API_KEY=true
NEXT_PUBLIC_BASE_URL=https://omniroute.example.com
BASE_URL=http://localhost:20128
OMNIROUTE_MEMORY_MB=8192
CORS_ORIGIN=https://your-frontend.example.com
No tīkla izolēta vide / CI
JWT_SECRET=test-jwt-secret-for-ci
API_KEY_SECRET=test-api-key-secret-for-ci
INITIAL_PASSWORD=testpass
NODE_ENV=production
OMNIROUTE_DISABLE_BACKGROUND_SERVICES=true
APP_LOG_TO_FILE=false
VPS ar reverso starpniekserveri (nginx + Cloudflare)
JWT_SECRET=<ģenerēts>
API_KEY_SECRET=<ģenerēts>
STORAGE_ENCRYPTION_KEY=<ģenerēts>
PORT=20128
AUTH_COOKIE_SECURE=true
REQUIRE_API_KEY=true
NEXT_PUBLIC_BASE_URL=https://omniroute.example.com
BASE_URL=http://127.0.0.1:20128
CORS_ORIGIN=https://omniroute.example.com
ENABLE_TLS_FINGERPRINT=true
CLI_COMPAT_ALL=1
24. Prasmju smilškaste (v3.8.0+)
Ierobežojumi un drošības iestatījumi, kas tiek piemēroti, kad prasmju ietvars (src/lib/skills/) izpilda lietotāja definētas automatizācijas smilškastes vidē.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
SKILLS_SANDBOX_TIMEOUT_MS |
10000 (10 s) |
src/lib/skills/builtins.ts |
Smilškastē izpildīta prasmes koda katras izpildes kopējā ilguma noildze. Stingrs ierobežojums; viss, kas darbojas ilgāk, tiek pārtraukts. |
SKILLS_EXECUTION_TIMEOUT_MS |
(izmanto SKILLS_SANDBOX_TIMEOUT_MS, ja nav iestatīts) |
src/lib/skills/ |
Augsta līmeņa prasmju orķestrēšanas noildze. Iestatiet lielāku vērtību nekā SKILLS_SANDBOX_TIMEOUT_MS, lai atļautu daudzpakāpju darbplūsmas. |
SKILLS_MAX_FILE_BYTES |
1048576 (1 MB) |
src/lib/skills/builtins.ts |
Maksimālais baitu skaits, ko prasme drīkst nolasīt no viena smilškastes faila. |
SKILLS_MAX_HTTP_RESPONSE_BYTES |
256000 (250 KB) |
src/lib/skills/builtins.ts |
Maksimālais baitu skaits, ko drīkst tvert no vienas HTTP atbildes prasmes ietvaros. |
SKILLS_MAX_SANDBOX_OUTPUT_CHARS |
100000 |
src/lib/skills/builtins.ts |
Stingrs ierobežojums stdout/stderr rakstzīmju skaitam, ko atgriež smilškastes izsaukums. |
SKILLS_SANDBOX_NETWORK_ENABLED |
false |
src/lib/skills/builtins.ts |
Iestatiet 1/true, lai atļautu izejošo tīkla savienojumu no smilškastes. Drošības nolūkos pēc noklusējuma tā ir izolēta. |
SKILLS_ALLOWED_SANDBOX_IMAGES |
(tukšs) | src/lib/skills/builtins.ts |
Ar komatiem atdalīts smilškastes izpildei atļauto konteineru attēlu saraksts. Tukša vērtība nozīmē, ka atļauts tikai iebūvētais noklusējuma attēls. |
SKILLS_SANDBOX_DOCKER_IMAGE |
(iebūvētais noklusējums) | src/lib/skills/ |
Konteinera attēls, kas tiek izmantots, palaižot Docker nodrošinātu smilškasti. Pārrakstiet, lai fiksētu pielāgotu, pastiprināti aizsargātu bāzes attēlu. |
SKILLS_SANDBOX_RUNTIME |
auto |
src/lib/skills/sandbox.ts, src/lib/skills/containerProvider.ts |
Konteineru izpildlaika vide prasmju izolēšanai smilškastē: auto | docker | apple | wsl | orbstack | podman. auto izvēlas labāko instalēto izpildlaika vidi atbilstoši resursdatora operētājsistēmai (Apple Container/OrbStack operētājsistēmā macOS, WSL Container operētājsistēmā Windows, Podman operētājsistēmā Linux), kā rezerves variantu izmantojot Docker. |
Caution
Iespējojot
SKILLS_SANDBOX_NETWORK_ENABLED=true, patvaļīgam prasmes kodam tiek atvērts izejošās datplūsmas ceļš. Koplietojamos izvietojumos izmantojiet to kopā arOUTBOUND_SSRF_GUARD_ENABLED=trueun stingruCORS_ORIGIN/starpniekservera politiku.
25. Pakalpojumu sniedzēju kvotas, tuneļi, dublējumkopijas un dažādi izpildlaika iestatījumi
Pakalpojumu sniedzēju kvotu galapunkti, tīkla tuneļi (Tailscale, Ngrok, MITM atkļūdošanas starpniekserveris), 1Proxy izejošās trafika starpniekserveru kopa, datubāzes dublējumkopijas un nelieli atsevišķu funkciju pārrakstījumi, uz kuriem atsaucas izpildītāja slānis vai skripti.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
REDIS_URL |
redis://localhost:6379 |
src/shared/utils/rateLimiter.ts |
Redis savienojuma virkne ātruma ierobežotāja aizmugursistēmai. |
ALIBABA_CODING_PLAN_HOST |
(produkcijas resursdators) | open-sse/services/bailianQuotaFetcher.ts |
Pārraksta resursdatoru, kas tiek izmantots Alibaba Bailian programmēšanas plāna kvotu iegūšanai. |
ALIBABA_CODING_PLAN_QUOTA_URL |
atvasināts no resursdatora | open-sse/services/bailianQuotaFetcher.ts |
Pilnas kvotas URL pārrakstījums pakalpojumam Alibaba Bailian. |
QWEN_CLOUD_COOKIE |
(nav iestatīts) | open-sse/services/qwenTokenPlanQuotaFetcher.ts |
Konsoles sesijas sīkfails Qwen Cloud / Model Studio personīgā Token Plan kvotu vārtejai (secinājumu API atslēga to nevar nolasīt). Nokopējiet visu Cookie pieprasījuma galveni — tā satur login_qwencloud_ticket — no jebkura api.json izsaukuma uz cs-data.qwencloud.com vietnē home.qwencloud.com › Billing › Subscription (F12 › Network). Sensitīvs un piesaistīts sesijai; ieteicams izmantot katram savienojumam paredzēto informācijas paneļa lauku qwenCloudCookie. |
QWEN_CLOUD_SEC_TOKEN |
(nav iestatīts) | open-sse/services/qwenTokenPlanQuotaFetcher.ts |
Manuāls sec_token pārrakstījums Token Plan konsoles vārtejai. Sensitīvs; ja nav iestatīts, ielādētājs to nosaka no informācijas paneļa HTML, izmantojot sīkfailu. |
QWEN_TOKEN_PLAN_HOST |
https://cs-data.qwencloud.com |
open-sse/services/qwenTokenPlanQuotaFetcher.ts |
Vārtejas resursdatora pārrakstījums personīgā Token Plan kvotu ielādētājam (piem., bailian-singapore-cs.alibabacloud.com Model Studio konsolei). |
QWEN_TOKEN_PLAN_DASHBOARD_URL |
https://home.qwencloud.com/ |
open-sse/services/qwenTokenPlanQuotaFetcher.ts |
Informācijas paneļa URL, kas tiek izmantots, lai noteiktu sec_token no pieteiktā lietotāja HTML. |
ALIBABA_FREE_TIER_VISION_FE_PATH |
/costing-balance/free-quota-image-video |
open-sse/services/alibabaFreeTierQuotaFetcher.ts |
Konsoles priekšgala ceļa pārrakstījums Alibaba Model Studio bezmaksas līmeņa redzes/multivides kvotas iegūšanai. |
ALIBABA_FREE_TIER_MULTIMODAL_FE_PATH |
/costing-balance/free-quota-multimodal |
open-sse/services/alibabaFreeTierQuotaFetcher.ts |
Konsoles priekšgala ceļa pārrakstīšana Alibaba Model Studio bezmaksas līmeņa multimodālās kvotas iegūšanai. |
ALIBABA_FREE_TIER_AUDIO_FE_PATH |
/costing-balance/free-quota-audio |
open-sse/services/alibabaFreeTierQuotaFetcher.ts |
Konsoles priekšgala ceļa pārrakstīšana Alibaba Model Studio bezmaksas līmeņa audio kvotas iegūšanai. |
ALIBABA_FREE_TIER_ALLOWLIST_PATH |
(nav iestatīts) | open-sse/services/alibabaFreeTierAllowlist.ts |
Neobligāts ceļš uz lokālu JSON pārrakstīšanas failu iebūvētajam Alibaba bezmaksas līmeņa teksta modeļu atļauto vienumu sarakstam. Ja tas nav pieejams, tiek izmantots $DATA_DIR/alibaba-free-tier-allowlist.json, pēc tam config/alibaba-free-tier-allowlist.json. |
CONTEXT_RESERVE_TOKENS |
1024 |
open-sse/services/contextManager.ts |
Marķieri, kas, aprēķinot uzvednes budžetu, rezervēti pabeigšanas izvadei. |
CONTEXT_KEEP_LATEST_IMAGES |
2 |
open-sse/services/contextManager.ts |
Jaunāko iekļauto attēlu skaits, kas jāsaglabā, atmetot vecākos attēlus, lai iekļautos konteksta logā (#8560). |
MODEL_ALIAS_COMPAT_ENABLED |
iespējots | open-sse/services/model.ts |
Ieslēdz vai izslēdz mantoto modeļu aizstājvārdu saderības slāni, ko izmanto vecāki klienti. |
OMNIROUTE_EMERGENCY_FALLBACK |
iespējots | open-sse/services/emergencyFallback.ts |
Iestatiet false (vai 0), lai atspējotu ārkārtas atkāpšanās mehānismu budžeta izsmelšanas gadījumā, kas neveiksmīgos pieprasījumus pārmaršrutē uz bezmaksas nvidia/openai/gpt-oss-120b modeli. Spēkā esošā prioritāte ir: Feature Flags datubāzes pārrakstīšana > vides mainīgais > noklusējums; ja tā nav pieejama, pakalpojums atkāpjas uz neapstrādāto vides mainīgā vērtību. |
COMMAND_CODE_CALLBACK_PORT |
(nav iestatīts) | src/app/api/providers/command-code/auth/shared.ts |
Lokālais ports, ko izmanto OAuth stila atzvaniem no Command Code CLI palīgrīka. |
COMMAND_CODE_VERSION |
0.33.2 |
open-sse/executors/commandCode.ts |
Vērtība, kas tiek nosūtīta Command Code ārējam pakalpojumam kā x-command-code-version galvene. Pārrakstiet to, lai paaugstinātu CLI versiju. |
COMMANDCODE_API_URL |
https://api.commandcode.ai |
open-sse/services/usage/command-code.ts |
Command Code lietojuma/kvotas ārējā pakalpojuma bāzes URL, ko izmanto viedtālruņa kvotu ieguvēja telemetrija. Pārrakstiet to pašmitinātai/alternatīvai Command Code API. |
MITM_LOCAL_PORT |
443 |
src/mitm/server.cjs |
MITM atkļūdošanas starpniekservera lokālais piesaistes ports. |
MITM_DISABLE_TLS_VERIFY |
0 |
src/mitm/server.cjs |
Iestatiet 1, lai atspējotu augšupstraumes TLS verifikāciju (tikai izstrādei). |
MITM_IDLE_TIMEOUT_MS |
60000 |
src/mitm/socketTimeouts.ts, src/mitm/server.cjs |
Dīkstāvē esoša ligzdas savienojuma taimauts (ms) starpniekotiem savienojumiem; dīkstāvē esošas ligzdas pēc šī laika tiek slēgtas, lai novērstu daļēji atvērtu tuneļu noplūdi. |
MITM_VERBOSE |
1 |
src/mitm/server.cjs, src/mitm/_internal/bypass.cjs |
Maršrutēšanas lēmumu žurnāla detalizācijas līmenis: 0 izslēdz žurnālu, bet lielākas vērtības reģistrē vairāk apiešanas/maršrutēšanas lēmumu. |
MITM_ROOT_CA_ENABLED |
false |
src/mitm/manager.ts |
Iestatiet true, lai izvēlētos saknes CA un katram resursdatoram atsevišķa gala sertifikāta modeli (#6684). Jaunās instalācijās tas tiek izmantots automātiski; instalācijās ar jau esošu uzticamu mantoto gala sertifikātu tiek saglabāts mantotais fiksētais SAN sertifikāts, ja vien šis modelis netiek izvēlēts. |
MITM_CERT_MODE |
legacy |
src/mitm/manager.ts, src/mitm/server.cjs |
MITM pārvaldnieks to iestata palaistajam starpniekservera procesam (root-ca | legacy) — tas atspoguļo sertifikātu migrācijas lēmumu un nav paredzēts manuālai iestatīšanai. |
OMNIROUTE_NO_SUDO |
0 |
src/mitm/systemCommands.ts |
Iestatiet 1 (patiesumvērtību), lai no MITM sertifikātu uzticamības komandām noņemtu sākumā esošo sudo — izvietojumiem bez root tiesībām vai lietotāju nosaukumtelpās, kur operators manuāli uzticas CA (piemēram, izmantojot Node papildu CA sertifikātu mehānismu). |
SKIP_ANTIGRAVITY_DNS |
(nav iestatīts) | src/mitm/dns/provision.ts |
Iestatiet true, lai pilnībā izlaistu /etc/hosts DNS ierakstu nodrošināšanu Antigravity starpniekservera resursdatoru nosaukumiem — konteineriem, kuros nav pieejams sudo/root. |
OMNIROUTE_SKIP_DNS_WRITE |
(nav iestatīts) | src/mitm/dns/dnsConfig.ts |
Iestatiet 1, lai, pievienojot vai noņemot DNS ierakstus, izlaistu rakstīšanu resursdatoru failā — smilškastes vai tikai lasāmām testēšanas vidēm. |
OMNIROUTE_SKIP_SYSTEM_TRUST |
0 |
src/mitm/cert/install.ts, src/mitm/tproxy/caTrust.ts |
Tikai testiem/CI paredzēts aizsargmehānisms: iestatiet 1, lai sertifikātu uzticamības instalēšana/atinstalēšana neveiktu nekādas darbības un testu komplekts nekad nemainītu OS uzticamības krātuvi. Testu iestatīšana un CI darbplūsmas to iestata automātiski. |
CHANGELOG_BASE_REF |
(automātiski) | scripts/check/check-changelog-integrity.mjs |
Tieša bāzes atsauces norāde pret CHANGELOG dzēšanas pārbaudei (pēc noklusējuma CI vidē tiek izmantots PR bāzes zars vai augstākais release/v*). |
FREE_PROXY_AUTO_SYNC_ENABLED |
false |
src/lib/freeProxyProviders/scheduler.ts |
Iestatiet uz true, lai iespējotu bezmaksas starpniekserveru kopas automātiskās sinhronizācijas plānotāju fonā. Jāiespējo manuāli; pēc noklusējuma izslēgts. |
FREE_PROXY_AUTO_SYNC_INTERVAL_MS |
1800000 |
src/lib/freeProxyProviders/scheduler.ts |
Automātiskās sinhronizācijas intervāls milisekundēs (pēc noklusējuma 30 min). |
FREE_PROXY_1PROXY_ENABLED |
true |
src/lib/freeProxyProviders/oneproxy.ts |
Iespējojiet 1proxy bezmaksas starpniekserveru avotu. Iestatiet uz false, lai atspējotu. |
FREE_PROXY_1PROXY_API_URL |
(skatiet oneproxy.ts) | src/lib/freeProxyProviders/oneproxy.ts |
1proxy API URL pārrakstīšana. |
FREE_PROXY_1PROXY_MAX |
500 |
src/lib/freeProxyProviders/oneproxy.ts |
Maksimālais no 1proxy katrā sinhronizācijas reizē iegūstamo starpniekserveru skaits. |
FREE_PROXY_1PROXY_MIN_QUALITY |
50 |
src/lib/freeProxyProviders/oneproxy.ts |
Minimālais kvalitātes vērtējuma slieksnis importēšanai no 1proxy. |
FREE_PROXY_PROXIFLY_ENABLED |
true |
src/lib/freeProxyProviders/proxifly.ts |
Iespējojiet Proxifly bezmaksas starpniekserveru avotu. Iestatiet uz false, lai atspējotu. |
FREE_PROXY_PROXIFLY_QUANTITY |
100 |
src/lib/freeProxyProviders/proxifly.ts |
Katrā Proxifly sinhronizācijas reizē iegūstamo starpniekserveru skaits. |
FREE_PROXY_PROXIFLY_ANONYMITY |
elite |
src/lib/freeProxyProviders/proxifly.ts |
Proxifly anonimitātes līmeņa filtrs (elite, anonymous, transparent). |
FREE_PROXY_IPLOCATE_ENABLED |
false |
src/lib/freeProxyProviders/iplocate.ts |
Iespējot IPLocate bezmaksas starpniekserveru avotu. Tikai pēc izvēles. |
FREE_PROXY_IPLOCATE_BASE_URL |
https://raw.githubusercontent.com/iplocate/free-proxy-list/main/protocols |
src/lib/freeProxyProviders/iplocate.ts |
IPLocate starpniekserveru saraksta bāzes URL pārrakstīšana. |
FREE_PROXY_WEBSHARE_ENABLED |
true |
src/lib/freeProxyProviders/webshare.ts |
Iespējot Webshare starpniekserveru pūla avotu. Iestatiet uz false, lai atspējotu; jābūt iestatītam arī FREE_PROXY_WEBSHARE_API_KEY. |
FREE_PROXY_WEBSHARE_API_KEY |
(nav) | src/lib/freeProxyProviders/webshare.ts |
Webshare konta API pilnvara (Authorization: Token <key>). Obligāta — bez tās nodrošinātājs paliek atspējots. |
FREE_PROXY_WEBSHARE_API_URL |
https://proxy.webshare.io/api/v2/proxy/list/ |
src/lib/freeProxyProviders/webshare.ts |
Webshare starpniekserveru saraksta API URL pārrakstīšana. |
FREE_PROXY_WEBSHARE_MAX |
500 |
src/lib/freeProxyProviders/webshare.ts |
Maksimālais vienā Webshare sinhronizācijā importēto starpniekserveru skaits. |
NEXT_PUBLIC_VERCEL_RELAY_ENABLED |
true |
src/app/(dashboard)/…/ProxyPoolTab.tsx |
Rādīt/slēpt pogu Izvietot Vercel Relay cilnē Starpniekserveru pūls. |
VERCEL_API_BASE |
https://api.vercel.com |
src/app/api/settings/proxy/vercel-deploy/route.ts |
Vercel API bāzes URL pārrakstīšana (testēšanai). |
NEXT_PUBLIC_VERCEL_RELAY_DEFAULT_PROJECT |
omniroute-relay |
src/app/(dashboard)/…/VercelRelayModal.tsx |
Noklusējuma projekta nosaukums, kas iepriekš aizpildīts Vercel Relay izvietošanas modālajā logā. |
TAILSCALE_BIN |
(automātiska noteikšana) | src/lib/tailscaleTunnel.ts |
Tiešs ceļš uz tailscale bināro failu. |
TAILSCALED_BIN |
(automātiska noteikšana) | src/lib/tailscaleTunnel.ts |
Precīzs ceļš uz tailscaled dēmona bināro failu. |
TAILSCALE_AUTHKEY |
(nav iestatīts) | src/lib/tailscaleTunnel.ts |
Iepriekš koplietota Tailscale autentifikācijas atslēga neinteraktīvai / bezgalvas tailscale up izpildei (nodota, izmantojot --auth-key=). Ja tā nav iestatīta, pieteikšanās izmanto interaktīvo pārlūkprogrammas autentifikācijas URL. |
NGROK_AUTHTOKEN |
(nav iestatīts) | src/lib/ngrokTunnel.ts |
Autentificē izejošos ngrok tuneļus. |
DB_BACKUP_MAX_FILES |
20 |
src/lib/db/backup.ts |
Maksimālais SQLite dublējuma failu skaits, kas tiek saglabāts manuālās/plānotās dublējumu tīrīšanas laikā. Migrācijas momentuzņēmumiem tiek izmantota satura adresācija, un identiska DB stāvokļa gadījumā tie tiek izmantoti atkārtoti; tie netiek dzēsti vienlaicīgās migrācijas loga ietvaros. Ignorē vērtību, kas saglabāta sadaļā Iestatījumi → Datubāzes dublējumu saglabāšana. |
DB_BACKUP_RETENTION_DAYS |
0 |
src/lib/db/backup.ts |
Maksimālais vecums (dienās) dublējumiem, kas tiek saglabāti manuālās/plānotās dublējumu tīrīšanas laikā. 0 atspējo dzēšanu pēc vecuma. Migrācijas momentuzņēmumi netiek dzēsti vienlaicīgās migrācijas loga ietvaros. Ignorē vērtību, kas saglabāta sadaļā Iestatījumi → Datubāzes dublējumu saglabāšana. |
OMNIROUTE_BACKUP_SCHEDULE_JOB_INTERVAL_MS |
30000 |
src/lib/jobs/backupScheduleJob.ts |
Servera puses uzdevuma, kas izpilda backup-schedule.json, cikla intervāls (ms). Tam jābūt ievērojami īsākam par cron 1 minūtes granularitāti; vērtībām, kas ir mazākas par 5000 vai nav parsējamas, tiek izmantota noklusējuma vērtība 30000. |
CONTAINER_HOST |
docker |
scripts/check-permissions.sh |
Konteinera izpildlaika norāde ievades punkta atļauju pārbaudei. Iestatiet uz podman jebkurai Podman topoloģijai. Tā kā konteiners nevar noteikt, vai dzinis ir lokāls vai tam piekļūst, izmantojot Podman Machine, brīdinājums paliek topoloģiski neitrāls un norāda uz contrib/podman/README.md. |
QUOTA_STORE_DRIVER |
sqlite |
src/lib/quota/storeFactory.ts |
Kvotas daļas patēriņa krātuves aizmugursistēma: sqlite (noklusējums) vai redis. |
QUOTA_STORE_REDIS_URL |
(nav iestatīts) | src/lib/quota/storeFactory.ts |
Redis savienojuma virkne, kas tiek izmantota, ja QUOTA_STORE_DRIVER=redis (piemēram, redis://localhost:6379). |
QUOTA_SATURATION_THRESHOLD |
0.5 |
src/lib/quota/enforce.ts |
Pūla piesātinājuma attiecība (0..1); sasniedzot vai pārsniedzot šo vērtību, pūls pāriet stingrajā režīmā (aizņemšanās nav atļauta). |
QUOTA_SOFT_DEPRIORITIZE_FACTOR |
0.7 |
open-sse/services/combo.ts |
Vērtējuma reizinātājs (0..1), kas tiek piemērots mērķim, kad elastīgā kvotu politika pazemina tā prioritāti. |
STATUS_SOFT_DEPRIORITIZE_FACTOR |
0.5 |
open-sse/services/combo/autoStrategy.ts |
Vērtējuma reizinātājs (0..1), kas automātiskās kombinācijas vērtēšanā tiek piemērots pakalpojumu sniedzējam ar izsmeltiem resursiem (credits_exhausted/rate_limited), ja priekšpārbaudes kvotas robežvērtība ir IZSLĒGTA (#4540). |
QUOTA_CONSUMPTION_RETENTION_DAYS |
14 |
src/lib/db/quotaConsumption.ts |
quota_consumption intervālu glabāšanas periods (dienās) pirms atkritumu savākšanas (gcQuotaConsumption). |
QUOTA_PREFLIGHT_CUTOFF_ENABLED |
false |
src/lib/resilience/settings.ts |
Izvēles iestatījums (pēc noklusējuma IZSLĒGTS): iespējo automātiskās maršrutēšanas stingro kvotas robežvērtību, kas pirms vērtēšanas atmet kandidātus ar zemu kvotu. |
OMNIROUTE_AUTO_FREE_FALLBACK_TO_FULL_POOL |
false |
open-sse/services/autoCombo/virtualFactory.ts |
Izvēles iestatījums (pēc noklusējuma IZSLĒGTS): ja auto/<category>:<tier> filtram neatbilst neviens savienots kandidāts, atjauno iepriekšējo darbību, kurā tukša kopuma atgriešanas vietā tiek izmantots pilnais (nefiltrētais) kopums. Noklusējuma iestatījums IZSLĒGTS nozīmē, ka :free ietver tikai bezmaksas līmeni. |
OMNIROUTE_CHAOS_MAX_PANEL |
5 |
open-sse/services/autoCombo/virtualFactory.ts |
Paneļa lieluma ierobežojums (diapazonā 1–10) auto/*:chaos apraides variantam — viens pieprasījums tiek izvērsts ne vairāk kā uz šo pakalpojumu sniedzēju ziņā daudzveidīgo modeļu skaitu. |
OMNIROUTE_CHAOS_MIN_PANEL |
(dzinēja noklusējuma vērtība) | open-sse/services/autoCombo/virtualFactory.ts |
Minimālā paneļa lieluma iestatījums, kas tiek pārsūtīts haosa apraides apstrādātājam; ja tas nav iestatīts, tiek saglabāta dzinēja noklusējuma vērtība. |
OMNIROUTE_CHAOS_PANEL_TIMEOUT_MS |
(dzinēja noklusējuma vērtība) | open-sse/services/autoCombo/virtualFactory.ts |
Stingrais noildzes ierobežojums (ms) visai haosa paneļa izvēršanai; ja tas nav iestatīts, tiek saglabāta dzinēja noklusējuma vērtība. |
GROK_AUTH_PATH |
~/.grok/auth.json |
open-sse/services/grokQuotaFetcher.ts |
Grok CLI faila auth.json ceļš, ko izmanto grok-web nedēļas kvotas iegūšanai; to var pārrakstīt testiem vai nestandarta CLI instalācijai. |
AGENTBRIDGE_UPSTREAM_CA_CERT |
(nav iestatīts) | src/mitm/manager.ts |
Papildu CA sertifikāts (PEM), kas tiek uzskatīts par uzticamu AgentBridge augšupstraumes TLS savienojumiem. |
INSPECTOR_BUFFER_SIZE |
1000 |
src/mitm/inspector/buffer.ts |
Maksimālais tverto pieprasījumu skaits, kas tiek glabāts Traffic Inspector cikliskajā buferī. |
INSPECTOR_MAX_BODY_KB |
1024 |
src/mitm/inspector/buffer.ts |
Maksimālais tvertā pieprasījuma/atbildes pamatteksta lielums (KB) pirms saīsināšanas. |
INSPECTOR_HTTP_PROXY_PORT |
8080 |
src/mitm/inspector/httpProxyServer.ts |
Traffic Inspector HTTP starpniekservera lokālais ports. |
INSPECTOR_HTTP_PROXY_AUTOSTART |
false |
src/mitm/inspector/httpProxyServer.ts |
Automātiski palaist inspektora HTTP starpniekserveri sāknēšanas laikā. |
INSPECTOR_TLS_INTERCEPT |
false |
src/lib/inspector/captureState.ts |
Iespējot TLS pārtveršanu (MITM) tvertajai HTTPS datplūsmai. |
INSPECTOR_LLM_HOSTS_EXTRA |
(nav iestatīts) | src/lib/inspector/captureState.ts |
Papildu resursdatoru nosaukumi (atdalīti ar komatiem), kas tveršanas nolūkos tiek uzskatīti par LLM galapunktiem. |
INSPECTOR_MASK_SECRETS |
true |
src/mitm/inspector/buffer.ts |
Maskēt noslēpumus (autorizācijas galvenes/API atslēgas) tvertajā datplūsmā. |
INSPECTOR_SYSTEM_PROXY_GUARD_MINUTES |
30 |
src/app/api/tools/traffic-inspector/capture-modes/system-proxy/route.ts |
Minūšu skaits, pēc kura sistēmas starpniekservera aizsardzības mehānisms automātiski atjauno operētājsistēmas starpniekservera iestatījumus. |
INSPECTOR_INTERNAL_INGEST_TOKEN |
(automātiski) | src/app/api/tools/traffic-inspector/internal/ingest/route.ts |
Tokens, kas autentificē iekšēji tverto datu ievadi inspektorā. |
PLAYGROUND_COMPARE_MAX_COLUMNS |
4 |
src/app/(dashboard)/dashboard/playground/ |
Maksimālais blakus izvietoto kolonnu skaits Playground salīdzināšanas režīmā. |
PLAYGROUND_IMPROVE_PROMPT_DEFAULT_MODEL |
(nav iestatīts) | src/app/(dashboard)/dashboard/playground/ |
Noklusējuma modelis Playground darbībai “uzlabot uzvedni” (ja nav iestatīts, tiek izmantots aktīvais modelis). |
BIFROST_ENABLED |
1 |
src/app/api/v1/relay/chat/completions/bifrost/route.ts |
Galvenais Bifrost blakusprocesa starpniekservera avārijas izslēgšanas slēdzis. Ja iestatīts uz 0, maršruts atgriež 503 ar galveni X-Bifrost-Killswitch, un operators tiek novirzīts uz TS ceļu. Izmantojiet, lai atspējotu blakusprocesu bez atkārtotas izvietošanas (1. līmeņa maršrutētāja incidents, atslēgu rotācija). |
BIFROST_BASE_URL |
(nav iestatīts) | src/app/api/v1/relay/chat/completions/bifrost/route.ts |
Ja iestatīts, Bifrost blakusprocesa starpniekservera maršruts pārsūta /v1/chat/completions datplūsmu uz šo Go vārteju, nevis TS releja apstrādātāju. Nav iestatīts → 503 ar atkāpšanos. Beigu slīpsvītra tiek noņemta. |
BIFROST_PORT |
8080 |
src/lib/services/bootstrap.ts |
Ports, kuram piesaistās uzraudzītais iegultais Bifrost pakalpojums (127.0.0.1:<port>), kad OmniRoute pārvalda Bifrost blakusprocesa dzīves ciklu. Noklusējuma vērtība ir 8080. |
BIFROST_API_KEY |
(nav iestatīts) | src/app/api/v1/relay/chat/completions/bifrost/route.ts |
Bifrost vārtejas API atslēga (tiek nosūtīta kā Authorization: Bearer ...). Ja nav iestatīta, maršruts sagaida, ka pieprasījumā būs derīga OmniRoute API atslēga; šī atslēga paredzēta tikai autentifikācijai vārtejas pusē. |
BIFROST_STREAMING_ENABLED |
true |
src/app/api/v1/relay/chat/completions/bifrost/route.ts |
Ja vērtība ir true, Bifrost blakusprocesa maršruts straumē atbildes atpakaļ, izmantojot SSE caur vārteju, nevis TS straumēšanas izpildītāju. Iestatiet uz 0, lai caur vārteju piespiedu kārtā izmantotu nestraumētas JSON atbildes. |
BIFROST_TIMEOUT_MS |
30000 |
src/app/api/v1/relay/chat/completions/bifrost/route.ts |
Katra pieprasījuma taimauts, veicot starpniekservera pārsūtīšanu uz Bifrost vārteju (ms). Iestājoties taimautam, maršruts atgriež TS releja ceļu, izmantojot galveni X-Bifrost-Fallback. |
OMNIROUTE_BIFROST_KEY |
(nav iestatīts) | src/app/api/v1/relay/chat/completions/bifrost/route.ts |
BIFROST_API_KEY aizstājvārds (izmanto skripti, kas nolasa vides mainīgos, izmantojot OMNIROUTE_*). Ja ir iestatīti abi, prioritāte ir BIFROST_API_KEY. |
OMNIROUTE_RELAY_BACKEND |
ts / auto |
src/app/api/v1/relay/chat/completions/routingBackend.ts |
Releja aizmugursistēma maršrutam /api/v1/relay/chat/completions: ts | bifrost | auto. ts = TypeScript relejs (noklusējums, ja Bifrost nav konfigurēts); auto atlasa Bifrost, ja ir iestatīts BIFROST_BASE_URL un BIFROST_ENABLED ≠ 0, automātiski atkāpjoties uz TS, ja blakusprocess nav sasniedzams; bifrost piespiedu kārtā izmanto Bifrost (stingri, bez atkāpšanās). Autentifikācija/ātruma ierobežošana/injekciju aizsardzība/atļauto vērtību saraksts vienmēr vispirms tiek izpildīti Next maršrutā. Atbildēs ir X-Routing-Backend / X-Routing-Fallback / X-Routing-Fallback-Reason. |
RELAY_ROUTING_BACKEND |
(nav iestatīts) | src/app/api/v1/relay/chat/completions/routingBackend.ts |
Pieņemts OMNIROUTE_RELAY_BACKEND aizstājvārds (tās pašas ts | bifrost | auto vērtības). Ja ir iestatīti abi, prioritāte ir OMNIROUTE_RELAY_BACKEND. |
OMNIROUTE_BIFROST_FAILURE_COOLDOWN_MS |
5000 |
src/app/api/v1/relay/chat/completions/bifrostCooldown.ts |
Atelpas laiks (ms) pēc Bifrost blakusprocesa pārejas kļūmes auto režīmā, pirms relejs atkārtoti mēģina izmantot blakusprocesu; kamēr ilgst atelpas laiks, pieprasījumi tiek maršrutēti tieši uz TS ceļu, bet pēc tam pārbaude tiek veikta vēlreiz. 0 atspējo. Attiecas tikai tad, ja OMNIROUTE_RELAY_BACKEND=auto. |
OMNIROUTE_TLS_CERT |
(nav iestatīts) | bin/cli/commands/serve.mjs |
Ceļš uz PEM TLS sertifikātu, lai apkalpotu omniroute serve, izmantojot HTTPS (līdzvērtīgs --tls-cert). Jāizmanto kopā ar OMNIROUTE_TLS_KEY; atsevišķais serveris tad terminē TLS tajā pašā klausītājā (wss:// turpina darboties bez izmaiņām). Nav iestatīts → parasts HTTP. Ja norādīts tikai sertifikāts vai atslēga vai arī ceļš nav nolasāms, tiek reģistrēts brīdinājums un tiek turpināts izmantot HTTP. |
OMNIROUTE_TLS_KEY |
(nav iestatīts) | bin/cli/commands/serve.mjs |
Ceļš uz PEM TLS privāto atslēgu, lai omniroute serve izmantotu HTTPS (līdzvērtīgs --tls-key). Jāizmanto kopā ar OMNIROUTE_TLS_CERT. Skatiet OMNIROUTE_TLS_CERT. |
OMNIROUTE_LOCAL_ENDPOINTS_ENABLED |
0 |
src/lib/security/localEndpoints.ts |
Galvenais slēdzis /api/local/* maršrutiem. Ja nav iestatīts vai tā vērtība ir 0, visi /api/local/* maršruti produkcijas vidē atgriež 503. Izvietojumos, kas neizmanto atgriezeniskās cilpas adresi, vērtībai jābūt 1, lai iespējotu Redis palaidēju un līdzīgus viena klikšķa lokālo pakalpojumu palaidējus. Papildu drošības slānis kopā ar isLocalOnlyPath() maršrutu aizsarga klasifikāciju (LOCAL_ONLY_API_PREFIXES failā src/server/authz/routeGuard.ts). |
OMNIROUTE_LOCAL_ENDPOINTS_TOKEN |
(nav iestatīts) | src/lib/security/localEndpoints.ts |
Bearer marķieris /api/local/* izsaucējiem, kuri neatrodas atgriezeniskās cilpas adresē (piemēram, darbvirsmas lietotnei). Ja tas ir iestatīts, pieprasījumos no IP adresēm, kas nav atgriezeniskās cilpas adreses, jābūt Authorization: Bearer <token>. Nepieciešams, ja izvietojumos, kas neizmanto atgriezeniskās cilpas adresi, ir iestatīts OMNIROUTE_LOCAL_ENDPOINTS_ENABLED=1. |
OMNIROUTE_REDIS_CONTAINER_NAME |
omniroute-redis |
bin/cli/commands/redis.mjs |
Konteinera nosaukums viena klikšķa Redis palaidējam (omniroute redis up). To izmanto gan CLI, gan RedisLauncherPanel GUI. |
OMNIROUTE_REDIS_HOST_PORT |
6379 |
bin/cli/commands/redis.mjs |
Resursdatora ports viena klikšķa Redis palaidējam. Mainiet to, ja resursdators jau izmanto portu 6379. Konteinera iekšējais ports paliek 6379. |
OMNIROUTE_REDIS_BIND_HOST |
127.0.0.1 |
bin/cli/commands/redis.mjs |
Resursdatora saskarne, kurā viena klikšķa Redis palaidējs publicē pakalpojumu. Palaidējs startē Redis BEZ paroles, tāpēc piesaiste pie 0.0.0.0 nodrošina katram jūsu LAN resursdatoram neautentificētu piekļuvi Redis — paplašiniet piesaisti tikai tad, ja pats šai instancei iestatāt arī paroli. |
REDIS_BIND_HOST |
127.0.0.1 |
docker-compose.yml |
Resursdatora saskarne, kurā docker-compose publicē Redis blakusprocesu (#9286). Compose Redis darbojas bez requirepass; lietotņu konteineri tam piekļūst, izmantojot compose tīklu (redis:6379) — publicētais ports ir paredzēts tikai resursdatora puses rīkiem. 0.0.0.0 pakļauj neautentificētu Redis visam LAN. |
REDIS_PORT |
6379 |
docker-compose.yml |
Resursdatora ports compose Redis blakusprocesam. |
APP_BIND_HOST |
127.0.0.1 |
docker-compose.yml, docker-compose.prod.yml |
Resursdatora saskarne, kurā docker-compose publicē pašas lietotnes informācijas paneļa/API/live-WS portus (#12568). Tā kā .env.example pēc noklusējuma tiek piegādāts ar REQUIRE_API_KEY=false, 0.0.0.0 padara anonīmo /v1 LLM starpniekserveri pieejamu visā LAN/WAN — paplašiniet piekļuvi tikai pēc REQUIRE_API_KEY=true iestatīšanas vai tad, ja priekšā esošais reversais starpniekserveris nodrošina savu autentifikāciju. |
QDRANT_BIND_HOST |
127.0.0.1 |
docker-compose.yml |
Resursdatora saskarne, kurā docker-compose publicē Qdrant atmiņas blakuspakalpojumu (#12578). Uz LAN pieejamību attiecas tie paši apsvērumi kā REDIS_BIND_HOST gadījumā. |
BIFROST_BIND_HOST |
127.0.0.1 |
docker-compose.yml |
Resursdatora saskarne, kurā docker-compose publicē Bifrost maršrutētāja blakuspakalpojumu (#12578). Uz LAN pieejamību attiecas tie paši apsvērumi kā REDIS_BIND_HOST gadījumā. |
REDIS_KEY_PREFIX |
omniroute: |
src/shared/utils/rateLimiter.ts |
Nosaukumvietas prefikss, kas tiek lietots katrai OmniRoute Redis atslēgai (ātruma ierobežotājam, autentifikācijas kešatmiņai, kvotu krātuvei, iesildīšanas ķēdes pārtraucējam). Novērš atslēgu kolīzijas, ja Redis instance tiek koplietota ar citām lietotnēm (#11042). |
OMNIROUTE_INTERNAL_SERVICE_TOKEN |
(nav iestatīts — mehānisms atspējots) | src/lib/api/internalServiceAuth.ts |
Koplietojams noslēpums identitāti saglabājošiem iekšējiem REST pārsūtījumiem (#9260): OmniRoute komponenti, kas izsauc citus lokālos OmniRoute maršrutus, nosūta to kā x-omniroute-internal-service-token, lai saglabātu sākotnējā izsaucēja identitāti. Tiek salīdzināts ar timingSafeEqual. |
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE |
(nav iestatīts) | src/lib/api/internalServiceAuth.ts |
Iekšējā pakalpojuma marķiera slepenā faila variants: ceļš uz failu, kura saturs pēc sākuma un beigu atstarpju noņemšanas ir marķieris. Tiek izmantots tikai tad, ja iekļautais mainīgais nav iestatīts. |
OPENROUTER_PROVIDER_STATS_ENABLED |
true |
src/lib/catalog/openrouterProviderStats.ts |
Papildina informācijas paneļa pakalpojumu sniedzēju sarakstu ar OpenRouter nedēļas reitinga statistiku (#9324). Pēc noklusējuma ieslēgts; iestatiet false, lai pilnībā izlaistu fona izgūšanu (nebloķējoša un nekad nav fatāla). |
OPENROUTER_PROVIDER_STATS_TTL_MS |
86400000 (24 h) |
src/lib/catalog/openrouterProviderStats.ts |
OpenRouter pakalpojumu sniedzēju statistikas momentuzņēmuma kešatmiņas TTL milisekundēs. |
OMNIROUTE_REDIS_IMAGE |
redis:7-alpine |
bin/cli/commands/redis.mjs |
Redis attēls, ko izmanto Redis viena klikšķa palaidējs. Pēc vajadzības aizstājiet ar redis:8-alpine vai privāta reģistra spoguli. |
QDRANT_HOST |
qdrant |
(izvēles klastera profils) | Qdrant blakuspakalpojuma resursdatora nosaukums, kad ir aktīvs --profile memory. Noklusējuma vērtība norāda uz tīklā esošā qdrant pakalpojuma nosaukumu; ārējai izvietošanai iestatiet citu vērtību. Tiek izmantots tikai tad, ja kodā qdrantEnabled ir true (src/lib/memory/vectorStore.ts:108). |
QDRANT_PORT |
6333 |
(izvēles klastera profils) | Qdrant blakusservisa REST ports. |
QDRANT_GRPC_PORT |
6334 |
(izvēles klastera profils) | Qdrant blakusservisa gRPC ports. To izmanto klientu bibliotēkas, kas straumēšanas operācijām dod priekšroku gRPC, nevis REST. |
QDRANT_API_KEY |
(nav iestatīts) | (izvēles klastera profils) | Neobligāta API atslēga pakalpojumam Qdrant Cloud vai autentificētai lokālai instancei. Tukša vērtība → api-key galvene netiek nosūtīta. |
QDRANT_COLLECTION |
omniroute-memory |
(izvēles klastera profils) | Kolekcijas nosaukums OmniRoute sarunu atmiņas iegultnēm. Pirmajā palaišanas reizē tiek izveidota ar QDRANT_VECTOR_SIZE dimensijām. |
QDRANT_EMBEDDING_MODEL |
text-embedding-3-small |
(izvēles klastera profils) | Qdrant kolekcijas metadatos ierakstītais noklusējuma iegulšanas modeļa nosaukums. Faktiskās iegultnes ģenerē tas pakalpojumu sniedzējs, uz kuru norāda embeddingModel lauks OmniRoute iestatījumos. |
QDRANT_VECTOR_SIZE |
1536 |
(izvēles klastera profils) | Iegulšanas vektora dimensija. Tai jāatbilst izmantotajam iegulšanas modelim (text-embedding-3-small → 1536; ada-002 → 1536; nomic-embed-text → 768). |
QDRANT_HNSW_EF_CONSTRUCT |
128 |
(izvēles klastera profils) | HNSW indeksa precizitāte izveides laikā. Lielāka vērtība = lēnāka izveide, ātrāka meklēšana. |
OMNIROUTE_ROTATION_ENABLED |
true |
open-sse/services/rotationConfig.ts |
Galvenais slēdzis operatora konfigurējamai kontu rotācijai. Ja vērtība ir false, neviena no tālāk norādītajām OMNIROUTE_ROTATE_* klasēm neaktivizē pārslēgšanos uz rezerves kontu (pilnībā izslēgtais stāvoklis bloķē arī pēc noklusējuma iespējotās 429/500/502 klases). Tas ļauj pārraugošajai priekšgalsistēmai (piemēram, VibeProxy darbvirsmas lietotnei) atspoguļot savus rotācijas noteikumus aizmugursistēmas kontu pārslēgšanas dzinējā. |
OMNIROUTE_ROTATION_RATE_LIMIT_RESET_SECONDS |
0 |
open-sse/services/rotationConfig.ts |
Atdzišanas periods (sekundēs), kas tiek piemērots ātruma ierobežojumu sasniegušam kontam, ja augšupstraumes pakalpojums nenorāda konkrētu atiestatīšanas laiku. 0 = fiksētas pārrakstīšanas vērtības vietā izmantot dzinēja noklusējuma atdzišanas periodu. |
OMNIROUTE_ROTATION_DISABLE_TAG_WITHOUT_RESET |
true |
open-sse/services/rotationConfig.ts |
Priekšgalsistēmas iestatījuma „neatzīmēt kā ātruma ierobežojumu sasniegušu bez atiestatīšanas laika” atspoguļojums. |
OMNIROUTE_ROTATE_ON_429 |
true |
open-sse/services/rotationConfig.ts |
Iespējo atkāpšanos konkrētajam statusam 429 kļūdu gadījumā. Ja iestatīts uz false (un OMNIROUTE_ROTATION_ENABLED=true), 429 vairs neizraisa konta rotāciju un tā vietā tiek atgriezts klientam. |
OMNIROUTE_ROTATE_429_THRESHOLD |
1 |
open-sse/services/rotationConfig.ts |
429 kļūdu skaits periodā OMNIROUTE_ROTATE_429_WINDOW_SECONDS, kas nepieciešams, pirms tiek rotēts konts. 1 (noklusējums) izraisa tūlītēju rotāciju, saglabājot līdzšinējo darbību. |
OMNIROUTE_ROTATE_429_WINDOW_SECONDS |
120 |
open-sse/services/rotationConfig.ts |
Slīdošais laika logs (sekundēs), kurā 429 kļūdas tiek skaitītas attiecībā pret OMNIROUTE_ROTATE_429_THRESHOLD. |
OMNIROUTE_ROTATE_ON_500 |
true |
open-sse/services/rotationConfig.ts |
Iespējo atkāpšanos konkrētajam statusam 5xx servera kļūdu gadījumā (izņemot 502, kam ir sava klase). Ja iestatīts uz false, šīs kļūdas vairs neizraisa konta rotāciju. |
OMNIROUTE_ROTATE_500_THRESHOLD |
1 |
open-sse/services/rotationConfig.ts |
5xx kļūdu skaits periodā OMNIROUTE_ROTATE_500_WINDOW_SECONDS, kas nepieciešams, pirms tiek rotēts konts. 1 (noklusējums) izraisa tūlītēju rotāciju. |
OMNIROUTE_ROTATE_500_WINDOW_SECONDS |
120 |
open-sse/services/rotationConfig.ts |
Slīdošais laika logs (sekundēs), kurā 5xx kļūdas tiek skaitītas attiecībā pret OMNIROUTE_ROTATE_500_THRESHOLD. |
OMNIROUTE_ROTATE_ON_502 |
true |
open-sse/services/rotationConfig.ts |
Iespējo atkāpšanos konkrētajam statusam 502 (nepareiza vārteja) kļūdu gadījumā. Ja iestatīts uz false, 502 kļūdas vairs neizraisa konta rotāciju. |
OMNIROUTE_ROTATE_502_THRESHOLD |
1 |
open-sse/services/rotationConfig.ts |
502 kļūdu skaits periodā OMNIROUTE_ROTATE_502_WINDOW_SECONDS, kas nepieciešams, pirms tiek rotēts konts. 1 (noklusējums) izraisa tūlītēju rotāciju. |
OMNIROUTE_ROTATE_502_WINDOW_SECONDS |
120 |
open-sse/services/rotationConfig.ts |
Slīdošais laika logs (sekundēs), kurā 502 kļūdas tiek skaitītas attiecībā pret OMNIROUTE_ROTATE_502_THRESHOLD. |
OMNIROUTE_ROTATE_ON_400 |
false |
open-sse/services/rotationConfig.ts |
Izvēles iestatījums (pēc noklusējuma IZSLĒGTS): ja iestatīts uz true, arī parasta 400 (nederīgs pieprasījums) kļūda izraisa konta rotāciju. Šī darbība ir tikai papildinoša — tā nekad nebloķē dzinēja esošo darbību, kurā 400, kas satur ātruma ierobežojuma vai kvotas tekstu, joprojām izraisa atkāpšanos neatkarīgi no šī karoga. |
OMNIROUTE_ROTATE_400_THRESHOLD |
1 |
open-sse/services/rotationConfig.ts |
400 kļūdu skaits OMNIROUTE_ROTATE_400_WINDOW_SECONDS periodā, kas nepieciešams pirms konta rotācijas (tiek ņemts vērā tikai tad, ja OMNIROUTE_ROTATE_ON_400=true). |
OMNIROUTE_ROTATE_400_WINDOW_SECONDS |
120 |
open-sse/services/rotationConfig.ts |
Slīdošais logs (sekundēs), kurā 400 kļūdas tiek uzskaitītas OMNIROUTE_ROTATE_400_THRESHOLD sasniegšanai. |
Claude iesildīšanas plānotājs
Cron vadīta iesildīšana Anthropic OAuth savienojumiem, kuriem tā ir iespējota, lai 5 stundu ātruma ierobežojuma logs tiktu atvērts ar vienkāršu ieplānotu pieprasījumu, nevis ar pirmo reālo pieprasījumu (#8848). Plānotājs ir izslēgts, ja vien OMNIROUTE_WARMUP_ENABLED nav patiess un savienojums nav atzīmēts sadaļā settings.claudeWarmup.connections; tukšs savienojumu saraksts nozīmē, ka nekas netiek iesildīts pat tad, ja vides mainīgais ir ieslēgts.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_WARMUP_ENABLED |
(nav iestatīts → izslēgts) | src/lib/warmupScheduler.ts |
Galvenais iesildīšanas plānotāja slēdzis. Pieņem 1/true/yes/on (nav reģistrjutīgs, atstarpes tiek noņemtas). Jebkura cita vērtība vai neiestatīta vērtība atstāj plānotāju izslēgtu. |
OMNIROUTE_WARMUP_CRON |
0 7 * * * |
src/lib/warmupScheduler.ts |
Piecu lauku cron izteiksme iesildīšanas aktivizēšanai, kas tiek izvērtēta laika joslā America/Los_Angeles (Anthropic atiestatīšanas laika josla) neatkarīgi no resursdatora pulksteņa. |
OMNIROUTE_WARMUP_CONCURRENCY |
3 |
src/lib/warmupScheduler.ts |
Savienojumu skaits, kas katrā aktivizēšanas reizē tiek iesildīti paralēli. Ierobežots diapazonā no 1 līdz 10; ja vērtība nav skaitlis, tiek izmantots 3. |
OMNIROUTE_WARMUP_MODEL |
claude-3-5-haiku-20241022 |
src/lib/warmupScheduler.ts |
Iesildīšanas pieprasījumam izmantotais modelis. Mainiet tikai tad, ja noklusējuma modelis jūsu plānā nav pieejams; izvēlieties lētāko modeli, kas joprojām atver logu. |
Pārlūkprogrammas pieteikšanās VNC sesijas un datu direktorija aizstājvārds
Konteinerizēts Chromium+VNC, ko izmanto interaktīvai pārlūkprogrammas pieteikšanās akreditācijas datu iegūšanai (/api/vnc-session), kā arī mantots DATA_DIR aizstājvārds. Viss ir neobligāts — VNC noklusējuma iestatījumi ir paredzēti komplektā iekļautajam omniroute-vnc-chromium:local attēlam un tiek mainīti tikai pielāgotam konteinera attēlam, portiem vai dzīves cikla pielāgošanai.
| Mainīgais | Noklusējuma vērtība | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_VNC_IMAGE |
omniroute-vnc-chromium:local |
src/lib/vncSession/manifest.ts |
Docker attēla tags Chromium+VNC pieteikšanās konteineram. Izveidojiet docker/vnc-browser/chromium vai norādiet pielāgotu attēlu. |
OMNIROUTE_DOCKER_BIN |
docker |
src/lib/vncSession/manifest.ts |
Konteinera izpildvides binārais fails, ko izmanto VNC konteinera palaišanai (piemēram, iestatiet uz podman). |
OMNIROUTE_VNC_CONTAINER_VNC_PORT |
3000 |
src/lib/vncSession/manifest.ts |
VNC/noVNC ports, kas pieejams konteinera iekšienē. |
OMNIROUTE_VNC_CONTAINER_CDP_PORT |
9223 |
src/lib/vncSession/manifest.ts |
Chrome DevTools Protocol ports konteinera iekšienē. |
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR |
/config |
src/lib/vncSession/manifest.ts |
Chromium profila direktorija ceļš konteinera iekšienē. |
OMNIROUTE_VNC_PROFILE_DIR |
$HOME/.omniroute/browser-login-profiles |
src/lib/vncSession/manifest.ts |
Resursdatora direktorija, kurā tiek glabāti pastāvīgie pārlūkprogrammas pieteikšanās profili. |
OMNIROUTE_VNC_IDLE_MS |
600000 (10 min) |
src/lib/vncSession/manifest.ts |
Dīkstāves taimauts (ms), pēc kura neaktīva VNC sesija tiek likvidēta. |
OMNIROUTE_VNC_MAX_MS |
1800000 (30 min) |
src/lib/vncSession/manifest.ts |
Vienas VNC sesijas maksimālā ilguma stingrais ierobežojums (ms). |
OMNIROUTE_VNC_MAX_SESSIONS |
4 |
src/lib/vncSession/manifest.ts |
Maksimālais vienlaicīgo VNC sesiju skaits. |
OMNIROUTE_VNC_READY_MS |
45000 |
src/lib/vncSession/manifest.ts |
Taimauts (ms), gaidot, līdz konteinerizētā pārlūkprogramma ir gatava CDP savienojumam. |
OMNIROUTE_VNC_HARVEST_MS |
20000 |
src/lib/vncSession/manifest.ts |
Taimauts (ms) tvertās sesijas/sīkdatņu iegūšanai pēc pieteikšanās pabeigšanas. |
OMNIROUTE_VNC_CHROMIUM_ARGS |
--remote-debugging-port=9222 --no-first-run --no-default-browser-check |
src/lib/vncSession/manifest.ts |
Papildu komandrindas karodziņi, kas tiek nodoti konteinerizētajam Chromium. |
OMNIROUTE_VNC_NETWORK |
omniroute-vnc-browser-login |
src/lib/vncSession/manifest.ts |
Atsevišķs Docker tīkls, kuram noklusējuma tilta vietā pievienojas VNC pieteikšanās konteiners (#12571), lai blakus esošie konteineri nevarētu piekļūt tā CDP tilta portam. |
VIBEPROXY_DATA_DIR |
(nav iestatīts) | open-sse/services/notionThreadSessions.ts |
Novecojis aizstājvārds mainīgajam DATA_DIR; tas tiek pārbaudīts tikai tad, ja nav iestatīts ne DATA_DIR, ne OMNIROUTE_DATA_DIR. Norāda Notion tīmekļa pavedienu sesiju kešatmiņas atrašanās vietu (<dir>/notion-web-thread-sessions.json). |
26. Testu un E2E pārbaudes ietvars
Izmanto scripts/dev/run-next-playwright.mjs, scripts/dev/smoke-electron-packaged.mjs,
scripts/dev/run-ecosystem-tests.mjs un scripts/build/uninstall.mjs. Produkcijas
izvietojumos visas tālāk norādītās vērtības atstājiet neiestatītas.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_E2E_BOOTSTRAP_MODE |
auth |
scripts/dev/run-next-playwright.mjs |
E2E inicializācijas režīms (auth, fresh, reuse) Playwright izpildītājam. |
OMNIROUTE_E2E_PASSWORD |
izmanto INITIAL_PASSWORD |
scripts/dev/run-next-playwright.mjs |
Playwright vidē ievadītā administratora parole. |
OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK |
true |
scripts/dev/run-next-playwright.mjs |
Atspējot lokālās darbspējas pārbaudes aptauju Playwright izpildes laikā. |
OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK |
true |
scripts/dev/run-next-playwright.mjs |
Testu laikā atspējot OAuth marķieru darbspējas pārbaudes ciklu. |
OMNIROUTE_HEALTHCHECK_SKIP_PROVIDERS |
(nav iestatīts) | src/lib/tokenHealthCheck.ts |
Ar komatiem atdalīti pakalpojumu sniedzēji, kas izslēgti no proaktīvās marķieru atsvaidzināšanas pārbaudes (piem., codex,openai). Mērķēta alternatīva pilnīgai darbspējas pārbaudes atspējošanai — īsa TTL sniedzēji turpina atsvaidzināšanu, bet kaskādes sniedzēji darbojas tikai reaģējošā režīmā. |
OMNIROUTE_HIDE_HEALTHCHECK_LOGS |
true |
scripts/dev/run-next-playwright.mjs |
Nerādīt darbspējas pārbaužu ziņojumus Playwright standarta izvadē. |
OMNIROUTE_PLAYWRIGHT_SKIP_BUILD |
0 |
scripts/dev/run-next-playwright.mjs |
Izlaist Next.js produkcijas būvējumu pirms Playwright palaišanas (CI optimizācija). |
OMNIROUTE_SKIP_UNINSTALL_HOOK |
0 |
scripts/build/uninstall.mjs |
Izlaist OmniRoute atinstalēšanas āķi (CI to izmanto, lai saglabātu node_modules neskartu). |
ECOSYSTEM_SERVER_WAIT_MS |
180000 |
scripts/dev/run-ecosystem-tests.mjs |
Gaidīšanas laiks (ms), līdz serveris kļūst darbspējīgs, pirms tiek palaisti ekosistēmas/protokola testi. |
ELECTRON_SMOKE_URL |
http://127.0.0.1:20128/login |
scripts/dev/smoke-electron-packaged.mjs |
URL, kurā Electron ātrās pārbaudes ietvars sagaida iepakotās lietotnes darbību. |
ELECTRON_SMOKE_TIMEOUT_MS |
45000 |
scripts/dev/smoke-electron-packaged.mjs |
Kopējais taimauts (ms), pēc kura ātrās pārbaudes ietvars pārtrauc mēģinājumus. |
ELECTRON_SMOKE_SETTLE_MS |
2000 |
scripts/dev/smoke-electron-packaged.mjs |
Stabilizācijas periods (ms) pēc lapas ielādes. |
ELECTRON_SMOKE_APP_EXECUTABLE |
(automātiski) | scripts/dev/smoke-electron-packaged.mjs |
Precīzs ceļš uz iepakotās Electron lietotnes izpildāmo failu. |
ELECTRON_SMOKE_DATA_DIR |
(tmpdir) | scripts/dev/smoke-electron-packaged.mjs |
Datu direktorijs Electron ātrās pārbaudes izpildei. |
ELECTRON_SMOKE_KEEP_DATA |
0 |
scripts/dev/smoke-electron-packaged.mjs |
Iestatiet 1, lai pēc izpildes saglabātu pārbaudes datu direktoriju. |
ELECTRON_SMOKE_STREAM_LOGS |
0 |
scripts/dev/smoke-electron-packaged.mjs |
Iestatiet 1, lai izpildes laikā straumētu Electron žurnālus uz stdout. |
ELECTRON_SMOKE_COLD_RESTART |
0 |
scripts/dev/smoke-electron-packaged.mjs |
#7592: atkārtoti palaist ar to pašu datu direktoriju un pārbaudīt, ka otrajā palaišanas reizē tiek atlasīts vietējais SQLite draiveris. |
CLI_DEVIN_BIN |
(PATH uzmeklēšana) | open-sse/executors/devin-cli.ts |
Pārrakstīt Devin CLI binārā faila ceļu. |
Dokumentācijas tulkošanas konveijers
Izmanto scripts/i18n/run-translation.mjs (komanda npm run i18n:run).
Visi pieci mainīgie pēc noklusējuma nav iestatīti — iestatiet tos failā .env tikai tajās iekārtās,
kurās jābūt iespējai palaist dokumentācijas tulkotāju.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_TRANSLATION_API_URL |
(nav iestatīts) | scripts/i18n/run-translation.mjs |
Ar OpenAI saderīgs tulkošanas aizmugursistēmas bāzes URL. |
OMNIROUTE_TRANSLATION_API_KEY |
(nav iestatīts) | scripts/i18n/run-translation.mjs |
Tulkošanas aizmugursistēmas Bearer pilnvara (nekad netiek reģistrēta žurnālā). |
OMNIROUTE_TRANSLATION_MODEL |
(nav iestatīts) | scripts/i18n/run-translation.mjs |
Modeļa ID, piemēram, gpt-4o-mini vai cx/gpt-5.4-mini. |
OMNIROUTE_TRANSLATION_TIMEOUT_MS |
60000 |
scripts/i18n/run-translation.mjs |
Katra pieprasījuma taimauts milisekundēs. |
OMNIROUTE_TRANSLATION_CONCURRENCY |
4 |
scripts/i18n/run-translation.mjs |
Paralēlie tulkošanas pieprasījumi, apstrādājot vairākus failus/lokalizācijas. |
27. Radar plūsma (pašmitināšana)
Izvēles papildinājums, ko kontrolē RADAR_ENABLED funkcijas karodziņš (pēc noklusējuma izslēgts — funkcijas
karodziņš, kas pārslēdzams sadaļā Settings/DB, nevis ar vides mainīgo; skatiet
docs/frameworks/RADAR.md).
Pirmie četri tālāk norādītie mainīgie ir neobligātas pārrakstīšanas vērtības pašmitinātai vai atzarotai plūsmai un
atbalstītāja atslēgas darbplūsmām. Piektais, RADAR_ADMIN_URL, ir atsevišķa saite bez noklusējuma vērtības uz īpašnieka
privāto operāciju paneli. Pilnu moduļa dokumentāciju un tā
visaptverošo aktivizēšanas un vadītās iestatīšanas secību skatiet docs/frameworks/RADAR.md.
Vispārīgais Home/Changelog paziņojumu lasītājs netiek konfigurēts ar vides
mainīgo un nav atkarīgs no RADAR_ENABLED funkcijas karodziņa. Tas tikai ar
GET nolasa publiskā repozitorija news.json URL, kas norādīts failā
src/shared/utils/releaseNotes.ts; noraidīšanas ID paliek pārlūkprogrammas lokālajā krātuvē.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
RADAR_FEED_URL |
https://radar.omniroute.online |
src/lib/radar/{sync,referralsSync,offersSync,intelSync}.ts |
Bāzes URL, ko kopīgi izmanto atsevišķi parakstītās kataloga, ieteikumu, atbalstītāju piedāvājumu un Intel plūsmas. Pārrakstiet to, lai norādītu uz pašmitinātu vai atzarotu pakalpojumu. |
RADAR_FEED_PUBKEY |
(piesprausta noklusējuma atslēga) | src/lib/radar/pinnedKeys.ts |
Ed25519 publiskā atslēga (base64-DER SPKI vai PEM), ko izmanto pielāgotas plūsmas parakstu pārbaudei. |
RADAR_CONTRIBUTOR_CLAIM_URL |
https://radar.omniroute.online/auth/github |
src/lib/radar/links.ts |
URL, ko atver informācijas paneļa poga „Esmu līdzstrādnieks” (GitHub OAuth atbalstītāja atslēgas pieprasīšanas darbplūsma). |
RADAR_SUPPORTER_PLANS_URL |
https://radar.omniroute.online/planos |
src/lib/radar/links.ts |
URL, ko atver informācijas paneļa poga „Atbalstīt projektu” (maksājumu/plānu lapa). |
RADAR_ADMIN_URL |
(nav iestatīts) | src/lib/radar/links.ts |
Tikai īpašniekam paredzēta saite uz privāto operāciju paneli. HTTPS ir obligāts, izņemot HTTP atgriezeniskās cilpas SSH pārsūtīšanu; neiestatītas vai nederīgas vērtības neizveido navigācijas vienumu. |
Audits: noņemtie / neizmantotie mainīgie
Tālāk norādītie mainīgie bija iekļauti iepriekšējās .env.example versijās, taču pašreizējā kodu bāzē uz tiem nav izpildlaika atsauču. Tie ir noņemti:
| Mainīgais | Iemesls |
|---|---|
STORAGE_DRIVER=sqlite |
Neviens avota fails to nelasa. SQLite ir vienīgais atbalstītais draiveris — izvēle nav nepieciešama. |
INSTANCE_NAME=omniroute |
Ir atrodams vecajā dokumentācijā/vides veidnēs, taču izpildlaikā netiek izmantots. Tas var atgriezties nākotnes vairāku instanču funkcionalitātē. |
SQLITE_MAX_SIZE_MB=2048 |
Avota kodā nav atsauču uz to. Datubāzes izmērs netiek mākslīgi ierobežots. |
SQLITE_CLEAN_LEGACY_FILES=true |
Avota kodā nav atsauču uz to. Mantoto failu tīrīšana, visticamāk, tika noņemta. |
CLI_ROO_BIN |
Nav reģistrēts failā src/shared/services/cliRuntime.ts. |
CLI_KIMI_CODING_BIN |
Nav reģistrēts failā src/shared/services/cliRuntime.ts (Kimi Coding izmanto OAuth, nevis CLI bināro failu). |
IFLOW_OAUTH_CLIENT_ID / IFLOW_OAUTH_CLIENT_SECRET |
Avota kodā nekur nav atsauču uz tiem. |
CEREBRAS_API_KEY / COHERE_API_KEY / FIREWORKS_API_KEY / GROQ_API_KEY / MISTRAL_API_KEY / NEBIUS_API_KEY / PERPLEXITY_API_KEY / TOGETHER_API_KEY / XAI_API_KEY |
Noņemti versijā v3.8.0. Izpildlaika vide vairs nelasa šos vides mainīgos — akreditācijas dati tiek iegūti no informācijas paneļa / data/provider-credentials.json / šifrētas DB. |
CURSOR_PROTOBUF_DEBUG |
Noņemts versijā v3.8.0. Cursor izpildītājs izmanto CURSOR_DEBUG / CURSOR_STREAM_DEBUG (skatiet §22). |
CLI_COMPAT_KIRO |
Noņemts versijā v3.8.0. Kiro ir iekļauts CLI_COMPAT_OMITTED_PROVIDER_IDS — tā pārslēgšana neko neietekmē. |
QIANFAN_API_KEY |
Noņemts kopā ar citām neizmantotām pakalpojumu sniedzēju API atslēgu sagatavēm versijā v3.8.0. |
Noklusējuma vērtību labojumi
| Mainīgais | Vecā .env.example vērtība |
Faktiskā koda noklusējuma vērtība | Labojums |
|---|---|---|---|
APP_LOG_RETENTION_DAYS |
90 |
7 |
✅ Maldinošā vērtība noņemta; 7 dokumentēta kā noklusējuma vērtība |
CALL_LOG_RETENTION_DAYS |
90 |
7 |
✅ Maldinošā vērtība noņemta; 7 dokumentēta kā noklusējuma vērtība |
OpenCode konfigurācijas atkārtota ģenerēšana (ad hoc rīki)
Skripts scripts/ad-hoc/regen-opencode-config.ts to izmanto, lai atkārtoti ģenerētu opencode.json
ar precīzām limit.context un limit.output vērtībām, kas iegūtas no darbojošās
OmniRoute instances. Nekas no tā nav nepieciešams normālai darbībai — šis skripts
ir paredzēts tikai izstrādātāju rīkiem.
| Mainīgais | Noklusējuma vērtība | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_URL |
http://localhost:20128 |
scripts/ad-hoc/regen-opencode-config.ts |
OmniRoute instances bāzes URL, kurā vaicāt /v1/models. |
OMNIROUTE_KEY |
(nav iestatīts) | scripts/ad-hoc/regen-opencode-config.ts |
API atslēga autentifikācijai OmniRoute galapunktā /v1/models. Ja nav iestatīta, tiek izmantota OPENCODE_API_KEY. |
OPENCODE_API_KEY |
(nav iestatīts) | scripts/ad-hoc/regen-opencode-config.ts |
OpenCode stila API atslēga (sk-...), kas tiek ierakstīta no jauna ģenerētajā opencode.json. Ja nav iestatīta, tiek izmantota OMNIROUTE_KEY. |
Kompresijas bezsaistes novērtēšanas ietvars (ad-hoc rīki)
To izmanto scripts/compression-eval/index.ts — bezsaistes kompresijas novērtēšanas CLI.
Nav nepieciešams normālai darbībai — paredzēts tikai izstrādātāju rīkiem.
| Mainīgais | Noklusējuma vērtība | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_EVAL_CREDENTIALS |
{} (tukšs) |
scripts/compression-eval/index.ts |
Operatora nodrošināti JSON akreditācijas dati pakalpojuma sniedzējam, ko izmanto bezsaistes kompresijas novērtēšanas CLI (parsēti ar JSON.parse). Atstājiet neiestatītu izmēģinājuma palaišanai. |
VNC pārlūka sesijas
To izmanto src/lib/vncSession/manifest.ts, lai konfigurētu uz Docker balstītas Chromium sesijas bez grafiskās saskarnes pārlūka automatizācijas pakalpojumu sniedzējiem. Visi mainīgie ir neobligāti — noklusējuma vērtības ir parādītas tālāk.
| Mainīgais | Noklusējuma vērtība | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_DOCKER_BIN |
docker |
src/lib/vncSession/manifest.ts |
Ceļš uz Docker bināro failu, ko izmanto VNC konteineru palaišanai. |
OMNIROUTE_VNC_IMAGE |
omniroute-vnc-chromium:local |
src/lib/vncSession/manifest.ts |
Docker attēls VNC Chromium konteineram. |
OMNIROUTE_VNC_CHROMIUM_ARGS |
(iebūvētie karodziņi) | src/lib/vncSession/manifest.ts |
Papildu Chromium CLI argumenti, kas tiek nodoti pārlūkam konteinerā. |
OMNIROUTE_VNC_CONTAINER_VNC_PORT |
3000 |
src/lib/vncSession/manifest.ts |
VNC ports konteinerā. |
OMNIROUTE_VNC_CONTAINER_CDP_PORT |
9223 |
src/lib/vncSession/manifest.ts |
Chrome DevTools Protocol ports konteinerā. |
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR |
/config |
src/lib/vncSession/manifest.ts |
Profila direktorijs konteinerā. |
OMNIROUTE_VNC_PROFILE_DIR |
(nav iestatīts) | src/lib/vncSession/manifest.ts |
Resursdatora direktorijs pastāvīgiem pārlūka profiliem. |
OMNIROUTE_VNC_IDLE_MS |
600000 |
src/lib/vncSession/manifest.ts |
Dīkstāves taimauts (ms), pēc kura VNC sesija tiek savākta. |
OMNIROUTE_VNC_MAX_MS |
1800000 |
src/lib/vncSession/manifest.ts |
Maksimālais sesijas ilgums (ms). |
OMNIROUTE_VNC_MAX_SESSIONS |
4 |
src/lib/vncSession/manifest.ts |
Maksimālais vienlaicīgo VNC sesiju skaits. |
OMNIROUTE_VNC_READY_MS |
45000 |
src/lib/vncSession/manifest.ts |
Pārlūka gatavības taimauts (ms). |
OMNIROUTE_VNC_HARVEST_MS |
20000 |
src/lib/vncSession/manifest.ts |
Savākšanas/tīrīšanas taimauts (ms). |
OMNIROUTE_VNC_NETWORK |
omniroute-vnc-browser-login |
src/lib/vncSession/manifest.ts |
Īpašais Docker tīkls, kuram pievienojas konteiners (#12571), apejot noklusējuma tiltu. |
VIBEPROXY_DATA_DIR |
(nav iestatīts) | open-sse/services/notionThreadSessions.ts |
Direktorijs Notion pavedienu sesiju pastāvīgai glabāšanai. |
Iekšējo pakalpojumu autentifikācija
| Mainīgais | Noklusējuma vērtība | Apraksts |
|---|---|---|
OMNIROUTE_INTERNAL_SERVICE_TOKEN |
– | Iekļauts marķieris pārvaldības plaknes pakalpojumu savstarpējai autentifikācijai. |
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE |
– | Ceļš uz failu, kurā ir iekšējā pakalpojuma marķieris (ieteicams konteineros; pārraksta iekļautā mainīgā vērtību). |
OpenRouter pakalpojumu sniedzēju statistika
| Mainīgais | Noklusējuma vērtība | Apraksts |
|---|---|---|
OPENROUTER_PROVIDER_STATS_ENABLED |
true |
Iestatiet uz false, lai izlaistu OpenRouter atsevišķu pakalpojumu sniedzēju statistikas iegūšanu kataloga bagātināšanai. |
OPENROUTER_PROVIDER_STATS_TTL_MS |
3600000 |
Kešatmiņas TTL (ms) iegūtajai OpenRouter pakalpojumu sniedzēju statistikai. |
Iegultā Redis piesaiste
| Mainīgais | Noklusējuma vērtība | Apraksts |
|---|---|---|
REDIS_BIND_HOST |
127.0.0.1 |
Iegultā Redis pakalpojuma piesaistes adrese. |
REDIS_PORT |
6379 |
Iegultā Redis pakalpojuma ports. |
OMNIROUTE_REDIS_BIND_HOST |
– | OmniRoute tvērumam specifiska ignorēšanas vērtība iegultā Redis piesaistes adresei. |
24. Laidiena v3.8.50 papildinājumi
Šie iestatījumi tika ieviesti pēc iepriekšējā vides līguma momentuzņēmuma.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_CHAT_ADMISSION_QUEUE_MS |
2000 |
src/shared/middleware/chatBodyAdmission.ts |
Maksimālais gaidīšanas laiks resursietilpīgas tērzēšanas uzņemšanas vietas saņemšanai pirms atkārtojama 503; īsa, ierobežota gaidīšana serializē aģentu pieprasījumu uzplūdus, nevis nekavējoties atgriež 503. 0 atjauno tūlītēju noraidīšanu. |
OMNIROUTE_CHAT_ADMISSION_MAX_QUEUED_BYTES |
4194304 (4 MB) |
src/shared/middleware/chatBodyAdmission.ts |
Rindā ievietoto baitu budžets uzņemšanas gaidīšanai: ierobežo kopējo buferēto pieprasījumu pamattekstu baitu apjomu, kas aizturēts visa procesa mērogā, lai gaidīšana nevarētu palielināt kaudzes lietojumu (#4380). Gaidīšanas pieprasījumi, kas pārsniedz budžetu, nekavējoties saņem atkārtojamu 503. |
OMNIROUTE_CHAT_VIRTUAL_TTL_MS |
60000 (60 s) |
src/shared/middleware/chatBodyAdmission.ts |
Kopš #10110 novecojis un neko neveic: katras sesijas uzņemšanas joslas tika noņemtas par labu vienam visa procesa budžetam. Tiek pieņemts konfigurācijas saderībai, bet ignorēts. |
OMNIROUTE_CHAT_VIRTUAL_MAX_SESSIONS |
64 |
src/shared/middleware/chatBodyAdmission.ts |
Kopš #10110 novecojis un neko neveic: katras sesijas uzņemšanas joslas tika noņemtas par labu vienam visa procesa budžetam. Tiek pieņemts konfigurācijas saderībai, bet ignorēts. |
OMNIROUTE_CHAT_VIRTUAL_LANES |
0 (izslēgts) |
open-sse/services/admission/runtime.ts |
Adaptīvās izpildlaika virtuālās uzņemšanas joslas (#9654): galvenais slēdzis katra nomnieka adaptīvajai vārtejai (2. sistēma). Atšķiras no iepriekš minētajiem novecojušajiem katra savienojuma joslu mainīgajiem (TTL_MS / MAX_SESSIONS, kopš #10110 neko neveic). Informācijas paneļa funkcijas karodziņš ar tādu pašu nosaukumu; vides mainīgajam ir prioritāte pār informācijas paneļa pārrakstījumu; nepieciešama restartēšana. |
OMNIROUTE_RUNNOW_TIMEOUT_MS |
30000 |
src/app/api/jobs/[id]/run-now/route.ts |
Ierobežo, cik ilgi tūlītējas palaišanas izsaukums gaida notiekošu uzdevumu, pirms sāk rindā ievietoto izpildi. |
ADOBE_FIREFLY_BROWSER_REFRESH |
iespējots | open-sse/services/adobeFireflySession.ts |
Uztur IMS un pārlūkprogrammas riska stāvokli aktuālu, izmantojot kontam piesaistītas Chrome CDP sesijas; iestatiet 0, lai atspējotu. |
ADOBE_FIREFLY_SESSION_DISK |
iespējots | open-sse/services/adobeFireflySession.ts |
Saglabā salabotās Adobe sesijas zem DATA_DIR; iestatiet 0, lai stāvokli glabātu tikai atmiņā. |
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS |
12000 |
open-sse/services/adobeFireflySession.ts |
Minimālais intervāls starp Adobe Firefly ģenerēšanas iesniegumiem. |
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS |
15000 |
open-sse/services/adobeFireflySession.ts |
Papildu klusuma periods pēc katra trešā veiksmīgā Adobe iesnieguma. |
ADOBE_FIREFLY_CHROME_HEADLESS |
0 |
open-sse/services/adobeFireflyBrowserLogin.ts |
Tikai atkļūdošanai paredzēts pilnībā bezgalvas režīms; Adobe colligo parasti noraida tā rezultātā iegūto riska sesiju. |
CHROME_PATH |
automātiska noteikšana | open-sse/executors/cloudflare-playground.ts, open-sse/executors/chatgpt-web-codex.ts |
Neobligāts absolūtais ceļš uz Chrome izpildfailu, ko izmanto pārlūkprogrammas vadītie izpildītāji, ja platformas automātiskā noteikšana nav pietiekama. |
TELEGRAM_BOT_TOKEN |
(nav iestatīts) | src/lib/telegram/config.ts |
BotFather pilnvara, kas iespējo ienākošo tīmekļa aizķeri un paraksta Mini App initData. |
TELEGRAM_WEBHOOK_SECRET |
(nav iestatīts) | src/lib/telegram/config.ts |
Koplietotais noslēpums, kas reģistrēts, izmantojot setWebhook, un katrā tīmekļa aizķeres piegādē pārbaudīts pret galveni X-Telegram-Bot-Api-Secret-Token. Nepieciešams tīmekļa aizķeres ceļam; ja tas nav iestatīts, tīmekļa aizķeres piegādes tiek noraidītas ar 503. |
TELEGRAM_DEFAULT_MODEL |
auto/chat |
src/lib/telegram/chatProxy.ts |
Telegram tērzēšanas atbildēm izmantotais modelis. |
TELEGRAM_BOT_API_BASE |
https://api.telegram.org |
src/lib/telegram/config.ts |
Bot API bāzes URL pārrakstījums starpniekserveriem vai pašu mitinātiem Bot API serveriem. |
TELEGRAM_WEBHOOK_TIMEOUT_MS |
60000 |
src/lib/telegram/config.ts |
Izejošo Bot API izsaukumu taimauts milisekundēs. |
OMNIROUTE_OPTIONAL_PACK_TAR |
1 (iespējots) |
scripts/build/optionalPackStaging.mjs |
Iestatiet 0, lai, sagatavojot neobligātās ML/pārlūkprogrammas pakotnes Electron savrupās versijas kokam, netiktu izveidoti .tar.gz tar arhīvi (pakotņu direktoriji un optional-packs.index.json joprojām tiek izveidoti). Darbvirsmas laidiena darbplūsma to izmanto, lai samazinātu augšupielādējamo artefaktu apjomu. |
ChatGPT Web (Codex)
Globālie noklusējumi bezgalvas pārlūkprogrammai un izejošajam rīku tunelim. Informācijas panelī iestatītajām savienojuma vērtībām ir prioritāte.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
CHATGPT_WEB_CODEX_CHROME_PATH |
(automātiska noteikšana) | open-sse/executors/chatgpt-web-codex.ts |
Tiešs Chrome/Chromium ceļš npm, systemd un PM2 darbībai. |
CHROME_PATH |
(automātiska noteikšana) | open-sse/executors/chatgpt-web-codex.ts |
Kopīgs atkāpšanās variants tieši norādītam Chrome/Chromium ceļam. |
CHATGPT_WEB_CODEX_CDP_URL |
(nav iestatīts) | open-sse/executors/chatgpt-web-codex.ts |
Iekšējais CDP galapunkts; Docker izmanto blakusprocesu portā 9223. |
CDP_PROXY_TOKEN |
(nav iestatīts) | docker/chatgpt-web-codex-browser/cdp-proxy.mjs |
Ja iestatīts, katrā pieprasījumā CDP starpniekservera blakusprocesam šī vērtība jānosūta galvenē X-Omni-Cdp-Token (#13679). Ja vērtība nav iestatīta, starpniekserveris pārsūta pieprasījumus bez autentifikācijas — tādā gadījumā aizsardzību nodrošina tikai Compose tīkla chatgpt-web-codex-net izolācija. Ģenerējiet ar openssl rand -hex 32. |
CHATGPT_WEB_CODEX_TUNNEL_ID |
(nav iestatīts) | open-sse/executors/chatgpt-web-codex.ts |
Globālais OpenAI tuneļa ID lokālām Codex rīku kārtām. |
CHATGPT_WEB_CODEX_RUNTIME_KEY |
(nav iestatīts) | open-sse/executors/chatgpt-web-codex.ts |
Globālā tuneļa izpildlaika atslēga; nekad neizvadiet to žurnālos. |
CHATGPT_WEB_CODEX_CONNECTOR_NAME |
OmniRoute Codex v2 |
open-sse/executors/chatgpt-web-codex.ts |
Precīzs jaunizveidotā ChatGPT pielāgotā savienotāja nosaukums MCP tiltam. |
CODEX_CHATGPT_WEB_HOME |
<DATA_DIR>/chatgpt-web-codex |
open-sse/vendor/codex-chatgpt-web/config.ts |
Atsevišķs direktorijs pārlūka, brokera un tuneļa stāvoklim. |
CODEX_CHATGPT_WEB_BROWSER_DIAGNOSTICS |
0 |
open-sse/vendor/codex-chatgpt-web/adapters/chatgpt-web/browser-worker.ts |
Ja vērtība ir 1, katrā kontrolpunktā tiek uzņemti pārlūka diagnostikas attēli. |
CODEX_CHATGPT_WEB_LAUNCHER |
(nav iestatīts) | open-sse/vendor/codex-chatgpt-web/config.ts |
Neobligāts absolūtais ceļš uz pastāvīgu palaidēja bināro failu. |
CODEX_CHATGPT_WEB_BUN |
(automātiska noteikšana) | open-sse/vendor/codex-chatgpt-web/config.ts |
Neobligāts absolūtais ceļš uz Bun izpildlaika bināro failu. |
CODEX_WEB_GPT_BUN |
(nav iestatīts) | open-sse/vendor/codex-chatgpt-web/config.ts |
Mantotais atkāpšanās variants mainīgajam CODEX_CHATGPT_WEB_BUN; jaunās konfigurācijās izmanto kanonisko nosaukumu. |
OmniConductor tilts
Ilgstošs SSE patērētājs, kas atspoguļo OmniConductor centrmezgla uzdevumus lokālajā A2A TaskManager (src/lib/conductor/). Izvēles funkcija — tilts tiek palaists tikai tad, ja ir iestatīts CONDUCTOR_HUB_URL. Tikai servera pusē: centrmezgla marķieris nekad nedrīkst nonākt pārlūkprogrammā.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
CONDUCTOR_HUB_URL |
(tukšs) | src/lib/conductor/boot.ts |
OmniConductor centrmezgla bāzes URL (piem., http://127.0.0.1:7910). Nav iestatīts = tilts atspējots. |
CONDUCTOR_HUB_TOKEN |
(tukšs) | src/lib/conductor/boot.ts |
Centrmezgla akreditācijas dati SSE plūsmai — centrmezglā izveidojiet spokesperson veida līdzinieku (POST /v1/peers, administratora piekļuve). |
CONDUCTOR_ORCHESTRATOR_TOKEN |
(tukšs) | src/lib/conductor/hubProxy.ts |
Akreditācijas dati ienākošo A2A→centrmezgla uzdevumu deleģēšanai (POST /v1/tasks); ja nav iestatīts, tiek izmantots CONDUCTOR_HUB_TOKEN. |
CONDUCTOR_SPOKESPERSON_URL |
http://127.0.0.1:7920 |
src/lib/conductor/faroProxy.ts |
Spokesperson (Faro) pakalpojuma bāzes URL, kas atrodas aiz informācijas paneļa tērzēšanas starpniekservera (/api/conductor/ask). |
Kvotu ņemoša plānošana
Izmanto open-sse/services/combo.ts un src/lib/quota/quotaScheduler.ts, lai pirms pieprasījuma pārbaudītu marķieru budžetu. Izvēles funkcija — ja tā nav iestatīta, noklusējuma maršrutēšanas darbība nemainās.
| Mainīgais | Noklusējums | Avota fails | Apraksts |
|---|---|---|---|
OMNIROUTE_QUOTA_AWARE_ROUTING |
0 |
open-sse/services/combo.ts |
Ja vērtība ir 1, izlaiž savienojumus, kuru katra perioda marķieru budžets (rateLimitOverrides.tpm, tabula provider_quota_state) pirms nosūtīšanas nevar segt aplēstās pieprasījuma izmaksas. Ja budžets nav konfigurēts, pieprasījums netiek bloķēts. |