चेतावनी: यह एक प्रारंभिक रिलीज़ है, कृपया अब तक की सभी रिलीज़ों के रिलीज़ नोट्स पढ़ें

OpenSOHO

प्रलेखन

OpenSOHO को OpenWRT-आधारित नेटवर्क उपकरणों की कम संख्या प्रबंधित करने के लिए बनाया गया है। इसलिए नाम SOHO, Small Office Home Office (SOHO) Networks से लिया गया है।

• 2 से 20 डिवाइस (कोई कठोर सीमा नहीं है)
• कोई मल्टी-टेनेंसी नहीं
• openwisp-config और openwisp-monitoring के साथ संगत
• तैनात करने के लिए सरल

यह OpenWISP से प्रेरित है, लेकिन उन नेटवर्कों को लक्षित करता है जो OpenWISP के साथ प्रबंधित करने के लिए बहुत छोटे हैं। जैसा कि OpenWisp ने उल्लेख किया है:

हालाँकि, OpenWISP बहुत छोटे नेटवर्कों (20 से कम डिवाइस), IT विशेषज्ञता की कमी वाले संगठनों, या केवल लागत बचत के उद्देश्यों के लिए ओपन-सोर्स विकल्प चाहने वाले उद्यमों के लिए सबसे उपयुक्त नहीं हो सकता है।

निम्नलिखित संस्करणों का परीक्षण किया गया है

• OpenWRT 24.10.x DSA
• OpenWRT 25.12.x DSA (बीटा समर्थन)

OpenSOHO के साथ शुरुआत करना

अवलोकन

OpenSOHO सेट करने के लिए कुछ सरल चरणों की आवश्यकता होती है, जिनमें से प्रत्येक का विवरण नीचे दिए गए अनुभागों में है:

• अपने सर्वर पर OpenSOHO स्थापित करें।
• अपने OpenWRT डिवाइसों पर OpenWisp पैकेज स्थापित करें।
• OpenSOHO से कनेक्ट करने के लिए अपने प्रत्येक OpenWRT डिवाइस पर OpenWisp कॉन्फ़िगर करें।
• OpenSOHO में कॉन्फ़िगर करना शुरू करें!

OpenSOHO स्थापित करें

• नवीनतम OpenSOHO रिलीज़ डाउनलोड करें (या डॉकर कंटेनर का उपयोग करें)

  रिलीज़

  Docker, Podman या Kubernetes के साथ सेटअप

• OpenSOHO प्रारंभ करें

सबसे पहले, एक shared secret चुनें जो OpenWRT डिवाइसों (openwisp-config का उपयोग करके) को OpenSOHO के साथ पंजीकरण करने की अनुमति देता है।

इष्टतम सुरक्षा के लिए एक लंबी यादृच्छिक स्ट्रिंग चुनें।

यह LuCI में अगले चरणों में आपके द्वारा कॉन्फ़िगर किए गए मान से मेल खाना चाहिए।

OPENSOHO_SHARED_SECRET=randompassphrase ./opensoho serve --http 0.0.0.0:8090

अब, OpenSOHO कमांड-लाइन पर एक URL प्रदर्शित करता है जो आपको व्यवस्थापक खाता बनाने की अनुमति देता है। बस URL को अपने ब्राउज़र में खोलें।

वैकल्पिक रूप से, कमांड-लाइन के माध्यम से व्यवस्थापक खाता बनाएं:

./opensoho superuser upsert EMAIL PASS

OpenWRT डिवाइसों को कॉन्फ़िगर करना (अपनाना)

OpenWISP पैकेज स्थापित करें

opkg install openwisp-config openwisp-monitoring luci-app-openwisp # OpenWRT 24.10
apk add openwisp-config openwisp-monitoring luci-app-openwisp # OpenWRT 25.12+

यदि आप 802.11v क्लाइंट स्टीयरिंग का उपयोग करना चाहते हैं, तो पूर्ण wpad-mbedtls आवश्यक है।

OpenWRT 24.10 पर

opkg remove wpad-basic-mbedtls && \
opkg install wpad-mbedtls && \
service wpad restart

OpenWRT 25.12+ पर

apk del wpad-basic-mbedtls && \
apk add wpad-mbedtls && \
service wpad restart

wpad-mbedtls स्थापित होने के बाद, पहले service restart wpad आज़माएँ, अन्यथा नए wpad बाइनरी पर स्विच करने के लिए रीबूट की आवश्यकता हो सकती है। यदि ऐसा नहीं करते हैं, तो आपको daemon.notice netifd: radio1 (28210): WARNING (wireless_add_process): executable path /usr/sbin/wpad does not match process 1842 path (/usr/sbin/wpad (deleted)) जैसी त्रुटि मिल सकती है। (कृपया ध्यान दें कि 802.11v क्लाइंट स्टीयरिंग अभी भी कार्य प्रगति पर है)

LuCI में OpenWISP कॉन्फ़िगर करें:

• केवल Server URL और Shared secret सेट करें।
  • Server URL के अंत में स्लैश नहीं जोड़ें। एक उदाहरण URL: http://192.168.1.1:8090
  • shared secret वह मान है जिसे आपने पहले चुना था (OPENSOHO_SHARED_SECRET)।
• वैकल्पिक रूप से, तेज़ अपडेट के लिए Update Interval को 30 सेकंड तक कम करें। (यदि आप नहीं करते हैं तो OpenSOHO यह आपके लिए करता है)
• OpenSOHO मॉनिटरिंग भी सक्षम करता है और नेटवर्क स्थिति के त्वरित अपडेट के लिए मॉनिटरिंग अंतराल को 15 सेकंड तक कम करता है।

मॉनिटरिंग सक्षम करने की अत्यधिक अनुशंसा की जाती है, क्योंकि OpenSOHO वर्तमान OpenWRT सेटिंग्स में से कई का अनुमान लगाता है और आसान कॉन्फ़िगरेशन के लिए उन्हें भर देता है।

OpenSOHO कॉन्फ़िगर करें

• OpenWrt डिवाइस(ों) के shared secret का उपयोग करके स्व-पंजीकरण करने की प्रतीक्षा करें।
• डिवाइस का Enabled फ़्लैग true पर सेट करें।
• numradios को सही मान पर सेट करें। उदाहरण के लिए, 2.4 + 5GHz डिवाइस के लिए, यह मान 2 होगा।
• एक वाई-फाई एक्सेस पॉइंट (SSID+KEY) सेट करें। यह प्रक्रिया OpenSOHO को डिवाइस पंजीकरण पर रेडियो कॉन्फ़िगरेशन को सही ढंग से पहचानने की अनुमति देती है।
• कॉन्फ़िगर किए गए वाई-फाई एक्सेस पॉइंट को किसी डिवाइस से जोड़ें ताकि वह कॉन्फ़िगर हो सके।
• वर्तमान में, प्रत्येक नेटवर्क स्वचालित रूप से सभी रेडियो पर कॉन्फ़िगर किया जाएगा (numradios का उपयोग करके कॉन्फ़िगर किया गया)।
• वैकल्पिक रूप से, एलईडी (leds) को भी चालू या बंद किया जा सकता है (अभी के लिए केवल स्थिर कॉन्फ़िगरेशन)।
• रेडियो आवृत्तियों को कॉन्फ़िगर करना अब समर्थित है। OpenSOHO वर्तमान रेडियो कॉन्फ़िगरेशन को एक बार पढ़ता है और इसे radios कॉन्फ़िगरेशन के अंतर्गत उपलब्ध कराता है। रेडियो कॉन्फ़िगरेशन दिखने में एक या दो मिनट लग सकते हैं (कॉन्फ़िगरेशन और मॉनिटरिंग चरणों को पूरा होने में कुछ समय चाहिए)।

डैशबोर्ड

OpenSOHO एक बुनियादी डैशबोर्ड के साथ आता है। यह सबसे बाएँ साइडबार में OpenSOHO लोगो के ठीक नीचे स्थित बटन के माध्यम से सुलभ है।

कृपया ध्यान दें कि यह अधिक उन्नत ग्राफ़िंग टूल्स के प्रतिस्थापन के रूप में अभिप्रेत नहीं है; इसे जानबूझकर बुनियादी रखा गया है और आगे भी बुनियादी रखा जाएगा।

कॉन्फ़िगर करें

OpenSOHO को अब http://ipaddress:8090/_/ के माध्यम से एक्सेस किया जा सकता है।

यहाँ कई कॉन्फ़िगरेशन कलेक्शन हैं:

क्लाइंट

ये वाई-फाई से जुड़े क्लाइंट हैं। यह तालिका केवल-पठनीय है, alias को छोड़कर। इसका उपयोग उपकरणों को मानव-पठनीय नाम देने के लिए किया जा सकता है। यह केवल तभी ठीक से काम करता है जब क्लाइंट अपने मैक-पते को रैंडमाइज़ नहीं करता है।

कनेक्टेड क्लाइंट

उन क्लाइंटों की सूची शामिल है जो वर्तमान में आपकी वाई-फाई से जुड़े हैं। डिवाइस का IP पता दिखाने के लिए, OpenSOHO को आपकी DHCP लीज़ तक पहुँच की आवश्यकता होती है। ऐसा करने के लिए, आपको DHCP सर्वर वाले डिवाइस पर openwisp मॉनिटरिंग डेमन चलाना होगा। स्थिर IP वाले डिवाइसों को IP नहीं मिलेगा। यह 0.12.0 तक एक ज्ञात सीमा है।

डिवाइस

ये जुड़े हुए डिवाइस हैं।

• कॉन्फ़िगरेशन अपडेट अक्षम करने के लिए enable/disable का उपयोग करें। यह सभी डिवाइसों को एक साथ अपडेट करने से बचने के लिए उपयोगी है। मॉनिटरिंग सक्रिय रहती है।
• स्वास्थ्य स्थिति केवल-पठनीय क्षेत्र है। healthy का अर्थ है कि डिवाइस ने पिछले एक मिनट के भीतर संचार किया है। यदि नहीं, तो स्वास्थ्य स्थिति unhealthy हो जाती है और डिवाइस या उसके कनेक्शन में कुछ गड़बड़ हो सकती है।
• Leds आपको led कॉन्फ़िगरेशन चुनने की अनुमति देता है
• Numradios डिवाइस पर रेडियो की संख्या सेट करने की अनुमति देता है। यह प्रारंभ में OpenWisp द्वारा नहीं भेजा जाता है, इसलिए इसे उपयोगकर्ता द्वारा सेट किया जाना आवश्यक है।
• Wifis आपको इस डिवाइस पर लागू करने के लिए SSID चुनने की अनुमति देता है।

एलईडी

• बुनियादी LED कॉन्फ़िगरेशन (इस समय अधिक एक POC की तरह)

रेडियो

• प्रत्येक रेडियो की आवृत्ति सेट करने की अनुमति देता है।
• बैंड को संशोधित नहीं किया जाना चाहिए, क्योंकि यह OpenSOHO को आवृत्ति कॉन्फ़िगरेशन सत्यापित करने की अनुमति देता है। PocketBase के भीतर सीमाओं के कारण यह आवश्यक है।

वाई-फाई

• विभिन्न SSID सेट करने की अनुमति देता है। एन्क्रिप्शन मोड का चयन वर्तमान में सीमित है। WEP या Open डिज़ाइन द्वारा समर्थित नहीं हैं।

मॉनिटरिंग

डिवाइस मॉनिटरिंग

जाँच करें कि डिवाइस स्वास्थ्य healthy है या नहीं।

कनेक्टेड क्लाइंट

यह दृश्य उन सभी वाई-फाई क्लाइंटों को दिखाता है जो पिछले 30 सेकंड के भीतर अभी भी जुड़े हुए हैं।

Home Assistant एकीकरण

OpenSOHO मॉनिटरिंग को Home Assistant के साथ एकीकृत किया जा सकता है। (अधिक जानकारी) यह REST API Home Assistant के साथ उपयोग के लिए डिज़ाइन की गई है, लेकिन इसे अन्य टूल्स के साथ भी एकीकृत किया जा सकता है।

समस्या निवारण

किसी डिवाइस को पुनः पंजीकृत करें

जब LuCI में OpenWISP Server URL बदलने पर नए कंट्रोलर के साथ ठीक से पंजीकरण नहीं होता है। इसे ठीक करने के लिए:

uci delete openwisp.http.uuid
uci delete openwisp.http.key
/etc/init.d/openwisp-config restart

पहला SSID सक्षम नहीं होता है

OpenWRT में एक समस्या प्रतीत होती है जहाँ किसी वाई-फाई डिवाइस पर पहला कॉन्फ़िगर किया गया SSID स्वतः सक्षम नहीं होता है। समाधान: LuCI में enable बटन पर क्लिक करें।

डेवलपर्स

• निर्भरताएँ स्थापित करें

go mod tidy

• OpenSOHO प्रारंभ करें

shared secret का उपयोग openwisp-config द्वारा पंजीकरण के लिए किया जाता है। इष्टतम सुरक्षा के लिए एक लंबी यादृच्छिक स्ट्रिंग चुनें।

यूनिट परीक्षण चलाना:

go test -cover -v -coverprofile=coverage.out
go tool cover -html=coverage.out

कार्यक्षेत्र

विशेषताएँ

कुछ OpenWISP विशेषताएँ (वर्तमान में) OpenSOHO के कार्यक्षेत्र से बाहर मानी जाती हैं

• फ़र्मवेयर अपडेट: OpenWRT को बार-बार अपडेट करने की आवश्यकता नहीं होती; प्रत्येक डिवाइस पर मैन्युअल रूप से Attended sysupgrade सुविधा का उपयोग करें।
• मल्टी-टेनेंसी
• टेम्पलेट: OpenWISP के पास एक शक्तिशाली और बहुमुखी टेम्पलेट तंत्र है, इसे आसान कॉन्फ़िगरेशन अनुभव प्रदान करने के लिए अधिक निर्देशित (opinionated) सुविधाओं के एक उपसमुच्चय द्वारा प्रतिस्थापित किया गया है।

विकास

लक्ष्य pocketbase का अधिकतम लाभ उठाना है। छोटे संशोधन किए जा सकते हैं क्योंकि pocketbase बैक-एंड में वर्तमान में प्लग-इन प्रणाली का अभाव है। लेकिन pocketbase का फ़ोर्क बनाना लक्ष्य नहीं है, इसलिए अपस्ट्रीम परिवर्तनों को मर्ज करना सीधा बना रहता है।

रिलीज़ करना

GITHUB_TOKEN=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa goreleaser release