Localtonet को सर्विस के रूप में चलाएँ
इस पेज पर 8 सेक्शन
Localtonet क्लाइंट को बैकग्राउंड सर्विस के रूप में इंस्टॉल करें, ताकि वह डिवाइस के साथ शुरू हो, लॉग आउट करने के बाद भी चलता रहे और कोई टर्मिनल खुला न रखना पड़े। एक कमांड उसे Windows सर्विस, macOS पर launchd या Linux पर systemd में रजिस्टर कर देती है।
शुरू करने से पहले #
- कंसोल क्लाइंट डिवाइस पर इंस्टॉल है: Windows, macOS या Linux।
- मेरे टोकन से इस डिवाइस के लिए एक AuthToken।
- एडमिनिस्ट्रेटर अधिकार: Windows पर व्यवस्थापक के रूप में चलाएँ से खोला गया टर्मिनल, macOS और Linux पर
sudo। - Linux पर systemd इस्तेमाल करने वाला डिस्ट्रीब्यूशन। Termux समर्थित नहीं है; वहाँ Android ऐप इस्तेमाल करें।
DEB या RPM पैकेज से, OpenWrt पर या Docker में इंस्टॉल किया है? उनके साथ बूट पर शुरू होने का अपना तरीका आता है। इस पेज की जगह DEB और RPM पैकेज, OpenWrt और Docker देखें।
सर्विस इंस्टॉल करें #
क्लाइंट को एक बार --install-service और अपने टोकन के साथ चलाएँ। <YOUR_TOKEN> की जगह अपना AuthToken डालें। इस कमांड में हमेशा --authtoken दें: सर्विस उसी टोकन से कनेक्ट होती है जिससे आप उसे इंस्टॉल करते हैं।
Windows #
उस फ़ोल्डर में, जिसमें localtonet है, कमांड प्रॉम्प्ट या PowerShell को व्यवस्थापक के रूप में खोलें, फिर चलाएँ:
localtonet --install-service --authtoken <YOUR_TOKEN>क्लाइंट ऑटोमैटिक स्टार्ट वाली Windows सर्विस बनाता है और उसे शुरू कर देता है। सर्विस services.msc में विवरण Localtonet Service के साथ दिखती है। अगर सर्विस विफल हो जाए, तो Windows उसे एक मिनट बाद फिर शुरू करता है।
macOS
sudo localtonet --install-service --authtoken <YOUR_TOKEN>क्लाइंट /Library/LaunchDaemons/<SERVICE_NAME>.plist में launchd जॉब लिखता है, उसे लोड करता है और शुरू करता है। जॉब बूट पर शुरू होती है, और त्रुटि के साथ बंद होने पर launchd उसे फिर शुरू करता है।
Linux
sudo localtonet --install-service --authtoken <YOUR_TOKEN>क्लाइंट /etc/systemd/system/<SERVICE_NAME>.service में systemd यूनिट लिखता है, उसे एनेबल करता है और शुरू करता है। यूनिट बूट पर शुरू होती है, और विफलता के पाँच सेकंड बाद systemd उसे फिर शुरू करता है।
अगर sudo को localtonet न मिले, तो उसे उसके पाथ के साथ चलाएँ, जैसे उस फ़ोल्डर से sudo ./localtonet जिसमें वह है।
सफल होने पर क्लाइंट सर्विस का नाम प्रिंट करता है:
[CLI] Installed service 'Localtonet_AbCdEfGhI'इंस्टॉल करने से सर्विस शुरू भी हो जाती है, इसलिए अलग से शुरू करने की कमांड नहीं चाहिए। अब आप डैशबोर्ड में इस टोकन के लिए टनल बना और शुरू कर सकते हैं।
सर्विस का नाम #
सर्विस का नाम Localtonet_ और उसके बाद टोकन के पहले नौ अक्षर होते हैं, जैसे Localtonet_AbCdEfGhI। यह पेज उसके लिए <SERVICE_NAME> लिखता है। नाम टोकन से बनता है, इसलिए आप एक ही डिवाइस पर हर टोकन के लिए एक सर्विस इंस्टॉल कर सकते हैं, और हर मैनेजमेंट कमांड को अपनी सर्विस खोजने के लिए वही टोकन चाहिए।
सर्विस क्या चलाती है #
सर्विस उसी जगह से वही localtonet फ़ाइल शुरू करती है, उन विकल्पों के साथ जो आपने इंस्टॉल कमांड में दिए थे। इससे दो बातें निकलती हैं:
- फ़ाइल को न हिलाएँ, न हटाएँ। सर्विस की परिभाषा में उसका पूरा पाथ है। Linux पर, अगर फ़ाइल
/rootके अंदर है, तो इंस्टॉलर उसे/usr/local/lib/<SERVICE_NAME>/में कॉपी कर देता है और सर्विस वही कॉपी चलाती है। - बाकी विकल्प सहेजे जाते हैं। इंस्टॉल कमांड में दिए
--netऔर--ipया--proxy envजैसे विकल्प सर्विस में सहेजे जाते हैं और हर शुरुआत पर इस्तेमाल होते हैं। देखें CLI संदर्भ।
सर्विस मैनेज करें #
इन विकल्पों में से किसी के साथ वही टोकन इस्तेमाल करें। macOS और Linux पर आगे sudo लगाएँ। Windows पर स्टेटस के अलावा हर चीज़ के लिए Administrator टर्मिनल इस्तेमाल करें।
| कमांड | यह क्या करता है | सफल होने पर आउटपुट |
|---|---|---|
localtonet --status-service --authtoken <YOUR_TOKEN> | सर्विस की स्थिति दिखाता है। | [CLI] Service '<SERVICE_NAME>' status: Running |
localtonet --stop-service --authtoken <YOUR_TOKEN> | सर्विस को रोकता है। उसके टनल ऑफ़लाइन हो जाते हैं। अगले बूट पर वह फिर शुरू होती है। | [CLI] Stopped service '<SERVICE_NAME>'. |
localtonet --start-service --authtoken <YOUR_TOKEN> | रोकी गई सर्विस को शुरू करता है। | [CLI] Started service '<SERVICE_NAME>'. |
localtonet --remove-service --authtoken <YOUR_TOKEN> | सर्विस को रोकता है और उसका रजिस्ट्रेशन हटा देता है। localtonet फ़ाइल खुद बनी रहती है। | [CLI] Removed service '<SERVICE_NAME>'. |
स्थिति इनमें से एक मान होती है:
| स्थिति | मतलब |
|---|---|
Running | सर्विस चल रही है। |
Stopped | सर्विस इंस्टॉल है लेकिन चल नहीं रही। |
Installing | सर्विस शुरू हो रही है। |
NotFound | इस टोकन के लिए कोई सर्विस इंस्टॉल नहीं है। |
Paused | सिर्फ़ Windows पर: सर्विस को पॉज़ किया गया। |
Error | सर्विस विफल रही, या उसकी स्थिति पढ़ी नहीं जा सकी। |
Unknown | सर्विस मैनेजर ने ऐसी स्थिति लौटाई जिसे क्लाइंट पहचानता नहीं। |
आप ऑपरेटिंग सिस्टम के टूल भी सर्विस के नाम के साथ इस्तेमाल कर सकते हैं:
Windows #
services.msc खोलें और <SERVICE_NAME> ढूँढें, या Administrator टर्मिनल में sc इस्तेमाल करें:
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>macOS
sudo launchctl print system/<SERVICE_NAME>Linux
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>सर्विस कहाँ रजिस्टर होती है और उसके लॉग कहाँ हैं #
| सिस्टम | रजिस्ट्रेशन | लॉग |
|---|---|---|
| Windows | <SERVICE_NAME> नाम की Windows सर्विस, स्टार्ट प्रकार ऑटोमैटिक, LocalSystem अकाउंट के तहत चलती है। | सर्विस की कोई कंसोल विंडो नहीं होती और इंस्टॉलर कोई लॉग फ़ाइल सेट अप नहीं करता। सर्विस की स्थिति, और डिवाइस तथा उसके टनल डैशबोर्ड में देखें। |
| macOS | /Library/LaunchDaemons/<SERVICE_NAME>.plist, सिस्टम-व्यापी launchd जॉब। | /var/log/<SERVICE_NAME>.out.log और /var/log/<SERVICE_NAME>.err.log |
| Linux | /etc/systemd/system/<SERVICE_NAME>.service, multi-user.target के लिए एनेबल। | systemd जर्नल: journalctl -u <SERVICE_NAME> -f |
सर्विस वह टनल टेबल प्रिंट नहीं करती जो क्लाइंट टर्मिनल में दिखाता है। अपने डिवाइस और उसके टनल की स्थिति के लिए डैशबोर्ड इस्तेमाल करें।
टोकन बदलें #
किसी डिवाइस का टोकन बदलने के लिए, पुराने टोकन से सर्विस हटाएँ और नए टोकन से फिर इंस्टॉल करें:
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>ध्यान रखने की बातें #
- हर टोकन पर एक क्लाइंट। सर्विस चलते समय उसी टोकन से दूसरा Localtonet क्लाइंट शुरू न करें, इस डिवाइस पर या किसी और पर। उसी टोकन से कनेक्ट होने वाला दूसरा क्लाइंट पहले को डिस्कनेक्ट कर देता है।
- क्लाइंट अपडेट करना। सर्विस वही फ़ाइल चलाती रहती है जिस पर उसकी परिभाषा इशारा करती है। सर्विस रोकें, उस फ़ाइल को नए वर्शन से बदलें, और सर्विस फिर शुरू करें।
- प्रॉक्सी पासवर्ड सहेजे नहीं जाते। इंस्टॉल कमांड पासवर्ड वाले प्रॉक्सी URL और विकल्प
--proxy-userको मना कर देती है।--proxy envके साथ इंस्टॉल करें और प्रॉक्सी वेरिएबल सर्विस के एनवायरनमेंट में सेट करें। - डिवाइस टर्मिनल। अगर डिवाइस Localtonet को सर्विस के रूप में चलाता है, तो
localtonet --terminal enableको Administrator टर्मिनल से याsudoके साथ चलाएँ, ताकि सर्विस नतीजे का इस्तेमाल कर सके। देखें डिवाइस टर्मिनल।
समस्या निवारण #
| संदेश | कारण और समाधान |
|---|---|
[CLI] Install failed: '…' requires elevated (admin/root) privileges. | कमांड बिना एडमिनिस्ट्रेटर अधिकार के चलाई गई। Windows पर टर्मिनल को Administrator के रूप में खोलें, या macOS और Linux पर sudo इस्तेमाल करें। Windows और Linux पर शुरू, रोकने और हटाने के लिए भी यही संदेश आता है। |
[CLI] Install failed: के बाद Service '<SERVICE_NAME>' already exists. (Windows), Systemd unit already exists for … (Linux) या Plist already exists for … (macOS) | इस टोकन की सर्विस पहले से इंस्टॉल है। उसे शुरू करने के लिए --start-service इस्तेमाल करें, या फिर से इंस्टॉल करना हो तो पहले --remove-service। |
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment. | इंस्टॉल कमांड में --proxy-user या पासवर्ड वाला प्रॉक्सी URL था। इसकी जगह --proxy env इस्तेमाल करें। |
Windows पर इंस्टॉल के तुरंत बाद [CLI] Start failed: … | सर्विस पहले से चल रही है, क्योंकि इंस्टॉल करने से वह शुरू हो जाती है। --status-service से जाँचें। |
स्थिति NotFound है | आपके दिए टोकन के लिए कोई सर्विस मौजूद नहीं है। जाँचें कि यह वही टोकन है जिससे आपने सर्विस इंस्टॉल की थी। |
स्थिति Running है लेकिन डिवाइस डैशबोर्ड में ऑफ़लाइन है | टोकन जाँचें: उसे मेरे टोकन से फिर कॉपी करें, सर्विस हटाएँ और फिर इंस्टॉल करें। यह भी सुनिश्चित करें कि कोई दूसरा क्लाइंट वही टोकन इस्तेमाल नहीं कर रहा। |