← Bloga geri dön

Ollama Proxy ile: HTTP_PROXY Nasıl Ayarlanır ve Model Çekme Hataları Nasıl Düzeltilir

Ollama'nın proxy sunucusu altında ayarlarının detaylı analizi - ortam değişkenlerinden model çekme hatalarının teşhisine ve uygun proxy türünün seçimine kadar.

📅16 Kasım 2026

Eğer bir ollama pull komutu ile bir modeli kurumsal bir ağdan, VPN üzerinden veya harici bir proxy sunucusu aracılığıyla indirmeye çalışıyorsanız, muhtemelen dial tcp: lookup registry.ollama.ai veya context deadline exceeded gibi hatalarla karşılaşmışsınızdır. Ollama, varsayılan olarak her zaman sistem proxy ayarlarını doğru bir şekilde algılamaz ve modellerin büyük boyutları (2 GB'den 70+ GB'a kadar) bu sorunu daha da kötüleştirir — bağlantı indirme sırasında kesilir. Bu yazıda, ortam değişkenlerini nasıl doğru bir şekilde ayarlayacağımızı, Docker ve systemd'de proxy ayarlarını nasıl yapacağımızı ve en sık karşılaşılan pull hatalarını ve bunların nasıl giderileceğini ele alacağız.

Ollama'nın ağ ve proxy ile çalışması

Ollama, bir istemci-sunucu uygulamasıdır: yerel sunucu (ollama serve) CLI'den komutlar alır ve model kayıt defteri registry.ollama.ai ve katmanların (layers) saklandığı CDN'ye ağ istekleri yapar. ollama pull llama3 komutu aslında, Docker pull'a benzer bir dizi HTTPS isteği gerçekleştirir: önce modelin manifesti istenir, ardından ikili katmanlar (GGUF ağırlık dosyaları) sırasıyla veya paralel olarak indirilir.

Önemli bir nokta: Ağ isteklerini gerçekleştiren sunucu sürecidir, CLI komutu değil. Bu, proxy ayarlarıyla ilgili ortam değişkenlerinin ollama serve sürecinin çalıştığı yerde ayarlanması gerektiği anlamına gelir, çağırdığınız terminalde değil. Eğer servis bir systemd birimi veya Docker konteyneri olarak çalışıyorsa, bir normal bash oturumunda değişkenin dışa aktarılması ona hiçbir şekilde etki etmeyecektir — bu, "proxy ayarlanmış gibi görünüyor ama pull yine de çalışmıyor" sorununun en yaygın nedenidir.

HTTP_PROXY, HTTPS_PROXY, NO_PROXY ortam değişkenleri

Ollama Go dilinde yazılmıştır ve Go'nun standart HTTP kütüphanesi proxy ayarlarını klasik ortam değişkenlerinden okur:

  • HTTP_PROXY — normal HTTP istekleri için proxy
  • HTTPS_PROXY — HTTPS istekleri için proxy (modellerin indirilmesi için gereklidir, çünkü kayıt defteri TLS üzerinden çalışır)
  • NO_PROXY — proxy'den hariç tutulması gereken hostların listesi (örneğin, 127.0.0.1:11434 üzerindeki yerel Ollama API'si)

Değer formatı: http://user:password@host:port yetkilendirilmiş proxy için veya socks5://host:port SOCKS5 için. Go her iki seçeneği de destekler, ancak SOCKS5 için Ollama'nın bu proxy desteği ile derlenmiş olması önemlidir — çoğu güncel derlemede bu durum geçerlidir, ancak hatalarla karşılaşıldığında önce HTTP/HTTPS proxy ile test etmek, bu değişkeni dışlamak için daha iyidir.

Önemli: hem küçük hem de büyük harfle değişkenleri belirtin (http_proxy ve HTTP_PROXY). Bazı Linux dağıtımları yalnızca küçük harfleri okur, Go uygulamaları bazen büyük harf bekler — her iki seçeneği de belirlemek daha iyidir, böylece tahmin yapmak zorunda kalmazsınız.

Linux ve macOS'ta ayarlama

Eğer Ollama'yı doğrudan terminalden çalıştırıyorsanız (sistem servisi olarak değil), sunucu çalıştırmadan önce değişkenleri dışa aktarmanız yeterlidir:

export HTTP_PROXY="http://user:[email protected]:8000"
export HTTPS_PROXY="http://user:[email protected]:8000"
export http_proxy="http://user:[email protected]:8000"
export https_proxy="http://user:[email protected]:8000"
export NO_PROXY="localhost,127.0.0.1"

ollama serve &
ollama pull llama3

Ayarların oturumlar arasında korunması için bu satırları ~/.bashrc, ~/.zshrc veya ~/.profile dosyasına ekleyin, kullandığınız kabuğa bağlı olarak. Düzenledikten sonra source ~/.bashrc komutunu çalıştırın ve Ollama sürecini yeniden başlatın — ortam değişkenleri yalnızca süreç başlatıldığında okunur, sıcak yeniden başlatma mevcut değildir.

macOS'ta, eğer Ollama bir uygulama olarak (Homebrew ile değil) kuruluysa, terminalden ayarlanan ortam değişkenleri GUI üzerinden başlatılan sürece ulaşmayabilir. Bu durumda, değişkenleri launchctl setenv ile ayarlamak daha güvenlidir:

launchctl setenv HTTPS_PROXY "http://user:[email protected]:8000"
launchctl setenv HTTP_PROXY "http://user:[email protected]:8000"
# Daha sonra Ollama uygulamasını tamamen yeniden başlatın (kasa çıkışı, sadece pencereyi kapatmak değil)

Windows'ta ayarlama

PowerShell'de değişkenler, mevcut oturum için şu komutla ayarlanır:

$env:HTTP_PROXY="http://user:[email protected]:8000"
$env:HTTPS_PROXY="http://user:[email protected]:8000"
$env:NO_PROXY="localhost,127.0.0.1"

ollama pull mistral

Eğer Ollama arka planda bir hizmet olarak çalışıyorsa (sistem tepsisinde simgesi var), oturum değişkenleri yeterli olmayacaktır — hizmet, PowerShell'i açmadan önce sisteme giriş yapıldığında başlar. Değişkenleri kullanıcı veya sistem düzeyinde ayarlamak için "Ayarlar → Sistem → Hakkında → Gelişmiş sistem ayarları → Ortam değişkenleri" yolunu izleyin, ardından ollama.exe sürecini görev yöneticisinden tamamen sonlandırın ve uygulamayı yeniden başlatın.

Ollama için Docker'da proxy

Eğer Ollama bir konteynerde çalışıyorsa (sunucu dağıtımları için yaygın bir durum), ana bilgisayarın ortam değişkenleri otomatik olarak konteynere geçmez — bunları açıkça -e veya docker-compose'daki environment bölümü aracılığıyla iletmeniz gerekir:

docker run -d \
  -e HTTP_PROXY="http://user:[email protected]:8000" \
  -e HTTPS_PROXY="http://user:[email protected]:8000" \
  -e NO_PROXY="localhost,127.0.0.1" \
  -v ollama:/root/.ollama \
  -p 11434:11434 \
  --name ollama ollama/ollama

Aynı şekilde docker-compose.yml'de:

version: "3.8"
services:
  ollama:
    image: ollama/ollama
    environment:
      - HTTP_PROXY=http://user:[email protected]:8000
      - HTTPS_PROXY=http://user:[email protected]:8000
      - NO_PROXY=localhost,127.0.0.1
    volumes:
      - ollama:/root/.ollama
    ports:
      - "11434:11434"
volumes:
  ollama:

Değişkenleri değiştirdikten sonra konteyneri yeniden oluşturmanız gerekir (docker compose up -d --force-recreate), basit bir yeniden başlatma yeterli değildir, çünkü ortam değişkenleri konteyner oluşturulurken sabitlenir.

Ollama'nın systemd servisi için proxy

Linux sunucularında Ollama genellikle resmi kurulum betiği aracılığıyla systemd servisi olarak kurulur. Bu durumda, ortam değişkenleri terminaldeki export ile değil, override dosyası aracılığıyla ayarlanır:

sudo systemctl edit ollama.service

Açılan editörde şunları ekleyin:

[Service]
Environment="HTTP_PROXY=http://user:[email protected]:8000"
Environment="HTTPS_PROXY=http://user:[email protected]:8000"
Environment="NO_PROXY=localhost,127.0.0.1"

Ardından değişiklikleri uygulayın:

sudo systemctl daemon-reload
sudo systemctl restart ollama
systemctl show ollama --property Environment

Son komut, sürecin gerçekten hangi değişkenleri gördüğünü gösterecektir — bu, yapılandırmanın uygulandığından emin olmak için kullanışlı bir yoldur, pull işlemini tekrar denemeden önce.

Pull hatalarının analizi ve çözümü

Proxy üzerinden model indirirken en sık karşılaşılan hata mesajlarını ve bunlarla ne yapılacağını inceleyelim.

dial tcp: lookup registry.ollama.ai: no such host

DNS çözümlemesi proxy arkasında çalışmıyor — bu genellikle isteğin doğrudan, proxy sunucusunu atlayarak gitmeye çalıştığı veya makinede DNS'e erişim olmadığı anlamına gelir (kapalı bir kurumsal ağ). Çözüm: HTTPS_PROXY değişkeninin gerçekten sürece iletildiğinden emin olun (yukarıdaki systemctl show komutuna bakın), ve proxy sunucusunun dış alan adlarını çözümleyebildiğinden emin olun (SOCKS5 proxy, DNS'i kendi tarafında çözer, HTTP proxy de öyle, ancak bazı yerel proxy'ler bunu yapmaz).

proxyconnect tcp: dial tcp: connection refused

Ollama proxy'ye bağlanmaya çalışıyor, ancak bağlantı reddediliyor. Port ve host için yazım hatalarını kontrol edin, proxy sunucusunun gerçekten belirtilen portu dışarıdan dinlediğinden (sadece localhost üzerinde değil) ve güvenlik duvarının proxy portuna giden çıkış bağlantısını engellemediğinden emin olun.

407 Proxy Authentication Required

Proxy, kullanıcı adı ve şifre gerektiriyor, ancak bunlar iletilmedi veya yanlış iletildi. Ortam değişkeninde kullanıcı adı ve şifrenin URL içinde http://user:password@host:port formatında yer aldığından emin olun ve şifredeki özel karakterlerin (örneğin, @ veya :) URL kodlaması ile kodlandığından emin olun (%40, %3A).

x509: certificate signed by unknown authority

Bu, TLS denetimi (MITM) ile kurumsal bir proxy'nin, SSL sertifikasını kendi kök sertifikasıyla değiştirdiğinin bir işareti. Ollama'nın Go istemcisi bu sertifikaya güvenmiyor. Çözüm, kurumsal kök sertifikayı sistemin güvenilir sertifika otoriteleri deposuna eklemektir (Linux'ta genellikle .crt dosyasını /usr/local/share/ca-certificates/ dizinine kopyaladıktan sonra update-ca-certificates ile yapılır). Sertifika denetimini küresel olarak devre dışı bırakmak önerilmez — bu, trafiğin ele geçirilmesine yol açar.

context deadline exceeded / i/o timeout sırasında katman indirme

Bağlantı, büyük bir model katmanının indirilmesi sırasında kesiliyor (genellikle 4-40 GB boyutunda dosyalar). Bu hata neredeyse her zaman proxy sunucusunun kararsızlığı veya düşük bant genişliği ile ilgilidir, Ollama ile değil. Ücretsiz veya aşırı yüklenmiş kamu proxy'leri uzun TCP oturumlarını keser, özellikle indirme birkaç dakikadan fazla sürerse. Bu tür durumlarda daha kararlı bir kanala geçmek yardımcı olur — örneğin, büyük dosyaların kesintisiz indirilmesi için yüksek hız ve sağlam bağlantı sağlayan veri merkezi proxy'leri.

Ollama için hangi proxy türünü seçmeli

Proxy türünün seçimi, Ollama için proxy'ye neden ihtiyaç duyduğunuza bağlıdır. Amaç, sadece kurumsal ağ içindeki kısıtlamaları aşmaksa, hemen hemen her kararlı HTTP(S) proxy uygundur. Ancak amaç, model kayıt defterinin coğrafi engelini aşmak veya isteğin veri merkezinden geldiğini gizlemekse (bazı CDN'ler, bilinen bulut sağlayıcılarının IP aralıkları için hızı sınırlar), proxy türünün seçimi kritik hale gelir.

Proxy Türü Hız Ollama için ne zaman kullanılmalı
Veri merkezi Yüksek Büyük model katmanlarının (4-40+ GB) kesintisiz indirilmesi, farklı veri merkezi konumlarından test edilmesi
Konut Orta Kayıt defterinin coğrafi kısıtlamalarını aşmak, veri merkezi IP'sinin bölgesel rate-limit'e girmesi durumunda
Mobil Değişken Tam IP aralıkları sağlayıcıları tarafından tamamen engellendiğinde son çare, büyük indirmeler için hız dalgalanmaları nedeniyle daha az etkilidir

Ollama ile çoğu senaryo için — on gigabaytlarca ağırlığa sahip bir modeli güvenilir bir şekilde indirmek gerektiğinde — en iyi seçim veri merkezi proxy'leridir: maksimum bant genişliği ve minimum gecikme sağlar, bu da büyük ikili katmanların indirilmesi sırasında kritik öneme sahiptir. Konut IP'leri yalnızca veri merkezi adresleri gerçekten model kayıt defteri tarafında kısıtlamalara giriyorsa bağlanmalıdır.

Bağlantı teşhisi

Ollama'nın kendisini hata ayıklamak için zaman harcamadan önce, proxy'yi doğrudan curl ile kontrol edin — bu, uygulamadaki sorun ile proxy sunucusundaki sorun arasında karışıklığı ortadan kaldırır:

# Proxy üzerinden kayıt defterinin erişilebilirliğini kontrol etme
curl -v -x http://user:[email protected]:8000 https://registry.ollama.ai/v2/

# Proxy üzerinden indirme hızını ölçme
curl -x http://user:[email protected]:8000 -o /dev/null -w "%{speed_download}\n" https://registry.ollama.ai/v2/

# Ayrıntılı günlük ile ollama serve başlatma
OLLAMA_DEBUG=1 ollama serve

Eğer curl başarılı bir şekilde yanıt alıyorsa ve ollama pull yine de başarısız oluyorsa — sorun büyük ihtimalle ortam değişkenlerinin sunucu sürecine ulaşmadığıdır (hizmet başka bir kullanıcı ile, başka bir shell'den veya override olmadan bir systemd birimi olarak başlatılmıştır). Systemd ile ilgili bölüme geri dönün ve systemctl show ollama --property Environment çıktısını kontrol edin.

Eğer curl de büyük bir dosyanın indirilmesi sırasında kesiliyorsa veya kararsız bir hız gösteriyorsa — sorun proxy sunucusundadır, ve büyük veri transferlerine odaklanmış daha kararlı bir proxy sağlayıcısına geçmeyi düşünmelisiniz.

Sonuç

Ollama'yı proxy arkasında ayarlamak üç ana noktaya dayanır: ortam değişkenleri, ollama serve süreci için ayarlanmalıdır, pull komutunu çağırdığınız terminal için değil; proxy URL formatı, doğru kodlanmış kullanıcı adı ve şifreyi içermelidir; ve sertifika hataları durumunda, kurumsal kök sertifikayı güvenilir depoya eklemelisiniz, TLS denetimini devre dışı bırakmamalısınız. Çoğu pull hatası, Ollama'nın kendisinde bir hata değil, ağ ayarlarının gerekli sürece uygulanmaması veya proxy sunucusunun büyük dosyaların uzun süreli aktarımını kaldıramaması sonucudur.

Eğer ana amacınız, kesintisiz bağlantılarla on gigabaytlarca ağırlığa sahip modelleri hızlı ve güvenilir bir şekilde indirmekse, denemenizi öneririz veri merkezi proxy'leri — bunlar büyük model katmanlarının yüklenmesi için gerekli yüksek bant genişliğini sağlar. Eğer proxy kullanma nedeniniz, model kayıt defterinin coğrafi kısıtlamalarını aşmaksa, konut proxy'lerine dikkat edin, bunlar bulut sağlayıcılarının IP aralıklarına uygulanan bölgesel sınırlara daha az maruz kalır.