🏢 تثبيت InvenTree — إدارة مخزون مفتوحة المصدر

انشر InvenTree على Ubuntu — نظام إدارة قطع ومخزون مفتوح المصدر مع PostgreSQL وRedis، مبني لتتبع المخزون وقوائم المواد والموردين وأوامر الشراء.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر InvenTree مع PostgreSQL وRedis وعامل خلفي على المنفذ 8152.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/erp/inventree/inventree-ubuntu.sh
chmod +x inventree-ubuntu.sh
sudo bash inventree-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/erp/inventree/inventree-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x inventree-ubuntu.sh

3 تشغيل المثبت

يثبّت السكريبت Docker إن لزم، يُشغّل حاويتي PostgreSQL 15 وRedis 7 بالإضافة إلى عامل خلفي، ثم يُطلق InvenTree على المنفذ 8152. اسم مستخدم المسؤول هو admin وتُولَّد كلمة مرور عشوائية وتُطبع في النهاية.

sudo bash inventree-ubuntu.sh

4 تسجيل الدخول إلى واجهة الويب

افتح المتصفح وانتقل إلى InvenTree، ثم سجّل الدخول بـ admin وكلمة المرور المُولّدة:

http://<your-server-ip>:8152

المنافذ المستخدمة

المنفذالغرض
8152Web UI + REST API (host → container 8000)
internalPostgreSQL 15 + Redis 7 + worker (not published)

نظرة عامة

InvenTree نظام إدارة مخزون مجاني ومفتوح المصدر لتتبع القطع المادية والمخزون، مبني بلغة Python وإطار Django على قاعدة بيانات PostgreSQL. يتعامل مع القطع والفئات ومواقع المخزون وقوائم المواد (BOM) والموردين وأوامر الشراء في نظام واحد مترابط، ليحل محل جداول البيانات التي يبدأ بها معظم المصنّعين الصغار والمختبرات والمساحات الصانعة ثم يتجاوزونها. واجهة REST API ونظام إضافات يجعلانه قابلاً للتوسيع، وتعمل المهام طويلة الأمد مثل طباعة الملصقات وتوليد التقارير عبر عامل خلفي مدعوم بـ Redis حتى تبقى واجهة الويب سريعة الاستجابة.

لماذا تستخدمه

يبدأ معظم الفرق الصغيرة بتتبع القطع والمخزون في جدول بيانات، وينجح ذلك — حتى يحتاج عدة أشخاص تعديله في وقت واحد، أو تنحرف أعداد المخزون عن الواقع، أو تحتاج معرفة فورية إن كان لديك ما يكفي من المكونات لبناء الدفعة التالية من تجميعة. يحل InvenTree هذا بمنح كل قطعة سجلاً مرجعياً بمستويات مخزون فورية عبر مواقع متعددة، وربط القطع في قوائم مواد بحيث تُظهر التجميعات تلقائياً ما هو مطلوب وما هو متوفر، وتتبع الموردين وأوامر الشراء بحيث تكون إعادة التخزين مُخطَّطة لا رد فعل. وكونه ذاتي الاستضافة ومُرخَّصاً بـ MIT، فهو لا يكلّف شيئاً للتشغيل، ويحافظ على خصوصية أسعار موردك وبيانات مخزونك، ويمكن توسيعه بإضافات مخصصة أو دمجه في أنظمة أخرى عبر واجهة REST API.

متى تحتاجه

  • تجاوز فريقك جدول بيانات مشترك لتتبع القطع ومستويات المخزون والمواقع، وأصبحت الأخطاء أو تعارضات النسخ شائعة
  • تبني تجميعات من قطع مكونة وتحتاج معرفة فورية بما هو متوفر من مخزون قبل بدء بناء
  • تدير مساحة صانعة أو مختبراً أو عملية تصنيع صغيرة بقطع موزعة عبر أرفف أو صناديق أو مواقع متعددة
  • تحتاج تتبع أوامر الشراء وتاريخ أسعار الموردين جنباً إلى جنب مع مخزونك بدلاً من مستندات منفصلة
  • تريد بديلاً مجانياً ذاتي الاستضافة لمنصات SaaS مدفوعة لإدارة المخزون أو التصنيع الخفيف
  • تحتاج تكاملاً مع أنظمة أخرى وتريد واجهة REST API ونظام إضافات بدلاً من أداة مغلقة احتكارية

من يحتاجه

  • مصنّعو الإلكترونيات والأجهزة الصغار الذين يحتاجون تتبع قوائم المواد مرتبطة مباشرة بمستويات مخزون حية
  • المساحات الصانعة وورش الهواة التي تدير مكونات مشتركة بين أعضاء ومشاريع متعددة
  • مختبرات البحث والنمذجة الأولية التي تتتبع قطعاً استهلاكية وغير استهلاكية عبر مواقع تخزين متعددة
  • الشركات الصغيرة التي تجاوزت جداول البيانات لكنها لا تريد تكلفة أو تعقيد نظام ERP كامل
  • المطورون والمتكاملون الذين يريدون بناء تدفقات عمل مخصصة فوق واجهة REST API ونظام الإضافات في InvenTree
  • عشاق الاستضافة الذاتية الذين يريدون ملكية كاملة لبيانات مورديهم ومخزونهم بدلاً من اشتراك سحابي SaaS

حالات الاستخدام الشائعة

  • تتبع القطع وكميات المخزون عبر مواقع تخزين مادية متعددة في الوقت الفعلي
  • بناء قائمة مواد لتجميعة وترك InvenTree يتتبع استهلاك المكونات أثناء البناء
  • إدارة أوامر الشراء وتاريخ أسعار الموردين لتخطيط إعادة التخزين قبل النفاد
  • توليد وطباعة ملصقات المخزون والقطع للصناديق والأرفف والمكونات المادية
  • منح أعضاء الفريق وصولاً قائماً على الأدوار بحيث يستطيع فقط المستخدمون المصرَّح لهم تعديل المخزون أو اعتماد الطلبات
  • دمج InvenTree مع أدوات أخرى عبر واجهة REST API الخاصة به، مثل ربطه بنظام تنفيذ تصنيع أو محاسبة

الميزات الرئيسية

  • إدارة القطع والفئات بحقول مخصصة ومعاملات ومرفقات لأوراق البيانات أو التوثيق
  • تتبع مخزون فوري عبر مواقع متعددة مع سجل كامل لحركة المخزون
  • دعم قوائم المواد (BOM) التي تربط التجميعات بالقطع المكونة وتستهلك المخزون تلقائياً عند البناء
  • إدارة قطع الموردين والمصنّعين بتاريخ أسعار وتتبع أوامر شراء
  • عامل خلفي للمهام طويلة الأمد مثل طباعة الملصقات وتوليد التقارير والإشعارات المجدولة
  • واجهة REST API لدمج InvenTree مع أنظمة خارجية أو بناء تطبيقات مخصصة
  • نظام إضافات لتوسيع الوظائف بمنطق مخصص وماسحات باركود وتكاملات طرف ثالث
  • صلاحيات مستخدمين قائمة على الأدوار بحيث تتحكم في من يستطيع عرض أو تعديل أو اعتماد المخزون والطلبات

كيفية الاستخدام بعد التثبيت

  • سجّل الدخول باسم المستخدم admin وكلمة المرور العشوائية المطبوعة في نهاية سكريبت التثبيت (تظهر أيضاً عبر docker logs inventree)
  • غيّر كلمة مرور المسؤول فوراً وأنشئ حسابات فردية لأعضاء الفريق الآخرين بدلاً من مشاركة تسجيل دخول المسؤول
  • أعدّ فئات القطع ومواقع المخزون أولاً، لأن القطع وقوائم المواد مُنظَّمة حول هذا الهيكل
  • أضف قطعك بتفاصيلها الرئيسية — المورد والسعر وأي معاملات مخصصة ذات صلة بتدفق عملك
  • ابنِ أول قائمة مواد لك بربط قطعة تجميعة بقطعها المكونة والكميات المطلوبة
  • اضبط إعدادات العامل الخلفي إذا كنت تخطط لاستخدام المهام المجدولة أو الإشعارات أو طباعة الملصقات
  • استكشف نظام الإضافات إذا احتجت مسح باركود أو تقارير مخصصة أو تكاملاً مع أدوات خارجية

أفضل ممارسات الأمان

  • غيّر كلمة مرور المسؤول العشوائية فوراً بعد أول تسجيل دخول واحفظها في مدير كلمات مرور
  • ضع InvenTree خلف وكيل عكسي مع HTTPS قبل السماح بأي وصول خارج شبكتك المحلية
  • لا تكشف المنفذ 8152 مباشرة للإنترنت بدون TLS — بيانات تسجيل الدخول وبيانات المخزون/الأسعار ستنتقل بدون تشفير
  • أنشئ حسابات مستخدمين فردية بصلاحيات قائمة على الأدوار مناسبة بدلاً من مشاركة تسجيل دخول المسؤول عبر الفريق
  • أبقِ PostgreSQL وRedis معزولين على شبكة Docker الداخلية — يجب ألا يُنشرا أبداً للمضيف أو الإنترنت
  • حافظ على تحديث صورة InvenTree Docker لتلقي التصحيحات الأمنية، خاصة أنه يتعامل مع بيانات موردين وأسعار
  • راجع الإضافات المثبتة بعناية قبل تفعيلها، لأن الإضافات تعمل بنفس صلاحيات وصول التطبيق الأساسي

المنافذ وإعدادات جدار الحماية

تُقدَّم واجهة InvenTree وREST API على المنفذ 8152 على المضيف، المعيّن من منفذ الحاوية الداخلي 8000. تعمل PostgreSQL 15 وRedis 7، جنباً إلى جنب مع العامل الخلفي، كخدمات داخلية على شبكة Docker ولا تُنشر إلى المضيف، لذا فهي غير قابلة للوصول من خارج شبكة Docker افتراضياً. يجب عدم كشف المنفذ 8152 مباشرة للإنترنت العام بدون وكيل عكسي يضيف تشفير TLS، وإلا فإن بيانات تسجيل الدخول وبيانات المخزون والأسعار والموردين الحساسة ستنتقل بنص عادي HTTP. إذا احتجت وصولاً عن بُعد لفريق موزّع، ضع InvenTree خلف Nginx Proxy Manager أو وكيل عكسي مماثل على المنفذ 443 مع شهادة صالحة، وقيّد الوصول المباشر للمنفذ 8152 على شبكتك المحلية أو عبر VPN.

النسخ الاحتياطي والصيانة

  • احفظ نسخة احتياطية من حجم قاعدة بيانات PostgreSQL، الذي يخزن كل القطع ومستويات المخزون وقوائم المواد والموردين وتاريخ أوامر الشراء
  • احفظ نسخة احتياطية من حجم الوسائط/المرفقات بشكل منفصل، لأنه يحتفظ بأوراق البيانات المرفوعة والصور والمستندات المرتبطة بالقطع
  • احفظ نسخة من docker-compose.yml وأي إعدادات بيئة حتى يمكن إعادة إنشاء المكدس بشكل مطابق
  • جدول تفريغات PostgreSQL تلقائية بدلاً من الاعتماد على نسخ احتياطية يدوية، خاصة بمجرد استخدام بيانات المخزون فعلياً للعمليات
  • خزّن النسخ الاحتياطية خارج سيرفر المضيف حتى لا يستطيع فشل قرص واحد تدمير بيانات مخزونك الحية ونسختها الاحتياطية معاً
  • اختبر عملية الاستعادة دورياً باستعادة نسخة احتياطية على نسخة منفصلة والتأكد أن أعداد المخزون وقوائم المواد متطابقة

الأخطاء الشائعة

  • أخذ نسخة احتياطية من قاعدة البيانات فقط ونسيان حجم الوسائط/المرفقات، مما يفقد أوراق البيانات وصور القطع المرتبطة عند الاستعادة
  • عدم تغيير كلمة مرور المسؤول العشوائية بعد التثبيت أبداً، مما يترك بيانات اعتماد بنمط افتراضي
  • كشف المنفذ 8152 مباشرة للإنترنت بدون وكيل عكسي وTLS، مما يرسل بيانات الاعتماد والأسعار كنص عادي
  • مشاركة حساب المسؤول الواحد عبر الفريق بالكامل بدلاً من إنشاء حسابات فردية بصلاحيات محددة
  • تخطي هيكل الفئات والمواقع وإلقاء كل القطع في قائمة مسطحة واحدة، مما يجعل النظام صعب التصفح مع نموه
  • عدم ربط أوامر الشراء بسجلات موردين حقيقية، مما يفقد تاريخ الأسعار الذي يسهّل قرارات إعادة التخزين

استكشاف الأخطاء وإصلاحها

  • تعذر الوصول لواجهة الويب — تأكد أن جميع الحاويات تعمل بأمر docker ps وتحقق أن المنفذ 8152 غير محظور بجدار حماية المضيف
  • فشل تسجيل الدخول بكلمة المرور المُولّدة — استرجعها مرة أخرى بأمر docker logs inventree، لأنها تُطبع مرة واحدة فقط أثناء الإعداد الأولي
  • المهام الخلفية مثل طباعة الملصقات أو التقارير لا تكتمل أبداً — تحقق أن حاوية العامل تعمل وتستطيع الوصول لحاوية Redis
  • أعداد المخزون تبدو خاطئة بعد بناء — تحقق من كميات قائمة المواد وتأكد أن أمر البناء استهلك مخزون المكونات المتوقع بشكل صحيح
  • أخطاء اتصال بقاعدة البيانات عند التشغيل — تأكد أن حاوية PostgreSQL سليمة وأن متغيرات بيئة قاعدة البيانات متطابقة بين الحاويات
  • أداء بطيء مع كتالوج قطع كبير — تحقق من تخصيص موارد PostgreSQL وفكّر في زيادة حدود ذاكرة الحاوية

البدائل

ERPNext وOdoo مجموعتا ERP كاملتان تتضمنان إدارة مخزون إلى جانب وحدات محاسبة ومبيعات وتصنيع — أقوى إذا احتجت نظام أعمال كاملاً، لكنهما أثقل بكثير في النشر والتعلّم من نطاق InvenTree المركّز. Snipe-IT مصمم لتتبع أصول تقنية المعلومات وليس القطع والمخزون للتصنيع، لذا يناسب حالة استخدام مختلفة رغم بعض التشابه السطحي. PartKeepr أداة أقدم مشابهة مفتوحة المصدر لمخزون القطع لكنها شهدت تطويراً نشطاً أقل بكثير في السنوات الأخيرة مقارنة بـ InvenTree. للفرق التي تحتاج تحديداً تتبع القطع وقوائم المواد والمخزون دون تبني نظام ERP كامل، يبقى InvenTree من أكثر الخيارات مفتوحة المصدر نشاطاً وتركيزاً.

متى لا تستخدمه

InvenTree مصمم خصيصاً لتتبع القطع والمخزون — إذا احتجت وظائف محاسبة أو مبيعات أو موارد بشرية أو CRM كاملة إلى جانب المخزون، فنظام ERP كامل مثل ERPNext أو Odoo سيوفّر عليك ربط أنظمة منفصلة معاً. كما أنه مبالغ فيه لمجموعة شخصية صغيرة جداً بعدد قليل من العناصر؛ جدول بيانات بسيط لا يزال معقولاً تماماً حتى تكون لديك احتياجات حقيقية متعددة المستخدمين أو تتبع قوائم مواد. يتطلب InvenTree تشغيل وصيانة PostgreSQL وRedis وعامل خلفي، لذا إذا لم تستطع الالتزام بصيانة استضافة ذاتية أساسية، فتطبيق مخزون سحابي خفيف قد يناسبك أكثر رغم تكلفة الاشتراك. وإذا كانت حاجتك الأساسية هي تتبع أصول تقنية المعلومات (أجهزة لابتوب، تراخيص، ضمانات) بدلاً من قطع وتصنيع، فأداة مخصصة مثل Snipe-IT ستتماشى بشكل أطبع مع ذلك التدفق.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

لماذا يُستخدم InvenTree؟

InvenTree نظام إدارة مخزون لتتبع القطع والمخزون المادي. يتعامل مع القطع والفئات ومواقع المخزون وقوائم المواد والموردين وأوامر الشراء، مثالي للمساحات الصانعة والمختبرات والمصنّعين الصغار الذين تجاوزوا جداول البيانات.

لماذا يحتاج InvenTree إلى Redis وحاوية عامل؟

يُحوّل InvenTree المهام طويلة الأمد — طباعة الملصقات وتوليد التقارير والإشعارات والمهام المجدولة — إلى عامل خلفي يستخدم Redis كطابور مهام. تتعامل حاوية الويب مع الطلبات بينما يعالج العامل هذه المهام، لذا يجب أن يعمل كلاهما ويتشاركا نفس نسخة Redis.

على أي منفذ يعمل InvenTree؟

يُعيّن سكريبت التثبيت المنفذ 8152 على المضيف إلى المنفذ الداخلي 8000 في الحاوية، لذا تصل لواجهة الويب على http://your-server-ip:8152. تبقى خدمتا PostgreSQL وRedis على الشبكة الداخلية ولا تُنشران.

ما بيانات الدخول الافتراضية؟

اسم المستخدم هو admin وكلمة المرور تُولَّد عشوائياً بواسطة سكريبت التثبيت وتُطبع في نهاية التشغيل، وتظهر أيضاً عبر docker logs inventree. بريد المسؤول الافتراضي هو admin@localhost.local.

هل يمكن لـ InvenTree التعامل مع قوائم المواد؟

نعم. تُعرّف قطعة تجميعة وتُدرج قطعها المكونة بكمياتها. عندما تبني التجميعة، يتتبع InvenTree استهلاك كل مكون من المخزون، وهذا أمر أساسي لاستخدامه في التصنيع صغير النطاق.