Open WebUI ile Yerel Modeli Güvenli Bir Çalışma Alanına Dönüştürme

by

⏱️ 11 dk tahmini okuma süresi
📝 1954 kelime
♿ WCAG 2.2 Uyumlu
Bu Makaleyi Sesli Dinleyin
Doğal Türkçe ses sentezleyici hazır



Kısa özet: Open WebUI, tarayıcıdan çalışan ve Ollama ile yerel modellere ya da OpenAI-uyumlu servis uçlarına bağlanabilen bir arayüzdür. Bu kılavuzda amaç, yalnızca “bir sohbet ekranı açmak” değil; tek kullanıcılı, yerel bir not-asistanı akışı kurmak, veri sınırını belirlemek ve bir sorun çıktığında geri dönebilmektir. Projenin güncel kararlı sürümü 27 Temmuz 2026’da yayımlanan v0.11.0’dır. Kod deposu etkin görünse de lisansı standart açık kaynak lisansı değildir: 50 kullanıcıyı aşan dağıtımlarda Open WebUI markasını kaldırma/değiştirme kısıtı vardır. Bu nedenle kurumsal yeniden markalama planı olanlar lisansı baştan okumalıdır.

Ne işe yarar, kimler için?

Open WebUI bir model değildir; model, belge, kullanıcı ve araç bağlantılarını bir tarayıcı arayüzünde birleştirir. En sade kullanımda bilgisayarınızdaki Ollama sunucusuna bağlanır ve modelinize sohbet penceresinden erişirsiniz. İsterseniz OpenAI-uyumlu bir API, Anthropic, llama.cpp veya vLLM gibi başka bir sağlayıcı da eklersiniz. Belgelerden soru yanıtlama, ayrı “task model” kullanımı, araç çağrıları, filtreler ve yönetici ayarları daha sonra gelir.

Bu yaklaşım; hassas olmayan kişisel notlarını kendi makinesinde tutmak isteyenler, birden çok model sağlayıcısını tek ekranla karşılaştıran geliştiriciler ve küçük ekipte izinleri merkezi yönetmek isteyenler için uygundur. Bir sohbeti sadece arayüze taşımanın veriyi otomatik olarak yerelleştirmediğini unutmayın: seçtiğiniz model bulut API’sindeyse istek o sağlayıcıya gider. Yerel işlem için hem Open WebUI hem model sunucusu yerelde çalışmalıdır.

Başlamadan önce: küçük ama önemli kararlar

  • Tek kullanıcı mı, ekip mi? İlk denemeyi yalnızca bilgisayarınızda ve ağ dışına açmadan yapın. Ekip kurulumu; hesap, yedek, TLS, ters vekil ve güncelleme sorumluluğu getirir.
  • Model nerede çalışacak? Ollama yerel model için pratik başlangıçtır. Bulut uç noktası eklemek, anahtar ve veri aktarımı demektir; sağlayıcının saklama ve bölge politikasını ayrıca doğrulayın.
  • Ne saklanacak? Sohbet geçmişi, yüklenen belge ve vektör dizini diskte kalabilir. Kalıcı veriyi taşıyan Docker birimini yedeklemeden sürüm değiştirmeyin.
  • Hangi sürüm? Üretimde main veya dev etiketi yerine sürüm sabitleyin. v0.11.0 öncesini kullanmayın: proje, bilgi dosyası aramasındaki orta önem dereceli bir hizmet aksatma sorununu bu sürümde düzelttiğini bildiriyor.

Kurulum: yerel ve geri alınabilir başlangıç

Resmî belgeler Docker’ı hızlı yol olarak öneriyor. Önce Docker Desktop/Engine ve yerel model istiyorsanız Ollama’yı kurun; ardından bir model indirin. Örneğin terminalde ollama pull qwen3:4b komutu model dosyasını yerel depoya alır. Model adı ve bellek gereksinimi cihazınıza göre değişir; küçük bir modelle başlayın.

docker volume create open-webui-data
docker run -d --name open-webui
  -p 127.0.0.1:3000:8080
  --add-host=host.docker.internal:host-gateway
  -v open-webui-data:/app/backend/data
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434
  ghcr.io/open-webui/open-webui:v0.11.0

Buradaki 127.0.0.1:3000:8080 kasıtlıdır: arayüzü yalnız aynı bilgisayara bağlar. Yerel ağda paylaşmak için bunu 0.0.0.0 yapmadan önce kimlik doğrulama, HTTPS ve erişim politikanızı kurun. Komut Docker Desktop ile macOS/Windows’ta yaygındır; Linux’ta ana makineye erişim biçimi dağıtıma göre değişebilir. Resmî belgede Python/pip, Kubernetes ve masaüstü seçenekleri de var; ancak pip paketi için desteklenen Python aralığını sürüm notundan kontrol edin.

Tarayıcıda http://localhost:3000 adresini açın. İlk hesap yerel örneğin yönetici hesabı olabilir; güçlü ve benzersiz bir parola kullanın. Sayfanın sol yanında sohbet listesi, üst bölümde model seçici, ortada mesaj geçmişi, altta çok satırlı yazma alanı ve gönder düğmesi bulunur. Klavyeyle önce adres çubuğuna URL’yi yazın, Tab ile model seçiciye ilerleyin, ok tuşlarıyla modeli seçin; yazma alanına geçip mesajı girin. Gönderim kısayolu sürüm/ayar farkı gösterebileceğinden, ekran okuyucuda düğmenin erişilebilir adını dinleyerek doğrulayın.

Adım adım gerçek kullanım: toplantı notunu eylem listesine çevirme

Bu örnek, hassas müşteri verisi içermeyen kısa bir toplantı özetiyle çalışır. Hedef; modelin “biliyor gibi yapması” değil, kaynak metindeki belirsizlikleri ayırarak bir yapılacaklar listesi üretmesidir.

  1. Yeni sohbet açın ve model seçicide yerel modeli seçin. Önce model yanıt vermiyorsa yönetici ayarlarında model bağlantısını değil, Ollama’nın çalışıp çalışmadığını kontrol edin.
  2. Mesaj alanına toplantı notunu yapıştırın. İlk denemede dosya yüklemek yerine 15–20 satırlık metin kullanın; böylece veri akışını ve sonucu kolay denetlersiniz.
  3. Aşağıdaki istemi ekleyin. İstem, tahmin ile kanıtı ayırmayı zorlar:
Aşağıdaki toplantı notundan Türkçe bir eylem listesi üret.
Her satırda: sorumlu | iş | son tarih | kaynak cümle olsun.
Notta olmayan sorumlu veya tarih uydurma; bunları “belirsiz” yaz.
En alta, sahibine sorulacak en fazla üç net soru ekle.

[TOPLANTI NOTU BURAYA]
  1. Çıktıda her satırı nottaki kaynak cümleyle karşılaştırın. “Belirsiz” alanları doldurmak yerine ilgili kişiye soru olarak yöneltin. Bu insan denetimi, yerel model kullansanız da zorunludur.
  2. Sohbete anlamlı bir başlık verin ve gerekirse klasöre taşıyın. Aynı metni tekrar kullanacaksanız, modelin sistem istemine görev tanımını koyun; kişisel veya müşteri bilgisini sistem istemine kalıcı profil verisi gibi yazmayın.

Belge tabanlı kullanımda dosya yükleme, alma/indeksleme ve gömleme modeli ek maliyet ve hata yüzeyi getirir. Önce tek metinle doğru biçimi oturtun; sonra küçük bir test belgesiyle arama sonucunun gerçekten alıntıladığı bölümü kontrol edin.

Arayüz ve erişilebilirlik notları

Arayüz bir web uygulamasıdır; ekran okuyucu deneyimi kullanılan tarayıcı, işletim sistemi ve sürüme göre değişir. Sol kenar çubuğunda sohbet ve klasörleri; orta alanda mesajları; ayarlarda kullanıcı ve yönetici denetimlerini mantıksal bölgeler halinde dolaşın. Yalnız simgeyle görünen bir denetimde belirsizlik yaşarsanız, fareyle tahmin etmek yerine tarayıcının erişilebilirlik ağacında adını kontrol edin veya metin etiketli alternatif yolu kullanın.

Uzun yanıtlar odak kaymasına yol açabilir. Yanıt üretimi bittiğinde odak otomatik taşınmıyorsa, başlık/ana bölge kısayollarıyla son yanıta dönün; kopyalamadan önce seçili model adını ve sohbet başlığını kontrol edin. Mobilde sol panel dar ekranda kapalı başlayabilir; menü düğmesiyle açılır. Yatay taşmayı azaltmak için kod bloklarını kısa tutun, geniş tabloları kullanmayın ve telefonda yönetici ayarları yerine temel sohbet akışını tercih edin. PWA olarak ana ekrana eklenebilir; bu bir yerel model veya çevrimdışı çalışma garantisi değildir.

Araçlar, izinler ve gözlemlenebilirlik

Open WebUI araç çağrısı, eklenti, filtre ve ajan bağlama seçenekleri sunar. Bunlar modelin tarayıcıyı, dosyaları veya ağ uçlarını doğrudan “güvenli” kullandığı anlamına gelmez. Her araç için en az yetki uygulayın: yalnız gerekli klasörü bağlayın, yazma/silme eylemlerini varsayılan kapalı bırakın, üretim anahtarlarını sohbet içine yapıştırmayın ve dış URL alabilen araçları ayrı bir test örneğinde deneyin.

Yönetici tarafında yapılandırılmış günlükler, izleme ve OpenTelemetry seçenekleri bulunur; fakat günlükler de hassas veri taşıyabilir. Hata ayıklama kaydını sınırlayın, erişimini daraltın ve saklama süresi belirleyin. Modelin araç çağrılarını, hata mesajlarını ve dosya erişimlerini denetlenebilir bir olay kaydı olarak düşünün. Özellikle tarayıcı yükleyicisi, belge alma ve otomasyonlarda sonuç beklenmedikse önce aracı devre dışı bırakıp salt sohbet modunda sorunu ayırın.

Alternatiflerle karşılaştırma

Ollama’nın komut satırı, en küçük saldırı yüzeyi ve en az arayüz karmaşası için daha iyidir; fakat çok kullanıcı, belge ve sohbet yönetimi sağlamaz. LM Studio, masaüstünde model indirme ve yerel API keşfi için güçlü bir alternatiftir; ekip paylaşımı için farklı bir işletim modeli gerekir. Dify ve n8n, görsel iş akışı ve entegrasyon odaklıdır; sıradan bir sohbet çalışma alanından daha fazla bileşen ve yönetişim ister. Open WebUI, yerel model sohbetiyle araç/ekip özellikleri arasında durur; bu esneklik, daha fazla yapılandırma sorumluluğu demektir.

Güvenlik, gizlilik ve maliyet

Yerel modelde temel maliyet donanım, enerji ve bakım; bulut sağlayıcıda ise token, dosya işleme ve olası gömleme maliyetidir. API anahtarlarını arayüze eklemek, anahtarın Open WebUI örneğinizde saklanması/işlenmesi riskini doğurur; ayrı anahtar, kullanım limiti ve sağlayıcı tarafında harcama uyarısı kullanın. Sunucuyu internetten erişilebilir yapmayın; gerekiyorsa VPN, TLS, güncel imaj, düzenli yedek ve ayrı yönetici hesabı olmadan açmayın.

Projenin GitHub güvenlik duyurularını ve sürüm notlarını izleyin. İncelediğimiz duyuruda, >=0.9.6,<0.11.0 aralığını etkileyen ve 0.11.0’da düzeltilen bilgi dosyası aramasıyla ilgili hizmet aksatma açığı yer alıyor. Bu tek başına güvenlik değerlendirmesi değildir; yalnızca “eski sürümü sabitlemek” yerine düzenli, kontrollü güncelleme gerektiğini gösterir.

Sınırlamalar ve sorun giderme

  • Model listede yok: Ollama’nın çalıştığını ve konteynerin ana makine adresine eriştiğini kontrol edin. Konteyner içindeki 127.0.0.1, kendi konteyneridir; ana makine değildir.
  • Belge araması bozuldu: Gömleme modelini değiştirmeden önce dizini yedekleyin. Açık hata kayıtlarında, farklı boyutlu gömleme modeline geçildikten sonra bellek/dizin uyuşmazlığı bildiriliyor; yeniden indeksleme gerekebilir.
  • Yanıt yavaş: Önce daha küçük model ve kısa bağlam deneyin. GPU, RAM ve eşzamanlı istek sayısı sonucu doğrudan etkiler.
  • Arayüz uzaktan açıldı: Port eşlemesini durdurun, erişim günlüklerini gözden geçirin ve örneği yalnız localhost’a bağlayarak yeniden başlatın.

Test notu: Bu vardiyada macOS üzerinde Python 3.14 ile pip kurulumu denendi ve v0.11.0 paketinin Python 3.11–3.12 gereksinimi nedeniyle çalıştırılamadı. Docker Engine bulundu; izole Docker duman testi başlatıldı ancak ilk imaj indirmesi tamamlanmadan süre sınırında sonlandırıldı. Bu yüzden bu yazı canlı sohbet veya ekran okuyucu testi iddia etmez; kurulum akışı resmî dokümantasyon ve sürümleme üzerinden doğrulanmıştır.

Kaynaklar

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

✅ Uygulama Başarıyla Güncellendi!
🟢 Profil Uygulandı