🛠️ تثبيت KitchenOwl — قوائم تسوق ووصفات مشتركة

انشر KitchenOwl على Ubuntu بـ Docker — مدير قوائم تسوق ووصفات ذاتي الاستضافة يتزامن عبر أفراد أسرتك، مع تخطيط للوجبات، على المنفذ 8219.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر KitchenOwl على المنفذ 8219 مع مفتاح JWT يُولَّد تلقائياً؛ أنشئ حسابك أثناء الإعداد الأولي.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/kitchenowl/kitchenowl-ubuntu.sh

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

chmod +x kitchenowl-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم، يولّد JWT_SECRET_KEY باستخدام openssl، يضبط FRONT_URL على عنوان سيرفرك، ويشغّل KitchenOwl على المنفذ 8219 مع تخزين البيانات في ./data.

sudo bash kitchenowl-ubuntu.sh

4 إكمال الإعداد الأولي

افتح KitchenOwl وأنشئ حسابك في معالج الإعداد الأولي، ثم ادعُ بقية أفراد الأسرة:

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

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

المنفذالغرض
8219Web UI + API (host → container 8080) — onboarding creates account
FRONT_URLSet to your server — mobile apps rely on it
./dataRecipes, lists, and household data

نظرة عامة

KitchenOwl هو مدير قوائم تسوق ووصفات ذاتي الاستضافة ومفتوح المصدر، مرخّص بموجب AGPL-3.0، بخلفية مبنية على Flask وواجهة أمامية مبنية على Flutter تُقدَّم كتطبيقات أصلية للجوال والويب وسطح المكتب. تدور فكرته الأساسية حول قائمة تسوق مشتركة تعمل بزمن حقيقي — العناصر التي يضيفها أحد أفراد الأسرة تظهر فوراً على أجهزة البقية — إلى جانب مدير وصفات يمكنه نقل مكونات طبق ما مباشرة إلى القائمة، ومخطط وجبات يربط الوصفات بأيام محددة. تتبع النفقات المدمج يحافظ على رصيد جارٍ لمن دفع ثمن المشتريات، فيعمل KitchenOwl كمركز تنسيق صغير لطبخ الأسرة وتسوقها أكثر من كونه مجرد تطبيق قائمة بسيط.

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

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

متى تحتاجه

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

من يحتاجه

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

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

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

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

  • قائمة تسوق متزامنة بزمن حقيقي مع دعم جزئي لوضع عدم الاتصال لشبكات واي فاي المتجر الضعيفة
  • مدير وصفات مع تحجيم للمكونات وزر "إضافة إلى قائمة التسوق" بضغطة واحدة
  • مخطط وجبات يجدول الوصفات عبر أيام الأسبوع ويضيف مكوناتها إلى القائمة تلقائياً
  • تتبع نفقات الأسرة يسجل من دفع ثمن المشتريات ويحسب الأرصدة الجارية
  • تصنيف العناصر بأيقونات وكميات بحيث تطابق القائمة تخطيط المتجر الفعلي
  • دعم عدة أسر — قوائم تسوق ووصفات ونفقات منفصلة لكل مجموعة على نفس السيرفر
  • تطبيقات أصلية لأندرويد وiOS والويب وسطح المكتب، جميعها تتصل بسيرفرك ذاتي الاستضافة
  • دعم تسجيل الدخول عبر OpenID Connect (OIDC) لـ Google أو Apple أو مزود هوية مخصص

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

  • افتح http://عنوان-سيرفرك:8219 وأكمل معالج الإعداد الأولي لإنشاء الحساب الأول (المسؤول) — نفّذ هذا فور التثبيت مباشرة
  • أنشئ أسرة تحت Settings → Households وادعُ بقية أفراد عائلتك أو شركائك في السكن للانضمام إليها
  • أضف بضعة عناصر بقالة يدوياً للتأكد من تحديث القائمة المشتركة بزمن حقيقي عبر علامتي تبويب أو جهازين
  • أنشئ وصفتك الأولى، أو استوردها، واستخدم زر "إضافة إلى قائمة التسوق" لاختبار تدفق الوصفة إلى القائمة
  • ثبّت تطبيق KitchenOwl على أندرويد أو iOS ووجّهه إلى عنوان سيرفرك للتسوق من هاتفك
  • أعدّ مخطط الوجبات للأسبوع القادم وولّد قائمة تسوق موحدة من الوصفات المخططة
  • فعّل تتبع النفقات إذا أرادت الأسرة تقسيم تكاليف البقالة، وسجّل من يدفع مع كل عملية شراء
  • ضع KitchenOwl خلف وكيل عكسي مع نطاق حقيقي وHTTPS قبل الاعتماد عليه في رحلات التسوق اليومية

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

  • لا تكشف المنفذ 8219 مباشرة للإنترنت بدون HTTPS — صفحة الإعداد الأولي لا تحتوي تحديد معدل افتراضياً وتنتقل البيانات بنص عادي HTTP بخلاف ذلك
  • أكمل الإعداد الأولي فور التثبيت مباشرة؛ أول حساب يُنشأ على نسخة يمكن الوصول إليها يصبح المسؤول، لذا فإن نسخة مكشوفة وغير مُطالَب بها خطر حقيقي
  • ولّد JWT_SECRET_KEY قوياً وعشوائياً باستخدام openssl بدلاً من ترك قيمة افتراضية أو متوقعة — يقوم سكريبت التثبيت بهذا تلقائياً
  • اضبط FRONT_URL على العنوان الدقيق الذي سيستخدمه الناس (بما فيه https:// إذا كان خلف وكيل) ليبقى سلوك الجلسة وCORS صحيحاً
  • ضع KitchenOwl خلف وكيل عكسي مثل Nginx Proxy Manager مع شهادة TLS صالحة قبل السماح بأي وصول عن بُعد
  • فعّل تسجيل الدخول عبر OpenID Connect (OIDC) عبر Google أو Apple أو مزود مخصص إذا أردت أن يتجنب أفراد الأسرة كلمات مرور منفصلة لـ KitchenOwl
  • قيّد من تدعوه إلى أسرتك — كل عضو يستطيع رؤية وتعديل القائمة المشتركة والوصفات وأرصدة النفقات
  • حافظ على تحديث صورة KitchenOwl في Docker، فالمشروع لا يزال في مرحلة ألفا عامة نشطة ويتلقى إصلاحات متكررة

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

ينشر سكريبت تثبيت KitchenOwl واجهة الويب والـ API على المنفذ 8219 على المضيف، والذي يُربط بمنفذ الحاوية الداخلي 8080 — تصفّح http://عنوان-سيرفرك:8219 وليس 8080. تتصل تطبيقات الجوال وسطح المكتب بنفس العنوان المضبوط في FRONT_URL، لذا يجب أن يطابق هذا المتغير العنوان الذي يكتبه الناس فعلياً، بما في ذلك المنفذ أو نطاق الوكيل العكسي. لا ينبغي كشف المنفذ 8219 مباشرة للإنترنت العام بدون وكيل عكسي ينهي اتصال TLS أمامه، لأن KitchenOwl يقدم HTTP عادي افتراضياً ولا تحتوي صفحة الإعداد الأولي على تحديد معدل مدمج. احظر المنفذ الخام في الجدار الناري لحركة المرور الخارجية واسمح بالوصول فقط عبر وكيل عكسي على المنفذ 443 أو VPN.

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

  • انسخ دليل ./data (أو حجم Docker باسم kitchenowl_data) احتياطياً، فهو يحتوي قاعدة بيانات SQLite بكل القوائم والوصفات والأسر وسجلات النفقات
  • انسخ docker-compose.yml أو أمر docker run احتياطياً مع قيم JWT_SECRET_KEY وFRONT_URL حتى تتمكن من إعادة إنشاء الحاوية بشكل مطابق
  • أوقف الحاوية (أو على الأقل أوقف عمليات الكتابة) قبل نسخ دليل البيانات للحصول على لقطة متسقة بدلاً من نسخة أثناء الكتابة
  • خزّن النسخ الاحتياطية بعيداً عن نفس قرص السيرفر — سيرفر بعيد، قرص خارجي، أو تخزين سحابي — حتى لا يؤدي عطل القرص إلى فقدان الاثنين معاً
  • جدول نسخاً احتياطية تلقائية عبر cron أو أداة مثل Duplicati بدلاً من الاعتماد على نسخ يدوية قد تنساها
  • اختبر الاستعادة دورياً على سيرفر احتياطي للتأكد من أن دليل البيانات وحده كافٍ لإعادة تشغيل KitchenOwl بكل الأسر والوصفات سليمة

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

  • ترك النسخة قابلة للوصول من الإنترنت قبل إكمال الإعداد الأولي — أول شخص يصل إلى الرابط يستحوذ على حساب المسؤول
  • كشف المنفذ 8219 مباشرة بدون وكيل عكسي، مما يرسل بيانات الاعتماد والبيانات عبر HTTP عادي
  • نسيان ضبط FRONT_URL على العنوان الحقيقي الذي تستخدمه المتصفحات وتطبيقات الجوال، مما يكسر إعادة توجيه تسجيل الدخول وCORS
  • عدم إنشاء أسر منفصلة قبل دعوة مجموعات مختلطة، مما يخلط وصفات ونفقات أسرة مع أخرى
  • تخطي النسخ الاحتياطي لدليل البيانات، بافتراض أن حجم Docker وحده آمن من عطل القرص أو الحذف العرضي
  • إعادة استخدام JWT_SECRET_KEY ضعيف أو افتراضي بدلاً من ترك المثبت يولّد واحداً عشوائياً بـ openssl
  • عدم تثبيت تطبيق الجوال والاعتماد فقط على المتصفح، مما يفوّت دعم وضع عدم الاتصال الذي يجعل الاستخدام داخل المتجر موثوقاً
  • تشغيل الحاوية بدون restart: unless-stopped، بحيث تترك إعادة تشغيل السيرفر الأسرة بدون قائمة تسوق حتى يلاحظ أحدهم

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

  • تعذر الوصول لواجهة الويب — تأكد من تشغيل الحاوية بـ docker ps، تحقق من ربط المنفذ 8219، وتأكد أن جدار حماية المضيف يسمح بالمنفذ
  • تظهر صفحة الإعداد الأولي مجدداً بعد إنشاء حساب بالفعل — تحقق من أن FRONT_URL يطابق العنوان الذي تتصفحه؛ عدم التطابق قد يكسر ملفات تعريف الجلسة
  • تطبيق الجوال لا يتصل — تأكد أن عنوان السيرفر المُدخل في التطبيق يطابق FRONT_URL تماماً، بما في ذلك http/https والمنفذ
  • تحديثات القائمة لا تظهر بزمن حقيقي — تحقق من أن اتصالات WebSocket ليست محظورة أو مُزالة بواسطة وكيل عكسي أو جدار حماية وسيط
  • مكونات الوصفة لا تُضاف للقائمة — تأكد من حفظ الوصفة بشكل صحيح وجرّب إجراء "إضافة إلى قائمة التسوق" مجدداً من صفحة تفاصيل الوصفة
  • فشل تسجيل الدخول عبر OIDC — تحقق من أن رابط إعادة التوجيه المضبوط لدى مزود الهوية يطابق FRONT_URL بالإضافة إلى مسار الاستدعاء تماماً
  • الحاوية تعيد التشغيل في حلقة — راجع سجلات docker logs لاسم الحاوية وابحث عن JWT_SECRET_KEY مفقود أو غير صالح أو خطأ صلاحيات قاعدة بيانات على حجم البيانات
  • تبدو البيانات وكأنها أُعيد ضبطها بعد تحديث — تأكد أن حجم البيانات أو ربط ./data تم الحفاظ عليه في docker-compose.yml الجديد ولم يُعَد إنشاؤه عن طريق الخطأ

البدائل

Mealie مدير وصفات أعمق مع قدرات قوية على استخراج الوصفات من الإنترنت وتنظيمها، لكن قائمة التسوق المشتركة فيه ميزة ثانوية وليست جوهر التطبيق. Tandoor Recipes يركز بالمثل على إدارة الوصفات وتخطيط الوجبات مع إضافة قوية لقائمة التسوق، ويناسب من يطبخون من أرشيف وصفات شخصي كبير. Grocy نظام ERP كامل للأسرة يتتبع مخزون المؤن وتواريخ انتهاء الصلاحية والمهام المنزلية إضافة لقوائم التسوق — أقوى بكثير لكن بمنحنى تعلّم أصعب وصيانة يومية أكبر. Bring! وOut of Milk تطبيقات تسوق تجارية مصقولة لكنها تتطلب حساباً لدى طرف ثالث وليست ذاتية الاستضافة. لأسرة تريد أساساً قائمة تسوق مشتركة سريعة بزمن حقيقي مع دعم خفيف للوصفات وتخطيط الوجبات، يقع KitchenOwl في منطقة وسطى مريحة بين تطبيق قائمة بسيط ونظام كامل لإدارة المؤن.

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

KitchenOwl ليس نظام جرد للمؤن — فهو لا يتتبع كمية العنصر المتوفرة لديك في المنزل، أو تواريخ انتهاء الصلاحية، أو مستويات المخزون المعتمدة على الباركود بالطريقة التي يفعلها Grocy. إذا كان تتبع ما في ثلاجتك وفريزرك أهم من قائمة التسوق نفسها، فإن Grocy خيار أنسب رغم إعداده الأصعب. مدير الوصفات في KitchenOwl أخف أيضاً من أدوات مخصصة مثل Mealie أو Tandoor — إذا كنت تحتفظ بأرشيف وصفات شخصي كبير مع بيانات غذائية تفصيلية وبحث متقدم، فتلك الأدوات أعمق. لا يزال المشروع في مرحلة ألفا عامة، لذا إذا احتجت منصة ناضجة ومستقرة على المدى الطويل لأداة أسرية حرجة، ضع هذه الحالة في اعتبارك قبل الالتزام. وإذا لم يكن أحد في أسرتك مرتاحاً لتشغيل حاوية Docker ووكيل عكسي، فإن تطبيقاً تجارياً مصقولاً مثل Bring! سيتطلب صيانة مستمرة أقل بكثير.

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

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

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

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

ما الذي يميز KitchenOwl عن قائمة تسوق في تطبيق ملاحظات؟

المزامنة بزمن حقيقي وتكامل الوصفات. تتحدث القائمة مباشرة عبر هواتف الجميع، فمن يكون في المتجر يرى العناصر التي يضيفها الآخرون لحظياً. وإضافة وصفة إلى خطة وجباتك تُسقط مكوناتها مباشرة على القائمة، فيصبح التخطيط والتسوق إجراءً واحداً بدلاً من اثنين.

كيف ينضم أفراد الأسرة؟

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

ما المنفذ الذي يستخدمه؟

المنفذ 8219 على المضيف، مربوط بمنفذ الحاوية الداخلي 8080. تصفّح 8219؛ أما 8080 فهو المنفذ داخل الحاوية. تتصل تطبيقات الجوال بنفس العنوان، لذا تأكد أن FRONT_URL يعكس العنوان الذي يستخدمه الناس فعلياً.

هل توجد تطبيقات جوال؟

نعم، لدى KitchenOwl تطبيقات iOS وأندرويد تتصل بسيرفرك ذاتي الاستضافة، وهذه فعلياً أفضل طريقة لاستخدام قائمة تسوق مشتركة — يحدّثها الجميع من هواتفهم بزمن حقيقي. وجّه التطبيق إلى عنوان سيرفرك، وتأكد من ضبط FRONT_URL بشكل صحيح ليتصل بسلاسة.

كيف يقارَن بـ Grocy وMealie؟

يركّز KitchenOwl على قائمة التسوق المشتركة مع تخطيط وجبات مدفوع بالوصفات. Mealie وTandoor مديرا وصفات أعمق لكنهما أخف على جانب القائمة المشتركة، بينما Grocy نظام ERP كامل للأسرة يتتبع مخزون المؤن وتواريخ انتهاء الصلاحية — أقوى بكثير لكن يتطلب صيانة أكبر بكثير.