Arama Yap Mesaj Gönder
Biz Sizi Arayalım
+90
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro

Bize Ulaşın

Konum Halkalı merkez mahallesi fatih cd ozgur apt no 46 , Küçükçekmece , İstanbul , 34303 , TR

LiteLLM Proxy Kurulumu: OpenAI, Gemini, Claude ve Ollama API’lerini Tek Noktadan Yönetme

LiteLLM Proxy’yi PostgreSQL ve Redis ile kurun; farklı model sağlayıcılarını OpenAI uyumlu tek API altında birleştirin, sanal anahtar, bütçe, hız sınırı, SSL ve log gizliliğini yapılandırın.

LiteLLM Proxy Kurulumu: OpenAI, Gemini, Claude ve Ollama API’lerini Tek Noktadan Yönetme
Bu rehberin sonunda ne çalışacak?

LiteLLM Proxy’yi PostgreSQL ve Redis ile kurun; farklı model sağlayıcılarını OpenAI uyumlu tek API altında birleştirin, sanal anahtar, bütçe, hız sınırı, SSL ve log gizliliğini yapılandırın. Komutlar kopyalanabilir biçimde verilmiştir; örnek alan adları ve parolalar çalıştırılmadan önce kendi değerlerinizle değiştirilmelidir.

Kurulum öncesi mimari ve gereksinimler

  • Ubuntu 24.04 LTS, Docker Compose
  • Başlangıçta 4 vCPU, 8 GB RAM ve NVMe
  • llm.example.com DNS kaydı
  • Sağlayıcı API anahtarları veya özel ağdaki Ollama/vLLM uç noktası

DNS ve port planı

  • 443/TCP: istemci API erişimi
  • 4000/TCP: yalnız reverse proxy arkasında LiteLLM
  • 5432/TCP: PostgreSQL iç ağ
  • 6379/TCP: Redis iç ağ

Uygulamalı kurulum adımları

1. Sırlar
openssl rand -hex 32
openssl rand -base64 48
2. Ortam dosyası
LITELLM_MASTER_KEY=sk-YONETICI_ICIN_GUCLU_ANAHTAR
LITELLM_SALT_KEY=DEGISTIRILMEMESI_GEREKEN_RASTGELE_DEGER
POSTGRES_PASSWORD=GUCLU_DB_PAROLASI
DATABASE_URL=postgresql://litellm:GUCLU_DB_PAROLASI@postgres:5432/litellm
REDIS_HOST=redis
OPENAI_API_KEY=sk-...
GEMINI_API_KEY=...
ANTHROPIC_API_KEY=...
3. Model yapılandırması
model_list:
  - model_name: gpt-4o-mini
    litellm_params:
      model: openai/gpt-4o-mini
      api_key: os.environ/OPENAI_API_KEY
  - model_name: gemini-flash
    litellm_params:
      model: gemini/gemini-2.5-flash
      api_key: os.environ/GEMINI_API_KEY
  - model_name: claude-sonnet
    litellm_params:
      model: anthropic/claude-sonnet-4-5
      api_key: os.environ/ANTHROPIC_API_KEY
  - model_name: yerel-qwen
    litellm_params:
      model: ollama/qwen3:8b
      api_base: http://ollama:11434
general_settings:
  master_key: os.environ/LITELLM_MASTER_KEY
  database_url: os.environ/DATABASE_URL
4. Compose yapısı
services:
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: litellm
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: litellm
    volumes:
      - postgres_veri:/var/lib/postgresql/data
  redis:
    image: redis:7-alpine
    restart: unless-stopped
    volumes:
      - redis_veri:/data
  litellm:
    image: ghcr.io/berriai/litellm-database:main-stable
    restart: unless-stopped
    env_file: .env
    command: ["--config", "/app/config.yaml", "--port", "4000"]
    ports:
      - 127.0.0.1:4000:4000
    volumes:
      - ./config.yaml:/app/config.yaml:ro
    depends_on:
      - postgres
      - redis
volumes:
  postgres_veri:
  redis_veri:
5. API doğrulama
curl -sS http://127.0.0.1:4000/health/liveliness
curl -sS http://127.0.0.1:4000/v1/models -H "Authorization: Bearer sk-YONETICI_ICIN_GUCLU_ANAHTAR"
6. Sohbet testi
curl https://llm.example.com/v1/chat/completions \
  -H "Authorization: Bearer sk-SANAL_ANAHTAR" \
  -H "Content-Type: application/json" \
  -d '{"model":"yerel-qwen","messages":[{"role":"user","content":"Merhaba"}]}'
7. Veritabanı yedeği
sudo docker compose exec -T postgres pg_dump -U litellm -d litellm -Fc > litellm-$(date +%F).dump
sha256sum litellm-$(date +%F).dump
8. Nginx reverse proxy
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx
sudo tee /etc/nginx/sites-available/llm.example.com > /dev/null <<'NGINX'
server {
    listen 80;
    listen [::]:80;
    server_name llm.example.com;
    client_max_body_size 10G;
    proxy_read_timeout 3600;
    proxy_send_timeout 3600;
    location / {
        proxy_pass http://127.0.0.1:4000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
NGINX
sudo ln -s /etc/nginx/sites-available/llm.example.com /etc/nginx/sites-enabled/llm.example.com
sudo nginx -t
sudo systemctl reload nginx
9. Let’s Encrypt SSL ve yenileme testi
sudo certbot --nginx -d llm.example.com --redirect --agree-tos --no-eff-email -m [email protected]
sudo certbot renew --dry-run
curl -I https://llm.example.com
openssl s_client -connect llm.example.com:443 -servername llm.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

Üretime geçmeden önce bilinmesi gerekenler

Üretim notu
LITELLM_SALT_KEY sağlayıcı kimlik bilgilerini şifrelemek için kullanılır. Modeller eklendikten sonra değiştirilirse mevcut şifreli anahtarlar okunamaz; yedeği ayrı ve güvenli tutulmalıdır.
Üretim notu
İstemcilere master key verilmez. Ekip, model, bütçe, RPM/TPM ve sona erme tarihi sınırlandırılmış sanal anahtar üretilir.
Üretim notu
Spend log, hata logu veya önbelleğe alınan prompt/cevap verileri varsayılan tasarımda hassas içerik barındırabilir. Gizlilik gereksinimine göre içerik loglama kapatılmalı ve saklama süresi sınırlandırılmalıdır.
Üretim notu
Üretimde hareketli latest/main etiketi yerine test edilmiş sabit sürüm etiketi kullanılmalı; PostgreSQL migration öncesi geri dönüş yedeği alınmalıdır.

Yaygın hatalar ve kök nedenleri

Belirti / SymptomKök neden ve çözüm / Root cause and fix
401 invalid proxy keyMaster key ile kullanıcıya verilen virtual key karıştırılmaz; Authorization Bearer başlığı kontrol edilir.
Model not foundİstemcinin gönderdiği model adı config içindeki model_name ile birebir eşleştirilir.
Prisma/DB migration hatasıDatabase image, DATABASE_URL, PostgreSQL erişimi ve sürüm geçiş notları kontrol edilir.
Anahtarlar okunamıyorKurulumun ilk LITELLM_SALT_KEY değeri geri yüklenir; rastgele yeni salt mevcut kayıtları çözemez.

Kurulum sonrası doğrulama listesi

  • Tüm container veya servisler healthy/running durumda
  • Alan adı HTTPS üzerinden geçerli sertifika ile açılıyor
  • Yalnız gerekli portlar dışarıdan erişilebilir
  • Yönetici hesabında güçlü parola ve MFA etkin
  • Yedek dosyasının checksum değeri kaydedildi
  • Ayrı ortamda en az bir geri yükleme testi tamamlandı
  • Loglarda tekrarlayan kritik hata bulunmuyor
  • Yeniden başlatma sonrası servisler otomatik açılıyor

Resmî teknik kaynaklar

İlgili EKA Sunucu rehberleri

Sık sorulan sorular

Bu kurulum üretimde kullanılabilir mi?

Evet; fakat örnek değerler değiştirilmeden, erişim sınırları uygulanmadan ve geri yükleme testi yapılmadan üretime alınmamalıdır.

Minimum sunucu yeterli olur mu?

Minimum değer yalnız kurulumun açılması içindir. Eş zamanlı kullanıcı, veri büyümesi ve arka plan işleri ölçülerek kaynak payı bırakılmalıdır.

Cloudflare kullanılabilir mi?

Evet. SSL modu Full (strict), doğru origin sertifikası ve WebSocket/gerçek IP başlıkları uygulamanın gereksinimine göre ayarlanmalıdır.

Güncelleme otomatik yapılmalı mı?

Major sürümler otomatik güncellenmemelidir. Sürüm notu, veritabanı migration bilgisi, yedek ve geri dönüş imajı kontrol edilmelidir.

Hangi yedekler alınmalı?

Veritabanı, yüklenen dosyalar, volume verileri, yapılandırma, şifreleme anahtarları ve kullanılan sürüm etiketi aynı geri dönüş setinde tutulmalıdır.

VPS mi GPU sunucu mu?

Web paneli ve standart iş yükleri için NVMe VPS yeterli olabilir. Model inference, OCR hızlandırma veya video transcoding varsa uygun GPU gerekir.

Kurulum için bize ulaşın

LiteLLM Proxy’yi PostgreSQL ve Redis ile kurun; farklı model sağlayıcılarını OpenAI uyumlu tek API altında birleştirin, sanal anahtar, bütçe, hız sınırı, SSL ve log gizliliğini yapılandırın.

Ekran kartlı sunucuları inceleyinKurulum için bize ulaşın
Top