~/tools / Yerel LLM'i kendi sunucunuzda çalıştırın / Ollama nginx Config Generator
Ollama nginx Config Generator — Ollama için nginx yapılandırması oluşturun: HTTPS, temel kimlik doğrulama, izin verilen adresler, akış
Ollama'yı bir vekil sunucunun arkasına koyan bir nginx server bloğu oluşturun: sertifikanızla HTTPS, 80 numaralı porttan yönlendirme, temel kimlik doğrulamayla parola, izin verilen adresler listesi ve akışla gelen yanıtların yazıldıkça ulaşmasını sağlayan ayarlar. Başlangıç noktası resmî Ollama SSS'deki vekil sunucu örneğidir ve yalnızca nginx belgelerindeki yönergeler kullanılır. Hiçbir veri tarayıcınızdan çıkmaz.
nginx yapılandırması
Bunu /etc/nginx/conf.d/ollama.conf olarak kaydedin. Yönerge birleşimi bize aittir, bu yüzden yeniden yüklemeden önce her zaman nginx -t çalıştırın.
server {
listen 80;
server_name ollama.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name ollama.example.com;
ssl_certificate /etc/ssl/ollama.crt;
ssl_certificate_key /etc/ssl/ollama.key;
auth_basic "ollama";
auth_basic_user_file /etc/nginx/ollama.htpasswd;
location / {
proxy_pass http://localhost:11434;
proxy_set_header Host localhost:11434;
proxy_http_version 1.1;
proxy_buffering off;
proxy_read_timeout 300s;
}
}
Komutlar
htpasswd parolayı sorar. -c seçeneği yeni bir dosya oluşturur ve var olan bir dosya yeniden yazılır; bu yüzden ikinci bir kullanıcı eklerken bu seçeneği kullanmayın. Ubuntu'da htpasswd, apache2-utils paketiyle gelir.
sudo htpasswd -c /etc/nginx/ollama.htpasswd alice sudo nginx -t sudo nginx -s reload
Yönergeler ve varsayılanlar nginx belgelerinde ve Ollama SSS'deki vekil sunucu örneğinde verildiği gibidir; 2026-11-03 tarihinde denetlendi. Ollama SSS: vekil sunucu / nginx: ngx_http_proxy_module
Her şey tarayıcınızda yapılır. Girdiğiniz hiçbir şey herhangi bir yere gönderilmez.
Ollama varsayılan olarak yalnızca sunucunun kendisinde dinler ve Ollama SSS bunun için herhangi bir kimlik doğrulama tanımlamaz. Başka bir makinenin ona erişmesi gerektiğinde SSS, nginx gibi bir vekil sunucuya işaret eder; örnekte istekler http://localhost:11434 adresine iletilir ve Host başlığı localhost:11434 olarak ayarlanır. Bu araç, o örneğin üzerine nginx belgelerindeki yönergeleri ekler: sertifika ve anahtarla listen 443 ssl, HTTPS'e yönlendiren 80 numaralı porttaki bir sunucu, parola dosyasıyla auth_basic, adresler için allow ve deny, client_max_body_size, proxy_http_version 1.1, akış için proxy_buffering off ve yavaş gelen ilk yanıt için proxy_read_timeout. Bu birleşim bize aittir, belgelerdeki tek bir örnek değildir; bu yüzden test ettik: çıktı resmî nginx 1.29.8 imajında ve Ubuntu 24.04'ün nginx 1.24.0 sürümünde nginx -t denetimini geçti; nginx 1.29.8 üzerinden Ollama 0.40.11'e yalnızca doğru parolayla ulaştık, akışla gelen bir yanıtın 81 parça halinde ulaştığını gördük ve izin verilen adresler listesinin dışındaki bir adresten 403 aldık.
Bu aracın temel mantığı MIT lisansıyla açık kaynaktır. github.com/seigo5555/toolkitbox-lib/src/ollama-nginx.ts
Kullanım örnekleri
- Bir VPS'teki Ollama'ya dizüstü bilgisayarınızdan veya başka bir sunucudan parola ve HTTPS ile erişmek
- Parolaya ek olarak Ollama'ya yalnızca ofisinizin veya evinizin adresinin erişmesine izin vermek
- Hepsi bir anda gelen yanıtları ya da büyük bir model hâlâ yüklenirken kapanan bağlantıları düzeltmek
Nasıl kullanılır
- Alan adını ve Ollama aynı sunucuda 11434 numaralı portta değilse nginx'in isteği ileteceği adresi girin. HTTPS'i açın ve sertifikanızın ile özel anahtarınızın yollarını girin.
- Erişimin nasıl sınırlanacağını seçin: bir parola, izin verilen adreslerin bir listesi ya da ikisi birden. İkisi birlikteyken bir isteğin ikisini de geçmesi gerekir, çünkü nginx'in satisfy yönergesi varsayılan olarak all değerindedir. Akışı açık bırakın ve modeliniz yüklenirken uzun sürüyorsa zaman aşımını artırın.
- Yapılandırmayı /etc/nginx/conf.d/ollama.conf olarak kaydedin, gösterilen htpasswd komutuyla parola dosyasını oluşturun, ardından nginx -t komutunu çalıştırın ve nginx'i yeniden yükleyin.
SSS
Host başlığı neden her zaman localhost:11434?
Ollama SSS'deki örnek bunu böyle ayarlar. Ollama, Host başlığı tanımadığı bir ana makineyi gösteren istekleri reddeder: Ollama 0.40.11'i test ettiğimizde Host: ollama.example.com 403 aldı, localhost:11434 ve hatta localhost:9999 ise 200 aldı. localhost:11434 göndermek, ziyaretçi hangi adı kullanmış olursa olsun isteğin kabul edilmesini sağlar.
proxy_buffering neden kapatılıyor?
Ollama bir yanıtı parça parça akıtır. nginx belgeleri, arabelleğe alma devre dışıyken yanıtın alındığı anda istemciye eşzamanlı olarak iletildiğini, etkinken ise nginx'in yanıtı önce arabelleklere kaydettiğini söyler. Kapalıyken test yanıtımız yaklaşık altı saniye boyunca 81 parça halinde ulaştı.
proxy_read_timeout neyi değiştirir?
nginx belgeleri, varsayılanı 60 saniye olan bu zaman aşımının tüm yanıt için değil yalnızca art arda iki okuma arasında geçerli olduğunu ve vekil sunucu bu sürede hiçbir şey göndermezse bağlantının kapatıldığını söyler. Bizim yorumumuz, belgelerde yazan bir ifade değil: hâlâ belleğe yüklenmekte olan bir model, küçük bir sunucuda bir dakikadan uzun süre sessiz kalabilir; bu yüzden daha yüksek bir değer, kapanan bir bağlantıdan kaçınmayı sağlar.
nginx hangi dosyayı okur?
Hem resmî nginx imajı hem de Ubuntu 24.04'ün nginx paketi, nginx.conf içindeki http bloğunda /etc/nginx/conf.d/*.conf dosyalarını dahil eder; bu yüzden oraya kaydedilen bir dosya okunur. Diğer kurulumlar farklı bir dizin kullanabilir; nginx.conf dosyanızdaki include satırlarına bakın.
Parola dosyasını nasıl oluştururum?
nginx belgeleri komut vermeden Apache'nin htpasswd aracını ve openssl passwd komutunu anar. Araç, girdiğiniz dosya ve kullanıcı adıyla htpasswd -c komutunu gösterir. Ubuntu'da htpasswd, apache2-utils paketiyle gelir. Apache belgeleri, -c seçeneğinin dosyayı oluşturduğunu, var olan bir dosyanın yeniden yazılıp kısaltıldığını söyler; bu yüzden ikinci bir kullanıcı eklerken -c seçeneğini kullanmayın.
Bir sunucuya herhangi bir şey gönderiliyor mu?
Hayır. Yapılandırma tarayıcınızda oluşturulur.
İlgili makaleler
- Küçük bir VPS'te Ollama'nın bellek kullanımını izleyinOllama'nın bellekte neyi tuttuğunu, orada ne kadar kaldığını ve hangi ayarların bunu değiştirdiğini görün: ollama ps, keep_alive ve sınırlar, resmî FAQ'ye göre.
- Dify'ı kendi VPS'inizdeki Ollama'ya bağlayınDify'ı kendi VPS'inizde çalıştırın ve modeli Ollama'dan alın: kurulum, eklenti alanları, Docker adres sorunu ve embedding'ler, resmî belgelere dayanarak.
- Pahalı bir bilgisayar olmadan yerel LLM başlatın: VPS kullanımı için yeni başlayanlara rehberGüçlü bir bilgisayarınız yok mu? Bir VPS kiralayın ve küçük bir yerel LLM'yi tarayıcınızdan çalıştırın: bellek tahmininden korumalı sohbet ekranına altı adım, sınırlar dürüstçe belirtilerek.