لماذا تستضيف Dolibarr على خادم VPS؟
اختيار خادم VPS بدلًا من استضافة مشتركة أو SaaS يضمن لك موارد مخصّصة وقاعدة بيانات معزولة وحرية تثبيت وحدات Dolibarr التي تختارها دون قيود. تبقى بياناتك على خادم تتحكّم فيه بالكامل، بما يتوافق مع متطلبات السرية التي تفرضها اللوائح المعمول بها. يتيح لك خادم VPS أيضًا تطوير الموارد (RAM، CPU، التخزين) مع نمو نشاطك، دون الحاجة إلى تغيير المنصّة أبدًا.
ما يمكنك فعله بـ Dolibarr
- إنشاء وإرسال عروض أسعار وفواتير احترافية مباشرة من متصفحك
- إدارة دليل عملائك ومورّديك مع سجلّ كامل للتفاعلات
- متابعة مخزونك وطلباتك وعمليات التسليم في الوقت الفعلي
- إدارة مشاريعك بمراحل رئيسية ومهام وتتبّع للوقت المُستغرَق
- توليد تقارير محاسبية ولوحات معلومات مالية
- توسيع الوظائف عبر أكثر من 1000 وحدة رسمية ومجتمعية
المتطلبات المرقّمة قبل تحديد حجم الخادم
يطلب wiki الخاص بـ Dolibarr كحد أدنى MariaDB 10.3 أو MySQL 5.7.7 أو PostgreSQL 9.1، إضافة إلى PHP مسموح له باستخدام 128 ميغابايت من الذاكرة (الإعداد memory_limit) مع تفعيل الجلسات. وتذكر صفحة الإصدارات أن Dolibarr 24.0، الذي نُشر في 20 أغسطس 2026، يعمل مع PHP من 7.2 إلى 8.5؛ ويغطي Dolibarr 23.0 النطاق نفسه، بينما يمتد Dolibarr 22.0 من 7.1 إلى 8.4. على خادم VPS الخاص بك، تحقّق بالأمرين php -v وmariadb --version مما وضعه التثبيت بنقرة واحدة فعليًا قبل إضافة وحدة من طرف ثالث تشترط إصدارًا محددًا. يكفي 2 vCPU و2 غيغابايت من RAM المذكوران في الخطوة الأولى لبدء العمل في شركة صغيرة أو متوسطة؛ وترتفع الذاكرة مع عدد المستخدمين المتزامنين والوحدات المفعّلة وتوليد ملفات PDF. سجّل نتيجة free -h خلال يوم فوترة مزدحم قبل تغيير العرض: القياس هو الذي يقرّر لا الحدس.
تثبيت Dolibarr على خادم VPS من ServOrbit
اطلب خادم VPS Cloud من ServOrbit
توجّه إلى صفحة /vps-cloud واختر العرض المناسب لحملك: للاستخدام القياسي لـ Dolibarr في شركة صغيرة أو متوسطة، يشكّل خادم VPS بـ 2 vCPU و2 غيغابايت من RAM نقطة انطلاق جيدة. أكمل الطلب؛ يُسلَّم خادمك خلال 60 ثانية بعنوان IP مخصّص ووصول SSH بصلاحية root.
الوصول إلى Marketplace في مساحة العميل
سجّل الدخول إلى مساحة العميل الخاصة بك على ServOrbit، وافتح صفحة خادم VPS الخاص بك، ثم انقر على تبويب « Marketplace ». يسرد هذا القسم جميع التطبيقات المتاحة للتثبيت بنقرة واحدة، مُهيّأة مسبقًا وجاهزة للاستخدام.
بدء تثبيت Dolibarr
ابحث عن « Dolibarr » في Marketplace، وانقر على بطاقة التطبيق ثم على « Install ». ينشر النظام تلقائيًا Apache وMariaDB وDolibarr على خادم VPS الخاص بك. تستغرق العملية حوالي دقيقتين إلى 3 دقائق؛ وستتلقّى إشعارًا بمجرد اكتمال التثبيت.
الوصول إلى واجهة تثبيت Dolibarr
بمجرد اكتمال التثبيت، افتح متصفحك وأدخل العنوان http://VOTRE_IP/dolibarr/install. يرشدك معالج تهيئة Dolibarr لإنشاء قاعدة البيانات، وتعيين اسم المستخدم وكلمة المرور للمسؤول، ثم اختيار اللغة والعملة. في نهاية هذا المعالج، احذف أو أعد تسمية مجلد install/ لتأمين نسختك.
أول تسجيل دخول والتهيئة الأولية
توجّه إلى http://VOTRE_IP/dolibarr وسجّل الدخول ببيانات اعتماد المسؤول التي حدّدتها للتو. من لوحة المعلومات، فعّل الوحدات التي تحتاجها (الفواتير، عروض الأسعار، الأطراف الثالثة، المخزون، إلخ) عبر قائمة الصفحة الرئيسية > الإعداد > الوحدات. للوصول الآمن في الإنتاج، هيّئ اسم نطاق يشير إلى خادم VPS الخاص بك وفعّل شهادة HTTPS عبر Let's Encrypt.
أول تسجيل دخول
يثبّت Dolibarr نفسه تلقائيًا عند أول تشغيل: فعند فتح العنوان تصل مباشرة إلى شاشة تسجيل الدخول، دون أي معالج. سجّل الدخول بكلمة المرور التي سُلّمت إليك (تجدها في قسم التطبيقات داخل مساحة العميل) وباسم المستخدم «admin»، ثم غيّر كلمة المرور من: الرئيسية ▸ المستخدمون.
تحصين النسخة بعد أول تسجيل دخول
- HTTPS في كل مكان — اربط نطاقًا مثل
your-domain.comبالخادم، وفعّل شهادة Let's Encrypt وأعد توجيه HTTP إلى HTTPS: يحتوي Dolibarr على عملائك وفواتيرك وبياناتهم - ملف إعداد للقراءة فقط — يحمل
conf/conf.phpبيانات اعتماد قاعدة البيانات؛ بعد التثبيت، أزل منه صلاحية الكتابة بالأمر chmod 400 conf/conf.php - مجلد documents/ غير مُقدَّم عبر الويب — تحقّق من أن عنوانًا مباشرًا إلى مرفق أو إلى ملف PDF لفاتورة لا يستجيب دون تسجيل دخول
- حسابات شخصية — غيّر كلمة مرور حساب « admin »، وأنشئ حسابًا لكل مستخدم، واقصر صلاحيات الإدارة على من يحتاجها
- جدار ناري أدنى — افتح للعموم المنفذين 80 و443 فقط، وقيّد SSH بعناوين عملك
قبل نقل Dolibarr إلى الإنتاج، جدول نسخًا احتياطية تلقائية لقاعدة بيانات MariaDB باستخدام mysqldump وخزّنها خارج خادم VPS (على سبيل المثال عبر تخزين كائني بعيد). يخزّن Dolibarr أيضًا الملفات المرفوعة في مجلد documents/: ضمّن هذا الدليل في خطة النسخ الاحتياطي حتى لا تفقد أي مرفق أو أي ملف PDF لفاتورة مُولَّدة.
تحديث Dolibarr دون فقدان البيانات
تُظهر المستودعات الرسمية أن الفرع 24 يضم إصدارين حتى الآن: 24.0.0 في 20 أغسطس 2026، ثم 24.0.1 في 7 سبتمبر 2026. التحديث الصغير يصلح أخطاء؛ أما تغيير الإصدار الرئيسي فقد يعدّل قاعدة البيانات ويرفع إصدار PHP المطلوب. قبل أي عملية، خذ نسخة احتياطية من القاعدة بالأمر mysqldump، وانسخ مجلد documents/ وملف conf/conf.php، ثم أعد تنفيذ التحديث على نسخة من الخادم أو على لقطة. بعد ذلك تحقّق من أن إصدار PHP لديك يبقى ضمن النطاق المعلن للإصدار المستهدف: الانتقال من Dolibarr 22.0 إلى 24.0 يرفع الحد الأعلى من 8.4 إلى 8.5 والحد الأدنى من 7.1 إلى 7.2. وأخيرًا، اقرأ ملاحظات الإصدار قبل تشغيل معالج الترقية، ودوّن الإصدار المثبّت بجانب نسختك الاحتياطية.
تنبيه PHP بتاريخ 21 أكتوبر 2026
في 21 أكتوبر 2026، نشر مشروع PHP الإصدارات 8.5.12 و8.4.27 و8.3.36 و8.2.35 لإصلاح ثغرتين حرجتين هما CVE-2026-109618 وCVE-2026-109619، وقد تتيحان تنفيذ تعليمات برمجية عن بُعد دون مصادقة. يوضح التنبيه أن التحديث هو الإصلاح الموصى به، وأن الحلول المؤقتة لا تجعل التثبيت آمنًا. على خادمك، يعطيك php -v رقم الإصدار، لكن التوزيعات تنقل الإصلاحات دون أن تغيّر الرقم دائمًا: راجع تنبيه توزيعتك، وطبّق الحزم، ثم أعد تشغيل Apache أو PHP-FPM. وإذا كان Dolibarr يعمل داخل صورة Docker من نوع php:*، فأعد بناء الصورة ثم أعد التشغيل بالأمر docker compose pull && docker compose up -d. يقبل Dolibarr 24.0 إصدارات PHP حتى 8.5، لذا يبقى الإصدار 8.5.12 ضمن نطاقه.
Dolibarr وStripe: عندما لا يظهر دفع تم تحصيله
إذا كنت تحصّل المدفوعات بالبطاقة عبر وحدة Stripe، فثمة نقطة تستحق انتباهك. يصف البلاغ رقم 32510 في مستودع Dolibarr، المفتوح في 3 يناير 2025 بوسم Bug والذي ظل مفتوحًا في 31 أكتوبر 2026، دفعًا اكتمل وصُرف من جهة Stripe، بينما لم ينشئ Dolibarr لا الفاتورة ولا اعتمادها ولا الدفعة، بعد أربع محاولات من العميل. عاد صاحب البلاغ في سبتمبر 2025: فاتورتان من خمس وعشرين متأثرتان، مع Dolibarr 21.0.1، ثم حالة جديدة في 2026. يضم النقاش خمسة عشر تعليقًا، لا واحد منها من عضو في منظمة Dolibarr، ولا يُعلَن فيه عن أي إصلاح. إليك ما يمكن تأكيده وما يبقى فرضية.
ما يُظهره الكود وما يرويه المشاركون
- مُعاين في الكود، الفرع 24.0 — في
htdocs/public/stripe/ipn.php، يبني مسار « البطاقة » الاستعلام الذي يضبطtraiteعلى 1، ويسجّله بالنص « TODO update flag traite to 1 sql= »، ثم يتركه معلّقًا (//$db->query($sql);)؛ ويرشّح الاستعلام أيضًا بالشرطsourcetype = 'facture' - مُعاين في الكود، الفرعان 22.0 و23.0 — لا يحتوي المسار نفسه على أي استعلام، بل على سجلات « TODO update flag traite to 1 » فقط: فالقيمة
traite = 0لا تثبت شيئًا بشأن دفع بالبطاقة - يرويه مشارك، غير مؤكَّد — يُفترض أن الدفع بالبطاقة يُسجَّل عبر
public/payment/paymentok.phpعند عودة متصفح المشتري؛ فإن أغلق التبويب أو فقد الاتصال، فلن يصلح webhook شيئًا. ولم يتمكن صاحب البلاغ من تأكيد هذا الاحتمال - يرويه مشارك آخر، غير مؤكَّد — بالنسبة إلى دفعة مفقودة، لا يظهر في سجلات خادم الويب أي طلب
POSTإلى newpayment.phpولا أي استدعاء لـ paymentok.phpبعد المحاولة الناجحة - غير مثبت — السبب الدقيق لدى صاحب البلاغ، وقرار المشرفين بشأن إصلاح، والصلة المحتملة بالبلاغ رقم 32500، حيث يصف الكاتب نفسه فاتورة غير معتمدة رغم دفع كامل
أي مصدر يقول ماذا عندما تغيب دفعة
مرّر الجدول أفقيًا
| المصدر | ما يثبته | ما لا يثبته |
|---|---|---|
| لوحة Stripe | أن الدفع نجح وصُرف | أن Dolibarr سجّله |
| عمود `traite` في `llx_prelevement_demande` | لا شيء عن مسار البطاقة بحسب كود الفروع 22.0 إلى 24.0 | هل وصل webhook أم لا |
| جدول `llx_paiement`، عمود `ext_payment_id` | أن دفعة موجودة في Dolibarr | الدفعة الغائبة تُعرف بغياب السطر |
| سجلات خادم الويب | هل استدعى Stripe الـ webhook وهل عاد متصفح المشتري | لماذا لم تُنشأ الدفعة |
استكشاف الأخطاء: العثور على دفعة Stripe غائبة عن Dolibarr
سرد الدفعات الناجحة من جهة Stripe
في لوحة Stripe، رشّح الدفعات الناجحة للفترة ودوّن معرّفاتها التي تبدأ بـ
pi_. هذه هي القائمة المرجعية: لا يستطيع Dolibarr أن يخبرك بما لم يستقبله قط.البحث عن الطلبات بلا دفعة في Dolibarr
على نسخة من القاعدة أو بوصول للقراءة فقط، يقترح أحد المشاركين في البلاغ هذا الاستعلام، وعليك تكييفه إذا لم تكن بادئة جداولك
llx_: SELECT pd.rowid, pd.ext_payment_id, pd.sourcetype, pd.fk_facture, pd.amount, pd.date_demande FROM llx_prelevement_demande pd LEFT JOIN llx_paiement p ON p.ext_payment_id LIKE CONCAT(pd.ext_payment_id, '%') WHERE pd.ext_payment_id LIKE 'pi_%' AND pd.ext_payment_site = 'StripeLive' AND p.rowid IS NULL ORDER BY pd.date_demande DESC;كل سطر هو دفعة أعدّها Dolibarr دون أن يسجّلها قط؛ قارن معرّفاتهاpi_بمعرّفات Stripe لتحتفظ بالدفعات الناجحة فعلًا فقط.التحقق من استجابة webhook من الخارج
من جهاز خارج الخادم، شغّل
curl -s -o /dev/null -w '%{http_code}' -X POST https://your-domain.com/public/stripe/ipn.php. تثبت الاستجابة 400 أن السكربت يعمل؛ أما 404 أو 502 أو انتهاء المهلة فتشير إلى خادم الويب أو الجدار الناري أو CDN. يعيد الكود على وجه الخصوص « Error: Setup of module Stripe not complete for mode StripeLive. The WEBHOOK_KEY is not defined. » عندما يغيب مفتاح webhook من إعداد الوحدة، و« Invalid signature. May be a hook for an event created by another Stripe env or a hack attempt ? Check setup of your keys whsec_... » عندما لا يطابق التوقيع المفتاح المحفوظ. لا تثبت الاستجابة 400 أن Stripe يوقّع بالمفتاح الصحيح: قائمة الإرسالات في لوحة Stripe تؤكد ذلك.قراءة سجلات خادم الويب وقت الدفع
في وقت الدفعة المفقودة، ابحث عن استدعاءات Stripe إلى
ipn.php، ثم عن طلبات المشتري إلى newpayment.phpوpaymentok.php. بحسب المشاركين في البلاغ، فإن غياب هذين الأخيرين يفسّر دفعة لم تُنشأ قط. اعتبره احتمالًا لا تشخيصًا.التسوية وحفظ الأثر
من صفحة الفاتورة، سجّل الدفعة المفقودة مع كتابة معرّف Stripe في الملاحظة، واعتمد الفاتورة إن لم تكن معتمدة، ثم دوّن الحادثة بالتاريخ والمبلغ. يتيح لك هذا الأثر مقارنة عدد الحالات من شهر إلى آخر.
مطابقة أسبوعية
ما دام المشرفون لم يعلنوا أي إصلاح، فالدفاع الموثوق هو المراقبة: مرة في الأسبوع، قارن الدفعات الناجحة في لوحة Stripe بالدفعات المسجّلة في Dolibarr، ثم اقرأ سجلات استقبال webhook. تحمي هذه العادة أيضًا متابعة سيولتك النقدية، لأن تحصيلًا غائبًا عن نظام ERP يشوّه الرصيد المتوقع. لا تنسب لعملائك أي سبب ما دام غير مثبت.
الوثائق الرسمية
للتهيئة المتقدّمة والخيارات الخاصة بالأداة وتغييرات الإصدار، راجع الوثائق الرسمية لـ Dolibarr. يغطّي هذا الدليل النشر على خادم VPS من ServOrbit؛ وتبقى وثائق الناشر المرجع للضبط الدقيق.
