Language: az

Stirling PDF: VPS-də şəxsi PDF redaktorunu necə quraşdırmalı

Müqaviləyə əlavəni birləşdirmək, pasport skanını sıxmaq və ya ödəniş məlumatlarını gizlətmək lazım olduqda, çoxları sənədi axtarışda tapdığı ilk onlayn xidmətə yükləyir. Faylla birlikdə imzalar, ünvanlar, hesab-fakturalar və digər məxfi məlumatlar da üçüncü tərəfin saytına göndərilə bilər.

Stirling PDF fərqli yanaşma təklif edir. Bu, öz VPS-inizdə işlədə biləcəyiniz onlarla PDF alətinə malik web-tətbiqdir. İnterfeys kompüter və ya telefon brauzerində açılır, sənədləri isə sizin serveriniz emal edir.

Aşağıda Stirling PDF-in ən faydalı imkanlarına, server tələblərinə və Ubuntu-da Docker Compose, autentifikasiya və HTTPS ilə quraşdırılmasına baxacağıq.

Stirling PDF nədir

Stirling PDF PDF fayllarını redaktə və emal etmək üçün öz serverinizdə yerləşdirilən platformadır. O, 55-dən çox əməliyyatı birləşdirir: faylları birləşdirmək və bölmək, səhifələrin sırasını dəyişmək, sıxmaq, konvertasiya etmək, OCR, imza və su nişanı əlavə etmək, sənədləri müqayisə etmək, metadata və məxfi məlumatları silmək.

Xidmətdən masaüstü tətbiqi, bulud məhsulu və ya öz serverinizdə self-hosted instans kimi istifadə etmək olar. Self-hosted rejimində faylları sizin Stirling PDF instansınız emal edir, girişi isə parol və HTTPS ilə qorumaq mümkündür. Pulsuz server buraxılışı beş istifadəçiyə qədər olan qruplar üçün nəzərdə tutulub; daha böyük komandalar və bəzi korporativ imkanlar üçün ödənişli buraxılışlar var.

Adi onlayn konvertordan əsas fərq nəzarətin sizdə olmasıdır. Provayderi, serverin yerləşdiyi məkanı, istifadəçiləri və giriş qaydalarını özünüz seçirsiniz. Bununla yanaşı, hər əməliyyat üçün ayrıca sayt axtarmağa ehtiyac qalmır: bir interfeys sıxma, konvertasiya, imzalama və OCR xidmətlərinin bütöv dəstini əvəz edir.

Stirling PDF-in ən faydalı imkanları

Səhifələrin vizual idarə edilməsi

Multi-Tool rejimində sənəd miniatürlər şəbəkəsi kimi göstərilir. Səhifələri sürükləmək, çevirmək, silmək, bölmək, lazımi yerə yerləşdirmək və yalnız seçilənləri ixrac etmək mümkündür. Fayl yalnız bir dəfə yüklənir, dəyişiklikləri geri almaq və yenidən tətbiq etmək dəstəklənir.

Skan edilmiş sənədlər üçün OCR

OCR skan edilmiş PDF-ə mətn qatı əlavə edir. Emaldan sonra sənəddə söz axtarmaq, mətni seçmək və kopyalamaq olar. Əyri səhifələri düzəltmək, səs-küyü silmək və kontrastı artırmaq imkanları da var. Rus dili üçün Tesseract paketinə aid rus.traineddata faylını ayrıca əlavə etmək lazımdır.

Məxfi məlumatların təhlükəsiz gizlədilməsi

Hesab nömrəsinin üzərinə çəkilən qara düzbucaqlı ilkin mətni həmişə silmir. Redact aləti uyğunluqları sadəcə vizual qatla örtmək əvəzinə PDF strukturundan silə bilər. Sahəni əl ilə işarələmək və ya sözlər, yaxud müntəzəm ifadələr vasitəsilə bütün sənəddə telefon nömrələri, e-poçt ünvanları, kart nömrələri və digər məlumatları axtarmaq mümkündür.

Versiyaların müqayisəsi və mobil skaner

Compare müqavilənin, hesabatın və ya texniki spesifikasiyanın iki versiyasında hansı sözlərin əlavə və ya silindiyini göstərir. Kağız sənədlər üçün mobil skaner də var: kompüterdə QR-kod görünür, telefon şəkilləri cari sessiyaya birbaşa yükləyir, müvəqqəti fayllar isə endirmədən sonra və ya on dəqiqəlik fəaliyyətsizlikdən sonra avtomatik silinir.

Avtomatlaşdırma və API

Automate PDF faylları üçün makrolar kimi işləyir. Məsələn, aşağıdakı iş axınını bir dəfə saxlamaq olar:

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

Sonra hər addımı təkrar etmədən həmin iş axınını yeni fayllara tətbiq etmək mümkündür. Stirling PDF izlənən qovluqdan faylların emalını da dəstəkləyir və daxili Swagger sənədlərinə malik REST API təqdim edir.

Stirling PDF üçün hansı VPS lazımdır

PDF-i emal etmək üçün mənbə faylın öz həcmindən xeyli çox yaddaş tələb oluna bilər. OCR, səhifələri şəkillərə çevirmək və ofis sənədlərini LibreOffice vasitəsilə konvertasiya etmək xüsusilə çox resurs istifadə edir.

Sınaq quraşdırması üçün 2 GB RAM kifayətdir, lakin müntəzəm istifadə üçün bunları seçmək daha yaxşıdır:

• 2 vCPU;
• 4 GB RAM;
• SSD və ya NVMe diskdə ən azı 10–20 GB boş yer;
• Ubuntu 22.04 və ya 24.04.

Bir neçə istifadəçi eyni vaxtda OCR və ya konvertasiya işə salırsa, 4 vCPU və 8 GB RAM seçmək daha məqsədəuyğundur. Zəif server üçün latest-ultra-lite obrazı mövcuddur, latest-fat isə daha keyfiyyətli konvertasiya üçün əlavə şriftlər və alətlər ehtiva edir. Əksər istifadəçilər üçün standart latest obrazı uyğundur.

Stirling PDF-i Docker Compose ilə quraşdırmaq

Aşağıdakı konfiqurasiyada konteyner yalnız lokal interfeysdə dinləyir. Xarici giriş sonradan Nginx və HTTPS üzərindən veriləcək, buna görə 8080 portu bütün internetə açılmayacaq.

Addım 1. Docker quraşdırın

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

Quraşdırmanı yoxlayın:

docker --version
docker compose version

Addım 2. Docker Compose konfiqurasiyasını yaradın

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

Konfiqurasiyanı əlavə edin:

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

Xidməti işə salın:

docker compose up -d
docker compose ps

Diaqnostika üçün istifadə edin:

docker compose logs --tail=100 stirling-pdf

Addım 3. İlk dəfə daxil olun

Domeni sazlamazdan əvvəl interfeysi SSH tuneli ilə açın. Komandanı öz kompüterinizdə icra edin:

ssh -L 8080:127.0.0.1:8080 root@SERVER_IP

http://localhost:8080 ünvanına keçin. İlk giriş üçün standart istifadəçi adı admin, parol isə stirling-dir. Hesab parametrlərində parolu dərhal dəyişin.

Domen və HTTPS qoşulması

pdf.example.com kimi ünvan üçün A tipli DNS yazısı yaradın və onu serverin IP ünvanına yönləndirin. Sonra Nginx və Certbot quraşdırın:

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

Konfiqurasiyanı əlavə edin və domen adını dəyişin:

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;
    }
}

Saytı aktivləşdirin və sertifikat 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

Artıq Stirling PDF HTTPS üzərindən əlçatandır, daxili 8080 portu isə bağlı qalır. 500 MB-dan böyük fayllar üçün client_max_body_size dəyərini artırın.

Rus dili OCR-ı necə əlavə etməli

Qovluq yaradın və Tesseract üçün ingilis və rus paketlərini endirin:

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

volumes bölməsindəki docker-compose.yml faylına bu sətri əlavə edin:

      - ./tessdata:/usr/share/tessdata

Dəyişiklikləri tətbiq edin və əlçatan dilləri yoxlayın:

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

Siyahıda eng və rus olmalıdır.

Təhlükəsizlik, yeniləmələr və məhdudiyyətlər

Müntəzəm istifadədən əvvəl standart parolu dəyişin, autentifikasiyanı aktiv saxlayın, 8080 portunu açıq internetə çıxarmayın və firewall-da yalnız SSH, HTTP və HTTPS-ə icazə verin. configs və pipeline qovluqları ehtiyat nüsxələrə daxil edilməlidir. Stirling PDF analitikası yalnız istifadəçi razılığından sonra aktivləşir və administrator tərəfindən tamamilə söndürülə bilər.

Tətbiqi yeniləmək üçün icra edin:

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

Stirling PDF gündəlik tapşırıqların çoxunu yerinə yetirir, lakin PDF və ofis formatları arasında konvertasiya zamanı mürəkkəb maketi həmişə qoruya bilmir. OCR cədvəl və düsturların strukturunu tanımır, əl yazısı və ya çox kiçik mətnin keyfiyyəti isə məhduddur. Yaxşı nəticə üçün təxminən 300 DPI ayırdetmə qabiliyyətinə malik aydın skanlardan istifadə edin.

tropic.host VPS-də Stirling PDF

Xidmət üçün qrafik kartı lazım deyil: RAM, prosessorun sabit məhsuldarlığı və sürətli yaddaş daha vacibdir. İstifadəçilərə yaxın məkan seçmək yaxşıdır, çünki böyük sənədlər əvvəlcə serverə yüklənir, sonra yenidən endirilir.

Şəxsi instans və ya kiçik komanda üçün 2 vCPU və 4 GB RAM olan Linux VPS adətən kifayətdir. tropic.host VPS-də Ubuntu quraşdıra, yuxarıdakı Docker Compose konfiqurasiyasını işə sala və interfeysi ayrıca subdomen üzərində yerləşdirə bilərsiniz. Eyni serverdə başqa konteynerlər də işləyirsə, əlavə yaddaş xüsusilə vacibdir.

Nəticə

Stirling PDF VPS-i sənədlər üçün şəxsi web-xidmətə çevirir. O, onlarla aləti, OCR-ı, məxfi məlumatların həqiqətən silinməsini, versiyaların müqayisəsini, mobil skan etməni, avtomatlaşdırmanı və API-ı birləşdirir.

Onu özünüz yerləşdirməyin əsas səbəbi fayllarınıza nəzarət etməkdir. Müqavilələr, hesab-fakturalar, formalar və daxili sənədlər üçün autentifikasiya və HTTPS olan qorunan instans təsadüfi onlayn konvertorlar toplusundan daha rahatdır.

FAQ

Stirling PDF pulsuzdurmu

Bəli. Pulsuz self-hosted buraxılış beş istifadəçiyə qədər dəstəkləyir. Daha böyük komandalar və korporativ imkanlara ehtiyacı olan təşkilatlar ödənişli buraxılışdan istifadə etməlidir.

Sənədlər serverimdən çıxırmı

Self-hosted rejimində onları sizin Stirling PDF instansınız emal edir. Yekun təhlükəsizlik səviyyəsi VPS konfiqurasiyasından, HTTPS-dən, parollardan, yeniləmələrdən və administrator girişindən asılıdır.

2 GB RAM kifayətdirmi

Sınaq və yüngül əməliyyatlar üçün bəli. Daimi istifadə, OCR və konvertasiya üçün 4 GB RAM, eyni vaxtda çox iş olduqda isə daha çox yaddaş seçmək yaxşıdır.

Domen tələb olunurmu

Xeyr. Xidməti IP ünvanı ilə və ya SSH tuneli üzərindən açmaq olar. Domen rahat daimi ünvan və düzgün HTTPS konfiqurasiyası üçün faydalıdır.

Rus dili OCR dəstəklənirmi

Bəli. rus.traineddata faylını Tesseract qovluğuna əlavə edin və konteynerə qoşun.