[{"data":1,"prerenderedAt":153},["ShallowReactive",2],{"seo-verification":3,"blog-استضافة-paperless-ngx-على-خادمك-الافتراضي-الخاص-vps-ar":6},{"google":4,"bing":5},"EycwPY2XMyTkVzas3n1ygeNJFGAH513qrMjfDljzsMQ","",{"id":7,"slug":8,"slugs":9,"title":12,"excerpt":13,"readTime":14,"views":15,"isPinned":16,"publishedAt":17,"category":18,"categories":24,"featuredImage":26,"bgImage":27,"posterImage":28,"relatedSolution":29,"intro":31,"sections":32,"ctaTitle":101,"ctaBody":102,"ctaButton":103,"ctaUrl":104,"relatedPosts":105},85,"استضافة-paperless-ngx-على-خادمك-الافتراضي-الخاص-vps",{"fr":10,"en":11,"ar":8},"heberger-paperless-ngx","host-paperless-ngx-on-your-own-vps","استضافة Paperless-ngx على خادمك الافتراضي الخاص (VPS)","ثبّت Paperless-ngx على خادمك الافتراضي (VPS): إدارة مستندات مُستضافة ذاتيًا مع OCR وفهرسة وتصنيف تلقائي وSSL عبر Docker.",3,0,false,"2026-03-27T00:00:00+00:00",{"id":19,"name":20,"slug":21,"color":22,"icon":23},7,"الاستضافة الذاتية","self-hosting","bg-indigo-500\u002F10 text-indigo-400","cloud",[25],{"id":19,"name":20,"slug":21,"color":22,"icon":23},null,"\u002Fblog\u002Fcovers\u002Fbg.svg","\u002Fblog\u002Fcovers\u002Fheberger-paperless-ngx-poster.svg",{"categorySlug":21,"appSlug":30},"paperless-ngx","يحوّل Paperless-ngx مستنداتك الورقية وملفات PDF إلى أرشيف رقمي قابل للبحث: OCR تلقائي وتصنيف حسب المُراسِل ووسوم وبحث في النص الكامل. مُستضافًا ذاتيًا على خادمك الافتراضي (VPS)، يصبح خزنة مستندات نشاطك، مفهرسًا ويمكن الوصول إليه في ثوانٍ.",[33,37,47,50,72,75,78,81,99],{"type":34,"title":35,"body":36},"h2","لماذا تستضيف Paperless-ngx ذاتيًا على خادم VPS","الفواتير والعقود وكشوف الرواتب والمراسلات الإدارية: تتعامل إدارة المستندات مع بيانات سرّية قلّما ترغب الشركات في تسليمها إلى سحابة طرف ثالث. يستوعب Paperless-ngx كل ملف PDF أو صورة ممسوحة، ويطبّق عليه OCR (التعرّف على النص) لجعله قابلاً للبحث، ثم يصنّفه تلقائيًا حسب المُراسِل والنوع والوسوم بفضل محرّك مطابقة. على خادم VPS، تحصل على أرشيف يمكن الوصول إليه من أي مكان، يُغذّى بمجرد إسقاط الملفات في مجلد مُراقَب أو عبر البريد الإلكتروني. يعتمد المكدّس على PostgreSQL للفهرس، وRedis لطابور المهام، وخدمة معالجة تشغّل Tesseract لـOCR. وتتحكم أنت بالاحتفاظ القانوني وتشفير النسخ الاحتياطي والوصول، دون الاعتماد على مطوّر.",{"type":38,"title":39,"items":40},"ul","فوائد Paperless-ngx المُستضاف ذاتيًا",[41,42,43,44,45,46],"‎OCR تلقائي عبر Tesseract: يصبح كل ملف ممسوح أو PDF قابلاً للبحث في نصه الكامل.","تصنيف تلقائي حسب المُراسِل ونوع المستند والوسوم وفق قواعدك.","مجلد مُراقَب واستيراد عبر البريد الإلكتروني: أسقِط ملفًا، فتتم معالجته وفهرسته تلقائيًا.","بحث فوري في كل المحتوى النصّي، وليس أسماء الملفات فقط.","الحفاظ على النسخ الأصلية سليمة إلى جانب النسخ المعالَجة بـOCR، من أجل القيمة الإثباتية.","نسخ احتياطي مُتحكَّم به لأرشيف حسّاس قانونيًا، دون سحابة طرف ثالث.",{"type":34,"title":48,"body":49},"المتطلبات العتادية والبرمجية","‎Paperless-ngx معقول عند الخمول، لكن OCR نهِم على دفعات: يوفّر 2 vCPU و3 إلى 4 غيغابايت من RAM راحة جيدة، إذ يُجهد OCR مستندٍ متعدد الصفحات المعالَج مؤقتًا. وللاستيراد الأولي الكبير لعدة آلاف من المستندات، تسرّع الأنوية الإضافية المعالجة بشكل ملحوظ. خصّص تخزينًا للنسخ الأصلية إضافةً إلى ملفات الأرشيف المعالَجة بـOCR، أي نحو ضعف الحجم الخام. على الجانب البرمجي: ‎Docker و`docker compose` الإصدار v2، وPostgreSQL، وRedis، ولغات Tesseract التي تحتاجها (`fra` و`eng` و`ara`). ونطاق (`docs.yourcompany.com`)، واختياريًا حساب IMAP مخصّص للاستيراد التلقائي لمرفقات البريد الإلكتروني.",{"type":51,"title":52,"steps":53},"steps","نشر Paperless-ngx خطوة بخطوة",[54,57,60,63,66,69],{"title":55,"body":56},"تجهيز الخادم VPS والأحجام","ثبّت Docker، ثم أنشئ المجلدات الدائمة: `consume` (نقطة إسقاط مُراقَبة) و`media` (الأرشيف المعالَج بـOCR) و`data` و`export`. سيكون مجلد `consume` صندوق وارد مستنداتك.",{"title":58,"body":59},"جلب ملف compose الرسمي","يوفّر المشروع سكربت تثبيت تفاعليًا، لكن في الإنتاج انطلق من ملف `docker-compose.yml` الرسمي الذي يعلن `webserver` و`broker` (Redis) و`db` (PostgreSQL) والعامل (worker). عدّل مسارات الأحجام لتشير إلى المجلدات التي أنشأتها.",{"title":61,"body":62},"إعداد لغات OCR والأسرار","في ملف البيئة، عيّن `PAPERLESS_OCR_LANGUAGE=fra+eng+ara`، و`PAPERLESS_SECRET_KEY` المولَّد بـ`openssl rand -base64 48`، والعنوان العام `PAPERLESS_URL=https:\u002F\u002Fdocs.yourcompany.com`.",{"title":64,"body":65},"إنشاء المستخدم الفائق والبدء","شغّل `docker compose up -d`، ثم أنشئ المسؤول بـ`docker compose run --rm webserver createsuperuser`. بعدها سجّل الدخول إلى الواجهة للتحقق من أن العمّال (workers) يعالجون طابور المهام بشكل صحيح.",{"title":67,"body":68},"إضافة وكيل عكسي وSSL","ضع Caddy أمام خدمة الويب لـ`docs.yourcompany.com`، مع شهادة Let's Encrypt تلقائية. زِد الحدّ الأقصى لحجم الرفع في الوكيل لقبول ملفات PDF الممسوحة الكبيرة دون خطأ 413.",{"title":70,"body":71},"توصيل الاستيراد عبر البريد الإلكتروني","من Administration، اضبط حساب IMAP مخصّصًا: سيجلب Paperless-ngx مرفقات الرسائل الواردة، ويعالجها بـOCR، ويصنّفها تلقائيًا وفق قواعد المطابقة لديك.",{"type":73,"body":74},"tip","عرّف المُراسِلين وأنواع المستندات بقواعد مطابقة تلقائية (بالكلمة المفتاحية أو التعبير النمطي) منذ البداية. يتعلّم Paperless-ngx أيضًا عبر التصنيف: بعد وسم نحو خمسين مستندًا يدويًا، فعّل المصنِّف التلقائي كي يقترح وحده وسوم الملفات الجديدة. وبدمجه مع مجلد `consume` المُراقَب، تحصل على سلسلة تلقائية بالكامل من المسح إلى الأرشيف المفهرس.",{"type":34,"title":76,"body":77},"تكاملات شائعة","تفتح REST API الخاصة بـ Paperless-ngx (المتاحة على `\u002Fapi\u002F` مع توثيق Swagger) إمكانات كثيرة. في n8n، يمكن لعقدة HTTP Request أن تطلق استيعاب وثيقة فور وصول فاتورة إلى صندوق Gmail. ومع Nextcloud، تتيح إضافة Paperless-ngx إرسال الملفات مباشرة إلى نظام إدارة الوثائق من واجهة Nextcloud. وفي خطوط التكامل المستمر، يكفي أمر `curl` لرفع ملف PDF لتقرير البناء عند نجاح النشر، مع تطبيق الوسمين `#ci` و`#deploy` تلقائيًا.",{"type":34,"title":79,"body":80},"الانتقال من Paperless-ngx v2 إلى v3 : ثلاث نقاط إعاقة","يستبدل الإصدار v3 من Paperless-ngx محرّك البحث النصي ‎Whoosh بـ‎Tantivy. يحسّن هذا التغيير أداء الفهرسة لكنه يُبطل بصمت استعلامات العروض المحفوظة الموجودة: تظل العروض مرئية في الواجهة لكنها لا تُعيد أي نتائج. يضاف إلى ذلك أن مشكلتين في البنية التحتية تعوقان بدء تشغيل الـworker على خوادم VPS التي لا تملك وصولاً شبكيًا صادرًا غير مقيّد: محاولة تجميع مكتبة C الخاصة بـ‎`psycopg-c` عند الإطلاق الأول، وحدّ واصفات الملفات المنخفض الذي لا يستوعب ‎Celery وRedis معًا. لا تظهر هذه النقاط الثلاث في دليل الترحيل الرسمي لـv3 — إغفالها يؤدي إلى worker لا يبدأ أبدًا أو أرشيف لا تعمل فيه المرشّحات المحفوظة بعد التحديث.",{"type":51,"title":82,"steps":83},"إجراءات الترحيل من v2 إلى v3",[84,87,90,93,96],{"title":85,"body":86},"نسخ احتياطي لقاعدة البيانات والوسائط","قبل أي تحديث، صدِّر قاعدة بيانات PostgreSQL بـ`docker compose exec db pg_dump -U paperless paperless > backup-$(date +%F).sql` وأنشئ أرشيفًا لحجم `media` الذي يحتوي جميع ملفاتك الأصلية والمعالَجة بـ‎OCR. الترحيل دون نسخة احتياطية مسبقة لا يمكن التراجع عنه.",{"title":88,"body":89},"تحديث الصورة وإعادة التشغيل","في ملف `docker-compose.yml` الخاص بك، حدّث وسم صورة `ghcr.io\u002Fpaperless-ngx\u002Fpaperless-ngx` إلى إصدار v3 المستهدف. ثم نفّذ `docker compose pull` تليها `docker compose up -d`. يطبّق الـworker ترحيلات قاعدة البيانات عند بدء التشغيل.",{"title":91,"body":92},"إعادة إنشاء العروض المحفوظة","بعد التحديث، استعرض كل عرض محفوظ في الواجهة (قائمة العروض). يستبدل ‎Tantivy محرّكَ ‎Whoosh النصي: الاستعلامات المُجمَّعة تحت v2 لم تعد صالحة. احذف كل عرض متأثر وأعد إنشاءه بالمعايير ذاتها — يعمل البحث النصي الكامل بشكل صحيح مجدّدًا بعد إعادة البناء.",{"title":94,"body":95},"ضبط PAPERLESS_OCR_LANGUAGE في ملف ‎.env","على خادم VPS لا يملك وصولاً شبكيًا صادرًا كاملاً، يحاول الحاوي تجميع مكتبة C الخاصة بـ‎`psycopg-c` عند الإطلاق الأول ويفشل دون رسالة خطأ واضحة، تاركًا الـworker في حالة انتظار. إضافة `PAPERLESS_OCR_LANGUAGE=fra+eng` صراحةً (أو اللغات التي تحتاجها) إلى ملف ‎`‎.env` قبل الإطلاق يتجنّب هذا البناء البارد. تحقق من سجل الـworker بـ`docker compose logs worker` إن لم يستجب الخدمة.",{"title":97,"body":98},"ضبط ulimits nofile في docker-compose.yml","يفتح ‎Celery وRedis معًا أكثر من 1024 واصف ملف تحت الحمل. الحدّ الافتراضي للنظام (`ulimit -n 1024`) يُوقف تشغيل الـworker دون تحذير مقروء. أضف الكتلة التالية إلى خدمة `webserver` وخدمة الـworker في ملف `docker-compose.yml` الخاص بك:\n```yaml\nulimits:\n  nofile:\n    soft: 65536\n    hard: 65536\n```\nأعد التشغيل بعدها بـ`docker compose up -d` لكي يُؤخذ الحدّ بعين الاعتبار.",{"type":73,"body":100},"اختبر دائمًا على نسخة قبل الترحيل إلى الإنتاج. استعد نسختك الاحتياطية على خادم VPS ثانٍ أو في مشروع Docker ثانٍ، وطبّق ترحيل v3، وتحقق من أن عروضك المحفوظة وإدخال البريد الإلكتروني ونتائج البحث تتوافق مع توقعاتك. تعتمد مدة الفهرسة الأولية في ‎Tantivy على الحجم: خصّص عدة دقائق لأرشيف يضم آلاف المستندات.","رقمِن وافهرس جميع مستنداتك","يوفّر خادم ServOrbit Cloud VPS المعالج والتخزين وDocker الجاهزة لـPaperless-ngx وأداة OCR Tesseract وPostgreSQL وRedis. حوّل أكوام الورق لديك إلى أرشيف قابل للبحث، منسوخ احتياطيًا وتحت سيطرتك وحدك.","انشر Paperless-ngx على خادم Cloud VPS","\u002Fvps-cloud",[106,122,138],{"id":107,"slug":108,"slugs":109,"title":112,"excerpt":113,"readTime":114,"views":15,"isPinned":16,"publishedAt":115,"category":116,"categories":117,"featuredImage":26,"bgImage":27,"posterImage":119,"relatedSolution":120},71,"استضافة-nextcloud-على-خادمك-الـvps-الخاص",{"fr":110,"en":111,"ar":108},"heberger-nextcloud","hosting-nextcloud-on-your-own-vps","‎Nextcloud‎ على ‎VPS‎ : الدليل الكامل ‎NC 34‎ والأمان","‏انشر ‎Nextcloud 34.0.2‎ على ‎VPS‎ الخاص بك مع ‎Docker‎ و‎Redis‎. دليل شامل: تطبيقات ‎NC 34.0.0‎ المفقودة وقيد ‎oc_filecache_extended‎ على ‎PostgreSQL‎ وثغرات ‎CVE‎.",12,"2026-04-10T00:00:00+00:00",{"id":19,"name":20,"slug":21,"color":22,"icon":23},[118],{"id":19,"name":20,"slug":21,"color":22,"icon":23},"\u002Fblog\u002Fcovers\u002Fheberger-nextcloud-poster.svg",{"categorySlug":21,"appSlug":121},"nextcloud",{"id":123,"slug":124,"slugs":125,"title":128,"excerpt":129,"readTime":130,"views":15,"isPinned":16,"publishedAt":131,"category":132,"categories":133,"featuredImage":26,"bgImage":27,"posterImage":135,"relatedSolution":136},72,"استضافة-ghost-على-خادمك-الـvps-الخاص",{"fr":126,"en":127,"ar":124},"heberger-ghost","hosting-ghost-on-your-own-vps","استضافة Ghost على خادمك الـVPS: دليل شامل 2026","نشر Ghost v6 على خادمك الـVPS مع Caddy وMySQL وGhost CLI وStripe Tax: التثبيت ووكيل TLS العكسي والتحديثات واستكشاف أخطاء البدء الشائعة.",9,"2026-04-09T00:00:00+00:00",{"id":19,"name":20,"slug":21,"color":22,"icon":23},[134],{"id":19,"name":20,"slug":21,"color":22,"icon":23},"\u002Fblog\u002Fcovers\u002Fheberger-ghost-poster.svg",{"categorySlug":21,"appSlug":137},"ghost",{"id":139,"slug":140,"slugs":141,"title":144,"excerpt":145,"readTime":14,"views":15,"isPinned":16,"publishedAt":146,"category":147,"categories":148,"featuredImage":26,"bgImage":27,"posterImage":150,"relatedSolution":151},73,"استضافة-wordpress-على-خادم-vps-الخاص-بك",{"fr":142,"en":143,"ar":140},"heberger-wordpress","host-wordpress-on-your-own-vps","استضافة WordPress على خادم VPS الخاص بك","استضِف WordPress على خادم VPS الخاص بك لأقصى أداء وتحكّم: Docker وMariaDB والتخزين المؤقت (cache) وreverse proxy وSSL.","2026-04-08T00:00:00+00:00",{"id":19,"name":20,"slug":21,"color":22,"icon":23},[149],{"id":19,"name":20,"slug":21,"color":22,"icon":23},"\u002Fblog\u002Fcovers\u002Fheberger-wordpress-poster.svg",{"categorySlug":21,"appSlug":152},"wordpress",1787580943093]