Tropic Host

Paperless-ngx: أرشيفك الخاص للمستندات مع OCR على خادم VPS

1 دقيقة للقراءة
Tropic
Paperless-ngx: أرشيفك الخاص للمستندات مع OCR على خادم VPS

Paperless-ngx: كيفية إنشاء أرشيف مستندات قابل للبحث

تتذكر أن عقدًا ما يتضمن مبلغًا مهمًا، لكن اسم الملف هو scan_2024_03_17.pdf وهو موجود بين مئات الملفات المشابهة. يبحث مدير الملفات العادي في أسماء الملفات، بينما توجد الكلمات التي تحتاج إليها داخل المستند الممسوح.

يحل Paperless-ngx هذه المشكلة. ترفع ملف PDF أو صورة إيصال أو مرفقًا من البريد الإلكتروني، فتتعرف الخدمة على النص وتفهرسه وتحول الملفات المبعثرة إلى أرشيف واحد. بعد ذلك يمكنك العثور على مستند باستخدام اسم العائلة أو العنوان أو رقم الحساب أو أي عبارة موجودة في الصفحة.

ما هو Paperless-ngx

Paperless-ngx نظام مجاني مفتوح المصدر لإدارة المستندات. يعمل على خادمك الخاص، ويستقبل الملفات من مصادر مختلفة، وينفذ OCR، ويتيح البحث داخل محتوى المستندات.

بدلًا من الاعتماد على هيكل مجلدات واحد وثابت، يستخدم النظام المراسلات وأنواع المستندات والوسوم والتواريخ والحقول المخصصة وقواعد التخزين. يتيح لك ذلك عرض فواتير الكهرباء لعام 2026 أو مستندات شقة معينة أو الضمانات التي يقترب موعد انتهائها خلال ثوانٍ.

لماذا Paperless-ngx أفضل من المجلدات العادية

تظل المجلدات عملية عندما يكون عدد المستندات قليلًا وتتذكر نظام التسمية الذي تستخدمه. بعد مرور عدة أعوام، تظهر مجلدات مثل Documents وScans وNew وTo sort، ويصبح العثور على الملف الصحيح أمرًا صعبًا.

المجلد العاديPaperless-ngx
البحث باسم الملفالبحث في النص داخل المستند
ملف واحد داخل مجلد واحدوسوم وسمات متعددة
التسمية والترتيب يدويًاتعيين البيانات الوصفية تلقائيًا
يجب حفظ المرفقات يدويًاالاستيراد من البريد الإلكتروني
يبقى المستند الممسوح صورةيجعل OCR النص قابلًا للبحث

بدلًا من محاولة تذكر المجلد، يكفي أن تتذكر كلمة واحدة من المستند.

كيف يعالج Paperless-ngx الملف

بعد رفع الملف، تنفذ الخدمة الخطوات التالية:

  1. حفظ الملف الأصلي؛
  2. استخراج النص الموجود أو بدء OCR؛
  3. إنشاء نسخة PDF للأرشفة وصور مصغرة عند الحاجة؛
  4. إضافة المحتوى إلى فهرس البحث الكامل؛
  5. تطبيق القواعد واقتراح المراسل والنوع والوسوم ومسار التخزين.

يمكنك البدء بالرفع والبحث فقط، ثم إضافة الأتمتة لاحقًا.

أكثر ميزات Paperless-ngx فائدة

البحث داخل المستندات الممسوحة

بعد تنفيذ OCR، يمكنك العثور على عقد باستخدام العنوان، وعلى فاتورة باستخدام رقم العميل، وعلى إيصال باستخدام طراز الجهاز. مثلًا، سيعرض البحث عن عبارة «الإنهاء المبكر» المستندات التي تحتوي على هذه العبارة حتى إذا كان ملف PDF الأصلي مكوّنًا من صور فقط.

تعتمد الجودة على حالة المسح: تُتعرّف الصفحة المستقيمة عالية التباين بصورة أفضل من صورة داكنة ملتقطة بزاوية. وفي أرشيف يجمع الروسية والإنجليزية، من المهم تثبيت لغتي OCR كلتيهما.

الترتيب التلقائي

يستطيع Paperless-ngx مطابقة المستندات الجديدة مع المستندات التي رتبتها سابقًا. تضع وسومًا يدويًا لعدة فواتير من مزود واحد، ثم تتعلم الخدمة اقتراح المراسل والنوع والوسوم نفسها للملفات التالية.

إذا كنت تحتاج إلى منطق صارم، يمكنك إنشاء قواعد تعتمد على النص أو اسم الملف أو المصدر أو مجلد الرفع.

الاستيراد من البريد الإلكتروني

يمكن للخدمة فحص صندوق بريد عبر IMAP ومعالجة الرسائل وفقًا للقواعد. مثلًا، يمكنها استلام مرفقات PDF من مورد معين فقط، وإرسالها إلى الأرشيف، ثم وضع علامة «مقروءة» على الرسالة أو نقلها إلى مجلد آخر.

لن تتراكم الفواتير في صندوق الوارد، بل ستصبح قابلة للبحث إلى جانب المستندات الممسوحة.

مسارات العمل والحقول وطرق العرض المحفوظة

تنفذ مسارات العمل إجراءات عند رفع المستند أو إضافته أو تغييره، أو وفق جدول زمني. ويمكنها تعيين مالك للمستند، وإضافة وسم، واختيار نوع، وتحديد مسار التخزين.

تحول الحقول المخصصة الأرشيف إلى قاعدة بيانات صغيرة. يمكنك تخزين تاريخ انتهاء عقد، ومبلغ فاتورة وموعد سدادها، ورقم تسلسلي لمعدة. وباستخدام طرق العرض المحفوظة، يمكنك مثلًا عرض قائمة «يتطلب الدفع» أو «ينتهي الضمان هذا الشهر».

المسح على دفعات باستخدام الرموز الشريطية

يمكن لـ Paperless-ngx تقسيم مسح كبير واحد إلى عدة مستندات باستخدام الرموز الشريطية. يمكنك وضع صفحات فاصلة بين الأوراق أو إرفاق رمز ASN بالورقة الأولى.

ASN هو رقم تسلسلي للأرشيف يربط النسخة الرقمية بالأصل الورقي. وهذا مفيد عند رقمنة رزم كبيرة من الأوراق.

الإصدارات والذكاء الاصطناعي الاختياري

قدمت سلسلة Paperless-ngx 3.x إصدارات المستندات، ومجموعات الروابط للوصول المشترك، وميزات ذكاء اصطناعي مدمجة. عند ربط نموذج، تستطيع الخدمة اقتراح البيانات الوصفية والإجابة عن أسئلة حول المستندات.

لا تحتاج الميزات الأساسية إلى الذكاء الاصطناعي: يعمل OCR والبحث والقواعد والوسوم واستيراد البريد الإلكتروني من دونه. وعند استخدام واجهة API خارجية للذكاء الاصطناعي، قد يغادر جزء من النص الخادم، بينما يحتاج النموذج المحلي إلى موارد أكبر.

لمن يناسب Paperless-ngx

للأرشيف الشخصي أو العائلي: العقود، ووثائق التأمين، وكشوف الحسابات، والضمانات، والإيصالات، ووثائق السكن، وأدلة الأجهزة.

للمستقلين والشركات الصغيرة: الفواتير، ومحاضر الاستلام، والعقود، ومصروفات العمل، والمراسلات مع الأطراف الأخرى. يقلل استيراد البريد الإلكتروني العمل اليدوي، بينما تتيح أذونات الوصول مشاركة المستندات بين المستخدمين.

للإجراءات الإدارية: البحث السريع في المستندات الأصلية، والتصفية حسب المورد والفترة، وقائمة انتظار للملفات التي لم تُعالج.

لا يحل Paperless-ngx محل برنامج المحاسبة أو التوقيع الإلكتروني أو نظام ECM المؤسسي.

ما نوع الخادم الذي يحتاج إليه Paperless-ngx

يعتمد الحمل على عدد الصفحات وجودة المسح وتكرار الرفع والمكونات الإضافية. يمكنك استخدام نقاط البداية العملية التالية:

السيناريوCPURAMالقرص
أرشيف شخصي2 vCPU2 GB‏30–50 GB NVMe أو أكثر
عائلة أو فريق صغير2–4 vCPU4 GB‏60–100 GB NVMe أو أكثر
دفعات كبيرة وملفات Office وذكاء اصطناعي محلي4 vCPU أو أكثر8 GB أو أكثرحجم الأرشيف مع سعة احتياطية

على خادم ضعيف، قد تعمل الواجهة بصورة طبيعية، بينما يكون OCR للمستندات الكبيرة بطيئًا. كما يزيد Tika وGotenberg، المستخدمان لمعالجة Word وExcel وتنسيقات Office الأخرى، استهلاك الذاكرة.

خطط لسعة القرص مع ترك مساحة احتياطية: فبالإضافة إلى الملفات الأصلية، قد يخزن النظام إصدارات الأرشفة والصور المصغرة والفهرس وقاعدة البيانات والملفات المؤقتة. وتحتاج النسخ الاحتياطية إلى مساحة منفصلة أيضًا.

تثبيت Paperless-ngx على خادم VPS باستخدام Docker

أبسط طريقة مدعومة هي Docker Compose. تحتاج إلى خادم Linux وDocker Engine وإضافة Compose.

يوفر المشروع الرسمي برنامج تثبيت تفاعليًا:

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

يسألك عن المجلد وقاعدة البيانات والمنفذ ولغة OCR والمكونات الإضافية وحساب المسؤول، ثم ينشئ إعداد Compose ويشغل الحاويات.

على خادم إنتاج، من الأكثر أمانًا تنزيل البرنامج النصي وفحصه أولًا:

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

من مجلد التثبيت، يمكنك التحقق من بدء التشغيل باستخدام الأوامر التالية:

docker compose ps
docker compose logs -f webserver

بالنسبة إلى OCR بالروسية والإنجليزية، تضبط عادةً rus+eng وتثبت بيانات اللغتين الإضافيتين rus eng داخل Docker.

لا تعرض المنفذ الداخلي للتطبيق مباشرة على الإنترنت. اربط نطاقًا عبر وكيل عكسي، وفعل HTTPS، وأغلق المنافذ غير الضرورية. وللأرشيف الشخصي، يكون السماح بالوصول عبر VPN فقط أكثر أمانًا.

تشغيل Paperless-ngx على VPS من tropic.host

يناسب الأرشيف الصغير خادم VPS بمواصفات 2 vCPU وذاكرة RAM بسعة 2–4 GB وتخزين NVMe. على tropic.host، يمكنك نشر Ubuntu وتثبيت Docker وإتاحة Paperless-ngx من الكمبيوتر والهاتف دون الحاجة إلى تشغيل NAS في المنزل.

يعمل خادم VPS على مدار الساعة، لذلك تستطيع الخدمة جمع مرفقات البريد الإلكتروني بانتظام. لكن المستندات تحتوي غالبًا على بيانات شخصية؛ استخدم HTTPS أو VPN ومفاتيح SSH وجدار حماية مقيدًا ونسخًا احتياطية مستقلة.

الأمان والنسخ الاحتياطية

لا يوفر Paperless-ngx تشفيرًا مدمجًا من طرف إلى طرف للمستندات. وقد يتمكن مستخدم لديه وصول كامل إلى الخادم أو وحدات Docker أو نسخة احتياطية من قراءة الأرشيف.

الحد الأدنى من الإجراءات:

  • استضافة الخدمة على بنية تحتية موثوقة فقط؛
  • تحديث النظام والحاويات؛
  • تقييد وصول SSH بالمفاتيح؛
  • تخزين نسخ مشفرة خارج الخادم الرئيسي؛
  • اختبار الاستعادة دوريًا.

للهجرة والنسخ الاحتياطي، توجد أداة document_exporter مدمجة:

docker compose exec webserver document_exporter ../export

انسخ مجلد التصدير إلى جهاز آخر أو مساحة تخزين مستقلة. فالنسخة الموجودة على خادم VPS نفسه لا تحمي من تلف القرص أو الحذف العرضي أو فقدان الوصول.

هل يستحق Paperless-ngx التثبيت؟

يصبح Paperless-ngx مفيدًا عندما لا تعود المشكلة هي تخزين الملفات، بل العثور عليها. فهو يحول المستندات الممسوحة والمرفقات وملفات PDF ذات الأسماء غير الواضحة إلى أرشيف يمكن فيه العثور على المستندات من خلال محتواها ومعالجتها وفق قواعد ثابتة.

للبدء، يكفي تثبيت الخدمة وضبط لغات OCR ورفع الملفات الأولى. أضف الوسوم واستيراد البريد ومسارات العمل والرموز الشريطية وميزات الذكاء الاصطناعي عندما تتشكل لديك عملية واضحة ومتكررة.

الأسئلة الشائعة

هل يمكن استخدام Paperless-ngx مجانًا؟

نعم. إنه مشروع مفتوح المصدر. وتظهر التكاليف فقط مقابل العتاد أو خادم VPS أو النطاق أو الخدمات الخارجية.

هل يستطيع Paperless-ngx التعرف على النص الروسي؟

نعم. يستخدم OCR حزمة اللغة rus الخاصة بـ Tesseract. وبالنسبة إلى الأرشيف المختلط، يضبط عادةً rus+eng.

هل يُحذف الملف الأصلي بعد تنفيذ OCR؟

لا. يُحافظ على الملف الأصلي. وبحسب الإعدادات، قد تُنشأ نسخة PDF منفصلة للأرشفة إلى جانبه.

هل يمكن رفع المستندات من الهاتف؟

نعم. يمكنك استخدام واجهة الويب أو API أو تطبيق هاتف متوافقًا أو إعادة توجيه المستند إلى عنوان بريد إلكتروني متصل.

هل تكفي نسخة احتياطية على VPS؟

تُعد لقطة VPS مفيدة، لكن من الأفضل دمجها مع أداة التصدير المدمجة وتخزين نسخة منفصلة. لا يكفي إنشاء أرشيف؛ من المهم أيضًا اختبار استعادته على تثبيت نظيف.