كيفية تشغيل ERPNext على VPS باستخدام Docker
شغّل ERPNext على VPS تملكه باستخدام Docker، مع متطلبات الحجم، وحزمة من 11 حاوية، وTLS، والبريد الصادر، وتثبيت الإصدارات، واختبار الاستعادة.
ما الذي ستشغّله عند التسجيل
تشغيل ERPNext ذاتياً على VPS هو مهمة تشغيلية، وليس تثبيتاً بأمر واحد. تتكوّن حزمة Docker Compose الرسمية من إحدى عشرة حاوية، وتحتفظ بدفتر الأستاذ العام وسجلات العملاء. لذلك يجب رفع مستوى الحذر في كل ما يلي: لا تُعدّ النسخة الاحتياطية نسخة احتياطية حتى تستعيدها، ووسم الصورة غير المثبّت ينتظر ترحيل مخطط قاعدة البيانات.
ستظهر عدة أسماء في هذا الدليل. ERPNext هو تطبيق الأعمال. Frappe هو إطار Python الذي يعمل تحته. Bench هي أداة سطر الأوامر التي تدير المواقع، وهي مثبّتة مسبقاً داخل الحاويات. الموقع هو مستأجر واحد: قاعدة بيانات MariaDB واحدة بالإضافة إلى دليل واحد للملفات المرفوعة. تُنفَّذ كل الأوامر تقريباً هنا bench داخل الحاوية backend على موقع واحد محدد بالاسم.
يستخدم هذا الدليل مستودع frappe_docker، وهو النشر الذي يحافظ عليه المشروع. اختُبرت كل الأوامر أدناه مقابل هذا المستودع في August 2026. إذا كانت Docker Compose جديدة عليك، فسيغطي تشغيل Docker Compose على VPS الأساسيات التي يفترضها هذا الدليل.
ما هي موارد VPS التي يحتاجها ERPNext؟
البيانات وراء هذا الرسم البياني
[
{
"label": "Evaluation",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 40
},
{
"label": "Small production",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 100
},
{
"label": "Room to grow",
"vcpu": 4,
"ram_gb": 16,
"disk_gb": 160
}
]لأغراض التقييم، ابدأ بـ 2 vCPU و 4 GB من الذاكرة العشوائية (RAM). هذه هي فئة التقييم. هذه الأرقام هي نقاط بداية وليست قياسات مستمدة من هذا الدليل، فحجم بياناتك هو ما يحدد الاحتياج الفعلي. الصف الأخير ليس حداً أدنى معتمداً، بل يوفر لك مساحة إضافية في الذاكرة، ولا يضمن عدم نفادها.
كن واقعياً بشأن الخطط الصغيرة. خادم VPS بذاكرة 1 GB أو 2 GB لا يترك مساحة كافية لتشغيل عشر حاويات (containers) بالإضافة إلى مخزن مؤقت (buffer pool) لقاعدة بيانات MariaDB وعملية Python التي تنشئ التقارير. عند الضغط على الذاكرة، قد يقوم نظام التشغيل بإنهاء إحدى الحاويات قسراً (OOM killer)، وعندها سيظهر الأمر docker inspect الحالة "OOMKilled": true مع رمز الخروج 137. إنهاء عملية أثناء العمل يترك المستندات في حالة معالجة غير مكتملة.
بالنسبة لشركة تستخدم ERPNext بشكل يومي، ابدأ التخطيط بـ 8 GB من الذاكرة و 4 vCPU مع 100 GB من مساحة SSD، ثم اختبر حجم عملك. الذاكرة العشوائية هي أول ما ينفد. مساحة القرص تنمو أسرع مما يتوقع المستخدمون، لأن كل مرفق وكل نسخة احتياطية محلية تُخزّن على نفس وحدة التخزين الخاصة بقاعدة البيانات.
الحاويات الإحدى عشرة ووظيفة كل منها
شغّل docker compose ps بعد بدء الـstack وتشغيل عشر حاويات. توجد حاوية أخرى، configurator، تنفّذ مهمتها مرة واحدة ثم تتوقف، ومن هنا يأتي العدد الإجمالي البالغ إحدى عشرة حاوية.
backendيشغّل تطبيق Frappe باستخدام gunicorn. يوجدbenchهنا.frontendهو nginx. يقدّم الملفات الثابتة ويمرّر كل ما عدا ذلك إلى الواجهة الخلفية.queue-shortوqueue-longعاملان لـRQ (Redis Queue). ينفّذان مهاماً في الخلفية، مثل البريد الإلكتروني الصادر وعمليات الاستيراد وإنشاء التقارير.schedulerيشغّل المهام المستندة إلى الوقت، بما في ذلك التقارير المجدولة والمستندات المكررة تلقائياً.websocketهو عملية socket.io المسؤولة عن التحديثات المباشرة في المتصفح.dbهو MariaDB.redis-cacheوredis-queueمثيلان منفصلان من Redis، أحدهما للتخزين المؤقت والآخر لقائمة المهام.proxyهو Traefik، وتضيفه إعدادات HTTPS البديلة. وهو يتولى المنفذين 80 و443 ويجلب الشهادات.
من المفيد فهم هذا التقسيم، لأنه يوضح لك السجل الذي يجب قراءته. مشكلة توقف البريد الإلكتروني هي مشكلة في عامل قائمة المهام، ولذلك يكون docker compose logs -f queue-short هو الأمر الصحيح. أما الصفحة التي تُحمّل، لكن شارة الإشعارات فيها لا تتحدّث أبداً، فهذه مشكلة في websocket. قراءة سجلات backend في أي من الحالتين تضيّع وقتك.
التثبيت باستخدام ملفات compose الخاصة بالإنتاج، وليس ملفات العرض
يأتي المستودع مع pwd.yml، ويوضح ملف README ذلك بصراحة: "هذا الإعداد مخصص للتقييم قصير المدى فقط. لن تتمكن من تثبيت تطبيقات مخصصة على هذا الإعداد". استخدمه لإلقاء نظرة على ERPNext لبضع ساعات. لا تقم بتشغيل شركة عليه.
sudo apt update && sudo apt install -y git
curl -fsSL https://get.docker.com | bash
git clone https://github.com/frappe/frappe_docker
cd frappe_docker
mkdir -p ~/gitops
cp example.env ~/gitops/erpnext.envافتح ~/gitops/erpnext.env وقم بتغيير أربع قيم. يقوم ERPNEXT_VERSION بتثبيت إصدار الصورة (tag). يأتي DB_PASSWORD كـ 123 في ملف المثال. SITES_RULE هو قاعدة توجيه Traefik، ويوفر LETSENCRYPT_EMAIL بريداً إلكترونياً لحساب ACME. أوقفت Let’s Encrypt رسائل البريد الإلكتروني الخاصة بإشعارات انتهاء الصلاحية في 4 يونيو 2025، لذا راقب انتهاء صلاحية الشهادة بشكل منفصل.
ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.comالآن قم بإنشاء ملف compose واحد، ثم ابدأ تشغيله.
docker compose --project-name erpnext \
--env-file ~/gitops/erpnext.env \
-f compose.yaml \
-f overrides/compose.mariadb.yaml \
-f overrides/compose.redis.yaml \
-f overrides/compose.https.yaml \
config > ~/gitops/erpnext.yaml
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d
export COMPOSE_FILE="$HOME/gitops/erpnext.yaml"لا يقوم config ببدء أي شيء. هو يدمج الملف الأساسي مع ملفات التجاوز (overrides) ويطبع النتيجة مع استبدال كل المتغيرات. بعد ذلك، تقوم بتشغيل ذلك الملف المُنشأ. هذه الخطوة الإضافية مفيدة: المكدس (stack) قيد التشغيل هو ملف واحد يمكنك قراءته، لذا لا يمكن أن يتغير دون علمك عند تعديل ملف env أو عند سحب المستودع. يشرح كيفية دمج عدة ملفات Docker Compose قواعد التجاوز بالتفصيل.
يجعل تصدير COMPOSE_FILE الأوامر أدناه تستخدم الملف المُنشأ. كرر هذا الأمر في كل shell جديدة؛ وفي cron، مرر -f ~/gitops/erpnext.yaml صراحةً.
انتظر حتى يبدأ db وينتهي configurator، وهو أمر يستغرق بضع ثوانٍ، ثم أنشئ الموقع.
docker compose --project-name erpnext exec backend \
bench new-site --mariadb-user-host-login-scope=% \
--db-root-password '<your DB_PASSWORD>' \
--install-app erpnext \
--admin-password '<a strong admin password>' \
erp.example.comتحقق منه:
docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-appsيجب أن يطبع list-apps كلاً من frappe و erpnext مع إصداراتهما. يُظهر ps السليم عشر خدمات في حالة running ولا شيء في حالة restarting.
هناك أمران يسببان مشاكل هنا غالباً. يمنح --mariadb-user-host-login-scope=% مستخدم قاعدة بيانات الموقع الجديد نطاق مضيف (host scope) عام، بحيث يمكنه تسجيل الدخول حتى عندما يخصص Docker لحاوية التطبيق عنواناً مختلفاً. بدون هذا، يحدد Frappe نطاق المستخدم بالمضيف المتصل حالياً. تصل حاوية التطبيق إلى MariaDB عبر شبكة Docker، لذا فهي تصل كمضيف بعيد، ولا يمكن لمستخدم قاعدة بيانات محدد بـ localhost تسجيل الدخول من هناك. يغير هذا الخيار مستخدم قاعدة بيانات الموقع، وليس حساب root. يسمح نطاق % بالاتصالات من أي مضيف يمكنه الوصول إلى MariaDB، لذا أبقِ قاعدة البيانات على شبكة Docker الخاصة.
الأمر الثاني هو اسم الموقع. تختار الواجهة الأمامية الموقع الذي ستخدمه من ترويسة HTTP Host افتراضياً، لذا فإن الموقع الذي تم إنشاؤه باسم erpnext لا يمكن الوصول إليه عبر erp.example.com على الرغم من وجود كليهما. قم بتسمية الموقع باسم النطاق، كما هو موضح أعلاه، أو اضبط FRAPPE_SITE_NAME_HEADER في ملف env على اسم الموقع وأعد إنشاء ملف compose مرة أخرى.
HTTPS، وما يجب أن يكون صحيحاً قبل أن يعمل
يشغّل إعداد compose.https.yaml override Traefik على المنفذ 443، ويعيد توجيه المنفذ 80 إليه، ويطلب الشهادات من Let's Encrypt. يوفّر TLS (أمان طبقة النقل) الحماية التي تمنع ظهور الفاتورة وملف تعريف ارتباط الجلسة على الشبكة بنص واضح.
يجب تحقق أمرين، وإلا فلن تُصدر أي شهادة. يجب أن يكون سجل DNS من النوع A لـ erp.example.com موجهاً مسبقاً إلى VPS. ويجب أن يكون المنفذان 80 و443 قابلين للوصول من الإنترنت، لأن Let's Encrypt يثبت أنك تتحكم في الاسم باستخدام تحدي HTTP-01 على المنفذ 80. افحص جدار الشبكة الناري لدى مزود الخدمة، وكذلك الجدار الناري على الخادم. هذان إعدادان منفصلان، وغالباً ما يُنسى جدار اللوحة.
تُخزَّن الشهادات في volume cert-data ضمن /letsencrypt/acme.json. إذا عرض المتصفح شهادة افتراضية بدلاً من شهادتك، فاعثر على اسم خدمة الوكيل في docker compose --project-name erpnext ps واقرأ سجلاتها بحثاً عن خطأ ACME (بيئة إدارة الشهادات الآلية). هل تشغّل تطبيقات ويب أخرى على الخادم نفسه؟ يوضح مثيل Traefik واحد أمام عدة تطبيقات Docker Compose كيفية مشاركة الوكيل بدلاً من التنافس على المنفذ 443. غالباً ما يكون التطبيق الثاني على خادم كهذا موجهاً إلى العملاء، وتعمل منصة Chatwoot مستضافة ذاتياً لدعم العملاء خلف الوكيل نفسه، ولذلك يستطيع العاملون على الفواتير الرد على البريد الإلكتروني ومحادثات العملاء من مكان واحد.
البريد الصادر، أو لماذا لا تغادر الفواتير الخادم
هذه هي الخطوة التي تتجاهلها معظم أدلة ERPNext، وهي التي تحدد ما إذا كان النظام مفيداً أم لا. بدون بريد صادر يعمل، لن تصل أي فاتورة إلى العميل، ولن تصل رسائل إعادة تعيين كلمة المرور، ولن يتم تسليم أي تقارير مجدولة. حزمة البرمجيات هذه لا تتضمن خادم بريد.
لا تحاول إرسال البريد مباشرة من الـVPS عبر المنفذ 25. يقوم مزودو الخدمة مثل AWS بحظر المنفذ 25 افتراضياً، كما أن عنوان IP جديد للإرسال بسجل تاريخي ضعيف أو معدوم يزيد من مخاطر رفض الرسائل أو تصنيفها كرسائل مزعجة (Spam). لا شيء من هذا حتمي. استخدم مرحلاً (relay) موثقاً عبر المنفذ 587، وتحقق أولاً من قواعد الصادر لدى مزودك: يقوم DigitalOcean بحظر المنافذ 25 و465 و587 على الـDroplets افتراضياً.
المسار المدعوم هو شاشة Email Account في واجهة ERPNext، والتي تخزن كلمة المرور مشفرة. يمكنك أيضاً كتابة المفاتيح في ملف إعداد الموقع (site config):
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_server smtp.example.com
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_port 587 --parse
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config use_tls 1 --parse
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_login 'erp@example.com'
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config auto_email_id 'erp@example.com'يقوم --parse بتخزين 587 كرقم بدلاً من السلسلة النصية "587". اقرأ الملف وتأكد من أن هاتين القيمتين لا تحيط بهما علامات اقتباس:
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.jsonلتخزين كلمة المرور مشفرة، قم بضبط خادم الصادر، واسم المستخدم، وكلمة المرور معاً في شاشة Email Account. حقل كلمة المرور هناك لا يضبط مفتاح إعداد الموقع mail_password المنفصل.
بعد ذلك، أرسل رسالة حقيقية. أنشئ فاتورة مبيعات (Sales Invoice)، وأرسلها بالبريد إلى عنوان تتحكم فيه، وراقب قائمة الانتظار أثناء القيام بذلك:
docker compose --project-name erpnext logs -f queue-shortالبريد الصادر هو مهمة خلفية (background job)، لذا فإن الرسالة التي لا تصل تظهر عادةً كمهمة فاشلة في ذلك السجل بدلاً من ظهور خطأ في المتصفح. انشر سجلات SPF (إطار سياسة المرسل) وDKIM (بريد محدد بمفاتيح النطاق) لنطاق الإرسال أيضاً، ثم أضف سياسة DMARC. بدون مصادقة، تخاطر الفاتورة الصحيحة تقنياً بالرفض أو التصنيف كرسائل مزعجة. إذا كنت تفضل امتلاك المسار بالكامل، فإن خادم بريد Mailcow ذاتي الاستضافة يمنحك مرحلاً تتحكم فيه، على خادم منفصل عن خادم ERP.
نسخ احتياطية يمكن استعادتها فعلياً
لا يُعد تفريغ قاعدة البيانات وحده نسخة احتياطية من ERPNext. توجد المرفقات والملفات الخاصة في دليل sites، وليس في MariaDB. إذا استعدت قاعدة البيانات فقط، فستظهر كل أوامر الشراء التي رُفعت سابقاً كروابط معطلة.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesيكتب ذلك أربعة ملفات في sites/erp.example.com/private/backups داخل وحدة التخزين sites:
- تفريغ
-database.sql.gz - أرشيف
-files.tarللملفات العامة - أرشيف
-private-files.tarللملفات الخاصة - نسخة
-site_config_backup.jsonمن إعدادات الموقع
الملف الرابع هو الذي يتخلص منه البعض، وهو الملف الذي يسبب المشكلة الأكبر. يحتوي على encryption_key، وهو المفتاح الذي يستخدمه Frappe لتشفير كلمات المرور المخزنة: بيانات اعتماد حسابات البريد الإلكتروني، ومفاتيح بوابات الدفع، وكل سر من أسرار التكاملات. إذا استعدت قاعدة البيانات من دون المفتاح المطابق، فسيُحمّل الموقع بشكل طبيعي، لكن إرسال البريد سيفشل مع:
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.jsonاحتفظ بالملفات الأربعة معاً دائماً.
ثم انقلها خارج الخادم. لا تبقى النسخة الاحتياطية الموجودة داخل وحدة التخزين بعد فقدان الخادم، كما أن bench يحذفها تلقائياً: فهو يحذف افتراضياً النسخ الاحتياطية الأقدم من 23 ساعة من ذلك الدليل. كان الإعداد الافتراضي 24 ساعة قبل Frappe 16.20.0 و15.114.0، ويتجاوزه المفتاح keep_backups_for_hours في إعدادات الموقع.
docker compose --project-name erpnext cp \
backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
~/erpnext-backupsشغّل ذلك من cron، ثم ادفع الدليل إلى مكان لا تديره أنت. تُعد نسخ restic الاحتياطية المشفّرة إلى تخزين خارج الموقع الأداة المناسبة، لأنها تشفّر البيانات قبل رفعها، ويثبت restic check أن المستودع لا يزال قابلاً للقراءة. نسخة ERP الاحتياطية هي نسخة من دفتر حساباتك بالكامل، لذلك يجب تخزينها مشفّرة وهي غير مستخدمة على أجهزة ليست هذا الخادم.
اختبر عملية الاستعادة قبل الحاجة إليها
النسخة الاحتياطية التي لم تُختبر هي مجرد تخمين. اختبر الاستعادة في موقع ثانٍ على نفس الخادم، ولا تقم بذلك أبداً في الموقع المباشر (الإنتاجي).
docker compose --project-name erpnext exec backend \
bench new-site --mariadb-user-host-login-scope=% \
--db-root-password '<your DB_PASSWORD>' \
--admin-password '<a strong admin password>' \
restore-test.example.com
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com --force restore \
sites/erp.example.com/private/backups/<stamp>-erp_example_com-database.sql.gz \
--with-public-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-files.tar \
--with-private-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-private-files.tar \
--db-root-password '<your DB_PASSWORD>'انسخ مفتاح التشفير من الإعدادات الاحتياطية إلى الموقع المستعاد، وإلا ستظل عمليات التكامل معطلة:
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'تحقق الآن من الاستعادة بأسلوب المحاسبين. افتح تقرير الذمم المدينة (Accounts Receivable) وقارن الرصيد الختامي مع الموقع المباشر. افتح فاتورة شراء حديثة وحمّل مرفقاتها. مجرد عرض صفحة تسجيل الدخول لا يثبت نجاح العملية.
احذف موقع الاختبار عند الانتهاء:
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comلماذا يُعد تثبيت الإصدار أكثر أهمية لـ ERPNext
في المواقع الثابتة، يعني استخدام وسم صورة (image tag) غير مثبت إعادة تشغيل مفاجئة. أما في ERPNext، فهذا يعني ترحيل المخطط (schema migration). يقوم bench migrate بإعادة كتابة جداول قاعدة البيانات وقد يعيد كتابة بيانات المستندات، ولا يوجد خيار للتراجع عن ذلك. التراجع يعني الاستعادة من نسخة احتياطية، وليس مجرد تنفيذ docker compose down.
لذا، ثبّت الوسم. كان ERPNEXT_VERSION=v16.32.1 هو الإصدار المثبت في pwd.yml الخاص بالمستودع في أغسطس 2026. في 2026-11-16، قام كل من pwd.yml وexample.env بتثبيت v16.55.0. لا تنقل أي رقم منهما إلى إصدار لاحق دون التحقق منه. الإصدارات الحالية مدرجة في صفحة إصدارات frappe/erpnext، وتوجد وسوم الصور المتاحة على Docker Hub. اقرأ ملاحظات الإصدار الذي تنتقل إليه قبل البدء.
تبدأ عملية الترقية نفسها بأخذ نسخة احتياطية وتفعيل وضع الصيانة.
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-files
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-maintenance-mode onعدّل ERPNEXT_VERSION في ~/gitops/erpnext.env، ثم قم بتنفيذ التوليد (render) والسحب (pull) والترحيل (migrate).
docker compose --project-name erpnext \
--env-file ~/gitops/erpnext.env \
-f compose.yaml \
-f overrides/compose.mariadb.yaml \
-f overrides/compose.redis.yaml \
-f overrides/compose.https.yaml \
config > ~/gitops/erpnext.yaml
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml pull
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d
docker compose --project-name erpnext exec backend \
bench --site erp.example.com migrate
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-maintenance-mode offيُعد وضع الصيانة مهماً لأن migrate يغير المخطط أثناء عمله. قيام مستخدم بإرسال مستند إلى جدول في منتصف عملية الترحيل هو السبب الذي سيضطرك لإصلاح السجلات يدوياً.
انتقل إصداراً رئيسياً واحداً في كل مرة، مع أخذ نسخة احتياطية بين كل خطوة. راجع إرشادات الترحيل لكل إصدار رئيسي قبل المتابعة.
يوفر المستودع أيضاً overrides/compose.migrator.yaml، الذي يضيف حاوية تشغل bench --site all migrate عند البدء إذا كانت المواقع موجودة وكان MIGRATE_SITES مفعلاً، وهو الوضع الافتراضي. هذا مريح، ولكنه يعني أيضاً أن تنفيذ docker compose up مع تغيير الوسم سيؤدي إلى ترحيل قاعدة بيانات الإنتاج دون مراقبة. في أنظمة الأعمال، اجعل تنفيذ الترحيل قراراً تتخذه بنفسك في ذلك الصباح.
تأمين خادم يحتوي على سجلات العملاء
غيّر كلمة مرور المسؤول عند تسجيل الدخول لأول مرة. ملف الـ compose المخصص للتقييم يشحن admin ككلمة مرور افتراضية، وغالباً ما ينقل المستخدمون هذه العادة إلى بيئة الإنتاج.
غيّر DB_PASSWORD بعيداً عن القيمة 123 الموجودة في example.env. تنتهي هذه القيمة في ملف ~/gitops/erpnext.yaml المُنشأ كنص صريح، لذا قم بـ chmod 600 الملف وأبقِه خارج أي مستودع git. للحصول على خيار أقوى، يقرأ overrides/compose.mariadb-secrets.yaml كلمة المرور من ملف أسرار Docker بدلاً من متغير بيئة. يغطي الرابط التعامل مع ملفات البيئة والأسرار في Docker Compose المقايضات في هذا الشأن.
انشر فقط ما تحتاجه. مع تجاوز HTTPS، يكون المنفذان 80 و443 هما الوحيدان المكشوفان. لا تضف تعيين ports لخدمة db لتسهيل اتصال عميل قاعدة البيانات: فهذا يضع MariaDB على الإنترنت العام. استخدم docker compose --project-name erpnext exec backend bench mariadb بدلاً من ذلك. على المضيف، اسمح بالمنفذين 22 و80 و443، واحظر البقية، وتحقق أيضاً من جدار حماية الشبكة المنفصل الخاص بمزود الخدمة.
فعّل المصادقة الثنائية في إعدادات النظام (System Settings) لكل حساب يحمل دور مدير النظام (System Manager). يمكن لهذا الدور تغيير إعدادات النظام، لذا تعامل معه كحساب مسؤول وليس كخيار للراحة. إذا كنت تشغل عدة تطبيقات ذاتية الاستضافة، فإن استخدام Authentik كمزود تسجيل دخول موحد ذاتي الاستضافة أفضل من إضافة كلمة مرور أخرى لكل تطبيق.
طبّق التحديثات الأمنية على المضيف وأعد التشغيل لتحديثات النواة (kernel). قبل الاعتماد على عودة الحزمة (stack) للعمل، تحقق من الملف المُنشأ بحثاً عن سياسة restart لكل خدمة، لأن الحزمة التي تفتقر إليها ستظل متوقفة بعد إعادة التشغيل. يغطي الرابط جعل حزمة Docker Compose تبدأ تلقائياً بعد إعادة التشغيل جانب systemd.
عندما لا يعود ERPNext مناسباً لخادم VPS واحد
يعمل خادم VPS واحد على خدمة شركة صغيرة لفترة طويلة. إليك مؤشرات عدم كفايته:
- تتراكم مهام الخلفية، مما يؤدي إلى تأخر وصول رسائل البريد الإلكتروني وعمليات الاستيراد لدقائق أو ساعات.
- تُبلغ
docker inspectعن حاويات بها"OOMKilled": trueأو رمز الخروج 137. - التقارير التي كانت تستغرق ثانيتين أصبحت تستغرق ثلاثين ثانية، وMariaDB هي العملية التي تستهلك المعالج.
- تستغرق النسخ الاحتياطية وقتاً طويلاً لدرجة تداخلها مع موعد التشغيل التالي المجدول.
ابدأ بمنح MariaDB موارد خاصة بها لا تشاركها مع غيرها، لأن قاعدة البيانات وعمال Python يتنافسون على نفس الذاكرة، وbuffer pool هو الجزء الذي يحتاج إلى المزيد منها. زيادة حجم خادم التطبيقات تساعد أقل مما يتوقع الناس. يغطي تشغيل قاعدة البيانات في Docker أو على المضيف هذا القرار، ويساعد ضبط حدود الذاكرة في Docker Compose في منع حاوية واحدة من استنزاف الموارد عن الأخريات أثناء قيامك بذلك.
بعد ذلك، أضف عمال طابور (queue workers) بدلاً من زيادة سعة الويب. العمل البطيء في ERPNext هو عمل الخلفية: إنشاء التقارير وعمليات الاستيراد الضخمة. يحتاج المزيد من العمال إلى مساحة إضافية في المعالج والذاكرة؛ إضافة حاويات إلى خادم VPS مشبع بالفعل لا يضيف سعة حقيقية.
FAQ
ما مقدار ذاكرة الوصول العشوائي (RAM) التي يحتاجها ERPNext على خادم VPS؟
للتقييم، ابدأ بـ 4 جيجابايت مع 2 وحدة معالجة مركزية افتراضية (vCPU). بالنسبة لشركة تستخدمه يومياً، خطط لـ 8 جيجابايت و 4 وحدة معالجة مركزية افتراضية مع 100 جيجابايت من مساحة SSD. تحت ضغط الذاكرة، قد يقوم نظام التشغيل بإنهاء الحاويات عبر أداة out of memory killer، وهو ما يبلّغ عنه docker inspect كـ "OOMKilled": true مع رمز الخروج 137. هذه نقاط بداية وليست قياسات نهائية، لذا راقب استهلاك الذاكرة الخاص بك خلال الشهر الأول.
هل يمكنني تشغيل pwd.yml في بيئة الإنتاج؟
لا. يصف ملف README الخاص بالمشروع هذا الملف بأنّه مخصص للتقييم قصير الأمد فقط، ويشير إلى أنّه لا يمكنك تثبيت تطبيقات مخصصة فيه. استخدم compose.yaml مع تجاوزات (overrides) MariaDB و Redis و HTTPS، ثم ادمجها في ملف واحد باستخدام docker compose config، وقم بتشغيل ذلك الملف.
لماذا لا يمكن الوصول إلى موقع ERPNext الخاص بي فور إنشائه؟
تختار الواجهة الأمامية الموقع الذي يجب تقديمه بناءً على ترويسة HTTP Host افتراضياً، لذا يجب أن يطابق اسم الموقع النطاق (domain) في المتصفح. الموقع الذي يتم إنشاؤه باسم erpnext لا يتم تقديمه عند erp.example.com. إما أن تنشئ الموقع باستخدام النطاق كاسم له، أو اضبط FRAPPE_SITE_NAME_HEADER في ملف البيئة (env file) على اسم الموقع، ثم أعد إنشاء ملف compose وأعد تشغيل الحزمة (stack).
ما الذي يجب أن يتضمنه النسخ الاحتياطي لـ ERPNext؟
أربعة ملفات محفوظة معاً: تفريغ قاعدة البيانات -database.sql.gz، وأرشيفات -files.tar و -private-files.tar، ونسخة إعدادات -site_config_backup.json. يؤدي تشغيل bench --site erp.example.com backup --with-files إلى إنتاج الملفات الأربعة جميعها. تحتوي نسخة الإعدادات على encryption_key، لذا فإن الاستعادة بدونها تجعل كلمات مرور التكامل المخزنة غير قابلة لفك التشفير، وهو ما يظهر كـ Encryption key is invalid! Please check site_config.json.
كيف أقوم بترقية ERPNext دون إتلاف بياناتي؟
قم بإجراء نسخ احتياطي باستخدام --with-files، وفعّل وضع الصيانة، وغيّر ERPNEXT_VERSION في ملف البيئة الخاص بك، وأعد إنشاء ملف compose، ثم اسحب التحديثات (pull)، وشغّل الحزمة، ثم نفّذ bench --site erp.example.com migrate وأوقف وضع الصيانة. انتقل إصداراً رئيسياً واحداً في كل مرة واقرأ ملاحظات الإصدار أولاً، لأن migrate يعيد كتابة المخطط (schema) وبيانات المستندات دون إمكانية التراجع. التراجع يعني استعادة النسخة الاحتياطية التي أخذتها في البداية.