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

title, version, lastUpdated

title	version	lastUpdated
Ortam Değişkenleri Referansı	3.8.50	2026-08-23

Ortam Değişkenleri Referansı (Türkçe)

🌐 Languages: 🇺🇸 English · 🇸🇦 ar · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇪🇸 es · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇳 gu · 🇮🇱 he · 🇮🇳 hi · 🇭🇺 hu · 🇮🇩 id · 🇮🇹 it · 🇯🇵 ja · 🇰🇷 ko · 🇮🇳 mr · 🇲🇾 ms · 🇳🇱 nl · 🇳🇴 no · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇸🇰 sk · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇻🇳 vi · 🇨🇳 zh-CN

---

OmniRoute tarafından tanınan her ortam değişkeni için eksiksiz başvuru kılavuzu. Hızlı başlangıç şablonu için .env.example dosyasına bakın.

Important

Burada belgelenen her değişken aynı zamanda .env.example içinde yer almalı ve .env.example içindeki her değişken burada görünmelidir. npm run check:env-doc-sync bunu commit sırasında ve CI üzerinde zorunlu kılar.

---

İçindekiler

• 1. Zorunlu Sırlar
• 2. Depolama ve Veritabanı
• 3. Ağ ve Portlar
• 4. Güvenlik ve Kimlik Doğrulama
• 5. Girdi Temizleme ve PII Koruması
• 6. Araç ve Yönlendirme Politikaları
• 7. URL'ler ve Bulut Senkronizasyonu
• 8. Giden Proxy (Outbound Proxy)
• 9. CLI Araç Entegrasyonu
• 10. Dahili Ajan ve MCP Entegrasyonları
• 11. OAuth Sağlayıcı Kimlik Bilgileri
• 12. Sağlayıcı User-Agent Geçersiz Kılmaları
• 13. CLI Parmak İzi Uyumluluğu
• 14. API Anahtarı Sağlayıcıları
• 15. Zaman Aşımı Ayarları
• 16. Günlük Kaydı (Logging)
• 17. Bellek Optimizasyonu
• 18. Fiyatlandırma Senkronizasyonu
• 19. Model Senkronizasyonu
• 20. Sağlayıcıya Özel Ayarlar
• 21. Proxy Sağlığı
• 22. Hata Ayıklama (Debug)

---

1. Zorunlu Sırlar

Bunlar ilk çalıştırmadan önce mutlaka ayarlanmalıdır. Bunlar olmadan uygulama ya başlamayı reddeder ya da güvensiz varsayılanlarla çalışır.

Değişken	Zorunlu	Varsayılan	Kaynak Dosya	Açıklama
JWT_SECRET	Evet	(yok)	src/lib/auth	Tüm pano oturum çerezlerini (JWT) imzalar ve doğrular. openssl rand -base64 48 ile üretin.
API_KEY_SECRET	Evet	(yok)	src/lib/db/apiKeys.ts	SQLite'ta saklanan API anahtarı değerleri için AES şifreleme anahtarı. openssl rand -hex 32 ile üretin.
INITIAL_PASSWORD	Evet	CHANGEME	Bootstrap betiği	İlk yönetici pano şifresini belirler. İlk kullanımdan önce değiştirin.
OMNIROUTE_WS_BRIDGE_SECRET	Evet (üretimde)	(ayarlanmamış)	src/app/api/internal/codex-responses-ws/route.ts	Dahili Codex Responses WebSocket köprüsü için paylaşılan sır. openssl rand -base64 32 ile üretin.

Üretim Komutları

# Dört sırrı tek seferde üretin:
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)"

---

2. Depolama ve Veritabanı

Değişken	Varsayılan	Açıklama
DATA_DIR	~/.omniroute/	SQLite veritabanı, yedeklemeler ve veri dosyaları için kök dizin. Docker hacimleri için geçersiz kılın.
STORAGE_ENCRYPTION_KEY	(boş = devre dışı)	SQLite veritabanının diskte AES ile şifrelenmesi için anahtar. openssl rand -hex 32 ile üretin.
DISABLE_SQLITE_AUTO_BACKUP	false	true olduğunda otomatik başlatma ve yazma öncesi yedeklemeleri atlar.
OMNIROUTE_WAL_TRUNCATE_INTERVAL_MS	21600000 (6h)	Periyodik wal_checkpoint(TRUNCATE) aralığı (ms).

---

3. Ağ ve Portlar

Değişken	Varsayılan	Açıklama
PORT	20128	HTTP dinleme portu (Pano ve API aynı süreci paylaşır).
HOST / HOSTNAME	0.0.0.0	Ağ bağlama adresi (tüm arayüzleri dinler).
NEXT_PUBLIC_BASE_URL	http://localhost:20128	OAuth geri çağırma URL'leri ve istemci yönlendirmeleri için.
RATE_LIMIT_AUTO_ENABLE	true	Sağlayıcı başına hız sınırlamasını otomatik etkinleştirir.
RATE_LIMIT_MAX_WAIT_MS	30000	Hız sınırı kuyruğunda maksimum bekleme süresi (ms).