Homarr: الدليل الشامل لبناء لوحة تحكم بصرية موحدة للمعمل المنزلي وخدمات Docker

لوحة القيادة الموحدة: تنظيم المعمل المنزلي وإدارة حاويات Docker بنقاء Homarr

مع نمو معملك المنزلي وتشغيل عشرات الحاويات والخدمات (مثل Nextcloud و Jellyfin و Vaultwarden و Pi-hole و qBittorrent)، يصبح حفظ أرقام المنافذ وعناوين IP المختلفة في المفضلة مسألة فوضوية وغير عملية. يحتاج كل معمل منزلي إلى “صفحة بداية” ذكية (Dashboard) تجمع كافة الروابط في مكان واحد. يقدم مشروع Homarr لوحة التحكم الأكثر حداثة وجمالاً في هذا المجال.

يتميز Homarr بكونه أكثر من مجرد صفحة إشارات مرجعية ثابتة؛ فهو لوحة قيادة تفاعلية مجهزة بأدوات مخصصة (Widgets) تتصل مباشرة بالخدمات الأخرى: يعرض سرعة التنزيل الحالية في qBittorrent، والأفلام المشاهدة حاليًا على Jellyfin، وعدد الاستعلامات المحجوبة في Pi-hole، مع تحكم كامل لتشغيل وإيقاف حاويات Docker بنقرة زر.

ما هو Homarr؟

Homarr هو لوحة تحكم وبوابة خدمات مخصصة للمعامل المنزلية مفتوحة المصدر بالكامل (AGPL-3.0). يتميز بواجهة مستخدم فائقة الأناقة تدعم السحب والإفلات لتنظيم العناصر، مع إمكانية إنشاء لوحات متعددة، وتخصيص الأيقونات، ودعم الوضع المظلم، وإدارة مستخدمين وصلاحيات وصول متعددة.

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

لماذا لم تسمع به من قبل؟

أحدث Homarr نقلة نوعية في مجتمع r/selfhosted بتجاوزه لوحات التحكم القديمة (مثل Heimdall و Homer و Flame)، بفضل بنائه على تقنيات الويب الحديثة (Next.js & TypeScript) وتركيزه على التفاعلية اللحظية وسرعة الاستجابة.

كيف يعمل تحت الغطاء؟

تعتمد بنية Homarr على محرك ويب خفيف ومحكم:

محرك التكاملات الذكية (Integration Subsystem): يتصل بواجهات برمجة التطبيقات (APIs) للخدمات الخارجية لجلب المقاييس والإحصائيات وتحديث بطاقات الواجهة كل بضع ثوانٍ.
موصل محرك Docker: يقرأ بيانات الحاويات عبر /var/run/docker.sock، ويتيح تنفيذ أوامر البدء والإيقاف وإعادة التشغيل مباشرة من لوحة التحكم.
طبقة تخزين خفيفة بدون قواعد بيانات خارجية: يحفظ كافة إعدادات اللوحة والتخصيصات في ملفات محلية، مما يجعل النسخ الاحتياطي أمرًا فوريًا.

دليل التثبيت والتشغيل عبر Docker Compose

يتم تشغيل Homarr كحاوية Docker واحدة. أنشئ ملف docker-compose.yml التالي:

services:
  homarr:
    container_name: homarr
    image: ghcr.io/homarr-labs/homarr:latest
    restart: unless-stopped
    ports:
      - "7575:7575"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./homarr_data:/app/data/configs
      - ./homarr_icons:/app/public/icons
    environment:
      - SECRET_ENCRYPTION_KEY=generate_a_secure_32_character_key_here!
      - TZ=Asia/Riyadh

لتشغيل الخدمة:

docker compose up -d

افتح متصفحك على http://<SERVER_IP>:7575 لبدء تخصيص لوحتك الأولى، وإضافة أيقونات وتطبيقات معملك المنزلي، وربط أدوات المراقبة الذكية.

ما الذي يستبدله؟

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

الحدود والقيود التقنية

Homarr مصمم كلوحة تحكم وبوابة وصول سريعة للخدمات (Application Dashboard)؛ لذا فهو لا يحل محل لوحات المراقبة المتخصصة في السجلات العميقة (Grafana / Kibana) الموجهة لمقاييس البنية التحتية التفصيلية.

الفئات المستهدفة

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

الخلاصة

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