🏠 تثبيت Homebox — نظام ذاتي الاستضافة لجرد المنزل

انشر Homebox على Ubuntu باستخدام Docker — نظام خفيف وسريع ذاتي الاستضافة لجرد المنزل وإدارة الأصول.

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

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

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

سكريبت تثبيت آلي — ينشر Homebox مع تخزين دائم وواجهة ويب على المنفذ 7745.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/homebox/homebox-ubuntu.sh

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

chmod +x homebox-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم، وينشئ دليل بيانات Homebox، وينشر الحاوية على المنفذ 7745.

sudo bash homebox-ubuntu.sh

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

افتح المتصفح وانتقل إلى Homebox:

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

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

المنفذالغرض
7745Homebox Web UI (HTTP)

نظرة عامة

Homebox نظام مجاني ومفتوح المصدر لجرد المنزل وإدارة الأصول، مبني بلغة Go مع واجهة أمامية بـ SvelteKit، ويصونه فريق sysadminsmedia كامتداد لمشروع HomeBox الأصلي. يعمل كحاوية واحدة خفيفة مع قاعدة بيانات SQLite مدمجة، فلا حاجة لإعداد أو صيانة قاعدة بيانات خارجية منفصلة. يتيح لك Homebox تسجيل كل قطعة مادية تملكها — منظمة ضمن مواقع متداخلة، وسمات (Labels)، وحقول مخصصة — مع تواريخ الضمان، وإيصالات الشراء، وملصقات QR للوصول السريع.

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

يحل Homebox مشكلة تواجه معظم الأسر والفرق الصغيرة عاجلاً أم آجلاً: عدم معرفة ما تملكه، ومكانه، وموعد انتهاء ضمانه. بدلاً من جدول بيانات يفقد تحديثه بسرعة، يمنحك Homebox قاعدة بيانات قابلة للبحث والوسم مع صور وإيصالات وملصقات QR يمكنك طباعتها ولصقها مباشرة على الصناديق أو الأجهزة. إنه خفيف جداً — أقل من 50 ميغابايت من الذاكرة عند الخمول — ويُنشر كحاوية Docker واحدة مع قاعدة بيانات SQLite مدمجة، فلا يوجد سيرفر قاعدة بيانات منفصل تديره أو تؤمّنه أو تنسخه احتياطياً. وبكونه ذاتي الاستضافة ومرخصاً بـ AGPL-3.0، فإن بيانات جردك — التي قد تكشف الكثير عن منزلك ومحتوياته وقيمتها — لا تغادر سيرفرك الخاص أبداً.

متى تحتاجه

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

من يحتاجه

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

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

  • طباعة ملصقات QR لصناديق التخزين وصناديق النقل — امسح أي ملصق لترى محتوياته الكاملة فوراً
  • تتبع تواريخ انتهاء الضمان والحصول على رؤية واضحة لما هو مغطى قبل شراء بدائل
  • إرفاق إيصالات الشراء والصور بالقطع لتسريع مطالبات التأمين بعد الفقد أو التلف
  • الاحتفاظ بسجل أصول تقنية يتضمن الأرقام التسلسلية وتواريخ الشراء والمواقع المخصصة لمعدات المكتب
  • تنظيم كراج أو وحدة تخزين ضمن مواقع متداخلة (كراج ← رف 3 ← صندوق 2) تعكس الواقع الفعلي
  • استيراد جردٍ موجود من جدول بيانات دفعة واحدة عبر CSV بدلاً من إدخال كل شيء يدوياً
  • تتبع قيمة القطع بمرور الوقت لتخطيط التركات أو إدارة المقتنيات عالية القيمة

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

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

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

  • أنشئ حسابك وسجّل الدخول لأول مرة على http://your-server-ip:7745
  • أعدّ مواقعك الرئيسية أولاً (مثل المنزل، الكراج، وحدة التخزين) قبل إضافة المواقع الفرعية المتداخلة
  • أنشئ سمات (Labels) للفئات المتقاطعة مثل إلكترونيات أو أدوات أو قابل للكسر تنطبق عبر مواقع متعددة
  • أضف القطع واحدة تلو الأخرى أو استورد جدول بيانات موجوداً دفعة واحدة باستخدام أداة استيراد CSV
  • أرفق صوراً وإيصالات بالقطع عالية القيمة لتكون جاهزة إن احتجت لتقديم مطالبة تأمين
  • أدخل تواريخ انتهاء الضمان للأجهزة الإلكترونية والمنزلية حتى يُظهر Homebox ما سينتهي قريباً
  • ولّد واطبع ملصقات QR للصناديق والرفوف، ثم امسحها لاحقاً لسحب المحتويات فوراً
  • ادعُ مستخدمين إضافيين لمجموعتك من الإعدادات إذا احتاج أفراد آخرون من الأسرة أو الفريق الوصول

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

  • ضع Homebox خلف وكيل عكسي مع HTTPS — بيانات تسجيل الدخول والجرد تنتقل بنص عادي HTTP افتراضياً على المنفذ 7745
  • استخدم كلمات مرور قوية وفريدة لكل حساب، خاصة إذا كنت تخزّن بيانات قطع عالية القيمة وإيصالات
  • قيّد الوصول على شبكتك المحلية أو VPN مثل WireGuard بدلاً من كشف المنفذ 7745 للإنترنت
  • حدّث صورة Homebox Docker بانتظام — اسحب الإصدارات الجديدة دورياً للحصول على إصلاحات أمنية
  • انسخ ملف قاعدة بيانات SQLite احتياطياً بانتظام لأنه المصدر الوحيد للحقيقة دون تكرار مدمج
  • اقصر عضوية المجموعة على من تثق بهم فعلاً — أي عضو يمكنه رؤية الجرد الكامل وقيمه
  • راجع المرفقات المرفوعة دورياً — قد تحتوي الإيصالات والصور على معلومات تعريف شخصية

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

يقدّم Homebox واجهة الويب وواجهة API الخاصة به عبر منفذ واحد فقط — 7745 في هذا النشر — عبر HTTP عادي. لا توجد منافذ منفصلة لقاعدة بيانات أو خدمات خلفية، لأن SQLite يعمل مدمجاً داخل نفس الحاوية. لا تكشف المنفذ 7745 مباشرة للإنترنت أبداً بدون TLS، لأن بيانات تسجيل الدخول وكامل بيانات جردك ستنتقل دون تشفير. احظر المنفذ 7745 في الجدار الناري لحركة المرور الخارجية وضع Homebox خلف وكيل عكسي مثل Nginx Proxy Manager على المنفذ 443 مع شهادة SSL صالحة، أو قيّد الوصول بالكامل على شبكتك المحلية أو VPN مثل WireGuard.

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

  • انسخ دليل بيانات Homebox احتياطياً، الذي يحتوي قاعدة بيانات SQLite المدمجة وكل المرفقات المرفوعة (الإيصالات، الصور، الأدلة)
  • أوقف الحاوية أو استخدم آلية النسخ الاحتياطي الفوري في SQLite قبل نسخ ملف قاعدة البيانات لتجنب لقطة تالفة
  • صدّر جردك الكامل إلى CSV دورياً كنسخة احتياطية قابلة للقراءة البشرية ومستقلة عن تنسيق قاعدة البيانات
  • خزّن النسخ الاحتياطية خارج السيرفر — على NAS أو جهاز آخر أو تخزين سحابي — وليس على نفس القرص فقط
  • انسخ ملف docker-compose.yml أو أمر التشغيل احتياطياً حتى يمكن إعادة إنشاء الحاوية بشكل مطابق بعد عطل السيرفر
  • اختبر النسخة الاحتياطية باستعادتها على نسخة تجريبية منفصلة والتأكد من سلامة القطع والمواقع والمرفقات

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

  • كشف المنفذ 7745 للإنترنت دون وكيل عكسي و HTTPS، مما يُرسل بيانات الاعتماد والجرد بنص عادي
  • عدم ربط دليل البيانات بحجم دائم، فتُفقد قاعدة البيانات والمرفقات عند إعادة إنشاء الحاوية
  • تخطي تواريخ الضمان عند إضافة القطع، مما يُبطل إحدى أكثر ميزات Homebox فائدة
  • إنشاء قائمة مسطحة من القطع دون مواقع أو سمات، مما يجعل الجرد صعب البحث مع نموه
  • رفع صور بدقة كاملة لكل قطعة دون مراعاة نمو مساحة التخزين على قرص سيرفر صغير
  • نسيان نسخ ملف قاعدة بيانات SQLite احتياطياً، دون مسار استعادة في حال تعطل القرص
  • مشاركة تسجيل دخول واحد لعائلة كاملة بدلاً من إنشاء حسابات مستخدمين منفصلة للمساءلة

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

  • لا يمكن الوصول لواجهة الويب — تحقق أن الحاوية تعمل بأمر docker ps وأن المنفذ 7745 غير محظور بجدار حماية المضيف
  • تختفي البيانات بعد التحديث — تأكد أن دليل البيانات مربوط كحجم دائم وليس مخزناً داخل الطبقة القابلة للكتابة في الحاوية
  • فشل استيراد CSV أو ظهور قطع بشكل خاطئ — تحقق أن ملف CSV يطابق تنسيق الأعمدة المتوقع من قالب تصدير حديث
  • ملصقات QR لا تُمسح بشكل صحيح — تأكد من الطباعة بالدقة الأصلية للملصق دون تصغير الصورة كثيراً
  • أداء بطيء مع جرد كبير — قد تبدأ قاعدة بيانات SQLite بالتباطؤ بعد عشرات آلاف القطع؛ تأكد أن حجم البيانات على تخزين سريع
  • لا يمكن تسجيل الدخول بعد نسيان كلمة مرور المسؤول — أعد ضبطها مباشرة عبر قاعدة بيانات SQLite أو أعد إنشاء مستخدم المسؤول حسب توثيق المشروع
  • فشل رفع المرفقات — تحقق من المساحة المتاحة على القرص الذي يدعم دليل البيانات

البدائل

Grocy أداة أوسع لإدارة المنزل تغطي أيضاً البقالة والمهام وتخطيط الوجبات، لكن وحدة الجرد فيها أقل تركيزاً على تتبع الأصول مقارنة بـ Homebox. Snipe-IT مبني خصيصاً لإدارة أصول تقنية المعلومات مع تتبع التراخيص، ما يجعله أنسب لجرد أجهزة الشركات المنظم لكنه مبالغ فيه للاستخدام المنزلي. Sortly وEncircle خدمات سحابية تجارية بتطبيقات جوال مصقولة لكنها تتطلب اشتراكاً مدفوعاً وتخزّن بياناتك على سيرفراتها. جدول البيانات هو الخيار المجاني الأساسي الذي يبدأ به معظم الناس، لكنه يفتقر للبحث وملصقات QR وتنبيهات الضمان والوصول متعدد المستخدمين. كأداة جرد منزلي مبنية خصيصاً وذاتية الاستضافة ومفتوحة المصدر وخفيفة ومجانية للأبد، Homebox هو الخيار الواضح.

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

Homebox ليس منصة إدارة أصول تقنية معلومات مع امتثال تراخيص أو تذاكر دعم أو محاسبة استهلاك — لهذا الغرض، Snipe-IT أو أداة ITAM مخصصة أنسب. كما أنه ليس متتبع بقالة أو مستهلكات؛ إذا احتجت إدارة مخزن مؤن وقوائم تسوق وتخطيط وجبات إلى جانب الأصول المادية، يغطي Grocy مساحة أوسع. إذا كنت تملك قطعاً قليلة فقط ولا تحتاج تتبع ضمان أو ملصقات QR، فقد يكفيك جدول بيانات بسيط. وإذا احتجت تطبيقاً مصقولاً موجهاً للجوال بفريق دعم مدفوع خلفه، فقد يناسب خيار تجاري مثل Sortly المستخدمين غير التقنيين أكثر من استضافة نسختك الخاصة.

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

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

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

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

هل Homebox مجاني ومفتوح المصدر؟

نعم. Homebox مجاني تماماً ومفتوح المصدر برخصة AGPL-3.0، ويصونه فريق sysadminsmedia كامتداد لمشروع HomeBox الأصلي. لا توجد اشتراكات مدفوعة أو متطلبات حساب أو بيانات تتبع — كل شيء يعمل على سيرفرك الخاص.

هل يحتاج Homebox سيرفر قاعدة بيانات منفصل؟

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

هل يمكنني طباعة ملصقات QR لقطعي؟

نعم. يولّد Homebox رمز QR ورقم أصل فريد لكل قطعة وموقع. يمكنك طباعة هذه كملصقات ولصقها على الصناديق أو الرفوف أو المعدات — ومسح الرمز بأي كاميرا هاتف يفتح سجل تلك القطعة الكامل فوراً.

هل يمكن لعدة أشخاص مشاركة نفس الجرد؟

نعم. يدعم Homebox عدة حسابات مستخدمين ضمن مجموعة مشتركة، بحيث يمكن لأفراد الأسرة أو الفريق جميعاً عرض وتعديل نفس الجرد بتسجيلات دخول منفصلة خاصة بهم.

كيف أُرحّل جرداً موجوداً من جدول بيانات إلى Homebox؟

يتضمن Homebox أداة استيراد CSV. صدّر قالباً من التطبيق، واملأه ليطابق أعمدة جدول بياناتك الحالي (أو عدّل جدول بياناتك ليطابقه)، ثم استورده دفعة واحدة بدلاً من إضافة كل قطعة يدوياً.