Open WebUI 0.11.0 ile Yerel Belge Asistanı: Kurulum, Güvenlik ve Erişilebilirlik Testi

by

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



Kısa sonuç: Open WebUI 0.11.0, Ollama gibi yerel model çalıştırıcılarını tarayıcıdan kullanılabilen bir sohbet ve belge çalışma alanına dönüştürüyor. Sürümü macOS üzerinde geçici bir Python 3.11 ortamına gerçekten kurdum; yerel Mistral 7B modelini seçip 562 baytlık erişilebilirlik test notunu yükledim, belgenin işlenmesini ve kaynak gösteren bir tablo üretilmesini tamamladım. Akış çalıştı, ancak model “notlarda olmayan ayrıntı uydurma” talimatına rağmen testi geçen bir maddeyi düzeltilmesi gereken sorun gibi yorumladı. Dolayısıyla Open WebUI belgeyi modele ulaştırmayı kolaylaştırıyor; çıktının doğruluğunu garanti etmiyor.

Open WebUI ne işe yarar, kimler için uygun?

Open WebUI, yerel veya uzaktaki modelleri tek bir web arayüzünde kullanmaya yarayan, kendi sunucunda barındırılabilen bir AI çalışma alanı. Ollama, llama.cpp ve çeşitli OpenAI uyumlu API’lere bağlanabiliyor; sohbet, dosya yükleme, bilgi tabanı, model seçimi, araçlar ve yönetim denetimlerini aynı arayüzde topluyor. Bu yazının odağı, haber özeti değil: kısa bir denetim notunu yerel modelle yapılandırılmış eylem tablosuna çevirmek.

Hassas olmayan belgeleri bulut API’sine göndermeden incelemek isteyen bireyler, küçük ekipler ve kurum içi pilotlar için anlamlı. Birden fazla kullanıcı, paylaşımlı bilgi tabanı veya terminal ve araç çalıştırma hedefleniyorsa ürün artık basit bir “yerel sohbet kutusu” olmaktan çıkar; kimlik doğrulama, yedekleme, ağ ayrımı, yetki ve güncelleme planı gerektiren bir sunucu uygulamasına dönüşür. Yalnız tek modele tek istek gönderen bir betik içinse bu kadar geniş bir arayüz gereksiz olabilir.

Kurulum: üretimde sürümü sabitleyin

Resmî hızlı başlangıç belgesi çoğu kullanıcıya Docker’ı öneriyor. Belgede main ve latest etiketlerinin sabit sürüm değil, değişken geliştirme görüntüleri olduğu özellikle belirtiliyor. Üretimde v0.11.0 gibi sürüm etiketi ve kalıcı veri birimi kullanmak daha tekrarlanabilir:

export WEBUI_SECRET_KEY='uzun-rastgele-ve-gizli-bir-deger'
docker run -d \
  -p 3000:8080 \
  -e WEBUI_SECRET_KEY \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -v open-webui-data:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:v0.11.0

Benim makinemde Docker istemcisi vardı fakat hizmet çalışmıyordu; bu nedenle Docker yolunu çalıştırmış gibi göstermedim. Bunun yerine resmî olarak belgelenen Python/uv yöntemini, yalnız test verisi içeren geçici dizinde kullandım:

DATA_DIR=/tmp/open-webui-test-data \
WEBUI_AUTH=False \
OLLAMA_BASE_URL=http://127.0.0.1:11434 \
uvx --python 3.11 'open-webui==0.11.0' serve --port 8765

İlk çalıştırmada 258 Python paketi kuruldu; gömme modeli için ayrıca yaklaşık 931 MB dosya indirildi. Bu rakamlar benim 10 Ağustos 2026 tarihli testimin ağ hareketidir, genel kurulum boyutu garantisi değildir. WEBUI_AUTH=False yalnız izole, tek kullanıcılı test içindi. Resmî belge bu mod ile çok kullanıcılı kimlik doğrulama modu arasında sonradan geçiş yapılamayacağı konusunda uyarıyor. İnternete açık veya ortak kullanılan kurulumda bu seçeneği kullanmayın.

Adım adım gerçek kullanım: denetim notundan eylem tablosuna

  1. Arayüzü açın: Yerel sunucu başladıktan sonra http://127.0.0.1:8765 adresine gidin. Sol tarafta “Yeni Sohbet”, “Ara”, “Notlar” ve “Çalışma Alanı” girişleri bulunuyor.
  2. Modeli seçin: Mesaj alanının yanındaki model seçiciyi açıp sohbet üretebilen modeli seçin. Arayüz benim kurulumumda nomic-embed-text gömme modelini de sohbet modeli gibi listeliyordu; yalnız adı listede göründü diye doğru modeli seçtiğinizi varsaymayın. Testte yerel mistral:7b kullandım.
  3. Dosyayı ekleyin: “Daha Fazla” menüsündeki “Dosyaları Yükle” denetimiyle Markdown notunu yükleyin. Sunucu dosyayı bir Markdown başlık ayırıcıyla işledi, tek parça için gömme oluşturdu ve koleksiyona ekledi.
  4. Sınırları belirleyen istemi yazın: İstenen sütunları, kaynak sınırını ve uydurma yasağını açıkça söyleyin.
  5. Kaynak ve doğruluk kontrolü yapın: Yanıttaki “1 kaynak getirildi” denetimini açın; her satırın gerçekten dosyadan gelip gelmediğini karşılaştırın.

Testte kullandığım istem şuydu:

Ekli notları yalnız verilen içeriğe dayanarak Türkçe bir tabloya dönüştür.
Sütunlar: Bulgu, Etkilenen kullanıcı, Öncelik, Önerilen düzeltme.
Testi geçen maddeyi ayrıca belirt; notlarda olmayan bir ayrıntı uydurma.

Open WebUI dosyayı başarıyla getirdi, tablo başlıklarını semantik sütun başlıkları olarak sundu ve satırlara kaynak düğmeleri ekledi. Ancak Mistral 7B, “200% yakınlaştırmada yatay kaydırma oluşmuyor” biçimindeki geçen testi hata gibi ele alıp yeni bir yöntem önerdi. “Etkilenen kullanıcı” sütununa da kullanıcı grubu yerine “Form hataları” gibi sınıflar yazdı. Bu iki hata, yerel modelin akıcı tablo üretmesinin veri sadakati anlamına gelmediğini gösteriyor.

Daha güvenilir bir kontrol akışı

Bu tür bir görevde sonucu doğrudan iş takip sistemine göndermek yerine üç aşamalı doğrulama kullanın. Önce modelden yalnız nottaki cümleleri geçti, kaldı, belirsiz olarak sınıflandırmasını isteyin. Ardından yalnız “kaldı” sınıfındaki maddeler için düzeltme önerisi üretin. Son olarak her önerinin yanına kaynak cümlesini ekletip insan onayı olmadan yazma işlemi yaptırmayın.

Beklenen doğru ayrımda görünür etiketi olmayan e-posta alanı ve yalnız renkle verilen hata yüksek öncelikli bulgudur; PDF dilinin belirtilmemesi orta önceliklidir. Klavyeyle ulaşılabilen gönder düğmesi ile yüzde 200 yakınlaştırmada taşma olmaması geçen testlerdir. Model bu ayrımı korumuyorsa istemi büyütmekten önce daha uygun modeli, daha düşük sıcaklığı ve şemalı çıktıyı deneyin.

Arayüz ve erişilebilirlik notları

Arayüz tarayıcı dilini algılayarak büyük ölçüde Türkçe açıldı. İlk sürüm notu penceresinde “Kapat” ve “Tamam, Hadi Başlayalım!” denetimleri; ana akışta “Kenar Çubuğunu Aç”, “Yeni Sohbet”, “Ara”, “Notlar”, “Çalışma Alanı”, “Geçici Sohbet”, “Daha Fazla” ve seçili modeli açıklayan adlandırılmış düğmeler vardı. Mesaj alanının erişilebilir adı “Bugün size nasıl yardımcı olabilirim?” olarak duyurulabiliyor. Üretilen tabloda sütun başlıkları gerçek başlık hücreleriydi; kaynak düğmesi de dosya adıyla adlandırılmıştı.

Olumlu tabloya rağmen tam bir WCAG denetimi yapılmış değil. Atlama bağlantısı “Skip to main content”, önerilen istemler ve “Voice Input” etiketi İngilizce kaldı; Türkçe ekran okuyucu akışında dil karışıklığı yaratabilir. DOM kontrolünde ana ekranda erişilebilir adı olmayan iki düğme adayı görüldü. 320 piksel emüle edilmiş görünümde belge genişliği 320 piksel kaldı ve sayfa düzeyinde yatay taşma oluşmadı. Bu, tek bir ana ekran ve mevcut durum üzerinde yapılan otomatik kontroldür; VoiceOver, NVDA, yüksek karşıtlık, yüzde 400 yakınlaştırma ve tüm yönetim ekranları ayrıca sınanmalıdır.

Open WebUI, LM Studio ve doğrudan Ollama karşılaştırması

Doğrudan Ollama API’si en küçük saldırı yüzeyini ve en kolay otomasyonu sunar; dosya parçalama, kullanıcı yönetimi ve kaynak arayüzünü sizin kurmanız gerekir. LM Studio masaüstünde model indirme ve yerel sunucu başlatmayı kolaylaştırır; Open WebUI kadar geniş çok kullanıcılı çalışma alanı hedeflemez. Open WebUI belge, sohbet, model ve yönetim katmanlarını bir araya getirir; karşılığında daha büyük bağımlılık kümesi, veritabanı, yetki modeli ve düzenli güvenlik güncellemesi yükü getirir.

Yerel çalıştırma “ücretsiz” ile eş anlamlı değildir. Open WebUI için ayrı bir token ücreti olmayabilir; donanım, elektrik, depolama, yedekleme ve yöneticinin zamanı maliyettir. Bulut sağlayıcısı eklerseniz onun API tarifesi geçerlidir. Model ağırlıkları, gömme modeli ve eklentiler ana uygulamanın lisansından ayrı koşullara sahip olabilir.

Güvenlik, gizlilik ve lisans

0.11.0 sürümüne yükseltme yalnız özellik tercihi değil, güvenlik gereğidir. GitHub güvenlik duyurularında 0.11.0’ın düzelttiği 17 kayıt bulunuyor: 6 yüksek, 10 orta ve 1 düşük önem dereceli. Bunlar OAuth hesap ele geçirme, SSRF, depolanmış XSS, kullanıcılar arası dosya veya araç bilgisi sızıntısı ve yetki aşımı gibi başlıkları içeriyor. Bu nedenle 0.10.2 ve öncesini internete açık bırakmak makul değil. Sürümü sabitleyin, güvenlik duyurularını izleyin, veri yedeği alın ve 0.11.0 sürüm notundaki şema değişikliği nedeniyle çok sunuculu kurulumları aynı anda yükseltin.

Yerel Ollama kullanıldığında testteki sohbet üretimi yerel makinede gerçekleşti; fakat ilk açılışta gömme modeli Hugging Face’ten indirildi ve Open WebUI sürüm kontrolü gibi dış istekler görüldü. “Tamamen çevrimdışı” hedefi olan ekip, bağımlılıkları önceden aynalamalı, ağ çıkışını ölçmeli ve engellemeli. Dosya yükleme, URL getirme, web arama, terminal, araçlar ve eklentiler ayrı ayrı veri çıkışı veya kod çalıştırma riski taşır. En az yetkiyi verin; sunucuyu varsayılan olarak yalnız yerel ağa bağlayın.

Depodaki lisans MIT veya Apache 2.0 değil. “Open WebUI License”, kaynak ve ikili dağıtıma izin veren koşullara ek olarak markanın değiştirilmesini sınırlandırıyor; 30 günlük hareketli dönemde 50’yi aşmayan son kullanıcı, yazılı izin veya kurumsal lisans istisnaları tanımlıyor. Eski katkılar için LICENSE_HISTORY dosyasındaki önceki koşullar korunuyor. Bu nedenle ürünü yeniden markalayacak kurumlar lisansı hukuk ekibiyle incelemeli; “GitHub’da kodu var” ifadesini sınırsız açık kaynak hakkı gibi yorumlamamalı.

Sınırlamalar ve sorun giderme

Depo arşivlenmiş değil ve son kararlı 0.11.0 sürümü 27 Temmuz’da yayımlandı; güvenlik düzeltmelerinin topluca duyurulması bakımın sürdüğünü gösteriyor. Buna karşılık güncel issue akışında URL veya YouTube eki yüklenirken isteğin gönderilmemesi, içeriğin modele boş ulaşması ve başarısız eklerde açıklayıcı hata gösterilmemesi gibi doğrulanmış kayıtlar bulunuyor. Ben yerel Markdown dosyasını sınadım; URL ve YouTube ekleme yolunu başarılı saymadım. Yıldız veya “trend” sırasını kalite kanıtı olarak kullanmadım.

  • Ollama görünmüyor: Kapsayıcı içindeki 127.0.0.1 kendi kapsayıcısını gösterir. macOS ve Windows’ta host.docker.internal:11434 kullanın; uzak sunucuda TLS ve ağ erişimini ayrıca yapılandırın.
  • Gömme modeli sohbet listesinde: nomic-embed-text gibi modeller metin üretmek için değildir. Model seçicisinde ayrı bir sohbet modeli seçin.
  • İlk açılış yavaş: Python bağımlılıkları ve gömme modeli ilk çalıştırmada indirilebilir. İndirme tamamlanmadan belge işleme hazır görünmeyebilir.
  • Yanıt kaynağa aykırı: Kaynak düğmelerini açın, geçen/kalan ayrımını ayrı adım yapın ve insan onayı ekleyin. RAG, modelin yorum hatasını ortadan kaldırmaz.
  • Yükseltme başarısız: Önce veritabanı ve dosya birimini yedekleyin. 0.11.0 sürüm notu, yük dengelemeli kurulumlarda kademeli yükseltmenin şema uyumsuzluğu yaratabileceğini söylüyor.

Sonuç olarak Open WebUI 0.11.0, yerel modellerle belge üzerinde çalışmayı erişilebilir bir web akışına dönüştürüyor ve kaynak görünürlüğü sağlıyor. En iyi kullanım biçimi, onu “doğru cevap makinesi” değil; sürümü sabitlenmiş, izinleri daraltılmış ve her kritik çıktısı insan tarafından doğrulanan bir çalışma yüzeyi olarak görmek.

Kaynaklar

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