Docker में Localtonet चलाएँ
इस पेज पर 12 सेक्शन
- शुरू करने से पहले
- चरण
- इमेज पुल करें
- अपने टोकन के साथ कंटेनर शुरू करें
- टनल बनाएँ और शुरू करें
- कंटेनर कैसे चलता है
- बैकग्राउंड में चलाएँ और अपने-आप रीस्टार्ट करें
- टोकन देने के तरीके
- Docker Compose
- कंटेनर से अपनी सर्विस तक पहुँचें
- लॉग पढ़ें
- अपडेट
- रजिस्ट्री एक्सेस के बिना होस्ट के लिए इमेज आर्काइव
- समस्या निवारण
- संबंधित पेज
आधिकारिक इमेज localtonet/localtonet Localtonet क्लाइंट को कंटेनर में चलाती है। अपना AuthToken दें, फिर डैशबोर्ड में हमेशा की तरह टनल बनाएँ और शुरू करें।
शुरू करने से पहले #
- 64-बिट होस्ट पर Docker। इमेज
linux/amd64औरlinux/arm64के लिए प्रकाशित है, और Docker आपके होस्ट से मेल खाने वाली इमेज खुद चुन लेता है। 32-बिट ARM डिवाइस के लिए इसकी जगह Linux बिल्ड इस्तेमाल करें। - मेरे टोकन से एक AuthToken। हर कंटेनर को उसका अपना टोकन दें: जब उसी टोकन से दूसरा क्लाइंट कनेक्ट होता है, तो पहला डिस्कनेक्ट हो जाता है।
चरण #
-
इमेज पुल करें #
पहले पुल करने से यह पक्का होता है कि आप मौजूदा वर्शन चला रहे हैं, न कि होस्ट पर पड़ी कोई पुरानी इमेज।
Bashdocker pull localtonet/localtonetइमेज Docker Hub पर है।
latestके अलावा, अगर आप कोई रिलीज़ पिन करना चाहें तो Docker Hub हर वर्शन के लिए एक टैग सूचीबद्ध करता है। -
अपने टोकन के साथ कंटेनर शुरू करें #
इमेज के नाम के बाद का सब कुछ Localtonet क्लाइंट को दे दिया जाता है।
<YOUR_TOKEN>की जगह अपना AuthToken लगाएँ।Bashdocker run localtonet/localtonet --authtoken <YOUR_TOKEN>कंटेनर अपने कनेक्शन की स्थिति प्रिंट करता है और फ़ोरग्राउंड में बना रहता है। उसे रोकने के लिए Ctrl + C दबाएँ।
-
टनल बनाएँ और शुरू करें #
डैशबोर्ड खोलें, उसी टोकन से टनल बनाएँ जो आपने कंटेनर को दिया है, और शुरू करें चुनें। क्विक स्टार्ट में फ़ॉर्म दिखाया गया है। लोकल IP एड्रेस भरने से पहले कंटेनर से अपनी सर्विस तक पहुँचें पढ़ लें, क्योंकि कंटेनर के अंदर
127.0.0.1का मतलब अलग होता है।
कंटेनर कैसे चलता है #
इमेज क्लाइंट को हेडलेस मोड में शुरू करती है। डेस्कटॉप पर चलने वाले क्लाइंट की तुलना में इससे तीन चीज़ें बदलती हैं:
- यह कभी कोई सवाल नहीं पूछता। अगर टोकन गायब या गलत फ़ॉर्मैट का है, तो कंटेनर एरर प्रिंट करता है और कोड 2 के साथ बाहर निकल जाता है।
- यह लाइव स्टेटस तालिका की जगह सादी लॉग लाइनें लिखता है,
-itके साथ शुरू करने पर भी। - यह टोकन सेव नहीं करता। इमेज कोई वॉल्यूम घोषित नहीं करती, इसलिए कंटेनर बनाते समय हर बार टोकन दें: कमांड लाइन पर, एनवायरनमेंट वेरिएबल में या फ़ाइल के रूप में।
टनल कंटेनर में कॉन्फ़िगर नहीं होते। आप उन्हें डैशबोर्ड में बनाते, शुरू करते और रोकते हैं, और कंटेनर उन्हें अपने कनेक्शन से उठा लेता है।
बैकग्राउंड में चलाएँ और अपने-आप रीस्टार्ट करें #
डिटैच करने के लिए -d और रीस्टार्ट पॉलिसी इस्तेमाल करें, ताकि रीबूट या क्रैश के बाद Docker कंटेनर को फिर शुरू कर दे:
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 सेट करती है। आपको इसे सेट करने की ज़रूरत नहीं है।
टोकन फ़ाइल के साथ टोकन को कंटेनर की परिभाषा से बाहर रखें और उसे रीड-ओनली माउंट करें:
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. प्रिंट करता है और बाहर निकल जाता है। वह सर्वर से नहीं पूछता कि टोकन मान्य है या नहीं।
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-configDocker Compose #
वही सेटअप Compose फ़ाइल के रूप में। टोकन को compose.yaml के बगल में auth-token नाम की फ़ाइल में रखें:
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:rodocker compose up -d
docker compose logs -f localtonetजब आप जिस सर्विस को पब्लिश करना चाहते हैं वह Linux होस्ट पर उसी Compose प्रोजेक्ट में हो, तो उसका पोर्ट होस्ट पर पब्लिश करें और Localtonet कंटेनर को होस्ट नेटवर्किंग के साथ चलाएँ। टनल का लोकल एड्रेस IP एड्रेस होना चाहिए, इसलिए इसके लिए web जैसा Compose सर्विस नाम इस्तेमाल नहीं हो सकता:
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 होस्ट पर, Linux | 127.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 | कुछ नहीं। |
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 ने टोकन स्वीकार नहीं किया। |
टोकन खुद कभी लॉग में नहीं लिखा जाता।
अपडेट #
इमेज को फिर से पुल करें और कंटेनर दोबारा बनाएँ:
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 आर्काइव के रूप में डाउनलोड करें, उसे कॉपी करें और लोड करें:
| आर्किटेक्चर | आर्काइव |
|---|---|
| AMD64 | localtonet-docker-amd64.tar |
| ARM64 | localtonet-docker-arm64.tar |
docker load --input localtonet-docker-amd64.tardocker load बताता है कि उसने क्या लोड किया। अगर वह नाम की जगह इमेज ID प्रिंट करे, तो चलाने से पहले इमेज को एक नाम दें:
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 जैसा नाम या किसी दूसरे कंटेनर का नाम इस फ़ील्ड में काम नहीं करता, जैसा कंटेनर से अपनी सर्विस तक पहुँचें में बताया गया है।
कंटेनर बार-बार कनेक्शन खो देता है
पक्का करें कि कोई दूसरा क्लाइंट वही टोकन इस्तेमाल नहीं कर रहा। उस टोकन से कनेक्ट होने वाला दूसरा क्लाइंट पहले को डिस्कनेक्ट कर देता है। मेरे टोकन में हर कंटेनर या डिवाइस के लिए एक टोकन बनाएँ।