Stirling-PDF, 50'ten fazla belge aracını kendi sunucunuza taşıyor

dev.to'da yayımlanan bir eğitim, Stirling-PDF'yi özel, tarayıcı tabanlı bir belge çalışma tezgâhı olarak çalıştırmayı anlatıyor; böylece sözleşmeleri ve taramaları arama sonuçlarında ilk çıkan ücretsiz PDF sitesine yükleme alışkanlığından kurtuluyorsunuz.

Öneri basit. dev.to'daki anlatıma göre yazılım, 50'den fazla PDF işlemi tek pakette sunuyor ve tamamen kendi sunucunuzda çalıştığı için dosyalarınız hiçbir zaman kontrolünüzden çıkmıyor. Uygulamanın temelinde durum bilgisi taşımayan (stateless) bir yapı var: belgeler kalıcı olarak saklanmadan işlenip geri döndürülüyor; yalnızca yapılandırma ve OCR dil verileri takılı volume'lerde kalıcı oluyor.

Docker ve Traefik ile kurulum

Kurulum, tanıdık bir self-hosting tarifi izliyor. Stirling-PDF v2.14.2 tek bir Docker Compose servisi olarak çalışıyor ve Traefik, ters proxy olarak önüne yerleştiriliyor; TLS, yapılandırılmış sertifika çözücüsü (certificate resolver) üzerinden hallediliyor. Resmî imaj kendi sağlık kontrolünü (health check) içeriyor ve Traefik trafiği yalnızca container sağlıklı olduğunu bildirdiğinde iletiyor — bu da Java uygulaması ısınırken başlangıçtan sonra yaklaşık 20-30 saniyelik bir pencere demek.

Bu stateless yapı işlemleri de hafif tutuyor. Yazar, yedeklemenin yapılandırma klasörü ve varsa özel OCR verisinden ibaret olduğunu, çünkü işlenen PDF'lerin sunucuda tutulmadığını belirtiyor.

Giriş varsayılan olarak açık

Sürüm 2, kimlik doğrulama etkin şekilde geliyor ve eğitim bunu benzer araçlardan anlamlı bir fark olarak vurguluyor. İlk giriş bilinen varsayılan admin/stirling bilgileriyle yapılıyor ve uygulama ilk girişte hemen şifre değişikliğini zorunlu kılıyor. Tavsiye açık sözlü: herkese açık bir kurulumda girişi zayıflatmayın ya da kaldırmayın, çünkü açık bir dağıtım, üzerinden geçen her belgeyi alan adını bulan herkese teslim eder.

Araç kutusu neleri kapsıyor

Arayüz yüklenen dosyaları yerleşik bir görüntüleyicide gösteriyor ve araç kataloğu imzalama, belge güvenliği ve doğrulama gibi kategorilere ayrılmış durumda. Eğitim, pratikte en sık karşılaşılan işlemleri öne çıkarıyor:

• Birden fazla PDF'i birleştirme veya tek tek sayfalara ayırma
• Büyük belgeleri e-postayla gönderebilmek için sıkıştırma
• PDF ile resim formatları arasında ve Office belgeleriyle PDF arasında dönüştürme
• Taranan sayfaları aranabilir hale getiren ve taramaları temizleyebilen OCR
• Hassas içeriği siyah bir kutuyla örterek değil kalıcı olarak kaldıran sansürlendirme
• Şifreler ve filigranlar

OCR desteği Tesseract'a dayanıyor. Standart imaj yaygın dilleri içeriyor; ek diller, ilgili .traineddata dosyalarını takılı bir klasöre bırakarak etkinleştirilebiliyor.

Bilinmeye değer uyarılar

Sınırlar kenarlarda ortaya çıkıyor. Office'ten PDF'e dönüştürme yalnızca LibreOffice'e bağlı ve bu, yalnızca imajın daha büyük fat sürümünde mevcut. OCR ve format dönüştürme bellek yoğun olduğu için küçük bir sanal sunucu büyük dosyalarda zorlanabilir. Bakım konusunda yazar, proje aktif şekilde geliştirildiği ve yeni araçlar düzenli geldiği için imaj etiketini periyodik olarak yükseltmeyi öneriyor.

Eğitim ayrıca Stirling-PDF'yi Paperless veya Nextcloud gibi belge kurulumları için bir yardımcı olarak konumlandırıyor — dosyaları bu sistemlere girmeden önce ya da çıktıktan sonra hazırlayacağınız bir yer.

Neden önemli

Ücretsiz çevrimiçi PDF araçları sessiz bir gizlilik riski: insanlar düzenli olarak sözleşmeleri, kimlik belgelerini ve finansal belgeleri saklama ve işleme politikaları belirsiz hizmetlere yükler. Self-hosted bir araç kutusu bu riskin büyük kısmını ortadan kaldırır ve stateless tasarım sayesinde sunucu sessizce evraklarınızın arşivini oluşturmaz. Kurulum maliyeti bir container ve bir alt alan adı; işleme yerel olarak gerçekleştiği için hiçbir belge verisinin ağınızdan çıkması gerekmiyor. Zaten Docker ve bir ters proxy çalıştıran herkes için Stirling-PDF, ücretsiz PDF sitelerinin arama motoru kumarına neredeyse hazır bir alternatif — dikkatle yapılandırılması gereken detaylar ise yönetici şifresi ve OCR dilleri.