دليل التثبيت والإعداد

1. نزّل ملف .dmg ثم افتحه.
2. اسحب DeviceShelf إلى مجلّد التطبيقات.
3. افتحه من Launchpad أو من مجلّد التطبيقات. فهو موثّق من Apple، لذا يعمل مباشرةً بلا أي تحذير أمني.

المتطلّبات: نظام macOS 12 أو أحدث (بمعالجات Apple Silicon و Intel). يحتاج قياس النطاق الترددي المباشر لكل جهاز إلى صلاحيات مرتفعة — راجع النطاق الترددي المباشر. وكل ما عدا ذلك يعمل فوراً.

1. نزّل حزمة التثبيت (.exe) — إصدار x64 لمعالجات Intel/AMD، أو إصدار ARM64 لأجهزة Snapdragon و Copilot+.
2. شغّله. قد يحذّر Windows SmartScreen من أن الناشر غير موثّق (فالنسخة غير موقّعة): اضغط مزيد من المعلومات ← تشغيل على أي حال.
3. اتبع خطوات التثبيت ثم شغّل DeviceShelf.

لقياس النطاق الترددي المباشر: ثبّت Npcap. يعتمد قياس النطاق لكل جهاز على Windows على التقاط الحزم، وهذا يتطلّب Npcap. تدلّك حزمة التثبيت عليه، ويمكنك أيضاً تنزيل Npcap ثم إعادة تشغيل DeviceShelf. أمّا الفحص والمنافذ وتقرير الأمان وكل ما عداها فتعمل دون Npcap.

للمزيد: تفعيل النطاق الترددي المباشر.

يتوفّر DeviceShelf بصيغة AppImage (يعمل في أي مكان بلا تثبيت) وكحزم أصلية .deb و .rpm، لمعماريتَي x86-64 و ARM64.

ستثبّت حزمة .deb؟ استخدم الطرفية لا النقر المزدوج — على Ubuntu 24.04 تُفتح حزمة .deb بالنقر المزدوج داخل App Center وقد تفشل بصمت:

sudo apt install ./DeviceShelf-*.deb

دليل Linux الكامل (AppImage و .rpm وصلاحيات الالتقاط): التثبيت على Linux.

يتوفّر DeviceShelf لأجهزة iPhone و iPad على App Store. أمّا أندرويد فيأتي بصيغة حزمة APK مباشرة تثبّتها بنفسك — ولا وجود لصفحة على Google Play. ومفتاح ترخيصك يعمل على الحاسب والهاتف معاً، فشراء واحد يغطّي كل أجهزتك.

للمراقبة المتواصلة هناك نسخة خادم بلا واجهة رسومية: داخل Docker أو عبر حزمة .deb أو كخدمة Windows. وجّهها إلى الشبكات التي تريد مراقبتها على مدار الساعة. ترخيصك الحالي يشملها: المفتاح نفسه، وبلا تكلفة إضافية.

جديد في 1.5.3: يتضمن الخادم خادم MCP محليًا — اربط Claude أو Cursor أو أي وكيل ذكاء اصطناعي واسأل عن شبكتك بلغة طبيعية. دليل الربط ←

تجد خطوات التثبيت والتنبيهات وإعداد الرمز وأمثلة اتصال MCP في دليل الخادم.

تنشر نسخة الخادم أجهزتك إلى Home Assistant عبر MQTT. ويكتشفها Home Assistant من تلقاء نفسه، فلا شيء لتثبّته من جهته سوى تكامل MQTT ووسيط — بلا إضافة وبلا مكوّن مخصّص.

1. تأكّد من أن تكامل MQTT في Home Assistant موجّه إلى وسيطك (إضافة Mosquitto تفي بالغرض، وكذلك أي وسيط خارجي).
2. من لوحة الخادم افتح الإعدادات ← التكاملات ← Home Assistant، وأدخل عنوان الوسيط (192.168.1.10:1883 يكفي)، وأضف اسم مستخدم وكلمة مرور إن كان وسيطك يطلبهما.
3. فعّل خيار النشر إلى Home Assistant واضغط اختبار الاتصال. تظهر الكيانات خلال دورة فحص واحدة.

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

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

يعرف الموجّه أجهزة لا يصل إليها الفحص: هواتف في وضع السكون، وأجهزة على شبكة VLAN أخرى. يستطيع DeviceShelf قراءة قائمة الأجهزة من الموجّه مباشرة، على الحاسوب وعلى الهاتف وعلى الخادم. كلٌّ منها يسأل الموجّه بنفسه، ولا يمرّ شيء عبر خوادمنا.

1. افتح الإعدادات ← الموجّه / وحدة التحكم (تطبيق الحاسوب ولوحة الخادم) أو الإعدادات ← الموجّه على الهاتف.
2. اختر علامة الموجّه أو اترك اكتشاف تلقائي. إذا كان الموجّه هو البوابة، اترك حقل العنوان فارغًا.
3. أدخل ما تطلبه الملاحظة أسفل العلامة. معظم الموجّهات المنزلية (FRITZ!Box وASUS وNetgear وTP-Link …) تطلب كلمة مرور واجهة الويب الخاصة بها. أما وحدات التحكم مثل UniFi وpfSense وOPNsense وFortiGate وOmada فتطلب عادةً مفتاح API.
4. اضغط اختبار الاتصال. سترى أي علامة أجابت وكم جهازًا أعادت.

تبقى كلمة المرور على جهازك (سلسلة المفاتيح على Mac، والتخزين الآمن للنظام على iPhone وAndroid، وملف مشفّر على Windows وLinux) ولا تُرسل إلا إلى الموجّه. بعض الموجّهات لا تتحدث داخل الشبكة إلا عبر HTTP غير المشفّر، وعندها يستطيع أي شخص يتنصّت على الشبكة قراءة بيانات الدخول.

ASUS: يتصل DeviceShelf أولًا عبر HTTPS. إذا نبّه اختبار الاتصال إلى HTTP غير مشفّر، ففعّل HTTPS في الموجّه من Administration → System → Local Access Config.

جرّبنا حتى الآن على أجهزة حقيقية: UniFi وZyxel. أما بقية العلامات فمبنية على الواجهات التي يوثّقها المصنّعون. إذا لم يجب موجّهك كما هو متوقع، راسلنا.

1. بعد الشراء تصلك رسالة بريدية تحمل مفتاح الترخيص.
2. داخل التطبيق: الإعدادات ← الترخيص، اضغط لصق وتفعيل. أو الصق المفتاح بنفسك ثم اضغط تفعيل.
3. على iPhone وiPad لا يوجد حقل للمفتاح: افتح رسالة الترخيص على الجهاز واضغط زرّ التفعيل، أو فعّل أولًا على الكمبيوتر وامسح رمز QR الخاص به (الإعدادات ← الترخيص ← التفعيل على هاتفك) بكاميرا iPhone. على أندرويد يعمل ذلك أيضًا، أو الصق المفتاح ضمن الإعدادات ← الترخيص.
4. إصدار الخادم: الصق المفتاح نفسه في لوحة الخادم ضمن الإعدادات ← عام ← الترخيص، أو عيّن DEVICESHELF_LICENSE في البيئة (Docker أو .deb أو خدمة Windows).

بلا حساب وبلا تحقّق عبر الإنترنت — فالتفعيل يتم دون اتصال. والمفتاح نفسه يفعّل بقية أجهزتك كذلك. للمزيد: تفعيل DeviceShelf.

وبدونها يظل التطبيق يعمل — وتبقى الميزة المعنيّة وحدها معطّلة.

المسح لا يجد شيئًا أو يكاد

يرى الماسح الشبكة المتصل بها. على شبكة ضيوف أو VLAN أو مع VPN نشط تفحص ذلك الجزء بدل شبكتك الرئيسية — وهذا أكثر أسباب القائمة شبه الفارغة شيوعًا. على macOS تحقق أيضًا من إعدادات النظام › الخصوصية والأمن › الشبكة المحلية: إن لم يكن DeviceShelf مسموحًا هناك فلن يعيد الفحص شيئًا. وامنحه نصف دقيقة — تظهر الأجهزة المتاحة خلال ثوانٍ وتتبعها الأسماء والتعرّف.

يبقى عرض النطاق المباشر فارغًا أو معطلاً

يعتمد عرض النطاق لكل جهاز على التقاط الحزم، وهذا يحتاج صلاحيات إضافية: Npcap على Windows، أو sudo أو وصول BPF على macOS/Linux. كل ما عدا ذلك في التطبيق يعمل بدونها. تشرح صفحة عرض النطاق المباشر الإعداد لكل منصة.

يحذّر Windows من ناشر غير معروف

يعرض SmartScreen هذا التحذير مع المثبّتات غير الموقّعة. انقر مزيد من المعلومات → التشغيل على أي حال. تُنشر بصمة SHA-256 للتنزيل بجانب كل إصدار كي تتحقق مما تشغّله.

ملف ‎.deb لا يُثبَّت على Ubuntu

فتح ملف ‎.deb بالنقر المزدوج يمر عبر App Center في Ubuntu وقد يفشل بصمت. ثبّته من الطرفية بدلًا من ذلك: sudo apt install ./DeviceShelf-*.deb. التفاصيل في صفحة Linux.

الترخيص لا يُفعَّل

ألصق الرمز الكامل من بريد الشراء في الإعدادات › الترخيص دون فواصل أسطر. يتم التحقق دون اتصال، فلا يمكن لأي جدار حماية أن يعترض. إذا رُفض الرمز فردّ على بريد الشراء وسنحل الأمر.

macOS

1. إذا كنت قد أعددت عرض النطاق المباشر: افتح عرض النطاق في DeviceShelf وانقر إزالة وصول BPF. سيُطلب منك كلمة مرور المسؤول، ثم يُحذف البرنامج المساعد الذي تعرضه إعدادات النظام باسم DeviceShelf-Helper. قد تستمر إعدادات النظام في عرض الإدخال حتى إعادة تشغيل الـ Mac.
2. أغلق DeviceShelf واسحبه من مجلد التطبيقات إلى سلة المهملات. يختفي خيار «الفتح عند تسجيل الدخول» مع التطبيق.
3. لحذف قائمة الأجهزة والإعدادات وكلمات المرور المحفوظة أيضًا، احذف المجلد ~/Library/Application Support/DeviceShelf.

كانت الإصدارات الأقدم تحفظ كلمات المرور في سلسلة المفاتيح. لإزالتها أيضًا، افتح «الوصول إلى سلسلة المفاتيح» وابحث عن DeviceShelf واحذف الإدخالات التي تظهر.

هل نقلت التطبيق إلى سلة المهملات بينما كان عرض النطاق المباشر مُعدًّا؟ هذه الأوامر في Terminal تزيل البرنامج المساعد:

sudo launchctl bootout system /Library/LaunchDaemons/app.deviceshelf.ChmodBPF.plist
sudo rm -f /Library/LaunchDaemons/app.deviceshelf.ChmodBPF.plist
sudo rm -rf "/Library/Application Support/DeviceShelf"
sudo chown root /dev/bpf*

Windows

1. افتح الإعدادات ← التطبيقات ← التطبيقات المثبتة، وابحث عن DeviceShelf واختر إلغاء التثبيت.
2. تبقى قائمة الأجهزة والإعدادات في %AppData%\DeviceShelf. احذف هذا المجلد لإزالتها أيضًا.
3. لـ Npcap إدخال خاص به في القائمة نفسها. أزله فقط إذا لم يكن أي برنامج آخر على الجهاز يستخدمه، مثل Wireshark.

Linux

1. AppImage: احذف الملف. الحزمة: sudo apt remove deviceshelf (.deb) أو sudo dnf remove deviceshelf (.rpm).
2. توجد قائمة الأجهزة والإعدادات في ~/.config/DeviceShelf. احذف هذا المجلد لإزالتها أيضًا.

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

• اعرض كل جهاز في شبكتك واعثر على عنوان IP الخاص به
• من المتصل بشبكة Wi-Fi لديك؟ اعرض كل جهاز
• تأمين شبكتك المنزلية خطوة بخطوة
• ما الذي يعنيه المنفذ المفتوح فعليًا
• العثور على أجهزة إنترنت الأشياء في شبكتك
• لماذا يعرض هاتفك عنوان MAC عشوائيًا
• فحص الشبكة على نظام Windows
• فحص الشبكة من نظام Linux
• مراقبة الشبكة ذاتية الاستضافة