🤖 تثبيت Paperless-AI — الأتمتة والفرز الذكي للمستندات بالذكاء الاصطناعي على Docker
نشر أداة Paperless-AI على Ubuntu باستخدام Docker — المساعد الذكي لنظام Paperless-ngx الذي يعتمد على نماذج Ollama أو OpenAI لتصنيف وفهرسة وتلخيص المستندات الممسوحة ضوئياً آلياً.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/paperless-ai/paperless-ai-ubuntu.sh
chmod +x paperless-ai-ubuntu.sh
sudo bash paperless-ai-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/paperless-ai/paperless-ai-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x paperless-ai-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للإعدادات (`./data`) وتشغيل حاوية Paperless-AI الرسمية على المنفذ 3055.
sudo bash paperless-ai-ubuntu.sh
4 ضبط الاتصال بالواجهات البرمجية
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:3055. اربط عنوان خادم Paperless-ngx ومفتاح API، وحدد نموذج الذكاء الاصطناعي (Ollama أو OpenAI)، وابدأ المعالجة التلقائية.
http://<your-server-ip>:3055
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3055 | Web UI (host → container 3000) — connect Paperless-ngx + LLM in setup |
| requires | An existing Paperless-ngx instance and an LLM (Ollama or OpenAI) |
| ./data | Configuration and processing state |
نظرة عامة
تعد Paperless-AI خدمة مصغرة مفتوحة المصدر مصممة لتعزيز نظام أرشفة المستندات Paperless-ngx بقدرات نماذج الذكاء الاصطناعي اللغوية الكبيرة (LLMs). تعمل الخدمة على المنفذ 3055، وتراقب المستندات الجديدة الممسوحة ضوئياً في Paperless-ngx، وتقوم بإرسال نصوص الـ OCR إلى النماذج المحلية (عبر Ollama) أو السحابية (مثل OpenAI وClaude) لاستخراج التواريخ الذاتية، وتحديد الجهة المصدرة (المراسل)، وتوليد وسوم ذكية وتلخيص محتوى الملفات بدقة بشرية فائقة وبشكل آلي بالكامل.
لماذا تستخدمه
يعتمد التصنيف التقليدي في Paperless-ngx على خوارزميات تطابق بسيطة ونماذج تعلم آلي تحتاج لتدريب يدوي على مئات المستندات لتصبح دقيقة. يحل Paperless-AI هذه المشكلة بالاستفادة من قدرات الفهم الدلالي للنماذج اللغوية الحديثة (مثل Llama 3 أو GPT-4o) لفهم فواتير الكهرباء، والعقود القانونية، والتقارير الطبية فورياً وتصنيفها وتلخيصها بدقة مذهلة دون الحاجة لأي تصنيف يدوي متعب.
متى تحتاجه
- تستخدم Paperless-ngx وتريد أتمتة تصنيف وتسمية وتوسيم الفواتير والمستندات الممسوحة ضوئياً دون تدخل يدوي
- ترغب في توليد ملخصات نصية موجزة بالذكاء الاصطناعي للعقود الطويلة والوثائق القانونية وبوالص التأمين
- تريد استخدام نماذج ذكاء اصطناعي محلية تماماً (عبر Ollama) لمعالجة المستندات السرية والمالية دون تسريبها للسحابة
- تريد التخلص من عبء تدريب خوارزميات التصنيف التقليدية على مئات النماذج يدوياً
- تبحث عن لوحة تحكم مخصصة لمراجعة واعتماد التعديلات المقترحة من الذكاء الاصطناعي قبل حفظها في الأرشيف
من يحتاجه
- أصحاب المنازل والمكاتب الرقمية (Homelab) لأرشفة الفواتير الضريبية والإيصالات والتقارير الطبية آلياً
- الشركات الصغيرة ومكاتب المحاماة والمحاسبة لتنظيم عقود العملاء والفواتير بدقة وسرعة
- مديرو الأنظمة المشرفون على خوادم أرشفة المستندات الورقية للمؤسسات والشركات
- المستخدمون الحريصون على الخصوصية الراغبون في تشغيل الذكاء الاصطناعي محلياً 100% بدون إنترنت
- المطورون الباحثون عن دمج تقنيات النماذج اللغوية (LLMs) في أنظمة إدارة الوثائق الرقمية
حالات الاستخدام الشائعة
- استخراج تواريخ الفواتير الدقيقة وتاريخ الاستحقاق واسم الشركة المصدرة للفاتورة تلقائياً من الملفات الممسوحة
- توليد ملخص تنفيذي بالنقاط الرئيسية للشروط والبنود القانونية في خانة الملاحظات داخل Paperless-ngx
- تصنيف المستندات آلياً حسب نوعها (مثل: 'فاتورة'، 'عقد إيجار'، 'تقرير طبي'، 'مستند بنكي')
- إعادة تسمية الملفات بصيغة معيارية منظمة (مثل: `2024-03-15 - Vodafone - فاتورة إنترنت.pdf`) تلقائياً
- معالجة أرشيف المستندات القديمة دفعة واحدة لتصنيف وتوسيم آلاف الملفات المكدسة بدون وسوم
الميزات الرئيسية
- تكامل مباشر وسلس مع واجهات Paperless-ngx REST API عبر خطافات الويب (Webhooks) أو الفحص الدوري
- دعم محركات ذكاء اصطناعي متعددة: نماذج Ollama المحلية، واجهات OpenAI، ومحركات Groq وAnthropic
- استخراج ذكي وشامل للبيانات الوصفية: المراسل، تاريخ المستند، الوسوم المقترحة، ونوع المستند
- تلخيص آلي للنصوص الطويلة وحقن الملخص مباشرة في حقل الملاحظات المدمج في Paperless-ngx
- واجهة ويب عصرية وخفيفة على المنفذ 3055 لمتابعة حالة العمليات وإعادة معالجة المستندات يدوياً
- قوالب أوامر قابلة للتخصيص الكامل (System Prompts) لفرض القوانين الخاصة بتسمية وتصنيف ملفاتك
- نشر منظم في حاوية موحدة عبر Docker مع ربط مجلد `./data` لحفظ الإعدادات وسجلات المعالجة
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3055 للوصول للوحة تحكم Paperless-AI
- ولد رمز وصول برمجياً (API Token) داخل سيرفر Paperless-ngx من قسم ملفي الشخصي ← API Tokens
- في إعدادات Paperless-AI، أدخل رابط خادم Paperless-ngx (مثل `http://ip-سيرفرك:8000`) والصق رمز API
- اضبط مزود الذكاء الاصطناعي: اختر 'Ollama' (مثل `http://host.docker.internal:11434` ونموذج `llama3:8b`) أو أدخل مفتاح OpenAI
- خصص قواعد التوجيه (Prompts) لتحديد شكل التسميات والتصنيفات المطلوبة لملفاتك
- ارفع مستند PDF جديد إلى Paperless-ngx لاختبار التصنيف والتوسيم والتلخيص التلقائي بالذكاء الاصطناعي
- ضع Paperless-AI خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) لتأمين الاتصال بالسيرفر
أفضل ممارسات الأمان
- عند معالجة المستندات الضريبية أو الطبية الحساسة، استخدم نموذج Ollama محلي لضمان بقاء كافة البيانات داخل سيرفرك بنسبة 100%
- في حال استخدام خدمات الذكاء الاصطناعي السحابية الخارجية (مثل OpenAI)، احفظ مفاتيح APIs بأمان في إعدادات المشرف
- لا تفتح المنفذ 3055 للإنترنت العام مباشرة؛ واقصر الوصول على شبكتك المحلية وشبكة VPN المشفرة
- عامل رمز الوصول البرمجي الخاص بـ Paperless-ngx بسرية تامة ككلمة مرور المشرف
- احمِ مجلد البيانات `./data` بصلاحيات مناسبة على السيرفر
- حدّث حاوية clusterzx/paperless-ai دورياً للحصول على الميزات الجديدة وإصلاحات الأخطاء
المنافذ وإعدادات جدار الحماية
يستمع Paperless-AI على منفذ TCP 3055 (المحول من 3000 الداخلي) لواجهة الويب وقنوات استقبال خطافات الويب. يجب السماح بهذا المنفذ على شبكتك المحلية عبر جدار الحماية (ufw allow 3055/tcp). وتأكد من قدرة الحاوية على الاتصال بسيرفر Paperless-ngx (منفذ 8000 عادة) ومحرك Ollama (منفذ 11434).
النسخ الاحتياطي والصيانة
- انسخ مجلد `./data` (/app/data) احتياطياً، والذي يحتوي على إعدادات الربط وقوالب الأوامر وسجل العمليات
- احتفظ بنسخة من متغيرات البيئة ومفاتيح APIs ورموز الربط
- أتمت النسخ الاحتياطي اليومي للمجلد وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية والتأكد من استرجاع إعدادات الربط بنجاح
الأخطاء الشائعة
- كتابة رابط اتصال Ollama كـ `http://localhost:11434` داخل الحاوية بدلاً من `http://host.docker.internal:11434`
- استخدام نماذج ذكاء اصطناعي ضعيفة وصغيرة جداً (أقل من 3B) مما يسبب تواريخ وهمية أو مخرجات JSON غير صالحة
- نسيان توليد رمز API Token في Paperless-ngx قبل بدء عملية الإعداد والربط
- عدم ربط مجلد التخزين الدائم `./data`، مما يسبب فقدان قوالب الأوامر وإعدادات الربط عند تحديث الحاوية
- تشغيل الأداة قبل اكتمال استخراج النصوص (OCR) من المستند داخل Paperless-ngx
استكشاف الأخطاء وإصلاحها
- المستندات لا تتم معالجتها — تأكد من صحة الربط مع Paperless-ngx واكتمال استخراج نصوص OCR للمستند
- خطأ في الاتصال بالذكاء الاصطناعي — اختبر محرك Ollama من السيرفر: `curl http://localhost:11434/api/tags` وتأكد من تحميل النموذج (`ollama pull llama3`)
- تنسيق التواريخ غير صحيح — عدل في نص الأوامر (System Prompt) لفرض كتابة التاريخ بصيغة ISO القياسية (YYYY-MM-DD)
- واجهة الويب لا تفتح على المنفذ 3055 — افحص سجلات الحاوية بالأمر: `docker logs paperless-ai -f`
- استهلاك معالج مرتفع أثناء التحليل — شغل محرك Ollama على كرت شاشة مخصص أو استخدم نماذج مكممة خفيفة (Q4_K_M)
البدائل
نظام التصنيف المدمج في Paperless-ngx يعتمد على التعلم الآلي التقليدي لـ Scikit-learn. منصة Stirling-PDF أداة مفتوحة المصدر لمعالجة وتعديل ملفات PDF. منصة Documenso منصة رقمية لتوقيع المستندات. منصة AnythingLLM للمحادثة مع المستندات وبناء قواعد المعرفة.
متى لا تستخدمه
تجنب استخدام Paperless-AI إذا كان سيرفرك لا يمتلك موارد ذاكرة كافية لتشغيل نماذج الذكاء الاصطناعي المحلية ولا ترغب في دفع تكاليف APIs الخارجية السحابية (حيث تكفي القواعد التلقائية المدمجة في Paperless-ngx بدون ذكاء اصطناعي). وإذا كانت لديك فواتير محددة ومتكررة لشركات معدودة، فإن قواعد المطابقة العادية في Paperless-ngx أسرع وأبسط.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل يغني Paperless-AI عن خادم Paperless-ngx؟
لا، يعد Paperless-AI أداة مكملة ومساعدة ترتبط بخادم Paperless-ngx القائم. حيث يتولى Paperless-ngx إدارة الملفات وتخزينها والتعرف الضوئي (OCR)، بينما يتولى Paperless-AI تحليل النصوص بالذكاء الاصطناعي لتطبيق الوسوم والملخصات.
هل يمكن استخدام نماذج Ollama المحلية مع Paperless-AI؟
نعم! يدعم Paperless-AI نماذج Ollama المحلية (مثل Llama 3 وMistral وQwen). وهذا يضمن بقاء كافة مستنداتك وفواتيرك السرية داخل سيرفرك الشخصي دون إرسال أي بيانات للسحابة.
ما هو أفضل نموذج ذكاء اصطناعي لمعالجة المستندات؟
للتشغيل المحلي، يوفر نموذج `llama3:8b` أو `mistral:7b` دقة ممتازة في استخراج البيانات والتصنيف. وللخدمات السحابية، يعد نموذج `gpt-4o-mini` خياراً سريعاً واقتصادياً للغاية.
أين يحفظ Paperless-AI ملخصات المستندات المولدة؟
يقوم Paperless-AI بكتابة الملخص الذكي في حقل 'الملاحظات' (Notes) الخاص بالمستند داخل Paperless-ngx مباشرة، ليظهر فوراً عند فتح المستند في الواجهة.
كم يستهلك Paperless-AI من الذاكرة العشوائية؟
تستهلك حاوية Paperless-AI ما بين 60 إلى 120 ميجابايت فقط من الذاكرة العشوائية. واستهلاك الذاكرة الرئيسي يعتمد على نموذج الذكاء الاصطناعي المستخدم في Ollama (حوالي 6 إلى 8 جيجابايت لنموذج 8B).