لماذا تستضيف Paperless-ngx ذاتيًا على خادم VPS
الفواتير والعقود وكشوف الرواتب والمراسلات الإدارية: تتعامل إدارة المستندات مع بيانات سرّية قلّما ترغب الشركات في تسليمها إلى سحابة طرف ثالث. يستوعب Paperless-ngx كل ملف PDF أو صورة ممسوحة، ويطبّق عليه OCR (التعرّف على النص) لجعله قابلاً للبحث، ثم يصنّفه تلقائيًا حسب المُراسِل والنوع والوسوم بفضل محرّك مطابقة. على خادم VPS، تحصل على أرشيف يمكن الوصول إليه من أي مكان، يُغذّى بمجرد إسقاط الملفات في مجلد مُراقَب أو عبر البريد الإلكتروني. يعتمد المكدّس على PostgreSQL للفهرس، وRedis لطابور المهام، وخدمة معالجة تشغّل Tesseract لـOCR. وتتحكم أنت بالاحتفاظ القانوني وتشفير النسخ الاحتياطي والوصول، دون الاعتماد على مطوّر.
فوائد Paperless-ngx المُستضاف ذاتيًا
- OCR تلقائي عبر Tesseract: يصبح كل ملف ممسوح أو PDF قابلاً للبحث في نصه الكامل.
- تصنيف تلقائي حسب المُراسِل ونوع المستند والوسوم وفق قواعدك.
- مجلد مُراقَب واستيراد عبر البريد الإلكتروني: أسقِط ملفًا، فتتم معالجته وفهرسته تلقائيًا.
- بحث فوري في كل المحتوى النصّي، وليس أسماء الملفات فقط.
- الحفاظ على النسخ الأصلية سليمة إلى جانب النسخ المعالَجة بـOCR، من أجل القيمة الإثباتية.
- نسخ احتياطي مُتحكَّم به لأرشيف حسّاس قانونيًا، دون سحابة طرف ثالث.
المتطلبات العتادية والبرمجية
Paperless-ngx معقول عند الخمول، لكن OCR نهِم على دفعات: يوفّر 2 vCPU و3 إلى 4 غيغابايت من RAM راحة جيدة، إذ يُجهد OCR مستندٍ متعدد الصفحات المعالجَ مؤقتًا. وللاستيراد الأولي الكبير لعدة آلاف من المستندات، تسرّع الأنوية الإضافية المعالجة بشكل ملحوظ. خصّص تخزينًا للنسخ الأصلية إضافةً إلى ملفات الأرشيف المعالَجة بـOCR، أي نحو ضعف الحجم الخام. على الجانب البرمجي: Docker وdocker compose الإصدار v2، وPostgreSQL، وRedis، ولغات Tesseract التي تحتاجها (fra وeng وara). ونطاق (docs.yourcompany.com)، واختياريًا حساب IMAP مخصّص للاستيراد التلقائي لمرفقات البريد الإلكتروني.
نشر Paperless-ngx خطوة بخطوة
تجهيز الخادم VPS والأحجام
ثبّت Docker، ثم أنشئ المجلدات الدائمة: consume (نقطة إسقاط مُراقَبة) وmedia (الأرشيف المعالَج بـOCR) وdata وexport. سيكون مجلد consume صندوق وارد مستنداتك.
جلب ملف compose الرسمي
يوفّر المشروع سكربت تثبيت تفاعليًا، لكن في الإنتاج انطلق من ملف docker-compose.yml الرسمي الذي يعلن webserver وbroker (Redis) وdb (PostgreSQL) والعامل (worker). عدّل مسارات الأحجام لتشير إلى المجلدات التي أنشأتها.
إعداد لغات OCR والأسرار
في ملف البيئة، عيّن PAPERLESS_OCR_LANGUAGE=fra+eng+ara، وPAPERLESS_SECRET_KEY المولَّد بـopenssl rand -base64 48، والعنوان العام PAPERLESS_URL=https://docs.yourcompany.com.
إنشاء المستخدم الفائق والبدء
شغّل docker compose up -d، ثم أنشئ المسؤول بـdocker compose run --rm webserver createsuperuser. بعدها سجّل الدخول إلى الواجهة للتحقق من أن العمّال (workers) يعالجون طابور المهام بشكل صحيح.
إضافة وكيل عكسي وSSL
ضع Caddy أمام خدمة الويب لـdocs.yourcompany.com، مع شهادة Let's Encrypt تلقائية. زِد الحدّ الأقصى لحجم الرفع في الوكيل لقبول ملفات PDF الممسوحة الكبيرة دون خطأ 413.
توصيل الاستيراد عبر البريد الإلكتروني
من Administration، اضبط حساب IMAP مخصّصًا: سيجلب Paperless-ngx مرفقات الرسائل الواردة، ويعالجها بـOCR، ويصنّفها تلقائيًا وفق قواعد المطابقة لديك.
عرّف المُراسِلين وأنواع المستندات بقواعد مطابقة تلقائية (بالكلمة المفتاحية أو التعبير النمطي) منذ البداية. يتعلّم Paperless-ngx أيضًا عبر التصنيف: بعد وسم نحو خمسين مستندًا يدويًا، فعّل المصنِّف التلقائي كي يقترح وحده وسوم الملفات الجديدة. وبدمجه مع مجلد consume المُراقَب، تحصل على سلسلة تلقائية بالكامل من المسح إلى الأرشيف المفهرس.
