Stirling PDF: VPS'te kendi PDF editörünüzü nasıl kurarsınız?

Bir sözleşmeyi ekiyle birleştirmek, pasaport taramasını sıkıştırmak veya ödeme bilgilerini gizlemek için birçok kişi bulduğu ilk çevrimiçi hizmete belge yükler. Dosyayla birlikte imzalar, adresler, faturalar ve diğer gizli veriler üçüncü taraf bir web sitesine gönderilebilir.

Stirling PDF farklı bir yaklaşım sunar. Kendi VPS'inizde çalıştırabileceğiniz onlarca PDF aracına sahip bir web uygulamasıdır. Arayüz bilgisayar veya telefondaki tarayıcıda açılır, belgeleri ise sunucunuz işler.

Aşağıda en ilgi çekici Stirling PDF özelliklerini, sunucu gereksinimlerini ve kimlik doğrulama ile HTTPS içeren Docker Compose kullanarak Ubuntu'ya nasıl kurulacağını inceleyeceğiz.

Stirling PDF nedir?

Stirling PDF, PDF dosyalarını düzenlemek ve işlemek için self-hosted bir platformdur. Dosyaları birleştirme ve bölme, sayfaları yeniden düzenleme, sıkıştırma, dönüştürme, OCR, imzalar, filigranlar, belge karşılaştırma ve meta verilerle gizli bilgileri kaldırma dâhil 55'ten fazla işlemi bir araya getirir.

Hizmet masaüstü uygulaması, bulut ürünü veya self-hosted sunucu olarak kullanılabilir. Self-hosted modda dosyalar kendi Stirling PDF instance'ınız tarafından işlenir; erişim parola ve HTTPS ile korunabilir. Ücretsiz sunucu sürümü en fazla beş kullanıcılı gruplar için tasarlanmıştır; daha büyük ekipler ve belirli kurumsal özellikler için ücretli sürümler vardır.

Normal bir çevrimiçi dönüştürücüden temel fark kontrolün sizde olmasıdır. Sağlayıcıyı, sunucu konumunu, kullanıcıları ve erişim kurallarını seçersiniz. Aynı zamanda her işlem için ayrı bir web sitesi aramanız gerekmez: tek arayüz sıkıştırma, dönüştürme, imzalama ve OCR hizmetlerinden oluşan bir koleksiyonun yerini alır.

En ilgi çekici Stirling PDF özellikleri

Görsel sayfa yönetimi

Multi-Tool modunda belge küçük resimlerden oluşan bir ızgara olarak görüntülenir. Sayfalar sürüklenebilir, döndürülebilir, silinebilir, bölünebilir, gerekli konuma eklenebilir ve seçilerek dışa aktarılabilir. Dosya yalnızca bir kez yüklenir; değişiklikler geri alma ve yineleme işlemlerini destekler.

Taranmış belgeler için OCR

OCR, taranmış bir PDF'e metin katmanı ekler. İşlemden sonra belgede kelime arayabilir, metni seçip kopyalayabilirsiniz. Eğrilik düzeltme, gürültü giderme ve kontrast iyileştirme de mevcuttur. Rusça için Tesseract paketi rus.traineddata ayrıca eklenmelidir.

Güvenli veri redaksiyonu

Bir hesap numarasının üzerine yerleştirilen siyah bir dikdörtgen orijinal metni her zaman kaldırmaz. Redact aracı, metni yalnızca görsel bir katmanla kapatmak yerine eşleşmeleri PDF yapısından silebilir. Bir alanı elle işaretleyebilir veya kelimeler ya da regular expression kullanarak telefon numaralarını, e-posta adreslerini, kart numaralarını ve diğer verileri tüm belgede arayabilirsiniz.

Sürüm karşılaştırma ve mobil tarayıcı

Compare, bir sözleşmenin, raporun veya teknik şartnamenin iki sürümü arasında hangi kelimelerin eklendiğini ya da çıkarıldığını gösterir. Kâğıt belgeler için mobil tarayıcı bulunur: bilgisayarda bir QR kodu görünür, telefon fotoğrafları doğrudan mevcut oturuma yükler ve geçici dosyalar indirme işleminden veya on dakika işlem yapılmamasından sonra otomatik olarak silinir.

Otomasyon ve API

Automate, PDF dosyaları için makrolar gibi çalışır. Örneğin şu workflow'u bir kez kaydedebilirsiniz:

OCR → remove blank pages → compress → add a watermark → set a password

Aynı workflow daha sonra her adımı tekrarlamadan yeni dosyalara uygulanabilir. Stirling PDF ayrıca izlenen bir klasörden dosya işlemeyi destekler ve yerleşik Swagger belgelerine sahip bir REST API sunar.

Stirling PDF ne tür bir VPS ister?

Bir PDF'i işlemek, kaynak dosyanın kapladığından çok daha fazla bellek gerektirebilir. OCR, sayfaları görsellere dönüştürmek ve LibreOffice aracılığıyla ofis belgelerini dönüştürmek özellikle kaynak tüketir.

Test kurulumu için 2 GB RAM yeterlidir, ancak düzenli kullanımda şunları seçmek daha iyidir:

• 2 vCPU;
• 4 GB RAM;
• SSD veya NVMe sürücüsünde en az 10–20 GB boş alan;
• Ubuntu 22.04 veya 24.04.

Birkaç kullanıcı aynı anda OCR veya dönüştürme çalıştırıyorsa 4 vCPU ve 8 GB RAM seçmek daha mantıklıdır. Düşük güçlü bir sunucu için latest-ultra-lite image'ı bulunur; latest-fat ise daha yüksek kaliteli dönüştürme için ek fontlar ve araçlar içerir. Standart latest image'ı çoğu kullanıcı için uygundur.

Docker Compose ile Stirling PDF kurulumu

Aşağıdaki yapılandırmada container yalnızca yerel arayüzü dinler. Dış erişim daha sonra HTTPS içeren Nginx üzerinden sağlanacağından 8080 portu tüm internete açılmaz.

Adım 1. Docker'ı kurun

ssh root@SERVER_IP
apt update && apt upgrade -y
apt install -y curl
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
rm get-docker.sh

Kurulumu doğrulayın:

docker --version
docker compose version

Adım 2. Docker Compose yapılandırmasını oluşturun

mkdir -p /opt/stirling-pdf/{configs,logs,pipeline}
cd /opt/stirling-pdf
nano docker-compose.yml

Yapılandırmayı ekleyin:

services:
  stirling-pdf:
    image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest
    container_name: stirling-pdf
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:8080"
    volumes:
      - ./configs:/configs
      - ./logs:/logs
      - ./pipeline:/pipeline
    environment:
      - SECURITY_ENABLELOGIN=true
      - SYSTEM_DEFAULTLOCALE=ru-RU
      - SYSTEM_GOOGLEVISIBILITY=false

Hizmeti başlatın:

docker compose up -d
docker compose ps

Tanılama için:

docker compose logs --tail=100 stirling-pdf

Adım 3. İlk kez giriş yapın

Alan adını yapılandırmadan önce arayüzü bir SSH tüneli üzerinden açın. Komutu bilgisayarınızda çalıştırın:

ssh -L 8080:127.0.0.1:8080 root@SERVER_IP

http://localhost:8080 adresine gidin. İlk giriş için varsayılan bilgiler kullanıcı adı admin, parola stirling şeklindedir. Hesap ayarlarından parolayı hemen değiştirin.

Alan adı ve HTTPS bağlama

pdf.example.com gibi bir adres için A türü DNS kaydı oluşturun ve sunucunun IP adresine yönlendirin. Ardından Nginx ve Certbot'u kurun:

apt install -y nginx certbot python3-certbot-nginx
nano /etc/nginx/sites-available/stirling-pdf

Yapılandırmayı ekleyip alan adını değiştirin:

server {
    listen 80;
    server_name pdf.example.com;
    client_max_body_size 500M;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
    }
}

Site'ı etkinleştirip sertifika alın:

ln -s /etc/nginx/sites-available/stirling-pdf /etc/nginx/sites-enabled/stirling-pdf
nginx -t
systemctl reload nginx
certbot --nginx -d pdf.example.com

Stirling PDF artık HTTPS üzerinden kullanılabilir, dahili 8080 portu ise kapalı kalır. 500 MB'tan büyük dosyalar için client_max_body_size değerini artırın.

Rusça OCR ekleme

Bir dizin oluşturup İngilizce ve Rusça Tesseract paketlerini indirin:

cd /opt/stirling-pdf
mkdir -p tessdata
curl -L -o tessdata/eng.traineddata \
  https://raw.githubusercontent.com/tesseract-ocr/tessdata_fast/main/eng.traineddata
curl -L -o tessdata/rus.traineddata \
  https://raw.githubusercontent.com/tesseract-ocr/tessdata_fast/main/rus.traineddata

docker-compose.yml dosyasının volumes bölümüne şu satırı ekleyin:

      - ./tessdata:/usr/share/tessdata

Değişiklikleri uygulayıp kullanılabilir dilleri kontrol edin:

docker compose up -d
docker exec stirling-pdf tesseract --list-langs

Listede eng ve rus bulunmalıdır.

Güvenlik, güncellemeler ve sınırlamalar

Düzenli kullanımdan önce varsayılan parolayı değiştirin, kimlik doğrulamayı açık tutun, 8080 portunu expose etmeyin ve firewall üzerinden yalnızca SSH, HTTP ve HTTPS'e izin verin. configs ve pipeline dizinleri yedeklere dahil edilmelidir. Stirling PDF analizleri yalnızca kullanıcı onayından sonra etkinleşir ve yönetici tarafından tamamen kapatılabilir.

Uygulamayı güncellemek için:

cd /opt/stirling-pdf
docker compose pull
docker compose up -d

Stirling PDF günlük işlerin çoğunu karşılar, ancak PDF ile ofis biçimleri arasında dönüştürme yaparken karmaşık yerleşimleri her zaman korumaz. OCR tabloların ve formüllerin yapısını tanımaz; el yazısı veya çok küçük metinlerde kalite sınırlıdır. İyi sonuç için yaklaşık 300 DPI çözünürlüklü, temiz taramalar kullanın.

tropic.host VPS'inde Stirling PDF

Hizmet bir grafik kartı gerektirmez: RAM, kararlı CPU performansı ve hızlı depolama daha önemlidir. Büyük belgeler önce sunucuya yüklenip daha sonra tekrar indirildiğinden kullanıcılara yakın bir konum seçmek daha iyidir.

Kişisel bir instance veya küçük ekip için 2 vCPU ve 4 GB RAM'li bir Linux VPS genellikle yeterlidir. tropic.host VPS'inde Ubuntu kurabilir, yukarıdaki Docker Compose yapılandırmasını başlatabilir ve arayüzü ayrı bir alt alan adında barındırabilirsiniz. Aynı sunucuda başka container'lar çalışıyorsa ek bellek özellikle önemlidir.

Sonuç

Stirling PDF bir VPS'i belgeler için kendi web hizmetinize dönüştürür. Düzinelerce aracı birleştirir ve OCR'ı, gizli verilerin gerçekten kaldırılmasını, sürüm karşılaştırmayı, mobil taramayı, otomasyonu ve API'yi destekler.

Kendi sunucunuzda kurmanın temel nedeni dosyalarınız üzerindeki kontroldür. Sözleşmeler, faturalar, formlar ve dahili belgeler için kimlik doğrulamalı ve HTTPS korumalı bir instance, rastgele çevrimiçi dönüştürücülerden oluşan bir koleksiyondan daha kullanışlıdır.

SSS

Stirling PDF ücretsiz mi?

Evet. Ücretsiz self-hosted sürüm en fazla beş kullanıcıyı destekler. Daha büyük ekipler ve kurumsal özelliklere ihtiyaç duyan kuruluşlar ücretli sürümü kullanmalıdır.

Belgeler sunucumdan ayrılır mı?

Self-hosted modda belgeler kendi Stirling PDF instance'ınız tarafından işlenir. Nihai güvenlik düzeyi VPS yapılandırmasına, HTTPS'e, parolalara, güncellemelere ve yönetici erişimine bağlıdır.

2 GB RAM yeterli mi?

Test ve hafif işlemler için evet. Düzenli kullanım, OCR ve dönüştürme için 4 GB RAM seçmek; eşzamanlı iş yükleri için ise daha fazlasını ayırmak daha iyidir.

Alan adı gerekli mi?

Hayır. Hizmet IP adresi veya SSH tüneli üzerinden açılabilir. Kullanışlı ve kalıcı bir adres ile doğru HTTPS yapılandırması için alan adı yararlıdır.

Rusça OCR destekleniyor mu?

Evet. rus.traineddata dosyasını Tesseract dizinine ekleyip container'a mount edin.