🛒 تثبيت Grocy — نظام ERP ذاتي الاستضافة لإدارة المشتريات والمنزل
انشر Grocy على Ubuntu بـ Docker — نظام ERP ذاتي الاستضافة لمطبخك يتتبع المشتريات والمخزون وتواريخ الصلاحية وقوائم التسوق والوصفات والمهام المنزلية.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/grocy/grocy-ubuntu.sh
chmod +x grocy-ubuntu.sh
sudo bash grocy-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/grocy/grocy-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x grocy-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم، يسحب صورة Grocy من LinuxServer، ويُشغّلها على المنفذ 9283 مع مجلد ./config دائم يحتوي قاعدة بيانات SQLite.
sudo bash grocy-ubuntu.sh
4 الدخول إلى واجهة الويب
افتح المتصفح وانتقل إلى Grocy، ثم سجّل الدخول ببيانات الاعتماد الافتراضية admin / admin وغيّر كلمة المرور فوراً:
http://<your-server-ip>:9283
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 9283 | Web UI + REST API (host → container 80) |
نظرة عامة
Grocy تطبيق ذاتي الاستضافة بأسلوب أنظمة تخطيط موارد المؤسسات (ERP)، لكن مُوجَّه لإدارة المنزل. يمركز مخزون المشتريات والمستهلكات، تتبع تواريخ الصلاحية، توليد قوائم التسوق تلقائياً، إدارة الوصفات مع خصم المكونات من المخزون، جدولة المهام المنزلية، وتتبع الأجهزة والبطاريات. مبني بلغة PHP مع قاعدة بيانات SQLite خفيفة، ويوزَّع كصورة Docker جاهزة عبر مشروع LinuxServer.io.
لماذا تستخدمه
يقلّل Grocy هدر الطعام عبر تتبع تواريخ الصلاحية وتنبيهك قبل فساد المنتجات. يولّد قوائم التسوق تلقائياً من العناصر التي أوشكت على النفاد أو نفدت، ويدعم مسح الباركود عبر تطبيقات الجوال المرافقة لإدخال سريع عند تخزين المشتريات أو استهلاكها. يجمع مخزون المشتريات والوصفات وتخطيط الوجبات والمهام المنزلية في واجهة واحدة يمكن الوصول إليها من أي جهاز، دون اشتراكات أو إعلانات أو مشاركة بياناتك مع طرف ثالث.
متى تحتاجه
- تريد تقليل هدر الطعام عبر تتبع تواريخ الصلاحية وتلقي تنبيهات قبل فساد المنتجات
- سئمت من إدارة قوائم التسوق يدوياً وتريدها تُولَّد تلقائياً من العناصر التي أوشكت على النفاد
- تريد تتبع مخزون منزلي يتجاوز الطعام — بطاريات، مستلزمات تنظيف، أدوات نظافة شخصية — مع مستويات مخزون وحدود لإعادة الطلب
- تطبخ بانتظام وتريد ربط الوصفات بمخزونك بحيث تُخصم المكونات تلقائياً عند الطبخ
- منزلك يشارك فيه عدة أفراد المهام المنزلية وتحتاج جدولاً دورياً عادلاً مع تذكيرات
- تريد مسح الباركود لإدخال سريع عند تخزين المشتريات أو استهلاك العناصر
- تبحث عن بديل مجاني وذاتي الاستضافة لتطبيقات استهلاكية مثل Out of Milk أو Bring! بدون إعلانات أو اشتراكات
من يحتاجه
- الأسر والعائلات التي تريد تقليل هدر الطعام وإدارة مخزون مشتريات مشترك
- الطهاة المنزليون الذين يخططون وجباتهم حسب المتوفر في المخزون ويريدون خصم المكونات تلقائياً
- من يدير ميزانية المنزل ويريد رؤية واضحة لأنماط الاستهلاك وتكاليف التسوق
- من يخزّن كميات كبيرة ويتتبع المخزون عبر المخزن والفريزر والمرآب أو القبو
- زملاء السكن والمنازل المشتركة التي تحتاج نظام تدوير عادل وواضح للمهام المنزلية
- عشاق الاستضافة الذاتية الذين يريدون تطبيقاً عملياً للاستخدام اليومي يتجاوز خوادم الوسائط
- من يتتبع مستلزمات غير غذائية — منتجات تنظيف، أدوات عناية شخصية، مستلزمات حيوانات أليفة، بطاريات
- من يدير مهاماً دورية مرتبطة بالأجهزة، مثل استبدال الفلاتر أو جداول الصيانة
حالات الاستخدام الشائعة
- تتبع مخزون المشتريات وتلقي تنبيهات قبل انتهاء الصلاحية حتى لا يُهدر شيء
- توليد قائمة تسوق تلقائياً عند انخفاض المخزون عن الحد الأدنى المحدد
- تخطيط الوجبات عبر وحدة الوصفات التي تخصم المكونات من المخزون عند استهلاك الوصفة
- مسح الباركود بتطبيق الجوال المرافق لإضافة أو استهلاك العناصر بسرعة
- تدوير المهام المنزلية بعدل بين أفراد الأسرة أو زملاء السكن مع مواعيد استحقاق وتذكيرات
- تتبع البطاريات وحالة شحنها عبر جميع الأجهزة المنزلية التي تعمل بالبطاريات
الميزات الرئيسية
- إدارة مخزون مع تواريخ الصلاحية ووحدات الكمية وكشف تلقائي لانخفاض المخزون
- قائمة تسوق تُملأ تلقائياً من العناصر التي انخفضت عن الحد الأدنى ويمكن مشاركتها مع أفراد المنزل
- إدارة وصفات مع خصم المخزون حسب المكونات وعرض "ماذا يمكنني أن أطبخ" حسب المتوفر
- تقويم تخطيط وجبات مرتبط مباشرة بمكتبة الوصفات ومستويات المخزون
- تتبع المهام المنزلية مع تدوير قابل للتخصيص ومواعيد استحقاق وتوزيع على أفراد المنزل
- تتبع البطاريات مع دورات الشحن وتذكيرات للأجهزة التي تعمل بالبطاريات
- دعم مسح الباركود عبر تطبيقات Android وiOS المرافقة وخدمة بحث عن الباركود
- واجهة برمجة REST API للتكامل مع ماسحات الباركود وHome Assistant والأتمتة المخصصة
- دعم متعدد المستخدمين مع صلاحيات فردية لأفراد المنزل
كيفية الاستخدام بعد التثبيت
- سجّل الدخول ببيانات الاعتماد الافتراضية admin/admin وغيّر كلمة المرور فوراً من Manage Users
- اضبط Settings → General لتحديد العملة وتنسيق التاريخ ووحدة الكمية الافتراضية
- أضف المنتجات من Master Data → Products، محدداً كمية المخزون والحد الأدنى وتاريخ الصلاحية الافتراضي
- أضف المواقع (مثل الثلاجة، المخزن، الفريزر) ووحدات الكمية لتطابق طريقة تخزينك الفعلية
- استخدم إجراءات الشراء والاستهلاك (أو ماسح الباركود) للحفاظ على دقة مستويات المخزون يومياً
- أضف الوصفات من Master Data → Recipes، واربط كل مكوّن بمنتج فعلي حتى يُخصم المخزون تلقائياً عند الاستهلاك
- فعّل قائمة التسوق وراجعها قبل رحلات الشراء — تُملأ تلقائياً من المنتجات المنخفضة أو الناقصة
- ثبّت تطبيق الجوال المرافق واربطه بعنوان HTTPS الخاص بسيرفرك لمسح الباركود أثناء التنقل
أفضل ممارسات الأمان
- غيّر كلمة مرور admin/admin الافتراضية فور تسجيل الدخول الأول — هذه أهم خطوة على الإطلاق
- ضع Grocy خلف وكيل عكسي مع HTTPS/TLS قبل ربط تطبيق الجوال، لأن مسح الباركود يتطلب اتصالاً آمناً
- لا تكشف المنفذ 9283 مباشرة للإنترنت — قيّد الوصول على شبكتك المحلية أو VPN
- أنشئ حسابات مستخدمين منفصلة بصلاحيات محدودة لأفراد المنزل بدلاً من مشاركة حساب المسؤول
- حافظ على تحديث صورة Grocy من LinuxServer لتحصل على تصحيحات الأمان
- قيّد الوصول عبر SSH إلى السيرفر المُشغِّل لـ Grocy لأن قاعدة بيانات SQLite لا تملك تشفيراً مدمجاً أثناء التخزين
- انسخ مجلد ./config احتياطياً بانتظام لأنه يحتوي قاعدة البيانات بالكامل ومفاتيح API
- أعد توليد مفاتيح API من Settings → API keys إذا اشتبهت بتسريب أحدها
المنافذ وإعدادات جدار الحماية
يربط نشر Grocy عبر Docker منفذ المضيف 9283 بالمنفذ الداخلي 80 للحاوية، الذي يخدم واجهة الويب وواجهة REST API التي يستخدمها تطبيق الجوال وإضافة المتصفح. لا يوجد منفذ منفصل لقاعدة البيانات لأن Grocy يستخدم SQLite المدمجة بدلاً من خادم قاعدة بيانات شبكي. يجب ألا يُكشف المنفذ 9283 مباشرة للإنترنت — ضعه خلف وكيل عكسي مثل Nginx Proxy Manager مع شهادة TLS صالحة، لأن تطبيقات الجوال المرافقة عادة تتطلب HTTPS للعمل بشكل صحيح. إذا كنت تحتاج وصولاً محلياً فقط، أبقِ المنفذ مغلقاً في الجدار الناري واعتمد على شبكتك المحلية أو VPN مثل WireGuard.
النسخ الاحتياطي والصيانة
- انسخ مجلد ./config بالكامل احتياطياً، فهو يحتوي grocy.db (قاعدة بيانات SQLite) والملفات المرفوعة والإعدادات
- أوقف الحاوية أو استخدم آلية النسخ الاحتياطي المدمجة في SQLite قبل نسخ ملف قاعدة البيانات لتجنب نسخة تالفة أثناء الكتابة
- جدول نسخاً احتياطية تلقائية لمجلد ./config عبر مهمة cron أو أداة مثل Duplicati تستهدف مضيف Docker
- احتفظ بنسخة من docker-compose.yml أو أمر التشغيل لتتمكن من إعادة إنشاء الحاوية بنفس الإعدادات بعد ترحيل السيرفر
- اختبر الاستعادة دورياً باستعادة ./config إلى حاوية تجريبية والتأكد من ظهور المنتجات والمخزون والوصفات بشكل صحيح
- صدّر بيانات المنتجات والمخزون دورياً عبر تصدير CSV/JSON المدمج في Grocy كصيغة احتياطية إضافية قابلة للنقل
- حدّث صورة LinuxServer دورياً وراجع سجل تغييرات Grocy بحثاً عن ترحيلات قاعدة بيانات جذرية قبل القفزات الكبيرة بين الإصدارات
الأخطاء الشائعة
- ترك بيانات الاعتماد الافتراضية admin/admin دون تغيير، خاصة عند كشف السيرفر عبر تطبيق الجوال أو الوكيل العكسي
- عدم ضبط الحد الأدنى للمخزون على المنتجات، مما يُعطّل ميزة قائمة التسوق التلقائية
- تخطي إعداد وحدات الكمية والمواقع، مما يؤدي لإدخالات مخزون غير متسقة يصعب تسويتها لاحقاً
- نسيان تسجيل العناصر المفتوحة أو المشتراة بشكل صحيح، مما يجعل أعداد المخزون تنحرف عمّا هو موجود فعلياً في المخزن
- كشف المنفذ 9283 مباشرة للإنترنت بدون وكيل عكسي وTLS
- عدم ربط مكونات الوصفات بمنتجات فعلية، فلا يُخصم المخزون تلقائياً عند طبخ الوصفة
- تجاهل حاجة تطبيق الجوال لـ HTTPS والاستسلام عن مسح الباركود بدلاً من إعداد وكيل عكسي
- عدم نسخ ./config احتياطياً قبل الترقيات الكبيرة، مما يعرّض البيانات لخطر الفقدان إذا فشل الترحيل
استكشاف الأخطاء وإصلاحها
- واجهة الويب لا تُحمّل — تحقق من تشغيل الحاوية بـ docker ps وراجع السجلات بـ docker logs grocy بحثاً عن أخطاء بدء التشغيل
- مسح الباركود لا يعمل في تطبيق الجوال — تأكد من إمكانية الوصول للسيرفر عبر HTTPS؛ معظم التطبيقات ترفض حفظ بيانات الاعتماد عبر HTTP العادي
- قائمة التسوق لا تُملأ تلقائياً — تحقق من ضبط "الحد الأدنى للمخزون" على المنتجات ذات الصلة من Master Data → Products
- أعداد المخزون لا تطابق الواقع — قم بتصحيح جرد يدوي من Stock → Inventory، الذي يعيد ضبط الأعداد دون التأثير على سجل المشتريات
- قاعدة البيانات تبدو تالفة أو التطبيق لا يعمل — استعد آخر نسخة سليمة من grocy.db من نسخة ./config الاحتياطية
- استهلاك الوصفة لا يخصم المخزون — تأكد أن كل مكوّن في الوصفة مرتبط بمنتج فعلي وليس نصاً حراً فقط
- أداء بطيء مع كتالوج منتجات كبير — SQLite تتعامل بشكل جيد مع معظم المنازل، لكن الكتالوجات الكبيرة جداً (آلاف المنتجات) قد تستفيد من تفريغ قاعدة البيانات (vacuum) دورياً
- فشل تسجيل الدخول بعد تغيير كلمة المرور — امسح ملفات تعريف الارتباط/ذاكرة التخزين المؤقت لنطاق Grocy في المتصفح أو جرّب نافذة تصفح خفي
البدائل
Bring! وOut of Milk تطبيقات قوائم تسوق استهلاكية أنيقة لكنها سحابية، مدعومة بالإعلانات، ولا تتتبع تواريخ الصلاحية أو المخزون بأسلوب ERP حقيقي. Mealie يركز على إدارة الوصفات وتخطيط الوجبات بتجربة استيراد وصفات أفضل بكثير لكنه يفتقر لعمق Grocy في المخزون وتوليد قوائم التسوق. Homebox أداة تتبع مخزون منزلي أبسط للعناصر العامة دون تتبع الصلاحية الخاص بالمشتريات أو خصم الوصفات الذي يقدمه Grocy. Paprika مدير وصفات مدفوع بتخطيط وجبات قوي لكن بدون تتبع مخزون. كأداة واحدة ذاتية الاستضافة تجمع مخزون المشتريات وتتبع الصلاحية وقوائم التسوق والوصفات في نظام واحد بأسلوب ERP، يبقى Grocy الخيار الأكمل.
متى لا تستخدمه
Grocy مبالغ فيه إذا كنت تريد فقط قائمة تسوق مشتركة بسيطة — تطبيق مثل Bring! أو حتى ملاحظات مشتركة أسرع في الإعداد والاستخدام لهذا الغرض وحده. إذا كانت أولويتك اكتشاف وصفات وتخطيط وجبات بدلاً من تتبع المخزون، فأداة مخصصة مثل Mealie أو Paprika تقدم تجربة تصفح وصفات أفضل. Grocy يفترض أيضاً مستوى من انضباط إدخال البيانات اليدوي — مسح العناصر عند الدخول والخروج — لن يلتزم به كل منزل؛ إذا لم يلتزم أحد في المنزل بتسجيل المشتريات والاستهلاك بانتظام، ستنحرف بيانات المخزون والصلاحية عن الواقع وتفقد الأداة قيمتها. لتتبع مخزون منزلي عام يتجاوز المشتريات (إلكترونيات، أدوات، مستندات) دون تتبع صلاحية، قد تكون أداة أبسط مثل Homebox خياراً أفضل.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو Grocy؟
Grocy تطبيق ذاتي الاستضافة بأسلوب ERP لإدارة المنزل — يتتبع مخزون المشتريات والمستهلكات مع تواريخ الصلاحية، يبني قوائم تسوق تلقائياً، يدير الوصفات مع خصم المكونات، ويجدول المهام المنزلية. يعمل بالكامل على سيرفرك الخاص بقاعدة بيانات SQLite بسيطة.
ما بيانات الدخول الافتراضية لـ Grocy؟
اسم المستخدم وكلمة المرور الافتراضيان كلاهما admin. غيّر كلمة المرور فوراً بعد أول تسجيل دخول من Manage Users، خاصة قبل كشف Grocy خارج شبكتك المحلية.
ما المنفذ الذي يستخدمه Grocy؟
هذا النشر يربط منفذ المضيف 9283 بالمنفذ الداخلي 80 للحاوية، لذا تصل لواجهة الويب عبر http://your-server-ip:9283. المنفذ 9283 هو التعيين التقليدي لصورة LinuxServer؛ يمكنك تغييره إذا تعارض مع منفذ آخر.
هل يملك Grocy تطبيق جوال بمسح الباركود؟
نعم. تطبيقات Android وiOS المرافقة تتصل بسيرفر Grocy الخاص بك عبر REST API وتدعم مسح الباركود لإضافة أو استهلاك العناصر. تتطلب التطبيقات عادة نقطة نهاية HTTPS، لذا ضع Grocy خلف وكيل عكسي مع TLS.
أين يخزّن Grocy بياناته؟
كل شيء موجود في مجلد ./config، بما فيه قاعدة بيانات grocy.db بصيغة SQLite والملفات المرفوعة. بما أن كل الحالة في مجلد واحد، فإن نسخ ./config احتياطياً يمنحك نسخة احتياطية كاملة.