Paperless-ngx: kendi aranabilir belge arşivinizi kurma

Bir sözleşmede önemli bir tutar olduğunu hatırlıyorsunuz, ancak dosyanın adı scan_2024_03_17.pdf ve yüzlerce benzer dosyanın arasında duruyor. Normal bir dosya yöneticisi dosya adına göre arama yapar; oysa aradığınız kelimeler taramanın içindedir.

Paperless-ngx bu sorunu çözer. Bir PDF, makbuz fotoğrafı veya e-posta eki yüklediğinizde hizmet metni tanır, indeksler ve dağınık dosyaları tek bir arşive dönüştürür. Bundan sonra bir belgeyi soyadına, adrese, hesap numarasına veya sayfadaki herhangi bir ifadeye göre bulabilirsiniz.

Paperless-ngx nedir?

Paperless-ngx ücretsiz ve açık kaynaklı bir belge yönetim sistemidir. Kendi sunucunuzda çalışır, farklı kaynaklardan dosya kabul eder, OCR uygular ve içeriklerinde arama yapmanızı sağlar.

Tek bir katı klasör yapısı yerine muhatapları, belge türlerini, etiketleri, tarihleri, özel alanları ve depolama kurallarını kullanır. Böylece 2026 elektrik faturalarını, belirli bir daireye ait belgeleri veya süresi dolmak üzere olan garantileri saniyeler içinde gösterebilirsiniz.

Paperless-ngx neden normal klasörlerden daha iyi?

Belge sayısı azken ve adlandırma sisteminizi hatırlıyorken klasörler işe yarar. Birkaç yıl sonra Documents, Scans, New ve To sort gibi dizinler oluşur ve doğru dosyayı bulmak zorlaşır.

Normal klasör	Paperless-ngx
Dosya adına göre arama	Belgenin içindeki metinde arama
Bir dosya, bir klasör	Birden çok etiket ve özellik
Manuel adlandırma ve sıralama	Otomatik meta veri atama
Ekler elle kaydedilmelidir	E-postadan içe aktarma
Tarama bir görsel olarak kalır	OCR metni aranabilir yapar

Bir dizini hatırlamaya çalışmak yerine belgeden tek bir kelimeyi hatırlamanız yeterlidir.

Paperless-ngx bir dosyayı nasıl işler?

Yüklemeden sonra hizmet:

1. orijinal dosyayı kaydeder;
2. mevcut metni çıkarır veya OCR'ı başlatır;
3. gerektiğinde arşiv PDF sürümü ve küçük resimler oluşturur;
4. içeriği tam metin dizinine ekler;
5. kuralları uygular ve muhatap, tür, etiket ve depolama yolu önerir.

Önce yükleme ve arama ile başlayabilir, daha sonra otomasyon ekleyebilirsiniz.

En kullanışlı Paperless-ngx özellikleri

Taramaların içinde arama

OCR'dan sonra bir sözleşmeyi adrese, faturayı müşteri numarasına, makbuzu cihaz modeline göre bulabilirsiniz. Örneğin “early termination” araması, orijinal PDF yalnızca görsellerden oluşsa bile bu ifadeyi içeren belgeleri gösterir.

Kalite taramaya bağlıdır: düz ve yüksek kontrastlı bir sayfa, açılı çekilmiş karanlık bir fotoğraftan daha iyi tanınır. Rusça-İngilizce bir arşiv için her iki OCR dilini de kurmak önemlidir.

Otomatik sıralama

Paperless-ngx yeni belgeleri daha önce düzenlediğiniz belgelerle eşleştirebilir. Bir sağlayıcıdan gelen birkaç faturayı elle etiketlediğinizde, hizmet sonraki dosyalar için aynı muhatabı, türü ve etiketleri önermeyi öğrenir.

Kesin mantık için metne, dosya adına, kaynağa veya yükleme klasörüne dayalı kurallar oluşturabilirsiniz.

E-postadan içe aktarma

Hizmet bir posta kutusunu IMAP üzerinden kontrol edip iletileri kurallara göre işleyebilir. Örneğin bir tedarikçiden yalnızca PDF eklerini alıp arşive gönderebilir, ardından e-postayı okundu olarak işaretleyebilir veya başka bir klasöre taşıyabilirsiniz.

Faturalar gelen kutusunda birikmek yerine taramalarla birlikte aranabilir hâle gelir.

İş akışları, alanlar ve kayıtlı görünümler

İş akışları bir belge yüklendiğinde, eklendiğinde, değiştirildiğinde veya belirli bir zamanlamaya göre işlemler gerçekleştirir. Sahip atayabilir, etiket ekleyebilir, tür seçebilir ve depolama yolu belirleyebilirler.

Özel alanlar arşivi küçük bir veritabanına dönüştürür. Bir sözleşmeye son kullanma tarihi, faturaya tutar ve ödeme son tarihi, ekipmana seri numarası ekleyebilirsiniz. Kayıtlı görünümler daha sonra “ödeme gerekli” veya “garanti bu ay bitiyor” gibi belgeleri gösterebilir.

Barkodlarla toplu tarama

Paperless-ngx barkodları kullanarak tek bir büyük taramayı birkaç belgeye bölebilir. Kâğıtların arasına ayırıcı sayfalar koyabilir veya ilk sayfaya bir ASN kodu ekleyebilirsiniz.

ASN, dijital kopyayı kâğıt orijinaliyle ilişkilendiren arşiv seri numarasıdır. Büyük yığınları dijitalleştirirken kullanışlıdır.

Sürümler ve isteğe bağlı yapay zekâ

Paperless-ngx 3.x serisi belge sürümlerini, paylaşılan erişim için bağlantı kümelerini ve yerleşik yapay zekâ özelliklerini tanıttı. Bir model bağlandığında hizmet meta veri önerebilir ve belgeler hakkında soruları yanıtlayabilir.

Temel özellikler için yapay zekâ gerekmez: OCR, arama, kurallar, etiketler ve e-posta içe aktarma onsuz çalışır. Harici bir yapay zekâ API'si kullandığınızda bazı metinler sunucudan çıkabilir; yerel model ise daha fazla kaynak ister.

Paperless-ngx kimler için uygundur?

Kişisel veya aile arşivi için: sözleşmeler, sigorta poliçeleri, ekstreler, garantiler, makbuzlar, konut belgeleri ve ekipman kılavuzları.

Freelancer'lar ve küçük işletmeler için: faturalar, kabul tutanakları, sözleşmeler, giderler ve iş ortaklarıyla yazışmalar. E-posta içe aktarma manuel işi azaltır, erişim izinleri ise belgeleri paylaşmanızı sağlar.

İdari süreçler için: kaynak belgelerde hızlı arama, tedarikçi ve döneme göre seçimler ve işlenmemiş dosya kuyruğu.

Paperless-ngx muhasebe yazılımının, elektronik imzanın veya kurumsal bir ECM sisteminin yerini tutmaz.

Paperless-ngx ne tür bir sunucu ister?

Yük; sayfa sayısına, tarama kalitesine, yükleme sıklığına ve ek bileşenlere bağlıdır. Başlangıç için şu pratik değerleri kullanabilirsiniz:

Senaryo	CPU	RAM	Disk
Kişisel arşiv	2 vCPU	2 GB	30–50 GB NVMe veya daha fazlası
Aile veya küçük ekip	2–4 vCPU	4 GB	60–100 GB NVMe veya daha fazlası
Büyük gruplar, Office dosyaları, yerel yapay zekâ	4 vCPU veya daha fazlası	8 GB veya daha fazlası	Arşiv boyutu ve boş kapasite

Zayıf bir sunucuda arayüz normal çalışabilir, ancak büyük belgelerin OCR işlemi yavaş olur. Word, Excel ve diğer ofis biçimleri için Tika ve Gotenberg de bellek kullanımını artırır.

Disk kapasitesini pay bırakarak planlayın: orijinallerin yanında sistem arşiv sürümlerini, küçük resimleri, dizini, veritabanını ve geçici dosyaları da saklayabilir. Yedekler için de ayrı alan gerekir.

Docker ile VPS'e Paperless-ngx kurulumu

Desteklenen en basit yöntem Docker Compose'dur. Bir Linux sunucusuna, Docker Engine'e ve Compose plugin'ine ihtiyacınız vardır.

Resmî proje etkileşimli bir yükleyici sunar:

bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"

Yükleyici dizini, veritabanını, portu, OCR dilini, ek bileşenleri ve yönetici hesabını sorar; ardından Compose yapılandırması oluşturup container'ları başlatır.

Production sunucusunda önce script'i indirip incelemek daha güvenlidir:

curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh \
  -o install-paperless-ngx.sh
less install-paperless-ngx.sh
bash install-paperless-ngx.sh

Kurulum dizininden başlatmayı şu komutlarla kontrol edebilirsiniz:

docker compose ps
docker compose logs -f webserver

Rusça ve İngilizce OCR için genellikle rus+eng ayarlanır ve Docker'a ek rus eng dil verileri kurulur.

Uygulamanın dahili portunu doğrudan expose etmeyin. Reverse proxy üzerinden domain bağlayın, HTTPS'i etkinleştirin ve gereksiz portları kapatın. Kişisel bir arşiv için erişimi yalnızca VPN üzerinden vermek daha da güvenlidir.

tropic.host VPS'inde Paperless-ngx

Küçük bir arşiv için 2 vCPU, 2–4 GB RAM ve NVMe depolamalı bir VPS uygundur. tropic.host üzerinde Ubuntu kurup Docker yükleyerek Paperless-ngx'i evde NAS olmadan bilgisayar ve telefondan erişilebilir tutabilirsiniz.

VPS günün her saati çalışır; bu nedenle hizmet e-posta eklerini düzenli olarak toplayabilir. Ancak belgeler genellikle kişisel veri içerir: HTTPS veya VPN, SSH anahtarları, kısıtlayıcı bir firewall ve bağımsız yedekler kullanın.

Güvenlik ve yedekler

Paperless-ngx belgeler için yerleşik uçtan uca şifreleme sunmaz. Sunucuya, Docker volume'lerine veya bir yedeğe tam erişimi olan kullanıcı arşivi okuyabilir.

Minimum önlemler:

• hizmeti yalnızca güvenilir altyapıda barındırın;
• sistemi ve container'ları güncelleyin;
• SSH erişimini anahtarlarla sınırlandırın;
• ana sunucunun dışında şifreli kopyalar tutun;
• kurtarmayı düzenli olarak test edin.

Taşıma ve yedekleme için yerleşik document_exporter kullanılabilir:

docker compose exec webserver document_exporter ../export

Export dizinini başka bir cihaza veya bağımsız depolamaya kopyalayın. Aynı VPS'teki bir kopya disk hasarına, yanlışlıkla silmeye veya erişim kaybına karşı koruma sağlamaz.

Paperless-ngx kurulmaya değer mi?

Sorun artık dosyaları saklamak değil, onları bulmak olduğunda Paperless-ngx kullanışlıdır. Adları belirsiz taramaları, ekleri ve PDF'leri; belgelerin içeriklerine göre bulunduğu ve tutarlı kurallarla işlendiği bir arşive dönüştürür.

Başlamak için hizmeti kurmanız, OCR dillerini yapılandırmanız ve ilk dosyaları yüklemeniz yeterlidir. Açık ve tekrarlanan bir süreciniz varsa etiketleri, e-posta içe aktarmayı, iş akışlarını, barkodları ve yapay zekâ özelliklerini ekleyin.

SSS

Paperless-ngx ücretsiz kullanılabilir mi?

Evet. Açık kaynaklı bir projedir. Yalnızca donanım, VPS, alan adı veya harici hizmetler için maliyet oluşur.

Paperless-ngx Rusça metni tanıyabilir mi?

Evet. OCR, Tesseract'ın rus dil paketini kullanır. Karma bir arşiv için genellikle rus+eng yapılandırılır.

OCR'dan sonra orijinal dosya silinir mi?

Hayır. Orijinal dosya korunur. Ayarlara bağlı olarak yanında ayrı bir arşiv PDF sürümü oluşturulabilir.

Belgeler telefondan yüklenebilir mi?

Evet. Web arayüzünü, API'yi, uyumlu bir mobil uygulamayı kullanabilir veya belgeyi bağlı bir e-posta adresine yönlendirebilirsiniz.

VPS yedeği yeterli mi?

VPS snapshot'ı yararlıdır, ancak yerleşik exporter ile birlikte kullanılmalı ve ayrı bir kopya saklanmalıdır. Yalnızca arşiv oluşturmak değil, temiz bir kurulumda kurtarmayı test etmek de önemlidir.