सीधे कंटेंट पर जाएँ
Localtonet Localtonet डैशबोर्ड

NAS या Home Assistant पर Localtonet चलाएँ

सेटअप टेम्पलेट AMD64 और ARM64

इस पेज पर मदद पाएँ
इस पेज पर 7 सेक्शन
  1. टेम्पलेट क्या हैं
  2. ये क्या नहीं हैं
  3. शुरू करने से पहले
  4. Docker Compose से NAS सेट अप करें
  5. ZIP एक्सट्रैक्ट करें और nas फ़ोल्डर को NAS पर कॉपी करें
  6. टोकन फ़ाइल बनाएँ
  7. compose.yaml को जैसा है वैसा रहने दें
  8. प्रोजेक्ट शुरू करें
  9. टनल बनाएँ और शुरू करें
  10. Compose टेम्पलेट क्या करता है
  11. Home Assistant OS या Supervised सेट अप करें
  12. ऐप फ़ोल्डर कॉपी करें
  13. ऐप स्टोर रीलोड करें और Localtonet इंस्टॉल करें
  14. अपना टोकन दर्ज करें और ऐप शुरू करें
  15. टनल बनाएँ और शुरू करें
  16. अपनी सर्विस तक पहुँचें
  17. लॉग और अपडेट
  18. संबंधित पेज

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 Supervisedhome-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 सेट अप करें #

  1. ZIP एक्सट्रैक्ट करें और nas फ़ोल्डर को NAS पर कॉपी करें #

    अपने कंप्यूटर पर आर्काइव एक्सट्रैक्ट करें। nas फ़ोल्डर को NAS के उस शेयर्ड फ़ोल्डर में कॉपी करें जिसे आपका कंटेनर मैनेजर इस्तेमाल कर सके।

  2. टोकन फ़ाइल बनाएँ #

    nas फ़ोल्डर में auth-token.example को auth-token में कॉपी करें। auth-token खोलें और DUMMY_AUTH_TOKEN की जगह अपना AuthToken डालें, एक ही पंक्ति में, फ़ाइल में और कुछ नहीं।

    टोकन फ़ाइल को निजी रखें। उसे NAS पर सिर्फ़ अपने अकाउंट तक सीमित करें और ऐसे शेयर्ड या सिंक किए जाने वाले फ़ोल्डर में न रखें जिसे दूसरे लोग पढ़ सकें। टोकन से Localtonet क्लाइंट इस डिवाइस के रूप में कनेक्ट हो सकता है।

    फ़ाइल कंटेनर शुरू होने से पहले मौजूद होनी चाहिए। अगर वह नहीं है, तो Docker उसकी जगह auth-token नाम की डायरेक्टरी बना देता है, और कंटेनर उससे टोकन नहीं पढ़ सकता।

  3. compose.yaml को जैसा है वैसा रहने दें #

    आपको compose.yaml बदलने की ज़रूरत नहीं है। उसकी image: पंक्ति में Localtonet इमेज और वह वर्शन लिखा है जिसके लिए यह ZIP बना है, जैसे docker.io/localtonet/localtonet:8.6.0। बाकी पंक्तियाँ Compose टेम्पलेट क्या करता है में समझाई गई हैं।

  4. प्रोजेक्ट शुरू करें #

    compose.yaml को अपने कंटेनर मैनेजर में प्रोजेक्ट के रूप में इंपोर्ट करें और शुरू करें:

    • Synology: Container Manager में nas फ़ोल्डर और उसकी compose.yaml से प्रोजेक्ट बनाएँ।
    • QNAP: Container Station में compose.yaml से एप्लिकेशन बनाएँ। फ़ाइल ./auth-token को Compose फ़ाइल के सापेक्ष माउंट करती है, इसलिए टोकन फ़ाइल उसी पाथ पर पहुँच में होनी चाहिए।
    • शेल वाला कोई भी Docker होस्ट: नीचे दी गई कमांड nas डायरेक्टरी से चलाएँ।
    Bash
    docker compose up -d

    सटीक स्क्रीन NAS मॉडल और वर्शन के हिसाब से अलग होती हैं। Compose फ़ाइल से प्रोजेक्ट बनाने के लिए अपने वेंडर के दस्तावेज़ देखें।

  5. टनल बनाएँ और शुरू करें #

    कंटेनर चलने लगे, तो डैशबोर्ड खोलें, फ़ाइल में डाले गए टोकन से टनल बनाएँ और शुरू करें चुनें, जैसा क्विक स्टार्ट में है।

Compose टेम्पलेट क्या करता है #

यह पूरी फ़ाइल है। image: पंक्ति के अंत का टैग वह Localtonet वर्शन है जिसके लिए आपका ZIP बना है; 8.6.0 एक उदाहरण है।

nas/compose.yaml
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
सेटिंगयह क्या करता है
imageLocaltonet इमेज, 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 के ज़रिए चलाते हैं। टेम्पलेट एक लोकल ऐप है जिसे आप डिवाइस पर कॉपी करते हैं।

  1. ऐप फ़ोल्डर कॉपी करें #

    ZIP एक्सट्रैक्ट करें। फ़ोल्डर home-assistant/localtonet को अपने Home Assistant की लोकल ऐप डायरेक्टरी में कॉपी करें, ताकि वह /addons/localtonet बन जाए। फ़ोल्डर में एक ही फ़ाइल है, config.json। इसे न बदलें: इसमें ऐप का नाम Localtonet, इमेज docker.io/localtonet/localtonet और वह वर्शन है जिसके लिए यह ZIP बना है, और authtoken विकल्प आपके बाद में भरने के लिए खाली छोड़ा गया है।

  2. ऐप स्टोर रीलोड करें और Localtonet इंस्टॉल करें #

    Home Assistant में ऐप स्टोर रीलोड करें ताकि उसे लोकल ऐप मिल जाए, फिर Localtonet इंस्टॉल करें।

  3. अपना टोकन दर्ज करें और ऐप शुरू करें #

    ऐप का Configuration पेज खोलें, authtoken विकल्प में अपना AuthToken दर्ज करें और ऐप शुरू करें। Home Assistant मान को पासवर्ड की तरह छिपा देता है। इसके बाद ऐप Home Assistant के साथ अपने आप शुरू होता है।

  4. टनल बनाएँ और शुरू करें #

    डैशबोर्ड में उसी टोकन से टनल बनाएँ और शुरू करें चुनें। 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 टैब में, या इस कमांड से पढ़ें:

Bash
docker compose logs -f localtonet

Invalid 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 सेट अप करें
  1. ZIP एक्सट्रैक्ट करें और README.txt पढ़ें।
  2. NAS के लिए nas/auth-token.example को nas/auth-token में कॉपी करें और अपना AuthToken दर्ज करें। इस फ़ाइल को निजी रखें।
  3. nas/compose.yaml में इमेज टैग जाँचें, फिर इसे प्रोजेक्ट के रूप में इम्पोर्ट करें या nas डायरेक्टरी से docker compose up -d चलाएँ।
  4. Home Assistant OS / Supervised के लिए README में दिए गए लोकल ऐप इंस्टॉलेशन निर्देशों का पालन करें और ऐप कॉन्फ़िगरेशन में टोकन दर्ज करें।

टेम्पलेट LAN एक्सेस के लिए Linux होस्ट नेटवर्किंग का उपयोग करते हैं। ये VPN अधिकार चालू नहीं करते।

सपोर्ट