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

Environment Variables Reference (తెలుగు)

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

---

OmniRoute గుర్తించే ప్రతి పర్యావరణ వేరియబుల్కు సంబంధించిన సంపూర్ణ సూచన. త్వరిత-ప్రారంభ టెంప్లేట్ కోసం .env.example చూడండి.

Important

ఇక్కడ డాక్యుమెంట్ చేసిన ప్రతి వేరియబుల్ .env.exampleలో కూడా తప్పనిసరిగా ఉండాలి, అలాగే .env.exampleలోని ప్రతి వేరియబుల్ ఇక్కడ తప్పనిసరిగా ఉండాలి. కమిట్ చేసేటప్పుడు మరియు CIలో npm run check:env-doc-sync దీనిని అమలు పరుస్తుంది. ఏదైనా వేరియబుల్ను ఉద్దేశపూర్వకంగా మినహాయించడానికి, దానిని scripts/check/check-env-doc-sync.mjsలోని అనుమతి జాబితాకు జోడించండి.

---

విషయ సూచిక

• 1. అవసరమైన రహస్యాలు
• 2. నిల్వ & డేటాబేస్
• 3. నెట్వర్క్ & పోర్ట్లు
• 4. భద్రత & ప్రామాణీకరణ
• 5. ఇన్పుట్ శుద్ధీకరణ & PII రక్షణ
• 6. సాధన & రూటింగ్ విధానాలు
• 7. URLలు & క్లౌడ్ సమకాలీకరణ
• 8. అవుట్బౌండ్ ప్రాక్సీ
• 9. CLI సాధన సమన్వయం
• 10. అంతర్గత ఏజెంట్ & MCP సమన్వయాలు
• 11. OAuth ప్రొవైడర్ ఆధారాలు
• 12. ప్రొవైడర్ User-Agent ఓవర్రైడ్లు
• 13. CLI ఫింగర్ప్రింట్ అనుకూలత
• 14. API కీ ప్రొవైడర్లు
• 15. గడువు ముగింపు సెట్టింగ్లు
• 16. లాగింగ్
• 17. మెమరీ ఆప్టిమైజేషన్
• 18. ధరల సమకాలీకరణ
• 19. మోడల్ సమకాలీకరణ (Dev)
• 20. ప్రొవైడర్-నిర్దిష్ట సెట్టింగ్లు
• 21. ప్రాక్సీ ఆరోగ్యం
• 22. డీబగ్గింగ్
• 23. GitHub సమన్వయం
• 24. నైపుణ్యాల శాండ్బాక్స్ (v3.8.0+)
• 27. రాడార్ ఫీడ్ (స్వీయ-హోస్టింగ్)
• డిప్లాయ్మెంట్ సందర్భాలు
• ఆడిట్: తొలగించిన / నిరుపయోగ వేరియబుల్స్

---

1. అవసరమైన రహస్యాలు

మొదటిసారి అమలు చేయడానికి ముందు వీటిని తప్పనిసరిగా సెట్ చేయాలి. ఇవి లేకుండా, అప్లికేషన్ ప్రారంభం కావడానికి నిరాకరిస్తుంది లేదా అసురక్షిత డిఫాల్ట్లతో పనిచేస్తుంది.

వేరియబుల్	అవసరం	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
JWT_SECRET	అవును	(ఏదీ లేదు)	src/lib/auth	అన్ని డ్యాష్బోర్డ్ సెషన్ కుకీలకు (JWT) సంతకం చేస్తుంది/ధృవీకరిస్తుంది. openssl rand -base64 48తో రూపొందించండి.
API_KEY_SECRET	అవును	(ఏదీ లేదు)	src/lib/db/apiKeys.ts	SQLiteలో నిష్క్రియ స్థితిలో ఉన్న API కీ విలువల కోసం AES ఎన్క్రిప్షన్ కీ. openssl rand -hex 32తో రూపొందించండి.
INITIAL_PASSWORD	అవును	CHANGEME	బూట్స్ట్రాప్ స్క్రిప్ట్	ప్రారంభ అడ్మిన్ డ్యాష్బోర్డ్ పాస్వర్డ్ను సెట్ చేస్తుంది (.env.example డిఫాల్ట్తో సరిపోలుతుంది — తప్పనిసరిగా మార్చేలా ఉద్దేశపూర్వకంగా అసురక్షితంగా ఉంచబడింది). మొదటిసారి ఉపయోగించే ముందు మార్చండి. లాగిన్ అయిన తర్వాత, డ్యాష్బోర్డ్ → సెట్టింగ్లు → భద్రత ద్వారా మార్చండి.
OMNIROUTE_WS_BRIDGE_SECRET	అవును (ప్రొడక్షన్లో)	(సెట్ చేయబడలేదు)	src/app/api/internal/codex-responses-ws/route.ts	అంతర్గత Codex Responses WebSocket బ్రిడ్జ్ కోసం షేర్డ్ సీక్రెట్. Electron/బ్రౌజర్ WS రిలే మరియు OmniRoute మధ్య బ్రిడ్జ్ అభ్యర్థనలను ధృవీకరిస్తుంది. ⚠️ ప్రొడక్షన్లో అవసరం — ఇది సెట్ చేయబడనప్పుడు, అన్ని WS బ్రిడ్జ్ అభ్యర్థనలు తిరస్కరించబడతాయి. openssl rand -base64 32తో రూపొందించండి.
OMNIROUTE_SW_BUILD_ID	లేదు	(git SHA)	next.config.mjs, scripts/build/assembleStandalone.mjs	PWA షెల్ (#11779) కోసం స్పష్టమైన సర్వీస్-వర్కర్ క్యాష్-బస్టింగ్ id; రిజల్యూషన్ చైన్లో మొదటిది.
SOURCE_VERSION	లేదు	(సెట్ చేయబడలేదు)	next.config.mjs, scripts/build/assembleStandalone.mjs	చైన్లో రెండవది — అమలు చేసిన కమిట్గా PaaS బిల్డర్లు (ఉదా. Heroku-శైలి) దీన్ని సెట్ చేస్తాయి.
NEXT_PUBLIC_SW_BUILD_ID	లేదు	(ఉత్పన్నమైనది)	src/shared/components/PwaRegister.tsx	/sw.js?v=…ను నమోదు చేయడానికి క్లయింట్ ఉపయోగించే బిల్డ్-టైమ్ పబ్లిక్ విలువ; పైన ఉన్న రెండింటి నుండి, ఆపై git SHA నుండి ఉత్పన్నమవుతుంది.
OMNIROUTE_PEER_STAMP_TOKEN	లేదు (స్వయంచాలకం)	(ప్రతి బూట్కు స్వయంచాలకం)	src/server/authz/policies/management.ts	విశ్వసనీయ peer-IP స్టాంప్ OmniRoute స్వంత HTTP సర్వర్ (scripts/dev/peer-stamp.mjs) నుండి వచ్చిందని నిరూపించే ప్రతి-ప్రాసెస్ సీక్రెట్. స్టాంప్లో ఈ టోకెన్ ఉన్నప్పుడు మాత్రమే authz మిడిల్వేర్ అభ్యర్థన స్థానికతను (LOCAL_ONLY రూట్ల loopback/LAN గేటింగ్) విశ్వసిస్తుంది. ప్రతి బూట్లో స్వయంచాలకంగా రూపొందించబడుతుంది — సెట్ చేయకుండా వదిలేయండి; స్టాంప్ను తప్పనిసరిగా పంచుకోవాల్సిన మల్టీ-ప్రాసెస్ సెటప్ల కోసం మాత్రమే దీనిని స్థిరపరచండి.

రూపొందించే కమాండ్లు

# నాలుగు సీక్రెట్లను ఒకేసారి రూపొందించండి:
echo "JWT_SECRET=$(openssl rand -base64 48)"
echo "API_KEY_SECRET=$(openssl rand -hex 32)"
echo "INITIAL_PASSWORD=$(openssl rand -base64 16)"
echo "OMNIROUTE_WS_BRIDGE_SECRET=$(openssl rand -base64 32)"

Caution

నిజమైన సీక్రెట్లు ఉన్న .env ఫైల్లను ఎప్పుడూ వెర్షన్ కంట్రోల్కు కమిట్ చేయవద్దు. .gitignore ఇప్పటికే .envను మినహాయిస్తుంది, అయినప్పటికీ పుష్ చేసే ముందు ధృవీకరించండి.

---

2. నిల్వ & డేటాబేస్

అన్ని డేటా నిల్వ అవసరాల కోసం OmniRoute SQLiteను (better-sqlite3 ద్వారా) ఉపయోగిస్తుంది. ఈ వేరియబుల్స్ డేటా స్థానం, ఎన్క్రిప్షన్ మరియు జీవితచక్రాన్ని నియంత్రిస్తాయి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
DATA_DIR	~/.omniroute/	src/lib/db/core.ts	SQLite DB, బ్యాకప్లు మరియు డేటా ఫైళ్ల కోసం రూట్ డైరెక్టరీ. Docker వాల్యూమ్లు లేదా అనుకూల పాత్ల కోసం దీన్ని ఓవర్రైడ్ చేయండి.
OMNIROUTE_ALLOW_DEFAULT_DATA_DIR	(సెట్ చేయబడలేదు)	src/lib/dataPaths.ts	టెస్ట్/eval DATA_DIR గార్డ్కు అత్యవసర మినహాయింపు మార్గం (#10428). DATA_DIR లేని టెస్ట్లు మరియు Node eval/print ప్రోబ్లు (-e/--eval/-p/--print, --eval=/--print= రూపాలతో సహా) ఆపరేటర్ యొక్క నిజమైన డేటాబేస్ను తెరవకుండా ఉండేందుకు తాత్కాలికంగా ఉపయోగించి విస్మరించే డైరెక్టరీకి మళ్లించబడతాయి; నిజమైన డైరెక్టరీని తిరిగి ఉపయోగించడానికి దీన్ని 1కు సెట్ చేయండి.
OMNIROUTE_BUILD_SHA	(సెట్ చేయబడలేదు)	src/lib/monitoring/buildSha.ts	ప్రస్తుతం అమలవుతున్న ఆర్టిఫాక్ట్ యొక్క Git SHA. npm run build:release ద్వారా ముద్రించబడుతుంది; dist/BUILD_SHA సెంటినెల్ లేకుండా పంపిణీ అయ్యే కంటైనర్లలో ఇంజెక్ట్ చేయవచ్చు. /api/monitoring/healthలో system.buildShaగా చూపబడుతుంది.
OMNIROUTE_RELEASE_REF	origin/main	scripts/build/buildProvenance.ts	pack-artifact ప్రావెనెన్స్ గేట్, బిల్డ్ SHAను దేనితో పోల్చి తనిఖీ చేయాలో తెలిపే ref (#10427).
OMNIROUTE_ALLOW_CANARY_BUILD	(సెట్ చేయబడలేదు)	scripts/build/buildProvenance.ts	విడుదల లైన్లో SHA లేని బిల్డ్ను ప్యాక్ చేయడానికి అనుమతించాలంటే దీన్ని 1కు సెట్ చేయండి; అప్పుడు గేట్ను విఫలం చేయడానికి బదులుగా, దాన్ని ఉద్దేశపూర్వక canaryగా నమోదు చేస్తుంది (#10427).
OMNIROUTE_SMOKE_API_KEY	(సెట్ చేయబడలేదు)	scripts/ops/deploy-canary.mjs	canary-deploy smoke ప్రోబ్ కోసం API కీ; /v1/chat/completionsకు Authorization: Bearerగా పంపబడుతుంది. ఇది deploy స్క్రిప్ట్ (#10429) ద్వారా మాత్రమే ఉపయోగించబడుతుంది, సర్వర్ ద్వారా ఎప్పుడూ ఉపయోగించబడదు. opt-in CLI smoke హార్నెస్కు చెందిన OMNIROUTE_SMOKE_* వేరియబుల్స్తో (tests/integration/upstream-cli-smoke.int.test.tsలోని RUN_CLI_SMOKE=1, OMNIROUTE_SMOKE_BASE_URL/MODEL/API_KEY_ENV/TARGETS/TIMEOUT_MS) దీనికి సంబంధం లేదు — CLI ఇంటిగ్రేషన్లు → నిజమైన smoke sweep చూడండి.
OMNIROUTE_BUILDING	(సెట్ చేయబడలేదు)	src/lib/buildPhase.ts	బిల్డ్-దశ సంకేతం (#10060): scripts/build/build-next-isolated.mjs ద్వారా 1కు సెట్ చేయబడుతుంది మరియు ప్రారంభించబడిన ప్రతి బిల్డ్ వర్కర్కు వారసత్వంగా అందుతుంది. దీనివల్ల DB లేయర్, native better-sqlite3 addonను లోడ్ చేయడానికి బదులుగా no-op stubను తిరిగి ఇస్తుంది (ఆ addon నిష్క్రమణ సమయంలో వర్కర్ను నిలిపివేస్తుంది). అమలవుతున్న సర్వర్ కోసం దీన్ని ఎప్పుడూ సెట్ చేయరు.
OMNIROUTE_SKIP_NATIVE_DEP_CHECK	0	scripts/check/check-native-deps.mjs	అసాధారణ vendored ట్రీల కోసం ఐచ్ఛిక native-dependency prebuild తనిఖీని దాటవేయడానికి దీన్ని 1కు సెట్ చేయండి. దీనివల్ల తప్పిపోయిన dependencyని బిల్డ్ చేయడం సాధ్యం కాదు; native dependencies వేరే మార్గంలో అందించబడినప్పుడు మాత్రమే దీన్ని ఉపయోగించండి.
OMNIROUTE_DATA_DIR	(సెట్ చేయబడలేదు)	open-sse/executors/promptql/threadSticky.ts	DATA_DIRకు fallback alias; DATA_DIR సెట్ చేయబడనప్పుడు మాత్రమే తనిఖీ చేయబడుతుంది. PromptQL executor యొక్క డిస్క్పై ఉండే thread-sticky సెషన్ క్యాష్ను (<dir>/promptql-thread-sessions.json) గుర్తించడానికి ఉపయోగించబడుతుంది; ఏ వేరియబుల్ కూడా సెట్ చేయకపోతే, క్యాష్ మెమరీలో మాత్రమే ఉంటుంది (పునఃప్రారంభాల మధ్య నిల్వ చేయబడదు).
OMNIROUTE_PLUGINS_DIR	(సెట్ చేయబడలేదు)	src/lib/plugins/scanner.ts	runtime plugin scanner చదివే డైరెక్టరీ — అలాగే plugin manager ఇన్స్టాల్ చేసే రూట్ — home నుంచి ఉత్పన్నమయ్యే డిఫాల్ట్ను ఓవర్రైడ్ చేస్తుంది (#11827). scan pathను మార్చడం కోసమే HOMEను తరలించడానికి బదులుగా, Docker/K8sలో bind-mount చేసిన plugin treeను దీనికి సూచించండి (HOME ఇతర అన్ని home-relative ప్రవర్తనలను కూడా నియంత్రిస్తుంది). సెట్ చేయకపోతే = ~/.omniroute/plugins; లేదా process ఎటువంటి homeను export చేయనప్పుడు /tmp/.omniroute/plugins — ఈ వేరియబుల్ నివారించే నిశ్శబ్ద non-discovery ఇదే. పరిష్కరించబడిన డైరెక్టరీ, ప్రాధాన్యం పొందిన inputతో కలిసి startup సమయంలో scanner.dir_resolvedగా ఒకసారి లాగ్ చేయబడుతుంది. సర్వర్ వైపు మాత్రమే: CLI command plugins తమ స్వంత OMNIROUTE_PLUGIN_PATHను (విభాగం 9) కొనసాగిస్తాయి.
STORAGE_ENCRYPTION_KEY	(ఖాళీ = నిలిపివేయబడింది)	src/lib/db/encryption.ts	నిల్వలో ఉన్న పూర్తి SQLite డేటాబేస్ ఎన్క్రిప్షన్ కోసం AES కీ. openssl rand -hex 32తో రూపొందించండి.
STORAGE_ENCRYPTION_KEY_VERSION	v1	scripts/build/bootstrap-env.mjs, electron/main.js	ఎన్క్రిప్షన్ కీకి వెర్షన్ లేబుల్. పాత బ్యాకప్ల డీక్రిప్షన్కు మద్దతు ఇవ్వడానికి కీ రొటేషన్ నిర్వహిస్తున్నప్పుడు దీన్ని పెంచండి.
DISABLE_SQLITE_AUTO_BACKUP	false	src/lib/db/backup.ts	trueగా ఉన్నప్పుడు, సాధారణ/రైట్కు-ముందు SQLite ఫైల్ బ్యాకప్లను (models.dev ధరల సేవ్/క్లియర్, సెట్టింగ్ల రైట్లు) దాటవేస్తుంది. మాన్యువల్ మరియు రీస్టోర్కు-ముందు బ్యాకప్లు ఇప్పటికీ అమలవుతాయి. ఇది మైగ్రేషన్ రన్నర్కు తప్పనిసరైన మన్నికైన భద్రతా స్నాప్షాట్ను లేదా ఇప్పటికే ఉన్న స్థిరమైన DB కోసం మాస్-మైగ్రేషన్ గార్డ్ను నిలిపివేయదు. మాన్యువల్ కాని బ్యాకప్లు ప్రతి 60 నిమిషాలకు గరిష్ఠంగా ఒక్కసారి మాత్రమే జరిగేలా పరిమితం చేయబడతాయి. డ్యాష్బోర్డ్లోని Settings → Storage ద్వారా సాధారణ ఆటో-బ్యాకప్ను స్వతంత్రంగా నిలిపివేయవచ్చు.
OMNIROUTE_CRYPT_KEY	(సెట్ చేయబడలేదు)	src/lib/db/encryption.ts	STORAGE_ENCRYPTION_KEYకు లెగసీ ప్రత్యామ్నాయ పేరు. ప్రాథమిక వేరియబుల్ లేనప్పుడు ఫాల్బ్యాక్గా అంగీకరించబడుతుంది.
OMNIROUTE_API_KEY_BASE64	(సెట్ చేయబడలేదు)	src/lib/db/encryption.ts	ఫాల్బ్యాక్గా అంగీకరించబడే లెగసీ ప్రత్యామ్నాయ పేరు (Base64-ఎన్కోడ్ చేసిన రూపం). ఉపయోగానికి ముందు స్వయంచాలకంగా డీకోడ్ చేయబడుతుంది.
OMNIROUTE_DB_HEALTHCHECK_INTERVAL_MS	(సెట్ చేయబడలేదు)	src/lib/db/core.ts	ఆవర్తన SQLite ఆరోగ్య తనిఖీ విరామాన్ని (ms) ఓవర్రైడ్ చేయండి. సెట్ చేయనప్పుడు, డిఫాల్ట్లు NODE_ENV నుంచి ఉత్పన్నమవుతాయి.
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS	21600000 (6గం.)	src/lib/db/walMaintenance.ts	ఆవర్తన wal_checkpoint(TRUNCATE) విరామాన్ని (ms) ఓవర్రైడ్ చేయండి. ఆటో-చెక్పాయింట్ WAL ఫైల్ను స్వయంగా ఎప్పటికీ కుదించదు, అలాగే ఎక్కువసేపు నడిచే సర్వర్ తన DBని ఎప్పటికీ మూసివేయదు. 0 నిలిపివేస్తుంది.
OMNIROUTE_WAL_PASSIVE_INTERVAL_MS	300000 (5ని.)	src/lib/db/walMaintenance.ts	తరచుగా జరిగే wal_checkpoint(PASSIVE) విరామాన్ని (ms) ఓవర్రైడ్ చేయండి. పెండింగ్ WAL ఫ్రేమ్లను చిన్నగా ఉంచుతుంది, తద్వారా ఆవర్తన TRUNCATE ప్రధాన థ్రెడ్పై బహుళ-GB బ్యాక్లాగ్ను ఎప్పటికీ కాపీ చేయదు. 0 నిలిపివేస్తుంది.
OMNIROUTE_WAL_GUARD_MAX_MB	256	src/lib/db/walMaintenance.ts	PASSIVE టిక్కు WAL ఫైల్ ఈ పరిమాణం కంటే ఎక్కువగా ఉన్నట్లు కనిపించినప్పుడు, నెమ్మదైన టిక్ కోసం వేచి ఉండకుండా వెంటనే wal_checkpoint(TRUNCATE)కు పెంచండి.
OMNIROUTE_PRESSURE_SELF_RESTART	false	open-sse/utils/resourcePressure.ts	తీవ్రమైన వనరుల ఒత్తిడి OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS పాటు కొనసాగిన తర్వాత ప్రాసెస్ నుంచి నిష్క్రమించడానికి దీన్ని 1/true/yes/onగా సెట్ చేయండి; తద్వారా నిరవధికంగా 503లను అందించడానికి బదులుగా, సూపర్వైజర్ (systemd Restart=always, Docker రీస్టార్ట్ విధానం) శుభ్రమైన ప్రాసెస్ను తిరిగి ప్రారంభించగలదు.
OMNIROUTE_PRESSURE_SELF_RESTART_AFTER_MS	120000 (2ని.)	open-sse/utils/resourcePressure.ts	స్వీయ-పునఃప్రారంభ నిష్క్రమణ అమలవడానికి ముందు తీవ్రమైన ఒత్తిడి ఎంతసేపు కొనసాగాలో నిర్దేశిస్తుంది.
OMNIROUTE_SQLJS_WASM_PATH	(స్వయంచాలకంగా గుర్తించు)	src/lib/db/adapters/sqljsAdapter.ts	sql.js WASM ఫాల్బ్యాక్ అడాప్టర్ను ఉపయోగిస్తున్నప్పుడు sql-wasm.wasmకు స్పష్టమైన పాత్ (సంపూర్ణమైనది లేదా cwdకి సాపేక్షమైనది). సెట్ చేయనప్పుడు ప్యాకేజీ డిపెండెన్సీలు మరియు అభ్యర్థి లేఅవుట్ల ద్వారా స్వయంచాలకంగా గుర్తించబడుతుంది.
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS	21600000 (6గం.)	src/lib/db/core.ts	ఆవర్తన wal_checkpoint(TRUNCATE) విరామాన్ని (ms) ఓవర్రైడ్ చేయండి. ఆటో-చెక్పాయింట్ WAL ఫైల్ను స్వయంగా ఎప్పటికీ కుదించదు, అలాగే ఎక్కువసేపు నడిచే సర్వర్ తన DBని ఎప్పటికీ మూసివేయదు. 0 నిలిపివేస్తుంది.
OMNIROUTE_BATCH_RETENTION_DAYS	30	src/lib/db/cleanup.ts	టెర్మినల్ (పూర్తయిన/విఫలమైన/రద్దయిన/గడువు ముగిసిన) Batch API జాబ్కు చెందిన చెక్పాయింట్లు, సూచించబడిన ఇన్పుట్/అవుట్పుట్/లోప ఫైళ్లు మరియు వరుస తొలగింపుకు ముందు స్వయంచాలక క్లీనప్ స్వీప్ ద్వారా ఉంచబడే రోజుల సంఖ్య. BATCH_AND_FILE_AUTO_CLEANUP_ENABLED ఆన్ చేసిన తర్వాత మాత్రమే అమల్లోకి వస్తుంది; OpenAI స్వంత Batch API అవుట్పుట్ నిలుపుదల వ్యవధికి సరిపోలుతుంది. ఆపరేటర్ ప్రారంభించే DELETE /api/v1/batches/delete-completed రూట్పై ప్రభావం చూపదు; ఇది రూపకల్పన ప్రకారం షరతులు లేకుండా (వయస్సు ఫిల్టర్ లేకుండా) కొనసాగుతుంది.
BATCH_AND_FILE_AUTO_CLEANUP_ENABLED	false	src/lib/db/cleanup.ts	trueగా ఉన్నప్పుడు, OMNIROUTE_BATCH_RETENTION_DAYS దాటిన ముగింపు స్థితిలోని Batch API జాబ్లను (మరియు వాటి చెక్పాయింట్లను) ఆటోమేటిక్ క్లీనప్ స్వీప్ తొలగించడానికి, అలాగే వాటి స్వంత expires_at దాటిన అప్లోడ్ చేసిన ఫైళ్ల BLOB కంటెంట్ను క్లియర్ చేయడానికి అనుమతిస్తుంది. డిఫాల్ట్గా ఆఫ్లో ఉంటుంది: ఆపరేటర్ దీన్ని ప్రారంభించే వరకు ఇప్పటికే ఉన్న ప్రతి ఇన్స్టాలేషన్ ఈ డేటాను మునుపటిలాగే ఉంచుతుంది. ఇది డ్యాష్బోర్డ్లో సవరించగల ఫీచర్ ఫ్లాగ్ కూడా — docs/reference/FEATURE_FLAGS.md → రన్టైమ్ చూడండి.
OMNIROUTE_SKIP_DB_HEALTHCHECK	0	src/lib/db/core.ts, src/lib/db/healthCheck.ts	స్టార్టప్లో DB హెల్త్చెక్ను పూర్తిగా దాటవేయడానికి 1గా సెట్ చేయండి. స్వల్పకాలిక టాస్క్లు మరియు ఇంటిగ్రేషన్ టెస్ట్లకు ఉపయోగకరం.
OMNIROUTE_FORCE_DB_HEALTHCHECK	0	src/lib/db/core.ts	సాధారణంగా దాటవేయబడే సందర్భాల్లో కూడా (ఉదా., స్వల్పకాలిక టాస్క్లు) DB హెల్త్చెక్ లూప్ను బలవంతంగా ఆన్ చేయడానికి 1గా సెట్ చేయండి.
OMNIROUTE_SKIP_POSTINSTALL	0	scripts/postinstall.mjs	npm install సమయంలో నేటివ్-రన్టైమ్ వార్మప్ను దాటవేయడానికి 1గా సెట్ చేయండి. sqlite ఇప్పటికే బిల్డ్ అయి ఉన్న CI/హెడ్లెస్ ఇన్స్టాలేషన్లలో ఉపయోగకరం.
OMNIROUTE_MIGRATIONS_DIR	(స్వయంచాలక గుర్తింపు)	src/lib/db/migrationRunner.ts	మైగ్రేషన్ రన్నర్ స్కాన్ చేసే డైరెక్టరీని ఓవర్రైడ్ చేయండి. కస్టమ్ బిల్డ్లలో బండిల్ చేసిన మైగ్రేషన్లను పంపిణీ చేసేటప్పుడు ఉపయోగకరం.
OMNIROUTE_EXTRA_MIGRATIONS_DIRS	(సెట్ చేయబడలేదు)	src/lib/db/migrationRunner/extraDirs.ts	ప్లాట్ఫారమ్ పాత్ డెలిమిటర్తో వేరు చేసిన namespace=dir ఎంట్రీల రూపంలో అదనపు మైగ్రేషన్ డైరెక్టరీలు (ఉదా. ee=/opt/app/enterprise/db/migrations). అక్కడ కనిపించే ఫైళ్లు <namespace>-<number>గా నమోదు చేయబడతాయి, కాబట్టి తన స్వంత మైగ్రేషన్లను అందించే డిస్ట్రిబ్యూషన్ అప్స్ట్రీమ్ సంఖ్యాత్మక స్లాట్లతో ఎప్పటికీ ఘర్షణ పడదు. తప్పుగా రూపొందించిన ఎంట్రీ, చెల్లని నేమ్స్పేస్ లేదా లేని డైరెక్టరీ ఉన్నప్పుడు స్కీమాను నిశ్శబ్దంగా దాటవేయడానికి బదులుగా స్టార్టప్ సమయంలో ఎర్రర్ సంభవిస్తుంది.
OMNIROUTE_MAX_PENDING_MIGRATIONS	50	src/lib/db/migrationRunner.ts	పెద్ద సంఖ్యలో పెండింగ్ మైగ్రేషన్లకు భద్రతా పరిమితి (#3416). ఇప్పటికే ఉన్న DBలో ఇంతకంటే ఎక్కువ మైగ్రేషన్లు పెండింగ్లో ఉంటే స్టార్టప్ నిలిచిపోతుంది (ట్రాకింగ్ టేబుల్ తుడిచివేయబడిన సందర్భం నుంచి రక్షిస్తుంది). పాత బ్యాకప్ను పునరుద్ధరించడానికి దీన్ని పెంచండి; తనిఖీని నిలిపివేయడానికి 0గా సెట్ చేయండి.
OMNIROUTE_INSTALL_UPGRADE_WORKDIR	(<repo>/.install-upgrade)	scripts/check/check-install-upgrade.mjs	check:install-upgrade రిలీజ్ గేట్ కోసం వర్కింగ్ డైరెక్టరీ. దీనికి సుమారు 12 GB అవసరం (రెండు ~3 GB ఇన్స్టాలేషన్ ట్రీలు మరియు tarball), కాబట్టి ఇది చిన్న tmpfsలో రన్ కాకూడదు — స్వీయ-హోస్ట్ చేసిన రన్నర్లో /tmp అనేది 12 GB RAM-ఆధారిత tmpfs, గేట్ దానిని పూర్తిగా వినియోగించడంతో ప్యాకేజ్ మధ్యలో కత్తిరించబడింది.
OMNIROUTE_SPEND_FLUSH_INTERVAL_MS	(కోడ్లో డిఫాల్ట్)	src/lib/spend/batchWriter.ts	బ్యాచ్ చేసిన ఖర్చు/వ్యయ రైటర్ కోసం ఫ్లష్ విరామం (ms). తక్కువ విలువలు రైట్ కోలెసింగ్ను తగ్గిస్తాయి; ఎక్కువ విలువలు DB కంటెన్షన్ను తగ్గిస్తాయి.
OMNIROUTE_SPEND_MAX_BUFFER_SIZE	(కోడ్లో డిఫాల్ట్)	src/lib/spend/batchWriter.ts	బలవంతపు ఫ్లష్కు ముందు బఫర్ చేయగల గరిష్ఠ ఖర్చు ఎంట్రీలు. అధిక-QPS డిప్లాయ్మెంట్లలో పెంచండి; పరిమిత మెమరీకి ఎక్కువ ప్రాధాన్యం ఉన్నప్పుడు తగ్గించండి.
OMNIROUTE_PROXY_FETCH_DEBUG	(సెట్ చేయబడలేదు)	open-sse/utils/proxyFetch.ts	Vercel రిలే పాత్లో [ProxyFetch] డీబగ్ లాగ్లను ఉత్పత్తి చేయడానికి "true"గా సెట్ చేయండి. రూటింగ్ సూచనలు లీక్ కాకుండా ఉండటానికి డిఫాల్ట్గా ఆఫ్లో ఉంటుంది.
PROXY_LOG_INCLUDE_IPS	false	src/lib/proxyLogger.ts	విపులమైన [ProxyEgress] ప్రాసెస్-లాగ్ లైన్లో క్లయింట్/ఎగ్రెస్ IPలు మరియు ఖాతా ప్రిఫిక్స్ను చేర్చడానికి "true" లేదా "1"గా సెట్ చేయండి. ప్రాసెస్ లాగ్ IPలు లేదా ఖాతా ప్రిఫిక్స్ను లీక్ చేయకుండా ఉండేందుకు డిఫాల్ట్గా ఆఫ్లో ఉంచబడింది.
OMNIROUTE_DEBUG	(సెట్ చేయబడలేదు)	bin/cli/commands/quota.mjs	CLI కోటా కమాండ్ల నుంచి ప్రతి అభ్యర్థనకు సంబంధించిన టైమింగ్ డయాగ్నస్టిక్లను ([omniroute] GET <path> completed in Nms) stderrకు ప్రింట్ చేయడానికి 1గా సెట్ చేయండి.
OMNIROUTE_HEALTHCHECK_PATH	(స్వయంచాలకం)	scripts/dev/healthcheck.mjs	కంటైనర్ హెల్త్ చెక్ పరిశీలించే స్పష్టమైన పాత్. ఇది సెట్ చేయబడకపోతే, ప్రోబ్ దాన్ని OMNIROUTE_BASE_PATH నుంచి నిర్ధారిస్తుంది; దీన్ని సెట్ చేయడం ద్వారా డీప్ మానిటరింగ్ ఎండ్పాయింట్ను మళ్లీ ఎంచుకోవచ్చు.
OMNIROUTE_DEBUG_COMPLETION	(సెట్ చేయబడలేదు)	bin/cli/commands/completion.mjs	CLI షెల్-కంప్లీషన్ క్యాష్ పాత్ల (రీడ్/రిఫ్రెష్/రైట్) నుంచి [omniroute completion] డయాగ్నస్టిక్లను ఉత్పత్తి చేయడానికి ఖాళీ కాని ఏదైనా విలువకు సెట్ చేయండి. డిఫాల్ట్గా ఆఫ్లో ఉంటుంది — ఆ క్యాష్లు నిశ్శబ్దంగా విఫలమవుతాయి, కాబట్టి లేని/పాడైన క్యాష్ ఎప్పటికీ ట్యాబ్-కంప్లీషన్ను దెబ్బతీయదు.
BATCH_RETRY_DURATION_MS	86400000 (24గం)	open-sse/services/batchProcessor.ts	ఒక్కో బ్యాచ్ అంశానికి గరిష్ఠ పునఃప్రయత్న వ్యవధి (మి.సె.). ఈ వ్యవధిని మించిన అంశాలు విఫలమైనవిగా గుర్తించబడతాయి.
BATCH_BACKOFF_BASE_MS	5000	open-sse/services/batchProcessor.ts	బ్యాచ్ అంశాల పునఃప్రయత్నాలకు ఎక్స్పోనెన్షియల్ బ్యాక్ఆఫ్ కోసం ప్రాథమిక ఆలస్యం (మి.సె.).
BATCH_BACKOFF_MAX_MS	3600000 (1గం)	open-sse/services/batchProcessor.ts	బ్యాచ్ అంశాల పునఃప్రయత్నాల మధ్య ఎక్స్పోనెన్షియల్ బ్యాక్ఆఫ్కు గరిష్ఠ పరిమితి (మి.సె.).
BATCH_MAX_CONCURRENT	1	open-sse/services/batchProcessor.ts	ఏకకాలంలో ప్రాసెస్ చేయబడే బ్యాచ్ల గరిష్ఠ సంఖ్య. ప్రాసెసింగ్ సామర్థ్యాన్ని పెంచడానికి దీన్ని పెంచండి; రేట్-లిమిట్ సమస్యలు భారీగా తలెత్తకుండా ఉండేందుకు తక్కువగా ఉంచండి.

Important

ఇప్పటికే ఉన్న స్థిరమైన డేటాబేస్ను మార్చడానికి ముందు, మైగ్రేషన్ రన్నర్ DATA_DIR/db_backups/ కింద పూర్తి, కంటెంట్-అడ్రెస్డ్ స్నాప్షాట్ను ప్రచురిస్తుంది. ప్రచురణకు ఒకే ఫైల్సిస్టమ్లో ఓవర్రైట్ చేయని హార్డ్ లింక్లతో పాటు మన్నికైన ఫైల్ సింక్కు మద్దతిచ్చే ఫైల్సిస్టమ్ అవసరం. POSIX హోస్ట్లకు డైరెక్టరీ సింక్ కూడా అవసరం; Windowsలో, Node డైరెక్టరీ హ్యాండిల్లను తిరస్కరించవచ్చు, కాబట్టి OmniRoute ప్రచురించిన ఫైల్ను ఫ్లష్ చేసి, డైరెక్టరీ-ఎంట్రీ సింక్ను సాధ్యమైనంత ఉత్తమ ప్రయత్నంగా పరిగణిస్తుంది. మౌంట్ చేసిన DATA_DIR ఆ హామీలను అందించలేకపోతే, మైగ్రేషన్ను వర్తింపజేయడానికి ముందే స్టార్టప్ సురక్షితంగా విఫలమవుతుంది. DATA_DIRను ఆ ప్రిమిటివ్లకు మద్దతిచ్చే వాల్యూమ్కు తరలించండి; మైగ్రేషన్ భద్రతను దాటవేయడానికి DISABLE_SQLITE_AUTO_BACKUPను ఉపయోగించవద్దు.

సందర్భాలు

సందర్భం	కాన్ఫిగరేషన్
స్థానిక అభివృద్ధి	అన్ని డిఫాల్ట్లను అలాగే ఉంచండి. DB ~/.omniroute/omniroute.db వద్ద ఉంటుంది.
Docker	DATA_DIR=/data + /data వద్ద ఒక వాల్యూమ్ను మౌంట్ చేయండి.
నిల్వలో ఎన్క్రిప్ట్ చేయబడినది	STORAGE_ENCRYPTION_KEYను సెట్ చేయండి + కీ బ్యాకప్లను భద్రంగా ఉంచండి! దాన్ని కోల్పోవడం = డేటాను కోల్పోవడం.
CI/పరీక్ష	DATA_DIR=/tmp/omniroute-test — తాత్కాలికమైనది, ఎన్క్రిప్షన్ అవసరం లేదు.

---

3. నెట్వర్క్ & పోర్ట్లు

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
PORT	20128	src/lib/runtime/ports.ts	Dashboard UI మరియు API ఎండ్పాయింట్లు రెండింటికీ ప్రాథమిక పోర్ట్ (సింగిల్-పోర్ట్ మోడ్).
OMNIROUTE_BASE_PATH	(ఖాళీ = రూట్)	next.config.mjs, scripts/docker/ensure-docker-base-path.mjs	రివర్స్ ప్రాక్సీ వెనుక OmniRouteను అందించడానికి URL ఉపమార్గం (Next.js basePathను సెట్ చేస్తుంది; auth రీడైరెక్ట్లు basePathను పరిగణనలోకి తీసుకుంటాయి). ఉదా. /omniroute. Dockerలో ఈ విలువ docker build సమయంలో పొందుపరచబడుతుంది (ARG OMNIROUTE_BASE_PATH); ముందే బిల్డ్ చేసిన రూట్ ఇమేజ్లు Next.js ప్రారంభమయ్యే ముందు కంటైనర్ ప్రారంభ సమయంలో ఒక్కసారి వేరే రన్టైమ్ విలువను వర్తింపజేయగలవు. అదే ఉపమార్గంతో కూడిన పబ్లిక్ ఆరిజిన్కు NEXT_PUBLIC_BASE_URLను సెట్ చేయండి.
NEXT_PUBLIC_OMNIROUTE_BASE_PATH	(ఖాళీ = రూట్)	src/shared/hooks/useDisplayBaseUrl.ts	OMNIROUTE_BASE_PATH యొక్క బ్రౌజర్కు కనిపించే ప్రతిరూపం; బిల్డ్ సమయంలో ఇన్లైన్ చేయబడుతుంది, తద్వారా డ్యాష్బోర్డ్ ఎండ్పాయింట్ ప్రదర్శనలో https://host/v1కు బదులుగా https://host/omniroute/v1 కనిపిస్తుంది. సెట్ చేయకపోతే OMNIROUTE_BASE_PATHను ఉపయోగిస్తుంది. మార్చిన తర్వాత మళ్లీ బిల్డ్ చేయండి (Next basePath అనేది బిల్డ్-టైమ్ విలువ).
DASHBOARD_ALLOW_EMBED	(సెట్ చేయలేదు = ఫ్రేమ్లో ఎప్పటికీ చూపలేరు)	next.config.mjs, scripts/build/dashboardEmbed.mjs	HTML పేజీలను iframeలో పొందుపరచడాన్ని ఎంపిక ద్వారా ప్రారంభిస్తుంది. సెట్ చేయకపోతే, ప్రతి రూట్ frame-ancestors 'none' + X-Frame-Options: DENYతో పంపబడుతుంది. VS Code Simple Browser వాటిని రెండర్ చేయగలిగేలా (OmniCopilot యొక్క dashboardOpen: "editor" మోడ్), పేజీలను (డ్యాష్బోర్డ్, లాగిన్, డాక్స్, ల్యాండింగ్) frame-ancestors 'self' vscode-webview:తో మరియు X-Frame-Options లేకుండా అందించడానికి vscodeగా సెట్ చేయండి. API ఉపరితలం (/api, /v1, /v1beta, /a2a, /healthz, రూట్-స్థాయి అలియాస్లు) ఏ సందర్భంలోనైనా కఠినమైన హెడర్లను కొనసాగిస్తుంది. vscode మాత్రమే గుర్తించబడుతుంది — 1/true దీన్ని ప్రారంభించవు. బిల్డ్-టైమ్: మార్చిన తర్వాత మళ్లీ బిల్డ్ చేయండి (ఇమేజ్ల కోసం docker build --build-arg DASHBOARD_ALLOW_EMBED=vscode; ముందే బిల్డ్ చేసిన ఇన్స్టాలేషన్పై దీన్ని సెట్ చేయడం వల్ల ఎలాంటి ప్రభావం ఉండదు).
API_PORT	(సెట్ చేయలేదు)	src/lib/runtime/ports.ts	సెట్ చేసినప్పుడు, /v1/* ప్రాక్సీ APIని ఈ ప్రత్యేక పోర్ట్లో అందిస్తుంది.
API_HOST	0.0.0.0	src/lib/runtime/ports.ts	API పోర్ట్ కోసం బైండ్ చిరునామా.
DASHBOARD_PORT	(సెట్ చేయలేదు)	src/lib/runtime/ports.ts	సెట్ చేసినప్పుడు, Dashboard UIని ఈ ప్రత్యేక పోర్ట్లో అందిస్తుంది.
OMNI_MAX_CONCURRENT_CONNECTIONS	0 (నిలిపివేయబడింది)	src/sse/utils/backpressure.ts	ఏకకాలంలో ప్రాసెస్లో ఉన్న చాట్ కనెక్షన్లను పరిమితం చేస్తుంది; పరిమితిని మించిన అభ్యర్థనలకు Retry-Afterతో పాటు 503 లభిస్తుంది. ధన పూర్ణాంకం రక్షణను ప్రారంభిస్తుంది; సెట్ చేయకపోతే/0గా ఉంటే దాన్ని నిలిపివేస్తుంది.
OMNIROUTE_INSTANCE_ID	(సెట్ చేయలేదు)	src/shared/resilience/peerRouting.ts	OmniRoute ఇన్స్టాన్స్లను చైన్ చేసేటప్పుడు ఈ గేట్వే కోసం స్థిరమైన, ప్రత్యేక ID. ఇన్బౌండ్ పీర్-లూప్ తనిఖీలను ప్రారంభిస్తుంది. అనుమతించబడిన అక్షరాలు: అక్షరాలు, అంకెలు, ., _, :, మరియు -; గరిష్ఠంగా 64 అక్షరాలు.
OMNIROUTE_PEER_URLS	(సెట్ చేయబడలేదు)	src/shared/resilience/peerRouting.ts, open-sse/executors/base.ts	X-OmniRoute-Peer-Traceను స్వీకరించగల కామాతో వేరు చేసిన OmniRoute బేస్ URLలు. స్పష్టంగా అనుమతి జాబితాలో చేర్చిన అప్స్ట్రీమ్ URLలు మాత్రమే పీర్ మెటాడేటాను స్వీకరిస్తాయి; ఇతర ప్రొవైడర్లన్నీ ప్రభావితం కావు.
OMNIROUTE_PEER_MAX_HOPS	4	src/shared/resilience/peerRouting.ts	చైన్ చేయబడిన అభ్యర్థనలో ఆమోదించబడే, గతంలో సందర్శించిన OmniRoute ఇన్స్టాన్స్ల గరిష్ఠ సంఖ్య (1-32). పునరావృతమైన ఇన్స్టాన్స్లు లేదా పూర్తిగా వినియోగించబడిన బడ్జెట్ HTTP 508 Loop Detectedను తిరిగి ఇస్తాయి.
PROD_DASHBOARD_PORT	20130	docker-compose.prod.yml	Docker ప్రొడక్షన్ మోడ్లో Dashboard కోసం హోస్ట్ వైపు ప్రచురించబడే పోర్ట్.
PROD_API_PORT	20131	docker-compose.prod.yml	Docker ప్రొడక్షన్ మోడ్లో API కోసం హోస్ట్ వైపు ప్రచురించబడే పోర్ట్.
OMNIROUTE_PORT	(సెట్ చేయబడలేదు)	src/lib/runtime/ports.ts	Electron లేదా ఇతర ర్యాపర్లలో అమలు చేస్తున్నప్పుడు PORT కంటే దీనికే ప్రాధాన్యం ఉంటుంది.
LIVE_WS_PORT	20129	src/server/ws/liveServer.ts	రియల్-టైమ్ WebSocket లైవ్ మానిటరింగ్ సర్వర్ కోసం పోర్ట్.
LIVE_WS_HOST	127.0.0.1	src/server/ws/liveServer.ts	లైవ్ WebSocket సర్వర్ కోసం బైండ్ చిరునామా. LANలో బహిర్గతం చేయడానికి దీన్ని 0.0.0.0గా సెట్ చేయండి (LIVE_WS_ALLOWED_ORIGINSను కూడా కాన్ఫిగర్ చేయండి).
LIVE_WS_ALLOWED_ORIGINS	(సెట్ చేయబడలేదు)	src/server/ws/liveServer.ts	లైవ్ WebSocketను తెరవడానికి అనుమతించబడే, కామాతో వేరు చేసిన అదనపు ఆరిజిన్లు. లూప్బ్యాక్ డ్యాష్బోర్డ్ ఆరిజిన్లకు ఇప్పటికే డిఫాల్ట్గా అనుమతి ఉంది.
LIVE_WS_ALLOWED_HOSTS	(సెట్ చేయబడలేదు)	src/server/ws/liveServerAllowList.ts	లైవ్ WebSocket ఆరిజిన్ల కోసం అనుమతించబడే, కామాతో వేరు చేసిన అదనపు హోస్ట్నేమ్లు. LIVE_WS_ALLOWED_ORIGINS (పూర్తి ఆరిజిన్ URLలు)కు భిన్నంగా, ఇది హోస్ట్ భాగాన్ని మాత్రమే సరిపోల్చుతుంది — LAN/Tailscale సెటప్లకు ఉపయోగకరం.
NEXT_PUBLIC_LIVE_WS_PUBLIC_URL	(సెట్ చేయబడలేదు)	src/hooks/useLiveDashboard.ts	లైవ్ డ్యాష్బోర్డ్ WebSocket కోసం పబ్లిక్ URL (బ్రౌజర్ వైపు). WS సర్వర్ ముందు రివర్స్ ప్రాక్సీ లేదా Cloudflare Tunnelను ఉపయోగిస్తున్నప్పుడు దీన్ని సెట్ చేయండి (ఉదా. wss://ws.my-ai.com/live-ws); అప్పుడు బ్రౌజర్ ws://hostname:20132కు బదులుగా అక్కడికి కనెక్ట్ అవుతుంది. పాత్నేమ్ భాగం WebSocket అప్గ్రేడ్ పాత్గా కూడా ఉపయోగించబడుతుంది (డిఫాల్ట్: /live-ws).
OMNIROUTE_ENABLE_LIVE_WS	true	src/server/ws/liveServer.ts మరియు scripts/start-ws-server.mjs	రియల్-టైమ్ WebSocket సర్వర్ను నిలిపివేయడానికి 0 లేదా falseగా సెట్ చేయండి (డిఫాల్ట్గా ప్రారంభించబడి, లూప్బ్యాక్కు బైండ్ చేయబడుతుంది). స్వతంత్ర లైవ్ WebSocket సహాయక స్క్రిప్ట్ను నిలిపివేసే CI/హార్నెస్ టాగుల్.
RELAY_IP_PER_MINUTE	30	src/app/api/v1/relay/chat/completions/route.ts	ప్రతి (టోకెన్, IP)కు రిలే రేట్ పరిమితి, అభ్యర్థనలు/నిమిషం. ఇన్-మెమరీ, ప్రతి ఇన్స్టాన్స్కు. 0 లేదా ప్రతికూల విలువ IP-డైమెన్షన్ గేట్ను నిలిపివేస్తుంది (ప్రతి-టోకెన్ DB పరిమితి ఇప్పటికీ వర్తిస్తుంది).
NODE_ENV	production	Next.js కోర్	లాగింగ్ వివరస్థాయి, క్యాషింగ్, ఎర్రర్ వివరాల బహిర్గతం మరియు Next.js ఆప్టిమైజేషన్లను నియంత్రిస్తుంది.
OMNIROUTE_USE_TURBOPACK	1 (Turbopack — కోడ్ డిఫాల్ట్)	package.json / Next.js 16	npm run dev మరియు npm run build కోసం Turbopack డిఫాల్ట్ బండ్లర్ (బెంచ్మార్క్ ప్రకారం 2-3× వేగవంతమైన బిల్డ్లు). Windowsలో నేటివ్ బైండింగ్ / బండ్లర్-అనుకూలత సమస్యలు ఎదురైనప్పుడు, లేదా RAM పరిమితంగా ఉన్న మెషీన్లలో, webpackకు తిరిగి మారడానికి దీన్ని 0కు సెట్ చేయండి — ఈ Next.js వెర్షన్ శ్రేణి (16.2.x)లోని Turbopack ప్రొడక్షన్ బిల్డ్లు, పెద్ద మాడ్యూల్ గ్రాఫ్లపై webpack కంటే చాలా ఎక్కువ మెమరీ గరిష్ఠ స్థాయిని చేరుకుంటాయని upstreamలో తెలిసిన సమస్య ఉంది (Next 16.3లోని Turbopack మెమరీ-ఎవిక్షన్ పరిష్కారం ఇంకా స్థిరంగా లేదు); webpack ఫాల్బ్యాక్లో గరిష్ఠ మెమరీ వినియోగం చాలా తక్కువగా ఉంటుంది. #6409 చూడండి.
OMNIROUTE_SKIP_DB_HEALTHCHECK	(సెట్ చేయలేదు)	src/lib/db/core.ts / src/lib/db/healthCheck.ts	స్టార్టప్ సమయంలో SQLite సమగ్రత ఆరోగ్య తనిఖీని దాటవేయడానికి 1కు సెట్ చేయండి. పెద్ద డేటాబేస్లలో వేగవంతమైన బూట్కు ఉపయోగకరం.
NOTIFY_SOCKET	(సెట్ చేయలేదు)	systemd (sd_notify ప్రోటోకాల్)	ప్రాసెస్ sd_notify ఇంటిగ్రేషన్ ఉన్న సర్వీస్ యూనిట్ కింద నడుస్తున్నప్పుడు systemd ద్వారా సెట్ చేయబడుతుంది; READY/WATCHDOG నోటిఫికేషన్లను పంపడానికి OmniRoute దీన్ని చదువుతుంది (OMNIROUTE_DISABLE_SD_NOTIFY చూడండి). వినియోగదారు దీన్ని ఎప్పుడూ సెట్ చేయకూడదు.
OMNIROUTE_DISABLE_SD_NOTIFY	(సెట్ చేయలేదు)	scripts/dev/systemd-notify.mjs	systemd యూనిట్ కింద నడుస్తున్నప్పటికీ systemd sd_notifyని (Type=notify / WatchdogSec=) నిలిపివేయడానికి 1కు సెట్ చేయండి. systemd వెలుపల నోటిఫయర్ ఏ చర్యా చేయదు.
CREDENTIAL_HEALTH_CHECK_INTERVAL	300000	open-sse/config/constants.ts / src/lib/credentialHealth/scheduler.ts	బ్యాక్గ్రౌండ్ క్రెడెన్షియల్ ఆరోగ్య తనిఖీ షెడ్యూలర్ కోసం విరామం (ms). కనిష్ఠం: 10000 (10s).
CREDENTIAL_HEALTH_CACHE_TTL	300000	open-sse/config/constants.ts / src/lib/credentialHealth/cache.ts	క్యాష్ చేసిన క్రెడెన్షియల్ ఆరోగ్య స్థితికి TTL (ms).
OMNIROUTE_DISABLE_CREDENTIAL_HEALTH_CHECK	false	src/lib/credentialHealth/scheduler.ts	ప్రొవైడర్ కనెక్షన్ల బ్యాక్గ్రౌండ్ ఆవర్తన పరీక్షను నిలిపివేయడానికి 1 లేదా trueకు సెట్ చేయండి. శోధన ప్రొవైడర్లు (src/lib/providers/validation/searchProviders.tsలోని SEARCH_VALIDATOR_CONFIGS, ఉదా. tavily-search) ఈ స్వీప్ నుండి ఎల్లప్పుడూ మినహాయించబడతాయి — వాటి "ధ్రువీకరణ" అనేది వాస్తవంగా బిల్లు విధించబడే upstream క్వెరీ, కాబట్టి టైమర్పై వాటి ఆరోగ్య తనిఖీ ఎప్పుడూ జరగదు (#9970).
HOST	0.0.0.0	scripts/dev/run-next.mjs	Next.js dev/start సర్వర్ కోసం బైండ్ చిరునామా. సెట్ చేసినప్పుడు డిఫాల్ట్ 0.0.0.0ను భర్తీ చేస్తుంది.
HOSTNAME	127.0.0.1	scripts/dev/run-next-playwright.mjs	Next.jsను ప్రారంభించేటప్పుడు Playwright రన్నర్ ఉపయోగించే బైండ్ చిరునామా. హెర్మెటిక్ పరీక్షల కోసం డిఫాల్ట్గా 127.0.0.1 ఉంటుంది. omniroute serve కోసం ఉపయోగించవద్దు — బదులుగా OMNIROUTE_SERVER_HOST ఉపయోగించండి (POSIX షెల్లు HOSTNAMEను మెషీన్ పేరుకు స్వయంచాలకంగా సెట్ చేస్తాయి; .env దాన్ని భర్తీ చేయలేదు).
OMNIROUTE_SERVER_HOST	0.0.0.0	bin/cli/commands/serve.mjs	omniroute serve కోసం బైండ్ చిరునామా. POSIX షెల్ HOSTNAME వేరియబుల్తో ఘర్షణను నివారిస్తుంది (bash/zsh ఎల్లప్పుడూ దీన్ని మెషీన్ పేరుకు సెట్ చేస్తాయి). సెట్ చేయనప్పుడు 0.0.0.0కు ఫాల్బ్యాక్ అవుతుంది. (#6194)

పోర్ట్ మోడ్లు

┌─────────────────────────── ఒకే పోర్ట్ (డిఫాల్ట్) ──────────────────────────┐
│  PORT=20128                                                                 │
│  → డ్యాష్బోర్డ్: http://localhost:20128                                    │
│  → API:         http://localhost:20128/v1/chat/completions                  │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────── వేర్వేరు పోర్ట్లు ──────────────────────────────┐
│  DASHBOARD_PORT=20128                                                       │
│  API_PORT=20129                                                             │
│  API_HOST=0.0.0.0                                                           │
│  → డ్యాష్బోర్డ్: http://localhost:20128                                    │
│  → API:         http://0.0.0.0:20129/v1/chat/completions                   │
│  వినియోగ సందర్భం: డ్యాష్బోర్డ్ను localhostకే పరిమితం చేస్తూ APIని LANకు అందుబాటులో ఉంచడం. │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────── Docker ప్రొడక్షన్ ──────────────────────────────┐
│  PROD_DASHBOARD_PORT=443   PROD_API_PORT=8443                              │
│  → docker-compose.prod.ymlలోని కంటైనర్ పోర్ట్లను హోస్ట్ పోర్ట్లకు మ్యాప్ చేస్తుంది. │
└─────────────────────────────────────────────────────────────────────────────┘

---

4. భద్రత & ప్రమాణీకరణ

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
MACHINE_ID_SALT	endpoint-proxy-salt	src/lib/auth	మెషీన్ ఫింగర్ప్రింటింగ్ కోసం హార్డ్వేర్ ఐడెంటిఫయర్లతో కలిపే సాల్ట్. వేర్పాటు కోసం ప్రతి డిప్లాయ్మెంట్కు దీన్ని మార్చండి.
OMNIROUTE_CLI_SALT	(సెట్ చేయకపోతే = ప్రతి ఇన్స్టాలేషన్కు యాదృచ్ఛిక సాల్ట్, <DATA_DIR>/cli-token-salt.json వద్ద భద్రపరచబడుతుంది)	src/lib/machineToken.ts	స్థానిక CLI ప్రమాణీకరణ టోకెన్ను ఉత్పన్నం చేయడానికి ఉపయోగించే HMAC సాల్ట్. ఈ విలువను సెట్ చేయడం వల్ల మెషీన్లోని అన్ని CLI టోకెన్లు రొటేట్ అవుతాయి మరియు భద్రపరచిన సాల్ట్ కంటే దీనికే ఎల్లప్పుడూ ప్రాధాన్యం ఉంటుంది. docs/security/CLI_TOKEN.md చూడండి.
AUTH_COOKIE_SECURE	false	src/lib/auth	సెషన్ కుకీలపై Secure ఫ్లాగ్ను సెట్ చేస్తుంది. HTTPS వెనుక నడుస్తున్నప్పుడు ఇది తప్పనిసరిగా true అయి ఉండాలి.
REQUIRE_API_KEY	false	API మిడిల్వేర్	true అయినప్పుడు, అన్ని /v1/* ప్రాక్సీ అభ్యర్థనలు తప్పనిసరిగా చెల్లుబాటు అయ్యే API కీని కలిగి ఉండాలి.
ALLOW_API_KEY_REVEAL	false	src/shared/constants/featureFlagDefinitions.ts	Dashboard UIలో పూర్తి API కీ విలువలను చూపించడానికి అనుమతిస్తుంది. Dashboard Feature Flags నుంచి కాన్ఫిగర్ చేయవచ్చు; భాగస్వామ్య ఇన్స్టాన్స్లలో ఇది భద్రతా ప్రమాదం.
NO_LOG_API_KEY_IDS	(ఖాళీ)	src/lib/compliance/index.ts	అభ్యర్థన లాగింగ్ను దాటవేసే, కామాలతో వేరు చేసిన API కీ IDలు (GDPR అనుగుణ్యత).
DEFAULT_RATE_LIMIT_PER_DAY	(సెట్ చేయకపోతే = అపరిమితం)	src/shared/utils/apiKeyPolicy.ts	rate_limits కాలమ్ nullగా ఉన్న API కీలకు వర్తించే రోజువారీ ఫాల్బ్యాక్ అభ్యర్థన బడ్జెట్. సెట్ చేయకపోయినా లేదా ఖాళీగా ఉన్నా: అంతర్లీన పరిమితి ఉండదు (#2289, #11017). 0 కూడా ఇదే (అపరిమితం). ధన పూర్ణాంకం N అనేది N/రోజు, 5N/వారం, 20N/నెలను ప్రారంభిస్తుంది. తప్పుగా రూపొందించిన, ఖాళీ కాని విలువలు పాత 1000/రోజు, 5000/వారం, 20000/నెల విండోలకు ఫాల్బ్యాక్ అవుతాయి.
MAX_BODY_SIZE_BYTES	10485760 (10 MB)	src/shared/middleware/bodySizeGuard.ts	అనుమతించబడే గరిష్ఠ అభ్యర్థన బాడీ పరిమాణం. ఈ పరిమితిని మించిన పేలోడ్లను తిరస్కరిస్తుంది.
OMNIROUTE_CHAT_LARGE_BODY_BYTES	262144 (256 KB)	src/shared/middleware/chatBodyAdmission.ts	ఈ థ్రెషోల్డ్ వద్ద లేదా దానికంటే ఎక్కువగా ఉన్న వాస్తవ అభ్యర్థన బాడీలు JSON పార్సింగ్కు ముందు అటామిక్ ప్రాసెస్-లోకల్ హెవీవెయిట్ అడ్మిషన్ లీజ్ను తీసుకుంటాయి (POST /v1/responsesతో సహా BYTE మార్గం). స్ట్రక్చర్-హెవీ మార్గంలో ఉన్న అదే #10437 ఆరోగ్యకరమైన హెడ్రూమ్ ఎస్కేప్ను ఉపయోగిస్తుంది; అయినప్పటికీ OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110 ద్వారా పరిమితం చేయబడుతుంది, తద్వారా #7849 మళ్లీ సంభవించదు.
OMNIROUTE_CHAT_HARD_MAX_BODY_BYTES	52428800 (50 MB)	src/shared/middleware/chatBodyAdmission.ts	Content-Length లేని, చెల్లని లేదా అసత్యమైన అభ్యర్థనలతో సహా, పరిమిత ఇంజెషన్ సమయంలో చదివిన బైట్లపై అమలు చేసే చాట్-రూట్ కఠిన పరిమితి; పరిమితిని మించిన వాటికి 413 అందుతుంది.
OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT	(సెట్ చేయబడలేదు — అభ్యర్థనల సంఖ్యపై పరిమితి లేదు)	src/shared/middleware/chatBodyAdmission.ts	#503-fanout: ఈ పాత అభ్యర్థన-సంఖ్య పరిమితి ఇప్పుడు స్పష్టంగా సెట్ చేసినప్పుడు మాత్రమే వర్తిస్తుంది. దీన్ని సెట్ చేయకుండా ఉంచితే (డిఫాల్ట్), హెవీవెయిట్ చాట్ ప్రవేశం బదులుగా OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES ద్వారా నియంత్రించబడుతుంది — ఇది ఒక ప్రాసెస్లో (ఒక V8 హీప్) ప్రాసెస్ యొక్క వాస్తవ మెమరీ గరిష్ఠ పరిమితి ఆధారంగా స్వయంచాలకంగా నిర్ణయించబడే BYTE బడ్జెట్. ఒకదానితో మరొకటి అతివ్యాప్తి చెందే ~750k-token /v1/responses అభ్యర్థనలు రెండు ~12 Gi హీప్లను అబార్ట్ చేస్తాయి (#7849) — ఇది మెమరీ-బడ్జెట్ హెచ్చరిక, ఉత్పత్తికి 2 అనే కఠిన గరిష్ఠ పరిమితి కాదు. ఆరోగ్యకరమైన ప్రాసెస్ (షెడ్ నిష్పత్తి కంటే తక్కువ హీప్) OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM ద్వారా మరిన్ని సమకాలీన దీర్ఘ /v1/responses అభ్యర్థనలను అనుమతించవచ్చు. పదుల సంఖ్యలో దీర్ఘ SSE క్లయింట్లు (40–50) అనేది హీప్ + OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES / #10110 అంశం, “గరిష్ఠం 2” కాదు. “హోస్ట్ను ఉపయోగించుకోవడానికి” దీన్ని గుడ్డిగా పెంచడం #7849ను మళ్లీ ప్రవేశపెడుతుంది. N స్వతంత్ర DATA_DIRలతో హీప్లను గుణించండి (#11024); ఒకే SQLite ఫైల్పై ఎప్పుడూ replicas>1 ఉపయోగించవద్దు.
OMNIROUTE_CHAT_MAX_INFLIGHT_BYTES	(స్వయంచాలకంగా నిర్ణయించబడుతుంది)	src/shared/middleware/admissionBudget.ts	#503-fanout: స్వయంచాలకంగా నిర్ణయించబడే ఇన్జెస్ట్ బైట్ బడ్జెట్కు ఓవర్రైడ్ (మరింత కట్టుదిట్టమైన V8/cgroup మెమరీ గరిష్ఠ పరిమితిలో 25%ను 8x తాత్కాలిక విస్తరణతో భాగించడం ద్వారా). నిర్ణయించబడిన మరియు స్పష్టంగా పేర్కొన్న విలువలు 8 MiB–2 GiB పరిధికి పరిమితం చేయబడతాయి. ప్రభావవంతమైన బడ్జెట్ కంటే పెద్ద బాడీ వెంటనే 413 body_exceeds_budgetతో విఫలమవుతుంది; విడివిడిగా సేవ చేయగల బాడీల మధ్య పోటీ మాత్రం మళ్లీ ప్రయత్నించగల 503గానే ఉంటుంది. 40–50 సమకాలీన దీర్ఘ SSE క్లయింట్లు అనేది ఈ బడ్జెట్ + హీప్ అంశం, కఠినమైన “గరిష్ఠం 2” కాదు. ట్యూన్ చేయడానికి ముందు /api/monitoring/health వద్ద chatAdmission.maxInflightBytes / budgetSource / pressureSeverity చదవండి.
OMNIROUTE_CHAT_ADMISSION_HEAP_SHED_RATIO	0.75	src/shared/middleware/chatBodyAdmission.ts	BYTE మరియు STRUCTURE హెవీవెయిట్ ప్రవేశానికి (#10183, #10268, #10437) హీప్-పీడన షెడ్ నిష్పత్తి (heapUsed / heap_size_limit). OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHTను దాటిన సమకాలీన హెవీవెయిట్ అభ్యర్థన, హీప్ కూడా ఈ నిష్పత్తి వద్ద లేదా దానికంటే ఎక్కువగా ఉన్నప్పుడు మాత్రమే మళ్లీ ప్రయత్నించగల 503తో షెడ్ చేయబడుతుంది; ఆరోగ్యకరమైన హీప్లో అది బదులుగా హెల్తీ-హెడ్రూమ్ ద్వారా అనుమతించబడుతుంది.
OMNIROUTE_CHAT_ADMISSION_HEALTHY_HEADROOM	OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT (డిఫాల్ట్ 1)	src/shared/middleware/chatBodyAdmission.ts	STRUCTURE మరియు BYTE రెండింటిపై (admitChatRequest, OMNIROUTE_CHAT_LARGE_BODY_BYTES కంటే ఎక్కువ లేదా సమానమైన బాడీలతో సహా) ఆరోగ్యకరమైన-హీప్ ఫాస్ట్ పాత్ (#10437) కోసం పరిమిత అదనపు సామర్థ్యం. ఈ పరిమితి లేకపోతే, బిజీగా ఉన్నప్పటికీ ఆరోగ్యకరమైన హీప్ కలిగిన ప్రతి అభ్యర్థన ఎటువంటి గరిష్ఠ పరిమితి లేకుండా ప్రవేశ నియంత్రణను దాటవేసేది. ఆరోగ్యకరమైన-హీప్ పాత్ ద్వారా ఇన్ని సమకాలీన లీజ్లు సక్రియమైన తర్వాత, తదుపరి బిజీ అభ్యర్థనలు వాస్తవ హీప్ పీడనంలో ఉపయోగించే అదే పరిమిత-నిరీక్షణ/షెడ్ పాత్కు వెళ్తాయి. 0 బైపాస్ను పూర్తిగా నిలిపివేస్తుంది.
OMNIROUTE_CHAT_HEAVY_MESSAGE_COUNT	200	src/shared/middleware/chatBodyAdmission.ts	చాట్ అభ్యర్థన బాడీ బైట్ పరిమితి కంటే తక్కువగా ఉన్నప్పటికీ దాన్ని హెవీవెయిట్గా వర్గీకరించే సందేశాల సంఖ్య.
OMNIROUTE_CHAT_HEAVY_TOOL_COUNT	64	src/shared/middleware/chatBodyAdmission.ts	చాట్ అభ్యర్థన బాడీ బైట్ పరిమితి కంటే తక్కువగా ఉన్నప్పటికీ దాన్ని హెవీవెయిట్గా వర్గీకరించే సాధనాల సంఖ్య.
OMNIROUTE_CHAT_HEAVY_ESTIMATED_TOKENS	32000	src/shared/middleware/chatBodyAdmission.ts	అభ్యర్థనను హెవీవెయిట్గా వర్గీకరించే సాంప్రదాయిక స్ట్రింగ్-పరిమాణ టోకెన్ అంచనా; ఇది ప్రవేశ-వ్యయానికి ప్రాక్సీ మాత్రమే, ప్రొవైడర్ బిల్లింగ్ టోకనైజేషన్ కాదు.
OMNIROUTE_CHAT_HARD_MAX_MESSAGES	0 (నిలిపివేయబడింది)	src/shared/middleware/chatBodyAdmission.ts	ఐచ్ఛికంగా ప్రారంభించగల చాట్ చరిత్ర పరిమితి. డిఫాల్ట్గా నిలిపివేయబడింది: సందేశాల సంఖ్య అనేది డిప్లాయ్మెంట్ విధానం, అభ్యర్థన యొక్క సార్వత్రిక లక్షణం కాదు; ఇక్కడ పరిమితం చేయడం వల్ల కంప్రెషన్ పైప్లైన్ వాటిని సేవ చేయగలిగేలా మార్చకముందే సంభాషణలు తుది 413తో తిరస్కరించబడతాయి. హీప్ పెరుగుదల OMNIROUTE_CHAT_MAX_HEAVY_IN_FLIGHT మరియు హీప్-పీడన షెడ్ ద్వారా పరిమితం చేయబడుతుంది. కఠిన గరిష్ఠ పరిమితి అవసరమయ్యే మెమరీ-పరిమిత డిప్లాయ్మెంట్లలో ధనాత్మక విలువను సెట్ చేయండి; అప్పుడు అదనపు అభ్యర్థనలకు నిర్మితమైన compact-required 413 అందుతుంది.
OMNIROUTE_MAX_NONSTREAMING_RESPONSE_BYTES	67108864 (64 MB)	open-sse/handlers/chatCore/nonStreamingResponseBody.ts	మెమరీలో పూర్తిగా బఫర్ చేయబడే నాన్-స్ట్రీమింగ్ అప్స్ట్రీమ్ ప్రతిస్పందనకు కఠిన పరిమితి. దీన్ని దాటితే అప్స్ట్రీమ్ రీడర్ రద్దు చేయబడుతుంది మరియు హీప్ పూర్తిగా అయిపోయే వరకు అపరిమిత స్ట్రింగ్ పెరగనివ్వకుండా అభ్యర్థన వేగంగా విఫలమవుతుంది.
OMNIROUTE_FORWARDING_HEADER_BUDGET_BYTES	768	open-sse/handlers/chatCore/responseHeaders.ts	అప్స్ట్రీమ్ ప్రతిస్పందన హెడర్ల నుంచి ఫార్వర్డ్ చేయబడే గరిష్ఠ వైర్ బైట్లు. బడ్జెట్ మించిపోయినప్పుడు, సాధారణ రివర్స్-ప్రాక్సీ హెడర్ పరిమితుల్లో ఉండటానికి తక్కువ ప్రాధాన్యత గల హెడర్లు (ఉదా., అనుకూల x-codex-*, x-oai-request-id) తొలగించబడతాయి. పెద్ద ప్రతిస్పందన హెడర్ పరిమాణం మూల్యంగా మరింత అప్స్ట్రీమ్ మెటాడేటాను ఫార్వర్డ్ చేయడానికి దీన్ని ఎక్కువగా సెట్ చేయండి.
CORS_ORIGIN	(సెట్ చేయబడలేదు)	src/server/cors/origins.ts	పాత సింగిల్-ఆరిజిన్ CORS అనుమతి జాబితా. కొత్త డిప్లాయ్మెంట్ల కోసం CORS_ALLOWED_ORIGINSను ఉపయోగించడం ఉత్తమం. CORS అనేది క్రాస్-ఆరిజిన్ బ్రౌజర్ API క్లయింట్ల కోసం మాత్రమే; ప్రామాణీకరించిన డ్యాష్బోర్డ్ రైట్లు బదులుగా అదే-ఆరిజిన్ అభ్యర్థనలతో పాటు సెషన్కు అనుసంధానించిన CSRF రక్షణను ఉపయోగిస్తాయి.
CORS_ALLOWED_ORIGINS	(సెట్ చేయబడలేదు)	src/server/cors/origins.ts	కామాలతో వేరు చేసిన CORS అనుమతి జాబితా. CORS_ALLOW_ALL=trueను స్పష్టంగా కాన్ఫిగర్ చేయకపోతే వైల్డ్కార్డ్ పంపబడదు.
CORS_ALLOW_ALL	false	src/server/cors/origins.ts	ఏదైనా బ్రౌజర్ Originను తిరిగి పంపడానికి, డెవలప్మెంట్ కోసం మాత్రమే ఉద్దేశించిన ప్రత్యామ్నాయ మార్గం. షేర్డ్ లేదా ప్రొడక్షన్ డిప్లాయ్మెంట్లలో దీన్ని ప్రారంభించవద్దు.
OUTBOUND_SSRF_GUARD_ENABLED	true	src/shared/network/outboundUrlGuard.ts	ప్రైవేట్/లూప్బ్యాక్/లింక్-లోకల్ IP పరిధులను లక్ష్యంగా చేసుకునే ప్రొవైడర్ కాల్లను నిరోధించండి. ఐసోలేటెడ్ టెస్ట్ ఎన్విరాన్మెంట్లలో మాత్రమే నిలిపివేయండి.
OMNIROUTE_ALLOW_PRIVATE_PROVIDER_URLS	false	src/shared/network/outboundUrlGuard.ts	ప్రైవేట్/లోకల్ నెట్వర్క్లను (localhost, 192.168.x.x, 10.x.x.x మొదలైనవి) సూచించే ప్రొవైడర్ URLలను అనుమతించండి. స్వయంగా హోస్ట్ చేసిన ప్రొవైడర్లకు అవసరం (LM Studio, Ollama, vLLM, Llamafile, Triton, SearXNG). falseగా ఉన్నప్పుడు, డ్యాష్బోర్డ్ లోకల్ URLల ధృవీకరణను తిరస్కరిస్తుంది.
OMNIROUTE_ALLOW_LOCAL_PROVIDER_URLS	true	src/shared/network/outboundUrlGuard.ts	లోకల్/ప్రైవేట్ చిరునామాలపై (127.0.0.1, localhost, LAN, ప్రైవేట్ పరిధులు) ప్రొవైడర్లను జోడించడం/ధృవీకరించడం అనుమతించండి — ఇది ప్రొవైడర్ ధృవీకరణ మార్గానికి మాత్రమే పరిమితం. డిఫాల్ట్ true (లోకల్-ఫస్ట్); పబ్లిక్ చిరునామాలను మాత్రమే అనుమతించే కఠినమైన నిరోధాన్ని అమలు చేయడానికి falseగా సెట్ చేయండి. క్లౌడ్-మెటాడేటా ఎండ్పాయింట్లు (169.254.169.254, metadata.google.internal) దీనితో సంబంధం లేకుండా నిరోధించబడే ఉంటాయి. (#5066)
AUDIO_REMOTE_PROVIDER_NODES	false	src/app/api/v1/_shared/audioProviderNodes.ts	/v1/audio/* రూట్లు (ట్రాన్స్క్రిప్షన్లు, స్పీచ్, అనువాదాలు) localhost వెలుపల హోస్ట్ చేసిన OpenAI-అనుకూల ప్రొవైడర్ నోడ్ను ఉపయోగించడానికి అనుమతించండి. డిఫాల్ట్గా ఆఫ్లో ఉంటుంది — ఆడియోను రిమోట్ హోస్ట్కు రూట్ చేయడం వల్ల ఎగ్రెస్ గుర్తింపు మారుతుంది, కాబట్టి అది ఆపరేటర్ స్పష్టంగా తీసుకోవాల్సిన నిర్ణయం. లూప్బ్యాక్/ప్రైవేట్ నోడ్లు (localhost, 127.0.0.1, 172.16-31.x) ఎల్లప్పుడూ అనుమతించబడతాయి మరియు ప్రభావితం కావు. (#3963)
OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN	false	src/app/api/auth/login/route.ts	OIDC ప్రారంభించబడినప్పుడు, వినియోగదారులు OIDC సింగిల్ సైన్-ఆన్ ద్వారా మాత్రమే ప్రామాణీకరించగలిగేలా పాస్వర్డ్ లాగిన్ను నిలిపివేయండి. సంక్షిప్త అలియాస్ OIDC_DISABLE_PASSWORD_LOGIN కూడా ఆమోదించబడుతుంది; అదే కీ గల డ్యాష్బోర్డ్ ఫీచర్ ఫ్లాగ్కు ప్రాధాన్యం ఉంటుంది. (#10889)
OIDC_DISABLE_PASSWORD_LOGIN	false	src/app/api/auth/login/route.ts	OMNIROUTE_OIDC_DISABLE_PASSWORD_LOGIN యొక్క సంక్షిప్త అలియాస్ (#10889).

భద్రతా పటిష్ఠీకరణ తనిఖీ జాబితా

# ప్రొడక్షన్కు అవసరమైన కనీస భద్రత:
AUTH_COOKIE_SECURE=true        # HTTPS అవసరం
REQUIRE_API_KEY=true           # అన్ని ప్రాక్సీ కాల్లను ప్రామాణీకరించండి
ALLOW_API_KEY_REVEAL=false     # UIలో కీలను ఎప్పుడూ బహిర్గతం చేయవద్దు
CORS_ALLOWED_ORIGINS=https://your.domain.com
MAX_BODY_SIZE_BYTES=5242880    # 5 MB పరిమితి

---

5. ఇన్పుట్ శుద్ధీకరణ & PII రక్షణ

OmniRoute రెండు-అంచెల రక్షణను అందిస్తుంది: అభ్యర్థన వైపు ఇంజెక్షన్ స్కానింగ్ మరియు ప్రతిస్పందన వైపు PII తొలగింపు.

⚠️ పరిమితులు: ఈ గార్డ్రెయిల్స్ సంపూర్ణ ప్రాంప్ట్-ఇంజెక్షన్ ఫైర్వాల్ లేదా PII DLP వ్యవస్థలు కావు; ఇవి సాధ్యమైనంత ఉత్తమంగా పనిచేసే హ్యూరిస్టిక్ గుర్తింపులు మాత్రమే. ఇవి తప్పుడు పాజిటివ్లను (హానికరం కాని పర్సోనా/RPG ప్రాంప్ట్లు ఫ్లాగ్ చేయబడటం) మరియు తప్పుడు నెగటివ్లను (లీట్స్పీక్, స్పేసింగ్, ఆంగ్లేతర నమూనాలు) ఉత్పత్తి చేయగలవు. అనుగుణత కోసం ఇవి మాత్రమే సరిపోవు. వీటిపై ఆధారపడటానికి ముందు మోడ్లను సర్దుబాటు చేసి, మీ ట్రాఫిక్తో పరీక్షించండి.

అభ్యర్థన వైపు: ప్రాంప్ట్ ఇంజెక్షన్ గార్డ్

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
INPUT_SANITIZER_ENABLED	true	src/middleware/promptInjectionGuard.ts	ప్రాంప్ట్ ఇంజెక్షన్ నమూనాల కోసం ఇన్కమింగ్ సందేశాల స్కానింగ్ను ప్రారంభిస్తుంది.
INPUT_SANITIZER_MODE	warn	src/middleware/promptInjectionGuard.ts	ఇంజెక్షన్ విధానం: warn = లాగ్ మాత్రమే, block = 400తో అభ్యర్థనను తిరస్కరిస్తుంది. లెగసీ redact ఇంజెక్షన్ టెక్స్ట్ను తొలగించదు; అభ్యర్థన PII రీరైట్ కోసం PII_REDACTION_ENABLEDను ఉపయోగించండి.
INJECTION_GUARD_MODE	(సెట్ చేయబడలేదు)	src/middleware/promptInjectionGuard.ts	INPUT_SANITIZER_MODE కోసం లెగసీ అలియాస్ — అదే ప్రవర్తన.
INPUT_SANITIZER_BLOCK_THRESHOLD	high	src/shared/utils/injectionSeverity.ts	MODE=block తిరస్కరించే కనిష్ఠ తీవ్రత: high (డిఫాల్ట్), medium, లేదా low. తగ్గించనంత వరకు మధ్యస్థ నమూనాలు పరిశీలనకు మాత్రమే పరిమితం.
INJECTION_GUARD_BLOCK_THRESHOLD	(సెట్ చేయబడలేదు)	src/shared/utils/injectionSeverity.ts	INPUT_SANITIZER_BLOCK_THRESHOLD కోసం లెగసీ అలియాస్ — అదే ప్రవర్తన.
PII_REDACTION_ENABLED	false	src/lib/guardrails/piiMasker.ts	true అయినప్పుడు, ఇన్కమింగ్ అభ్యర్థనలలోని PIIని సవరించి దాచుతుంది (ఇంజెక్షన్ మోడ్తో సంబంధం లేకుండా).
CREDENTIAL_REDACTION_ENABLED	false	src/lib/guardrails/credentialMasker.ts	అభ్యర్థన/ప్రతిస్పందన పేలోడ్ల నుండి సుపరిచితమైన API-కీ / సీక్రెట్-టోకెన్ నమూనాలను సవరించి దాచుతుంది. ఎంపిక చేసుకుంటే మాత్రమే అమలవుతుంది; PII_REDACTION_ENABLEDను అనుసరిస్తుంది.

ప్రతిస్పందన వైపు: PII శుద్ధీకరణ సాధనం

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
PII_RESPONSE_SANITIZATION	false	src/lib/piiSanitizer.ts	క్లయింట్కు తిరిగి పంపే ముందు లీకైన PII కోసం LLM ప్రతిస్పందనలను స్కాన్ చేస్తుంది.
PII_RESPONSE_SANITIZATION_MODE	redact	src/lib/piiSanitizer.ts	redact = PIIని మాస్క్ చేస్తుంది, warn = లాగ్ మాత్రమే, block = మొత్తం ప్రతిస్పందనను తొలగిస్తుంది.

VS Code టోకనైజ్డ్-రూట్ కాంటెక్స్ట్ శుద్ధీకరణ సాధనం

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_VSCODE_SANITIZE_CONTEXT	1	src/app/api/v1/vscode/contextSanitizer.ts	/v1/vscode/[token]/* అభ్యర్థనల నుండి పరోక్ష యాక్టివ్-ఎడిటర్ కాంటెక్స్ట్ను (editorContext, activeEditor, currentFile, selection, openTabs…) తొలగిస్తుంది మరియు స్పష్టంగా జోడించిన సున్నితమైన ఫైళ్ల కంటెంట్ను సవరించి దాచుతుంది. డిఫాల్ట్గా సురక్షితం; నిలిపివేయడానికి 0గా సెట్ చేయండి.

సందర్భాలు

సందర్భం	కాన్ఫిగరేషన్
ఎంటర్ప్రైజ్ అనుగుణత	INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=block, PII_REDACTION_ENABLED=true, PII_RESPONSE_SANITIZATION=true (ఇంజెక్షన్ నిరోధం + అభ్యర్థన/ప్రతిస్పందన PII సవరణ; మోడ్లు స్వతంత్రంగా ఉంటాయి)
పర్యవేక్షణ మాత్రమే	INPUT_SANITIZER_ENABLED=true, INPUT_SANITIZER_MODE=warn — లాగ్ చేస్తుంది కానీ ఎప్పటికీ నిరోధించదు
వ్యక్తిగత వినియోగం	అన్నింటినీ నిలిపివేసి ఉంచండి — అదనపు ఓవర్హెడ్ ఉండదు

---

6. టూల్ & రూటింగ్ విధానాలు

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
TOOL_POLICY_MODE	disabled	src/lib/toolPolicy.ts	LLM టూల్/ఫంక్షన్-కాలింగ్ యాక్సెస్ను నియంత్రిస్తుంది. allowlist = జాబితాలో ఉన్న టూల్స్ మాత్రమే, denylist = జాబితాలో ఉన్నవి మినహా అన్నీ, disabled = పరిమితులు లేవు.
OMNIROUTE_PAYLOAD_RULES_PATH	./config/payloadRules.json	open-sse/services/payloadRules.ts	పేలోడ్ మానిప్యులేషన్ నియమాల JSON ఫైల్కు పాత్ (ప్రతి-మోడల్/ప్రోటోకాల్ అప్స్ట్రీమ్ సర్దుబాట్లు).
OMNIROUTE_PAYLOAD_RULES_RELOAD_MS	5000	open-sse/services/payloadRules.ts	పేలోడ్ నియమాల ఫైల్ను హాట్-రీలోడ్ చేయడానికి రీలోడ్ విరామం (ms). కనిష్ఠం 1000.
OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS	false	open-sse/services/model.ts	ఎంపిక చేసుకుని ప్రారంభించే సదుపాయం: ప్రొవైడర్ ప్రిఫిక్స్ను తప్పనిసరి చేయడానికి బదులుగా, Claude Code క్లయింట్ల నుండి వచ్చే ప్రిఫిక్స్ లేని claude-* మోడల్ IDలను Claude Code OAuth ఖాతా ద్వారా రూట్ చేస్తుంది. స్పష్టమైన ప్రొవైడర్ ప్రిఫిక్స్లకే ఇప్పటికీ ప్రాధాన్యం ఉంటుంది. Claude ప్రొవైడర్ పేజీలోని డ్యాష్బోర్డ్ టాగుల్ ద్వారా కూడా దీన్ని కాన్ఫిగర్ చేయవచ్చు.
COMBO_CONCURRENCY_PER_MODEL	3	open-sse/services/comboConfig.ts	రౌండ్-రాబిన్ కాంబోల కోసం ప్రతి-మోడల్ కన్కరెన్సీ పరిమితి (#9100). రౌండ్-రాబిన్ కాంబో సెమాఫోర్కు, ఓవర్రైడ్ లేకుండా ప్రతి మోడల్కు 3 సమకాలీన అభ్యర్థనల హార్డ్ క్యాప్ ఉండేది; దీనివల్ల అధిక-కన్కరెన్సీ ట్రాఫిక్ ఆ క్యాప్ వెనుక సీరియలైజ్ అయ్యేది. >= 1గా ధృవీకరించబడి, <= 32కు పరిమితం చేయబడుతుంది.
DISABLE_CONTEXT_WINDOW_CHECKS	false	open-sse/handlers/chatCore.ts	నేరుగా పంపే సింగిల్-మోడల్ అభ్యర్థనల కోసం OmniRoute స్థానిక కాంటెక్స్ట్-విండో / గరిష్ఠ-ఇన్పుట్-టోకెన్ తనిఖీని దాటవేసే ప్రమాదకరమైన ఎంపిక. అప్స్ట్రీమ్ ప్రొవైడర్లు తమ వాస్తవ పరిమితులను ఇప్పటికీ అమలు చేస్తారు; ప్రాంప్ట్ కంప్రెషన్ మరియు మోడల్ స్వంత అవుట్పుట్-టోకెన్ పరిమితి సక్రియంగానే ఉంటాయి. అమలయ్యే ప్రాధాన్యత క్రమం: Feature Flags DB ఓవర్రైడ్ > ఎన్విరాన్మెంట్ వేరియబుల్ > డిఫాల్ట్; రీస్టార్ట్ అవసరం లేదు.
OMNIROUTE_DISABLE_CONVERSATION_TRACKING	(సెట్ చేయలేదు)	open-sse/services/conversationTracker.ts	సంభాషణ చరిత్ర సేకరణను నిలిపివేయడానికి 1గా సెట్ చేయండి. SQLiteను చదవడానికి లేదా సందేశ చరిత్రను పార్స్ చేయడానికి ముందే resolveConversationId() ట్రాక్ చేయని ఫలితాన్ని అందిస్తుంది; క్లయింట్ అందించిన సెషన్ IDలు కూడా దీనికి వర్తిస్తాయి. రూటింగ్-సెషన్ నిర్వహణలో మార్పు ఉండదు మరియు ఇప్పటికే ఉన్న రికార్డులు తొలగించబడవు. డ్యాష్బోర్డ్లోని సంభాషణ వీక్షణను ఉపయోగించని, అలాగే టర్న్ టేబుల్ పెరగడాన్ని నిలిపివేయాలనుకునే డిప్లాయ్మెంట్ల కోసం ఇది ఉద్దేశించబడింది.

---

7. URLs & క్లౌడ్ సమకాలీకరణ

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
BASE_URL	http://localhost:20128	src/lib/cloudSync.ts	అంతర్గత సమకాలీకరణ జాబ్లు /api/sync/cloudను కాల్ చేయడానికి ఉపయోగించే సర్వర్-సైడ్ URL. యాప్ను పబ్లిక్గా ప్రాక్సీ చేసినప్పటికీ, దీన్ని లూప్బ్యాక్/కంటైనర్ URLగానే ఉంచండి.
CLOUD_URL	(ఖాళీ)	src/lib/cloudSync.ts	క్లౌడ్ రిలే ఎండ్పాయింట్ URL (ప్రీమియం ఫీచర్).
CLOUD_SYNC_TIMEOUT_MS	12000	src/lib/cloudSync.ts	క్లౌడ్ సమకాలీకరణ అభ్యర్థనల కోసం HTTP గడువు.
OMNIROUTE_BUILD_PROFILE	full	Webpack బిల్డ్ కాన్ఫిగ్	బిల్డ్-టైమ్ ప్రొఫైల్ (ప్రత్యేకాధికార మాడ్యూల్లను బండిల్ నుండి భౌతికంగా మినహాయించడానికి minimalగా సెట్ చేయండి).
OMNIROUTE_STANDALONE_DIR	.build/ స్వతంత్ర అవుట్పుట్	scripts/build/colocate-standalone.mjs	పోస్ట్-బిల్డ్ కోలొకేషన్ దశ ఉపయోగించే స్వతంత్ర అవుట్పుట్ డైరెక్టరీకి బిల్డ్-టైమ్ ఓవర్రైడ్. ఇది రన్టైమ్ సెట్టింగ్ కాదు.
OMNIROUTE_CLOUD_SYNC_SECRET	(ఖాళీ)	src/lib/cloudSync.ts	క్లౌడ్ సమకాలీకరణ ప్రతిస్పందనల HMAC-SHA256 సంతకాన్ని ధృవీకరించడానికి ఉపయోగించే భాగస్వామ్య రహస్యం.
OMNIROUTE_CLOUD_SYNC_SECRETS	false	src/lib/cloudSync.ts	క్లౌడ్ సమకాలీకరణ ఎండ్పాయింట్ స్థానిక క్రెడెన్షియల్లను ఓవర్రైట్ చేయడానికి అనుమతించాలంటే trueగా సెట్ చేయండి. డిఫాల్ట్ false.
OMNIROUTE_CLOUD_SYNC_ENFORCE_SIGNATURE	false	src/lib/cloudSync.ts	స్థానిక రహస్యం కాన్ఫిగర్ చేయనప్పుడు సంతకం చేయని క్లౌడ్ సమకాలీకరణ ప్రతిస్పందనను తిరస్కరించడానికి trueగా సెట్ చేయండి (#13679). ఈ ఫ్లాగ్తో సంబంధం లేకుండా, ఉన్న సంతకం ఎల్లప్పుడూ ధృవీకరించబడుతుంది — అలాగే OMNIROUTE_CLOUD_SYNC_SECRET సెట్ చేయకపోతే ఎల్లప్పుడూ తిరస్కరించబడుతుంది. v3.9లో డిఫాల్ట్ అమలు చేయబడేలా మారుతుంది.
OMNIROUTE_ZED_IMPORT_LEGACY_ONE_STEP	false	src/app/api/providers/zed/import/route.ts	వినియోగదారు నిర్ధారణ లేకుండా v3.8.5 యొక్క ఒకే-దశ "అన్నింటినీ దిగుమతి చేయి" ప్రవర్తనకు తిరిగి వెళ్లడానికి trueగా సెట్ చేయండి.
NEXT_PUBLIC_BASE_URL	http://localhost:20128	OAuth, డ్యాష్బోర్డ్, సమకాలీకరణ	OAuth redirect_uri, డ్యాష్బోర్డ్ లింక్లు మరియు రూపొందించిన పబ్లిక్ URLs కోసం పబ్లిక్-ఫేసింగ్ URL. OAuth కాల్బ్యాక్లు లేదా రూపొందించిన బ్రౌజర్ లింక్లు ప్రామాణిక రివర్స్-ప్రాక్సీ హోస్ట్ను తప్పనిసరిగా ఉపయోగించాల్సి ఉన్నప్పుడు, దీన్ని స్థిరమైన పబ్లిక్ URLకు సెట్ చేయండి.
NEXT_PUBLIC_CLOUD_URL	(ఖాళీ)	క్లయింట్-సైడ్	CLOUD_URL యొక్క క్లయింట్-సైడ్ ప్రతిరూపం.
NEXT_PUBLIC_APP_URL	(సెట్ చేయబడలేదు)	src/shared/services/cloudSyncScheduler.ts	NEXT_PUBLIC_BASE_URL కోసం లెగసీ ఫాల్బ్యాక్.
OMNIROUTE_PUBLIC_BASE_URL	(సెట్ చేయబడలేదు)	పబ్లిక్-ఆరిజిన్ రిజాల్వర్, ఇమేజ్ URLలు	పబ్లిక్ URL ఉత్పత్తి మరియు డ్యాష్బోర్డ్ కాని బ్రౌజర్-ఆరిజిన్ ధృవీకరణ కోసం ఉపయోగించే, అత్యధిక ప్రాధాన్యత గల బ్రౌజర్-ఫేసింగ్ OmniRoute ఆరిజిన్. OpenWebUI లేదా మరొక రిలే అంతర్గత URL ద్వారా OmniRouteను చేరుకుంటున్నప్పటికీ, వినియోగదారు బ్రౌజర్ రూపొందించిన మీడియాను LAN, టన్నెల్ లేదా పబ్లిక్ ఆరిజిన్ నుంచి పొందాల్సి ఉంటే దీన్ని సెట్ చేయండి. /v1ను చేర్చవద్దు.
OMNIROUTE_PROVIDER_MANIFEST_URL	(సెట్ చేయబడలేదు)	open-sse/config/providerPluginManifestUrl.ts	సైడ్కార్ క్లయింట్లకు ప్రకటించే సంపూర్ణ ప్రొవైడర్ ప్లగిన్ మానిఫెస్ట్ URL. దీన్ని సెట్ చేయనప్పుడు, OmniRoute అభ్యర్థన ఆరిజిన్ లేదా HOST/PORT నుంచి /api/v1/provider-plugin-manifestను ఉత్పన్నం చేస్తుంది.
OMNIROUTE_PUBLIC_PROTOCOL	http	open-sse/config/providerPluginManifestUrl.ts	అభ్యర్థన ఆరిజిన్ లేకుండా HOST/PORT నుంచి ప్రొవైడర్ ప్లగిన్ మానిఫెస్ట్ URLను ఉత్పన్నం చేసేటప్పుడు ఉపయోగించే ప్రోటోకాల్. స్పష్టమైన OMNIROUTE_PROVIDER_MANIFEST_URL సెట్ చేయనప్పుడు, TLSను ముగించే పబ్లిక్ ప్రాక్సీ వెనుక ఉంటే దీన్ని httpsకు సెట్ చేయండి.
OMNIROUTE_TRUST_PROXY	(సెట్ చేయబడలేదు)	src/server/origin/publicOrigin.ts	ఫార్వర్డ్ చేసిన పబ్లిక్-ఆరిజిన్ హెడర్ల కోసం ఐచ్ఛిక విశ్వసనీయత మోడ్. సెట్ చేయనప్పుడు = భద్రతా నిర్ణయాల కోసం Forwarded / X-Forwarded-*ను విశ్వసించవద్దు. true / loopback టోకెన్-స్టాంప్ చేసిన లూప్బ్యాక్ ప్రాక్సీ నుంచి మాత్రమే ఫార్వర్డ్ చేసిన హోస్ట్/ప్రోటోను విశ్వసిస్తుంది. private / lan ప్రైవేట్-LAN ప్రాక్సీ పీర్లను కూడా విశ్వసిస్తుంది. ప్రొడక్షన్లో స్పష్టమైన NEXT_PUBLIC_BASE_URLకు ప్రాధాన్యం ఇవ్వండి.
KIE_CALLBACK_URL	(సెట్ చేయబడలేదు)	open-sse/utils/kieTask.ts	అసమకాలిక kie.ai జాబ్ల కోసం పబ్లిక్ కాల్బ్యాక్ URL. OMNIROUTE_KIE_CALLBACK_URL మరియు OMNIROUTE_PUBLIC_URL కంటే ముందు అత్యధిక ప్రాధాన్యత గల ఓవర్రైడ్.
OMNIROUTE_KIE_CALLBACK_URL	(సెట్ చేయబడలేదు)	open-sse/utils/kieTask.ts	KIE_CALLBACK_URLకు ప్రత్యామ్నాయ స్పెల్లింగ్. ప్రాథమిక వేరియబుల్ సెట్ చేయనప్పుడు దీనికి ఫాల్బ్యాక్ అవుతుంది.
OMNIROUTE_PUBLIC_URL	(సెట్ చేయబడలేదు)	open-sse/utils/kieTask.ts	అసమకాలిక కాల్బ్యాక్ URLలను రూపొందించడానికి ఉపయోగించే పబ్లిక్ ఆరిజిన్. kie.ai కాల్బ్యాక్ల కోసం అత్యల్ప ప్రాధాన్యత గల ఫాల్బ్యాక్; ఇతర రిలేల కోసం సాధారణ పబ్లిక్ URLగా కూడా ఉపయోగించబడుతుంది.
OMNIROUTE_CROF_USAGE_URL	https://crof.ai/usage_api/	open-sse/services/usage.ts	Usage పేజీ ఉపయోగించే CrofAI కోటా లుకప్ ఎండ్పాయింట్. రిలేలు / టెస్ట్ ఫిక్చర్ల కోసం ఓవర్రైడ్ చేయండి.
OMNIROUTE_OPENCODE_QUOTA_URL	https://opencode.ai/zen/go/v1/usage	open-sse/services/opencodeQuotaFetcher.ts	Usage పేజీ ఉపయోగించే అధికారిక API-కీ-ప్రామాణీకృత OpenCode Go వినియోగ ఎండ్పాయింట్. రిలేలు / టెస్ట్ ఫిక్చర్ల కోసం ఓవర్రైడ్ చేయండి.
OPENCODE_SYNTHESIZE_CLI_HEADERS	true	open-sse/executors/opencode.ts	క్లయింట్ పంపని opencode-go/zen అప్స్ట్రీమ్ అభ్యర్థనలపై OpenCode CLI గుర్తింపు హెడర్లను (User-Agent, x-opencode-client/project, అభ్యర్థన/సెషన్ UUIDలు) సృష్టిస్తుంది, తద్వారా VPS ఎగ్రెస్లోని Cloudflare వాటిని అంగీకరిస్తుంది (#6210/#5997). #10571 నుంచి డిఫాల్ట్గా ఆన్లో ఉంటుంది; false/0/no/offతో నిలిపివేయండి.
OPENCODE_USER_AGENT	opencode	open-sse/executors/opencode.ts	OPENCODE_SYNTHESIZE_CLI_HEADERS ఆన్లో ఉండి, ప్రతి ప్రొవైడర్కు ప్రత్యేకమైన <PROVIDER>_USER_AGENT ఓవర్రైడ్ సెట్ చేయనప్పుడు ఉపయోగించే డిఫాల్ట్ User-Agent. opencode ఎగ్జిక్యూటర్లకు మాత్రమే వర్తిస్తుంది.
OPENCODE_CLIENT	desktop	open-sse/executors/opencode.ts	OPENCODE_SYNTHESIZE_CLI_HEADERS ఆన్లో ఉన్నప్పుడు సృష్టించే x-opencode-client హెడర్కు ఉపయోగించే విలువ.
OPENCODE_PROJECT	global	open-sse/executors/opencode.ts	OPENCODE_SYNTHESIZE_CLI_HEADERS ఆన్లో ఉన్నప్పుడు సంశ్లేషిత x-opencode-project హెడర్ కోసం ఉపయోగించే విలువ.
OMNIROUTE_OLLAMA_CLOUD_USAGE_URL	https://ollama.com/settings	open-sse/services/usage.ts	కోటా స్క్రేపింగ్ కోసం ఉపయోగించే Ollama Cloud సెట్టింగ్ల URL. రిలేలు / టెస్ట్ ఫిక్చర్ల కోసం ఓవర్రైడ్ చేయండి.
OLLAMA_USAGE_COOKIE	(సెట్ చేయబడలేదు)	open-sse/services/usage.ts	సెట్టింగ్ల పేజీ కోటా స్క్రేపింగ్ కోసం ఉపయోగించే Ollama Cloud __Secure-session కుకీ. ఇది సున్నితమైనది; అనేక ఖాతాలు కాన్ఫిగర్ చేయబడినప్పుడు ప్రతి కనెక్షన్కు సంబంధించిన Dashboard ఫీల్డ్ను ఉపయోగించడం ఉత్తమం.
OLLAMA_CLOUD_USAGE_COOKIE	(సెట్ చేయబడలేదు)	open-sse/services/usage.ts	ప్రత్యామ్నాయ Ollama Cloud __Secure-session కుకీ env var. ఇది సున్నితమైనది; అనేక ఖాతాలు కాన్ఫిగర్ చేయబడినప్పుడు ప్రతి కనెక్షన్కు సంబంధించిన Dashboard ఫీల్డ్ను ఉపయోగించడం ఉత్తమం.
OMNIROUTE_OLLAMA_USAGE_COOKIE	(సెట్ చేయబడలేదు)	open-sse/services/usage.ts	సంక్షిప్త అలియాస్లకు ముందు ఉపయోగించే ప్రత్యామ్నాయ Ollama Cloud __Secure-session కుకీ env var. ఇది సున్నితమైనది; అనేక ఖాతాలు కాన్ఫిగర్ చేయబడినప్పుడు ప్రతి కనెక్షన్కు సంబంధించిన Dashboard ఫీల్డ్ను ఉపయోగించడం ఉత్తమం.
OMNIROUTE_CODEWHISPERER_BASE_URL	https://codewhisperer.us-east-1.amazonaws.com	open-sse/services/usage.ts	CodeWhisperer (AWS Kiro) వినియోగ పరిమితుల ఎండ్పాయింట్. రిలేలు / టెస్ట్ ఫిక్చర్ల కోసం ఓవర్రైడ్ చేయండి.

Important

రివర్స్ ప్రాక్సీ (nginx, Caddy) వెనుక డిప్లాయ్ చేస్తున్నప్పుడు, OAuth కాల్బ్యాక్లు లేదా జనరేట్ చేసిన పబ్లిక్ లింక్లు ఆ హోస్ట్నేమ్ను ఉపయోగించాల్సి ఉంటే NEXT_PUBLIC_BASE_URLను మీ స్థిరమైన పబ్లిక్ URLకు (ఉదా., https://omniroute.example.com) సెట్ చేయండి. ఇది లేకపోతే, redirect_uri సరిపోలకపోవడం వల్ల OAuth కాల్బ్యాక్లు విఫలం కావచ్చు మరియు జనరేట్ చేసిన పబ్లిక్ లింక్లు అంతర్గత కంటైనర్ మూలాన్ని సూచించవచ్చు.

సర్వర్-టు-సర్వర్ జాబ్ల కోసం BASE_URLను అంతర్గత లూప్బ్యాక్/కంటైనర్ URLగానే ఉంచండి. క్రెడెన్షియల్స్ను కలిగి ఉండే అంతర్గత స్వీయ-ఫెచ్ల కోసం బ్రౌజర్ Origin లేదా పబ్లిక్ హోస్ట్నేమ్ను ఉపయోగించవద్దు.

ప్రామాణీకరించబడిన డ్యాష్బోర్డ్ రైట్లకు స్థిరమైన పబ్లిక్ బేస్ URL అవసరం లేదు: డ్యాష్బోర్డ్, సెషన్కు అనుసంధానమైన CSRF టోకెన్తో అదే-ఆరిజిన్ అసురక్షిత అభ్యర్థనలను పంపుతుంది. డ్యాష్బోర్డ్కు చెందని బ్రౌజర్ ఇంటిగ్రేషన్ల కోసం OmniRoute ఇప్పటికీ పబ్లిక్-ఆరిజిన్ ధ్రువీకరణను కేంద్రీకరిస్తుంది: స్పష్టమైన పబ్లిక్ URL env varలకు ముందుగా విశ్వసనీయత ఇవ్వబడుతుంది; OMNIROUTE_TRUST_PROXY ప్రారంభించబడి, తక్షణ ప్రాక్సీ పీర్ విశ్వసనీయమైనదిగా టోకెన్తో గుర్తించబడితే తప్ప, ముడి Forwarded / X-Forwarded-* హెడర్లు విస్మరించబడతాయి. అదే-ఆరిజిన్ డ్యాష్బోర్డ్ అభ్యర్థనలను పరిష్కరించడానికి CORS సెట్టింగ్లను ఉపయోగించవద్దు; CORS కేవలం క్రాస్-ఆరిజిన్ బ్రౌజర్ క్లయింట్ల కోసం మాత్రమే.

---

8. అవుట్బౌండ్ ప్రాక్సీ

ఎగ్రెస్ నియంత్రణ, జియో-రూటింగ్ లేదా IP మాస్కింగ్ కోసం అప్స్ట్రీమ్ LLM ప్రొవైడర్ కాల్లను HTTP లేదా SOCKS5 ప్రాక్సీ ద్వారా రూట్ చేయండి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
ENABLE_SOCKS5_PROXY	true	open-sse/executors	అప్స్ట్రీమ్ కాల్ల కోసం SOCKS5 ప్రాక్సీ ఏజెంట్ను ప్రారంభిస్తుంది. నిలిపివేయడానికి false ఉపయోగించండి.
NEXT_PUBLIC_ENABLE_SOCKS5_PROXY	true	క్లయింట్-సైడ్	SOCKS5 లభ్యత గురించి క్లయింట్-సైడ్ అవగాహన.
PROXY_SKIP_RECENTLY_FAILED	false	src/shared/utils/featureFlags.ts	ఆప్ట్-ఇన్ ఫీచర్ ఫ్లాగ్ (FEATURE_FLAGS.md చూడండి; డ్యాష్బోర్డ్ DB ఓవర్రైడ్కు ప్రాధాన్యం ఉంటుంది). ఇప్పుడే విఫలమైన మెంబర్ను (తిరస్కరించబడిన TCP ప్రోబ్ లేదా దాని ద్వారా వచ్చిన 429) ప్రాక్సీ పూల్లు మరియు ఒక్కో అకౌంట్ రొటేషన్ మళ్లీ అందించడం ఆపివేస్తాయి; ప్రతి పునరావృతంతో రెట్టింపు అయ్యే, గరిష్ఠ పరిమితి వరకు ఉండే వ్యవధికి ఇది వర్తిస్తుంది. true (లేదా 1, yes) దీన్ని ప్రారంభిస్తుంది.
HTTP_PROXY	(సెట్ చేయలేదు)	Node.js ప్రామాణికం	అప్స్ట్రీమ్ కాల్ల కోసం HTTP ప్రాక్సీ.
HTTPS_PROXY	(సెట్ చేయలేదు)	Node.js ప్రామాణికం	అప్స్ట్రీమ్ కాల్ల కోసం HTTPS ప్రాక్సీ.
ALL_PROXY	(సెట్ చేయలేదు)	Node.js ప్రామాణికం	యూనివర్సల్ ప్రాక్సీ (socks5://కు మద్దతు ఇస్తుంది).
OMNIROUTE_PROXY_ECHO_URL	(సెట్ చేయలేదు)	src/lib/proxyEchoTarget.ts	ప్రాక్సీ ఎగ్రెస్ ప్రోబ్లు ఉపయోగించే ఎకో-IP టార్గెట్ను ఒకే URLకు పిన్ చేస్తుంది. సెట్ చేయకపోతే, ప్రోబ్ మొదట api64.ipify.org, ఆపై api4.ipify.orgను ప్రయత్నిస్తుంది; తద్వారా IPv4-మాత్రమే టన్నెల్లు పనిచేయడం లేదని నివేదించబడవు (#9694).
NO_PROXY	(సెట్ చేయలేదు)	Node.js ప్రామాణికం	ప్రాక్సీని బైపాస్ చేయాల్సిన కామాతో వేరు చేసిన హోస్ట్నేమ్లు/IPలు.
OMNIROUTE_PROXY_DISPATCHER_CONNECTIONS	32	open-sse/utils/proxyDispatcher.ts	క్యాష్ చేసిన ఒక్కో HTTP/SOCKS ప్రాక్సీ డిస్పాచర్కు అనుమతించే గరిష్ఠ సమకాలీన సాకెట్లు. అనేక అభ్యర్థనలు ఒకే అకౌంట్-స్థాయి ప్రాక్సీని పంచుకున్నప్పుడు Codex /v1/responses వంటి దీర్ఘకాలిక SSE స్ట్రీమ్లకు ఒకటి కంటే ఎక్కువ కనెక్షన్లు అవసరం. 256 కంటే ఎక్కువ విలువలు పరిమితం చేయబడతాయి.
SOCKS_HANDSHAKE_TIMEOUT_MS	10000	open-sse/utils/socksConnectorWithFamily.ts	SOCKS5 హ్యాండ్షేక్ (కనెక్ట్) టైమ్అవుట్, msలో. ఒకే రెసిడెన్షియల్ గేట్వే హోస్ట్పై అధిక సమకాలీన లోడ్ ఉన్నప్పుడు (ఉదా. ఏకకాలంలో 100 అభ్యర్థనలు) దీన్ని పెంచండి — ప్రాక్సీ అందుబాటులో ఉన్నప్పటికీ, సంతృప్త స్థితిలో ఉన్న పూల్లో అసలు హ్యాండ్షేక్కు 10s కంటే ఎక్కువ పట్టవచ్చు; లేదంటే ఇది తప్పుడు [Proxy Fast-Fail] Proxy unreachableగా కనిపిస్తుంది. గరిష్ఠ పరిమితి 120000.
PROXY_FAIL_OPEN	false	src/sse/handlers/chatHelpers.ts	falseగా ఉన్నప్పుడు (డిఫాల్ట్), కేటాయించిన ప్రాక్సీని రిజాల్వ్ చేయడం విఫలమైన అభ్యర్థన నేరుగా కనెక్షన్కు తిరిగి వెళ్లకుండా తిరస్కరించబడుతుంది (fail-closed) — ఇది నిజమైన IP లీక్లను నివారిస్తుంది. పాత DIRECT ఫాల్బ్యాక్ను పునరుద్ధరించడానికి trueగా సెట్ చేయండి.
ENABLE_TLS_FINGERPRINT	false	open-sse/executors	wreq-js ఉపయోగించి TLS ఫింగర్ప్రింట్ను అనుకరించండి (Chrome 124ను అనుకరిస్తుంది). JA3/JA4 నిరోధాన్ని ఎదుర్కొంటుంది.
TLS_FINGERPRINT_PROVIDERS	(సెట్ చేయలేదు)	open-sse/utils/proxyFetch.ts	కొత్త ప్రాక్సీడ్ TLS రూటింగ్ (open-sse/utils/proxyFetch.ts) కోసం కామాలతో వేరు చేసిన ప్రొవైడర్ అనుమతి జాబితా. ఇది సెట్ చేయనప్పుడు డైరెక్ట్ TLS తన పాత ప్రవర్తనను కొనసాగిస్తుంది; ఈ ప్రొవైడర్లు మాత్రమే Chrome-124 ఫింగర్ప్రింట్ బ్రిడ్జ్ ద్వారా రూట్ చేయబడతాయి.
OMNIROUTE_TURNSTILE_IGNORE_TLS_ERRORS	false	open-sse/services/claudeTurnstileSolver.ts	HTTPS సర్టిఫికేట్ లోపాలను విస్మరించడానికి Claude Turnstile Playwright బ్రౌజర్ కాంటెక్స్ట్ను అనుమతించండి.

సందర్భాలు

సందర్భం	కాన్ఫిగరేషన్
SSH టన్నెల్ ద్వారా SOCKS5	ALL_PROXY=socks5://127.0.0.1:7890, ENABLE_SOCKS5_PROXY=true
కార్పొరేట్ HTTP ప్రాక్సీ	HTTP_PROXY=http://proxy.corp.com:3128, HTTPS_PROXY=http://proxy.corp.com:3128, NO_PROXY=localhost,internal.corp.com
యాంటీ-ఫింగర్ప్రింట్	ENABLE_TLS_FINGERPRINT=true — wreq-js అవసరం (చేర్చబడింది)
ఎగ్రెస్-నియంత్రిత / ప్రత్యక్ష యాక్సెస్ లేదు	PROXY_FAIL_OPEN=falseగా ఉంచండి (డిఫాల్ట్). ప్రాక్సీ అందుబాటులో లేనప్పుడు అభ్యర్థనలు ప్రత్యక్షంగా వెళ్లి లీక్ కావడానికి బదులుగా పూర్తిగా విఫలమవుతాయి.
లెగసీ / డెవ్ — ప్రత్యక్ష ఫాల్బ్యాక్ను అనుమతించండి	PROXY_FAIL_OPEN=true. హార్డెనింగ్కు ముందు ఉన్న ప్రవర్తనను పునరుద్ధరిస్తుంది: ప్రాక్సీ రిజల్యూషన్ విఫలమైనప్పుడు ప్రత్యక్ష కనెక్షన్ ఉపయోగించబడుతుంది.

గమనిక (NVIDIA ధృవీకరణ బైపాస్ — #3226): గ్లోబల్ ప్రాక్సీ/TLS-ప్యాచ్ చేసిన fetch ద్వారా రూట్ చేసినప్పుడు NVIDIA యొక్క API-key ధృవీకరణ ఎండ్పాయింట్ నిలిచిపోతుంది (undici డిస్పాచర్ → 504). src/lib/providers/validation.ts::directHttpsRequest() ఆ ఒక్క ధృవీకరణ కాల్ కోసం safeOutboundFetch({ bypassProxyPatch: true })ను ఉపయోగించి ఉద్దేశపూర్వకంగా ప్రాక్సీ ప్యాచ్ను బైపాస్ చేస్తుంది. ఇది డాక్యుమెంట్ చేయబడిన, పరిమిత పరిధి గల మినహాయింపు — ఇది చాట్/వినియోగ ఎగ్రెస్పై ప్రభావం చూపదు. బైపాస్ పరిధి tests/unit/proxy-bypass-scope-guard-3226.test.ts ద్వారా నిర్దిష్టంగా పరిమితం చేయబడింది.

---

9. CLI సాధన సమన్వయం

OmniRoute CLI సైడ్కార్లను (Claude Code, Codex మొదలైనవి) ఎలా గుర్తించి, ప్రారంభించాలో నియంత్రిస్తుంది.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
CLI_MODE	auto	src/shared/services/cliRuntime.ts	auto = సిస్టమ్ PATHలో శోధిస్తుంది; manual = స్పష్టంగా పేర్కొన్న పాత్లను మాత్రమే ఉపయోగిస్తుంది.
CLI_EXTRA_PATHS	(సెట్ చేయలేదు)	src/shared/services/cliRuntime.ts	CLI బైనరీలను కనుగొనడానికి అదనపు PATH ఎంట్రీలు (కోలన్తో వేరు చేసినవి).
CLI_CONFIG_HOME	(సెట్ చేయలేదు)	src/shared/services/cliRuntime.ts	CLI కాన్ఫిగ్లను (~/.claude, ~/.codex) చదవడానికి ఉపయోగించే హోమ్ డైరెక్టరీని ఓవర్రైడ్ చేస్తుంది. ఇది తప్పనిసరిగా అబ్సల్యూట్ పాత్ అయి, ప్రాసెస్ హోమ్లో ఉండాలి — లేదా, కంటైనర్లో అయితే, bind-mounted పాత్ అయి ఉండాలి (/host-home ఈ విధంగానే పనిచేస్తుంది). మిగతావన్నీ హోమ్ డైరెక్టరీకి ఫాల్బ్యాక్ అవుతాయి.
CLI_ALLOW_CONFIG_WRITES	true	src/shared/services/cliRuntime.ts	CLI కాన్ఫిగ్ ఫైల్లను (టోకెన్ రిఫ్రెష్, సెషన్ డేటా) వ్రాయడానికి OmniRouteను అనుమతిస్తుంది. ప్రతి CLI కాన్ఫిగ్ వ్రాత స్పష్టమైన "వ్రాతలు నిలిపివేయబడ్డాయి" ఎర్రర్తో విఫలమయ్యేలా చేయడానికి దీన్ని falseగా సెట్ చేయండి.
CLI_CLAUDE_BIN	claude	src/shared/services/cliRuntime.ts	Claude CLI బైనరీకి అనుకూల పాత్.
CLI_CODEX_BIN	codex	src/shared/services/cliRuntime.ts	Codex CLI బైనరీకి అనుకూల పాత్.
CLI_DROID_BIN	droid	src/shared/services/cliRuntime.ts	Droid CLI బైనరీకి అనుకూల పాత్.
CLI_OPENCLAW_BIN	openclaw	src/shared/services/cliRuntime.ts	OpenClaw CLI బైనరీకి అనుకూల పాత్.
CLI_CURSOR_BIN	agent, తర్వాత cursor	src/shared/services/cliRuntime.ts	Cursor agent బైనరీకి అనుకూల పాత్. ఇది లేకపోతే, గుర్తింపు మొదట agentను ప్రయత్నించి, అది అందుబాటులో లేకపోతే cursorకు ఫాల్బ్యాక్ అవుతుంది.
CLI_CLINE_BIN	cline	src/shared/services/cliRuntime.ts	Cline CLI బైనరీకి అనుకూల పాత్.
CLI_5DIVE_BIN	5dive	src/shared/services/cliRuntime.ts	5dive CLI బైనరీకి అనుకూల పాత్.
CLI_5DIVE_STATE_DIR	/var/lib/5dive	src/shared/services/cliRuntime.ts	5dive సిస్టమ్ స్టేట్ డైరెక్టరీ (root యాజమాన్యంలోని ప్రమాణీకరణ ప్రొఫైల్లు); ఇది 5dive స్వంత STATE_DIR డిఫాల్ట్ను ప్రతిబింబిస్తుంది.
CLI_CONTINUE_BIN	cn	src/shared/services/cliRuntime.ts	Continue CLI బైనరీకి అనుకూల పాత్.
CLI_QODER_BIN	qodercli	src/shared/services/cliRuntime.ts	Qoder CLI బైనరీకి అనుకూల పాత్.
CLI_QWEN_BIN	qwen	src/shared/services/cliRuntime.ts	Qwen Code CLI బైనరీకి అనుకూల పాత్.
CLI_AIDER_BIN	aider	src/shared/services/cliRuntime.ts	Aider CLI బైనరీకి అనుకూల పాత్.
CLI_GOOSE_BIN	goose	src/shared/services/cliRuntime.ts	Goose CLI బైనరీకి అనుకూల పాత్.
CLI_GEMINI_BIN	gemini	src/shared/services/cliRuntime.ts	Google Gemini CLI బైనరీకి అనుకూల పాత్ — సర్వర్-సైడ్ గుర్తింపు/ఆరోగ్య తనిఖీలకు మాత్రమే; omniroute run gemini సిస్టమ్ PATH నుండి gemini బైనరీని పరిష్కరిస్తుంది.
CLI_KILO_BIN	kilocode	src/shared/services/cliRuntime.ts	Kilo Code CLI బైనరీకి అనుకూల పాత్.
CLI_OPENCODE_BIN	opencode	src/shared/services/cliRuntime.ts	OpenCode CLI బైనరీకి అనుకూల పాత్.
CLI_HERMES_BIN	hermes	src/shared/services/cliRuntime.ts	Hermes బైనరీకి అనుకూల మార్గం. రెండు క్యాటలాగ్ ఎంట్రీలు (hermes మరియు hermes-agent) దీన్ని పంచుకుంటాయి.
CLI_FORGE_BIN	forge	src/shared/services/cliRuntime.ts	ForgeCode CLI బైనరీకి అనుకూల మార్గం.
CLI_JCODE_BIN	jcode	src/shared/services/cliRuntime.ts	jcode CLI బైనరీకి అనుకూల మార్గం.
CLI_DEEPSEEK_TUI_BIN	deepseek-tui	src/shared/services/cliRuntime.ts	DeepSeek TUI బైనరీకి అనుకూల మార్గం.
CLI_CODEWHALE_BIN	codewhale	src/shared/services/cliRuntime.ts	CodeWhale CLI బైనరీకి అనుకూల మార్గం.
CLI_SMELT_BIN	smelt	src/shared/services/cliRuntime.ts	Smelt CLI బైనరీకి అనుకూల మార్గం.
CLI_PI_BIN	pi	src/shared/services/cliRuntime.ts	Pi (pi-coding-agent) బైనరీకి అనుకూల మార్గం.
CLI_CRUSH_BIN	crush	src/shared/services/cliRuntime.ts	Crush CLI బైనరీకి అనుకూల మార్గం.
CLI_OMP_BIN	omp	src/shared/services/cliRuntime.ts	Oh My Pi (omp) ఏజెంట్ బైనరీకి అనుకూల మార్గం.
CLI_LETTA_BIN	letta	src/shared/services/cliRuntime.ts	Letta CLI బైనరీకి అనుకూల మార్గం.
CLI_PRIME_AGENT_BIN	prime-agent	src/shared/services/cliRuntime.ts	Prime Agent (Prime Intellect) బైనరీకి అనుకూల మార్గం.
CLI_WINDSURF_BIN	(ఏదీ లేదు)	src/shared/services/cliRuntime.ts	Windsurf బైనరీకి అనుకూల మార్గం. Windsurfలో డిఫాల్ట్ కమాండ్ లేదు — దీన్ని సెట్ చేసే వరకు బైనరీ గుర్తింపు నిలిపివేయబడి ఉంటుంది.
CLI_DEVIN_BIN	devin	open-sse/executors/devin-cli.ts	Devin CLI బైనరీకి (v3.8.0) అనుకూల మార్గం. Windsurf/Devin ఎగ్జిక్యూటర్ దీనిని ఉపయోగిస్తుంది.
DEVIN_DESKTOP_VERSION	3.6.27	open-sse/executors/devin-desktop.ts	Devin Desktop ide_version. ఓవర్రైడ్లు తప్పనిసరిగా x.y.z ఆకృతిని ఉపయోగించాలి; చెల్లని విలువలు ధృవీకరించిన డిఫాల్ట్కు తిరిగి వెళ్తాయి.
DEVIN_DESKTOP_EXTENSION_VERSION	1.48.2	open-sse/executors/devin-desktop.ts	బండిల్ చేసిన Codeium/language-server extension_version, Desktop ide_versionకు భిన్నమైనది. ఓవర్రైడ్లు తప్పనిసరిగా x.y.zను ఉపయోగించాలి; చెల్లని విలువలు బండిల్ చేసిన డిఫాల్ట్ను ఉపయోగిస్తాయి.
CLI_DEVIN_AGENTIC_BIN	devin	open-sse/executors/devin-cli-agentic.ts	ఏజెంటిక్ బ్రిడ్జ్కు మాత్రమే వర్తించే Devin CLI ఓవర్రైడ్. ఎగ్జిక్యూటర్ స్థానిక ACP stdio అప్స్ట్రీమ్ను మాత్రమే అంగీకరిస్తుంది.
DEVIN_AGENTIC_HOME	(అవసరం)	open-sse/executors/devin-cli-agentic.ts	ఏజెంటిక్ Devin సబ్ప్రాసెస్ కోసం సంపూర్ణ ఐసోలేటెడ్ హోమ్; అంగీకరించబడే బ్రిడ్జ్ మార్గాలు /home/bridge మరియు టాస్క్-లోకల్ .sandbox మార్గాలు (Windowsలో, C:\...\.sandbox\...).
DEVIN_AGENTIC_ACP_TIMEOUT_MS	120000	open-sse/executors/devin-cli-agentic.ts	బ్రిడ్జ్ చైల్డ్ను ముగించి స్పష్టమైన టైమ్అవుట్ను అందించడానికి ముందు ఒక Devin ACP టర్న్కు అనుమతించే గరిష్ఠ వ్యవధి.
DEVIN_BRIDGE_MODEL	devin-cli-agentic/swe-1-7	docker/devin-bridge/compose.yml	ఐసోలేటెడ్ బ్రిడ్జ్ కోసం ప్రధాన Claude Code మోడల్ అలియాస్. లైవ్ హార్నెస్ ఉదాహరణను ప్రస్తుత Devin ఖాతా అందించిన మోడల్తో భర్తీ చేస్తుంది.
DEVIN_BRIDGE_SONNET_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Claude Code తన Sonnet డిఫాల్ట్ను అభ్యర్థించినప్పుడు ఉపయోగించే ఐసోలేటెడ్ బ్రిడ్జ్ అలియాస్.
DEVIN_BRIDGE_OPUS_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Claude Code తన Opus డిఫాల్ట్ను అభ్యర్థించినప్పుడు ఉపయోగించే ఐసోలేటెడ్ బ్రిడ్జ్ అలియాస్.
DEVIN_BRIDGE_HAIKU_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Claude Code తన Haiku డిఫాల్ట్ను అభ్యర్థించినప్పుడు ఉపయోగించే ఐసోలేటెడ్ బ్రిడ్జ్ అలియాస్.
DEVIN_BRIDGE_SUBAGENT_MODEL	DEVIN_BRIDGE_MODEL	docker/devin-bridge/compose.yml	Claude Code సబ్ఏజెంట్ల కోసం ఉపయోగించే ఐసోలేటెడ్ బ్రిడ్జ్ అలియాస్.
DEVIN_SEAT_API_URL	https://server.codeium.com	open-sse/services/usage/devinCli.ts	Devin CLI కోటా (GetUserStatus) ఉపయోగించే Codeium సీట్-మేనేజ్మెంట్ API కోసం ఐచ్ఛిక ఓవర్రైడ్.
AUGGIE_BIN	auggie	open-sse/executors/auggie.ts	స్థానిక auggie ప్రొవైడర్ ఉపయోగించే Augment (Auggie) CLI బైనరీ కోసం సంపూర్ణ-పాత్ ఓవర్రైడ్. ఇది అందుబాటులో లేకపోతే CLI_AUGGIE_BINను, ఆ తర్వాత PATH లుకప్ను ఉపయోగిస్తుంది.
CLI_AUGGIE_BIN	auggie	open-sse/executors/auggie.ts	Augment (Auggie) CLI బైనరీ పాత్ కోసం ప్రత్యామ్నాయ ఓవర్రైడ్ (AUGGIE_BIN తర్వాత తనిఖీ చేయబడుతుంది).
ZCODE_BIN	zcode	open-sse/executors/zcode.ts	స్థానిక zcode ప్రొవైడర్ యొక్క stdio క్లయింట్ కోసం ఉపయోగించే బైనరీ. ఇది అందుబాటులో లేకపోతే PATHలోని zcodeను ఉపయోగిస్తుంది.
ZCODE_ARGS	—	open-sse/executors/zcode.ts	cliTools ద్వారా ప్రారంభించినప్పుడు zcode బైనరీకి పంపే అదనపు ఆర్గ్యుమెంట్ల JSON అరే (≤16 స్ట్రింగ్లు).
ZCODE_CWD	process.cwd()	open-sse/executors/zcode.ts	ZCode యాప్-సర్వర్ సబ్ప్రాసెస్ కోసం వర్కింగ్ డైరెక్టరీ.
ZCODE_PROVIDER_ID	builtin:zai-coding-plan	open-sse/executors/zcode.ts	యాప్-సర్వర్కు పంపే ప్రొవైడర్ ID కోసం ఓవర్రైడ్.
ZCODE_SERVER_RUNTIME_ROOT	~/.zcode/server	open-sse/executors/zcode.ts	ZCode యాప్-సర్వర్ రన్టైమ్ యొక్క రూట్ (node మరియు zcode-server.cjs బండిల్లు ఉండే స్థానం).
ZCODE_SERVER_NODE	<runtimeRoot>/node	open-sse/executors/zcode.ts	ZCode యాప్-సర్వర్ను హోస్ట్ చేయడానికి ఉపయోగించే Node ఎగ్జిక్యూటబుల్.
ZCODE_SERVER_ENTRY	<runtimeRoot>/zcode-server.cjs	open-sse/executors/zcode.ts	ZCode సర్వర్ను హోస్ట్ చేయడానికి ఉపయోగించే యాప్-సర్వర్ ఎంట్రీ స్క్రిప్ట్.
ZCODE_STARTUP_TIMEOUT_MS	10000	open-sse/executors/zcode.ts	ZCode యాప్-సర్వర్ ప్రారంభం విఫలమైనట్లు పరిగణించే ముందు వర్తించే స్టార్టప్ టైమ్అవుట్ (ms).
ZCODE_RPC_TIMEOUT_MS	30000	open-sse/executors/zcode.ts	ZCode యాప్-సర్వర్ కాల్ కోసం ప్రతి అభ్యర్థనకు వర్తించే RPC టైమ్అవుట్ (ms).
ZCODE_TURN_TIMEOUT_MS	120000	open-sse/executors/zcode.ts	సూపర్వైజర్ టైమ్అవుట్ చేసే ముందు ఒక ZCode టర్న్కు అనుమతించే గరిష్ఠ వ్యవధి (ms).
ZCODE_POLL_INTERVAL_MS	250	open-sse/executors/zcode.ts	ZCode టర్న్ పూర్తయిందో లేదో తనిఖీ చేసే పోలింగ్ విరామం (ms).
HERMES_HOME	~/.hermes	src/lib/cli-helper/config-generator/hermesHome.ts	OmniRoute, Hermes CLI కాన్ఫిగరేషన్ను చదివే/వ్రాసే Hermes Agent హోమ్ డైరెక్టరీ. Windowsలో Hermes PowerShell ఇన్స్టాలర్ సెట్ చేసే ఎన్విరాన్మెంట్ వేరియబుల్తో (%LOCALAPPDATA%\hermes) సరిపోలుతుంది.

CLI ప్రొఫైల్ ఆటో-సింక్

ఈ ఫీచర్ ఫ్లాగ్లు ఆప్ట్-ఇన్ విధానంలో ఉంటాయి మరియు డిఫాల్ట్గా ఆఫ్లో ఉంటాయి. వీటిని CLI Code డ్యాష్బోర్డ్ నుండి కూడా ఆన్ లేదా ఆఫ్ చేయవచ్చు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_AUTO_SYNC_CODEX_PROFILES	false	src/shared/constants/featureFlagDefinitions.ts	ప్రొవైడర్ మోడల్ సింక్ తర్వాత, లైవ్ కేటలాగ్ ఆధారంగా ~/.codex/*.config.toml ప్రొఫైల్ ఫైల్లను స్వయంచాలకంగా తిరిగి వ్రాస్తుంది. దీనికి CLI_ALLOW_CONFIG_WRITES అవసరం; యాక్టివ్/డిఫాల్ట్ Codex కాన్ఫిగరేషన్, ఆథ్, Codex-lb సెట్టింగ్లు లేదా ప్రొవైడర్ ఎంపికను ఎప్పటికీ మార్చదు.
OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES	false	src/shared/constants/featureFlagDefinitions.ts	ప్రొవైడర్ మోడల్ సింక్ తర్వాత, లైవ్ కేటలాగ్ ఆధారంగా ~/.claude/profiles/<name>/settings.json Claude Code ప్రొఫైల్ ఫైల్లను స్వయంచాలకంగా తిరిగి వ్రాస్తుంది. దీనికి CLI_ALLOW_CONFIG_WRITES అవసరం; యాక్టివ్/డిఫాల్ట్ Claude కాన్ఫిగరేషన్, ఆథ్ లేదా ప్రొవైడర్ ఎంపికను ఎప్పటికీ మార్చదు.

Docker ఉదాహరణ

# హోస్ట్ బైనరీలను కంటైనర్లోకి మౌంట్ చేసి, అవి ఎక్కడ ఉన్నాయో OmniRouteకు తెలియజేయండి:
CLI_EXTRA_PATHS=/host-cli/bin
CLI_CONFIG_HOME=/host-home
CLI_ALLOW_CONFIG_WRITES=true
CLI_CLAUDE_BIN=/host-cli/bin/claude

CLI_CONFIG_HOME అనేది పాత్ను హోస్ట్ నుండి వాస్తవంగా bind-mount చేసినప్పుడు మాత్రమే అమల్లోకి వస్తుంది — దీన్ని ~/.codex:/host-home/.codex:rw వంటి mountsతో జత చేయండి (docker-compose.ymlలోని host profile చూడండి). కంటైనర్ వినియోగదారు home లోపల లేని, అలాగే bind mount కాని పాత్ విస్మరించబడుతుంది, ఎందుకంటే అక్కడ వ్రాసిన డేటా కంటైనర్ను మళ్లీ సృష్టించినప్పుడు తొలగిపోతుంది.

ఇమేజ్ USER nodeగా రన్ అవుతుంది, కాబట్టి mount చేయని /root చెల్లుబాటు అయ్యే override కాదు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_CONTAINER	(auto)	src/shared/utils/containerEnv.ts	కంటైనర్ గుర్తింపును ఆన్ (1/true) లేదా ఆఫ్ (0/false) చేయమని నిర్బంధిస్తుంది. స్వయంచాలక గుర్తింపు గుర్తించలేని runtimesలో మాత్రమే ఇది అవసరం.
OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE	false	src/shared/services/cliRuntime.ts	mount చేయని కంటైనర్ పాత్లోకి CLI-tool config వ్రాతలను ఏమైనప్పటికీ అనుమతిస్తుంది. దీనికి సమానమైన CLI ఎంపిక --allow-container-write.

CLI బైనరీ (omniroute) సహాయకాలు

ఈ వేరియబుల్స్ omniroute CLI బైనరీ యొక్క స్వంత ప్రవర్తనను సర్దుబాటు చేస్తాయి (పైన ఉన్న sidecar గుర్తింపును కాదు).

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_LANG	(system)	bin/cli/i18n.mjs	CLI అవుట్పుట్ భాషను నిర్బంధిస్తుంది. BCP-47 locale (ఉదా. en, pt-BR). సిస్టమ్ locale env varsను (LC_ALL, LC_MESSAGES) override చేస్తుంది.
OMNIROUTE_SHOW_LOG	(unset)	bin/cli/runtime/processSupervisor.mjs	supervised modeలో server stdout/stderrను terminalకు పంపడానికి 1గా సెట్ చేయండి. omniroute serveలోని --log flagకు సమానం.
OMNIROUTE_CLI_TOKEN	(unset)	bin/cli/api.mjs	x-omniroute-cli-token headerగా చేర్చబడే machine-auth token. task 8.12లో స్వయంచాలకంగా రూపొందించబడుతుంది.
OMNIROUTE_HTTP_TIMEOUT_MS	30000	bin/cli/api.mjs	CLI → server requests కోసం ప్రతి ప్రయత్నానికి HTTP timeout (ms).
OMNIROUTE_READY_TIMEOUT_MS	60000	bin/cli/utils/pid.mjs	timeout హెచ్చరికను ముద్రించే ముందు server health endpoint కోసం CLI వేచి ఉండే గరిష్ఠ సమయం (ms). నెమ్మదైన cold startsకు (ఉదా. Windows) ఉపయోగకరం. --ready-timeout ద్వారా కూడా సెట్ చేయవచ్చు.
OMNIROUTE_VERBOSE	0	bin/cli/api.mjs	CLI commands సమయంలో retry/backoff diagnosticsను stderrకు ముద్రించడానికి 1గా సెట్ చేయండి.
OMNIROUTE_PLUGIN_PATH	(unset)	bin/cli/plugins.mjs	CLI plugin గుర్తింపు కోసం అనుకూల directory (omniroute-cmd-* packages). సెట్ చేయనప్పుడు డిఫాల్ట్గా ~/.omniroute/plugins/ ఉపయోగించబడుతుంది. CLIకి మాత్రమే — ఇది server-side plugin scannerకు ఎప్పటికీ చేరదు; దాన్ని OMNIROUTE_PLUGINS_DIR సూచిస్తుంది (విభాగం 2).

---

10. అంతర్గత ఏజెంట్ & MCP ఇంటిగ్రేషన్లు

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_BASE_URL	స్వయంచాలక గుర్తింపు	open-sse/mcp-server/server.ts	OmniRouteను చేరుకోవడానికి MCP/A2A సాధనాల కోసం స్పష్టమైన URL. localhost స్వయంచాలక గుర్తింపును ఓవర్రైడ్ చేస్తుంది.
OMNIROUTE_API_KEY	(సెట్ చేయబడలేదు)	MCP/A2A మాడ్యూల్లు	అంతర్గత MCP సాధనం మరియు A2A స్కిల్ కాల్ల కోసం API కీ.
OMNIROUTE_API_KEY_ID	(సెట్ చేయబడలేదు)	open-sse/mcp-server/audit.ts	MCP ఆడిట్ లాగ్ ఆపాదన కోసం కీ ID.
ROUTER_API_KEY	(సెట్ చేయబడలేదు)	లెగసీ	OMNIROUTE_API_KEY కోసం లెగసీ అలియాస్.
OMNIROUTE_A2A_HISTORY_RETENTION_DAYS	30	src/lib/a2a/taskManager.ts	రోజువారీ ప్రక్షాళన ఒక వరుసను తొలగించే ముందు స్థానిక డేటాబేస్లో ఉంచే A2A టాస్క్ చరిత్ర రోజుల సంఖ్య. సెట్ చేయకపోయినా, సంఖ్య కాకపోయినా లేదా <= 0 అయినా 30కి ఫాల్బ్యాక్ అవుతుంది.
OMNIROUTE_A2A_MEMORY_HITS	1	src/lib/a2a/taskExecution.ts	A2A మెమరీ-హిట్స్ పరిశీలనీయత ఫీచర్ కోసం కిల్-స్విచ్. ఒక టాస్క్కు సంబంధించిన మెమరీ రీకాల్ లుకప్ను పూర్తిగా దాటవేయడానికి 0గా సెట్ చేయండి; ఏ ఇతర విలువైనా (సెట్ చేయకపోవడం సహా) దాన్ని ప్రారంభించి ఉంచుతుంది.
OMNIROUTE_ISSUE_AGENT_ENABLED	false	src/app/api/issue-agent/runs/route.ts	ఆఫ్లైన్/స్థానిక Issue Agent రికార్డ్ చేసిన-ట్రయాజ్ ఎండ్పాయింట్ను ప్రారంభిస్తుంది. స్థానిక రికార్డ్ చేసిన-ట్రయాజ్ వర్క్ఫ్లోలను స్పష్టంగా అమలు చేస్తున్నప్పుడు తప్ప దీన్ని నిలిపివేసి ఉంచండి.
OMNIROUTE_ISSUE_AGENT_TIMEOUT_MS	(సెట్ చేయబడలేదు)	src/lib/issueAgent/execution.ts	ఒకే Issue Agent రికార్డ్ చేసిన-ట్రయాజ్ రన్ కోసం టైమ్అవుట్ (ms). అంతర్గత గరిష్ఠ పరిమితికి కుదించబడుతుంది; సెట్ చేయనప్పుడు లేదా చెల్లనప్పుడు అంతర్నిర్మిత డిఫాల్ట్కు ఫాల్బ్యాక్ అవుతుంది.
OMNIROUTE_CONTEXT	(సక్రియ కాంటెక్స్ట్)	bin/cli/program.mjs, bin/cli/api.mjs	omniroute కమాండ్ల కోసం CLI రిమోట్-మోడ్ కాంటెక్స్ట్/ప్రొఫైల్; స్థానిక కాంటెక్స్ట్ల స్టోర్లోని సక్రియ కాంటెక్స్ట్ను ఓవర్రైడ్ చేస్తుంది. --context <name>కు సమానం.
OMNIROUTE_CONTEXT_KEYCHAIN_DISABLED	0	bin/cli/contexts.mjs	CLI కాంటెక్స్ట్ క్రెడెన్షియల్స్ కోసం ఐచ్ఛిక keytar OS-కీచైన్ బ్యాకెండ్ను నిలిపివేస్తుంది. ప్రారంభించినప్పుడు, క్రెడెన్షియల్స్ config.json మోడ్ 0600లో ఉంటాయి మరియు CLI ఒకసారి మాత్రమే ఫాల్బ్యాక్ హెచ్చరికను జారీ చేస్తుంది; ఉద్దేశపూర్వక హెడ్లెస్/కంటైనర్ ఆపరేషన్ కోసం రూపొందించబడింది.
OMNIROUTE_MCP_ENFORCE_SCOPES	true	open-sse/mcp-server/server.ts	MCP సాధన కాల్లపై స్కోప్-ఆధారిత యాక్సెస్ నియంత్రణను అమలు చేస్తుంది.
OMNIROUTE_MCP_SCOPES	(అన్నీ)	open-sse/mcp-server/server.ts	కామాలతో వేరు చేసిన స్కోప్లు: admin, combos, health, models, routing, budget, metrics, pricing, memory, skills.
OMNIROUTE_MCP_COMPRESS_DESCRIPTIONS	false	open-sse/mcp-server/descriptionCompressor.ts	మానిఫెస్ట్ను సీరియలైజ్ చేయడానికి ముందు MCP సాధన వివరణలను కుదిస్తుంది. ప్రారంభించే విలువలు: 1, true, on.
OMNIROUTE_MCP_DESCRIPTION_COMPRESSION	rtk	open-sse/mcp-server/descriptionCompressor.ts	కంప్రెషన్ అల్గారిథమ్/ప్రొఫైల్. నిలిపివేసే విలువలు: 0, false, off.
OMNIROUTE_MCP_FETCH_TIMEOUT_MS	10000	open-sse/mcp-server/fetchTimeout.ts	MCP-సర్వర్ అంతర్గత నిర్వహణ రీడ్ల (హెల్త్, రెసిలియన్స్, కాంబోలు, కోటా, వినియోగం) కోసం అబార్ట్ బడ్జెట్ (ms).
OMNIROUTE_MCP_UPSTREAM_TIMEOUT_MS	60000	open-sse/mcp-server/fetchTimeout.ts	ప్రొవైడర్ కోసం వేచి ఉండే MCP హాప్లకు (route_request, web_search, web_fetch) అబార్ట్ సమయ పరిమితి (ms).
OMNIROUTE_CORPUS_CACHE_SIZE	5	src/lib/localCorpus/configured.ts	మెమరీలో క్యాష్ చేయబడే లోకల్-కార్పస్ ఇండెక్స్ ఇన్స్టాన్స్ల గరిష్ఠ సంఖ్య (LRU, ఇండెక్స్ చేసిన ప్రతి రూట్ డైరెక్టరీకి ఒకటి). కనిష్ఠంగా 1కి పరిమితం చేయబడుతుంది.
MODEL_SYNC_INTERVAL_HOURS	24	src/shared/services/modelSyncScheduler.ts	గంటల్లో మోడల్ కేటలాగ్ సింక్ విరామం.
PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES	70	src/lib/usage/providerLimits.ts	ప్రొవైడర్ రేట్-లిమిట్ మరియు కోటా పోలింగ్ విరామం.
PROVIDER_LIMITS_SYNC_SPACING_MS	1500	src/lib/usage/providerLimits.ts	బల్క్ సింక్లో వరుస OAuth కోటా ఫెచ్ల మధ్య విరామం (ms); అప్స్ట్రీమ్పై ఒకేసారి అధిక భారం పడకుండా ఉండేందుకు OAuth కనెక్షన్లు ఒక్కొక్కటిగా ఫెచ్ చేయబడతాయి. 0ని సెట్ చేస్తే ఇది వర్తించదు (ఏకకాలికం).
OMNIROUTE_QUOTA_FETCH_MIN_INTERVAL_MS	250	open-sse/services/quotaFetchThrottle.ts	ప్రతి-రిక్వెస్ట్ ప్రీఫ్లైట్/మానిటర్ పాత్లో వరుస అప్స్ట్రీమ్ కోటా ఫెచ్ల మధ్య కనిష్ఠ విరామం (ms); ఒకే IPలోని అనేక అకౌంట్లు అప్స్ట్రీమ్పై ఒకేసారి అధిక భారం వేయకుండా ఏకకాలిక నెట్వర్క్ కాల్లకు మధ్య విరామాన్ని కల్పిస్తుంది. Codex (/wham/usage), DeepSeek, Bailian (రెండు ఫెచ్ సైట్లు), OpenCode మరియు Crof కోటా ఫెచర్లలో అనుసంధానించబడింది (#6009, #6911). సాధారణ usage.ts::getUsageForProvider డిస్పాచ్ పాత్ (github/glm/minimax/nanogpt/xai/మొదలైనవి) ఇంకా కవర్ చేయబడలేదు — విడిగా ట్రాక్ చేయబడుతోంది. క్యాష్ హిట్లపై ప్రభావం ఉండదు. 0 నిలిపివేస్తుంది; 0..5000 పరిధికి పరిమితం చేయబడుతుంది.
PROVIDER_LIMITS_POST_USAGE_REFRESH_DELAY_MS	5000	src/lib/usage/providerLimits.ts	వాస్తవ వినియోగ ఈవెంట్ తర్వాత ప్రొవైడర్ పరిమితులను రిఫ్రెష్ చేయడానికి ముందు ఆలస్యం (ms), తద్వారా వినియోగాన్ని నమోదు చేయడానికి అప్స్ట్రీమ్ కోటా APIకి సమయం లభిస్తుంది.
OMNIROUTE_LOGIN_BROWSER_PATH	స్వయంచాలక-గుర్తింపు	open-sse/services/adobeFireflyBrowserLogin.ts	ఇంటరాక్టివ్ Adobe Firefly సైన్-ఇన్ మరియు ఆఫ్-స్క్రీన్ పునరుద్ధరణ కోసం ఉపయోగించే సిస్టమ్ Chrome లేదా Edge ఎగ్జిక్యూటబుల్కు సంపూర్ణ పాత్.
ADOBE_FIREFLY_BROWSER_REFRESH	ప్రారంభించబడింది	open-sse/services/adobeFireflySession.ts	అకౌంట్-స్కోప్ చేసిన Chrome CDP సెషన్లతో IMS మరియు బ్రౌజర్-రిస్క్ స్థితిని తాజాగా ఉంచుతుంది. బ్రౌజర్ పునరుద్ధరణను నిలిపివేయడానికి 0కి సెట్ చేయండి.
ADOBE_FIREFLY_SESSION_DISK	ప్రారంభించబడింది	open-sse/services/adobeFireflySession.ts	ప్రాసెస్ పునఃప్రారంభాల మధ్య మరమ్మతు చేసిన Adobe సెషన్లను DATA_DIR కింద నిల్వ చేస్తుంది. సెషన్లను మెమరీలో మాత్రమే ఉంచడానికి 0కి సెట్ చేయండి.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS	12000	open-sse/services/adobeFireflySession.ts	Adobe Firefly జనరేట్ సమర్పణల మధ్య మిల్లీసెకన్లలో కనిష్ఠ విరామం; 0 విరామాన్ని నిలిపివేస్తుంది.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS	15000	open-sse/services/adobeFireflySession.ts	ప్రతి మూడవ విజయవంతమైన Adobe సమర్పణ తర్వాత మిల్లీసెకన్లలో అదనపు నిశ్శబ్ద వ్యవధి.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS	8000	open-sse/services/adobeFireflyClient.ts	తాత్కాలిక Adobe 408 ప్రతిస్పందనల తర్వాత మిల్లీసెకన్లలో ప్రాథమిక బ్యాక్ఆఫ్; గరిష్ఠంగా ఐదు ప్రయత్నాల్లో సమర్పణ విరామంతో కలిపి వర్తించబడుతుంది.
OMNIROUTE_DISABLE_BACKGROUND_SERVICES	false	src/instrumentation-node.ts	అన్ని బ్యాక్గ్రౌండ్ సేవలను (సింక్, ధరల నిర్ణయం, మోడల్ రిఫ్రెష్) నిలిపివేయండి. CI/టెస్ట్కు ఉపయోగకరం.
OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS	(సెట్ చేయబడలేదు)	src/lib/config/runtimeSettings.ts	ఆటోమేటెడ్ టెస్ట్ గుర్తింపు సమయంలో బ్యాక్గ్రౌండ్ టాస్క్లను బలవంతంగా ప్రారంభించండి. టెస్ట్ హ్యూరిస్టిక్ను ఓవర్రైడ్ చేయడానికి 1కి సెట్ చేయండి.
OMNIROUTE_BUDGET_RESET_JOB_INTERVAL_MS	600000	src/lib/jobs/budgetResetJob.ts	బడ్జెట్ రీసెట్ తనిఖీ అవధి (ms). కనిష్ఠ పరిమితి 10000.
OMNIROUTE_CONNECTION_RECOVERY_INTERVAL_MS	60000	src/lib/quota/connectionRecovery.ts	ముందస్తు కనెక్షన్-కూల్డౌన్ పునరుద్ధరణ విరామం (ms): అభ్యర్థన హాట్ పాత్కు వెలుపల, తాత్కాలిక rate_limited_until గడువు ముగిసిన కనెక్షన్లను మళ్లీ ధ్రువీకరిస్తుంది. కనిష్ఠ పరిమితి 5000.
OMNIROUTE_DISABLE_CONNECTION_RECOVERY	false	src/lib/quota/connectionRecovery.ts	ముందస్తు కనెక్షన్-కూల్డౌన్ పునరుద్ధరణ షెడ్యూలర్ను నిలిపివేయండి (getProviderCredentialsలోని లేజీ పునరుద్ధరణ ఇప్పటికీ వర్తిస్తుంది).
OMNIROUTE_REASONING_CACHE_CLEANUP_INTERVAL_MS	1800000	src/lib/jobs/reasoningCacheCleanupJob.ts	రీజనింగ్ క్యాష్ శుభ్రపరిచే విరామం (ms). కనిష్ఠ పరిమితి 60000.
OMNIROUTE_REASONING_MIN_BUDGET	సెట్ చేయలేదు (నిలిపివేయబడింది)	open-sse/services/reasoningTokenBuffer.ts	థింకింగ్-మోడల్ అవుట్పుట్ బడ్జెట్ల కోసం ఎంపిక చేసుకోవాల్సిన కనిష్ఠ పరిమితి: [256, floor)లోని కాలర్ max_tokens విలువ కనిష్ఠ పరిమితికి పెంచబడుతుంది (మోడల్ అవుట్పుట్ పరిమితికి లోబడి ఉంటుంది). సెట్ చేయకపోతే = క్లయింట్ బడ్జెట్లు ఎన్నటికీ పెంచబడవు (#9507).
OMNIROUTE_LOG_EXPORT_CRON	0 * * * *	src/lib/jobs/logExportJob.ts	ప్రారంభించబడిన ప్రతి లాగ్-ఎక్స్పోర్ట్ గమ్యస్థానాన్ని ఖాళీ చేసే కాల్-లాగ్ ఎక్స్పోర్ట్ జాబ్ కోసం Cron ఎక్స్ప్రెషన్ (UTC).
OMNIROUTE_CONFIG_HOT_RELOAD_MS	5000	src/lib/config/hotReload.ts	కాన్ఫిగ్ హాట్-రీలోడ్ కోసం పోలింగ్ విరామం (ms). 1000 కంటే తక్కువ విలువ తిరస్కరించబడుతుంది.
OMNIROUTE_DISABLE_REDIS_AUTH_CACHE	(ప్రారంభించబడింది)	src/lib/db/apiKeys.ts	Redis-ఆధారిత API-key ఆథ్ క్యాష్ను దాటవేయడానికి 1గా సెట్ చేయండి (DB రీడ్లను బలవంతం చేస్తుంది).
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS	0	open-sse/services/compression/engines/rtk/filterLoader.ts	కఠినమైన సంతకం తనిఖీలు లేకుండా వినియోగదారు నిర్వహించే RTK ప్రాజెక్ట్ ఫిల్టర్ నియమాలను విశ్వసించండి.
OMNIROUTE_LITE_MAX_TOOL_LENGTH	2000	open-sse/services/compression/lite.ts	lite.maxToolLength సెట్ చేయనప్పుడు Lite ముందస్తు టూల్-ఫలిత సంక్షిప్తీకరణకు అక్షరాల పరిమితి. పరిధి 256–1000000. ఈ env కంటే డ్యాష్బోర్డ్ సెట్టింగ్కు ప్రాధాన్యం ఉంటుంది.
OMNI_COMPRESSION_WORKERS	2	open-sse/services/compression/compressionWorkerPool.ts	ఏకకాలంలో అమలయ్యే సింక్రోనస్ RTK/Caveman వర్కర్ల గరిష్ఠ సంఖ్య; అదనపు జాబ్లు FIFO క్రమంలో వేచి ఉంటాయి.
OMNI_COMPRESSION_WORKER_TIMEOUT_MS	120000	open-sse/services/compression/compressionWorkerPool.ts	ప్రతి జాబ్కు మిల్లీసెకన్లలో టైమ్అవుట్. టైమ్అవుట్ అయిన వర్కర్లు ముగించబడతాయి మరియు అభ్యర్థన ఎలాంటి మార్పులు లేకుండా ఫెయిల్-ఓపెన్ అవుతుంది.
OMNI_COMPRESSION_WORKER_IDLE_MS	60000	open-sse/services/compression/compressionWorkerPool.ts	ఉపయోగించని కంప్రెషన్ వర్కర్ను ముగించడానికి ముందు మిల్లీసెకన్లలో నిష్క్రియ జీవితకాలం.
COMPRESSION_PIPELINE_BREAKER_ENABLED	false	open-sse/services/compression/pipelineEngineBreaker.ts	T02 స్టాక్డ్-పైప్లైన్ ప్రతి-ఇంజిన్ సర్క్యూట్-బ్రేకర్ మాస్టర్ స్విచ్. ఎంపిక చేసుకోవాలి (డిఫాల్ట్గా ఆఫ్) — ఆన్లో ఉన్నప్పుడు, అభ్యర్థనలన్నింటిలో పదేపదే ఎర్రర్ ఇచ్చే ఇంజిన్ను కూల్డౌన్ వ్యవధి వరకు దాటవేస్తుంది (ఫెయిల్-ఓపెన్); ఆఫ్ = బైట్-స్థాయిలో ఒకేలా ఉండే లెగసీ ప్రవర్తన.
COMPRESSION_PIPELINE_BREAKER_THRESHOLD	3	open-sse/services/compression/pipelineEngineBreaker.ts	ఇంజిన్ బ్రేకర్ తెరవడానికి ముందు వరుసగా సంభవించాల్సిన క్రాస్-రిక్వెస్ట్ వైఫల్యాల సంఖ్య.
COMPRESSION_PIPELINE_BREAKER_COOLDOWN_MS	30000	open-sse/services/compression/pipelineEngineBreaker.ts	హాఫ్-ఓపెన్ ప్రోబ్కు ముందు తెరుచుకున్న ఇంజిన్ను దాటవేసే వ్యవధి, మిల్లీసెకన్లలో.
COMPRESSION_CCR_RETRIEVAL_RAMP_FACTOR	2	open-sse/services/compression/engines/ccr/index.ts	T08/H8 CCR రిట్రీవల్-ఫీడ్బ్యాక్ ర్యాంప్: నిల్వ చేసిన బ్లాక్ను ఇంతకుముందు రిట్రీవ్ చేసిన ప్రతిసారీ దాని ప్రభావవంతమైన minChars విలువ సరళరేఖీయంగా పెరుగుతుంది (తరచుగా రిట్రీవ్ చేసే కంటెంట్ తక్కువగా కంప్రెస్ అవుతుంది; >=3 రిట్రీవల్లు = ఎప్పటికీ కంప్రెస్ చేయబడదు). 1 ర్యాంప్ను నిలిపివేస్తుంది (థ్రెషోల్డ్ వద్ద మాత్రమే బైనరీ స్కిప్).
COMPRESSION_CCR_DURABLE_STORE	true	open-sse/services/compression/engines/ccr/index.ts	CCR మన్నికైన బ్లాక్ స్టోర్ (#9061). ఇన్-మెమరీ స్టోర్కు SQLite మద్దతును అందిస్తుంది, తద్వారా LRU తొలగింపు, TTL, పునఃప్రారంభం లేదా మరొక ఇన్స్టాన్స్కు చేరే రిట్రీవ్ తర్వాత కూడా బ్లాక్ నిలిచి ఉంటుంది. బ్లాక్లను మెమరీలో మాత్రమే ఉంచడానికి falseగా సెట్ చేయండి. 512KB కంటే ఎక్కువ పరిమాణమున్న బ్లాక్లు మరియు క్లౌడ్ రన్టైమ్లు ఏ సందర్భంలోనైనా మెమరీలో మాత్రమే ఉంటాయి.
COMPRESSION_PREFIX_FREEZE_ENABLED	false	open-sse/services/compression/prefixFreeze.ts	T08/H5 వినియోగ-పరిశీలిత ప్రిఫిక్స్ ఫ్రీజ్ ప్రధాన స్విచ్. ఎంచుకుంటేనే ప్రారంభమవుతుంది (డిఫాల్ట్గా ఆఫ్) — ఇది ఆన్లో ఉన్నప్పుడు, థ్రెషోల్డ్కు >= సార్లు పరిశీలించబడిన సిస్టమ్ ప్రాంప్ట్ను స్థిరమైన, క్యాష్ చేయదగిన ప్రిఫిక్స్గా పరిగణించి, స్థిర క్యాష్ హ్యూరిస్టిక్ గుర్తించని ప్రొవైడర్లకు కూడా కంప్రెషన్ నుంచి సంరక్షిస్తారు (ఫ్రీజ్ కేవలం సంరక్షిస్తుంది, ఎప్పుడూ మార్చదు).
COMPRESSION_PREFIX_FREEZE_THRESHOLD	3	open-sse/services/compression/prefixFreeze.ts	సిస్టమ్ ప్రాంప్ట్ను ఫ్రీజ్ చేసిన స్థిరమైన ప్రిఫిక్స్గా పరిగణించడానికి ముందు అవసరమైన పరిశీలనల సంఖ్య.
OMNIROUTE_BOOTSTRAPPED	false	src/app/(dashboard)/dashboard/page.tsx	ప్రారంభ సెటప్ తర్వాత బూట్స్ట్రాప్ స్క్రిప్ట్ ద్వారా trueగా సెట్ చేయబడుతుంది. సెటప్ విజార్డ్ కనిపించడాన్ని నియంత్రిస్తుంది.
OMNIROUTE_ALLOW_BODY_PROJECT_OVERRIDE	0	open-sse/executors/antigravity.ts	ప్రత్యామ్నాయ మార్గం: Antigravity ప్రాజెక్ట్ ఫీల్డ్ను రిక్వెస్ట్ బాడీ ఓవర్రైడ్ చేయడానికి అనుమతిస్తుంది.
ANTIGRAVITY_CREDITS	off	open-sse/services/antigravityCredits.ts	Google One AI క్రెడిట్ల విధానం: off ఎప్పుడూ క్రెడిట్లను చేర్చదు, retry అర్హతగల కోటా 429 తర్వాత ఒక్కసారి చేర్చుతుంది మరియు always మొదటి రిక్వెస్ట్లోనే చేర్చుతుంది.
ANTIGRAVITY_ALLOW_SIGNATURE_BYPASS	0	open-sse/translator/request/openai-to-gemini.ts	అప్స్ట్రీమ్ నిజమైన సిగ్నేచర్లను తిరస్కరించినప్పుడు, Antigravity రిక్వెస్ట్ ట్రాన్స్లేటర్ తన కఠినమైన CLI రిక్వెస్ట్-సిగ్నేచర్ ధ్రువీకరణను దాటవేయడానికి అనుమతిస్తుంది (డీబగ్/పురాతన-CLI మోడ్). సున్నా కాని విలువ బైపాస్ను ప్రారంభిస్తుంది.
AGY_TOKEN_FILE	~/.gemini/antigravity-cli/antigravity-oauth-token	src/app/api/providers/agy-auth/apply-local/route.ts	స్వయంచాలకంగా గుర్తించే స్థానిక లాగిన్ దిగుమతి కోసం Antigravity CLI (agy) టోకెన్-ఫైల్ పాత్ను ఓవర్రైడ్ చేస్తుంది.

OAuth CLI బ్రిడ్జ్ (అంతర్గతం)

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_SERVER	స్వయంచాలక గుర్తింపు	src/lib/oauth/config/index.ts	CLI↔OmniRoute ప్రామాణీకరణ బ్రిడ్జ్ కోసం సర్వర్ URL.
OMNIROUTE_TOKEN	(సెట్ చేయబడలేదు)	src/lib/oauth/config/index.ts	CLI బ్రిడ్జ్ కోసం ప్రామాణీకరణ టోకెన్.
OMNIROUTE_USER_ID	cli	src/lib/oauth/config/index.ts	CLI బ్రిడ్జ్ సెషన్ల కోసం వినియోగదారు ID.
SERVER_URL	(సెట్ చేయబడలేదు)	src/lib/oauth/config/index.ts	OMNIROUTE_SERVERకు లెగసీ అలియాస్.
CLI_TOKEN	(సెట్ చేయబడలేదు)	src/lib/oauth/config/index.ts	OMNIROUTE_TOKENకు లెగసీ అలియాస్.
CLI_USER_ID	(సెట్ చేయబడలేదు)	src/lib/oauth/config/index.ts	OMNIROUTE_USER_IDకు లెగసీ అలియాస్.

---

11. OAuth ప్రొవైడర్ క్రెడెన్షియల్స్

localhost డెవలప్మెంట్ కోసం అంతర్నిర్మిత క్రెడెన్షియల్స్. రిమోట్ డిప్లాయ్మెంట్ల కోసం, ప్రతి ప్రొవైడర్ డెవలపర్ కన్సోల్లో మీ స్వంత క్రెడెన్షియల్స్ను నమోదు చేయండి.

వేరియబుల్	ప్రొవైడర్	గమనికలు
CLAUDE_OAUTH_CLIENT_ID	Claude Code (Anthropic)	పబ్లిక్ క్లయింట్ — సీక్రెట్ అవసరం లేదు.
CLAUDE_CODE_REDIRECT_URI	Claude Code	రీడైరెక్ట్ URIని ఓవర్రైడ్ చేస్తుంది. డిఫాల్ట్: https://platform.claude.com/oauth/code/callback
CODEX_OAUTH_CLIENT_ID	Codex / OpenAI	పబ్లిక్ క్లయింట్.
GEMINI_OAUTH_CLIENT_ID	Gemini (Google)	సరిపోలే _SECRET అవసరం.
GEMINI_OAUTH_CLIENT_SECRET	Gemini (Google)	—
KIMI_CODING_OAUTH_CLIENT_ID	Kimi Coding (Moonshot)	పబ్లిక్ క్లయింట్.
ANTIGRAVITY_OAUTH_CLIENT_ID	Antigravity (Google)	సరిపోలే _SECRET అవసరం.
ANTIGRAVITY_OAUTH_CLIENT_SECRET	Antigravity (Google)	—
GITHUB_OAUTH_CLIENT_ID	GitHub Copilot	పబ్లిక్ క్లయింట్.
GHE_COPILOT_OAUTH_CLIENT_ID	GHE Copilot	GitHub Enterprise Copilot యొక్క OAuth క్లయింట్ ID కోసం ఐచ్ఛిక ఓవర్రైడ్. సెట్ చేయకపోతే GITHUB_OAUTH_CLIENT_ID యొక్క పబ్లిక్ డిఫాల్ట్కు ఫాల్బ్యాక్ అవుతుంది.
WINDSURF_API_KEY	Windsurf / Devin (v3.8)	ప్రతి కనెక్షన్కు సంబంధించిన క్రెడెన్షియల్ అందుబాటులో లేనప్పుడు open-sse/executors/devin-cli.ts ఉపయోగించే API కీ ఫాల్బ్యాక్. ఐచ్ఛికం.
CLI_DEVIN_BIN	Devin CLI (v3.8)	Devin CLI బైనరీ (devin)కి అనుకూల పాత్. open-sse/executors/devin-cli.ts ద్వారా పరిష్కరించబడుతుంది.
GITLAB_DUO_OAUTH_CLIENT_ID	GitLab Duo (v3.8)	GitLab Duo కోసం OAuth క్లయింట్ ID. https://gitlab.com/-/profile/applications వద్ద రీడైరెక్ట్ URIగా <NEXT_PUBLIC_BASE_URL>/callback, స్కోప్లుగా api, read_user, openid, profile, email ఉపయోగించి యాప్ను నమోదు చేయండి. GITLAB_OAUTH_CLIENT_IDకు ఫాల్బ్యాక్ అవుతుంది.
GITLAB_DUO_OAUTH_CLIENT_SECRET	GitLab Duo (v3.8)	GitLab Duo కోసం OAuth క్లయింట్ సీక్రెట్. ఐచ్ఛికం — PKCE ఫ్లోకు సీక్రెట్ అవసరం లేదు. GITLAB_OAUTH_CLIENT_SECRETకు ఫాల్బ్యాక్ అవుతుంది.
GITLAB_DUO_BASE_URL	GitLab Duo (v3.8)	GitLab బేస్ URLను ఓవర్రైడ్ చేస్తుంది (స్వయంగా హోస్ట్ చేసిన GitLab). డిఫాల్ట్గా https://gitlab.com ఉంటుంది. GITLAB_BASE_URLకు ఫాల్బ్యాక్ అవుతుంది.
GITLAB_BASE_URL	GitLab Duo (v3.8)	GITLAB_DUO_BASE_URL కోసం లెగసీ ఫాల్బ్యాక్. _DUO_ వేరియంట్ సెట్ చేయనప్పుడు ఉపయోగించబడుతుంది.
GITLAB_OAUTH_CLIENT_ID	GitLab Duo (v3.8)	src/lib/oauth/constants/oauth.ts ఉపయోగించే GITLAB_DUO_OAUTH_CLIENT_ID కోసం లెగసీ ఫాల్బ్యాక్.
GITLAB_OAUTH_CLIENT_SECRET	GitLab Duo (v3.8)	src/lib/oauth/constants/oauth.ts వినియోగించే GITLAB_DUO_OAUTH_CLIENT_SECRET కోసం లెగసీ ఫాల్బ్యాక్.
QODER_OAUTH_CLIENT_SECRET	Qoder	—
QODER_OAUTH_AUTHORIZE_URL	Qoder	Qoder OAuthను ప్రారంభించడానికి సెట్ చేయండి.
QODER_OAUTH_TOKEN_URL	Qoder	—
QODER_OAUTH_USERINFO_URL	Qoder	—
QODER_OAUTH_CLIENT_ID	Qoder	—
QODER_PERSONAL_ACCESS_TOKEN	Qoder	ప్రత్యక్ష API కీ ఫాల్బ్యాక్ (OAuthను దాటవేస్తుంది).
QODER_CLI_WORKSPACE	Qoder	Qoder CLI కోసం వర్క్స్పేస్ ID.
OMNIROUTE_QODER_WORKSPACE	Qoder	QODER_CLI_WORKSPACEకు మారుపేరు.
QODER_CLI_CONFIG_DIR	Qoder	Qoder CLI కాన్ఫిగరేషన్ డైరెక్టరీని ఓవర్రైడ్ చేస్తుంది (వేరుచేయబడిన PAT సెషన్, బ్రౌజర్ లాగిన్ను ఓవర్రైట్ చేయకుండా నివారిస్తుంది).
BLACKBOX_WEB_VALIDATED_TOKEN	Blackbox Web	/api/chatలో validatedగా పంపాల్సిన ఫ్రంటెండ్ tk టోకెన్. Blackbox టోకెన్ సరిపోలికను తప్పనిసరి చేసినప్పుడు ఇది అవసరం; లేకపోతే OmniRoute యాదృచ్ఛిక UUIDను ఫాల్బ్యాక్గా ఉపయోగిస్తుంది. సమస్య #2252 చూడండి.
VISION_BRIDGE_BASE_URL	Vision Bridge గార్డ్రైల్	Anthropic కాని విజన్-బ్రిడ్జ్ కాల్ల కోసం OpenAI-అనుకూల బేస్ URL. ఇది డిఫాల్ట్గా లెగసీ OpenAI URL env లేదా api.openai.comను ఉపయోగిస్తుంది. OmniRoute యొక్క /v1 సెల్ఫ్-లూప్ లేదా ఏదైనా OpenAI-అనుకూల ఎండ్పాయింట్ను (Gemini OpenAI-compat, OpenRouter) సూచించేలా సెట్ చేయండి. సమస్య #2232. URL OmniRoute యొక్క స్వంత /v1 అయినప్పుడు, describe ఉప-అభ్యర్థన x-omniroute-admission-bypass: internalను పంపుతుంది మరియు పరిష్కరించబడిన సెల్ఫ్-లూప్ క్రెడెన్షియల్తో (స్థానిక మోడ్లో sk_omniroute సెంటినెల్ లేదా OMNIROUTE_API_KEY / ROUTER_API_KEY — #1350) ప్రమాణీకరిస్తుంది, తద్వారా REQUIRE_API_KEY=true డిప్లాయ్మెంట్లు పనిచేస్తాయి.
VISION_BRIDGE_API_KEY	Vision Bridge గార్డ్రైల్	పైన ఉన్న URL కోసం API కీ. Anthropic కాని విజన్-బ్రిడ్జ్ కాల్ల కోసం ప్రతి ప్రొవైడర్కు చెందిన OpenAI / Google env వేరియబుల్లను ఓవర్రైడ్ చేస్తుంది. Anthropic మోడల్లు వాటి ప్రత్యేక Anthropic కీ పాత్ను కొనసాగిస్తాయి. సమస్య #2232.

Warning

1. Google Cloud Console → Credentialsకు వెళ్లండి
2. OAuth 2.0 Client IDని సృష్టించండి (రకం: "వెబ్ అప్లికేషన్")
3. మీ సర్వర్ URLను Authorized redirect URIగా జోడించండి
4. .envలోని క్రెడెన్షియల్ విలువలను భర్తీ చేయండి.

---

12. ప్రొవైడర్ User-Agent ఓవర్రైడ్లు

ప్రతి అప్స్ట్రీమ్ ప్రొవైడర్కు పంపే User-Agent హెడర్ను ఓవర్రైడ్ చేయండి. ఇది రన్టైమ్లో ఎగ్జిక్యూటర్ బేస్ క్లాస్ ద్వారా డైనమిక్గా పరిష్కరించబడుతుంది:

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

మూలం: open-sse/executors/base.ts → buildHeaders()

వేరియబుల్	డిఫాల్ట్ విలువ	ఎప్పుడు అప్డేట్ చేయాలి
CLAUDE_USER_AGENT	claude-cli/2.1.258 (external, cli)	Anthropic కొత్త CLI వెర్షన్ను విడుదల చేసినప్పుడు
CLAUDE_DISABLE_TOOL_NAME_CLOAK	false	executors/base.ts + executors/cliproxyapi.ts	Anthropicకు సంబంధించిన రెండు పాత్లలోనూ (నేటివ్ OAuth మరియు CLIProxyAPI) థర్డ్-పార్టీ హార్నెస్ టూల్ పేర్లను యథాతథంగా ఫార్వర్డ్ చేయడానికి 1/trueకు సెట్ చేయండి. డిఫాల్ట్గా, ఎగ్జిక్యూటర్ Claude-Code కాని టూల్ పేర్లకు నిర్ణయాత్మకంగా మారుపేర్లను కేటాయిస్తుంది (ఉనికిలో ఉన్నప్పుడు Claude Code ప్రామాణిక మ్యాపింగ్, లేకపోతే PascalCase) మరియు ప్రతిస్పందనలో _toolNameMap ద్వారా వాటిని తిరిగి అసలు పేర్లకు మారుస్తుంది; అందువల్ల snake_case టూల్స్ ఉన్న హార్నెస్లు ఫింగర్ప్రింట్ చేయబడిన థర్డ్-పార్టీ క్లయింట్లుగా తిరస్కరించబడవు. డీబగ్గింగ్ కోసం మాత్రమే.
CODEX_USER_AGENT	codex-cli/0.142.0 (Windows 10.0.26200; x64)	OpenAI Codex CLIని అప్డేట్ చేసినప్పుడు
CODEX_CLIENT_VERSION	0.131.0	పూర్తి UA స్ట్రింగ్తో సంబంధం లేకుండా Codex క్లయింట్ వెర్షన్ను ఓవర్రైడ్ చేయండి
CLAUDE_CODE_CLIENT_VERSION	2.1.258	CLAUDE_USER_AGENTతో సంబంధం లేకుండా ప్రకటించే Claude Code వెర్షన్ను ఓవర్రైడ్ చేయండి. Anthropic కొన్ని మోడళ్లకు ఈ విలువ ఆధారంగా యాక్సెస్ను నియంత్రిస్తుంది (#12417).
GITHUB_COPILOT_CLI_VERSION	1.0.81-6	GITHUB_USER_AGENTతో సంబంధం లేకుండా ప్రకటించే Copilot CLI వెర్షన్ను ఓవర్రైడ్ చేయండి
GITHUB_USER_AGENT	GitHubCopilotChat/0.54.0	GitHub Copilot Chat అప్డేట్ అయినప్పుడు
ANTIGRAVITY_USER_AGENT	antigravity/2.0.1 darwin/arm64	Antigravity IDE అప్డేట్ అయినప్పుడు
KIRO_USER_AGENT	AWS-SDK-JS/3.0.0 kiro-ide/1.0.0	Kiro IDE అప్డేట్ అయినప్పుడు
KIRO_OAUTH_CLIENT_ID	kiro-cli	Kiro సోషల్ డివైస్-కోడ్ clientIdను (పబ్లిక్ id) ఓవర్రైడ్ చేయండి
KIRO_VERIFY_FULL_CRC	false	ఎంపికగా ప్రారంభించండి: Kiro ఈవెంట్ స్ట్రీమ్లో ప్రతి ఫ్రేమ్కు పూర్తి మెసేజ్ CRC ధ్రువీకరణ (పాడైన స్ట్రీమ్లను డీబగ్ చేయడానికి)
QODER_USER_AGENT	Qoder-Cli	Qoder CLI అప్డేట్ అయినప్పుడు
CURSOR_USER_AGENT	Cursor/3.3	Cursor అప్డేట్ అయినప్పుడు

Tip

{PROVIDER_ID}_USER_AGENT నమూనాను ఉపయోగించి మీరు ఏ ప్రొవైడర్కైనా User-Agent ఓవర్రైడ్లను జోడించవచ్చు. ఎగ్జిక్యూటర్ env var పేరును డైనమిక్గా నిర్మిస్తుంది.

---

13. CLI ఫింగర్ప్రింట్ అనుకూలత

ప్రారంభించినప్పుడు, అధికారిక CLI సాధనాల ఖచ్చితమైన సిగ్నేచర్తో సరిపోలడానికి OmniRoute HTTP హెడర్లను మరియు JSON బాడీ ఫీల్డ్లను తిరిగి క్రమబద్ధీకరిస్తుంది. ఇది మీ ప్రాక్సీ IPని అలాగే ఉంచుతూ, ఖాతా ఫ్లాగ్ చేయబడే ప్రమాదాన్ని తగ్గిస్తుంది.

మూలం: open-sse/config/cliFingerprints.ts, open-sse/executors/base.ts

ప్రొవైడర్కు విడిగా

వేరియబుల్	సక్రియం చేయడం	ప్రభావం
CLI_COMPAT_CODEX	=1	Codex CLI అభ్యర్థన సిగ్నేచర్ను అనుకరిస్తుంది
CLI_COMPAT_CLAUDE	=1	Claude Code అభ్యర్థన సిగ్నేచర్ను అనుకరిస్తుంది
CLI_COMPAT_GITHUB	=1	GitHub Copilot అభ్యర్థన సిగ్నేచర్ను అనుకరిస్తుంది
CLI_COMPAT_ANTIGRAVITY	=1	Antigravity అభ్యర్థన సిగ్నేచర్ను అనుకరిస్తుంది
CLI_COMPAT_CURSOR	=1	Cursor అభ్యర్థన సిగ్నేచర్ను అనుకరిస్తుంది
CLI_COMPAT_KIMI_CODING	=1	Kimi Coding అభ్యర్థన సిగ్నేచర్ను అనుకరిస్తుంది
CLI_COMPAT_KILOCODE	=1	Kilo Code అభ్యర్థన సిగ్నేచర్ను అనుకరిస్తుంది
CLI_COMPAT_CLINE	=1	Cline అభ్యర్థన సిగ్నేచర్ను అనుకరిస్తుంది

గ్లోబల్

వేరియబుల్	సక్రియం చేయడం	ప్రభావం
CLI_COMPAT_ALL	=1	అన్ని ప్రొవైడర్లకు ఫింగర్ప్రింట్ అనుకూలతను ఒకేసారి ప్రారంభిస్తుంది.

Kimi Coding CLI గుర్తింపు ఓవర్రైడ్లు

వేరియబుల్	డిఫాల్ట్	మూల ఫైల్	వివరణ
KIMI_CLI_VERSION	1.36.0	src/lib/oauth/providers/kimi-coding.ts	OAuth/API కాల్ల సమయంలో పంపే Kimi CLI వెర్షన్ను ఓవర్రైడ్ చేస్తుంది.
KIMI_CODING_DEVICE_ID	(సంగ్రహించిన డిఫాల్ట్)	src/lib/oauth/providers/kimi-coding.ts	క్లయింట్ హెడర్లలో ఉపయోగించే సంగ్రహించిన Kimi పరికర IDని ఓవర్రైడ్ చేస్తుంది.

Note

ఈ ఫీచర్ User-Agent ఓవర్రైడ్లతో (§12) కలిసి పనిచేస్తుంది. ఫింగర్ప్రింట్ సిస్టమ్ హెడర్ల క్రమాన్ని మరియు బాడీ ఫీల్డ్ల క్రమాన్ని నిర్వహిస్తే, User-Agent ఓవర్రైడ్లు నిర్దిష్ట UA స్ట్రింగ్ను నిర్వహిస్తాయి. రెండింటినీ స్వతంత్రంగా ప్రారంభించవచ్చు.

---

14. API కీ ప్రొవైడర్లు

ప్రత్యక్ష ప్రామాణీకరణను ఉపయోగించే ప్రొవైడర్ల కోసం API కీలు. సిఫార్సు చేయబడిన సెటప్: Dashboard → Providers → Add API Key.

Docker లేదా హెడ్లెస్ డిప్లాయ్మెంట్ల కోసం ఎన్విరాన్మెంట్ వేరియబుల్ల ద్వారా సెట్ చేయడం ఒక ప్రత్యామ్నాయం.

గుర్తించబడే నమూనా: {PROVIDER_ID}_API_KEY

వేరియబుల్	ప్రొవైడర్
DEEPSEEK_API_KEY	DeepSeek
NVIDIA_API_KEY	NVIDIA NIM
JINA_AI_API_KEY	Jina AI (Foundation API + Reader ఫాల్బ్యాక్)
JINA_API_KEY	Jina AI (JINA_AI_API_KEYకు మారుపేరు)
GEMINI_API_KEY	Gemini (Google AI Studio) ఎంబెడింగ్లు + చాట్ ఫాల్బ్యాక్
GOOGLE_API_KEY	Gemini (GEMINI_API_KEYకు మారుపేరు)

Note

రన్టైమ్ ఇకపై వాటిని చదవనందున, Groq, xAI, Mistral, Perplexity, Together AI, Fireworks, Cerebras, Cohere, Nebius మరియు Qianfan కోసం ఉన్న స్థిరమైన ${PROVIDER}_API_KEY ఎంట్రీలు v3.8.0లో తొలగించబడ్డాయి — ఆ ప్రొవైడర్లు ప్రత్యేకంగా Dashboard / data/provider-credentials.json / ఎన్క్రిప్ట్ చేసిన DBపై ఆధారపడతారు. మైగ్రేషన్ మార్గం కోసం ఈ డాక్యుమెంట్ దిగువన ఉన్న ఆడిట్: తొలగించబడిన / నిరుపయోగ వేరియబుల్లు విభాగాన్ని చూడండి.

Tip

Dashboard ద్వారా సెట్ చేసిన కీలు SQLiteలో ఎన్క్రిప్ట్ చేసి నిల్వ చేయబడతాయి మరియు ఎన్విరాన్మెంట్ వేరియబుల్ల కంటే ప్రాధాన్యత పొందుతాయి.

Jina: Dashboardలో jina-ai (లేదా భాగస్వామ్య jina-reader) కనెక్షన్ ఉన్నప్పుడు, jina-ai/… ఎంబెడింగ్లు, రీర్యాంక్, క్లాసిఫై, సెగ్మెంట్ మరియు jina-search క్లస్టర్ ఎన్విరాన్మెంట్ కీపై బిల్ విధించవు — getProviderCredentials ఫిల్-ఫస్ట్ విధానాన్ని అనుసరిస్తుంది. ఉపయోగించగల Dashboard కీ లేనప్పుడు మాత్రమే JINA_AI_API_KEY / JINA_API_KEY ఉపయోగించబడతాయి. కాల్ లాగ్లు ఎన్విరాన్మెంట్ ఫాల్బ్యాక్ను connection_id=env:JINA_AI_API_KEYగా సూచిస్తాయి. Reader కార్డ్ (jina-reader, r.jina.ai) ఎప్పుడూ /v1/embeddings లేదా /v1/rerankను అందించదు.

Gemini: gemini/gemini-embedding-2 (google/gemini-embedding-2 అనే మారుపేరు) ముందుగా Dashboardలోని gemini కనెక్షన్ను ఉపయోగిస్తుంది. ఉపయోగించగల Dashboard కీ లేనప్పుడు మాత్రమే GEMINI_API_KEY / GOOGLE_API_KEY ఉపయోగించబడతాయి. కాల్ లాగ్లు ఎన్విరాన్మెంట్ ఫాల్బ్యాక్ను connection_id=env:GEMINI_API_KEYగా సూచిస్తాయి. స్థానిక మల్టీమోడల్ ట్రాఫిక్ :embedContent / :batchEmbedContentsకు వ్యతిరేకంగా x-goog-api-keyని ఉపయోగిస్తుంది — N OpenAI input అంశాలు N వెక్టర్లుగా మారతాయి.

---

15. టైమ్అవుట్ సెట్టింగ్లు

అన్ని విలువలు మిల్లీసెకన్లలో ఉంటాయి. కేంద్రీకృత పరిష్కారం src/shared/utils/runtimeTimeouts.tsలో ఉంటుంది.

టైమ్అవుట్ శ్రేణి

REQUEST_TIMEOUT_MS (గ్లోబల్ ఓవర్రైడ్)
├─→ FETCH_TIMEOUT_MS (అప్స్ట్రీమ్ ప్రొవైడర్ కాల్లు, డిఫాల్ట్: 600000)
│   ├─→ FETCH_HEADERS_TIMEOUT_MS (FETCH_TIMEOUT_MS నుండి సంక్రమిస్తుంది)
│   ├─→ FETCH_BODY_TIMEOUT_MS (FETCH_TIMEOUT_MS నుండి సంక్రమిస్తుంది)
│   ├─→ TLS_CLIENT_TIMEOUT_MS (FETCH_TIMEOUT_MS నుండి సంక్రమిస్తుంది)
│   │   └── TLS_FIRST_BYTE_WATCHDOG_MS (స్వతంత్రం, డిఫాల్ట్: 10000)
│   ├── RESPONSES_FIRST_BYTE_TIMEOUT_MS (స్వతంత్రం, డిఫాల్ట్: 15000)
│   ├── FETCH_CONNECT_TIMEOUT_MS (స్వతంత్రం, డిఫాల్ట్: 30000)
│   └── FETCH_KEEPALIVE_TIMEOUT_MS (స్వతంత్రం, డిఫాల్ట్: 4000)
├─→ STREAM_IDLE_TIMEOUT_MS (REQUEST_TIMEOUT_MS నుండి సంక్రమిస్తుంది, డిఫాల్ట్: 600000)
├─→ STREAM_ACTIVE_TIMEOUT_MS (స్వతంత్రం, డిఫాల్ట్: 1260000; 0 నిలిపివేస్తుంది)
├─→ STREAM_READINESS_TIMEOUT_MS (REQUEST_TIMEOUT_MS నుండి సంక్రమిస్తుంది, డిఫాల్ట్: 80000)
├─→ STREAM_READINESS_MAX_TIMEOUT_MS (అనుకూల సిద్ధత పొడిగింపులను పరిమితం చేస్తుంది, డిఫాల్ట్: 180000)
└─→ API_BRIDGE_PROXY_TIMEOUT_MS (REQUEST_TIMEOUT_MS నుండి సంక్రమిస్తుంది, డిఫాల్ట్: 30000)
    ├─→ API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS (ఉత్పన్నమైనది, డిఫాల్ట్: 300000)
    ├── API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS (డిఫాల్ట్: 60000)
    ├── API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS (డిఫాల్ట్: 5000)
    └── API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS (డిఫాల్ట్: 0 = నిలిపివేయబడింది)

వేరియబుల్	డిఫాల్ట్	వివరణ
REQUEST_TIMEOUT_MS	(సెట్ చేయబడలేదు)	గ్లోబల్ షార్ట్కట్ — FETCH_TIMEOUT_MS మరియు STREAM_IDLE_TIMEOUT_MS రెండింటి డిఫాల్ట్లను ఓవర్రైడ్ చేస్తుంది.
FETCH_TIMEOUT_MS	600000	అప్స్ట్రీమ్ ప్రొవైడర్ కాల్ల కోసం మొత్తం HTTP అభ్యర్థన గడువు.
STREAM_IDLE_TIMEOUT_MS	600000	రద్దు చేయడానికి ముందు ముడి అప్స్ట్రీమ్ బైట్ల మధ్య అనుమతించబడే గరిష్ఠ నిశ్శబ్ద సమయం. విస్తృతంగా ఆలోచించే మోడల్లు అరుదుగా >90s పాటు విరామం తీసుకుంటాయి.
STREAM_ACTIVE_TIMEOUT_MS	1260000	మొత్తం యాక్టివ్ SSE స్ట్రీమ్కు గరిష్ఠ జీవితకాలం; అప్స్ట్రీమ్ బైట్లపై ఎప్పటికీ రీసెట్ అవదు మరియు REQUEST_TIMEOUT_MSతో సంబంధం లేకుండా స్వతంత్రంగా ఉంటుంది. రిజిస్ట్రీలోని అతిపెద్ద ప్రతి-మోడల్ timeoutMs (1200000, Codex)కు 60000 మార్జిన్ను జోడించి నిర్ణయించబడింది, తద్వారా పూర్తి బడ్జెట్ వరకు అమలు కావడానికి అనుమతించబడిన మోడల్ సమాధానం మధ్యలో ఎప్పటికీ నిలిపివేయబడదు. నిలిపివేయడానికి 0గా సెట్ చేయండి.
OMNIROUTE_SSE_COMMENTS	(నిలిపివేయబడింది)	OmniRoute SSE : వ్యాఖ్య పంక్తులను (ఉదా. : keepalive హార్ట్బీట్ మరియు x-omniroute-* మెటాడేటా ట్రైలర్లు) విడుదల చేయవచ్చా లేదా అనేది. కఠినమైన OpenAI-అనుకూల క్లయింట్లు ప్రతి SSE పంక్తిపై JSON.parse చేసి, : వ్యాఖ్యల వద్ద క్రాష్ అవుతాయి కాబట్టి డిఫాల్ట్గా నిలిపివేయబడింది (#10524); data: హార్ట్బీట్లపై ప్రభావం ఉండదు. తిరిగి ప్రారంభించడానికి on/true/1/yesగా సెట్ చేయండి. open-sse/utils/sseHeartbeat.ts ద్వారా ఉపయోగించబడుతుంది.
STREAM_READINESS_TIMEOUT_MS	80000	మొదటి పింగ్-కాని SSE ఈవెంట్ను స్వీకరించడానికి అనుమతించబడే సమయం. సెట్ చేసినప్పుడు REQUEST_TIMEOUT_MSను వారసత్వంగా పొందుతుంది.
STREAM_READINESS_MAX_TIMEOUT_MS	180000	పెద్ద, టూల్లు అధికంగా ఉపయోగించే లేదా అధిక-రీజనింగ్ స్ట్రీమింగ్ అభ్యర్థనల కోసం గరిష్ఠ అనుకూల మొదటి-ఈవెంట్ సిద్ధత వ్యవధి.
OMNIROUTE_AGENT_GOAL_POLICY_ENABLED	true	/goal హ్యూరిస్టిక్ కోసం కిల్-స్విచ్. గుర్తింపును పూర్తిగా నిలిపివేయడానికి false/0/offగా సెట్ చేయండి — అభ్యర్థన బాడీ/హెడర్ల ఆధారంగా సిద్ధత గడువులు మరియు స్ట్రీమ్ రికవరీ ఎప్పటికీ పెంచబడవు, తద్వారా క్లయింట్-నియంత్రిత గడువు విస్తరణను తగ్గిస్తుంది.
OMNIROUTE_AGENT_GOAL_READINESS_MAX_TIMEOUT_MS	600000	గుర్తించబడిన /goal ఏజెంట్ రన్లు లేదా x-omniroute-agent-goalతో బలవంతంగా అమలు చేయబడిన అభ్యర్థనల కోసం గరిష్ఠ మొదటి-ఈవెంట్ సిద్ధత వ్యవధి.
OMNIROUTE_AGENT_GOAL_STREAM_RECOVERY	true	గుర్తించబడిన /goal ఏజెంట్ రన్ల కోసం ముందస్తు స్ట్రీమ్ రికవరీని స్వయంచాలకంగా ప్రారంభిస్తుంది. లక్ష్య-నిర్దిష్ట ఆప్ట్-ఇన్ను నిలిపివేయడానికి false/0/offగా సెట్ చేయండి. ఇది ఆపరేటర్ డిఫాల్ట్కు అదనంగా రికవరీని మాత్రమే జోడించగలదు — స్పష్టమైన STREAM_RECOVERY_ENABLED/DB సెట్టింగ్ల ఆప్ట్-అవుట్ను ఎప్పటికీ ఓవర్రైడ్ చేయదు.
OMNIROUTE_CODEX_DROP_NONSTANDARD_EVENTS	true	OpenAI SDK యొక్క responses.stream()ను 502తో విఫలం చేసే ప్రామాణికం కాని codex.* SSE ఈవెంట్లను (ఉదా. codex.rate_limits) తొలగిస్తుంది. డిఫాల్ట్గా ఆన్లో ఉంటుంది (#11014). వాటిని ఫార్వర్డ్ చేయడానికి 0/false/no/offగా సెట్ చేయండి.
OMNIROUTE_CODEX_APPSERVER_WS	(సెట్ చేయబడలేదు)	ఆప్ట్-ఇన్ Codex app-server ట్రాన్స్పోర్ట్. స్థానిక codex app-server సైడ్కార్ యొక్క WebSocket ఎండ్పాయింట్ (ws:///wss://). దీన్ని టోకెన్తో కలిపి సెట్ చేసినప్పుడు, Codex అభ్యర్థనలు HTTP Responses APIకు బదులుగా JSON-RPC ద్వారా సైడ్కార్కు రూట్ చేయబడతాయి. ప్రతి కనెక్షన్కు providerSpecificData.codexAppServerUrl ద్వారా కూడా సెట్ చేయవచ్చు. open-sse/executors/codex/appServerConfig.ts ద్వారా ఉపయోగించబడుతుంది.
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN	(సెట్ చేయబడలేదు)	app-serverకు సమర్పించబడే ఇన్లైన్ సామర్థ్య/బేరర్ టోకెన్. ప్రతి కనెక్షన్కు ఓవర్రైడ్: providerSpecificData.codexAppServerToken.
OMNIROUTE_CODEX_APPSERVER_WS_TOKEN_FILE	(సెట్ చేయబడలేదు)	app-server సామర్థ్య టోకెన్ను (codex app-server --ws-token-file నుండి) కలిగి ఉన్న ఫైల్కు పాత్. OMNIROUTE_CODEX_APPSERVER_WS_TOKEN సెట్ చేయనప్పుడు ఉపయోగించబడుతుంది. ప్రతి కనెక్షన్కు ఓవర్రైడ్: providerSpecificData.codexAppServerTokenFile.
OMNIROUTE_CODEX_APPSERVER_CWD	/tmp	app-server టర్న్ అమలయ్యే వర్కింగ్ డైరెక్టరీ. ప్రతి కనెక్షన్కు ఓవర్రైడ్: providerSpecificData.codexAppServerCwd.
OMNIROUTE_CODEX_APPSERVER_APPROVAL	(సెట్ చేయబడలేదు)	app-server టర్న్కు పంపబడే ఆమోద విధానం (ఉదా. never, on-request). ప్రతి కనెక్షన్కు ఓవర్రైడ్: providerSpecificData.codexAppServerApprovalPolicy.
OMNIROUTE_CODEX_APPSERVER_SANDBOX	(సెట్ చేయబడలేదు)	app-server టర్న్కు పంపబడే శాండ్బాక్స్ విధానం (ఉదా. read-only, workspace-write, danger-full-access). సెట్ చేయనప్పుడు ఎగ్జిక్యూటర్ డిఫాల్ట్గా workspace-writeను ఉపయోగిస్తుంది (మరింత సురక్షితమైనది; గతంలో danger-full-access). ప్రతి కనెక్షన్కు ఓవర్రైడ్: providerSpecificData.codexAppServerSandbox.
OMNIROUTE_CODEX_APPSERVER_AUTO_APPROVE	false	app-server యొక్క స్వంత ఆమోద ప్రాంప్ట్లను (హోస్ట్పై కమాండ్/ఫైల్/అనుమతి అమలు) స్వయంచాలకంగా ఆమోదిస్తుంది. డిఫాల్ట్గా ఆఫ్లో ఉంటుంది — ప్రాంప్ట్లు స్వయంచాలకంగా తిరస్కరించబడతాయి; హార్నెస్ టూల్ కాల్లపై ప్రభావం ఉండదు (అవి ప్రత్యేక item/tool/call పాస్త్రూ ద్వారా ప్రయాణిస్తాయి). true/1/yesను అంగీకరిస్తుంది. ప్రతి కనెక్షన్కు ఓవర్రైడ్: providerSpecificData.codexAppServerAutoApprove.
FETCH_HEADERS_TIMEOUT_MS	= FETCH_TIMEOUT_MS	ప్రతిస్పందన హెడర్లను స్వీకరించడానికి అనుమతించబడే సమయం.
OMNIROUTE_DIRECT_HEADERS_TIMEOUT_MS	30000 (30s)	ప్రతి ప్రత్యక్ష no-proxy ప్రయత్నానికి ప్రతిస్పందన ప్రారంభం కోసం గరిష్ఠ నిరీక్షణ సమయం (ms). సమయం ముగిసినప్పుడు తాజా socketపై ఒకసారి మళ్లీ ప్రయత్నిస్తుంది; ఈ పరిమితిని నిలిపివేసి మునుపటి ప్రవర్తనను కొనసాగించడానికి 0గా సెట్ చేయండి.
FETCH_BODY_TIMEOUT_MS	= FETCH_TIMEOUT_MS	పూర్తి ప్రతిస్పందన bodyని స్వీకరించే సమయం.
FETCH_CONNECT_TIMEOUT_MS	30000	TCP connection ఏర్పాటు గడువు.
FETCH_KEEPALIVE_TIMEOUT_MS	4000	Keep-alive socket నిష్క్రియ గడువు.
TLS_CLIENT_TIMEOUT_MS	= FETCH_TIMEOUT_MS	TLS fingerprint proxy (wreq-js) గడువు.
TLS_FIRST_BYTE_WATCHDOG_MS	10000	ప్రత్యేకంగా wreq-js TLS-fingerprint transport bodyలో మొదటి byte అందుకునే సమయాన్ని పరిమితం చేస్తుంది; headers వచ్చిన వెంటనే ఇది resolve అవుతుంది కాబట్టి నిలిచిపోయిన bodyని TLS_CLIENT_TIMEOUT_MS ఒక్కటే గుర్తించలేదు (#12656). సమయం ముగిసినప్పుడు wreq readerని రద్దుచేసి direct/proxy dispatcherకు తిరిగి వెళ్తుంది; 0 watchdogను నిలిపివేస్తుంది.
RESPONSES_FIRST_BYTE_TIMEOUT_MS	15000	OpenCode executorకు మాత్రమే, అలాగే OPENCODE_RESPONSES_STALL_ROTATION feature flag ఆన్లో ఉన్నప్పుడు మాత్రమే (డిఫాల్ట్గా ఆఫ్): streamed Responses reply headers వచ్చిన తర్వాత మొదటి body byte కోసం నిరీక్షణను పరిమితం చేస్తుంది (#13484). Responses stream response.createdతో తెరుచుకుంటుంది, కాబట్టి ఈ వ్యవధి దాటినా ఏమీ రాకపోతే అది stall: accountకు cooldown వర్తింపజేసి requestను తదుపరి accountకు ఒకసారి మారుస్తుంది; రెండో stall సంభవిస్తే వెంటనే విఫలమవుతుంది. flag ఆన్లో ఉన్నప్పటికీ 0 guardను నిలిపివేస్తుంది.
API_BRIDGE_PROXY_TIMEOUT_MS	30000	/v1 bridge requests కోసం proxy hop గడువు.
FIRECRAWL_BASE_URL	https://api.firecrawl.dev	Firecrawl web-fetch executorను self-hosted instanceకు మళ్లించండి (off-cloudలో API key ఐచ్ఛికం).
FIRECRAWL_TIMEOUT_MS	30000	Firecrawl web-fetch executor కోసం ఒక్కో request గడువు.
API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS	300000	bridge కోసం మొత్తం server request గడువు.
API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS	60000	bridge ద్వారా response headersను పంపే సమయం.
API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS	5000	Bridge keep-alive నిష్క్రియ గడువు.
API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS	0	ముడి socket గడువు (0 = నిలిపివేయబడింది).
SHUTDOWN_TIMEOUT_MS	30000	బలవంతంగా నిష్క్రమించే ముందు SIGTERM/SIGINTపై అనుమతించే grace period.
OMNIROUTE_DEFAULT_FETCH_TIMEOUT_MS	120000	FETCH_TIMEOUT_MS సెట్ చేయనప్పుడు src/shared/utils/fetchTimeout.ts ఉపయోగించే fallback.
OMNIROUTE_PROVIDER_PROBE_TIMEOUT_MS	8000	src/shared/network/safeOutboundFetch.tsలోని validationRead మరియు modelsProbe presets కోసం గడువు (ms). dashboardలో active/error మధ్య అస్థిరంగా మారడాన్ని నివారించడానికి నెమ్మదైన endpoints (Cerebras, Cloudflare AI, Groq) కోసం దీన్ని పెంచండి. చెల్లని (<1000) లేదా సంఖ్యాత్మకం కాని విలువలకు 8000msకు fallback అవుతుంది.
OMNIROUTE_RELAY_FETCH_TIMEOUT_MS	25000	open-sse/utils/proxyFetch.tsలో relay-నిర్దిష్ట fetch గడువు (#9158). callersకు సాధారణ upstream timeoutకు బదులుగా relay-నిర్దిష్ట failure కనిపించేలా, నిలిచిపోయిన relay తప్పనిసరిగా client/agent timeout (~30s)కు ముందే విఫలం కావాలి. ఇది ఎల్లప్పుడూ ముందుగా అమలయ్యేలా 29000 వద్ద పరిమితం చేయబడింది.
OMNIROUTE_RETRY_BACKOFF_MS	10	open-sse/utils/proxyFetch.tsలోని direct/relay/proxy ఒకసారి-మళ్లీ-ప్రయత్నించే మార్గాల కోసం ఉమ్మడి retry backoff (#9158). 0 = వెంటనే మళ్లీ ప్రయత్నించండి.
OMNIROUTE_CLAUDE_TLS_TIMEOUT_MS	60000	స్థానిక wreq-js request గడువు (claudeTlsClient.ts).
OMNIROUTE_CLAUDE_TLS_GRACE_MS	10000	స్థానిక timeoutకు అదనంగా జోడించే సంపూర్ణ JS hard-deadline grace.
OMNIROUTE_PPLX_TLS_TIMEOUT_MS	30000	స్థానిక wreq-js request గడువు (perplexityTlsClient.ts).
OMNIROUTE_PPLX_TLS_GRACE_MS	10000	స్థానిక timeoutకు అదనంగా జోడించే సంపూర్ణ JS hard-deadline grace.
OMNIROUTE_PPLX_SEARCH_HINT	0 (ఆఫ్)	కాలర్ యొక్క సిస్టమ్ సందేశానికి "మీకు అంతర్నిర్మిత వెబ్ శోధన ఉంది. శోధన ఫలితాలను ఉపయోగించి ప్రశ్నలకు నేరుగా సమాధానం ఇవ్వండి." అని జోడిస్తుంది (perplexity-web/protocol.ts). డిఫాల్ట్గా ఆఫ్లో ఉంటుంది — Perplexity ఏమైనప్పటికీ శోధిస్తుంది, అలాగే ఈ వాక్యం కోడింగ్ క్లయింట్ల ప్రత్యుత్తరాల్లో మెటా-వ్యాఖ్యగా కనిపిస్తుంది. తిరిగి ప్రారంభించడానికి 1/true/yes/on సెట్ చేయండి.
OMNIROUTE_GROK_TLS_TIMEOUT_MS	60000	స్థానిక wreq-js అభ్యర్థన గడువు (grokTlsClient.ts).
OMNIROUTE_GROK_TLS_GRACE_MS	10000	స్థానిక గడువుకు అదనంగా జోడించే సంపూర్ణ JS కఠిన గడువు సడలింపు.
OMNIROUTE_NOTION_TLS_TIMEOUT_MS	30000	స్థానిక wreq-js అభ్యర్థన గడువు (notionTlsClient.ts); సుదీర్ఘ జనరేషన్ల కోసం notion-web దీన్ని ప్రతి అభ్యర్థనకు 180000కు పెంచుతుంది.
OMNIROUTE_NOTION_TLS_GRACE_MS	10000	స్థానిక గడువుకు అదనంగా జోడించే సంపూర్ణ JS కఠిన గడువు సడలింపు.
OMNIROUTE_BROWSER_POOL	on	బ్రౌజర్ ఆధారిత వెబ్-కుకీ చాట్ కోసం భాగస్వామ్య Playwright బ్రౌజర్ పూల్ (browserPool.ts); నిలిపివేయడానికి off సెట్ చేయండి.
OBSCURA_BIN	auto-detect	బ్రౌజర్ పూల్ మరియు Cloudflare Playground ఎగ్జిక్యూటర్కు ప్రాథమిక ఇంజిన్గా ఉపయోగించే obscura బైనరీ పాత్ (open-sse/services/obscura.ts); సెట్ చేయనప్పుడు సిస్టమ్ PATH నుండి స్వయంచాలకంగా గుర్తించబడుతుంది.
OBSCURA_CDP_ENDPOINT	(సెట్ చేయలేదు)	కొత్తదాన్ని ప్రారంభించడానికి బదులుగా ఇప్పటికే నడుస్తున్న Obscuraను (http://host:port) సూచించండి; ఆ ప్రాసెస్ ఈ మాడ్యూల్ ఆధీనంలో ఉండదు (open-sse/services/obscura.ts).
OBSCURA_PORT	random free port	ప్రారంభించిన obscura serve కోసం స్పష్టమైన పోర్ట్; సెట్ చేయనప్పుడు ఖాళీ పోర్ట్ స్వయంచాలకంగా ఎంచుకోబడుతుంది (open-sse/services/obscura.ts).
WEB_COOKIE_USE_BROWSER	0	వెబ్-కుకీ చాట్ అభ్యర్థనకు బ్రౌజర్ ఆధారిత మార్గాన్ని ఎంపిక చేయండి (browserBackedChat.ts); ప్రారంభించడానికి 1.
KIMI_WEB_BASE_URL	https://www.kimi.ai	Kimi Web (అంతర్జాతీయ kimi.ai Connect-RPC) ఎగ్జిక్యూటర్కు బేస్ URL (kimi-web.ts); మిర్రర్/ప్రాక్సీ ఎండ్పాయింట్ల కోసం మాత్రమే ఓవర్రైడ్ చేయండి.
KIMI_WEB_CHAT_URL	<KIMI_WEB_BASE_URL>/apiv2/kimi.gateway.chat.v1.ChatService/Chat	Kimi Web ఎగ్జిక్యూటర్కు పూర్తి చాట్ ఎండ్పాయింట్ (kimi-web.ts).
OMNIROUTE_LOGIN_BROWSER_PATH	(స్వయంచాలకంగా గుర్తించబడింది)	Adobe Firefly ఇంటరాక్టివ్ బ్రౌజర్ సైన్-ఇన్ కోసం సిస్టమ్ Chrome/Edge ఎగ్జిక్యూటబుల్ పాత్ (adobeFireflyBrowserLogin.ts); ప్రతి-OS స్వయంచాలక గుర్తింపును ఓవర్రైడ్ చేస్తుంది.
OMNIROUTE_STANDALONE_DIR	.build/ స్వతంత్ర అవుట్పుట్	బిల్డ్ అనంతర సహస్థాపన దశ ఉపయోగించే స్వతంత్ర అవుట్పుట్ డైరెక్టరీకి బిల్డ్-సమయ ఓవర్రైడ్ (scripts/build/colocate-standalone.mjs); ఇది బిల్డ్ సాధనాలకు సంబంధించినది, రన్టైమ్కు కాదు.

కాంబో లక్ష్య ప్రయత్నాలు పరిష్కరించబడిన అప్స్ట్రీమ్ అభ్యర్థన గడువును (FETCH_TIMEOUT_MS, లేదా ఫెచ్ డిఫాల్ట్ను అందించినప్పుడు REQUEST_TIMEOUT_MS) వారసత్వంగా పొందుతాయి. కాంబో ఫాల్బ్యాక్ను వేగవంతం చేయడానికి మాత్రమే కాంబోలో, కాంబో డిఫాల్ట్లలో లేదా ప్రొవైడర్ ఓవర్రైడ్లో targetTimeoutMs సెట్ చేయండి; ప్రస్తుత అప్స్ట్రీమ్ గడువు కంటే ఎక్కువ విలువలు అప్స్ట్రీమ్ గడువుకే పరిమితం చేయబడతాయి.

comboTimeoutMs అనేది ఫెయిల్ఓవర్ లక్ష్యాలన్నింటికీ వర్తించే, మొత్తం కాంబోకు సంబంధించిన ప్రత్యేక వాల్-క్లాక్ బడ్జెట్. అపరిమిత ఇటరేషన్ను కొనసాగించడానికి దాన్ని సెట్ చేయకుండా ఉంచండి లేదా 0 సెట్ చేయండి (10-నిమిషాల COMBO_LOOP_SAFETY_TIMEOUT_MS హ్యాంగ్-స్టాప్ ఇప్పటికీ వర్తిస్తుంది). ధనాత్మక విలువ కాంబో కోసం ఆ భద్రతా పరిమితిని భర్తీ చేస్తుంది. నెమ్మదైన మొదటి లక్ష్యం తర్వాత కూడా ఫెయిల్ఓవర్కు సమయం ఉండేలా comboTimeoutMsను targetTimeoutMs కంటే ఎక్కువగా ఉంచండి.

సర్క్యూట్ బ్రేకర్ థ్రెషోల్డ్లు

ప్రొవైడర్-స్థాయి సర్క్యూట్ బ్రేకర్ ట్యూనింగ్. డిఫాల్ట్లు 500+ కనెక్షన్ల కోసం v3.6 నుండి ఉపయోగిస్తున్న స్కేల్ చేసిన విలువలను ప్రతిబింబిస్తాయి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_THRESHOLD	8	open-sse/config/constants.ts	బ్రేకర్ ట్రిప్ కావడానికి ముందు OAuth ప్రొవైడర్ల వరుస వైఫల్యాల పరిమితి.
OMNIROUTE_CIRCUIT_BREAKER_OAUTH_RESET_MS	60000	open-sse/config/constants.ts	OAuth ప్రొవైడర్ బ్రేకర్కు రీసెట్ వ్యవధి (ms).
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_THRESHOLD	12	open-sse/config/constants.ts	API-key ప్రొవైడర్లకు వరుస వైఫల్యాల పరిమితి.
OMNIROUTE_CIRCUIT_BREAKER_API_KEY_RESET_MS	30000	open-sse/config/constants.ts	API-key ప్రొవైడర్ బ్రేకర్కు రీసెట్ వ్యవధి (ms).
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_THRESHOLD	2	open-sse/config/constants.ts	లోకల్ ప్రొవైడర్లకు (Ollama, LM Studio, ...) వరుస వైఫల్యాల పరిమితి.
OMNIROUTE_CIRCUIT_BREAKER_LOCAL_RESET_MS	15000	open-sse/config/constants.ts	లోకల్ ప్రొవైడర్ బ్రేకర్కు రీసెట్ వ్యవధి (ms).
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_THRESHOLD	10	open-sse/config/constants.ts	ప్రొవైడర్-స్థాయి బ్రేకర్: మొత్తం OAuth ప్రొవైడర్ కూల్డౌన్లోకి ప్రవేశించే ముందు, వ్యవధిలో సంభవించే వైఫల్యాలు.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_FAILURE_WINDOW_MS	900000	open-sse/config/constants.ts	ప్రొవైడర్-స్థాయి బ్రేకర్: OAuth ప్రొవైడర్ల కోసం రోలింగ్ వైఫల్య-గణన వ్యవధి (ms).
OMNIROUTE_PROVIDER_BREAKER_OAUTH_COOLDOWN_MS	300000	open-sse/config/constants.ts	ప్రొవైడర్-స్థాయి బ్రేకర్: OAuth ప్రొవైడర్ పరిమితిని చేరుకున్న తర్వాత కూల్డౌన్ (ms).
OMNIROUTE_PROVIDER_BREAKER_OAUTH_DEGRADATION_THRESHOLD	5	open-sse/config/constants.ts	ఇన్ని వైఫల్యాల వద్ద OAuth ప్రొవైడర్ DEGRADED స్థితిలోకి ప్రవేశిస్తుంది.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_MAX_BACKOFF_MULTIPLIER	8	open-sse/config/constants.ts	OAuth ప్రొవైడర్ గరిష్ఠ resetTimeout పెంపు గుణకం.
OMNIROUTE_PROVIDER_BREAKER_OAUTH_BACKOFF_ESCALATION_COUNT	2	open-sse/config/constants.ts	ఇన్ని ఓపెన్ సైకిళ్ల తర్వాత OAuth ప్రొవైడర్ ఎస్కలేట్ అవుతుంది.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_THRESHOLD	15	open-sse/config/constants.ts	ప్రొవైడర్-స్థాయి బ్రేకర్: మొత్తం API-key ప్రొవైడర్ కూల్డౌన్లోకి ప్రవేశించే ముందు, వ్యవధిలో సంభవించే వైఫల్యాలు.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_FAILURE_WINDOW_MS	1800000	open-sse/config/constants.ts	ప్రొవైడర్-స్థాయి బ్రేకర్: API-key ప్రొవైడర్ల కోసం రోలింగ్ వైఫల్య-గణన వ్యవధి (ms).
OMNIROUTE_PROVIDER_BREAKER_API_KEY_COOLDOWN_MS	600000	open-sse/config/constants.ts	ప్రొవైడర్-స్థాయి బ్రేకర్: API-key ప్రొవైడర్ పరిమితిని చేరుకున్న తర్వాత కూల్డౌన్ (ms).
OMNIROUTE_PROVIDER_BREAKER_API_KEY_DEGRADATION_THRESHOLD	7	open-sse/config/constants.ts	ఇన్ని వైఫల్యాల వద్ద API-key ప్రొవైడర్ DEGRADED స్థితిలోకి ప్రవేశిస్తుంది.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_MAX_BACKOFF_MULTIPLIER	4	open-sse/config/constants.ts	API-key ప్రొవైడర్ గరిష్ఠ resetTimeout పెంపు గుణకం.
OMNIROUTE_PROVIDER_BREAKER_API_KEY_BACKOFF_ESCALATION_COUNT	3	open-sse/config/constants.ts	ఇన్ని ఓపెన్ సైకిళ్ల తర్వాత API-key ప్రొవైడర్ ఎస్కలేట్ అవుతుంది.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_THRESHOLD	2	open-sse/config/constants.ts	ప్రొవైడర్-స్థాయి బ్రేకర్: మొత్తం లోకల్ ప్రొవైడర్ కూల్డౌన్లోకి ప్రవేశించే ముందు సంభవించే వైఫల్యాలు.
OMNIROUTE_PROVIDER_BREAKER_LOCAL_FAILURE_WINDOW_MS	300000	open-sse/config/constants.ts	ప్రొవైడర్-స్థాయి బ్రేకర్: లోకల్ ప్రొవైడర్ల కోసం రోలింగ్ వైఫల్య-గణన వ్యవధి (ms).
OMNIROUTE_PROVIDER_BREAKER_LOCAL_COOLDOWN_MS	60000	open-sse/config/constants.ts	ప్రొవైడర్-స్థాయి బ్రేకర్: లోకల్ ప్రొవైడర్ పరిమితిని చేరుకున్న తర్వాత కూల్డౌన్ (ms).
PIN_DROP_BACKOFF_LEVEL	2	open-sse/services/combo.ts	context-cache పిన్ ప్రొవైడర్ దీర్ఘకాలికంగా అనారోగ్యకరంగా ఉన్నట్లు పరిగణించి, ఫెయిలోవర్ కోసం పిన్ను తొలగించే బ్యాక్ఆఫ్ లోతు.
PIN_DROP_GRACE_MS	20000	open-sse/services/combo.ts	context-cache పిన్ను తొలగించే ముందు స్వల్పకాలిక తాత్కాలిక కూల్డౌన్లను సహించే యాంటీ-ఫ్లాప్ వ్యవధి (ms).

సందర్భాలు

సందర్భం	కాన్ఫిగరేషన్
దీర్ఘకాలం నడిచే కోడ్ జనరేషన్	REQUEST_TIMEOUT_MS=900000 (15 నిమి)
మొత్తం స్ట్రీమ్ జీవితకాలాన్ని పరిమితం చేయడం	STREAM_ACTIVE_TIMEOUT_MS=1260000 (21 నిమి)
ప్రొడక్షన్ API కోసం వేగవంతమైన వైఫల్యం	API_BRIDGE_PROXY_TIMEOUT_MS=10000
పొడిగించిన ఆలోచనా మోడళ్లు	STREAM_IDLE_TIMEOUT_MS=300000 (చంక్ల మధ్య 5 నిమి)

---

16. లాగింగ్

లాగింగ్ సిస్టమ్ stdout మరియు రొటేట్ చేయబడిన లాగ్ ఫైళ్లు రెండింటికీ వ్రాస్తుంది. కాన్ఫిగరేషన్ మొత్తం src/lib/logEnv.ts ద్వారా చదవబడుతుంది.

వేరియబుల్	డిఫాల్ట్	వివరణ
APP_LOG_LEVEL	info	కనిష్ఠ లాగ్ స్థాయి: debug, info, warn, error.
APP_LOG_FORMAT	text	అవుట్పుట్ ఫార్మాట్: text (మనుషులు చదవగలిగేది) లేదా json (నిర్మితమైనది).
APP_LOG_TO_FILE	true	stdoutతో పాటు లాగ్లను ఫైల్కు వ్రాయండి.
APP_LOG_FILE_PATH	logs/application/app.log	లాగ్ ఫైల్ పాత్ (ప్రాజెక్ట్ రూట్ లేదా DATA_DIRకు సాపేక్షంగా).
APP_LOG_MAX_FILE_SIZE	50M	రొటేషన్కు ముందు గరిష్ఠ ఫైల్ పరిమాణం. ఆమోదించేవి: 50M, 1G, 512K, లేదా సాధారణ బైట్లు.
APP_LOG_RETENTION_DAYS	7	రొటేట్ చేసిన అప్లికేషన్ లాగ్ ఫైళ్లను ఉంచాల్సిన రోజుల సంఖ్య.
APP_LOG_MAX_FILES	20	రొటేట్ చేసిన లాగ్ ఫైల్ బ్యాకప్ల గరిష్ఠ సంఖ్య.
CALL_LOG_RETENTION_DAYS	7	డేటాబేస్లో అభ్యర్థన/కాల్ లాగ్ ఎంట్రీలను ఉంచాల్సిన రోజుల సంఖ్య.
CALL_LOG_MAX_ENTRIES	10000	ఇన్-మెమరీ బఫర్లోని కాల్ లాగ్ ఎంట్రీల గరిష్ఠ సంఖ్య.
CALL_LOGS_TABLE_MAX_ROWS	100000	తొలగింపుకు ముందు call_logs SQLite పట్టికలో ఉండగల గరిష్ఠ వరుసలు.
ENABLE_REQUEST_LOGS	(సెట్ చేయబడలేదు)	డాష్బోర్డ్ సెట్టింగ్ను అధిగమిస్తూ, వివరణాత్మక అభ్యర్థన లాగింగ్ను ఆన్ లేదా ఆఫ్ చేయమని నిర్బంధించండి.
MAX_PENDING_REQUEST_AGE_MS	3600000 (1 గంట)	ఇన్-మెమరీ క్లీనప్కు ముందు అనాథగా మిగిలిన యాక్టివ్ అభ్యర్థన లాగ్ ఎంట్రీల గరిష్ఠ వయస్సు.
CALL_LOG_PIPELINE_CAPTURE_STREAM_CHUNKS	false	call_log_pipeline_enabled=true అయినప్పుడు పైప్లైన్ ఆర్టిఫాక్ట్లలో స్ట్రీమ్ చంక్లను నిల్వ చేయండి. ఎంపిక చేసుకుంటే మాత్రమే (true) — డిస్క్ స్థలాన్ని ఆదా చేయడానికి డిఫాల్ట్గా ఆఫ్లో ఉంటుంది.
CALL_LOG_PIPELINE_MAX_SIZE_KB	512	call_log_pipeline_enabled=true అయినప్పుడు పైప్లైన్ కాల్ లాగ్ ఆర్టిఫాక్ట్ గరిష్ఠ పరిమాణం, KBలో.
PROXY_LOGS_TABLE_MAX_ROWS	100000	తొలగింపుకు ముందు proxy_logs SQLite పట్టికలో ఉండగల గరిష్ఠ వరుసలు.
PROXY_LOG_INCLUDE_IPS	false	[ProxyEgress] కన్సోల్ లాగ్లలో క్లయింట్/ఎగ్రెస్ IPలు మరియు ఖాతా ప్రిఫిక్స్లను చేర్చండి. డాష్బోర్డ్/డేటాబేస్ ప్రాక్సీ-లాగ్ రికార్డులు పూర్తి వివరాలను అలాగే ఉంచుతాయి.
APP_LOG_ROTATION_CHECK_INTERVAL_MS	60000 (1 నిమిషం)	src/lib/logRotation.ts యాక్టివ్ లాగ్ ఫైల్ పరిమాణాన్ని ఎంత తరచుగా మళ్లీ తనిఖీ చేయాలో నిర్దేశిస్తుంది.
CHAT_LOG_TEXT_LIMIT	65536	చాట్ లాగ్ ఆర్టిఫాక్ట్లలో ఉంచబడే గరిష్ఠ స్ట్రింగ్ పొడవు (డిఫాల్ట్ 64 KB).
CHAT_LOG_ARRAY_TAIL_ITEMS	128	చాట్ లాగ్ పేలోడ్లను కుదించేటప్పుడు అర్రే చివరి భాగం నుండి ఉంచబడే అంశాల సంఖ్య.
CHAT_LOG_MAX_DEPTH	6	చాట్ లాగ్ పేలోడ్లు కుదించబడటానికి ముందు అనుమతించే గరిష్ఠ నెస్టింగ్ లోతు.
CHAT_LOG_MAX_OBJECT_KEYS	80	చాట్ లాగ్ పేలోడ్లలో ఉంచబడే ఆబ్జెక్ట్ కీల గరిష్ఠ సంఖ్య (0 = అపరిమితం).
CHAT_LOG_MAX_BODY_KB	1024	పూర్తి క్లోన్కు బదులుగా కేవలం సారాంశంతో భర్తీ చేయడానికి ముందు మొత్తం అభ్యర్థన/ప్రతిస్పందన బాడీ పరిమాణం (KB). సుదీర్ఘ ఏజెంటిక్ సంభాషణల్లో డాష్బోర్డ్పై వాస్తవ సందేశాలకు బదులుగా ప్లేస్హోల్డర్ కనిపిస్తే దీనిని పెంచండి.
CHAT_DEBUG_FILE	false	true అయినప్పుడు, serializeArtifactForStorage పరిమాణ-ఆధారిత కుదింపును దాటవేస్తుంది. డీబగ్ కోసం మాత్రమే.

---

17. మెమరీ ఆప్టిమైజేషన్

వేరియబుల్	డిఫాల్ట్	వివరణ
OMNIROUTE_MEMORY_MB	ఆటో (బేర్ మెటల్); Docker ఇమేజ్లో 1024	సిఫార్సు చేయబడిన Docker/స్వతంత్ర V8 హీప్ పరిమితి (MB). సెట్ చేయనప్పుడు, ఇది డైనమిక్గా క్రమాంకనం చేయబడుతుంది (సిస్టమ్ RAMలో ~35%, [512, 4096] పరిధికి పరిమితం చేయబడుతుంది); మొత్తం మెమరీని చదవలేనప్పుడు మాత్రమే 512 కనిష్ఠ పరిమితిగా ఉపయోగించబడుతుంది. run-standalone.mjsలో (Docker CMD), ఒక స్పష్టమైన విలువ --max-old-space-sizeగా జోడించబడుతుంది మరియు విరుద్ధమైన NODE_OPTIONS హీప్ ఫ్లాగ్పై పైచేయి సాధిస్తుంది (V8లో చివరి ఫ్లాగ్కు ప్రాధాన్యం). omniroute serve ఇప్పటికీ ఇప్పటికే ఉన్న NODE_OPTIONS హీప్కు ప్రాధాన్యం ఇస్తుంది (#5238). రెండింటినీ వేర్వేరు సంఖ్యలకు సెట్ చేయవద్దు — ప్రాసెస్ రెండు విలువలతోపాటు ఏది గెలిచిందో పేర్కొంటూ హెచ్చరికను లాగ్ చేస్తుంది. అధికారిక Docker ఇమేజ్ ఎల్లప్పుడూ 1024ను సెట్ చేస్తుంది, కాబట్టి అక్కడ క్రమాంకనం ఎప్పుడూ అమలు కాదు. Coding-agent /v1/responsesకు cgroup అదనపు సామర్థ్యంతోపాటు 8192–12288 అవసరం — Docker గైడ్ — రన్టైమ్ RAM చూడండి.
PROMPT_CACHE_MAX_SIZE	50	గరిష్ఠంగా క్యాష్ చేయబడే సిస్టమ్ ప్రాంప్ట్ ఎంట్రీలు.
PROMPT_CACHE_MAX_BYTES	2097152 (2 MB)	మొత్తం ప్రాంప్ట్ క్యాష్ గరిష్ఠ పరిమాణం.
PROMPT_CACHE_TTL_MS	300000 (5 నిమి)	ప్రాంప్ట్ క్యాష్ ఎంట్రీ TTL.
SEMANTIC_CACHE_MAX_SIZE	100	గరిష్ఠంగా క్యాష్ చేయబడే temperature=0 ప్రతిస్పందనలు.
SEMANTIC_CACHE_MAX_BYTES	4194304 (4 MB)	మొత్తం సెమాంటిక్ క్యాష్ గరిష్ఠ పరిమాణం.
SEMANTIC_CACHE_TTL_MS	1800000 (30 నిమి)	సెమాంటిక్ క్యాష్ ఎంట్రీ TTL.
OMNIROUTE_CORPUS_CACHE_SIZE	5	ఒకేసారి సజీవమైన ఇన్-మెమరీ ఇండెక్స్ను ఉంచే స్థానిక-కార్పస్ రూట్లు (src/lib/localCorpus/configured.ts). LRU: పరిమితిని చేరుకున్నప్పుడు, అత్యంత తక్కువగా ఇటీవల ఉపయోగించిన రూట్ ఇండెక్స్ తొలగించబడి, దాని తదుపరి క్వెరీ సమయంలో తిరిగి నిర్మించబడుతుంది. కనిష్ఠంగా 1కు పరిమితం చేయబడుతుంది; సంఖ్య కాని విలువ డిఫాల్ట్కు తిరిగి వెళ్తుంది.
STREAM_HISTORY_MAX	50	Dashboard లైవ్ వ్యూ బఫర్లో గరిష్ఠ ఇటీవలి స్ట్రీమ్ ఈవెంట్లు.
CONTEXT_LENGTH_DEFAULT	128000	స్పష్టమైన కాన్ఫిగరేషన్ లేని మోడళ్ల కోసం గ్లోబల్ ఫాల్బ్యాక్ గరిష్ఠ కాంటెక్స్ట్ పొడవు.
USAGE_TOKEN_BUFFER	100	వినియోగ కోటాలను ట్రాక్ చేస్తున్నప్పుడు రిజర్వ్ చేయబడే అదనపు టోకెన్ సామర్థ్యం.

కంప్రెషన్

వేరియబుల్	డిఫాల్ట్	వివరణ
OMNIROUTE_RTK_TRUST_PROJECT_FILTERS	సెట్ చేయబడలేదు	.rtk/trust.json హాష్ లేకుండానే ప్రాజెక్ట్ .rtk/filters.jsonను విశ్వసించండి. నియంత్రిత స్థానిక డెవలప్మెంట్లో మాత్రమే ఉపయోగించండి.

మెమరీ ఇంజిన్ (ప్లాన్ 21)

మెమరీ, స్కిల్స్ మరియు టోకెన్ రిఫ్రెష్కు సంబంధించిన ఈవెంట్-లూప్ వ్యయం (#10349)

OmniRoute ఒక ఏకైక Node ప్రాసెస్. మెమరీ ఎక్స్ట్రాక్షన్/రిట్రీవల్, స్కిల్స్ ఇంజెక్షన్ మరియు ప్రొవైడర్ టోకెన్ రిఫ్రెష్ అనేవి GET /healthz మరియు dashboard మాదిరిగానే అదే ఈవెంట్ లూప్పై అమలవుతాయి. అవి worker thread కావు.

పని	కోడ్	డిఫాల్ట్	ఆపరేటర్ నియంత్రణ
మెమరీ సంగ్రహణ / పునరుద్ధరణ	src/lib/memory/	డాష్బోర్డ్ memoryEnabled (డిఫాల్ట్గా ఆన్లో ఉంటుంది)	Settings → Memoryను ఆఫ్ చేయండి. సెట్టింగ్లలో ఈ ఫీచర్ను నిలిపివేయడం మినహా ప్రత్యేక env కిల్ స్విచ్ ఏదీ లేదు.
స్కిల్స్ ఇంజెక్షన్	src/lib/skills/injection.ts	డాష్బోర్డ్ skillsEnabled (డిఫాల్ట్గా ఆన్లో ఉంటుంది)	Settings → Memory/Skills (skillsEnabled)ను ఆఫ్ చేయండి. ఇంజెక్షన్ ఇప్పటికే ఆన్లో ఉన్న తర్వాత మాత్రమే దిగువన ఉన్న శాండ్బాక్స్ నాబ్లు ఎగ్జిక్యూషన్ను పరిమితం చేస్తాయి.
టోకెన్ రిఫ్రెష్	src/sse/services/tokenRefresh.ts	కనెక్ట్ చేసిన OAuth/వెబ్ ప్రొవైడర్లకు ఆన్లో ఉంటుంది	ప్రొవైడర్ను డిస్కనెక్ట్ చేయండి లేదా టోకెన్లు చెల్లుబాటులో ఉండనివ్వండి; ప్రస్తుతం TOKEN_REFRESH=0 env లేదు.

నిష్క్రియగా ఉన్న మెషీన్లో /healthz నెమ్మదిగా ఉంటే, ముందుగా మెమరీ + స్కిల్స్ను నిలిపివేసి, ఆపై కేటలాగ్/కంప్రెషన్ లోడ్ను తనిఖీ చేయండి (#10303, #9685). ఈ ఫీచర్లు await పాయింట్ల వద్ద నియంత్రణను వదులుతాయి, అయినప్పటికీ ఒకే థ్రెడ్ కోసం పోటీపడతాయి.

స్థిరమైన మెమరీ సబ్సిస్టమ్ (src/lib/memory/) కోసం ఎంబెడ్డింగ్ లేయర్, వెక్టర్ స్టోర్ మరియు రీర్యాంకింగ్ నాబ్లు.

వేరియబుల్	డిఫాల్ట్	వివరణ
MEMORY_EMBEDDING_CACHE_TTL_MS	300000 (5 నిమి)	ఇన్-మెమరీ ఎంబెడ్డింగ్ క్యాష్కు TTL (ప్రతి సోర్స్/మోడల్/డైమెన్షన్ సిగ్నేచర్కు).
MEMORY_EMBEDDING_CACHE_MAX	1000	ఎంబెడ్డింగ్ క్యాష్లో ఉంచే గరిష్ఠ LRU ఎంట్రీలు.
MEMORY_TRANSFORMERS_MODEL	Xenova/all-MiniLM-L6-v2	ఆప్ట్-ఇన్ @huggingface/transformers లోకల్ MiniLM పైప్లైన్కు HF రిపో id (~23 MB int8, ~400 MB RAM).
MEMORY_STATIC_MODEL	minishlab/potion-base-8M	స్టాటిక్ potion/Model2Vec లుకప్-టేబుల్ ఎంబెడర్కు HF రిపో id. క్యాష్ డైరెక్టరీలోకి అవసరమైనప్పుడు డౌన్లోడ్ చేయబడుతుంది.
MEMORY_STATIC_CACHE_DIR	<DATA_DIR>/embeddings	స్టాటిక్ potion మోడల్ ఫైళ్లను క్యాష్ చేయడానికి ఉపయోగించే డైరెక్టరీ. సెట్ చేయనప్పుడు డిఫాల్ట్గా DATA_DIR కింద ఉంటుంది.
HF_HUB_ENDPOINT	https://huggingface.co	staticPotion.ts ఉపయోగించే Hugging Face Hub బేస్ URLను ఓవర్రైడ్ చేస్తుంది (ఉదా. ఎయిర్-గ్యాప్డ్ సెటప్ల కోసం మిర్రర్ ఎండ్పాయింట్).
MEMORY_VEC_TOP_K	20	src/lib/memory/vectorStore.tsలోని sqlite-vec బ్రూట్-ఫోర్స్ వెక్టర్ శోధన ఉపయోగించే డిఫాల్ట్ top-K.
MEMORY_RRF_K	60	హైబ్రిడ్ FTS5 + వెక్టర్ రిట్రీవల్ కోసం Reciprocal Rank Fusion స్థిరాంకం k (sqlite-vec రెసిపీ).
VECTOR_STORE_DISABLE_VEC	false	getVectorStore() (src/lib/memory/vectorStore.ts)లోని టెస్ట్/డయాగ్నస్టిక్ సీమ్: trueగా ఉన్నప్పుడు, వెక్టర్ స్టోర్ను బలవంతంగా nullకు సెట్ చేస్తుంది (sqlite-vec లేని క్లౌడ్/WASM ఎన్విరాన్మెంట్ను అనుకరిస్తుంది), తద్వారా మెమరీ రిట్రీవల్ FTS5 కీవర్డ్ శోధనకు దిగజారుతుంది. ప్రొడక్షన్లో సెట్ చేయకుండా వదిలేయండి.
NOTION_API_KEY	(సెట్ చేయలేదు)	Notion బ్యాకెండ్కు API కీ (genericBackend.tsలోని తెలిసిన బ్యాకెండ్ ప్రీసెట్ ఉపయోగిస్తుంది).
NOTION_API_URL	https://api.notion.com/v1	Notion API కోసం బేస్ URL (స్వయంగా హోస్ట్ చేసిన Notion ప్రత్యామ్నాయాల కోసం ఓవర్రైడ్ చేయవచ్చు).
OBSIDIAN_API_KEY	(సెట్ చేయలేదు)	Obsidian Vault బ్యాకెండ్కు API కీ (genericBackend.tsలోని తెలిసిన బ్యాకెండ్ ప్రీసెట్ ఉపయోగిస్తుంది).
OBSIDIAN_API_URL	http://localhost:27123	Obsidian Vault API కోసం బేస్ URL (రిమోట్ వాల్ట్ కోసం ఓవర్రైడ్ చేయవచ్చు).
MEMORY_TYPED_DECAY_ENABLED	false	TV6 టైప్డ్ మెమరీ డికే మాస్టర్ స్విచ్. ఆప్ట్-ఇన్ (డిఫాల్ట్గా ఆఫ్) — స్వీప్ డికే అయిన మెమరీలను తొలగిస్తుంది. ఇది ఆఫ్లో ఉన్నప్పుడు, access_count/last_accessed_at కేవలం టెలిమెట్రీ మాత్రమే; ఏదీ ఎప్పటికీ తొలగించబడదు.
MEMORY_TYPED_DECAY_EPISODIC_DAYS	30	ఉపయోగించని episodic మెమరీ డికే అయ్యే వ్యవధి TTL (రోజుల్లో). 0 ఎపిసోడిక్ మెమరీని కూడా డికే నుంచి మినహాయిస్తుంది. దీర్ఘకాలిక రకాలు (factual/procedural/semantic) ఎల్లప్పుడూ మినహాయింపు పొందుతాయి. డికే గడియారం last_accessed_at ఆధారంగా తిరిగి ప్రారంభమవుతుంది.
MEMORY_TYPED_DECAY_ACCESS_IMMUNITY	3	ఇన్ని సార్లు లేదా అంతకంటే ఎక్కువగా (>=) ఇంజెక్ట్ చేయబడిన మెమరీ, దాని రకంతో సంబంధం లేకుండా డికే నుంచి మినహాయింపు పొందుతుంది. 0 యాక్సెస్ ఇమ్యూనిటీని నిలిపివేస్తుంది.
MEMORY_TYPED_DECAY_SWEEP_INTERVAL	0 (నిలిపివేయబడింది)	src/lib/memory/typedDecay.tsలోని ఐచ్ఛిక పీరియాడిక్ డికే స్వీప్కు విరామం (సెకన్లలో). 0/సెట్ చేయకపోవడం = పీరియాడిక్ స్వీప్ లేదు. రెండంచెల ఆప్ట్-ఇన్: దీనికి అదనంగా MEMORY_TYPED_DECAY_ENABLED=true కూడా అవసరం.
OMNIROUTE_STRICT_SYSTEM_PROVIDERS	(సెట్ చేయలేదు)	system సందేశాన్ని ఇండెక్స్ 0 వద్ద మాత్రమే అంగీకరించే కామాతో వేరు చేసిన ప్రొవైడర్ idలు (కేస్-ఇన్సెన్సిటివ్) (src/lib/memory/injection.ts). వీటి విషయంలో, మల్టీ-టర్న్ సంభాషణల్లో క్యాష్-సేఫ్ మిడ్-అరే మెమరీ స్ప్లైస్ సురక్షితం కాదు; అందువల్ల మెమరీని విలీనం చేసి/ముందు జోడించి, మొదటి సిస్టమ్ సందేశంగా ఉంచుతారు. డిఫాల్ట్గా xiaomi-mimo/mimo మాత్రమే ఉంటాయి; అదే సింగిల్-లీడింగ్-సిస్టమ్-మెసేజ్ పరిమితిని అమలు చేసే చాట్ టెంప్లేట్ ఉన్న, స్వయంగా హోస్ట్ చేసిన OpenAI-అనుకూల ఎండ్పాయింట్ల (ఉదా. Qwen3.5+/3.6) కోసం దీన్ని విస్తరించండి.

తక్కువ-RAM Docker ఉదాహరణ

128 డాష్బోర్డ్కు మాత్రమే సరిపోతుంది. ఈ హీప్లో కోడింగ్ ఏజెంట్లు సుదీర్ఘ /v1/responses సమయంలో FATAL ERRORకు గురవుతాయి. ఈ ఉదాహరణను Claude/Codex/Grok గేట్వేగా ఉపయోగించవద్దు.

OMNIROUTE_MEMORY_MB=128
PROMPT_CACHE_MAX_SIZE=20
PROMPT_CACHE_MAX_BYTES=524288        # 512 KB
SEMANTIC_CACHE_MAX_SIZE=25
SEMANTIC_CACHE_MAX_BYTES=1048576     # 1 MB
STREAM_HISTORY_MAX=10

---

18. ధరల సమకాలీకరణ

బాహ్య మూలాల నుండి మోడల్ ధరల డేటాను స్వయంచాలకంగా సమకాలీకరించడం.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
PRICING_SYNC_ENABLED	false	src/lib/pricingSync.ts	కాలానుగుణ ధరల సమకాలీకరణను ఎంపిక చేసుకుని ప్రారంభిస్తుంది.
PRICING_SYNC_INTERVAL	86400 (24h)	src/lib/pricingSync.ts	సెకన్లలో సమకాలీకరణ విరామం.
PRICING_SYNC_SOURCES	litellm	src/lib/pricingSync.ts	కామాలతో వేరు చేసిన డేటా మూలాలు.

---

Arena ELO సమకాలీకరణ

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
ARENA_ELO_SYNC_ENABLED	true	src/shared/constants/featureFlagDefinitions.ts	కాలానుగుణ Arena AI లీడర్బోర్డ్ ELO సమకాలీకరణ; దీన్ని Dashboard Feature Flags నుండి కాన్ఫిగర్ చేయవచ్చు లేదా నిలిపివేయడానికి false ఉపయోగించవచ్చు.
MODELS_CATALOG_PREFIX_MODE	dual	src/shared/constants/featureFlagDefinitions.ts, src/app/api/v1/models/catalog.ts	GET /v1/modelsలోని మోడల్ idల కోసం ఉపయోగించే ప్రిఫిక్స్ రూపం. ప్రతి మోడల్కు dual సంక్షిప్త అలియాస్ ప్రిఫిక్స్తో పాటు ప్రామాణిక ప్రొవైడర్ ప్రిఫిక్స్నూ ప్రకటిస్తుంది (వెనుకబడిన అనుకూలత — ఇది కేటలాగ్ పరిమాణాన్ని సుమారుగా రెట్టింపు చేస్తుంది); alias ప్రతి మోడల్కు ఒక idని విడుదల చేస్తుంది; canonical పూర్తి provider-id ప్రిఫిక్స్ను మాత్రమే విడుదల చేస్తుంది (అలియాస్ ఇప్పటికే ప్రామాణిక idగా ఉన్న ప్రొవైడర్లు తమ ఒక్క ఎంట్రీనే ఉంచుకుంటారు). క్లయింట్లు ప్రతి అభ్యర్థనకు ?prefix=aliasతో దీన్ని ఓవర్రైడ్ చేయవచ్చు. API_REFERENCE చూడండి.
ARENA_ELO_SYNC_INTERVAL	86400 (24h)	src/lib/arenaEloSync.ts	సెకన్లలో సమకాలీకరణ విరామం.

---

PromptQL Playground ప్రొవైడర్ (అనధికారికం/ప్రయోగాత్మకం)

prompt.ql.app కోసం రివర్స్-ఇంజినీర్ చేసిన GraphQL సెషన్ బ్రిడ్జ్ (src/shared/constants/providers/web-cookie.ts). అన్నీ ఐచ్ఛికమే — డిఫాల్ట్లు పబ్లిక్ ప్లేగ్రౌండ్ ఎండ్పాయింట్లను సూచిస్తాయి; స్వయంగా హోస్ట్ చేసిన/ప్రత్యామ్నాయ PromptQL డిప్లాయ్మెంట్ కోసం మాత్రమే వీటిని ఓవర్రైడ్ చేయండి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
PROMPTQL_GRAPHQL_ENDPOINT	https://data.prompt.ql.app/promptql/playground-v2-hge/v1/graphql	open-sse/executors/promptql.ts	చాట్/సెషన్ కార్యకలాపాల కోసం ఉపయోగించే GraphQL ఎండ్పాయింట్.
PROMPTQL_CREDITS_ENDPOINT	https://data.pro.ql.app/v1/graphql	open-sse/executors/promptql.ts, open-sse/services/usage/promptql.ts	క్రెడిట్ బ్యాలెన్స్/వినియోగాన్ని ప్రశ్నించడానికి ఉపయోగించే GraphQL ఎండ్పాయింట్.
PROMPTQL_TOKEN_REFRESH_URL	https://auth.pro.ql.app/ddn/project/token	open-sse/executors/promptql.ts	సాధ్యమైనంత మేరకు టోకెన్ను రిఫ్రెష్ చేయడానికి ఉపయోగించే ఎండ్పాయింట్.
PROMPTQL_POLL_TIMEOUT_MS	180000	open-sse/executors/promptql.ts	సమయం ముగిసే ముందు thread_eventsను పోల్ చేయడానికి గరిష్ఠ సమయం (ms).

---

HyperAgent వెబ్ ప్రొవైడర్ (అనధికారికం/ప్రయోగాత్మకం)

hyperagent.com కోసం రివర్స్-ఇంజినీర్ చేసిన సెషన్ బ్రిడ్జ్ (src/shared/constants/providers/web-cookie.ts). ఐచ్ఛికం — డిఫాల్ట్గా పబ్లిక్ బిల్లింగ్/వినియోగ ఎండ్పాయింట్ను సూచిస్తుంది; స్వయంగా హోస్ట్ చేసిన/ప్రత్యామ్నాయ HyperAgent డిప్లాయ్మెంట్ కోసం మాత్రమే ఓవర్రైడ్ చేయండి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
HYPERAGENT_USAGE_URL	https://hyperagent.com/api/settings/billing/usage	open-sse/services/usage/hyperagent.ts	బిల్లింగ్/వినియోగ క్రెడిట్ బ్లాక్లను పొందడానికి ఉపయోగించే ఎండ్పాయింట్.

---

Kilo Code వినియోగ కోటాలు

Kilo Code ప్రొవైడర్ కోసం వ్యక్తిగత USD బ్యాలెన్స్ మరియు Kilo Pass వినియోగాన్ని తెలుసుకోవడం. ఐచ్ఛికం — డిఫాల్ట్గా పబ్లిక్ Kilo APIని సూచిస్తుంది; రిలే/టెస్ట్ ఫిక్చర్ కోసం మాత్రమే ఓవర్రైడ్ చేయండి. ప్రమాణీకరణ కోసం కనెక్షన్లో ఇప్పటికే ఉన్న OAuth యాక్సెస్ టోకెన్ ఉపయోగించబడుతుంది.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
KILO_API_URL	https://api.kilo.ai	open-sse/services/usage/kilocode.ts	వ్యక్తిగత Kilo Code బ్యాలెన్స్ మరియు Kilo Pass వినియోగాన్ని పొందడానికి ఉపయోగించే బేస్ URL.

---

Adobe Firefly వెబ్ ప్రొవైడర్ (అనధికారికం/ప్రయోగాత్మకం)

Adobe Firefly వెబ్ ప్రొవైడర్ కోసం బ్రౌజర్-ఆధారిత సెషన్ రిఫ్రెష్ (open-sse/services/adobeFireflyBrowserLogin.ts, open-sse/services/adobeFireflySession.ts, open-sse/services/adobeFireflyClient.ts). ఐచ్ఛికం — అన్ని డిఫాల్ట్లు సాధారణ డెస్క్టాప్ ఇన్స్టాలేషన్ కోసం సర్దుబాటు చేయబడ్డాయి.

#9255లో తొలగించబడింది. పాత CDP-అటాచ్డ్ Chrome రన్టైమ్ (adobeFireflyChromeRuntime.ts) Playwright బ్రౌజర్-లాగిన్ సర్వీస్తో భర్తీ చేయబడింది, ఇక దాని సెట్టింగ్లు ఉనికిలో లేవు. ADOBE_FIREFLY_CHROME_ CDP_PORT / VISIBLE / HEADED / PING / FORCE_RESTART వేరియబుల్లతో పాటు ADOBE_FIREFLY_LOGIN_WAIT_MS మరియు ADOBE_FIREFLY_FORTER_WAIT_MSలను కోడ్బేస్లో ఎక్కడా చదవరు — వాటిని సెట్ చేయడం వల్ల ఎలాంటి ప్రభావమూ ఉండదు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
ADOBE_FIREFLY_CHROME_HEADLESS	0	open-sse/services/adobeFireflyBrowserLogin.ts	నిజమైన హెడ్లెస్ Chrome కోసం 1కి సెట్ చేయండి (జనరేట్ కోసం పనిచేయదని తెలిసినది; డీబగ్ కోసం మాత్రమే).
ADOBE_FIREFLY_BROWSER_REFRESH	1	open-sse/services/adobeFireflySession.ts	ముందస్తు బ్రౌజర్ వార్మ్ను ప్రారంభించడం/నిలిపివేయడం. 0 ముందస్తు వార్మ్ను నిలిపివేస్తుంది (బ్యాచ్ మధ్యలో 408 రికవరీ ఇప్పటికీ వర్తిస్తుంది).
ADOBE_FIREFLY_SESSION_DISK	1	open-sse/services/adobeFireflySession.ts	Adobe Firefly సెషన్ను డిస్క్లో నిల్వ చేయడాన్ని నిలిపివేయడానికి 0కి సెట్ చేయండి.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS	(సెట్ చేయబడలేదు)	open-sse/services/adobeFireflySession.ts	వరుస సబ్మిట్ల మధ్య అమలు చేసే కనిష్ఠ విరామం (ms), అంతర్నిర్మిత డిఫాల్ట్ను ఓవర్రైడ్ చేస్తుంది.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS	(సెట్ చేయబడలేదు)	open-sse/services/adobeFireflySession.ts	విజయవంతమైన బ్యాచ్ తర్వాత జోడించే అదనపు విరామం (ms), అంతర్నిర్మిత డిఫాల్ట్ను ఓవర్రైడ్ చేస్తుంది.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS	(సెట్ చేయబడలేదు)	open-sse/services/adobeFireflyClient.ts	జనరేషన్ అభ్యర్థనను సబ్మిట్ చేయడానికి ముందు ఉండే ప్రాథమిక ఆలస్యం (ms), అంతర్నిర్మిత డిఫాల్ట్ను ఓవర్రైడ్ చేస్తుంది.

---

19. మోడల్ సమకాలీకరణ (డెవ్)

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
MODELS_DEV_SYNC_ENABLED	(సెట్ చేయలేదు)	src/lib/modelsDevSync.ts	models.dev ధరల సమకాలీకరణ కోసం కఠినమైన ఓవర్రైడ్. సెట్ చేయకపోతే = Settings > AI (modelsDevSyncEnabled)ను అనుసరిస్తుంది. 0/false/off/no DB కంటే ప్రాధాన్యత పొందుతుంది మరియు ఆవర్తన సమకాలీకరణతో పాటు getModelsDevPricing() SQL/JSON స్కాన్లను కూడా దాటవేస్తుంది (అదే ఈవెంట్ లూప్లో డ్యాష్బోర్డ్ నిలిచిపోయినప్పుడు పునరుద్ధరణ కోసం). 1/true/on/yes సమకాలీకరణను బలవంతంగా ఆన్ చేస్తుంది. ధరలను సేవ్ చేయడం/తొలగించడం ఇప్పటికీ backupDbFile("pre-write")ను కాల్ చేస్తుంది; 60-నిమిషాల థ్రాటిల్ లేదా DISABLE_SQLITE_AUTO_BACKUP అమలులో ఉన్నప్పుడు ఇది ఎలాంటి చర్యనూ చేయదు.
MODELS_DEV_SYNC_INTERVAL	86400 (24గం.)	src/lib/modelsDevSync.ts	డెవలప్మెంట్ సమయంలో మోడల్ కేటలాగ్ సమకాలీకరణ విరామం, సెకన్లలో.
CONTEXT_WINDOW_RECONCILE_INTERVAL	86400 (24గం.)	src/lib/contextWindowResolver.ts	స్వీయ-సరిదిద్దుకునే కాంటెక్స్ట్-విండో రీకన్సైలర్ (5004) కోసం విరామం (సెకన్లలో): /models డిస్కవరీ ద్వారా ప్రొవైడర్ ప్రకటించిన విండోలు కేటలాగ్కు భిన్నంగా ఉన్నప్పుడు, వాటిని auto:discovery ఓవర్రైడ్లుగా పిన్ చేస్తుంది. నిలిపివేయడానికి 0గా సెట్ చేయండి. ఇప్పటికే సమకాలీకరించిన డేటాను తిరిగి ఉపయోగిస్తుంది (కొత్త ఫెచ్ ఉండదు); manual ఓవర్రైడ్లను ఎప్పటికీ ఓవర్రైట్ చేయదు.

---

20. ప్రొవైడర్-నిర్దిష్ట సెట్టింగ్లు

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OPENROUTER_CATALOG_TTL_MS	86400000 (24గం.)	src/lib/catalog/openrouterCatalog.ts	OpenRouter మోడల్ కాటలాగ్ క్యాష్ TTL.
MODEL_CATALOG_INCLUDE_NAMES	true	src/shared/constants/featureFlagDefinitions.ts	/v1/models ప్రతిస్పందనల్లో ప్రదర్శనకు అనుకూలమైన name ఫీల్డ్లను చేర్చండి. IDలను మాత్రమే ఆశించే క్లయింట్ల కోసం నిలిపివేయండి.
CATALOG_BUILD_TIMEOUT_MS	8000 (8సె.)	src/app/api/v1/models/catalogCache.ts	సమీకృత GET /v1/models కాటలాగ్ పునర్నిర్మాణం కోసం కోల్డ్-పాత్ నిరీక్షణ పరిమితి (#12627). సమయం ముగిసినప్పుడు, చివరిగా విజయవంతమైన 200 అందుబాటులో ఉంటే అది అందించబడుతుంది.
OMNIROUTE_SYNCED_CATALOG_STALE_AFTER_MS	2592000000 (30 రోజులు)	src/lib/db/models/activeSyncedCatalog.ts	కనెక్షన్కు సింక్ చేసిన మోడల్ జాబితా రూటింగ్కు ప్రామాణికంగా ఉండటం ఆపి, రిజిస్ట్రీకి ఫెయిల్-ఓపెన్ అయ్యే కాలపరిమితి (#12849). టైమ్స్టాంప్ ఎప్పుడూ నమోదు కాని వరుసలు పాతవిగా పరిగణించబడతాయి.
NANOBANANA_POLL_TIMEOUT_MS	120000	open-sse/handlers/imageGeneration.ts	NanoBanana ఇమేజ్ జనరేషన్ జాబ్ల కోసం గరిష్ఠ నిరీక్షణ సమయం.
NANOBANANA_POLL_INTERVAL_MS	2500	open-sse/handlers/imageGeneration.ts	NanoBanana జాబ్ పోలింగ్ ఫ్రీక్వెన్సీ.
ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS	8000	open-sse/services/adobeFireflyUpscale.ts	Adobe Firefly అప్స్కేల్ సమర్పణ-పునఃప్రయత్న ఎక్స్పోనెన్షియల్ బ్యాక్ఆఫ్కు ప్రాథమిక ఆలస్యం.
AWS_REGION	(సెట్ చేయబడలేదు)	src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts	AWS Bedrock ఎండ్పాయింట్లను (Kiro, ఆడియో) రూపొందించడానికి ఉపయోగించే ప్రాంతం.
AWS_DEFAULT_REGION	(సెట్ చేయబడలేదు)	src/lib/providers/validation.ts, open-sse/handlers/audioSpeech.ts	AWS_REGION సెట్ చేయనప్పుడు ఉపయోగించే ఫాల్బ్యాక్.
CLOUDFLARE_ACCOUNT_ID	(సెట్ చేయబడలేదు)	open-sse/executors/cloudflare-ai.ts	Cloudflare Workers AI కోసం ఖాతా ID.
CLOUDFLARE_PLAYGROUND_CHROME_PATH	(సెట్ చేయబడలేదు)	open-sse/executors/cloudflare-playground.ts	Cloudflare AI Playground ఎగ్జిక్యూటర్ కోసం పూర్తి డెస్క్టాప్ Chrome బైనరీ పాత్; హెడ్లెస్ ఫింగర్ప్రింట్ తనిఖీ Playwrightతో బండిల్ చేసిన Chromiumను నిరోధించినప్పుడు ఇది ఉపయోగించబడుతుంది.
CLOUDFLARE_API_BASE	https://api.cloudflare.com/client/v4	src/app/api/settings/proxy/cloudflare-deploy/route.ts	ప్రాక్సీ-పూల్ Workers రిలే డిప్లాయర్ ఉపయోగించే Cloudflare REST API బేస్ను ఓవర్రైడ్ చేయండి (#4640 / 9router#1360).
NEXT_PUBLIC_CLOUDFLARE_RELAY_DEFAULT_PROJECT	omniroute-relay	src/app/(dashboard)/dashboard/settings/components/proxy/CloudflareRelayModal.tsx	ప్రాక్సీ-పూల్ "రిలేను డిప్లాయ్ చేయండి" మోడల్లో సూచించే డిఫాల్ట్ వర్కర్ ప్రాజెక్ట్ పేరు.
NEXT_PUBLIC_CLOUDFLARE_RELAY_ENABLED	true	src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx	Proxy Pool ట్యాబ్ నుండి Cloudflare Workers రిలే ఎంపికను దాచడానికి falseగా సెట్ చేయండి.
CLOUDFLARED_BIN	స్వయంచాలకంగా గుర్తించు	src/lib/cloudflaredTunnel.ts	cloudflared బైనరీకి అనుకూల పాత్.
CLOUDFLARED_PROTOCOL	http2	src/lib/cloudflaredTunnel.ts	టన్నెల్ రవాణా ప్రోటోకాల్: http2 (డిఫాల్ట్), quic, లేదా auto.
CLOUDFLARED_CONFIG	(సెట్ చేయబడలేదు)	src/lib/cloudflaredTunnel.ts	స్థానికంగా నిర్వహించే cloudflared config.ymlకు పాత్ (tunnel:, credentials-file:, ingress:తో). ఇది సెట్ చేసినప్పుడు, తాత్కాలిక క్విక్ టన్నెల్కు బదులుగా OmniRoute tunnel --config <path> run (పేరు గల టన్నెల్)ను అమలు చేస్తుంది.
CLOUDFLARED_HOSTNAME	(కాన్ఫిగ్ ingress నుండి)	src/lib/cloudflaredTunnel.ts	పేరు గల టన్నెల్ పబ్లిక్ హోస్ట్నేమ్కు ఓవర్రైడ్ (ఉదా. ai.example.com), ఇది publicUrl/apiUrlగా నివేదించబడుతుంది. సెట్ చేయనప్పుడు, కాన్ఫిగ్లోని మొదటి ingress హోస్ట్నేమ్ నుండి చదవబడుతుంది.
DENO_DEPLOY_API_BASE	https://api.deno.com/v2	src/app/api/settings/proxy/deno-deploy/route.ts	ప్రాక్సీ-పూల్ రిలే డిప్లాయర్ ఉపయోగించే Deno Deploy REST API బేస్ను ఓవర్రైడ్ చేస్తుంది (#4643 / 9router#1437).
NEXT_PUBLIC_DENO_RELAY_DEFAULT_PROJECT	omniroute-deno-relay	src/app/(dashboard)/dashboard/settings/components/proxy/DenoRelayModal.tsx	ప్రాక్సీ-పూల్ "Deploy Relay" మోడల్లో సూచించబడే డిఫాల్ట్ Deno Deploy యాప్ పేరు.
NEXT_PUBLIC_DENO_RELAY_ENABLED	true	src/app/(dashboard)/dashboard/settings/components/proxy/ProxyPoolTab.tsx	Proxy Pool ట్యాబ్లో Deno Deploy రిలే ఎంపికను దాచడానికి falseగా సెట్ చేయండి.
SEARCH_CACHE_TTL_MS	300000 (5 నిమి)	open-sse/services/searchCache.ts	శోధన API (Perplexity, Brave మొదలైనవి) ప్రతిస్పందన క్యాషింగ్ కోసం TTL.
ENABLE_CC_COMPATIBLE_PROVIDER	false	src/shared/utils/featureFlags.ts	Claude Code-మాత్రమే రిలేల కోసం ప్రయోగాత్మక CC-అనుకూల ప్రొవైడర్ UIని ప్రదర్శిస్తుంది.
NINEROUTER_HOST	127.0.0.1	open-sse/executors/ninerouter.ts	ఎంబెడ్ చేసిన 9router ఇన్స్టాన్స్ వినే హోస్ట్ను ఓవర్రైడ్ చేస్తుంది.
NINEROUTER_PORT	20130	open-sse/executors/ninerouter.ts	ఎంబెడ్ చేసిన 9router ఇన్స్టాన్స్ వినే పోర్ట్ను ఓవర్రైడ్ చేస్తుంది.
EMBED_WS_PROXY_HOST	127.0.0.1	src/lib/services/embedWsProxy.ts	ఎంబెడ్ చేసిన సర్వీస్ WebSocket ప్రాక్సీ కోసం బైండ్ హోస్ట్ (డిఫాల్ట్గా లూప్బ్యాక్ మాత్రమే).
EMBED_WS_PROXY_PORT	20131	src/lib/services/embedWsProxy.ts	ఎంబెడ్ చేసిన సర్వీస్ WebSocket ప్రాక్సీ సర్వర్ కోసం పోర్ట్.
CLIPROXYAPI_HOST	127.0.0.1	open-sse/executors/cliproxyapi.ts	CLIProxyAPI బ్రిడ్జ్ హోస్ట్ (లెగసీ ఇంటిగ్రేషన్).
CLIPROXYAPI_PORT	5544	open-sse/executors/cliproxyapi.ts	CLIProxyAPI బ్రిడ్జ్ పోర్ట్.
CLIPROXYAPI_API_KEY	(ఖాళీ)	open-sse/handlers/chatCore/cliproxyapiCredentials.ts	cliproxyapi_api_key సెట్టింగ్ లేనప్పుడు డేటా-ప్లేన్ కీ ఫాల్బ్యాక్.
CLIPROXYAPI_MANAGEMENT_KEY	(ఖాళీ)	src/lib/services/cliproxyAccountHealth.ts	బాహ్యంగా నిర్వహించబడే CLIProxyAPI ఇన్స్టాన్స్ నుండి ఖాతా-ఆరోగ్య రీడ్ల కోసం మేనేజ్మెంట్ కీ.
CLIPROXYAPI_CONFIG_DIR	~/.cli-proxy-api	src/lib/versionManager/processManager.ts	CLIProxyAPI కాన్ఫిగ్ డైరెక్టరీ.
CLIPROXY_BIND_HOST	127.0.0.1	docker-compose.yml	docker-compose cliproxyapi సైడ్కార్ను ప్రచురించే హోస్ట్ ఇంటర్ఫేస్ (#12578). దాని డేటా వాల్యూమ్ ప్రొవైడర్ OAuth/API క్రెడెన్షియల్లను కలిగి ఉంటుంది మరియు పిన్ చేసిన ఇమేజ్లో env-ఆధారిత డేటా-ప్లేన్ api-keys ఓవర్రైడ్ లేదు (మౌంట్ చేసిన config.yaml మాత్రమే), కాబట్టి 0.0.0.0 క్రెడెన్షియల్లను కలిగిన సర్వీస్ను మొత్తం LANకు బహిర్గతం చేస్తుంది.
MUX_SERVICE_PORT	8322	src/lib/services/bootstrap.ts	ఎంబెడ్ చేసిన Mux (coder/mux) ఏజెంట్-ఆర్కెస్ట్రేషన్ డీమన్ వినే పోర్ట్ను ఓవర్రైడ్ చేస్తుంది (ఎల్లప్పుడూ 127.0.0.1).
DARIO_HOST	127.0.0.1	open-sse/executors/dario.ts	Dario ఎంబెడ్ చేసిన సర్వీస్ బైండ్/కనెక్ట్ హోస్ట్ (డిఫాల్ట్గా లూప్బ్యాక్ మాత్రమే).
DARIO_PORT	3456	open-sse/executors/dario.ts	Dario ఎంబెడ్ చేసిన సర్వీస్ పోర్ట్.
DARIO_HOST	127.0.0.1	open-sse/executors/dario.ts	Dario ఎంబెడ్ చేసిన సర్వీస్ బైండ్/కనెక్ట్ హోస్ట్ (డిఫాల్ట్గా లూప్బ్యాక్ మాత్రమే).
DARIO_PORT	3456	open-sse/executors/dario.ts	Dario ఎంబెడ్ చేసిన సర్వీస్ పోర్ట్.
LOCAL_HOSTNAMES	(ఖాళీ)	open-sse/config/providerRegistry.ts	"స్థానికం"గా పరిగణించబడే కామాతో వేరు చేసిన అదనపు హోస్ట్ పేర్లు (Docker సర్వీస్ పేర్లు మొదలైనవి).

ENABLE_CC_COMPATIBLE_PROVIDER అనేది Claude Code క్లయింట్లను మాత్రమే అంగీకరించే మూడవ-పక్ష రిలేల కోసం ఉద్దేశించబడింది. ఆ రిలేలు అభ్యర్థనలను అంగీకరించేలా OmniRoute వాటిని తిరిగి వ్రాస్తుంది. మీరు Claude Code CLIని మాత్రమే ఉపయోగించాలనుకుంటే, లేదా ఈ రిలేలు ఏమిటో మీకు ఖచ్చితంగా తెలియకపోతే, దీన్ని నిలిపివేసి ఉంచి, బదులుగా సాధారణ Anthropic-అనుకూల ప్రొవైడర్ను జోడించండి.

---

21. ప్రాక్సీ ఆరోగ్యం

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
PROXY_FAST_FAIL_TIMEOUT_MS	2000	src/lib/proxyHealth.ts	ఫాస్ట్-ఫెయిల్ ఆరోగ్య తనిఖీ గడువు.
PROXY_LATENCY_WINDOW_HOURS	3	src/lib/db/proxies.ts	లేటెన్సీ-ఆప్టిమైజ్డ్ పూల్ వ్యూహంలో అభ్యర్థి ప్రాక్సీల సగటు లేటెన్సీని లెక్కించడానికి ఉపయోగించే సమయ విండో (గంటల్లో).
PROXY_HEALTH_CACHE_TTL_MS	30000	src/lib/proxyHealth.ts	ఆరోగ్య తనిఖీ ఫలితాల క్యాష్ TTL.
PROXY_HEALTH_UNHEALTHY_CACHE_TTL_MS	2000	src/lib/proxyHealth.ts	విఫలమైన ప్రాక్సీ ఆరోగ్య ప్రోబ్ల కోసం క్యాష్ TTL. అధిక సమకాలీనతలో తాత్కాలిక ప్రాక్సీ గడువు ముగింపులు త్వరగా మళ్లీ ప్రయత్నించబడేలా, అలాగే నిజంగా పనిచేయని ప్రాక్సీల కోసం ఫాస్ట్-ఫెయిల్ నిలిపివేయబడకుండా ఉండేలా, దీన్ని PROXY_HEALTH_CACHE_TTL_MS కంటే తక్కువగా ఉంచండి.
PROXY_HEALTH_ENABLED	true	src/lib/proxyHealth/scheduler.ts	నమోదు చేసిన ప్రాక్సీలను క్రమానుగతంగా ప్రోబ్ చేసే నేపథ్య ప్రాక్సీ ఆరోగ్య షెడ్యూలర్ను నిలిపివేయడానికి falseగా సెట్ చేయండి.
PROXY_HEALTH_INTERVAL_MS	600000	src/lib/proxyHealth/scheduler.ts	నేపథ్య ఆరోగ్య షెడ్యూలర్ స్వీప్ విరామం మిల్లీసెకన్లలో (కనిష్ఠం 60000).
PROXY_HEALTH_TEST_URL	https://httpbin.org/ip	src/lib/proxyHealth/probeTarget.ts	షెడ్యూలర్ మరియు /api/settings/proxies/auto-test ఎండ్పాయింట్ ఉపయోగించే రీచబిలిటీ ప్రోబ్ లక్ష్యం. పబ్లిక్ డిఫాల్ట్ను నివారించడానికి దీన్ని అంతర్గత/స్వీయ-హోస్ట్ చేసిన URLకు నిర్దేశించండి.
PROXY_HEALTH_TEST_CONCURRENCY	10	src/lib/proxyHealth/probeTarget.ts	ఒక్కో బ్యాచ్లో ఒకేసారి ప్రారంభమయ్యే ప్రోబ్ల సంఖ్య; దీన్ని షెడ్యూలర్ మరియు /api/settings/proxies/auto-test ఎండ్పాయింట్ పంచుకుంటాయి. కనిష్ఠంగా 1కి, గరిష్ఠంగా 50కి పరిమితం చేయబడుతుంది.
PROXY_HEALTH_TEST_STAGGER_MS	100	src/lib/proxyHealth/probeTarget.ts	ఒక బ్యాచ్లో రెండు ప్రోబ్లు బయలుదేరే మధ్య ఆలస్యం, msలో. ఇది లేకపోతే మొత్తం బ్యాచ్ ఒకేసారి బయలుదేరుతుంది, దాంతో భాగస్వామ్య ఎగ్రెస్ IP రేట్-పరిమితి ఉన్న లక్ష్యపు పరిమితిని ప్రేరేపించవచ్చు. ఈ అంతరాన్ని నిలిపివేయడానికి 0కు సెట్ చేయండి; గరిష్ఠంగా 5000కి పరిమితం చేయబడుతుంది.
PROXY_HEALTH_USE_PROVIDER_TARGET	true	src/lib/proxyHealth/providerProbeTarget.ts	ప్రాక్సీకి కేటాయించిన ప్రొవైడర్ యొక్క నిజమైన హోస్ట్ను (GET /models, API కీ లేకుండా) ప్రోబ్ చేయడం ఆపి, బదులుగా ఎల్లప్పుడూ PROXY_HEALTH_TEST_URLను ఉపయోగించడానికి "false"గా సెట్ చేయండి.
PROXY_HEALTH_AUTO_DEACTIVATE	false	src/lib/proxyHealth/statusPolicy.ts	false (డిఫాల్ట్)గా ఉన్నప్పుడు, స్వయంచాలక రీచబిలిటీ ప్రోబ్లు (షెడ్యూలర్ + /api/settings/proxies/auto-testలోని "అన్నింటినీ పరీక్షించండి" బటన్) చదవడానికి మాత్రమే ఉంటాయి మరియు ప్రాక్సీ స్థితిని ఎప్పుడూ మార్చవు — ఆపరేటర్ మాత్రమే సక్రియం/నిష్క్రియం స్థితిని సెట్ చేస్తారు, కాబట్టి అస్థిరమైన ప్రోబ్ కేటాయించిన ప్రాక్సీని ఒంటరిగా వదిలేయదు (#6246). పాత పరీక్షించి-సెట్-చేసే ప్రవర్తనను పునరుద్ధరించడానికి trueగా సెట్ చేయండి.
PROXY_POOL_EGRESS_OBSERVATION	false	src/shared/utils/featureFlags.ts	ఐచ్ఛికంగా ప్రారంభించగల ఫీచర్ ఫ్లాగ్ (FEATURE_FLAGS.md చూడండి; డ్యాష్బోర్డ్ DB ఓవర్రైడ్కు ప్రాధాన్యం ఉంటుంది). true (లేదా 1, yes)గా ఉంటే, డ్యాష్బోర్డ్లో ప్రాక్సీ పూల్ కింద చదవడానికి-మాత్రమే అనుమతించే పూల్ ఎగ్రెస్ పరిశీలనను చూపుతుంది (ప్రాక్సీ లాగ్ ఆధారంగా, గత 24 hలో విభిన్న ఎగ్రెస్ IPలు, కనెక్షన్లు మరియు ఒక IP వెనుక అత్యధికంగా కనిపించినవి). రూటింగ్ కోసం ఎప్పుడూ ఉపయోగించబడదు.
PROXY_AUTO_REMOVE	false	src/lib/proxyHealth/scheduler.ts	వరుసగా పదేపదే వైఫల్యాలు సంభవించిన తర్వాత ప్రాక్సీలను షెడ్యూలర్ స్వయంచాలకంగా తొలగించేందుకు trueగా సెట్ చేయండి.
PROXY_AUTO_REMOVE_AFTER	3	src/lib/proxyHealth/scheduler.ts	షెడ్యూలర్ ఒక ప్రాక్సీని స్వయంచాలకంగా తొలగించడానికి ముందు అనుమతించే వరుస వైఫల్యాల సంఖ్య (PROXY_AUTO_REMOVE=trueగా ఉన్నప్పుడు).
PROXY_AUTO_DISABLE	false	src/lib/proxyHealth/scheduler.ts	పునరావృత వరుస వైఫల్యాల తర్వాత proxyని తొలగించడానికి బదులుగా scheduler దానిని సాఫ్ట్గా నిలిపివేయడానికి (స్థితి dead, ఎప్పటికీ తొలగించబడదు) trueగా సెట్ చేయండి. PROXY_AUTO_REMOVEకు నాన్-డిస్ట్రక్టివ్ ప్రత్యామ్నాయం: proxy వెంటనే pool/rotation resolution నుండి తప్పించబడుతుంది (scope-pool resolution ఉపయోగించే alive-status filter ఇప్పటికే దానిని మినహాయిస్తుంది), అలాగే అది probesలో మళ్లీ విజయవంతం కావడం ప్రారంభించిన వెంటనే స్వయంచాలకంగా తిరిగి యాక్టివేట్ అవుతుంది. PROXY_AUTO_REMOVE_AFTER thresholdనే పంచుకుంటుంది. రెండు flags కూడా true అయితే, PROXY_AUTO_REMOVEకు ప్రాధాన్యం ఉంటుంది.
OMNIROUTE_CONTROL_PLANE_PROXY_DIRECT_FALLBACK	false	src/shared/constants/featureFlagDefinitions.ts	proxy reachability pre-checks విఫలమైనప్పుడు, pinned proxyని దాటవేసి నేరుగా కనెక్ట్ కావడానికి OAuth మరియు provider validation flowsను అనుమతించండి. అమలయ్యే ప్రాధాన్య క్రమం: Feature Flags DB override > env var > default.
RATE_LIMIT_MAX_WAIT_MS	30000 (30సె)	open-sse/services/rateLimitManager.ts	request విఫలమయ్యే ముందు 429పై వేచి ఉండాల్సిన గరిష్ఠ సమయం.
RATE_LIMIT_EXECUTION_MAX_WAIT_MS	600000 (10 నిమి)	open-sse/services/rateLimitManager.ts	అనుమతించబడిన request యొక్క rate-limit reservation గడువు ముగిసే ముందు అది executionలో ఉండగల గరిష్ఠ సమయం — queue-wait budget నుండి వేరుచేయబడింది, కాబట్టి non-incremental gatewaysలో నెమ్మదైన fetch-start కారణంగా time out అవదు (#12027).
RATE_LIMIT_MAX_QUEUE_DEPTH	0 (నిలిపివేయబడింది)	open-sse/services/rateLimitManager.ts	Queue admission పరిమితి: ఇప్పటికే ఇన్ని requests queueలో ఉంటే 429 queue_fullతో తిరస్కరించండి. 0 = పరిమితి లేదు (default).
RATE_LIMIT_AUTO_ENABLE	(సెట్ చేయలేదు)	open-sse/services/rateLimitManager.ts	persisted Dashboard settingతో సంబంధం లేకుండా auto-enable rate limit safety netను బలవంతంగా ఆన్/ఆఫ్ చేయండి. బలవంతంగా ఆన్ చేయడానికి true/1/on, బలవంతంగా ఆఫ్ చేయడానికి false/0/offను అంగీకరిస్తుంది.
PROVIDER_COOLDOWN_ENABLED	(సెట్ చేయలేదు → ఆఫ్)	open-sse/services/providerCooldownTracker.ts	global cross-request provider/connection cooldown trackingను స్వచ్ఛందంగా ప్రారంభించే ఎంపిక. defaultగా ఆఫ్లో ఉంటుంది (Connection Cooldown / Provider Circuit Breakerతో overlap అవుతుంది). ప్రారంభించడానికి true/1/onను అంగీకరిస్తుంది.
PROVIDER_COOLDOWN_MIN_MS	5000	open-sse/services/providerCooldownTracker.ts	విఫలమైన provider/connectionను మళ్లీ ప్రయత్నించే ముందు కనీస cooldown (ms). వరుస వైఫల్యాలతో exponentialగా scale అవుతుంది. PROVIDER_COOLDOWN_ENABLED ఉన్నప్పుడు మాత్రమే ఉపయోగించబడుతుంది.
PROVIDER_COOLDOWN_MAX_MS	300000 (5 నిమి)	open-sse/services/providerCooldownTracker.ts	విఫలమైన ప్రొవైడర్/కనెక్షన్ను ఏ పరిస్థితిలోనైనా మళ్లీ ప్రయత్నించే ముందు గరిష్ఠ కూల్డౌన్ పరిమితి (ms). PROVIDER_COOLDOWN_ENABLED ఉన్నప్పుడు మాత్రమే ఉపయోగించబడుతుంది.
STREAM_RECOVERY_ENABLED	(సెట్ చేయలేదు → ఆఫ్)	src/lib/resilience/settings.ts (సీడ్) → open-sse/services/streamRecovery.ts (లాజిక్)	ఏమిటి: మధ్యలో తెగిపోయిన అప్స్ట్రీమ్ స్ట్రీమ్ల పారదర్శక పునరుద్ధరణ (free-claude-code పోర్ట్). ప్రారంభ SSE విండోను STREAM_RECOVERY.HOLDBACK_MS (750 ms) వరకు నిలిపి ఉంచుతుంది; తద్వారా క్లయింట్కు ఏ బైట్ చేరకముందే సంభవించే ప్రీ-కమిట్ కటాఫ్ను అదృశ్యంగా మళ్లీ తెరిచి, తిరిగి ప్రయత్నిస్తుంది. ఎప్పుడు ప్రారంభించాలి: స్ట్రీమ్ ప్రారంభంలో తరచుగా 0-బైట్ వద్ద తెగిపోయే అస్థిరమైన అప్స్ట్రీమ్ల కోసం; ప్రతి స్ట్రీమ్లో మొదటి టోకెన్ అందే సమయానికి గరిష్ఠంగా 750 ms అదనపు ఆలస్యాన్ని భరించలేకపోతే దీన్ని ఆఫ్లోనే ఉంచండి. true/1/on విలువలను అంగీకరిస్తుంది. నిల్వ చేయబడిన Resilience సెట్టింగ్కు ప్రారంభ విలువను అందిస్తుంది; ఒకసారి సెట్ చేసిన తర్వాత Dashboard సెట్టింగ్కే ప్రాధాన్యం ఉంటుంది.
STREAM_RECOVERY_MIDSTREAM_ENABLED	(సెట్ చేయలేదు → ఆఫ్)	src/lib/resilience/settings.ts (సీడ్) → open-sse/services/streamRecovery.ts (లాజిక్)	ఏమిటి: స్ట్రీమ్ మధ్యలో కొనసాగింపు (దశ 4.4) — పోస్ట్-కమిట్ ట్రంకేషన్ తర్వాత (బైట్లు ఇప్పటికే క్లయింట్కు చేరినప్పుడు), పాక్షిక టెక్స్ట్ను అసిస్టెంట్ ప్రీఫిల్గా ఉపయోగించి మళ్లీ అభ్యర్థించి, లేని ప్రత్యయాన్ని జతచేస్తుంది. సాధారణ టెక్స్ట్ OpenAI-అనుకూల స్ట్రీమ్లకు మాత్రమే; టూల్ కాల్ ప్రాసెస్లో ఉన్నప్పుడు ఇది ఎప్పుడూ అమలవదు. ఎప్పుడు ప్రారంభించాలి: మధ్యలోనే సమాధానం తెగిపోయే సుదీర్ఘ జనరేషన్ల కోసం, అలాగే పునరుద్ధరించిన చివరి భాగం టోకెన్-వారీగా కాకుండా ఒకేసారి రావడాన్ని మీరు అంగీకరిస్తే. STREAM_RECOVERY_ENABLED నుండి స్వతంత్రం (భిన్నమైన ప్రమాద ప్రొఫైల్). true/1/on విలువలను అంగీకరిస్తుంది.
STREAM_THROUGHPUT_WATCHDOG_ENABLED	(సెట్ చేయలేదు → ఆఫ్)	src/lib/resilience/settings.ts → open-sse/services/throughputWatchdog.ts	ఐచ్ఛికంగా ప్రారంభించగల యాక్టివ్-స్ట్రీమ్ ఉపయోగకర-అవుట్పుట్ వాచ్డాగ్. చంక్లను పంపుతూనే ఉన్నప్పటికీ, కాన్ఫిగర్ చేసిన అసిస్టెంట్-అవుట్పుట్ రేటు కంటే తక్కువగా ఉండే స్ట్రీమ్లను గుర్తిస్తుంది; హార్ట్బీట్లు, వినియోగ ఈవెంట్లు, ఖాళీ డెల్టాలు, టూల్/రీజనింగ్ దశలు పురోగతిగా కనిపించవు. ఐడిల్ మరియు హార్డ్-డెడ్లైన్ టైమ్అవుట్లకు ఇది వేరు.
STREAM_THROUGHPUT_WATCHDOG_WARMUP_MS	30000	src/lib/resilience/settings/normalize.ts	త్రూపుట్ మూల్యాంకనానికి ముందు గ్రేస్ పీరియడ్, 0–600000 ms పరిధికి పరిమితం చేయబడుతుంది.
STREAM_THROUGHPUT_WATCHDOG_WINDOW_MS	30000	src/lib/resilience/settings/normalize.ts	రోలింగ్ ఉపయోగకర-అవుట్పుట్ విండో, 1000–600000 ms పరిధికి పరిమితం చేయబడుతుంది; నిలిపివేయడానికి ముందు ఒక పూర్తి విండో అవసరం.
STREAM_THROUGHPUT_WATCHDOG_MIN_BYTES_PER_SECOND	4	src/lib/resilience/settings/normalize.ts	కనిష్ఠ UTF-8 అసిస్టెంట్-అవుట్పుట్ బైట్ రేటు (సంప్రదాయవాద టోకెన్ ప్రాక్సీ), 1–1000000 పరిధికి పరిమితం చేయబడుతుంది.
STREAM_THROUGHPUT_WATCHDOG_MIN_USEFUL_BYTES	1	src/lib/resilience/settings/normalize.ts	కొలవదగినదిగా పరిగణించే కనిష్ఠ సున్నా-కాని ఉపయోగకర-అవుట్పుట్ నమూనా, 1–1000000 బైట్ల పరిధికి పరిమితం చేయబడుతుంది.
HEALTHCHECK_STAGGER_MS	3000	src/lib/tokenHealthCheck.ts	ప్రారంభ సమయంలో ప్రొవైడర్ టోకెన్ హెల్త్చెక్ల మధ్య స్టాగర్ విరామం (ms).
HEALTHCHECK_JITTER_MIN_MS	500	src/lib/tokenHealthCheck.ts	బర్స్టింగ్ను నివారించడానికి ప్రొవైడర్ టోకెన్ హెల్త్చెక్ల మధ్య HEALTHCHECK_STAGGER_MSకు అదనంగా జోడించే కనిష్ఠ యాదృచ్ఛిక జిట్టర్ (ms) (Issue #1220).
HEALTHCHECK_JITTER_MAX_MS	5000	src/lib/tokenHealthCheck.ts	బర్స్టింగ్ను నివారించడానికి ప్రొవైడర్ టోకెన్ హెల్త్చెక్ల మధ్య HEALTHCHECK_STAGGER_MSకు అదనంగా జోడించే గరిష్ఠ యాదృచ్ఛిక జిట్టర్ (ms) (Issue #1220).
HEALTHCHECK_BATCH_SIZE	20	src/lib/tokenHealthCheck.ts	ప్రారంభ టోకెన్-ఆరోగ్య తనిఖీ స్వీప్ కోసం ఏకకాలిక తనిఖీల బ్యాచ్ పరిమాణం; పెద్ద విలువలు మరిన్ని కనెక్షన్లను సమాంతరంగా తనిఖీ చేస్తాయి, చిన్న విలువలు ఆకస్మిక లోడ్ను తగ్గిస్తాయి (Issue #7875, #7719 యొక్క రిగ్రెషన్).
REQUEST_RETRY	2	src/sse/services/cooldownAwareRetry.ts	క్లయింట్కు లోపాన్ని తిరిగి పంపే ముందు మోడల్-పరిధిలోని కూల్డౌన్ ప్రతిస్పందనలపై చేసే స్వయంచాలక పునఃప్రయత్నాల సంఖ్య.
MAX_RETRY_INTERVAL_SEC	30	src/sse/services/cooldownAwareRetry.ts	కూల్డౌన్ పునఃప్రయత్నాల మధ్య గరిష్ఠ బ్యాక్ఆఫ్ విరామం (సెకన్లు). అప్స్ట్రీమ్ Retry-Afterతో సంబంధం లేకుండా ఈ విలువకు పరిమితం చేయబడుతుంది.
HEADROOM_URL	http://localhost:8787	src/lib/headroom/detect.ts	Headroom టోకెన్-సేవర్ ప్రాక్సీ URL. డ్యాష్బోర్డ్ జీవితచక్రం (api/headroom/*) డిఫాల్ట్గా లూప్బ్యాక్లో స్థానిక headroom-ai CLIని ప్రారంభిస్తుంది; బాహ్య Docker సైడ్కార్ ప్రాక్సీని సూచించడానికి మాత్రమే దీన్ని ఓవర్రైడ్ చేయండి.

స్ట్రీమ్-రికవరీ ట్యూనింగ్ స్థిరాంకాలు

రికవరీ హోల్డ్బ్యాక్ ప్రవర్తనను open-sse/config/constants.tsలోని (STREAM_RECOVERY) హార్డ్కోడ్ చేసిన స్థిరాంకాల ద్వారా ట్యూన్ చేస్తారు; సూచన కోసం అవి ఇక్కడ చూపబడ్డాయి — వాటిని మార్చడానికి env var కాకుండా కోడ్ సవరణ అవసరం:

• STREAM_RECOVERY.HOLDBACK_MS = 750 — ప్రారంభ SSE విండోను ఎంతసేపు నిలిపి ఉంచాలో సూచిస్తుంది, తద్వారా క్లయింట్కు ఏ బైట్ను కమిట్ చేయకముందే ప్రారంభ ట్రంకేషన్ను మళ్లీ ప్రయత్నించవచ్చు.
• STREAM_RECOVERY.BUFFER_MAX_BYTES = 65536 — నిలిపి ఉంచిన విండోకు కఠిన గరిష్ఠ పరిమితి; టైమర్తో సంబంధం లేకుండా ఇన్ని బైట్లు చేరగానే కమిట్ చేయండి (ఫ్లష్ + పాస్థ్రూ).
• STREAM_RECOVERY.EARLY_RETRY_MAX = 4 — హోల్డ్బ్యాక్ ఇంకా కమిట్ కానప్పుడు అప్స్ట్రీమ్ స్ట్రీమ్ను పారదర్శకంగా మళ్లీ తెరవగల గరిష్ఠ సంఖ్య.

ప్రతి-ప్రొవైడర్ స్లైడింగ్-విండో రేట్ పరిమితి (env var లేదు): FCC నుండి పోర్ట్ చేసిన ప్రతి-ప్రొవైడర్ స్లైడింగ్-విండో రేట్-లిమిట్ ఫాల్బ్యాక్ కోడ్లో ఉంది (open-sse/services/providerDefaultRateLimit.ts, ఇది open-sse/services/rateLimitManager.ts ద్వారా అనుసంధానించబడింది), కానీ ఇది ఖాళీ డిఫాల్ట్ మ్యాప్తో విడుదల అవుతుంది మరియు ప్రస్తుతం దీనికి ఆపరేటర్ env var లేదు — ఇది టెస్ట్ హుక్ / కోడ్ సవరణ ద్వారా మాత్రమే ప్రారంభించబడుతుంది. ఉద్దేశపూర్వకంగానే ఇది పై పట్టికలో జాబితా చేయబడలేదు. నియంత్రణ నాబ్ను కలిగి ఉన్న ప్రతి-(token, IP) రిలే లిమిటర్ RELAY_IP_PER_MINUTE (§3 నెట్వర్క్ & పోర్ట్లు).

---

22. డీబగ్గింగ్

Caution

ఈ వేరియబుల్స్ వివరణాత్మక అవుట్పుట్ను ఉత్పత్తి చేస్తాయి మరియు సున్నితమైన డేటాను బహిర్గతం చేయవచ్చు. ప్రొడక్షన్లో ఎన్నడూ ప్రారంభించవద్దు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
CURSOR_DEBUG	(సెట్ చేయబడలేదు)	open-sse/executors/cursor.ts	వివరణాత్మక Cursor ఎగ్జిక్యూటర్ లాగ్లను (డీకోడ్ చేసిన SSE భాగాలు మొదలైనవి) ప్రారంభించడానికి 1గా సెట్ చేయండి.
CURSOR_STREAM_DEBUG	(సెట్ చేయబడలేదు)	open-sse/executors/cursor.ts	CURSOR_DEBUGకు బ్యాక్వర్డ్-కంపాటిబుల్ అలియాస్.
CURSOR_DUMP_FILE	(సెట్ చేయబడలేదు)	open-sse/executors/cursor.ts	CURSOR_DEBUG=1గా ఉన్నప్పుడు ముడి డీకోడ్ చేసిన Cursor భాగాలను స్వీకరించే ఐచ్ఛిక ఫైల్ పాత్.
CURSOR_STREAM_TIMEOUT_MS	300000	open-sse/executors/cursor.ts	Cursor ఎగ్జిక్యూటర్ కోసం స్ట్రీమ్ నిష్క్రియ సమయ పరిమితి (ms).
CURSOR_KV_GRACE_MS	2000	open-sse/executors/cursor.ts	బైట్లు బఫర్లో మిగిలి ఉన్నప్పుడు composer kv_after_text సాఫ్ట్ టెర్మినేటర్ తర్వాత గ్రేస్ విండో (ms) — ఇది చివరలో వచ్చే exec_mcp టూల్ కాల్కు దాని ఫ్రేమ్ను పూర్తి చేయడానికి సమయం ఇస్తుంది.
CURSOR_TOOL_DIRECTIVE	ప్రారంభించబడింది (!== "0")	open-sse/executors/cursor.ts	composer-2.5 విశ్వసనీయంగా టూల్ కాల్స్ జారీ చేసేలా చేసే టూల్-కమిట్ డైరెక్టివ్. నిలిపివేయడానికి 0గా సెట్ చేయండి.
OMNIROUTE_SYSTEM_INSTRUCTION_APPEND	(సెట్ చేయబడలేదు)	open-sse/translator/request/claude-to-openai.ts, open-sse/translator/response/openai-to-claude.ts	అనువాదం తర్వాత సిస్టమ్ సందేశానికి జోడించబడే ఆపరేటర్-నిర్వచిత సిస్టమ్ ప్రాంప్ట్ టెక్స్ట్ (అనువాదానంతర ఇంజెక్షన్), ఇది codex/Responses మరియు /v1/messages పాత్లకు చేరుతుంది. ప్రతిధ్వనించిన సిస్టమ్ ప్రీఅంబుల్ బ్లాక్ల నుంచి తొలగించే డైరెక్టివ్ ప్రిఫిక్స్గా కూడా ఉపయోగించబడుతుంది. నిలిపివేయడానికి సెట్ చేయకుండా వదిలేయండి.
CURSOR_IMAGE_FETCH_TIMEOUT_MS	15000	open-sse/utils/cursorImages.ts	రిమోట్ image_url విజన్ ఇన్పుట్ కోసం ఒక్కో-చిత్ర ఫెచ్ సమయ పరిమితి (ms).
CURSOR_STATE_DB_PATH	(పరిశీలించబడుతుంది)	open-sse/utils/cursorVersionDetector.ts	IDE వెర్షన్ గుర్తింపు కోసం ఉపయోగించే Cursor IDE స్టేట్ DB లుకప్ను ఓవర్రైడ్ చేయండి.
CURSOR_AGENT_CLI_VERSION	(గుర్తించు / పిన్ చేయి)	open-sse/utils/cursorAgentCliVersion.ts	Agent Runలో x-cursor-client-version: cli-… కోసం Agent CLI బిల్డ్ id (YYYY.MM.DD-<hash>).
CURSOR_AGENT_BIN	(సెట్ చేయబడలేదు)	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	చిత్ర ఉత్పత్తి కోసం ఉపయోగించే Cursor Agent బైనరీకి పాత్. సెట్ చేయకపోతే, హ్యాండ్లర్ providerSpecificData.agentBin, ఆపై PATHను ఉపయోగిస్తుంది.
CURSOR_IMG_TIMEOUT_MS	210000	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Cursor Agent చిత్ర జాబ్ల కోసం ఒక్కో-చిత్ర వాల్ క్లాక్ సమయ పరిమితి (ms).
CURSOR_IMG_MAX_CONCURRENT	2	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	Cursor చిత్ర జాబ్ల కోసం షేర్డ్-సీట్ సమకాలీనత గేట్.
CURSOR_IMG_MODEL	రిక్వెస్ట్ / auto	open-sse/handlers/imageGeneration/providers/cursorAgentImage.ts	చిత్ర జాబ్ల కోసం Cursor CLI --modelను ఓవర్రైడ్ చేయండి.
UC_IMAGE_POLL_INTERVAL_MS	2000	open-sse/handlers/imageGeneration/providers/ucImage.ts	UC (uncensored.com) చిత్ర-ఉత్పత్తి ఫలితాన్ని పోల్ చేసే విరామం (ms).
UC_IMAGE_POLL_TIMEOUT_MS	60000	open-sse/handlers/imageGeneration/providers/ucImage.ts	UC చిత్ర-ఉత్పత్తి ఫలితాన్ని పోల్ చేసే వాల్ క్లాక్ సమయ పరిమితి (ms).
UC_VIDEO_POLL_INTERVAL_MS	3000	open-sse/handlers/videoGeneration/providers/ucVideo.ts	UC (uncensored.com) వీడియో-ఉత్పత్తి ఫలితాన్ని పోల్ చేసే విరామం (ms).
UC_VIDEO_POLL_TIMEOUT_MS	300000	open-sse/handlers/videoGeneration/providers/ucVideo.ts	UC వీడియో-ఉత్పత్తి ఫలితాన్ని పోల్ చేసే వాల్ క్లాక్ సమయ పరిమితి (ms).
CURSOR_DATA_DIR	(పరిశీలించబడుతుంది)	open-sse/utils/cursorAgentCliVersion.ts	Cursor Agent CLI డేటా డైరెక్టరీని (…/versions/<id>) ఓవర్రైడ్ చేయండి; అధికారిక ఏజెంట్ ఉపయోగించే వేరియబుల్ కూడా ఇదే.
CURSOR_TOKEN	(సెట్ చేయబడలేదు)	scripts/ad-hoc/cursor-tap.cjs	డెవలపర్ టూలింగ్ ఉపయోగించే ప్రత్యక్ష Cursor bearer టోకెన్.
OMNIROUTE_LOG_REQUEST_SHAPE	నిలిపివేయబడింది ("1" ద్వారా ఎంపిక చేసుకోవచ్చు)	src/app/api/v1/chat/completions/route.ts	"1"గా సెట్ చేసినప్పుడు పెద్ద చాట్ పేలోడ్ల కోసం కంటెంట్-టైప్/పొడవు మార్కర్లను లాగ్ చేయండి. లాగ్ నాయిస్ను తగ్గించడానికి డిఫాల్ట్గా ఆఫ్లో ఉంటుంది.
DEBUG_RESPONSES_SSE_TO_JSON	(సెట్ చేయబడలేదు)	open-sse/handlers/responseTranslator.ts	Responses API SSE→JSON అనువాద వివరాలను లాగ్ చేయడానికి trueగా సెట్ చేయండి.
DEBUG_CLAUDE_NONSTREAM	(సెట్ చేయబడలేదు)	open-sse/handlers/responseTranslator.ts	Claude ప్రతిస్పందన అనువాద పాత్లో ఖాళీ textContent భాగాలను కనిపించేలా చేయడానికి trueగా సెట్ చేయండి (డీబగ్ కోసం మాత్రమే).
NEXT_PUBLIC_OMNIROUTE_E2E_MODE	(సెట్ చేయబడలేదు)	E2E పరీక్ష హార్నెస్	E2E పరీక్ష మోడ్ను (సడలించిన ఆథెంటికేషన్, టెస్ట్ హుక్స్) ప్రారంభించడానికి trueగా సెట్ చేయండి.

---

23. GitHub సమీకరణ

Dashboard నుండే నేరుగా సమస్యలను నివేదించడానికి వినియోగదారులను అనుమతించండి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
GITHUB_ISSUES_REPO	(సెట్ చేయబడలేదు)	src/app/api/v1/issues/report/route.ts	owner/repo ఆకృతిలోని రిపోజిటరీ.
GITHUB_ISSUES_TOKEN	(సెట్ చేయబడలేదు)	src/app/api/v1/issues/report/route.ts	issues:write స్కోప్ కలిగిన GitHub వ్యక్తిగత యాక్సెస్ టోకెన్.
GITHUB_TOKEN	(సెట్ చేయబడలేదు)	సమస్య వర్గీకరణ / క్లౌడ్ ఏజెంట్ సహాయకాలు	GITHUB_ISSUES_TOKENకు ఫాల్బ్యాక్గా ఉపయోగించబడే మరియు src/lib/cloudAgent/*లోని క్లౌడ్ ఏజెంట్ సహాయకాలు వినియోగించే సాధారణ GitHub యాక్సెస్ టోకెన్.

---

డిప్లాయ్మెంట్ సందర్భాలు

రిలే బ్యాకెండ్ SRE మార్గదర్శకత్వం (ts/bifrost/auto ప్రవర్తన, 9router మరియు CLIProxyAPI అమరిక, అలాగే అధిక-త్రూపుట్ ఫాల్బ్యాక్ వ్యూహం) కోసం, రిలే బ్యాకెండ్ వ్యూహం చూడండి.

కనిష్ఠ స్థానిక డెవలప్మెంట్

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

Docker ప్రొడక్షన్

JWT_SECRET=<generated>
API_KEY_SECRET=<generated>
INITIAL_PASSWORD=<generated>
STORAGE_ENCRYPTION_KEY=<generated>
DATA_DIR=/data
PORT=20128
API_PORT=20129
NODE_ENV=production
AUTH_COOKIE_SECURE=true
REQUIRE_API_KEY=true
NEXT_PUBLIC_BASE_URL=https://omniroute.example.com
BASE_URL=http://localhost:20128
OMNIROUTE_MEMORY_MB=8192
CORS_ORIGIN=https://your-frontend.example.com

ఎయిర్-గ్యాప్డ్ / CI

JWT_SECRET=test-jwt-secret-for-ci
API_KEY_SECRET=test-api-key-secret-for-ci
INITIAL_PASSWORD=testpass
NODE_ENV=production
OMNIROUTE_DISABLE_BACKGROUND_SERVICES=true
APP_LOG_TO_FILE=false

రివర్స్ ప్రాక్సీతో VPS (nginx + Cloudflare)

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

---

24. Skills శాండ్బాక్స్ (v3.8.0+)

Skills ఫ్రేమ్వర్క్ (src/lib/skills/) శాండ్బాక్స్ చేసిన వాతావరణంలో వినియోగదారు నిర్వచించిన ఆటోమేషన్లను అమలు చేసినప్పుడు వర్తించే పరిమితులు మరియు భద్రతా నియంత్రణలు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
SKILLS_SANDBOX_TIMEOUT_MS	10000 (10 సెక.)	src/lib/skills/builtins.ts	శాండ్బాక్స్ చేసిన స్కిల్ కోడ్కు ప్రతి అమలుకు వర్తించే వాల్-క్లాక్ గడువు. ఇది కఠిన పరిమితి; దీనికంటే ఎక్కువ సమయం పట్టే ఏదైనా నిలిపివేయబడుతుంది.
SKILLS_EXECUTION_TIMEOUT_MS	(SKILLS_SANDBOX_TIMEOUT_MSకు ఫాల్బ్యాక్ అవుతుంది)	src/lib/skills/	ఉన్నత-స్థాయి స్కిల్ ఆర్కెస్ట్రేషన్ గడువు. బహుళ-దశల వర్క్ఫ్లోలను అనుమతించడానికి దీన్ని SKILLS_SANDBOX_TIMEOUT_MS కంటే ఎక్కువగా సెట్ చేయండి.
SKILLS_MAX_FILE_BYTES	1048576 (1 MB)	src/lib/skills/builtins.ts	శాండ్బాక్స్లోని ఏ ఒక్క ఫైల్ నుండైనా ఒక స్కిల్ చదవగల గరిష్ఠ బైట్ల సంఖ్య.
SKILLS_MAX_HTTP_RESPONSE_BYTES	256000 (250 KB)	src/lib/skills/builtins.ts	ఒక స్కిల్లోని ఏ ఒక్క HTTP ప్రతిస్పందన నుండైనా సంగ్రహించగల గరిష్ఠ బైట్ల సంఖ్య.
SKILLS_MAX_SANDBOX_OUTPUT_CHARS	100000	src/lib/skills/builtins.ts	శాండ్బాక్స్ ఇన్వొకేషన్ నుండి తిరిగి ఇచ్చే stdout/stderr అక్షరాలపై కఠిన పరిమితి.
SKILLS_SANDBOX_NETWORK_ENABLED	false	src/lib/skills/builtins.ts	శాండ్బాక్స్ లోపలి నుండి అవుట్బౌండ్ నెట్వర్క్ను అనుమతించడానికి 1/trueగా సెట్ చేయండి. భద్రత కోసం డిఫాల్ట్గా వేరుచేయబడి ఉంటుంది.
SKILLS_ALLOWED_SANDBOX_IMAGES	(ఖాళీ)	src/lib/skills/builtins.ts	శాండ్బాక్స్ అమలుకు అనుమతించబడిన కంటైనర్ ఇమేజ్ల కామాతో వేరు చేసిన అనుమతి జాబితా. ఖాళీగా ఉంటే అంతర్నిర్మిత డిఫాల్ట్ మాత్రమే అని అర్థం.
SKILLS_SANDBOX_DOCKER_IMAGE	(అంతర్నిర్మిత డిఫాల్ట్)	src/lib/skills/	Docker-ఆధారిత శాండ్బాక్స్ను ప్రారంభించేటప్పుడు ఉపయోగించే కంటైనర్ ఇమేజ్. అనుకూలమైన పటిష్ఠ బేస్ ఇమేజ్ను పిన్ చేయడానికి దీన్ని ఓవర్రైడ్ చేయండి.
SKILLS_SANDBOX_RUNTIME	auto	src/lib/skills/sandbox.ts, src/lib/skills/containerProvider.ts	స్కిల్ శాండ్బాక్సింగ్ కోసం కంటైనర్ రన్టైమ్: auto | docker | apple | wsl | orbstack | podman. auto ప్రతి హోస్ట్ OSలో ఇన్స్టాల్ చేసిన ఉత్తమ రన్టైమ్ను ఎంచుకుంటుంది (macOSలో Apple Container/OrbStack, Windowsలో WSL Container, Linuxలో Podman); అవి అందుబాటులో లేకపోతే Dockerను ఉపయోగిస్తుంది.

Caution

SKILLS_SANDBOX_NETWORK_ENABLED=trueను ప్రారంభించడం వలన ఏదైనా స్కిల్ కోడ్ నుండి ఎగ్రెస్ మార్గం తెరుచుకుంటుంది. భాగస్వామ్య డిప్లాయ్మెంట్లలో దీనితో పాటు OUTBOUND_SSRF_GUARD_ENABLED=true మరియు కఠినమైన CORS_ORIGIN/ప్రాక్సీ విధానాన్ని ఉపయోగించండి.

---

25. ప్రొవైడర్ కోటాలు, టన్నెల్లు, బ్యాకప్లు & ఇతర రన్టైమ్ అంశాలు

ప్రొవైడర్ కోటా ఎండ్పాయింట్లు, నెట్వర్క్ టన్నెల్లు (Tailscale, Ngrok, MITM డీబగ్ ప్రాక్సీ), 1Proxy ఎగ్రెస్ పూల్, డేటాబేస్ బ్యాకప్లు మరియు ఎగ్జిక్యూటర్ లేయర్ లేదా స్క్రిప్ట్లు సూచించే చిన్న ఫీచర్-నిర్దిష్ట ఓవర్రైడ్లు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
REDIS_URL	redis://localhost:6379	src/shared/utils/rateLimiter.ts	రేట్ లిమిటర్ బ్యాకెండ్ కోసం Redis కనెక్షన్ స్ట్రింగ్.
ALIBABA_CODING_PLAN_HOST	(ప్రొడక్షన్ హోస్ట్)	open-sse/services/bailianQuotaFetcher.ts	Alibaba Bailian కోడింగ్-ప్లాన్ కోటాలను పొందడానికి ఉపయోగించే హోస్ట్ను ఓవర్రైడ్ చేస్తుంది.
ALIBABA_CODING_PLAN_QUOTA_URL	హోస్ట్ నుండి ఉత్పన్నమవుతుంది	open-sse/services/bailianQuotaFetcher.ts	Alibaba Bailian కోసం పూర్తి కోటా URL ఓవర్రైడ్.
QWEN_CLOUD_COOKIE	(సెట్ చేయబడలేదు)	open-sse/services/qwenTokenPlanQuotaFetcher.ts	Qwen Cloud / Model Studio వ్యక్తిగత Token Plan కోటా గేట్వే కోసం కన్సోల్ సెషన్ కుకీ (ఇన్ఫరెన్స్ API కీ దీనిని చదవలేదు). home.qwencloud.com › Billing › Subscription (F12 › Network)లో cs-data.qwencloud.comకు చేసే ఏదైనా api.json కాల్ నుండి మొత్తం Cookie రిక్వెస్ట్ హెడర్ను కాపీ చేయండి — ఇందులో login_qwencloud_ticket ఉంటుంది. ఇది సున్నితమైనది మరియు సెషన్ పరిధికి పరిమితం; ప్రతి కనెక్షన్కు సంబంధించిన qwenCloudCookie Dashboard ఫీల్డ్కు ప్రాధాన్యం ఇవ్వండి.
QWEN_CLOUD_SEC_TOKEN	(సెట్ చేయబడలేదు)	open-sse/services/qwenTokenPlanQuotaFetcher.ts	Token Plan కన్సోల్ గేట్వే కోసం మాన్యువల్ sec_token ఓవర్రైడ్. ఇది సున్నితమైనది; సెట్ చేయనప్పుడు, ఫెచర్ కుకీని ఉపయోగించి డాష్బోర్డ్ HTML నుండి దీనిని పరిష్కరిస్తుంది.
QWEN_TOKEN_PLAN_HOST	https://cs-data.qwencloud.com	open-sse/services/qwenTokenPlanQuotaFetcher.ts	వ్యక్తిగత Token Plan కోటా ఫెచర్ కోసం గేట్వే హోస్ట్ ఓవర్రైడ్ (ఉదా. Model Studio కన్సోల్ కోసం bailian-singapore-cs.alibabacloud.com).
QWEN_TOKEN_PLAN_DASHBOARD_URL	https://home.qwencloud.com/	open-sse/services/qwenTokenPlanQuotaFetcher.ts	లాగిన్ చేసిన HTML నుండి sec_tokenను పరిష్కరించడానికి ఉపయోగించే డాష్బోర్డ్ URL.
ALIBABA_FREE_TIER_VISION_FE_PATH	/costing-balance/free-quota-image-video	open-sse/services/alibabaFreeTierQuotaFetcher.ts	Alibaba Model Studio ఫ్రీ-టియర్ విజన్/మీడియా కోటాను పొందడానికి కన్సోల్ ఫ్రంట్-ఎండ్ పాత్ ఓవర్రైడ్.
ALIBABA_FREE_TIER_MULTIMODAL_FE_PATH	/costing-balance/free-quota-multimodal	open-sse/services/alibabaFreeTierQuotaFetcher.ts	Alibaba Model Studio ఉచిత-స్థాయి మల్టీమోడల్ కోటాను పొందడానికి కన్సోల్ ఫ్రంట్-ఎండ్ పాత్ ఓవర్రైడ్.
ALIBABA_FREE_TIER_AUDIO_FE_PATH	/costing-balance/free-quota-audio	open-sse/services/alibabaFreeTierQuotaFetcher.ts	Alibaba Model Studio ఉచిత-స్థాయి ఆడియో కోటాను పొందడానికి కన్సోల్ ఫ్రంట్-ఎండ్ పాత్ ఓవర్రైడ్.
ALIBABA_FREE_TIER_ALLOWLIST_PATH	(సెట్ చేయబడలేదు)	open-sse/services/alibabaFreeTierAllowlist.ts	అంతర్నిర్మిత Alibaba ఉచిత-స్థాయి టెక్స్ట్-మోడల్ అనుమతి జాబితాను ఓవర్రైడ్ చేయడానికి స్థానిక JSONకు ఐచ్ఛిక పాత్. మొదట $DATA_DIR/alibaba-free-tier-allowlist.jsonకు, ఆపై config/alibaba-free-tier-allowlist.jsonకు ఫాల్బ్యాక్ అవుతుంది.
CONTEXT_RESERVE_TOKENS	1024	open-sse/services/contextManager.ts	ప్రాంప్ట్ బడ్జెట్లను గణించేటప్పుడు పూర్తీకరణ అవుట్పుట్ కోసం రిజర్వ్ చేయబడిన టోకెన్లు.
CONTEXT_KEEP_LATEST_IMAGES	2	open-sse/services/contextManager.ts	కాంటెక్స్ట్ విండోలో సరిపోయేలా పాత ఇన్లైన్ చిత్రాలను తొలగించేటప్పుడు, సరికొత్త చిత్రాలలో ఎన్నింటిని ఉంచాలి (#8560).
MODEL_ALIAS_COMPAT_ENABLED	ప్రారంభించబడింది	open-sse/services/model.ts	పాత క్లయింట్లు ఉపయోగించే లెగసీ మోడల్-అలియాస్ అనుకూలత లేయర్ను ఆన్ లేదా ఆఫ్ చేయండి.
OMNIROUTE_EMERGENCY_FALLBACK	ప్రారంభించబడింది	open-sse/services/emergencyFallback.ts	విఫలమైన అభ్యర్థనలను ఉచిత nvidia/openai/gpt-oss-120b మోడల్కు మళ్లించే అత్యవసర బడ్జెట్-అయిపోవడం ఫాల్బ్యాక్ను నిలిపివేయడానికి false (లేదా 0)గా సెట్ చేయండి. అమల్లో ఉండే ప్రాధాన్యత క్రమం: Feature Flags DB ఓవర్రైడ్ > env var > డిఫాల్ట్; అది అందుబాటులో లేకపోతే, సర్వీస్ ముడి env విలువకు ఫాల్బ్యాక్ అవుతుంది.
COMMAND_CODE_CALLBACK_PORT	(సెట్ చేయబడలేదు)	src/app/api/providers/command-code/auth/shared.ts	Command Code CLI సహాయకం నుండి వచ్చే OAuth-శైలి కాల్బ్యాక్ల కోసం ఉపయోగించే స్థానిక పోర్ట్.
COMMAND_CODE_VERSION	0.33.2	open-sse/executors/commandCode.ts	Command Code అప్స్ట్రీమ్కు x-command-code-version హెడర్గా పంపే విలువ. CLI వెర్షన్ను పెంచడానికి ఓవర్రైడ్ చేయండి.
COMMANDCODE_API_URL	https://api.commandcode.ai	open-sse/services/usage/command-code.ts	స్మార్ట్ఫోన్ కోటా-ఫెచర్ టెలిమెట్రీ ఉపయోగించే Command Code వినియోగం/కోటా అప్స్ట్రీమ్కు బేస్ URL. స్వయంగా హోస్ట్ చేసిన/ప్రత్యామ్నాయ Command Code API కోసం ఓవర్రైడ్ చేయండి.
MITM_LOCAL_PORT	443	src/mitm/server.cjs	MITM డీబగ్ ప్రాక్సీ కోసం స్థానిక బైండ్ పోర్ట్.
MITM_DISABLE_TLS_VERIFY	0	src/mitm/server.cjs	అప్స్ట్రీమ్ TLS ధృవీకరణను నిలిపివేయడానికి 1గా సెట్ చేయండి (అభివృద్ధి కోసం మాత్రమే).
MITM_IDLE_TIMEOUT_MS	60000	src/mitm/socketTimeouts.ts, src/mitm/server.cjs	ప్రాక్సీ చేయబడిన కనెక్షన్ల కోసం నిష్క్రియ సాకెట్ సమయం ముగింపు (ms); సగం-తెరిచి ఉన్న టన్నెల్లు లీక్ కాకుండా ఉండటానికి, ఈ సమయాన్ని దాటి నిష్క్రియంగా ఉన్న సాకెట్లు మూసివేయబడతాయి.
MITM_VERBOSE	1	src/mitm/server.cjs, src/mitm/_internal/bypass.cjs	రూటింగ్-నిర్ణయ లాగ్ వివరాల స్థాయి: 0 లాగింగ్ను నిలిపివేస్తుంది, అధిక విలువలు మరిన్ని బైపాస్/రూట్ నిర్ణయాలను లాగ్ చేస్తాయి.
MITM_ROOT_CA_ENABLED	false	src/mitm/manager.ts	రూట్-CA + ప్రతి-హోస్ట్-లీఫ్ సర్టిఫికేట్ మోడల్ను ఎంచుకోవడానికి trueగా సెట్ చేయండి (#6684). కొత్త ఇన్స్టాలేషన్లు దీన్ని స్వయంచాలకంగా పొందుతాయి; ముందే విశ్వసనీయ లెగసీ లీఫ్ ఉన్న ఇన్స్టాలేషన్లు దీనిని ఎంచుకోకపోతే లెగసీ స్థిర-SAN సర్టిఫికేట్నే ఉంచుకుంటాయి.
MITM_CERT_MODE	legacy	src/mitm/manager.ts, src/mitm/server.cjs	ప్రారంభించబడిన ప్రాక్సీ ప్రాసెస్ కోసం MITM మేనేజర్ ద్వారా సెట్ చేయబడుతుంది (root-ca | legacy) — ఇది సర్టిఫికేట్ మైగ్రేషన్ నిర్ణయాన్ని ప్రతిబింబిస్తుంది; దీన్ని మాన్యువల్గా సెట్ చేయకూడదు.
OMNIROUTE_NO_SUDO	0	src/mitm/systemCommands.ts	MITM సర్టిఫికేట్-ట్రస్ట్ కమాండ్ల ప్రారంభంలోని sudoను తొలగించడానికి 1 (ట్రూతీ)గా సెట్ చేయండి — ఆపరేటర్ CAను మాన్యువల్గా విశ్వసించే రూట్-లెస్ / యూజర్-నేమ్స్పేస్డ్ డిప్లాయ్మెంట్ల కోసం (ఉదా. Node యొక్క ఎక్స్ట్రా-CA-సర్ట్స్ విధానం ద్వారా).
SKIP_ANTIGRAVITY_DNS	(సెట్ చేయబడలేదు)	src/mitm/dns/provision.ts	Antigravity ప్రాక్సీ హోస్ట్నేమ్ల కోసం /etc/hosts DNS ఎంట్రీల ప్రొవిజనింగ్ను పూర్తిగా దాటవేయడానికి trueగా సెట్ చేయండి — sudo/root అందుబాటులో లేని కంటైనర్ల కోసం.
OMNIROUTE_SKIP_DNS_WRITE	(సెట్ చేయబడలేదు)	src/mitm/dns/dnsConfig.ts	DNS ఎంట్రీలను జోడించేటప్పుడు/తొలగించేటప్పుడు hosts ఫైల్కు రాయడాన్ని దాటవేయడానికి 1గా సెట్ చేయండి — శాండ్బాక్స్డ్ లేదా రీడ్-ఓన్లీ పరీక్షా వాతావరణాల కోసం.
OMNIROUTE_SKIP_SYSTEM_TRUST	0	src/mitm/cert/install.ts, src/mitm/tproxy/caTrust.ts	పరీక్ష/CI కోసం మాత్రమే ఉద్దేశించిన రక్షణ: సూట్ OS ట్రస్ట్ స్టోర్ను ఎప్పటికీ మార్చకుండా ఉండేలా, సర్టిఫికేట్ ట్రస్ట్ ఇన్స్టాల్/అన్ఇన్స్టాల్ను ఎటువంటి చర్య చేయనిదిగా మార్చడానికి 1గా సెట్ చేయండి. ఇది పరీక్ష సెటప్ మరియు CI వర్క్ఫ్లోల ద్వారా స్వయంచాలకంగా సెట్ చేయబడుతుంది.
CHANGELOG_BASE_REF	(auto)	scripts/check/check-changelog-integrity.mjs	anti CHANGELOG-eat గేట్ కోసం స్పష్టమైన base ref (CIలో డిఫాల్ట్గా PR base branch లేదా అత్యధిక release/v*).
FREE_PROXY_AUTO_SYNC_ENABLED	false	src/lib/freeProxyProviders/scheduler.ts	నేపథ్య free-proxy pool auto-sync schedulerను ప్రారంభించడానికి trueగా సెట్ చేయండి. ఇది opt-in; డిఫాల్ట్గా ఆఫ్లో ఉంటుంది.
FREE_PROXY_AUTO_SYNC_INTERVAL_MS	1800000	src/lib/freeProxyProviders/scheduler.ts	మిల్లీసెకన్లలో auto-sync విరామం (డిఫాల్ట్ 30 నిమి).
FREE_PROXY_1PROXY_ENABLED	true	src/lib/freeProxyProviders/oneproxy.ts	1proxy ఉచిత proxy sourceను ప్రారంభించండి. నిలిపివేయడానికి falseగా సెట్ చేయండి.
FREE_PROXY_1PROXY_API_URL	(oneproxy.ts చూడండి)	src/lib/freeProxyProviders/oneproxy.ts	1proxy API URL override.
FREE_PROXY_1PROXY_MAX	500	src/lib/freeProxyProviders/oneproxy.ts	ప్రతి syncలో 1proxy నుండి పొందే గరిష్ఠ proxies సంఖ్య.
FREE_PROXY_1PROXY_MIN_QUALITY	50	src/lib/freeProxyProviders/oneproxy.ts	1proxy imports కోసం కనిష్ఠ quality score threshold.
FREE_PROXY_PROXIFLY_ENABLED	true	src/lib/freeProxyProviders/proxifly.ts	Proxifly ఉచిత proxy sourceను ప్రారంభించండి. నిలిపివేయడానికి falseగా సెట్ చేయండి.
FREE_PROXY_PROXIFLY_QUANTITY	100	src/lib/freeProxyProviders/proxifly.ts	ప్రతి Proxifly syncలో పొందాల్సిన proxies సంఖ్య.
FREE_PROXY_PROXIFLY_ANONYMITY	elite	src/lib/freeProxyProviders/proxifly.ts	Proxifly కోసం anonymity level filter (elite, anonymous, transparent).
FREE_PROXY_IPLOCATE_ENABLED	false	src/lib/freeProxyProviders/iplocate.ts	IPLocate ఉచిత ప్రాక్సీ మూలాన్ని ప్రారంభించండి. ఎంపిక చేసుకుంటే మాత్రమే ప్రారంభమవుతుంది.
FREE_PROXY_IPLOCATE_BASE_URL	https://raw.githubusercontent.com/iplocate/free-proxy-list/main/protocols	src/lib/freeProxyProviders/iplocate.ts	IPLocate ప్రాక్సీ జాబితా బేస్ URLను ఓవర్రైడ్ చేస్తుంది.
FREE_PROXY_WEBSHARE_ENABLED	true	src/lib/freeProxyProviders/webshare.ts	Webshare ప్రాక్సీ పూల్ మూలాన్ని ప్రారంభించండి. నిలిపివేయడానికి falseగా సెట్ చేయండి; అలాగే FREE_PROXY_WEBSHARE_API_KEY కూడా తప్పనిసరిగా సెట్ చేసి ఉండాలి.
FREE_PROXY_WEBSHARE_API_KEY	(ఏదీ లేదు)	src/lib/freeProxyProviders/webshare.ts	Webshare ఖాతా API టోకెన్ (Authorization: Token <key>). ఇది తప్పనిసరి — ఇది లేకపోతే ప్రొవైడర్ నిలిపివేయబడిన స్థితిలోనే ఉంటుంది.
FREE_PROXY_WEBSHARE_API_URL	https://proxy.webshare.io/api/v2/proxy/list/	src/lib/freeProxyProviders/webshare.ts	Webshare ప్రాక్సీ జాబితా API URLను ఓవర్రైడ్ చేస్తుంది.
FREE_PROXY_WEBSHARE_MAX	500	src/lib/freeProxyProviders/webshare.ts	ప్రతి Webshare సింక్కు దిగుమతి చేసే ప్రాక్సీల గరిష్ఠ సంఖ్య.
NEXT_PUBLIC_VERCEL_RELAY_ENABLED	true	src/app/(dashboard)/…/ProxyPoolTab.tsx	ప్రాక్సీ పూల్ ట్యాబ్లో Deploy Vercel Relay బటన్ను చూపండి/దాచండి.
VERCEL_API_BASE	https://api.vercel.com	src/app/api/settings/proxy/vercel-deploy/route.ts	Vercel API బేస్ URLను ఓవర్రైడ్ చేస్తుంది (పరీక్ష కోసం).
NEXT_PUBLIC_VERCEL_RELAY_DEFAULT_PROJECT	omniroute-relay	src/app/(dashboard)/…/VercelRelayModal.tsx	Vercel Relay డిప్లాయ్ మోడల్లో ముందుగా పూరించబడే డిఫాల్ట్ ప్రాజెక్ట్ పేరు.
TAILSCALE_BIN	(స్వయంచాలకంగా గుర్తించబడుతుంది)	src/lib/tailscaleTunnel.ts	tailscale బైనరీకి స్పష్టమైన పాత్.
TAILSCALED_BIN	(స్వయంచాలకంగా గుర్తించబడుతుంది)	src/lib/tailscaleTunnel.ts	tailscaled డీమన్ బైనరీకి స్పష్టమైన పాత్.
TAILSCALE_AUTHKEY	(సెట్ చేయబడలేదు)	src/lib/tailscaleTunnel.ts	ఇంటరాక్టివ్ కాని / హెడ్లెస్ tailscale up కోసం ముందుగా షేర్ చేసిన Tailscale ప్రామాణీకరణ కీ (--auth-key= ద్వారా పంపబడుతుంది). ఇది సెట్ చేయకపోతే, లాగిన్ ఇంటరాక్టివ్ బ్రౌజర్ ప్రామాణీకరణ URLకు తిరిగి వెళ్తుంది.
NGROK_AUTHTOKEN	(సెట్ చేయబడలేదు)	src/lib/ngrokTunnel.ts	బయటకు వెళ్లే ngrok టన్నెల్లను ప్రామాణీకరిస్తుంది.
DB_BACKUP_MAX_FILES	20	src/lib/db/backup.ts	మాన్యువల్/షెడ్యూల్ చేసిన బ్యాకప్ శుభ్రపరిచే ప్రక్రియలో ఉంచబడే SQLite బ్యాకప్ ఫైళ్ల గరిష్ఠ సంఖ్య. మైగ్రేషన్ స్నాప్షాట్లు కంటెంట్ ఆధారంగా అడ్రస్ చేయబడతాయి మరియు ఒకే విధమైన DB స్థితి కోసం మళ్లీ ఉపయోగించబడతాయి; సమాంతర మైగ్రేషన్ విండోలో అవి తొలగించబడవు. Settings → Database backup retentionలో సేవ్ చేసిన విలువను ఇది భర్తీ చేస్తుంది.
DB_BACKUP_RETENTION_DAYS	0	src/lib/db/backup.ts	మాన్యువల్/షెడ్యూల్ చేసిన బ్యాకప్ శుభ్రపరిచే ప్రక్రియలో ఉంచబడే గరిష్ఠ వయస్సు (రోజుల్లో). 0 వయస్సు ఆధారిత తొలగింపును నిలిపివేస్తుంది. సమాంతర మైగ్రేషన్ విండోలో మైగ్రేషన్ స్నాప్షాట్లు తొలగించబడవు. Settings → Database backup retentionలో సేవ్ చేసిన విలువను ఇది భర్తీ చేస్తుంది.
OMNIROUTE_BACKUP_SCHEDULE_JOB_INTERVAL_MS	30000	src/lib/jobs/backupScheduleJob.ts	backup-schedule.jsonను అమలు చేసే సర్వర్-సైడ్ జాబ్ యొక్క టిక్ విరామం (ms). ఇది 1-నిమిషం cron గ్రాన్యులారిటీ కంటే చాలా తక్కువగా ఉండాలి; 5000 కంటే తక్కువ విలువలు లేదా పార్స్ చేయలేని విలువలు 30000కు తిరిగి వెళ్తాయి.
CONTAINER_HOST	docker	scripts/check-permissions.sh	ఎంట్రీపాయింట్ అనుమతుల తనిఖీ కోసం కంటైనర్ రన్టైమ్ సూచన. ఏదైనా Podman టోపాలజీ కోసం దీన్ని podmanగా సెట్ చేయండి. ఇంజిన్ స్థానికంగా ఉందా లేదా Podman Machine ద్వారా యాక్సెస్ చేయబడుతోందా అనేది కంటైనర్ నిర్ధారించలేనందున, హెచ్చరిక టోపాలజీకి తటస్థంగా ఉండి contrib/podman/README.mdను సూచిస్తుంది.
QUOTA_STORE_DRIVER	sqlite	src/lib/quota/storeFactory.ts	కోటా-షేర్ వినియోగ స్టోర్ బ్యాకెండ్: sqlite (డిఫాల్ట్) లేదా redis.
QUOTA_STORE_REDIS_URL	(సెట్ చేయబడలేదు)	src/lib/quota/storeFactory.ts	QUOTA_STORE_DRIVER=redis అయినప్పుడు ఉపయోగించే Redis కనెక్షన్ స్ట్రింగ్ (ఉదా. redis://localhost:6379).
QUOTA_SATURATION_THRESHOLD	0.5	src/lib/quota/enforce.ts	పూల్ సంతృప్త నిష్పత్తి (0..1); ఈ విలువ వద్ద లేదా అంతకంటే ఎక్కువగా ఉన్నప్పుడు పూల్ కఠిన మోడ్లోకి ప్రవేశిస్తుంది (అరువు తీసుకోవడం ఉండదు).
QUOTA_SOFT_DEPRIORITIZE_FACTOR	0.7	open-sse/services/combo.ts	సాఫ్ట్ కోటా విధానం ఒక లక్ష్యానికి ప్రాధాన్యతను తగ్గించినప్పుడు, దానికి వర్తించే స్కోర్ గుణకం (0..1).
STATUS_SOFT_DEPRIORITIZE_FACTOR	0.5	open-sse/services/combo/autoStrategy.ts	ప్రీఫ్లైట్ కోటా కటాఫ్ OFFలో ఉన్నప్పుడు (#4540), ఆటో-కాంబో స్కోరింగ్లో పరిమితి అయిపోయిన ప్రొవైడర్కు (credits_exhausted/rate_limited) వర్తించే స్కోర్ గుణకం (0..1).
QUOTA_CONSUMPTION_RETENTION_DAYS	14	src/lib/db/quotaConsumption.ts	GC (gcQuotaConsumption)కు ముందు quota_consumption బకెట్ల నిల్వ వ్యవధి (రోజుల్లో).
QUOTA_PREFLIGHT_CUTOFF_ENABLED	false	src/lib/resilience/settings.ts	ఎంపిక చేసుకుంటే మాత్రమే అమలయ్యేది (డిఫాల్ట్గా OFF): స్కోరింగ్కు ముందు తక్కువ కోటా ఉన్న అభ్యర్థులను తొలగించే ఆటో-రూటింగ్ హార్డ్ కోటా కటాఫ్ను ప్రారంభిస్తుంది.
OMNIROUTE_AUTO_FREE_FALLBACK_TO_FULL_POOL	false	open-sse/services/autoCombo/virtualFactory.ts	ఎంపిక చేసుకుంటే మాత్రమే అమలయ్యేది (డిఫాల్ట్గా OFF): auto/<category>:<tier> ఫిల్టర్కు కనెక్ట్ అయిన అభ్యర్థులేవీ సరిపోలనప్పుడు, ఖాళీ పూల్ను తిరిగి ఇవ్వడానికి బదులుగా పూర్తి (ఫిల్టర్ చేయని) పూల్కు ఫాల్బ్యాక్ అయ్యే పాత ప్రవర్తనను పునరుద్ధరిస్తుంది. డిఫాల్ట్గా OFF ఉండటం వల్ల :free అంటే "ఉచిత టియర్ మాత్రమే" అని అర్థం.
OMNIROUTE_CHAOS_MAX_PANEL	5	open-sse/services/autoCombo/virtualFactory.ts	auto/*:chaos బ్రాడ్కాస్ట్ వేరియంట్ కోసం ప్యానెల్ పరిమాణ గరిష్ఠ పరిమితి (1–10 మధ్యకు నియంత్రించబడుతుంది) — ఒక అభ్యర్థన గరిష్ఠంగా ఇంతమంది విభిన్న ప్రొవైడర్ల మోడళ్లకు విస్తరిస్తుంది.
OMNIROUTE_CHAOS_MIN_PANEL	(ఇంజిన్ డిఫాల్ట్)	open-sse/services/autoCombo/virtualFactory.ts	chaos బ్రాడ్కాస్ట్ హ్యాండ్లర్కు పంపే కనిష్ఠ ప్యానెల్ పరిమాణ సర్దుబాటు; సెట్ చేయకుండా ఉంచితే ఇంజిన్ డిఫాల్ట్ కొనసాగుతుంది.
OMNIROUTE_CHAOS_PANEL_TIMEOUT_MS	(ఇంజిన్ డిఫాల్ట్)	open-sse/services/autoCombo/virtualFactory.ts	మొత్తం chaos ప్యానెల్ ఫ్యాన్-అవుట్కు హార్డ్ టైమ్అవుట్ (ms); సెట్ చేయకుండా ఉంచితే ఇంజిన్ డిఫాల్ట్ కొనసాగుతుంది.
GROK_AUTH_PATH	~/.grok/auth.json	open-sse/services/grokQuotaFetcher.ts	grok-web వారపు కోటాను పొందడానికి ఉపయోగించే Grok CLI auth.json ఫైల్ పాత్; పరీక్షల కోసం లేదా ప్రామాణికం కాని CLI ఇన్స్టాలేషన్ కోసం దీన్ని ఓవర్రైడ్ చేయండి.
AGENTBRIDGE_UPSTREAM_CA_CERT	(సెట్ చేయలేదు)	src/mitm/manager.ts	AgentBridge అప్స్ట్రీమ్ TLS కనెక్షన్లు విశ్వసించే అదనపు CA సర్టిఫికేట్ (PEM).
INSPECTOR_BUFFER_SIZE	1000	src/mitm/inspector/buffer.ts	Traffic Inspector రింగ్ బఫర్లో ఉంచబడే క్యాప్చర్ చేసిన అభ్యర్థనల గరిష్ఠ సంఖ్య.
INSPECTOR_MAX_BODY_KB	1024	src/mitm/inspector/buffer.ts	కత్తిరింపుకు ముందు క్యాప్చర్ చేసిన అభ్యర్థన/ప్రతిస్పందన బాడీ గరిష్ఠ పరిమాణం (KB).
INSPECTOR_HTTP_PROXY_PORT	8080	src/mitm/inspector/httpProxyServer.ts	Traffic Inspector HTTP ప్రాక్సీ కోసం స్థానిక పోర్ట్.
INSPECTOR_HTTP_PROXY_AUTOSTART	false	src/mitm/inspector/httpProxyServer.ts	బూట్ సమయంలో ఇన్స్పెక్టర్ HTTP ప్రాక్సీని స్వయంచాలకంగా ప్రారంభిస్తుంది.
INSPECTOR_TLS_INTERCEPT	false	src/lib/inspector/captureState.ts	క్యాప్చర్ చేసిన HTTPS ట్రాఫిక్ కోసం TLS ఇంటర్సెప్షన్ (MITM)ను ప్రారంభిస్తుంది.
INSPECTOR_LLM_HOSTS_EXTRA	(సెట్ చేయబడలేదు)	src/lib/inspector/captureState.ts	క్యాప్చర్ కోసం LLM ఎండ్పాయింట్లుగా పరిగణించబడే అదనపు హోస్ట్ పేర్లు (కామాలతో వేరు చేసినవి).
INSPECTOR_MASK_SECRETS	true	src/mitm/inspector/buffer.ts	క్యాప్చర్ చేసిన ట్రాఫిక్లో రహస్యాలను (ప్రామాణీకరణ హెడర్లు / API కీలు) మాస్క్ చేస్తుంది.
INSPECTOR_SYSTEM_PROXY_GUARD_MINUTES	30	src/app/api/tools/traffic-inspector/capture-modes/system-proxy/route.ts	సిస్టమ్-ప్రాక్సీ గార్డ్ OS ప్రాక్సీ సెట్టింగ్లను స్వయంచాలకంగా మునుపటి స్థితికి మార్చడానికి ముందు నిమిషాల సంఖ్య.
INSPECTOR_INTERNAL_INGEST_TOKEN	(స్వయంచాలకం)	src/app/api/tools/traffic-inspector/internal/ingest/route.ts	ఇన్స్పెక్టర్లోకి అంతర్గత క్యాప్చర్ ఇన్జెస్ట్ను ప్రామాణీకరించే టోకెన్.
PLAYGROUND_COMPARE_MAX_COLUMNS	4	src/app/(dashboard)/dashboard/playground/	Playground పోలిక మోడ్లో పక్కపక్కన ఉండే నిలువు వరుసల గరిష్ఠ సంఖ్య.
PLAYGROUND_IMPROVE_PROMPT_DEFAULT_MODEL	(సెట్ చేయబడలేదు)	src/app/(dashboard)/dashboard/playground/	Playground 'ప్రాంప్ట్ను మెరుగుపరచు' చర్య కోసం డిఫాల్ట్ మోడల్ (సెట్ చేయనప్పుడు సక్రియ మోడల్కు తిరిగి వెళ్తుంది).
BIFROST_ENABLED	1	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Bifrost సైడ్కార్ ప్రాక్సీకి ప్రధాన కిల్ స్విచ్. దీన్ని 0కి సెట్ చేసినప్పుడు, రూట్ X-Bifrost-Killswitch హెడర్తో 503ని అందిస్తుంది మరియు ఆపరేటర్ను TS పాత్కు మళ్లిస్తుంది. మళ్లీ డిప్లాయ్ చేయకుండానే సైడ్కార్ను నిలిపివేయడానికి దీన్ని ఉపయోగించండి (టియర్-1 రౌటర్ సంఘటన, కీ రొటేషన్).
BIFROST_BASE_URL	(సెట్ చేయబడలేదు)	src/app/api/v1/relay/chat/completions/bifrost/route.ts	సెట్ చేసినప్పుడు, Bifrost సైడ్కార్ ప్రాక్సీ రూట్ /v1/chat/completions ట్రాఫిక్ను TS రిలే హ్యాండ్లర్కు బదులుగా ఈ Go గేట్వేకి ఫార్వర్డ్ చేస్తుంది. సెట్ చేయకపోతే → ఫాల్బ్యాక్తో-503. చివరి స్లాష్ తొలగించబడుతుంది.
BIFROST_PORT	8080	src/lib/services/bootstrap.ts	OmniRoute Bifrost సైడ్కార్ జీవితచక్రాన్ని నిర్వహించినప్పుడు, పర్యవేక్షిత Bifrost ఎంబెడెడ్ సర్వీస్ బైండ్ అయ్యే పోర్ట్ (127.0.0.1:<port>). డిఫాల్ట్గా 8080.
BIFROST_API_KEY	(సెట్ చేయబడలేదు)	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Bifrost గేట్వే కోసం API కీ (Authorization: Bearer ...గా పంపబడుతుంది). సెట్ చేయకపోతే, అభ్యర్థనలో చెల్లుబాటు అయ్యే OmniRoute API కీ ఉండాలని రూట్ ఆశిస్తుంది; ఈ కీ గేట్వే-వైపు ప్రామాణీకరణ కోసం మాత్రమే.
BIFROST_STREAMING_ENABLED	true	src/app/api/v1/relay/chat/completions/bifrost/route.ts	trueగా ఉన్నప్పుడు, Bifrost సైడ్కార్ రూట్ TS స్ట్రీమింగ్ ఎగ్జిక్యూటర్ ద్వారా కాకుండా గేట్వే ద్వారా SSEతో ప్రతిస్పందనలను తిరిగి స్ట్రీమ్ చేస్తుంది. గేట్వే ద్వారా నాన్-స్ట్రీమింగ్ JSON ప్రతిస్పందనలను నిర్బంధించడానికి 0కి సెట్ చేయండి.
BIFROST_TIMEOUT_MS	30000	src/app/api/v1/relay/chat/completions/bifrost/route.ts	Bifrost గేట్వేకి ప్రాక్సీ చేస్తున్నప్పుడు ప్రతి అభ్యర్థనకు టైమ్అవుట్ (ms). టైమ్అవుట్ అయినప్పుడు రూట్ X-Bifrost-Fallback హెడర్ ద్వారా TS రిలే పాత్ను అందిస్తుంది.
OMNIROUTE_BIFROST_KEY	(సెట్ చేయబడలేదు)	src/app/api/v1/relay/chat/completions/bifrost/route.ts	BIFROST_API_KEYకు ప్రత్యామ్నాయ పేరు (OMNIROUTE_* ద్వారా envని చదివే స్క్రిప్ట్లు ఉపయోగిస్తాయి). రెండూ సెట్ చేసినప్పుడు BIFROST_API_KEYకు ప్రాధాన్యం ఉంటుంది.
OMNIROUTE_RELAY_BACKEND	ts / auto	src/app/api/v1/relay/chat/completions/routingBackend.ts	/api/v1/relay/chat/completions కోసం రిలే బ్యాకెండ్: ts | bifrost | auto. ts = TypeScript రిలే (Bifrost కాన్ఫిగర్ చేయనప్పుడు డిఫాల్ట్); BIFROST_BASE_URL సెట్ చేయబడి, BIFROST_ENABLED ≠ 0గా ఉన్నప్పుడు auto Bifrostను ఎంచుకుంటుంది, సైడ్కార్ను చేరుకోలేకపోతే స్వయంచాలక TS ఫాల్బ్యాక్తో; bifrost Bifrostను నిర్బంధిస్తుంది (కఠినంగా, ఫాల్బ్యాక్ లేదు). ప్రామాణీకరణ/రేట్-లిమిట్/ఇంజెక్షన్-గార్డ్/అనుమతి జాబితా ఎల్లప్పుడూ ముందుగా Next రూట్లో అమలవుతాయి. ప్రతిస్పందనలు X-Routing-Backend / X-Routing-Fallback / X-Routing-Fallback-Reasonను కలిగి ఉంటాయి.
RELAY_ROUTING_BACKEND	(సెట్ చేయబడలేదు)	src/app/api/v1/relay/chat/completions/routingBackend.ts	OMNIROUTE_RELAY_BACKENDకు ఆమోదించబడిన ప్రత్యామ్నాయ పేరు (అదే ts | bifrost | auto విలువలు). రెండూ సెట్ చేసినప్పుడు OMNIROUTE_RELAY_BACKENDకు ప్రాధాన్యం ఉంటుంది.
OMNIROUTE_BIFROST_FAILURE_COOLDOWN_MS	5000	src/app/api/v1/relay/chat/completions/bifrostCooldown.ts	auto మోడ్లో Bifrost sidecar హాప్ విఫలమైన తర్వాత relay మళ్లీ sidecarను ప్రయత్నించే ముందు cooldown (ms); cooldown కొనసాగుతున్నంత వరకు ఇది నేరుగా TS మార్గానికి రూట్ చేసి, ఆ తర్వాత మళ్లీ పరీక్షిస్తుంది. 0 దీన్ని నిలిపివేస్తుంది. OMNIROUTE_RELAY_BACKEND=auto అయినప్పుడు మాత్రమే వర్తిస్తుంది.
OMNIROUTE_TLS_CERT	(సెట్ చేయలేదు)	bin/cli/commands/serve.mjs	HTTPS ద్వారా omniroute serve అందించడానికి PEM TLS సర్టిఫికేట్ పాత్ (--tls-certకు సమానం). దీన్ని తప్పనిసరిగా OMNIROUTE_TLS_KEYతో జత చేయాలి; అప్పుడు స్వతంత్ర server అదే listenerపై TLSను ముగిస్తుంది (wss:// మార్పు లేకుండా పనిచేస్తుంది). సెట్ చేయకపోతే → సాధారణ HTTP. cert/keyలో ఒకదాన్ని మాత్రమే అందించినా, లేదా చదవలేని పాత్ను అందించినా, హెచ్చరికను లాగ్ చేసి HTTPలోనే కొనసాగుతుంది.
OMNIROUTE_TLS_KEY	(సెట్ చేయలేదు)	bin/cli/commands/serve.mjs	omniroute serve HTTPS కోసం PEM TLS private key పాత్ (--tls-keyకు సమానం). దీన్ని తప్పనిసరిగా OMNIROUTE_TLS_CERTతో జత చేయాలి. OMNIROUTE_TLS_CERTను చూడండి.
OMNIROUTE_LOCAL_ENDPOINTS_ENABLED	0	src/lib/security/localEndpoints.ts	/api/local/* రూట్లకు ప్రధాన స్విచ్. సెట్ చేయనప్పుడు లేదా 0గా ఉన్నప్పుడు, productionలో అన్ని /api/local/* రూట్లు 503ను అందిస్తాయి. Redis launcher మరియు ఇలాంటి 1-click local service starterలను ప్రారంభించడానికి non-loopback deploymentలలో ఇది తప్పనిసరిగా 1గా ఉండాలి. isLocalOnlyPath() route-guard classificationతో అదనపు భద్రతను అందిస్తుంది (src/server/authz/routeGuard.tsలోని LOCAL_ONLY_API_PREFIXES).
OMNIROUTE_LOCAL_ENDPOINTS_TOKEN	(సెట్ చేయలేదు)	src/lib/security/localEndpoints.ts	loopbackలో లేని /api/local/* callerల కోసం Bearer token (ఉదా. desktop app). ఇది సెట్ చేసినప్పుడు, non-loopback IPల నుండి వచ్చే requestలు తప్పనిసరిగా Authorization: Bearer <token>ను కలిగి ఉండాలి. non-loopback deploymentలలో OMNIROUTE_LOCAL_ENDPOINTS_ENABLED=1గా ఉన్నప్పుడు ఇది అవసరం.
OMNIROUTE_REDIS_CONTAINER_NAME	omniroute-redis	bin/cli/commands/redis.mjs	1-click Redis launcher (omniroute redis up) కోసం container పేరు. CLI మరియు RedisLauncherPanel GUI రెండూ దీనిని ఉపయోగిస్తాయి.
OMNIROUTE_REDIS_HOST_PORT	6379	bin/cli/commands/redis.mjs	1-click Redis launcher కోసం host port. host ఇప్పటికే 6379ను bind చేస్తుంటే దీన్ని పెంచండి. container అంతర్గత port 6379గానే ఉంటుంది.
OMNIROUTE_REDIS_BIND_HOST	127.0.0.1	bin/cli/commands/redis.mjs	1-click Redis launcher ప్రచురించే host interface. launcher password లేకుండానే Redisను ప్రారంభిస్తుంది, కాబట్టి 0.0.0.0కు bind చేయడం వలన మీ LANలోని ప్రతి hostకు ప్రమాణీకరణ లేని Redis అందుబాటులోకి వస్తుంది — instanceపై మీరే passwordను సెట్ చేస్తే మాత్రమే దీన్ని విస్తరించండి.
REDIS_BIND_HOST	127.0.0.1	docker-compose.yml	docker-compose Redis sidecarను ప్రచురించే host interface (#9286). compose Redis requirepass లేకుండా నడుస్తుంది; app containerలు compose network (redis:6379) ద్వారా దాన్ని చేరుకుంటాయి — ప్రచురించిన port host-side tooling కోసం మాత్రమే ఉంది. 0.0.0.0 ప్రమాణీకరణ లేని Redisను మొత్తం LANకు బహిర్గతం చేస్తుంది.
REDIS_PORT	6379	docker-compose.yml	compose Redis sidecar కోసం host port.
APP_BIND_HOST	127.0.0.1	docker-compose.yml, docker-compose.prod.yml	docker-compose యాప్కు చెందిన dashboard/API/live-WS పోర్ట్లను ప్రచురించే హోస్ట్ ఇంటర్ఫేస్ (#12568). .env.example డిఫాల్ట్గా REQUIRE_API_KEY=falseతో పంపిణీ అవుతున్నందున, 0.0.0.0 అనామక /v1 LLM ప్రాక్సీని మొత్తం LAN/WANకు బహిర్గతం చేస్తుంది — REQUIRE_API_KEY=true చేసిన తర్వాత లేదా ముందున్న రివర్స్ ప్రాక్సీ తన స్వంత ప్రామాణీకరణను అమలు చేసినప్పుడు మాత్రమే దీన్ని విస్తరించండి.
QDRANT_BIND_HOST	127.0.0.1	docker-compose.yml	docker-compose Qdrant మెమరీ సైడ్కార్ను ప్రచురించే హోస్ట్ ఇంటర్ఫేస్ (#12578). REDIS_BIND_HOSTకు వర్తించే LAN-బహిర్గత తర్కమే దీనికీ వర్తిస్తుంది.
BIFROST_BIND_HOST	127.0.0.1	docker-compose.yml	docker-compose Bifrost రౌటర్ సైడ్కార్ను ప్రచురించే హోస్ట్ ఇంటర్ఫేస్ (#12578). REDIS_BIND_HOSTకు వర్తించే LAN-బహిర్గత తర్కమే దీనికీ వర్తిస్తుంది.
REDIS_KEY_PREFIX	omniroute:	src/shared/utils/rateLimiter.ts	ప్రతి OmniRoute Redis కీకి (రేట్ లిమిటర్, ప్రామాణీకరణ క్యాష్, కోటా స్టోర్, వార్మప్ సర్క్యూట్ బ్రేకర్) వర్తించే నేమ్స్పేస్ ప్రిఫిక్స్. Redis ఇన్స్టాన్స్ను ఇతర యాప్లతో పంచుకున్నప్పుడు కీ ఘర్షణలను నివారిస్తుంది (#11042).
OMNIROUTE_INTERNAL_SERVICE_TOKEN	(సెట్ చేయలేదు — విధానం నిలిపివేయబడింది)	src/lib/api/internalServiceAuth.ts	గుర్తింపును సంరక్షించే అంతర్గత REST హాప్ల కోసం భాగస్వామ్య రహస్యం (#9260): ఇతర స్థానిక OmniRoute రూట్లను కాల్ చేసే OmniRoute భాగాలు దీన్ని x-omniroute-internal-service-tokenగా పంపుతాయి, తద్వారా అసలు కాలర్ గుర్తింపు సంరక్షించబడుతుంది. timingSafeEqualతో పోల్చబడుతుంది.
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE	(సెట్ చేయలేదు)	src/lib/api/internalServiceAuth.ts	అంతర్గత సేవా టోకెన్ యొక్క రహస్య-ఫైల్ వేరియంట్: ట్రిమ్ చేసిన కంటెంట్ టోకెన్గా ఉండే ఫైల్కు పాత్. ఇన్లైన్ వేరియబుల్ సెట్ చేయనప్పుడు మాత్రమే దీనిని పరిశీలిస్తారు.
OPENROUTER_PROVIDER_STATS_ENABLED	true	src/lib/catalog/openrouterProviderStats.ts	OpenRouter వారపు ర్యాంకింగ్ గణాంకాలతో dashboard ప్రొవైడర్ల జాబితాను మరింత సమృద్ధిగా చేస్తుంది (#9324). డిఫాల్ట్గా ఆన్లో ఉంటుంది; బ్యాక్గ్రౌండ్ ఫెచ్ను పూర్తిగా దాటవేయడానికి falseగా సెట్ చేయండి (నాన్-బ్లాకింగ్, ఎప్పుడూ ప్రాణాంతకం కాదు).
OPENROUTER_PROVIDER_STATS_TTL_MS	86400000 (24గం.)	src/lib/catalog/openrouterProviderStats.ts	OpenRouter ప్రొవైడర్-గణాంకాల స్నాప్షాట్కు క్యాష్ TTL, మిల్లీసెకన్లలో.
OMNIROUTE_REDIS_IMAGE	redis:7-alpine	bin/cli/commands/redis.mjs	1-క్లిక్ Redis లాంచర్ ఉపయోగించే Redis ఇమేజ్. అవసరమైన విధంగా redis:8-alpine లేదా ప్రైవేట్ రిజిస్ట్రీ మిర్రర్తో ఓవర్రైడ్ చేయండి.
QDRANT_HOST	qdrant	(ఎంచుకుంటే మాత్రమే ఉపయోగించే క్లస్టర్ ప్రొఫైల్)	--profile memory సక్రియంగా ఉన్నప్పుడు Qdrant సైడ్కార్ యొక్క హోస్ట్నేమ్. డిఫాల్ట్గా ఇన్-నెట్వర్క్ qdrant సేవ పేరును సూచిస్తుంది; బాహ్య డిప్లాయ్మెంట్ కోసం ఓవర్రైడ్ చేయండి. కోడ్లో (src/lib/memory/vectorStore.ts:108) qdrantEnabled అనేది trueగా ఉన్నప్పుడు మాత్రమే వినియోగించబడుతుంది.
QDRANT_PORT	6333	(ఐచ్ఛిక క్లస్టర్ ప్రొఫైల్)	Qdrant సైడ్కార్ యొక్క REST పోర్ట్.
QDRANT_GRPC_PORT	6334	(ఐచ్ఛిక క్లస్టర్ ప్రొఫైల్)	Qdrant సైడ్కార్ యొక్క gRPC పోర్ట్. స్ట్రీమింగ్ ఆపరేషన్ల కోసం REST కంటే gRPCకి ప్రాధాన్యత ఇచ్చే క్లయింట్ లైబ్రరీలు దీన్ని ఉపయోగిస్తాయి.
QDRANT_API_KEY	(సెట్ చేయబడలేదు)	(ఐచ్ఛిక క్లస్టర్ ప్రొఫైల్)	Qdrant Cloud లేదా ప్రామాణీకరించబడిన ఆన్-ప్రెమైసెస్ ఇన్స్టాన్స్ కోసం ఐచ్ఛిక API కీ. ఖాళీగా ఉంటే → api-key హెడర్ పంపబడదు.
QDRANT_COLLECTION	omniroute-memory	(ఐచ్ఛిక క్లస్టర్ ప్రొఫైల్)	OmniRoute సంభాషణ మెమరీ ఎంబెడ్డింగ్ల కోసం కలెక్షన్ పేరు. మొదటిసారి అమలు చేసినప్పుడు QDRANT_VECTOR_SIZE డైమెన్షన్లతో సృష్టించబడుతుంది.
QDRANT_EMBEDDING_MODEL	text-embedding-3-small	(ఐచ్ఛిక క్లస్టర్ ప్రొఫైల్)	Qdrant కలెక్షన్ మెటాడేటాలో నమోదు చేయబడే డిఫాల్ట్ ఎంబెడ్డింగ్ మోడల్ పేరు. వాస్తవ ఎంబెడ్డింగ్లు OmniRoute సెట్టింగ్లలోని embeddingModel ఫీల్డ్ సూచించే ప్రొవైడర్ ద్వారా రూపొందించబడతాయి.
QDRANT_VECTOR_SIZE	1536	(ఐచ్ఛిక క్లస్టర్ ప్రొఫైల్)	ఎంబెడ్డింగ్ వెక్టర్ డైమెన్షన్. మీరు ఎంబెడ్ చేసే మోడల్తో ఇది సరిపోలాలి (text-embedding-3-small → 1536; ada-002 → 1536; nomic-embed-text → 768).
QDRANT_HNSW_EF_CONSTRUCT	128	(ఐచ్ఛిక క్లస్టర్ ప్రొఫైల్)	HNSW ఇండెక్స్ నిర్మాణ-సమయ ఖచ్చితత్వం. అధిక విలువ = నెమ్మదైన నిర్మాణం, వేగవంతమైన శోధన.
OMNIROUTE_ROTATION_ENABLED	true	open-sse/services/rotationConfig.ts	ఆపరేటర్ కాన్ఫిగర్ చేయగల ఖాతా రొటేషన్కు ప్రధాన స్విచ్. ఇది falseగా ఉన్నప్పుడు, దిగువన ఉన్న OMNIROUTE_ROTATE_* క్లాస్లలో ఏదీ ఖాతా ఫాల్బ్యాక్ను ట్రిగ్గర్ చేయదు (మాస్టర్-ఆఫ్ స్థితి డిఫాల్ట్గా ప్రారంభించబడిన 429/500/502 క్లాస్లను కూడా నిరోధిస్తుంది). దీనివల్ల పర్యవేక్షక ఫ్రంట్-ఎండ్ (ఉదా. VibeProxy డెస్క్టాప్ యాప్) తన స్వంత రొటేషన్ నియమాలను బ్యాకెండ్ ఖాతా-ఫాల్బ్యాక్ ఇంజిన్కు ప్రతిబింబించగలదు.
OMNIROUTE_ROTATION_RATE_LIMIT_RESET_SECONDS	0	open-sse/services/rotationConfig.ts	అప్స్ట్రీమ్ స్పష్టమైన రీసెట్ సూచనను ఇవ్వనప్పుడు, రేట్-పరిమితికి గురైన ఖాతాకు వర్తించే కూల్డౌన్ (సెకన్లలో). 0 = స్థిరమైన ఓవర్రైడ్కు బదులుగా ఇంజిన్ డిఫాల్ట్ కూల్డౌన్ను ఉపయోగించండి.
OMNIROUTE_ROTATION_DISABLE_TAG_WITHOUT_RESET	true	open-sse/services/rotationConfig.ts	ఫ్రంట్-ఎండ్లోని "రీసెట్ సమయం లేకుండా రేట్-పరిమితికి గురైనట్లు ట్యాగ్ చేయవద్దు" ప్రాధాన్యతకు ప్రతిబింబం.
OMNIROUTE_ROTATE_ON_429	true	open-sse/services/rotationConfig.ts	429 లోపాల కోసం ప్రతి-స్థితి ఫాల్బ్యాక్ను ప్రారంభిస్తుంది. falseగా ఉన్నప్పుడు (మరియు OMNIROUTE_ROTATION_ENABLED=true అయితే), 429 ఇకపై ఖాతా రొటేషన్ను ప్రేరేపించదు; బదులుగా క్లయింట్కు తిరిగి పంపబడుతుంది.
OMNIROUTE_ROTATE_429_THRESHOLD	1	open-sse/services/rotationConfig.ts	ఖాతాను రొటేట్ చేయడానికి ముందు OMNIROUTE_ROTATE_429_WINDOW_SECONDS వ్యవధిలో సంభవించాల్సిన 429 లోపాల సంఖ్య. 1 (డిఫాల్ట్) వెంటనే రొటేట్ చేసి, మునుపటి ప్రవర్తనను కొనసాగిస్తుంది.
OMNIROUTE_ROTATE_429_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	OMNIROUTE_ROTATE_429_THRESHOLD కోసం లెక్కించే 429 లోపాల స్లైడింగ్ విండో (సెకన్లలో).
OMNIROUTE_ROTATE_ON_500	true	open-sse/services/rotationConfig.ts	5xx సర్వర్ లోపాల కోసం ప్రతి-స్థితి ఫాల్బ్యాక్ను ప్రారంభిస్తుంది (502 మినహా, దానికి ప్రత్యేక తరగతి ఉంది). falseగా ఉన్నప్పుడు, ఈ లోపాలు ఇకపై ఖాతా రొటేషన్ను ప్రేరేపించవు.
OMNIROUTE_ROTATE_500_THRESHOLD	1	open-sse/services/rotationConfig.ts	ఖాతాను రొటేట్ చేయడానికి ముందు OMNIROUTE_ROTATE_500_WINDOW_SECONDS వ్యవధిలో సంభవించాల్సిన 5xx లోపాల సంఖ్య. 1 (డిఫాల్ట్) వెంటనే రొటేట్ చేస్తుంది.
OMNIROUTE_ROTATE_500_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	OMNIROUTE_ROTATE_500_THRESHOLD కోసం లెక్కించే 5xx లోపాల స్లైడింగ్ విండో (సెకన్లలో).
OMNIROUTE_ROTATE_ON_502	true	open-sse/services/rotationConfig.ts	502 (బ్యాడ్ గేట్వే) లోపాల కోసం ప్రతి-స్థితి ఫాల్బ్యాక్ను ప్రారంభిస్తుంది. falseగా ఉన్నప్పుడు, 502లు ఇకపై ఖాతా రొటేషన్ను ప్రేరేపించవు.
OMNIROUTE_ROTATE_502_THRESHOLD	1	open-sse/services/rotationConfig.ts	ఖాతాను రొటేట్ చేయడానికి ముందు OMNIROUTE_ROTATE_502_WINDOW_SECONDS వ్యవధిలో సంభవించాల్సిన 502 లోపాల సంఖ్య. 1 (డిఫాల్ట్) వెంటనే రొటేట్ చేస్తుంది.
OMNIROUTE_ROTATE_502_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	OMNIROUTE_ROTATE_502_THRESHOLD కోసం లెక్కించే 502 లోపాల స్లైడింగ్ విండో (సెకన్లలో).
OMNIROUTE_ROTATE_ON_400	false	open-sse/services/rotationConfig.ts	ఎంపిక చేసుకుంటే మాత్రమే ప్రారంభమవుతుంది (డిఫాల్ట్గా OFF): trueగా ఉన్నప్పుడు, సాధారణ 400 (బ్యాడ్ రిక్వెస్ట్) కూడా ఖాతా రొటేషన్ను ప్రేరేపిస్తుంది. ఇది అదనపు ప్రవర్తన మాత్రమే — ఈ ఫ్లాగ్తో సంబంధం లేకుండా, రేట్-లిమిట్/కోటా టెక్స్ట్ను కలిగి ఉన్న 400 ఇప్పటికీ ఫాల్ఓవర్ అయ్యే ఇంజిన్ ప్రస్తుత ప్రవర్తనను ఇది ఎప్పటికీ నిరోధించదు.
OMNIROUTE_ROTATE_400_THRESHOLD	1	open-sse/services/rotationConfig.ts	ఖాతాను రొటేట్ చేయడానికి ముందు OMNIROUTE_ROTATE_400_WINDOW_SECONDS వ్యవధిలో సంభవించాల్సిన 400 లోపాల సంఖ్య (OMNIROUTE_ROTATE_ON_400=true అయినప్పుడు మాత్రమే పరిగణించబడుతుంది).
OMNIROUTE_ROTATE_400_WINDOW_SECONDS	120	open-sse/services/rotationConfig.ts	OMNIROUTE_ROTATE_400_THRESHOLD కోసం 400 లోపాలను లెక్కించే స్లైడింగ్ విండో (సెకన్లలో).

Claude వార్మప్ షెడ్యూలర్

ఎంపిక చేసుకున్న Anthropic OAuth కనెక్షన్ల కోసం cron-ఆధారిత వార్మప్; దీనివల్ల 5-గంటల రేట్-లిమిట్ విండో మొదటి నిజమైన అభ్యర్థన ద్వారా కాకుండా, షెడ్యూల్ చేసిన ఒక సాధారణ అభ్యర్థన ద్వారా తెరవబడుతుంది (#8848). OMNIROUTE_WARMUP_ENABLED సత్య విలువగా మరియు కనెక్షన్ settings.claudeWarmup.connectionsలో ఫ్లాగ్ చేయబడి ఉంటే తప్ప షెడ్యూలర్ ఆఫ్లో ఉంటుంది; env var ఆన్లో ఉన్నప్పటికీ, కనెక్షన్ జాబితా ఖాళీగా ఉంటే ఏదీ వార్మప్ చేయబడదు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_WARMUP_ENABLED	(సెట్ చేయలేదు → ఆఫ్)	src/lib/warmupScheduler.ts	వార్మప్ షెడ్యూలర్ కోసం మాస్టర్ స్విచ్. 1/true/yes/on విలువలను అంగీకరిస్తుంది (కేస్తో సంబంధం లేకుండా, ఖాళీలు తొలగించిన తర్వాత). మరే ఇతర విలువ అయినా, లేదా సెట్ చేయకపోయినా, షెడ్యూలర్ ఆఫ్లోనే ఉంటుంది.
OMNIROUTE_WARMUP_CRON	0 7 * * *	src/lib/warmupScheduler.ts	హోస్ట్ గడియారంతో సంబంధం లేకుండా America/Los_Angelesలో (Anthropic రీసెట్ టైమ్జోన్) మూల్యాంకనం చేయబడే వార్మప్ టిక్ కోసం ఐదు-ఫీల్డ్ల cron ఎక్స్ప్రెషన్.
OMNIROUTE_WARMUP_CONCURRENCY	3	src/lib/warmupScheduler.ts	ప్రతి టిక్లో సమాంతరంగా వార్మప్ చేయబడే కనెక్షన్ల సంఖ్య. 1-10 పరిధికి పరిమితం చేయబడుతుంది; సంఖ్య కాని విలువకు 3 ఫాల్బ్యాక్గా ఉపయోగించబడుతుంది.
OMNIROUTE_WARMUP_MODEL	claude-3-5-haiku-20241022	src/lib/warmupScheduler.ts	వార్మప్ అభ్యర్థన కోసం ఉపయోగించే మోడల్. మీ ప్లాన్లో డిఫాల్ట్ అందుబాటులో లేనప్పుడు మాత్రమే ఓవర్రైడ్ చేయండి; విండోను తెరవగల అత్యంత చవకైన మోడల్ను ఎంచుకోండి.

బ్రౌజర్-లాగిన్ VNC సెషన్లు & డేటా-డైరెక్టరీ అలియాస్

ఇంటరాక్టివ్ బ్రౌజర్-లాగిన్ క్రెడెన్షియల్ క్యాప్చర్ (/api/vnc-session) కోసం ఉపయోగించే కంటైనరైజ్డ్ Chromium+VNC, దానితో పాటు లెగసీ DATA_DIR అలియాస్. ఇవన్నీ ఐచ్ఛికం — VNC డిఫాల్ట్లు బండిల్ చేసిన omniroute-vnc-chromium:local ఇమేజ్ను లక్ష్యంగా చేసుకుంటాయి; కస్టమ్ కంటైనర్ ఇమేజ్, పోర్ట్లు లేదా లైఫ్సైకిల్ ట్యూనింగ్ కోసం మాత్రమే వాటిని ఓవర్రైడ్ చేస్తారు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_VNC_IMAGE	omniroute-vnc-chromium:local	src/lib/vncSession/manifest.ts	Chromium+VNC లాగిన్ కంటైనర్ కోసం Docker ఇమేజ్ ట్యాగ్. docker/vnc-browser/chromiumను బిల్డ్ చేయండి లేదా దీన్ని అనుకూల ఇమేజ్కు సూచించేలా సెట్ చేయండి.
OMNIROUTE_DOCKER_BIN	docker	src/lib/vncSession/manifest.ts	VNC కంటైనర్ను ప్రారంభించడానికి ఉపయోగించే కంటైనర్ రన్టైమ్ బైనరీ (ఉదా. podmanకు సెట్ చేయండి).
OMNIROUTE_VNC_CONTAINER_VNC_PORT	3000	src/lib/vncSession/manifest.ts	కంటైనర్ లోపల ఎక్స్పోజ్ చేయబడిన VNC/noVNC పోర్ట్.
OMNIROUTE_VNC_CONTAINER_CDP_PORT	9223	src/lib/vncSession/manifest.ts	కంటైనర్ లోపల ఉన్న Chrome DevTools Protocol పోర్ట్.
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR	/config	src/lib/vncSession/manifest.ts	కంటైనర్ లోపల ఉన్న Chromium ప్రొఫైల్ డైరెక్టరీ పాత్.
OMNIROUTE_VNC_PROFILE_DIR	$HOME/.omniroute/browser-login-profiles	src/lib/vncSession/manifest.ts	స్థిరంగా నిల్వచేసిన బ్రౌజర్-లాగిన్ ప్రొఫైల్లను కలిగి ఉండే హోస్ట్ డైరెక్టరీ.
OMNIROUTE_VNC_IDLE_MS	600000 (10 నిమి)	src/lib/vncSession/manifest.ts	నిష్క్రియ VNC సెషన్ తొలగించబడటానికి ముందు ఉండే నిష్క్రియ సమయ పరిమితి (ms).
OMNIROUTE_VNC_MAX_MS	1800000 (30 నిమి)	src/lib/vncSession/manifest.ts	ఒక్క VNC సెషన్ జీవితకాలంపై గరిష్ఠ పరిమితి (ms).
OMNIROUTE_VNC_MAX_SESSIONS	4	src/lib/vncSession/manifest.ts	ఏకకాలంలో ఉండగల VNC సెషన్ల గరిష్ఠ సంఖ్య.
OMNIROUTE_VNC_READY_MS	45000	src/lib/vncSession/manifest.ts	కంటైనర్లోని బ్రౌజర్ CDP-సిద్ధంగా మారే వరకు వేచి ఉండే సమయ పరిమితి (ms).
OMNIROUTE_VNC_HARVEST_MS	20000	src/lib/vncSession/manifest.ts	లాగిన్ పూర్తయిన తర్వాత క్యాప్చర్ చేసిన సెషన్/కుకీలను సేకరించడానికి సమయ పరిమితి (ms).
OMNIROUTE_VNC_CHROMIUM_ARGS	--remote-debugging-port=9222 --no-first-run --no-default-browser-check	src/lib/vncSession/manifest.ts	కంటైనర్లోని Chromiumకు పంపబడే అదనపు కమాండ్-లైన్ ఫ్లాగ్లు.
OMNIROUTE_VNC_NETWORK	omniroute-vnc-browser-login	src/lib/vncSession/manifest.ts	VNC లాగిన్ కంటైనర్ డిఫాల్ట్ బ్రిడ్జ్కు బదులుగా చేరే ప్రత్యేక Docker నెట్వర్క్ (#12571); దీని వల్ల సహోదర కంటైనర్లు దాని CDP బ్రిడ్జ్ పోర్ట్ను చేరుకోలేవు.
VIBEPROXY_DATA_DIR	(సెట్ చేయబడలేదు)	open-sse/services/notionThreadSessions.ts	DATA_DIRకు లెగసీ అలియాస్; DATA_DIR మరియు OMNIROUTE_DATA_DIR రెండూ సెట్ చేయబడనప్పుడు మాత్రమే తనిఖీ చేయబడుతుంది. Notion వెబ్-థ్రెడ్ సెషన్ క్యాష్ (<dir>/notion-web-thread-sessions.json) స్థానాన్ని నిర్ధారిస్తుంది.

---

26. టెస్ట్ & E2E హార్నెస్

scripts/dev/run-next-playwright.mjs, scripts/dev/smoke-electron-packaged.mjs, scripts/dev/run-ecosystem-tests.mjs, మరియు scripts/build/uninstall.mjs ద్వారా ఉపయోగించబడుతుంది. ప్రొడక్షన్ డిప్లాయ్మెంట్లలో దిగువనున్న ప్రతి విలువను సెట్ చేయకుండా వదిలివేయండి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_E2E_BOOTSTRAP_MODE	auth	scripts/dev/run-next-playwright.mjs	Playwright రన్నర్ కోసం E2E బూట్స్ట్రాప్ మోడ్ (auth, fresh, reuse).
OMNIROUTE_E2E_PASSWORD	INITIAL_PASSWORDకు ఫాల్బ్యాక్ అవుతుంది	scripts/dev/run-next-playwright.mjs	Playwright ఎన్విరాన్మెంట్లోకి ఇంజెక్ట్ చేయబడే అడ్మిన్ పాస్వర్డ్.
OMNIROUTE_DISABLE_LOCAL_HEALTHCHECK	true	scripts/dev/run-next-playwright.mjs	Playwright రన్ల సమయంలో లోకల్ హెల్త్చెక్ పోలింగ్ను నిలిపివేస్తుంది.
OMNIROUTE_DISABLE_TOKEN_HEALTHCHECK	true	scripts/dev/run-next-playwright.mjs	టెస్ట్ల సమయంలో OAuth టోకెన్ హెల్త్చెక్ లూప్ను నిలిపివేస్తుంది.
OMNIROUTE_HEALTHCHECK_SKIP_PROVIDERS	(సెట్ చేయబడలేదు)	src/lib/tokenHealthCheck.ts	ముందస్తు టోకెన్-రిఫ్రెష్ స్వీప్ నుండి మినహాయించబడిన, కామాలతో వేరు చేసిన ప్రొవైడర్లు (ఉదా. codex,openai). హెల్త్చెక్ను పూర్తిగా నిలిపివేయడానికి లక్షిత ప్రత్యామ్నాయం — తక్కువ-TTL ప్రొవైడర్లు రిఫ్రెష్ అవుతూనే ఉంటాయి, కాగా క్యాస్కేడ్ ప్రొవైడర్లు ప్రతిస్పందనాత్మకంగా మాత్రమే ఉంటాయి.
OMNIROUTE_HIDE_HEALTHCHECK_LOGS	true	scripts/dev/run-next-playwright.mjs	Playwright stdoutలోని హెల్త్చెక్ అనవసర అవుట్పుట్ను నిశ్శబ్దం చేస్తుంది.
OMNIROUTE_PLAYWRIGHT_SKIP_BUILD	0	scripts/dev/run-next-playwright.mjs	Playwright ప్రారంభమయ్యే ముందు Next.js ప్రొడక్షన్ బిల్డ్ను దాటవేస్తుంది (CI ఆప్టిమైజేషన్).
OMNIROUTE_SKIP_UNINSTALL_HOOK	0	scripts/build/uninstall.mjs	OmniRoute అన్ఇన్స్టాల్ హుక్ను దాటవేస్తుంది (node_modulesను యథాతథంగా ఉంచడానికి CI ద్వారా ఉపయోగించబడుతుంది).
ECOSYSTEM_SERVER_WAIT_MS	180000	scripts/dev/run-ecosystem-tests.mjs	ఎకోసిస్టమ్/ప్రోటోకాల్ టెస్ట్లను అమలు చేయడానికి ముందు సర్వర్ ఆరోగ్యకరంగా మారేందుకు వేచి ఉండే సమయం (ms).
ELECTRON_SMOKE_URL	http://127.0.0.1:20128/login	scripts/dev/smoke-electron-packaged.mjs	ప్యాకేజ్ చేసిన యాప్ అందించాలని Electron స్మోక్ హార్నెస్ ఆశించే URL.
ELECTRON_SMOKE_TIMEOUT_MS	45000	scripts/dev/smoke-electron-packaged.mjs	స్మోక్ హార్నెస్ ప్రయత్నాన్ని విరమించడానికి ముందు మొత్తం టైమ్అవుట్ (ms).
ELECTRON_SMOKE_SETTLE_MS	2000	scripts/dev/smoke-electron-packaged.mjs	పేజీ లోడ్ అయిన తర్వాత స్థిరపడే వ్యవధి (ms).
ELECTRON_SMOKE_APP_EXECUTABLE	(ఆటో)	scripts/dev/smoke-electron-packaged.mjs	ప్యాకేజ్ చేసిన Electron ఎగ్జిక్యూటబుల్కు స్పష్టమైన పాత్.
ELECTRON_SMOKE_DATA_DIR	(tmpdir)	scripts/dev/smoke-electron-packaged.mjs	Electron స్మోక్ రన్ కోసం డేటా డైరెక్టరీ.
ELECTRON_SMOKE_KEEP_DATA	0	scripts/dev/smoke-electron-packaged.mjs	అమలు పూర్తయిన తర్వాత స్మోక్ డేటా డైరెక్టరీని అలాగే ఉంచడానికి 1గా సెట్ చేయండి.
ELECTRON_SMOKE_STREAM_LOGS	0	scripts/dev/smoke-electron-packaged.mjs	అమలు సమయంలో Electron లాగ్లను stdoutకు స్ట్రీమ్ చేయడానికి 1గా సెట్ చేయండి.
ELECTRON_SMOKE_COLD_RESTART	0	scripts/dev/smoke-electron-packaged.mjs	#7592: అదే డేటా డైరెక్టరీతో మళ్లీ ప్రారంభించి, రెండవ ప్రారంభం స్థానిక SQLite డ్రైవర్ను ఎంచుకుంటుందని నిర్ధారించండి.
CLI_DEVIN_BIN	(PATH శోధన)	open-sse/executors/devin-cli.ts	Devin CLI బైనరీ పాత్ను ఓవర్రైడ్ చేయండి.

డాక్యుమెంటేషన్ అనువాద పైప్లైన్

scripts/i18n/run-translation.mjs (npm run i18n:run కమాండ్) ద్వారా ఉపయోగించబడుతుంది. ఐదు వేరియబుల్స్ అన్నీ డిఫాల్ట్గా సెట్ చేయబడవు — డాక్యుమెంటేషన్ అనువాదకాన్ని అమలు చేయగల మెషీన్లలో మాత్రమే వాటిని .envలో సెట్ చేయండి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_TRANSLATION_API_URL	(సెట్ చేయబడలేదు)	scripts/i18n/run-translation.mjs	అనువాద బ్యాకెండ్ కోసం OpenAI-అనుకూలమైన బేస్ URL.
OMNIROUTE_TRANSLATION_API_KEY	(సెట్ చేయబడలేదు)	scripts/i18n/run-translation.mjs	అనువాద బ్యాకెండ్ కోసం బేరర్ టోకెన్ (ఎప్పుడూ లాగ్ చేయబడదు).
OMNIROUTE_TRANSLATION_MODEL	(సెట్ చేయబడలేదు)	scripts/i18n/run-translation.mjs	మోడల్ ID, ఉదా. gpt-4o-mini లేదా cx/gpt-5.4-mini.
OMNIROUTE_TRANSLATION_TIMEOUT_MS	60000	scripts/i18n/run-translation.mjs	ప్రతి అభ్యర్థనకు మిల్లీసెకన్లలో టైమ్అవుట్.
OMNIROUTE_TRANSLATION_CONCURRENCY	4	scripts/i18n/run-translation.mjs	బహుళ ఫైళ్లు / లోకేల్లపై అమలు చేస్తున్నప్పుడు సమాంతర అనువాద అభ్యర్థనలు.

---

27. రాడార్ ఫీడ్ (స్వీయ-హోస్టింగ్)

RADAR_ENABLED ఫీచర్ ఫ్లాగ్ ద్వారా నియంత్రించబడే ఐచ్ఛిక యాడ్-ఆన్ (డిఫాల్ట్గా ఆఫ్ — ఇది Settings/DB ద్వారా టాగుల్ చేయబడే ఫీచర్ ఫ్లాగ్, env var కాదు; చూడండి docs/frameworks/RADAR.md). దిగువన ఉన్న మొదటి నాలుగు వేరియబుల్స్ స్వీయ-హోస్ట్ చేసిన లేదా ఫోర్క్ చేసిన ఫీడ్ మరియు సపోర్టర్-కీ ఫ్లోల కోసం ఐచ్ఛిక ఓవర్రైడ్లు. ఐదవది, RADAR_ADMIN_URL, యజమాని యొక్క ప్రైవేట్ ఆపరేషన్స్ ప్యానెల్కు డిఫాల్ట్ లేని ప్రత్యేక లింక్. పూర్తి మాడ్యూల్ డాక్యుమెంటేషన్ మరియు దాని ఎండ్-టు-ఎండ్ యాక్టివేషన్ మరియు గైడెడ్-సెటప్ క్రమం కోసం docs/frameworks/RADAR.md చూడండి.

సాధారణ Home/Changelog ప్రకటన రీడర్ environment variable ద్వారా కాన్ఫిగర్ చేయబడదు మరియు RADAR_ENABLED ఫీచర్ ఫ్లాగ్పై ఆధారపడదు. ఇది src/shared/utils/releaseNotes.tsలో ప్రకటించిన పబ్లిక్ రిపోజిటరీ news.json URLను GET ద్వారా మాత్రమే చదువుతుంది; విస్మరణ IDలు బ్రౌజర్ లోకల్ స్టోరేజ్లోనే ఉంటాయి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
RADAR_FEED_URL	https://radar.omniroute.online	src/lib/radar/{sync,referralsSync,offersSync,intelSync}.ts	విడిగా సంతకం చేయబడిన కేటలాగ్, రెఫరల్స్, సపోర్టర్-ఆఫర్లు మరియు Intel ఫీడ్లు పంచుకునే బేస్ URL. స్వీయ-హోస్ట్ చేసిన లేదా ఫోర్క్ చేసిన సర్వీస్ను సూచించడానికి దీన్ని ఓవర్రైడ్ చేయండి.
RADAR_FEED_PUBKEY	(పిన్ చేయబడిన డిఫాల్ట్ కీ)	src/lib/radar/pinnedKeys.ts	అనుకూల ఫీడ్ నుండి వచ్చే ఫీడ్ సంతకాలను ధృవీకరించడానికి ఉపయోగించే Ed25519 పబ్లిక్ కీ (base64-DER SPKI లేదా PEM).
RADAR_CONTRIBUTOR_CLAIM_URL	https://radar.omniroute.online/auth/github	src/lib/radar/links.ts	"నేను కంట్రిబ్యూటర్ను" డ్యాష్బోర్డ్ బటన్ తెరిచే URL (GitHub OAuth సపోర్టర్-కీ క్లెయిమ్ ఫ్లో).
RADAR_SUPPORTER_PLANS_URL	https://radar.omniroute.online/planos	src/lib/radar/links.ts	"ప్రాజెక్ట్కు మద్దతు ఇవ్వండి" డ్యాష్బోర్డ్ బటన్ తెరిచే URL (చెల్లింపు/ప్లాన్ల పేజీ).
RADAR_ADMIN_URL	(సెట్ చేయబడలేదు)	src/lib/radar/links.ts	యజమానికి మాత్రమే అందుబాటులో ఉండే ప్రైవేట్ ఆపరేషన్స్-ప్యానెల్ లింక్. HTTP లూప్బ్యాక్ SSH ఫార్వర్డ్ మినహా HTTPS తప్పనిసరి; సెట్ చేయని లేదా చెల్లని విలువలు నావిగేషన్ ఐటెమ్ను సృష్టించవు.

---

ఆడిట్: తొలగించబడిన / నిరుపయోగ వేరియబుల్స్

కింది వేరియబుల్స్ .env.example యొక్క మునుపటి వెర్షన్లలో కనిపించాయి, కానీ ప్రస్తుత కోడ్బేస్లో వాటికి రన్టైమ్ రిఫరెన్స్లు లేవు. అవి తొలగించబడ్డాయి:

వేరియబుల్	కారణం
STORAGE_DRIVER=sqlite	ఏ సోర్స్ ఫైల్ కూడా దీనిని చదవదు. SQLite మాత్రమే మద్దతు ఉన్న డ్రైవర్ — ఎంపిక అవసరం లేదు.
INSTANCE_NAME=omniroute	పాత డాక్యుమెంటేషన్/env టెంప్లేట్లలో ఉంది, కానీ రన్టైమ్లో ఉపయోగించబడదు. భవిష్యత్తులో మల్టీ-ఇన్స్టాన్స్ ఫీచర్లో తిరిగి రావచ్చు.
SQLITE_MAX_SIZE_MB=2048	సోర్స్ కోడ్లో దీనికి సూచన లేదు. డేటాబేస్ పరిమాణం కృత్రిమంగా పరిమితం చేయబడదు.
SQLITE_CLEAN_LEGACY_FILES=true	సోర్స్ కోడ్లో దీనికి సూచన లేదు. పాత ఫైళ్ల క్లీనప్ బహుశా తొలగించబడింది.
CLI_ROO_BIN	src/shared/services/cliRuntime.tsలో నమోదు చేయబడలేదు.
CLI_KIMI_CODING_BIN	src/shared/services/cliRuntime.tsలో నమోదు చేయబడలేదు (Kimi Coding CLI బైనరీని కాకుండా OAuthను ఉపయోగిస్తుంది).
IFLOW_OAUTH_CLIENT_ID / IFLOW_OAUTH_CLIENT_SECRET	సోర్స్ కోడ్లో ఎక్కడా దీనికి సూచన లేదు.
CEREBRAS_API_KEY / COHERE_API_KEY / FIREWORKS_API_KEY / GROQ_API_KEY / MISTRAL_API_KEY / NEBIUS_API_KEY / PERPLEXITY_API_KEY / TOGETHER_API_KEY / XAI_API_KEY	v3.8.0లో తొలగించబడ్డాయి. రన్టైమ్ ఇకపై ఈ env వేరియబుల్లను చదవదు — క్రెడెన్షియల్లు Dashboard / data/provider-credentials.json / ఎన్క్రిప్ట్ చేసిన DB నుండి వస్తాయి.
CURSOR_PROTOBUF_DEBUG	v3.8.0లో తొలగించబడింది. Cursor ఎగ్జిక్యూటర్ CURSOR_DEBUG / CURSOR_STREAM_DEBUGను ఉపయోగిస్తుంది (§22 చూడండి).
CLI_COMPAT_KIRO	v3.8.0లో తొలగించబడింది. Kiro, CLI_COMPAT_OMITTED_PROVIDER_IDSలో ఉంది — దాని టాగుల్కు ఎటువంటి ప్రభావం లేదు.
QIANFAN_API_KEY	v3.8.0లో ఉపయోగించని ఇతర ప్రొవైడర్ API కీ స్టబ్లతో పాటు తొలగించబడింది.

డిఫాల్ట్ విలువ సవరణలు

వేరియబుల్	పాత .env.example విలువ	వాస్తవ కోడ్ డిఫాల్ట్	పరిష్కారం
APP_LOG_RETENTION_DAYS	90	7	✅ తప్పుదారి పట్టించే విలువ తొలగించబడింది; 7ను డిఫాల్ట్గా డాక్యుమెంట్ చేశారు
CALL_LOG_RETENTION_DAYS	90	7	✅ తప్పుదారి పట్టించే విలువ తొలగించబడింది; 7ను డిఫాల్ట్గా డాక్యుమెంట్ చేశారు

OpenCode కాన్ఫిగ్ పునరుత్పత్తి (అడ్-హాక్ టూలింగ్)

రన్ అవుతున్న OmniRoute ఇన్స్టాన్స్ నుండి ఖచ్చితమైన limit.context మరియు limit.output విలువలను తీసుకొని opencode.jsonను పునరుత్పత్తి చేయడానికి scripts/ad-hoc/regen-opencode-config.ts ఉపయోగించబడుతుంది. సాధారణ ఆపరేషన్ కోసం వీటిలో ఏదీ అవసరం లేదు — ఈ స్క్రిప్ట్ డెవలపర్ టూలింగ్ కోసం మాత్రమే.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_URL	http://localhost:20128	scripts/ad-hoc/regen-opencode-config.ts	/v1/models కోసం క్వెరీ చేయాల్సిన OmniRoute ఇన్స్టాన్స్ యొక్క బేస్ URL.
OMNIROUTE_KEY	(సెట్ చేయబడలేదు)	scripts/ad-hoc/regen-opencode-config.ts	OmniRoute /v1/models ఎండ్పాయింట్తో ప్రామాణీకరించడానికి API కీ. సెట్ చేయనప్పుడు OPENCODE_API_KEYను ఉపయోగిస్తుంది.
OPENCODE_API_KEY	(సెట్ చేయబడలేదు)	scripts/ad-hoc/regen-opencode-config.ts	తిరిగి రూపొందించిన opencode.jsonలో వ్రాయబడే OpenCode-శైలి API కీ (sk-...). సెట్ చేయనప్పుడు OMNIROUTE_KEYను ఉపయోగిస్తుంది.

కంప్రెషన్ ఆఫ్లైన్-ఎవాల్ హార్నెస్ (అడ్-హాక్ సాధనాలు)

ఆఫ్లైన్ కంప్రెషన్ మూల్యాంకన CLI అయిన scripts/compression-eval/index.ts ద్వారా ఉపయోగించబడుతుంది. సాధారణ ఆపరేషన్కు అవసరం లేదు — డెవలపర్ సాధనాల కోసం మాత్రమే.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_EVAL_CREDENTIALS	{} (ఖాళీ)	scripts/compression-eval/index.ts	ఆఫ్లైన్ compression-eval CLI ద్వారా ఉపయోగించబడే ప్రొవైడర్ కోసం ఆపరేటర్ అందించిన JSON క్రెడెన్షియల్స్ (JSON.parseతో పార్స్ చేయబడతాయి). డ్రై రన్ కోసం సెట్ చేయకుండా వదిలేయండి.

VNC బ్రౌజర్ సెషన్లు

బ్రౌజర్-ఆటోమేషన్ ప్రొవైడర్ల కోసం Docker-ఆధారిత హెడ్లెస్ Chromium సెషన్లను కాన్ఫిగర్ చేయడానికి src/lib/vncSession/manifest.ts ద్వారా ఉపయోగించబడుతుంది. అన్నీ ఐచ్ఛికమే — డిఫాల్ట్లు క్రింద చూపబడ్డాయి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_DOCKER_BIN	docker	src/lib/vncSession/manifest.ts	VNC కంటైనర్లను ప్రారంభించడానికి ఉపయోగించే Docker బైనరీకి పాత్.
OMNIROUTE_VNC_IMAGE	omniroute-vnc-chromium:local	src/lib/vncSession/manifest.ts	VNC Chromium కంటైనర్ కోసం Docker ఇమేజ్.
OMNIROUTE_VNC_CHROMIUM_ARGS	(అంతర్నిర్మిత ఫ్లాగ్లు)	src/lib/vncSession/manifest.ts	కంటైనర్లోని బ్రౌజర్కు పంపబడే అదనపు Chromium CLI ఆర్గ్యుమెంట్లు.
OMNIROUTE_VNC_CONTAINER_VNC_PORT	3000	src/lib/vncSession/manifest.ts	కంటైనర్లోని VNC పోర్ట్.
OMNIROUTE_VNC_CONTAINER_CDP_PORT	9223	src/lib/vncSession/manifest.ts	కంటైనర్లోని Chrome DevTools Protocol పోర్ట్.
OMNIROUTE_VNC_CONTAINER_PROFILE_DIR	/config	src/lib/vncSession/manifest.ts	కంటైనర్లోని ప్రొఫైల్ డైరెక్టరీ.
OMNIROUTE_VNC_PROFILE_DIR	(సెట్ చేయబడలేదు)	src/lib/vncSession/manifest.ts	స్థిరమైన బ్రౌజర్ ప్రొఫైల్ల కోసం హోస్ట్-వైపు డైరెక్టరీ.
OMNIROUTE_VNC_IDLE_MS	600000	src/lib/vncSession/manifest.ts	VNC సెషన్ను ముగించి వనరులను సేకరించే ముందు నిష్క్రియ గడువు (ms).
OMNIROUTE_VNC_MAX_MS	1800000	src/lib/vncSession/manifest.ts	గరిష్ఠ సెషన్ వ్యవధి (ms).
OMNIROUTE_VNC_MAX_SESSIONS	4	src/lib/vncSession/manifest.ts	ఏకకాలంలో అనుమతించబడే గరిష్ఠ VNC సెషన్లు.
OMNIROUTE_VNC_READY_MS	45000	src/lib/vncSession/manifest.ts	బ్రౌజర్ సిద్ధత గడువు (ms).
OMNIROUTE_VNC_HARVEST_MS	20000	src/lib/vncSession/manifest.ts	వనరుల సేకరణ/క్లీన్అప్ గడువు (ms).
OMNIROUTE_VNC_NETWORK	omniroute-vnc-browser-login	src/lib/vncSession/manifest.ts	డిఫాల్ట్ బ్రిడ్జ్కు బదులుగా కంటైనర్ చేరే ప్రత్యేక Docker నెట్వర్క్ (#12571).
VIBEPROXY_DATA_DIR	(సెట్ చేయబడలేదు)	open-sse/services/notionThreadSessions.ts	Notion థ్రెడ్ సెషన్ నిల్వ కోసం డైరెక్టరీ.

అంతర్గత సర్వీస్ ప్రామాణీకరణ

వేరియబుల్	డిఫాల్ట్	వివరణ
OMNIROUTE_INTERNAL_SERVICE_TOKEN	–	మేనేజ్మెంట్-ప్లేన్ సర్వీస్-టు-సర్వీస్ ప్రామాణీకరణ కోసం ఇన్లైన్ టోకెన్.
OMNIROUTE_INTERNAL_SERVICE_TOKEN_FILE	–	అంతర్గత సర్వీస్ టోకెన్ను కలిగి ఉన్న ఫైల్కు పాత్ (కంటైనర్లలో ప్రాధాన్యం ఇవ్వబడుతుంది; ఇన్లైన్ వేరియబుల్ను ఓవర్రైడ్ చేస్తుంది).

OpenRouter ప్రొవైడర్ గణాంకాలు

వేరియబుల్	డిఫాల్ట్	వివరణ
OPENROUTER_PROVIDER_STATS_ENABLED	true	కేటలాగ్ మెరుగుదల కోసం ప్రతి ప్రొవైడర్కు సంబంధించిన OpenRouter గణాంకాలను పొందడాన్ని దాటవేయడానికి falseగా సెట్ చేయండి.
OPENROUTER_PROVIDER_STATS_TTL_MS	3600000	పొందిన OpenRouter ప్రొవైడర్ గణాంకాల కోసం క్యాష్ TTL (ms).

ఎంబెడెడ్ Redis బైండింగ్

వేరియబుల్	డిఫాల్ట్	వివరణ
REDIS_BIND_HOST	127.0.0.1	ఎంబెడెడ్ Redis సేవ కోసం బైండ్ చిరునామా.
REDIS_PORT	6379	ఎంబెడెడ్ Redis సేవ కోసం పోర్ట్.
OMNIROUTE_REDIS_BIND_HOST	–	ఎంబెడెడ్ Redis బైండ్ చిరునామా కోసం OmniRoute-పరిధిలోని ఓవర్రైడ్.

---

24. Release v3.8.50 చేర్పులు

మునుపటి environment-contract స్నాప్షాట్ తర్వాత ఈ సెట్టింగ్లు ప్రవేశపెట్టబడ్డాయి.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_CHAT_ADMISSION_QUEUE_MS	2000	src/shared/middleware/chatBodyAdmission.ts	మళ్లీ ప్రయత్నించగల 503ను అందించే ముందు హెవీవెయిట్ చాట్ అడ్మిషన్ స్లాట్ కోసం వేచి ఉండే గరిష్ఠ సమయం; తక్షణ 503కు బదులుగా, స్వల్ప పరిమిత నిరీక్షణ ఏజెంట్ బర్స్ట్లను వరుసక్రమంలో అమలు చేస్తుంది. 0 తక్షణ తిరస్కరణను పునరుద్ధరిస్తుంది.
OMNIROUTE_CHAT_ADMISSION_MAX_QUEUED_BYTES	4194304 (4 MB)	src/shared/middleware/chatBodyAdmission.ts	అడ్మిషన్ నిరీక్షణ కోసం క్యూలో ఉన్న బైట్ల బడ్జెట్: నిరీక్షణ వల్ల హీప్ పెరగకుండా, ప్రాసెస్ అంతటా నిలిపి ఉంచిన మొత్తం బఫర్ చేసిన బాడీ బైట్లను పరిమితం చేస్తుంది (#4380). బడ్జెట్ను మించిన నిరీక్షణలకు వెంటనే మళ్లీ ప్రయత్నించగల 503 అందుతుంది.
OMNIROUTE_CHAT_VIRTUAL_TTL_MS	60000 (60 s)	src/shared/middleware/chatBodyAdmission.ts	#10110 నుండి వినియోగంలో లేని, ఏ ప్రభావమూ లేని సెట్టింగ్: ఒక్క ప్రాసెస్-వ్యాప్త బడ్జెట్కు అనుకూలంగా ప్రతి-సెషన్ అడ్మిషన్ లేన్లు తొలగించబడ్డాయి. కాన్ఫిగరేషన్ అనుకూలత కోసం అంగీకరించబడుతుంది; విస్మరించబడుతుంది.
OMNIROUTE_CHAT_VIRTUAL_MAX_SESSIONS	64	src/shared/middleware/chatBodyAdmission.ts	#10110 నుండి వినియోగంలో లేని, ఏ ప్రభావమూ లేని సెట్టింగ్: ఒక్క ప్రాసెస్-వ్యాప్త బడ్జెట్కు అనుకూలంగా ప్రతి-సెషన్ అడ్మిషన్ లేన్లు తొలగించబడ్డాయి. కాన్ఫిగరేషన్ అనుకూలత కోసం అంగీకరించబడుతుంది; విస్మరించబడుతుంది.
OMNIROUTE_CHAT_VIRTUAL_LANES	0 (ఆఫ్)	open-sse/services/admission/runtime.ts	అడాప్టివ్ రన్టైమ్ వర్చువల్ అడ్మిషన్ లేన్లు (#9654): ప్రతి-టెనెంట్ అడాప్టివ్ గేట్కు (సిస్టమ్ 2) ప్రధాన స్విచ్. పైన ఉన్న, వినియోగంలో లేని ప్రతి-కనెక్షన్ లేన్ వేరియబుల్లకు (TTL_MS / MAX_SESSIONS, #10110 నుండి ప్రభావం లేనివి) ఇది భిన్నమైనది. ఇదే పేరుతో ఉన్న డ్యాష్బోర్డ్ ఫీచర్ ఫ్లాగ్; డ్యాష్బోర్డ్ ఓవర్రైడ్ కంటే env varకే ప్రాధాన్యం ఉంటుంది; పునఃప్రారంభం అవసరం.
OMNIROUTE_RUNNOW_TIMEOUT_MS	30000	src/app/api/jobs/[id]/run-now/route.ts	క్యూలో ఉన్న రన్ను ప్రారంభించే ముందు, ఇప్పటికే అమలులో ఉన్న జాబ్ కోసం run-now కాల్ ఎంతసేపు వేచి ఉండాలో పరిమితం చేస్తుంది.
ADOBE_FIREFLY_BROWSER_REFRESH	ప్రారంభించబడింది	open-sse/services/adobeFireflySession.ts	ఖాతా-పరిధి Chrome CDP సెషన్ల ద్వారా IMS మరియు బ్రౌజర్-రిస్క్ స్థితిని తాజాగా ఉంచుతుంది; నిలిపివేయడానికి 0గా సెట్ చేయండి.
ADOBE_FIREFLY_SESSION_DISK	ప్రారంభించబడింది	open-sse/services/adobeFireflySession.ts	మరమ్మతు చేసిన Adobe సెషన్లను DATA_DIR కింద నిల్వ చేస్తుంది; మెమరీ-మాత్రమే స్థితి కోసం 0గా సెట్ చేయండి.
ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS	12000	open-sse/services/adobeFireflySession.ts	Adobe Firefly జనరేట్ సమర్పణల మధ్య కనిష్ఠ విరామం.
ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS	15000	open-sse/services/adobeFireflySession.ts	ప్రతి మూడవ విజయవంతమైన Adobe సమర్పణ తర్వాత అదనపు నిశ్శబ్ద వ్యవధి.
ADOBE_FIREFLY_CHROME_HEADLESS	0	open-sse/services/adobeFireflyBrowserLogin.ts	డీబగ్ కోసం మాత్రమే ఉద్దేశించిన నిజమైన హెడ్లెస్ మోడ్; ఫలితంగా ఏర్పడే రిస్క్ సెషన్ను Adobe colligo సాధారణంగా తిరస్కరిస్తుంది.
CHROME_PATH	స్వయంచాలక గుర్తింపు	open-sse/executors/cloudflare-playground.ts, open-sse/executors/chatgpt-web-codex.ts	ప్లాట్ఫామ్ స్వయంచాలక గుర్తింపు సరిపోనప్పుడు, బ్రౌజర్-ఆధారిత ఎగ్జిక్యూటర్లు ఉపయోగించే ఐచ్ఛిక సంపూర్ణ Chrome ఎగ్జిక్యూటబుల్ పాత్.
TELEGRAM_BOT_TOKEN	(సెట్ చేయబడలేదు)	src/lib/telegram/config.ts	ఇన్బౌండ్ వెబ్హుక్ను ప్రారంభించి, Mini App initDataపై సంతకం చేసే BotFather టోకెన్.
TELEGRAM_WEBHOOK_SECRET	(సెట్ చేయబడలేదు)	src/lib/telegram/config.ts	setWebhook ద్వారా నమోదు చేయబడి, ప్రతి వెబ్హుక్ డెలివరీలోని X-Telegram-Bot-Api-Secret-Token హెడర్తో ధృవీకరించబడే భాగస్వామ్య రహస్యం. వెబ్హుక్ పాత్కు ఇది అవసరం; సెట్ చేయకపోతే వెబ్హుక్ డెలివరీలు 503తో తిరస్కరించబడతాయి.
TELEGRAM_DEFAULT_MODEL	auto/chat	src/lib/telegram/chatProxy.ts	Telegram చాట్ ప్రత్యుత్తరాల కోసం ఉపయోగించే మోడల్.
TELEGRAM_BOT_API_BASE	https://api.telegram.org	src/lib/telegram/config.ts	ప్రాక్సీలు లేదా స్వయంగా హోస్ట్ చేసిన Bot API సర్వర్ల కోసం Bot API బేస్ URL ఓవర్రైడ్.
TELEGRAM_WEBHOOK_TIMEOUT_MS	60000	src/lib/telegram/config.ts	అవుట్బౌండ్ Bot API కాల్ల కోసం మిల్లీసెకన్లలో టైమ్అవుట్.
OMNIROUTE_OPTIONAL_PACK_TAR	1 (ప్రారంభించబడింది)	scripts/build/optionalPackStaging.mjs	Electron స్వతంత్ర ట్రీ కోసం ఐచ్ఛిక ML/బ్రౌజర్ ప్యాక్లను స్టేజ్ చేస్తున్నప్పుడు .tar.gz టార్బాల్లను ఉత్పత్తి చేయకుండా ఉండటానికి 0గా సెట్ చేయండి (ప్యాక్ డైరెక్టరీలు మరియు optional-packs.index.json అప్పటికీ ఉత్పత్తి చేయబడతాయి). ఆర్టిఫాక్ట్ అప్లోడ్ పరిమాణాన్ని తగ్గించడానికి డెస్క్టాప్ రిలీజ్ వర్క్ఫ్లో దీనిని ఉపయోగిస్తుంది.

ChatGPT Web (Codex)

హెడ్లెస్ బ్రౌజర్ మరియు అవుట్బౌండ్ టూల్-టన్నెల్ కోసం గ్లోబల్ డిఫాల్ట్లు. డ్యాష్బోర్డ్లో సెట్ చేసిన కనెక్షన్ విలువలకు ప్రాధాన్యం ఉంటుంది.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
CHATGPT_WEB_CODEX_CHROME_PATH	(స్వయంచాలకంగా గుర్తించబడుతుంది)	open-sse/executors/chatgpt-web-codex.ts	npm, systemd మరియు PM2 ఆపరేషన్ కోసం స్పష్టమైన Chrome/Chromium పాత్.
CHROME_PATH	(స్వయంచాలకంగా గుర్తించబడుతుంది)	open-sse/executors/chatgpt-web-codex.ts	స్పష్టమైన Chrome/Chromium పాత్ కోసం ఉమ్మడి ఫాల్బ్యాక్.
CHATGPT_WEB_CODEX_CDP_URL	(సెట్ చేయబడలేదు)	open-sse/executors/chatgpt-web-codex.ts	అంతర్గత CDP ఎండ్పాయింట్; Docker పోర్ట్ 9223లోని సైడ్కార్ను ఉపయోగిస్తుంది.
CDP_PROXY_TOKEN	(సెట్ చేయబడలేదు)	docker/chatgpt-web-codex-browser/cdp-proxy.mjs	దీన్ని సెట్ చేస్తే, CDP ప్రాక్సీ సైడ్కార్కు పంపే ప్రతి అభ్యర్థనలో ఈ విలువను X-Omni-Cdp-Token హెడర్లో పంపాలి (#13679). విలువ లేకపోతే ప్రాక్సీ ప్రామాణీకరణ లేకుండా ఫార్వర్డ్ చేస్తుంది — అప్పుడు chatgpt-web-codex-net Compose నెట్వర్క్ యొక్క నెట్వర్క్ ఐసోలేషన్ మాత్రమే రక్షణ కల్పిస్తుంది. openssl rand -hex 32తో రూపొందించండి.
CHATGPT_WEB_CODEX_TUNNEL_ID	(సెట్ చేయబడలేదు)	open-sse/executors/chatgpt-web-codex.ts	స్థానిక Codex టూల్ రౌండ్ల కోసం గ్లోబల్ OpenAI టన్నెల్ ID.
CHATGPT_WEB_CODEX_RUNTIME_KEY	(సెట్ చేయబడలేదు)	open-sse/executors/chatgpt-web-codex.ts	గ్లోబల్ టన్నెల్ రన్టైమ్ కీ; దీన్ని లాగ్లలో ఎప్పుడూ అవుట్పుట్ చేయవద్దు.
CHATGPT_WEB_CODEX_CONNECTOR_NAME	OmniRoute Codex v2	open-sse/executors/chatgpt-web-codex.ts	MCP బ్రిడ్జ్ కోసం కొత్తగా సృష్టించిన ChatGPT కస్టమ్ కనెక్టర్ యొక్క ఖచ్చితమైన పేరు.
CODEX_CHATGPT_WEB_HOME	<DATA_DIR>/chatgpt-web-codex	open-sse/vendor/codex-chatgpt-web/config.ts	బ్రౌజర్, బ్రోకర్ మరియు టన్నెల్ స్థితి కోసం ప్రత్యేక డైరెక్టరీ.
CODEX_CHATGPT_WEB_BROWSER_DIAGNOSTICS	0	open-sse/vendor/codex-chatgpt-web/adapters/chatgpt-web/browser-worker.ts	1గా సెట్ చేసినప్పుడు, ప్రతి చెక్పాయింట్ వద్ద బ్రౌజర్ డయాగ్నస్టిక్ చిత్రాలు సంగ్రహించబడతాయి.
CODEX_CHATGPT_WEB_LAUNCHER	(సెట్ చేయబడలేదు)	open-sse/vendor/codex-chatgpt-web/config.ts	శాశ్వత లాంచర్ బైనరీకి ఐచ్ఛిక సంపూర్ణ పాత్.
CODEX_CHATGPT_WEB_BUN	(స్వయంచాలకంగా గుర్తించబడుతుంది)	open-sse/vendor/codex-chatgpt-web/config.ts	Bun రన్టైమ్ బైనరీకి ఐచ్ఛిక సంపూర్ణ పాత్.
CODEX_WEB_GPT_BUN	(సెట్ చేయబడలేదు)	open-sse/vendor/codex-chatgpt-web/config.ts	CODEX_CHATGPT_WEB_BUN కోసం లెగసీ ఫాల్బ్యాక్; కొత్త సెటప్లు ప్రామాణిక పేరును ఉపయోగిస్తాయి.

---

OmniConductor బ్రిడ్జ్

OmniConductor హబ్ టాస్క్లను స్థానిక A2A TaskManager (src/lib/conductor/)లో ప్రతిబింబించే దీర్ఘకాలిక SSE కన్జ్యూమర్. ఎంపిక చేసుకుంటే మాత్రమే — CONDUCTOR_HUB_URL సెట్ చేసినప్పుడు మాత్రమే బ్రిడ్జ్ ప్రారంభమవుతుంది. సర్వర్ వైపు మాత్రమే: హబ్ టోకెన్ ఎప్పటికీ బ్రౌజర్కు చేరకూడదు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
CONDUCTOR_HUB_URL	(ఖాళీ)	src/lib/conductor/boot.ts	OmniConductor హబ్ యొక్క బేస్ URL (ఉదా. http://127.0.0.1:7910). సెట్ చేయకపోతే = బ్రిడ్జ్ నిలిపివేయబడుతుంది.
CONDUCTOR_HUB_TOKEN	(ఖాళీ)	src/lib/conductor/boot.ts	SSE ఫీడ్ కోసం హబ్ క్రెడెన్షియల్ — హబ్లో spokesperson-రకం పీర్ను సృష్టించండి (POST /v1/peers, అడ్మిన్).
CONDUCTOR_ORCHESTRATOR_TOKEN	(ఖాళీ)	src/lib/conductor/hubProxy.ts	ఇన్బౌండ్ A2A→హబ్ టాస్క్ డెలిగేషన్ కోసం క్రెడెన్షియల్ (POST /v1/tasks); సెట్ చేయనప్పుడు CONDUCTOR_HUB_TOKENను ఉపయోగిస్తుంది.
CONDUCTOR_SPOKESPERSON_URL	http://127.0.0.1:7920	src/lib/conductor/faroProxy.ts	డాష్బోర్డ్ చాట్ ప్రాక్సీ (/api/conductor/ask) వెనుక ఉన్న spokesperson (Faro) సర్వీస్ యొక్క బేస్ URL.

కోటాను పరిగణనలోకి తీసుకునే షెడ్యూలింగ్

రిక్వెస్ట్కు ముందు టోకెన్-బడ్జెట్ తనిఖీల కోసం open-sse/services/combo.ts మరియు src/lib/quota/quotaScheduler.ts ద్వారా ఉపయోగించబడుతుంది. ఎంపిక చేసుకుంటే మాత్రమే — సెట్ చేయనప్పుడు డిఫాల్ట్ రూటింగ్ ప్రవర్తన మారదు.

వేరియబుల్	డిఫాల్ట్	సోర్స్ ఫైల్	వివరణ
OMNIROUTE_QUOTA_AWARE_ROUTING	0	open-sse/services/combo.ts	1గా ఉన్నప్పుడు, డిస్పాచ్కు ముందు అంచనా వేసిన రిక్వెస్ట్ ఖర్చును భరించలేని ప్రతి-విండో టోకెన్ బడ్జెట్ (rateLimitOverrides.tpm, టేబుల్ provider_quota_state) ఉన్న కనెక్షన్లను దాటవేస్తుంది. బడ్జెట్ కాన్ఫిగర్ చేయనప్పుడు ఫెయిల్-ఓపెన్గా వ్యవహరిస్తుంది.