هذا الدليل الصادر في ديسمبر 2025 هو أحد أكثر الأدلة المجتمعية تفصيلًا لتشغيل Paperless-ngx على ZimaOS، لكنه مرتبط بحزمة BigBear محددة وبنظام ZimaOS 1.5.3 Plus. أما الجوانب المستدامة فهي مفاهيم التخزين والإعداد: امنح مجلد الاستهلاك موقعًا دائمًا وواضحًا، واضبط عنوان URL للتطبيق بشكل صحيح، وتهيئة لغات OCR، وفهم الخدمات الاختيارية لـ Tika/Gotenberg.
تحتاج بعض تفاصيل المصدر إلى تحديد زمني حالي. فقد تطور إعداد Docker الخاص بـ Paperless-ngx من المصدر، وأصبح PostgreSQL موصى به الآن للتثبيتات الجديدة، وتطلب ملفات Compose الحالية إنشاء مستخدم متميز أثناء الإعداد الأول، بينما تظل Tika/Gotenberg اختيارية وليست إلزامية لكل سير عمل للمستندات.
اختُبر الدليل المصدر على ZimaBoard 2 متواضع الإمكانات
وثّق المؤلف نظامًا قائمًا على N150 بذاكرة وصول عشوائي (RAM) سعتها 16 جيجابايت ويعمل بنظام ZimaOS 1.5.3 Plus. وكان الهدف هو الوصول عبر الشبكة المحلية أو Tailscale للاستخدام المنزلي، وليس التعريض المباشر للعامة.
هذا النطاق مهم لأن النشر على الإنترنت العام يحتاج إلى خطة مختلفة لـ HTTPS والوكيل العكسي والمصادقة والأمان.
استخدم الدليل التثبيت المخصص لـ BigBear Paperless-ngx
بحث سير العمل المصدر عن حزمة BigBear Paperless-ngx في متجر التطبيقات، ثم فتح قائمة التثبيت المنسدلة واختيار التثبيت المخصص حتى يمكن تعديل وحدات التخزين وقيم البيئة قبل التشغيل الأول.
هذا سير عمل خاص بالحزمة. ويمكن لتعريف التطبيق الحالي إضافة الخدمات والمتغيرات أو إزالتها أو إعادة تسميتها.
امنح مجلد الاستهلاك مسار مضيف دائمًا وواضحًا
/usr/src/paperless/consume باعتباره المجلد الذي يُرجح أن يتفاعل معه المستخدمون عند إسقاط المستندات فيه.لا تزال وثائق Paperless الحالية من المصدر تستخدم /usr/src/paperless/consume باعتباره وجهة الحاوية القياسية، وتدعم صراحةً تغيير جانب المضيف من نقطة الربط هذه.
ضبطت المجموعة متغيرات المشرف والمستهلك وOCR وعنوان URL
شملت خيارات المصدر الرئيسية ما يلي:
- اسم مستخدم/كلمة مرور مخصصان للمشرف؛
- الاستهلاك التكراري للمستندات؛
- حذف الملفات الأصلية من مجلد الاستهلاك بعد نجاح الإدخال؛
- تنظيف OCR وإعدادات اللغة؛
- المصدر الموثوق لـ CSRF وعنوان URL للتطبيق؛
- نقاط نهاية Tika/Gotenberg.
يجب أن يتطابق PAPERLESS_URL وCSRF Origins مع طريقة وصولك الفعلية إلى Paperless
حذّر البرنامج التعليمي من أن الإعداد غير الصحيح لعنوان URL/المصدر قد يؤدي إلى فشل التحقق من CSRF برمز الحالة 403. ولا يزال ذلك صحيحًا من الناحية المفاهيمية.
توضح وثائق Paperless الحالية PAPERLESS_URL يجب ضبطه عندما يكون التطبيق خلف وكيل عكسي، ويجب أن يمثل النطاق/عنوان URL المستخدم خارجيًا. لا تضع عنوان LAN الخاص بكاتب المصدر بشكل ثابت في تثبيت آخر.
تم أيضًا تعديل إعدادات OCR داخل Paperless
يجب أن تتوافق لغات OCR مع حزم اللغات المتاحة في الحاوية. وقد تؤدي إضافة اللغات إلى زيادة حجم الصورة أو تغيير متطلبات الحاويات عديمة الجذر، بحسب الحزمة الحالية.
إعادة التشغيل بعد كل دفعة استهلاك كبيرة هي نصيحة المصدر وليست متطلبًا من المنبع
صُمم Paperless-ngx الحالي لمراقبة دليل الاستهلاك باستمرار. ولا تذكر وثائق المنبع أن الدُفعات الكبيرة تتطلب عادةً إعادة التشغيل. إذا توقفت معالجة المستندات، فتحقق من الأذونات وسجلات المستهلك ودعم إشعارات نظام الملفات وحالة الوسيط/العامل، بدلًا من جعل إعادة التشغيل إجراءً إلزاميًا.
الإعداد الحالي من المنبع يوصي باستخدام PostgreSQL للتثبيتات الجديدة
يوصي إعداد Docker الحالي لـ Paperless-ngx باستخدام PostgreSQL للتثبيتات الجديدة، مع بقاء SQLite وMariaDB متاحين في الإعدادات المدعومة.
بالنسبة إلى أرشيف مستندات طويل الأمد، يجعل ذلك بنية Compose الحالية من المنبع مرجعًا أفضل من افتراض بقاء خدمة قاعدة بيانات BigBear لعام 2025 دون تغيير.
Tika وGotenberg اختياريان
توضح وثائق Paperless الحالية أن Tika وGotenberg مطلوبان لتحليل مستندات Office مثل DOC/XLSX/ODT وملفات البريد الإلكتروني. وإذا كنت تستوعب تنسيقات يتعامل معها نظام Paperless الأساسي فقط، فيمكن إبقاء الميزة معطلة.
استخدم إعداد Paperless-ngx الحالي باستخدام Docker قبل إعادة إنشاء حزمة BigBear التاريخية يدويًا.
أذونات مجلد الاستهلاك أهم من عمليات إعادة التشغيل المتكررة
يعرض الإعداد الحالي من المنبع USERMAP_UID و USERMAP_GID حتى يتمكن الحاوي من الكتابة إلى نقاط الربط على المضيف. إذا رأى Paperless مجلد consume لكنه لم يتمكن من معالجة الملفات أو حذفها، فتحقّق من ملكية الدليل المعيّن وهوية الحاوي.
على ZimaOS، تحقّق أيضًا من أن مسار consume على المضيف موجود في وحدة التخزين المُدارة المقصودة، وليس ضمن تعيين لوحدة تخزين للقراءة فقط.
حذف الملفات الأصلية من /consume لا يساوي حذف المستندات المؤرشفة
فعّل المصدر PAPERLESS_CONSUMER_DELETE_ORIGINALS=true. يتحكم هذا في ما يحدث لملف الإدخال في دليل consume بعد نجاح الاستيعاب. أما المستند المؤرشف الذي يديره Paperless فيظل في مساحة تخزين الوسائط الخاصة به.
اختبر هذا السلوك باستخدام مستندات يمكن التخلص منها قبل توجيه ماسح آلي أو خدمة مزامنة إلى مجلد إنتاج.
ردود Paperless-AI تخص تكاملًا منفصلًا
ناقشت الردود اللاحقة قراءة Paperless-AI للمستندات عبر واجهة Paperless API، مع فشله في تحليل الوسوم وكتابتها باستخدام إعداد OpenAI المدمج. وأفاد المستخدمون بأن Mistral يعمل، وأن الإعداد اليدوي لـ OpenAI يتجاوز المشكلة.
لا تثبت هذه الردود أن تثبيت Paperless-ngx الأساسي معطّل. فـ Paperless-AI تكامل منفصل من جهة خارجية، وله إعدادات مزود وخدمة API خاصة به.
لم تُحسم أخطاء 500 اللاحقة وأسئلة كلمات المرور في سلسلة النقاش
أفاد مستخدم في فبراير 2026 بحدوث خطأ HTTP 500 أثناء الرفع، كما لم يتمكن مستخدم آخر في مايو 2026 من تشغيل كلمات المرور المتوقعة. ولا تتضمن سلسلة النقاش العامة تشخيصًا نهائيًا لهاتين الحالتين.
لا تحوّل بيانات الاعتماد النموذجية في البرنامج التعليمي الأصلي إلى وصفة تسجيل دخول عامة للإصدارات اللاحقة من BigBear.
تصدير بيانات Paperless قبل إجراء تغييرات جوهرية على الحزمة
يوفر Paperless حاليًا أداة لتصدير المستندات تتضمن المستندات والصور المصغرة والبيانات الوصفية والمعلومات المستمدة من قاعدة البيانات، وذلك لسير عمل الترحيل والنسخ الاحتياطي. استخدم التصدير المدرك للتطبيق، إلى جانب النسخ الاحتياطية المعتادة للتخزين، قبل استبدال قاعدة البيانات أو حزمة Compose.
الأسئلة الشائعة حول Paperless-ngx على ZimaOS
هل يُعد Tika مطلوبًا لكل عملية تثبيت لـ Paperless-ngx؟
لا. هذا اختياري، ويُحتاج إليه أساسًا لمستندات Office وتحليل البريد الإلكتروني.
هل تتطلب دفعات المعالجة الكبيرة عادةً إعادة التشغيل؟
أوصى بها كاتب المصدر بناءً على تجربته، لكن وثائق المشروع الأصلية الحالية لا تعتبر إعادة التشغيل متطلبًا اعتياديًا.
ما قاعدة البيانات التي يوصي بها Paperless حاليًا للتثبيتات الجديدة؟
تُعد PostgreSQL قاعدة البيانات الخلفية الموصى بها لعمليات النشر الجديدة باستخدام Docker.
هل يُعد Paperless-AI جزءًا من Paperless-ngx نفسه؟
لا. إنه تكامل منفصل من جهة خارجية نوقش لاحقًا في سلسلة النقاش.
