التكامل

شبكتك، داخل Home Assistant

ينشر NetPulse حالة الأسطول إلى broker MQTT، ويكتشفه Home Assistant تلقائيًا: ينشئ الأجهزة وكياناتها دون أن تعرّف شيئًا يدويًا. كل شيء يحدث في شبكتك المحلية.

ثبّت على شبكتك اقرأ الدليل
ما الذي تحصل عليه

شبكتك ككيان إضافي في منزلك

يكتب NetPulse حالة شبكتك في broker MQTT الذي تشغّله أصلًا لـ Home Assistant. ومن هناك تصبح الراوترات ومقاييسها متاحة للوحات والأتمتة والتنبيهات، تمامًا كإضاءة أو مستشعر حرارة.

التثبيت كاملًا

جهاز واحد للحالة العامة (الدرجة والتصنيف)، والعملاء المتصلون والإجمالي، والراوترات المتصلة والإجمالي، والتنبيهات غير المقروءة.

كل راوتر، على حدة

جهاز واحد لكل راوتر يبيّن ما إذا كان متصلًا، وصحته، وCPU، والذاكرة، والحرارة، وعدد العملاء. مرتبط بالتثبيت ليتجمّع في اللوحة.

التنبيهات فور حدوثها

يُنشر كل تنبيه كحدث في لحظة انطلاقه (حرارة، انقطاع WAN، جهاز جديد...)، لتحوّله إلى الأتمتة التي تريدها.

يكتب NetPulse ولا يستمع: إنه ناشر. من Home Assistant تقرأ الشبكة؛ وللتحكم في راوتر تستخدم NetGrip، لوحته، التي تتحدث MQTT أيضًا وتقبل الأوامر.

البدء

أربع خطوات، مرة واحدة

يأتي معطّلًا: حتى تشغّله، لا ينشر NetPulse شيئًا. يُضبط عبر متغيرات البيئة (أو خيارات UCI في وضع on-box).

  • broker MQTT (إضافة Mosquitto في Home Assistant هي الخيار المعتاد)
  • اكتشاف MQTT مفعّل في Home Assistant (وهو المعتاد مع Mosquitto)
  • اسم نسخة إذا كان لديك أكثر من تثبيت (منزل، مكتب...)
  • لا شيء آخر: لا منافذ لفتحها، ولا راوتر للمسه

متغيرات البيئة (أو بطاقة MQTT في الإعدادات)

NETPULSE_MQTT_ENABLED=1 NETPULSE_MQTT_HOST=10.0.0.10 NETPULSE_MQTT_USER=netpulse NETPULSE_MQTT_PASS=... NETPULSE_MQTT_INSTANCE=casa

بعد إعادة التشغيل يُظهر السجل "[mqtt] connected ... as instance \"home\"". وتستغرق الحالة الأولى فاصلًا واحدًا على الأكثر.

الكيانات

ما يظهر في Home Assistant

جهاز للتثبيت وآخر لكل راوتر، معلّق من الأول. وهذه هي الكيانات التي تُنشأ تلقائيًا:

الجهاز الكيان النوع الوحدة
NetPulse <instancia>Health scoreمستشعر
Clients onlineمستشعر
Routers onlineمستشعر
Unread alertsمستشعر
NetPulse versionمستشعر (تشخيصي)
كل راوترOnlineثنائي (الاتصال)
Healthمستشعر
CPU usageمستشعر%
Memory usageمستشعر%
Temperatureمستشعر°C
Clientsمستشعر (تشخيصي)

إذا كان راوتر يشغّل NetGrip مع MQTT مفعّلًا، فإن NetGrip هو من يعرضه إلى Home Assistant ولا ينشره NetPulse: سترى جهازًا واحدًا فقط لكل راوتر.

جهاز راوتر في Home Assistant، مع كياناته المنشأة بالاكتشاف.

والمزيد: NetGrip

تحكّم في الراوتر من Home Assistant

NetPulse ينشر فقط، لكن الراوترات التي تشغّل NetGrip (لوحته) تقبل أيضًا أوامر عبر MQTT. مع تفعيل NetGrip، لا يرى Home Assistant الراوتر فحسب: بل يقوده.

الإجراء موضوع الأمر القيمة
WiFi الضيوفnetgrip/<router>/command/guest_wifiON / OFF
banIPnetgrip/<router>/command/banipON / OFF / RELOAD
IPv6netgrip/<router>/command/ipv6ON / OFF
SQMnetgrip/<router>/command/sqmON / OFF
إعادة التشغيلnetgrip/<router>/command/rebootPRESS

يردّ كل راوتر بالنتيجة على netgrip/<router>/result. وينشر أيضًا 17 مستشعرًا خاصًا به: العملاء لكل نطاق، وأضعف إشارة WiFi ومتوسطها، وحركة الشبكة المحلية.

لوحة Home Assistant مع حركة الشبكة المحلية وصحة التثبيت.

ما ينبغي أن تعرفه

  • اتصال broker لا يحمل TLS (المنفذ 1883): مخصص لـ broker في شبكتك المحلية، لا لعرضه على الإنترنت.
  • معطّل حتى تشغّله، وفي وضع العرض لا ينشر شيئًا.
  • لا سحابة في المنتصف: تنتقل البيانات من NetPulse إلى broker ثم منه إلى Home Assistant، دون المرور بأي طرف ثالث.
  • إذا سقط broker، لا يلاحظ NetPulse: يفشل النشر بصمت ويعيد المحاولة. تبقى المراقبة تعمل.

جرّبه على شبكتك

ثبّت NetPulse، ووجّه نسخته إلى broker، وفي دقيقة ستكون شبكتك داخل Home Assistant.

ثبّت على شبكتك المزايا
المظهر
السمة