NAS या Home Assistant पर Localtonet चलाएँ
सेटअप टेम्पलेट AMD64 और ARM64
इस पेज पर 7 सेक्शन
- टेम्पलेट क्या हैं
- ये क्या नहीं हैं
- शुरू करने से पहले
- Docker Compose से NAS सेट अप करें
- ZIP एक्सट्रैक्ट करें और nas फ़ोल्डर को NAS पर कॉपी करें
- टोकन फ़ाइल बनाएँ
- compose.yaml को जैसा है वैसा रहने दें
- प्रोजेक्ट शुरू करें
- टनल बनाएँ और शुरू करें
- Compose टेम्पलेट क्या करता है
- Home Assistant OS या Supervised सेट अप करें
- ऐप फ़ोल्डर कॉपी करें
- ऐप स्टोर रीलोड करें और Localtonet इंस्टॉल करें
- अपना टोकन दर्ज करें और ऐप शुरू करें
- टनल बनाएँ और शुरू करें
- अपनी सर्विस तक पहुँचें
- लॉग और अपडेट
- संबंधित पेज
Localtonet ऐसे डिप्लॉयमेंट टेम्पलेट देता है जो Localtonet क्लाइंट को Docker चला सकने वाले NAS पर और Home Assistant पर कंटेनर के रूप में चलाते हैं। आप अपना AuthToken जोड़ते हैं, कंटेनर शुरू करते हैं, और फिर डैशबोर्ड में टनल मैनेज करते हैं।
टेम्पलेट क्या हैं #
डाउनलोड एक छोटा ZIP आर्काइव है जिसमें दो टेम्पलेट हैं, कुल पाँच फ़ाइलें:
| टेम्पलेट | किस पर इस्तेमाल करें | फ़ाइलें | आप क्या बदलते हैं |
|---|---|---|---|
NAS / Docker Compose (फ़ोल्डर nas) | Synology Container Manager, QNAP Container Station, Docker चलाने वाला कोई भी दूसरा NAS, और Home Assistant Container या Core होस्ट | nas/compose.yaml और nas/auth-token.example | सिर्फ़ टोकन: auth-token.example को auth-token में कॉपी करें और DUMMY_AUTH_TOKEN की जगह अपना AuthToken डालें। compose.yaml को जैसा है वैसा रहने दें। |
Home Assistant ऐप (फ़ोल्डर home-assistant) | Home Assistant OS और Home Assistant Supervised | home-assistant/localtonet/config.json, यानी लोकल ऐप (पहले ऐड-ऑन कहलाता था) की परिभाषा, और home-assistant/repository.json | फ़ाइलों में कुछ नहीं। ऐप इंस्टॉल करने के बाद आप टोकन Home Assistant में दर्ज करते हैं। लोकल इंस्टॉलेशन repository.json का इस्तेमाल नहीं करता। |
पाँचवीं फ़ाइल, README.txt, इस पेज के चरणों का छोटा टेक्स्ट रूप है।
दोनों टेम्पलेट Localtonet क्लाइंट को कंटेनर में बिना प्रॉम्प्ट के चलाते हैं, जैसा Docker पेज बताता है। ये AMD64 (Intel और AMD प्रोसेसर) और ARM64 के लिए बने हैं। शुरू करने से पहले जाँच लें कि आपके NAS में कौन-सा प्रोसेसर है; 32-बिट ARM NAS इसे नहीं चला सकता।
ये क्या नहीं हैं #
- ये Synology SPK या QNAP QPKG पैकेज नहीं हैं। Synology Package Center या QNAP App Center में कुछ दिखाई नहीं देता।
- Home Assistant टेम्पलेट आधिकारिक Home Assistant स्टोर की लिस्टिंग नहीं है। आप इसे लोकल ऐप के रूप में इंस्टॉल करते हैं।
- इनमें कंटेनर इमेज शामिल नहीं है। आपका डिवाइस वह इमेज खींचता है जिसका नाम टेम्पलेट में है,
docker.io/localtonet/localtonet, जो Docker Hub पर Docker पेज वाली इमेज है। - ये कंटेनर को वे विशेषाधिकार नहीं देते जो VPN इंटरफ़ेस को चाहिए। टेम्पलेट टनल के लिए हैं; VPN सुविधा इनका हिस्सा नहीं है।
शुरू करने से पहले #
- Docker और Docker Compose सपोर्ट वाला NAS, या Home Assistant OS / Supervised।
- मेरे टोकन से एक AuthToken। ऐसा टोकन इस्तेमाल करें जिसे कोई और डिवाइस इस्तेमाल न करता हो: उसी टोकन से दूसरा क्लाइंट कनेक्ट होने पर पहला डिस्कनेक्ट हो जाता है।
- टेम्पलेट ZIP। डाउनलोड इस पेज के अंत की सूची में और डाउनलोड पेज पर है।
Docker Compose से NAS सेट अप करें #
-
ZIP एक्सट्रैक्ट करें और nas फ़ोल्डर को NAS पर कॉपी करें #
अपने कंप्यूटर पर आर्काइव एक्सट्रैक्ट करें।
nasफ़ोल्डर को NAS के उस शेयर्ड फ़ोल्डर में कॉपी करें जिसे आपका कंटेनर मैनेजर इस्तेमाल कर सके। -
टोकन फ़ाइल बनाएँ #
nasफ़ोल्डर मेंauth-token.exampleकोauth-tokenमें कॉपी करें।auth-tokenखोलें औरDUMMY_AUTH_TOKENकी जगह अपना AuthToken डालें, एक ही पंक्ति में, फ़ाइल में और कुछ नहीं।टोकन फ़ाइल को निजी रखें। उसे NAS पर सिर्फ़ अपने अकाउंट तक सीमित करें और ऐसे शेयर्ड या सिंक किए जाने वाले फ़ोल्डर में न रखें जिसे दूसरे लोग पढ़ सकें। टोकन से Localtonet क्लाइंट इस डिवाइस के रूप में कनेक्ट हो सकता है।
फ़ाइल कंटेनर शुरू होने से पहले मौजूद होनी चाहिए। अगर वह नहीं है, तो Docker उसकी जगह
auth-tokenनाम की डायरेक्टरी बना देता है, और कंटेनर उससे टोकन नहीं पढ़ सकता। -
compose.yaml को जैसा है वैसा रहने दें #
आपको
compose.yamlबदलने की ज़रूरत नहीं है। उसकीimage:पंक्ति में Localtonet इमेज और वह वर्शन लिखा है जिसके लिए यह ZIP बना है, जैसेdocker.io/localtonet/localtonet:8.6.0। बाकी पंक्तियाँ Compose टेम्पलेट क्या करता है में समझाई गई हैं। -
प्रोजेक्ट शुरू करें #
compose.yamlको अपने कंटेनर मैनेजर में प्रोजेक्ट के रूप में इंपोर्ट करें और शुरू करें:- Synology: Container Manager में
nasफ़ोल्डर और उसकीcompose.yamlसे प्रोजेक्ट बनाएँ। - QNAP: Container Station में
compose.yamlसे एप्लिकेशन बनाएँ। फ़ाइल./auth-tokenको Compose फ़ाइल के सापेक्ष माउंट करती है, इसलिए टोकन फ़ाइल उसी पाथ पर पहुँच में होनी चाहिए। - शेल वाला कोई भी Docker होस्ट: नीचे दी गई कमांड
nasडायरेक्टरी से चलाएँ।
Bashdocker compose up -dसटीक स्क्रीन NAS मॉडल और वर्शन के हिसाब से अलग होती हैं। Compose फ़ाइल से प्रोजेक्ट बनाने के लिए अपने वेंडर के दस्तावेज़ देखें।
- Synology: Container Manager में
-
टनल बनाएँ और शुरू करें #
कंटेनर चलने लगे, तो डैशबोर्ड खोलें, फ़ाइल में डाले गए टोकन से टनल बनाएँ और शुरू करें चुनें, जैसा क्विक स्टार्ट में है।
Compose टेम्पलेट क्या करता है #
यह पूरी फ़ाइल है। image: पंक्ति के अंत का टैग वह Localtonet वर्शन है जिसके लिए आपका ZIP बना है; 8.6.0 एक उदाहरण है।
services:
localtonet:
image: "docker.io/localtonet/localtonet:8.6.0"
restart: unless-stopped
network_mode: host
environment:
LOCALTONET_HEADLESS: "1"
LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
volumes:
- ./auth-token:/run/secrets/localtonet_auth_token:ro| सेटिंग | यह क्या करता है |
|---|---|
image | Localtonet इमेज, docker.io/localtonet/localtonet, और चलाने का वर्शन। टैग तभी बदलें जब आप दूसरे वर्शन पर जाएँ, देखें लॉग और अपडेट। |
restart: unless-stopped | रीबूट या क्रैश के बाद Docker कंटेनर को फिर शुरू करता है, जब तक कि आपने उसे खुद न रोका हो। |
network_mode: host | कंटेनर NAS का नेटवर्क साझा करता है। इससे टनल NAS की अपनी सर्विस तक 127.0.0.1 पर और आपके LAN के दूसरे डिवाइस तक उनके LAN पतों पर पहुँच सकता है। इसके लिए Linux होस्ट नेटवर्किंग चाहिए। |
LOCALTONET_HEADLESS | क्लाइंट को बिना प्रॉम्प्ट के, सादी लॉग पंक्तियों के साथ चलाता है। |
LOCALTONET_AUTH_TOKEN_FILE | कंटेनर के अंदर उस फ़ाइल का पाथ जिससे क्लाइंट टोकन पढ़ता है। |
volumes | आपकी auth-token फ़ाइल को उसी पाथ पर रीड-ओनली माउंट करता है। |
Home Assistant OS या Supervised सेट अप करें #
Home Assistant OS और Supervised ऐप को Supervisor के ज़रिए चलाते हैं। टेम्पलेट एक लोकल ऐप है जिसे आप डिवाइस पर कॉपी करते हैं।
-
ऐप फ़ोल्डर कॉपी करें #
ZIP एक्सट्रैक्ट करें। फ़ोल्डर
home-assistant/localtonetको अपने Home Assistant की लोकल ऐप डायरेक्टरी में कॉपी करें, ताकि वह/addons/localtonetबन जाए। फ़ोल्डर में एक ही फ़ाइल है,config.json। इसे न बदलें: इसमें ऐप का नाम Localtonet, इमेजdocker.io/localtonet/localtonetऔर वह वर्शन है जिसके लिए यह ZIP बना है, औरauthtokenविकल्प आपके बाद में भरने के लिए खाली छोड़ा गया है। -
ऐप स्टोर रीलोड करें और Localtonet इंस्टॉल करें #
Home Assistant में ऐप स्टोर रीलोड करें ताकि उसे लोकल ऐप मिल जाए, फिर Localtonet इंस्टॉल करें।
-
अपना टोकन दर्ज करें और ऐप शुरू करें #
ऐप का Configuration पेज खोलें,
authtokenविकल्प में अपना AuthToken दर्ज करें और ऐप शुरू करें। Home Assistant मान को पासवर्ड की तरह छिपा देता है। इसके बाद ऐप Home Assistant के साथ अपने आप शुरू होता है। -
टनल बनाएँ और शुरू करें #
डैशबोर्ड में उसी टोकन से टनल बनाएँ और शुरू करें चुनें। Home Assistant को खुद प्रकाशित करने के लिए,
127.0.0.1और उस पोर्ट पर HTTP टनल बनाएँ जिस पर आपका Home Assistant सुनता है। Home Assistant का डिफ़ॉल्ट पोर्ट8123है। प्रॉक्सी से आने वाली रिक्वेस्ट के लिए Home Assistant की अपनी सेटिंग्स हैं; अगर वह उन्हें अस्वीकार करता है, तो Home Assistant HTTP दस्तावेज़ देखें।
ऐप होस्ट नेटवर्किंग इस्तेमाल करता है, इसलिए वह Home Assistant और आपके नेटवर्क के दूसरे डिवाइस तक सीधे पहुँचता है। यह Home Assistant आर्किटेक्चर amd64 और aarch64 को सपोर्ट करता है।
Home Assistant Container और Core में Supervisor नहीं होता, इसलिए वे ऐप इंस्टॉल नहीं कर सकते। ऐसे इंस्टॉलेशन पर इसके बजाय Docker होस्ट पर NAS / Docker Compose टेम्पलेट इस्तेमाल करें।
home-assistant/repository.json फ़ाइल उस फ़ोल्डर के बाहर है जिसे आप कॉपी करते हैं और लोकल इंस्टॉलेशन का हिस्सा नहीं है। इसमें रिपॉज़िटरी URL और मेंटेनर के लिए प्लेसहोल्डर मान (DUMMY) हैं; इसे अनदेखा करें।
अपनी सर्विस तक पहुँचें #
दोनों टेम्पलेट होस्ट नेटवर्किंग इस्तेमाल करते हैं। टनल के लोकल IP एड्रेस फ़ील्ड में:
127.0.0.1खुद NAS या Home Assistant होस्ट है। इसे NAS के वेब इंटरफ़ेस, Home Assistant या उस डिवाइस की किसी भी और सर्विस के लिए, उस सर्विस के सुनने वाले पोर्ट के साथ इस्तेमाल करें।192.168.1.20जैसा LAN पता आपके नेटवर्क के किसी दूसरे डिवाइस तक पहुँचता है।
शुरू किया गया टनल इंटरनेट से पहुँचा जा सकता है। NAS का लॉगिन पेज या Home Assistant प्रकाशित करने से पहले, सर्विस पर ही मज़बूत पासवर्ड और टू-फ़ैक्टर साइन-इन रखें, और एक्सेस कंट्रोल पेज के विकल्पों पर विचार करें।
लॉग और अपडेट #
कंटेनर सादी लॉग पंक्तियाँ लिखता है: उसकी कनेक्शन स्थिति, जिस टोकन से उसने साइन इन किया उसका नाम, और हर बार जब कोई टनल जुड़ता है, उसकी स्थिति बदलती है या वह हटाया जाता है तब एक पंक्ति। इन्हें अपने कंटेनर मैनेजर के लॉग व्यू में, Home Assistant में ऐप के Log टैब में, या इस कमांड से पढ़ें:
docker compose logs -f localtonetInvalid Localtonet headless configuration. Check the token file or environment settings. पंक्ति का मतलब है कि क्लाइंट को इस्तेमाल लायक टोकन नहीं मिला: टोकन फ़ाइल गायब या खाली है, उसमें अब भी DUMMY_AUTH_TOKEN है, या टोकन 33 अक्षरों का नहीं है। Authentication failed: AuthToken was rejected. का मतलब है कि टोकन सही बनावट का है लेकिन Localtonet उसे स्वीकार नहीं करता।
हर टेम्पलेट ZIP एक Localtonet वर्शन के लिए बना है: Compose फ़ाइल उसे image: पंक्ति के टैग में तय करती है, और Home Assistant ऐप config.json के version फ़ील्ड में। NAS को नए वर्शन पर ले जाने के लिए, टैग को ऐसे वर्शन से बदलें जो Docker Hub इमेज के लिए सूचीबद्ध करता है (देखें Docker) और docker compose up -d फिर चलाएँ (या अपने कंटेनर मैनेजर में प्रोजेक्ट अपडेट करें)। आपकी auth-token फ़ाइल जैसी है वैसी रहती है।
संबंधित पेज #
NAS और Home Assistant
Synology Container Manager, QNAP Container Station और अन्य Docker-सक्षम NAS डिवाइस के लिए Docker Compose टेम्पलेट, साथ ही OS / Supervised के लिए Home Assistant ऐप टेम्पलेट। AMD64 और ARM64।
ये सेटअप टेम्पलेट हैं, SPK / QPKG इंस्टॉलर या ऑफ़िशियल Home Assistant स्टोर लिस्टिंग नहीं। रजिस्ट्री में मेल खाती Docker इमेज उपलब्ध होनी चाहिए। Home Assistant Container / Core उपयोगकर्ता Compose टेम्पलेट का उपयोग कर सकते हैं।
अपना NAS या Home Assistant सेट अप करें
- ZIP एक्सट्रैक्ट करें और
README.txtपढ़ें। - NAS के लिए
nas/auth-token.exampleकोnas/auth-tokenमें कॉपी करें और अपना AuthToken दर्ज करें। इस फ़ाइल को निजी रखें। nas/compose.yamlमें इमेज टैग जाँचें, फिर इसे प्रोजेक्ट के रूप में इम्पोर्ट करें याnasडायरेक्टरी सेdocker compose up -dचलाएँ।- Home Assistant OS / Supervised के लिए README में दिए गए लोकल ऐप इंस्टॉलेशन निर्देशों का पालन करें और ऐप कॉन्फ़िगरेशन में टोकन दर्ज करें।
टेम्पलेट LAN एक्सेस के लिए Linux होस्ट नेटवर्किंग का उपयोग करते हैं। ये VPN अधिकार चालू नहीं करते।