Language: ro

Paperless-ngx: cum să creezi propria arhivă de documente ușor de căutat

Îți amintești că un contract conținea o sumă importantă, dar fișierul se numește scan_2024_03_17.pdf și se află printre sute de fișiere similare? Un manager obișnuit de fișiere caută după numele fișierului, în timp ce cuvintele de care ai nevoie se află în scanare.

Paperless-ngx rezolvă această problemă. Încarci un PDF, o fotografie a unei chitanțe sau un atașament de e-mail, iar serviciul recunoaște textul, îl indexează și transformă fișierele împrăștiate într-o singură arhivă. Apoi poți găsi un document după nume, adresă, număr de cont sau orice expresie de pe pagină.

Ce este Paperless-ngx

Paperless-ngx este un sistem gratuit și open-source pentru gestionarea documentelor. Rulează pe propriul server, primește fișiere din surse diferite, efectuează OCR și îți permite să cauți în conținutul lor.

În locul unei structuri rigide de directoare, folosește corespondenți, tipuri de documente, etichete, date, câmpuri personalizate și reguli de stocare. Astfel poți afișa în câteva secunde facturile de electricitate din 2026, documentele pentru un anumit apartament sau garanțiile care urmează să expire.

De ce Paperless-ngx este mai bun decât directoarele obișnuite

Directoarele funcționează cât timp ai puține documente și încă îți amintești sistemul de denumire. După câțiva ani apar directoare precum Documents, Scans, New și To sort, iar găsirea fișierului potrivit devine dificilă.

Director obișnuit	Paperless-ngx
Căutare după numele fișierului	Căutare în textul documentului
Un fișier, un director	Mai multe etichete și atribute
Denumire și sortare manuală	Atribuire automată de metadate
Atașamentele trebuie salvate manual	Import din e-mail
O scanare rămâne o imagine	OCR face textul ușor de căutat

În loc să încerci să-ți amintești un director, este suficient să-ți amintești un cuvânt din document.

Cum procesează Paperless-ngx un fișier

După încărcare, serviciul:

1. salvează fișierul original;
2. extrage textul existent sau pornește OCR;
3. creează, când este necesar, o versiune PDF pentru arhivare și miniaturi;
4. adaugă conținutul într-un index de text integral;
5. aplică reguli și sugerează un corespondent, un tip, etichete și o cale de stocare.

Poți începe cu încărcarea și căutarea, apoi poți adăuga automatizări.

Cele mai utile funcții Paperless-ngx

Căutarea în scanări

După OCR, poți găsi un contract după adresă, o factură după numărul clientului și o chitanță după modelul dispozitivului. De exemplu, o căutare după „early termination” va afișa documentele care conțin expresia, chiar dacă PDF-ul original era format doar din imagini.

Calitatea depinde de scanare: o pagină dreaptă, cu contrast ridicat, este recunoscută mai bine decât o fotografie întunecată făcută din unghi. Pentru o arhivă ruso-engleză este important să instalezi ambele limbi OCR.

Sortare automată

Paperless-ngx poate compara documentele noi cu cele pe care le-ai organizat deja. Etichetezi manual mai multe facturi de la același furnizor, iar serviciul învață să sugereze același corespondent, tip și aceleași etichete pentru fișierele următoare.

Pentru o logică strictă, poți crea reguli bazate pe text, numele fișierului, sursă sau directorul de încărcare.

Import din e-mail

Serviciul poate verifica o căsuță poștală prin IMAP și poate procesa mesajele conform regulilor. De exemplu, poate prelua doar atașamentele PDF de la un furnizor, le poate trimite în arhivă, apoi poate marca mesajul ca citit sau îl poate muta în alt director.

Facturile nu se mai acumulează în inbox și devin ușor de găsit împreună cu scanările.

Fluxuri de lucru, câmpuri și vizualizări salvate

Fluxurile de lucru execută acțiuni când un document este încărcat, adăugat sau modificat, precum și conform unui program. Ele pot atribui un responsabil, pot adăuga o etichetă, pot selecta un tip și pot stabili o cale de stocare.

Câmpurile personalizate transformă arhiva într-o mică bază de date. Pentru un contract poți păstra data expirării; pentru o factură, suma și termenul de plată; iar pentru echipament, numărul de serie. Vizualizările salvate pot afișa apoi, de exemplu, documentele cu „payment required” sau „warranty expires this month”.

Scanare în loturi cu coduri de bare

Paperless-ngx poate împărți o scanare mare în mai multe documente folosind coduri de bare. Poți plasa pagini separatoare între documente sau poți atașa un cod ASN primei pagini.

ASN este un număr serial de arhivă care leagă o copie digitală de originalul pe hârtie. Este util la digitizarea unor teancuri mari.

Versiuni și AI opțional

Seria Paperless-ngx 3.x a introdus versiuni ale documentelor, seturi de linkuri pentru acces partajat și funcții AI integrate. Când conectezi un model, serviciul poate sugera metadate și poate răspunde la întrebări despre documente.

AI nu este necesar pentru funcțiile de bază: OCR, căutarea, regulile, etichetele și importul din e-mail funcționează fără el. Dacă folosești un API AI extern, o parte din text poate părăsi serverul, în timp ce un model local necesită mai multe resurse.

Pentru cine este potrivit Paperless-ngx

Pentru o arhivă personală sau de familie: contracte, polițe de asigurare, extrase, garanții, chitanțe, documente pentru locuință și manuale de echipamente.

Pentru freelanceri și firme mici: facturi, procese-verbale de predare-primire, contracte, cheltuieli și corespondență cu partenerii. Importul din e-mail reduce munca manuală, iar permisiunile de acces permit partajarea documentelor.

Pentru procese administrative: căutare rapidă în documentele sursă, selecții după furnizor și perioadă și o coadă de fișiere neprocesate.

Paperless-ngx nu înlocuiește software-ul de contabilitate, semnătura electronică sau un sistem ECM corporativ.

De ce fel de server are nevoie Paperless-ngx

Încărcarea depinde de numărul de pagini, calitatea scanării, frecvența încărcărilor și componentele suplimentare. Poți folosi următoarele valori practice de pornire:

Scenariu	CPU	RAM	Disc
Arhivă personală	2 vCPU	2 GB	30–50 GB NVMe sau mai mult
Familie sau echipă mică	2–4 vCPU	4 GB	60–100 GB NVMe sau mai mult
Loturi mari, fișiere Office, AI local	4 vCPU sau mai mult	8 GB sau mai mult	Dimensiunea arhivei plus spațiu de rezervă

Pe un server slab, interfața poate funcționa normal, dar OCR-ul documentelor mari va fi lent. Tika și Gotenberg pentru Word, Excel și alte formate Office cresc de asemenea consumul de memorie.

Planifică spațiul pe disc cu rezervă: pe lângă originale, sistemul poate păstra versiuni de arhivă, miniaturi, un index, o bază de date și fișiere temporare. Copiile de siguranță au nevoie și ele de spațiu separat.

Instalarea Paperless-ngx pe un VPS cu Docker

Cea mai simplă metodă acceptată este Docker Compose. Ai nevoie de un server Linux, Docker Engine și pluginul Compose.

Proiectul oficial oferă un instalator interactiv:

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

Acesta solicită directorul, baza de date, portul, limba OCR, componentele suplimentare și contul de administrator, apoi creează configurația Compose și pornește containerele.

Pe un server de producție este mai sigur să descarci și să verifici mai întâi scriptul:

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

Din directorul de instalare poți verifica pornirea cu aceste comenzi:

docker compose ps
docker compose logs -f webserver

Pentru OCR în rusă și engleză, de obicei setezi rus+eng și instalezi în Docker datele suplimentare de limbă rus eng.

Nu expune direct portul intern al aplicației. Conectează un domeniu printr-un reverse proxy, activează HTTPS și închide porturile inutile. Pentru o arhivă personală, accesul permis doar prin VPN este și mai sigur.

Paperless-ngx pe un VPS tropic.host

Pentru o arhivă mică este potrivit un VPS cu 2 vCPU, 2–4 GB RAM și stocare NVMe. Pe tropic.host poți instala Ubuntu și Docker și poți păstra Paperless-ngx accesibil de pe computer și telefon, fără un NAS acasă.

Un VPS rulează permanent, astfel încât serviciul poate colecta regulat atașamentele de e-mail. Totuși, documentele conțin adesea date personale: folosește HTTPS sau VPN, chei SSH, un firewall restrictiv și copii de siguranță independente.

Securitate și copii de siguranță

Paperless-ngx nu oferă criptare end-to-end integrată pentru documente. Un utilizator cu acces complet la server, volumele Docker sau o copie de siguranță ar putea citi arhiva.

Măsuri minime:

• găzduiește serviciul doar pe o infrastructură de încredere;
• actualizează sistemul și containerele;
• limitează accesul SSH la chei;
• păstrează copii criptate în afara serverului principal;
• testează periodic recuperarea.

Pentru migrare și copii de siguranță există document_exporter, inclus în sistem:

docker compose exec webserver document_exporter ../export

Copiază directorul export pe un alt dispozitiv sau într-un spațiu de stocare independent. O copie pe același VPS nu te protejează de defectarea discului, ștergerea accidentală sau pierderea accesului.

Merită instalat Paperless-ngx?

Paperless-ngx este util atunci când problema nu mai este păstrarea fișierelor, ci găsirea lor. Transformă scanările, atașamentele și PDF-urile cu nume neclare într-o arhivă în care documentele sunt găsite după conținut și procesate conform unor reguli consecvente.

Pentru început este suficient să instalezi serviciul, să configurezi limbile OCR și să încarci primele fișiere. Adaugă etichete, import din e-mail, fluxuri de lucru, coduri de bare și funcții AI când ai un proces clar și repetitiv.

FAQ

Poate fi folosit Paperless-ngx gratuit?

Da. Este un proiect open-source. Costurile apar doar pentru hardware, un VPS, un domeniu sau servicii externe.

Poate Paperless-ngx să recunoască textul rusesc?

Da. OCR folosește pachetul de limbă rus al Tesseract. Pentru o arhivă mixtă se configurează de obicei rus+eng.

Se șterge fișierul original după OCR?

Nu. Fișierul original este păstrat. În funcție de setări, lângă el poate fi creată o versiune PDF separată pentru arhivare.

Pot fi încărcate documente de pe telefon?

Da. Poți folosi interfața web, API-ul, o aplicație mobilă compatibilă sau poți redirecționa documentul către o adresă de e-mail conectată.

Este suficientă o copie de siguranță a VPS-ului?

Un snapshot VPS este util, dar este mai bine să-l combini cu exporterul integrat și să păstrezi o copie separată. Este important nu doar să creezi o arhivă, ci și să testezi recuperarea într-o instalare curată.