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

Docker में Localtonet चलाएँ

इस पेज पर मदद पाएँ
इस पेज पर 12 सेक्शन
  1. शुरू करने से पहले
  2. चरण
  3. इमेज पुल करें
  4. अपने टोकन के साथ कंटेनर शुरू करें
  5. टनल बनाएँ और शुरू करें
  6. कंटेनर कैसे चलता है
  7. बैकग्राउंड में चलाएँ और अपने-आप रीस्टार्ट करें
  8. टोकन देने के तरीके
  9. Docker Compose
  10. कंटेनर से अपनी सर्विस तक पहुँचें
  11. लॉग पढ़ें
  12. अपडेट
  13. रजिस्ट्री एक्सेस के बिना होस्ट के लिए इमेज आर्काइव
  14. समस्या निवारण
  15. संबंधित पेज

आधिकारिक इमेज localtonet/localtonet Localtonet क्लाइंट को कंटेनर में चलाती है। अपना AuthToken दें, फिर डैशबोर्ड में हमेशा की तरह टनल बनाएँ और शुरू करें।

शुरू करने से पहले #

  • 64-बिट होस्ट पर Docker। इमेज linux/amd64 और linux/arm64 के लिए प्रकाशित है, और Docker आपके होस्ट से मेल खाने वाली इमेज खुद चुन लेता है। 32-बिट ARM डिवाइस के लिए इसकी जगह Linux बिल्ड इस्तेमाल करें।
  • मेरे टोकन से एक AuthToken। हर कंटेनर को उसका अपना टोकन दें: जब उसी टोकन से दूसरा क्लाइंट कनेक्ट होता है, तो पहला डिस्कनेक्ट हो जाता है।

चरण #

  1. इमेज पुल करें #

    पहले पुल करने से यह पक्का होता है कि आप मौजूदा वर्शन चला रहे हैं, न कि होस्ट पर पड़ी कोई पुरानी इमेज।

    Bash
    docker pull localtonet/localtonet

    इमेज Docker Hub पर है। latest के अलावा, अगर आप कोई रिलीज़ पिन करना चाहें तो Docker Hub हर वर्शन के लिए एक टैग सूचीबद्ध करता है।

  2. अपने टोकन के साथ कंटेनर शुरू करें #

    इमेज के नाम के बाद का सब कुछ Localtonet क्लाइंट को दे दिया जाता है। <YOUR_TOKEN> की जगह अपना AuthToken लगाएँ।

    Bash
    docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

    कंटेनर अपने कनेक्शन की स्थिति प्रिंट करता है और फ़ोरग्राउंड में बना रहता है। उसे रोकने के लिए Ctrl + C दबाएँ।

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

    डैशबोर्ड खोलें, उसी टोकन से टनल बनाएँ जो आपने कंटेनर को दिया है, और शुरू करें चुनें। क्विक स्टार्ट में फ़ॉर्म दिखाया गया है। लोकल IP एड्रेस भरने से पहले कंटेनर से अपनी सर्विस तक पहुँचें पढ़ लें, क्योंकि कंटेनर के अंदर 127.0.0.1 का मतलब अलग होता है।

कंटेनर कैसे चलता है #

इमेज क्लाइंट को हेडलेस मोड में शुरू करती है। डेस्कटॉप पर चलने वाले क्लाइंट की तुलना में इससे तीन चीज़ें बदलती हैं:

  • यह कभी कोई सवाल नहीं पूछता। अगर टोकन गायब या गलत फ़ॉर्मैट का है, तो कंटेनर एरर प्रिंट करता है और कोड 2 के साथ बाहर निकल जाता है।
  • यह लाइव स्टेटस तालिका की जगह सादी लॉग लाइनें लिखता है, -it के साथ शुरू करने पर भी।
  • यह टोकन सेव नहीं करता। इमेज कोई वॉल्यूम घोषित नहीं करती, इसलिए कंटेनर बनाते समय हर बार टोकन दें: कमांड लाइन पर, एनवायरनमेंट वेरिएबल में या फ़ाइल के रूप में।

टनल कंटेनर में कॉन्फ़िगर नहीं होते। आप उन्हें डैशबोर्ड में बनाते, शुरू करते और रोकते हैं, और कंटेनर उन्हें अपने कनेक्शन से उठा लेता है।

बैकग्राउंड में चलाएँ और अपने-आप रीस्टार्ट करें #

डिटैच करने के लिए -d और रीस्टार्ट पॉलिसी इस्तेमाल करें, ताकि रीबूट या क्रैश के बाद Docker कंटेनर को फिर शुरू कर दे:

Bash
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

इसे सामान्य Docker कमांड से मैनेज करें:

कमांडयह क्या करता है
docker psचल रहे कंटेनर सूचीबद्ध करता है।
docker logs -f localtonetक्लाइंट का लॉग फ़ॉलो करता है।
docker stop localtonetक्लाइंट को रोकता है। उसके टनल ऑफ़लाइन हो जाते हैं।
docker start localtonetउसी टोकन के साथ उसे फिर शुरू करता है।
docker rm -f localtonetकंटेनर हटाता है।

टोकन देने के तरीके #

कमांड लाइन पर दिया गया टोकन docker inspect में और होस्ट की प्रोसेस सूची में दिखता है। इमेज टोकन को एनवायरनमेंट से या फ़ाइल से भी पढ़ती है:

स्रोतकैसे इस्तेमाल करेंटिप्पणियाँ
--authtoken <YOUR_TOKEN>इमेज के नाम के बाद आर्गुमेंट।सबसे आसान। LOCALTONET_AUTH_TOKEN पर भारी पड़ता है।
LOCALTONET_AUTH_TOKENटोकन रखने वाला एनवायरनमेंट वेरिएबल।जब कोई --authtoken आर्गुमेंट न दिया गया हो तब इस्तेमाल होता है।
LOCALTONET_AUTH_TOKEN_FILEएनवायरनमेंट वेरिएबल जिसमें कंटेनर के अंदर उस फ़ाइल का पाथ होता है जिसमें सिर्फ़ टोकन है।टोकन फ़ाइल हमेशा सीधे दिए गए टोकन पर भारी पड़ती है। आर्गुमेंट --authtoken-file <PATH> भी यही करता है।

इमेज खुद LOCALTONET_HEADLESS=1 सेट करती है। आपको इसे सेट करने की ज़रूरत नहीं है।

टोकन फ़ाइल के साथ टोकन को कंटेनर की परिभाषा से बाहर रखें और उसे रीड-ओनली माउंट करें:

Bash
printf '%s' '<YOUR_TOKEN>' > auth-token
chmod 600 auth-token

docker run -d \
  --name localtonet \
  --restart unless-stopped \
  -e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
  -v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
  localtonet/localtonet

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

कनेक्ट किए बिना टोकन स्रोत जाँचने के लिए --check-config जोड़ें। क्लाइंट जाँचता है कि टोकन मौजूद है और सही फ़ॉर्मैट का है (33 अक्षर, कोई स्पेस नहीं), Localtonet headless configuration OK. प्रिंट करता है और बाहर निकल जाता है। वह सर्वर से नहीं पूछता कि टोकन मान्य है या नहीं।

Bash
docker run --rm \
  -e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
  -v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
  localtonet/localtonet --check-config

Docker Compose #

वही सेटअप Compose फ़ाइल के रूप में। टोकन को compose.yaml के बगल में auth-token नाम की फ़ाइल में रखें:

compose.yaml
services:
  localtonet:
    image: localtonet/localtonet
    restart: unless-stopped
    environment:
      LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
    volumes:
      - ./auth-token:/run/secrets/localtonet_auth_token:ro
Bash
docker compose up -d
docker compose logs -f localtonet

जब आप जिस सर्विस को पब्लिश करना चाहते हैं वह Linux होस्ट पर उसी Compose प्रोजेक्ट में हो, तो उसका पोर्ट होस्ट पर पब्लिश करें और Localtonet कंटेनर को होस्ट नेटवर्किंग के साथ चलाएँ। टनल का लोकल एड्रेस IP एड्रेस होना चाहिए, इसलिए इसके लिए web जैसा Compose सर्विस नाम इस्तेमाल नहीं हो सकता:

compose.yaml
services:
  web:
    image: nginx
    ports:
      - "8080:80"

  localtonet:
    image: localtonet/localtonet
    restart: unless-stopped
    network_mode: host
    environment:
      LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
    volumes:
      - ./auth-token:/run/secrets/localtonet_auth_token:ro

इस उदाहरण के लिए टनल का लोकल एड्रेस 127.0.0.1 और लोकल पोर्ट 8080 सेट करें।

NAS या Home Assistant के लिए तैयार टेम्पलेट NAS और Home Assistant पेज पर हैं।

कंटेनर से अपनी सर्विस तक पहुँचें #

टनल का लोकल IP एड्रेस और लोकल पोर्ट क्लाइंट को बताते हैं कि आपकी सर्विस कहाँ है। क्लाइंट कंटेनर के अंदर से कनेक्ट करता है, जहाँ 127.0.0.1 कंटेनर खुद है, आपकी मशीन नहीं। IP एड्रेस दर्ज करें: क्लाइंट host.docker.internal, Compose सर्विस नाम या कंटेनर नाम जैसे Docker नामों को नहीं खोजता। वह मान इस्तेमाल करें जो उस जगह से मेल खाता हो जहाँ सर्विस चलती है:

सर्विस कहाँ चलती हैकौन-सा लोकल एड्रेस दर्ज करेंऔर क्या चाहिए
Docker होस्ट पर, Linux127.0.0.1कंटेनर को --network host के साथ शुरू करें (Compose: network_mode: host)। तब कंटेनर होस्ट का नेटवर्क साझा करता है।
Docker होस्ट पर, होस्ट नेटवर्किंग के बिना (Windows या macOS पर Docker Desktop समेत)होस्ट का LAN IP एड्रेस, जैसे 192.168.1.10सर्विस को ऐसे एड्रेस पर सुनना होगा जिस तक कंटेनर पहुँच सके, सिर्फ़ 127.0.0.1 पर नहीं, और होस्ट का फ़ायरवॉल कनेक्शन की अनुमति देता हो।
किसी दूसरे कंटेनर मेंLinux पर --network host के साथ 127.0.0.1, वरना होस्ट का LAN IP एड्रेसउस कंटेनर का पोर्ट होस्ट पर पब्लिश करें (-p, Compose: ports) और पब्लिश किए गए पोर्ट को टनल के लोकल पोर्ट के रूप में इस्तेमाल करें।
आपके नेटवर्क के किसी दूसरे डिवाइस परउस डिवाइस का LAN IP एड्रेस, जैसे 192.168.1.20कुछ नहीं।
Linux, होस्ट पर सर्विस
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  --network host \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

आप किसी मौजूदा टनल का एड्रेस उसकी सेटिंग्स में लोकल एड्रेस के अंतर्गत बदल सकते हैं। देखें सेटिंग्स रेफ़रेंस।

लॉग पढ़ें #

docker logs -f localtonet हर बदलाव के लिए एक लाइन दिखाता है। पहली लाइन के बाद की हर लाइन टाइमस्टैम्प से शुरू होती है:

लाइनमतलब
Localtonet - headless logक्लाइंट शुरू हुआ।
Connection: …Localtonet से कनेक्शन की स्थिति। बदलने पर नई लाइन आती है।
AuthTokenName: …उस टोकन का नाम जिससे कंटेनर ने साइन इन किया, जैसा मेरे टोकन में दिखता है।
OPEN …, ADDED …इस टोकन का एक टनल। क्लाइंट शुरू होते समय मौजूद टनल के लिए OPEN और बाद में आने वाले टनल के लिए ADDED इस्तेमाल होता है।
STATUS …किसी टनल की स्थिति बदल गई।
CLOSED …इस क्लाइंट से एक टनल हटा दिया गया।
Authentication failed: AuthToken was rejected.Localtonet ने टोकन स्वीकार नहीं किया।

टोकन खुद कभी लॉग में नहीं लिखा जाता।

अपडेट #

इमेज को फिर से पुल करें और कंटेनर दोबारा बनाएँ:

Bash
docker pull localtonet/localtonet
docker rm -f localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>

Compose के साथ docker compose pull और फिर docker compose up -d चलाएँ। हमेशा सबसे नई इमेज से शुरू करने के लिए docker run में --pull always जोड़ें।

रजिस्ट्री एक्सेस के बिना होस्ट के लिए इमेज आर्काइव #

अगर होस्ट Docker Hub तक नहीं पहुँच सकता, तो इमेज को किसी दूसरी मशीन पर TAR आर्काइव के रूप में डाउनलोड करें, उसे कॉपी करें और लोड करें:

आर्किटेक्चरआर्काइव
AMD64localtonet-docker-amd64.tar
ARM64localtonet-docker-arm64.tar
Bash
docker load --input localtonet-docker-amd64.tar

docker load बताता है कि उसने क्या लोड किया। अगर वह नाम की जगह इमेज ID प्रिंट करे, तो चलाने से पहले इमेज को एक नाम दें:

Bash
docker tag <IMAGE_ID> localtonet/localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>

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

कंटेनर तुरंत "Invalid Localtonet headless configuration" के साथ बाहर निकल जाता है

पूरा संदेश Invalid Localtonet headless configuration. Check the token file or environment settings. है। क्लाइंट को कोई इस्तेमाल लायक टोकन नहीं मिला: कुछ दिया नहीं गया, मान 33 अक्षर का नहीं है, उसके बीच में स्पेस या लाइन ब्रेक है, या टोकन फ़ाइल का पाथ कंटेनर में मौजूद नहीं है। अगर आप टोकन फ़ाइल माउंट करते हैं, तो होस्ट पर जाँचें कि वह फ़ाइल है, डायरेक्टरी नहीं। रीस्टार्ट पॉलिसी के साथ कंटेनर तब तक बार-बार रीस्टार्ट होता रहता है जब तक आप टोकन ठीक नहीं करते, इसलिए docker logs localtonet पढ़ें।

लॉग में "Authentication failed: AuthToken was rejected." दिखता है

टोकन सही फ़ॉर्मैट का है लेकिन Localtonet उसे स्वीकार नहीं करता। उसे मेरे टोकन से फिर कॉपी करें और कंटेनर दोबारा बनाएँ।

टनल शुरू है लेकिन पब्लिक एड्रेस मेरी सर्विस तक नहीं पहुँचता

टनल का लोकल एड्रेस जाँचें। 127.0.0.1 Linux पर सिर्फ़ --network host के साथ काम करता है। वरना होस्ट का LAN IP एड्रेस इस्तेमाल करें। host.docker.internal जैसा नाम या किसी दूसरे कंटेनर का नाम इस फ़ील्ड में काम नहीं करता, जैसा कंटेनर से अपनी सर्विस तक पहुँचें में बताया गया है।

कंटेनर बार-बार कनेक्शन खो देता है

पक्का करें कि कोई दूसरा क्लाइंट वही टोकन इस्तेमाल नहीं कर रहा। उस टोकन से कनेक्ट होने वाला दूसरा क्लाइंट पहले को डिस्कनेक्ट कर देता है। मेरे टोकन में हर कंटेनर या डिवाइस के लिए एक टोकन बनाएँ।

सपोर्ट