OpenWrt पर Localtonet इंस्टॉल करें
प्रायोगिक OpenWrt 24.10 और 25.12+ x64 और ARM64
इस पेज पर 12 सेक्शन
Localtonet क्लाइंट को सीधे OpenWrt राउटर पर चलाएँ। पैकेज क्लाइंट, एक टोकन फ़ाइल, एक UCI कॉन्फ़िगरेशन और एक सर्विस इंस्टॉल करता है जो राउटर के साथ शुरू होती है।
OpenWrt पैकेज प्रायोगिक हैं। ये बिना हस्ताक्षर वाली फ़ाइलें हैं जिन्हें आप हाथ से इंस्टॉल करते हैं, किसी हस्ताक्षरित OpenWrt फ़ीड के पैकेज नहीं। इन पर निर्भर होने से पहले अपने डिवाइस पर फ़र्मवेयर की संगतता, अपने टनल और VPN जाँच लें।
शुरू करने से पहले #
- OpenWrt के समर्थित वर्शन और CPU आर्किटेक्चर वाला राउटर (अगला सेक्शन देखें)।
- SSH के ज़रिए राउटर पर root एक्सेस।
- इंस्टॉल करते समय राउटर पर इंटरनेट एक्सेस। पैकेज मैनेजर डिपेंडेंसी आपके फ़र्मवेयर की अपनी पैकेज फ़ीड से डाउनलोड करता है।
- पर्याप्त खाली स्टोरेज और मेमोरी (स्टोरेज और मेमोरी देखें)।
- मेरे टोकन से एक AuthToken जिसे कोई दूसरा डिवाइस इस्तेमाल न करता हो।
समर्थित वर्शन और आर्किटेक्चर #
OpenWrt ने रिलीज़ के बीच अपना पैकेज मैनेजर बदला है, इसलिए पैकेज के दो फ़ॉर्मेट हैं। अपने फ़र्मवेयर वाला फ़ॉर्मेट चुनें:
| OpenWrt वर्शन | पैकेज फ़ॉर्मेट | पैकेज मैनेजर | आर्किटेक्चर |
|---|---|---|---|
| 24.10 | IPK | opkg | x64, ARM64 |
| 25.12 और बाद के | APK v3 | apk | x64, ARM64 |
यहाँ APK का मतलब OpenWrt पैकेज है। ये .apk फ़ाइलें Android ऐप नहीं हैं और फ़ोन पर इंस्टॉल नहीं हो सकतीं। Android के लिए Android देखें।
क्या समर्थित नहीं है #
- MIPS, MIPSEL और ARMv7 राउटर। इन आर्किटेक्चर के लिए कोई पैकेज नहीं है।
- पैकेज फ़ीड से इंस्टॉल करना। पैकेज लोकल फ़ाइलें हैं; आपका राउटर उन्हें
opkg updateयाapk updateसे न ढूँढता है, न अपडेट करता है। - पैकेज को किसी दूसरे आर्किटेक्चर पर ज़बरदस्ती इंस्टॉल करना। पैकेज मैनेजर की आर्किटेक्चर जाँच को कभी ओवरराइड न करें।
आर्किटेक्चर जाँचें #
पैकेज का आर्किटेक्चर आपके फ़र्मवेयर से मेल खाना चाहिए। राउटर से पूछें कि वह कौन-से आर्किटेक्चर स्वीकार करता है:
OpenWrt 24.10 (opkg) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archx64 राउटर x86_64 बताता है। ARM64 राउटर ऐसा नाम बताते हैं जो aarch64_ से शुरू होता है, और वह नाम फ़र्मवेयर बिल्ड के अनुसार अलग होता है। हर पैकेज के साथ एक छोटी निर्देश फ़ाइल आती है जो बताती है कि पैकेज किस सटीक आर्किटेक्चर के लिए बना है, जैसे x86_64 या aarch64_generic। डाउनलोड पेज पर OpenWrt के अंतर्गत अपना पैकेज चुनें और उसे पढ़ने के लिए पैकेज सेटअप निर्देश खोलें। उस आर्किटेक्चर की तुलना राउटर के बताए आर्किटेक्चर से करें। अगर वे मेल न खाएँ, तो पैकेज इंस्टॉल न करें।
स्टोरेज और मेमोरी #
पैकेज में क्लाइंट अपने रनटाइम के साथ होता है, इसलिए वह सामान्य OpenWrt पैकेज से काफ़ी बड़ा है। इंस्टॉल करने से पहले राउटर जाँच लें:
df -h
free- फ़्लैश (ओवरले)। प्रोग्राम फ़ाइलें
/usr/lib/localtonetके अंतर्गत इंस्टॉल होती हैं। छोटे फ़्लैश चिप वाले राउटर को इन्हें समाने के लिए extroot (रूट ओवरले के रूप में बाहरी स्टोरेज) की ज़रूरत पड़ सकती है। - RAM और
/tmp। क्लाइंट शुरू होने पर अपनी नेटिव लाइब्रेरी/tmp/localtonet/bundleमें खोलता है। OpenWrt पर/tmpRAM में रहता है, इसलिए यह जगह राउटर की मेमोरी से कटती है।
पैकेज क्या इंस्टॉल करता है #
| पाथ | यह क्या है |
|---|---|
/usr/bin/localtonet | localtonet कमांड। |
/usr/lib/localtonet | प्रोग्राम फ़ाइलें। |
/etc/localtonet/auth-token | टोकन फ़ाइल। जब तक आप बदलते नहीं, इसमें प्लेसहोल्डर DUMMY_AUTH_TOKEN रहता है। केवल root पढ़ सकता है। |
/etc/config/localtonet | सर्विस का UCI कॉन्फ़िगरेशन। |
/etc/init.d/localtonet | सर्विस स्क्रिप्ट (procd)। |
पैकेज libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft और ip6tables-nft पर निर्भर है। जो गायब हैं उन्हें पैकेज मैनेजर आपके फ़र्मवेयर की फ़ीड से इंस्टॉल कर देता है, इसीलिए सेटअप निर्देश पहले पैकेज सूचियाँ रिफ़्रेश करते हैं। kmod-tun इंस्टॉल किए गए फ़र्मवेयर के कर्नेल से मेल खाना चाहिए, इसलिए उसे हमेशा उसी फ़र्मवेयर की अपनी फ़ीड से लें।
टोकन फ़ाइल और कॉन्फ़िगरेशन #
पैकेज इंस्टॉल करने से कुछ कनेक्ट नहीं होता। सर्विस तब तक बंद रहती है जब तक आप दो काम नहीं कर लेते: टोकन फ़ाइल में अपना टोकन डालें और UCI में सर्विस चालू करें। आपके पैकेज के सटीक कमांड इस पेज के अंत में उसके सेटअप निर्देश में हैं; यह सेक्शन बताता है कि वे क्या करते हैं।
टोकन फ़ाइल #
/etc/localtonet/auth-token में आपका AuthToken एक ही लाइन में होता है और कुछ नहीं। प्लेसहोल्डर DUMMY_AUTH_TOKEN को अपने टोकन से बदलें, जैसे vi से। फ़ाइल को केवल root के पढ़ने योग्य रखें (मोड 600)।
इसके बाद सेटअप निर्देश क्लाइंट को --headless --authtoken-file /etc/localtonet/auth-token --check-config के साथ एक बार चलाते हैं। यह Localtonet से कनेक्ट किए बिना फ़ाइल जाँचता है:
| आउटपुट | मतलब |
|---|---|
Localtonet headless configuration OK. | फ़ाइल में सही बनावट वाला टोकन है: 33 अक्षर, कोई स्पेस नहीं। यह जाँच साबित नहीं करती कि टोकन आपके खाते के लिए मान्य है। |
Invalid Localtonet headless configuration. Check the token file or environment settings. | फ़ाइल नहीं है, उसमें अब भी प्लेसहोल्डर है, या टोकन 33 अक्षर का नहीं है। |
UCI कॉन्फ़िगरेशन #
सर्विस अपनी सेटिंग्स /etc/config/localtonet से पढ़ती है। नई इंस्टॉलेशन में यह होता है:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| विकल्प | यह क्या करता है | मान |
|---|---|---|
enabled | सर्विस क्लाइंट शुरू करती है या नहीं। जब तक यह 0 है, सर्विस शुरू करने से कुछ नहीं होता। | 0 (डिफ़ॉल्ट) या 1 |
token_file | उस फ़ाइल का पाथ जिससे क्लाइंट टोकन पढ़ता है। | डिफ़ॉल्ट /etc/localtonet/auth-token |
मौजूदा मान कभी भी देखें:
uci show localtonetसर्विस #
क्लाइंट localtonet नाम की procd सर्विस के रूप में चलता है। पैकेज इंस्टॉल करने से वह बूट पर शुरू होने के लिए रजिस्टर हो जाती है, लेकिन क्लाइंट तभी शुरू होता है जब enabled 1 हो और टोकन फ़ाइल खाली न हो। enabled को 1 करके बदलाव कमिट करने के बाद सर्विस को एक बार रीस्टार्ट करें; उसके बाद वह राउटर के साथ शुरू होती है।
| कमांड | यह क्या करता है |
|---|---|
/etc/init.d/localtonet restart | क्लाइंट को रोकता और फिर शुरू करता है। टोकन फ़ाइल या कॉन्फ़िगरेशन बदलने के बाद इसे चलाएँ। |
/etc/init.d/localtonet stop | अगले रीस्टार्ट या रीबूट तक क्लाइंट को रोकता है। |
/etc/init.d/localtonet disable | बूट पर सर्विस का शुरू होना बंद करता है। |
/etc/init.d/localtonet enable | बूट पर सर्विस फिर शुरू होने लगती है। |
क्लाइंट को बंद करने के लिए, लेकिन पैकेज इंस्टॉल रखने के लिए:
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restartअगर क्लाइंट अचानक रुक जाए, तो procd उसे फिर शुरू कर देता है।
क्लाइंट के कनेक्ट होने के बाद, डैशबोर्ड में राउटर के टोकन से टनल बनाएँ और शुरू करें। टनल का लोकल IP एड्रेस राउटर पर ही चल रही सेवा के लिए 127.0.0.1 हो सकता है, या राउटर के पीछे किसी भी डिवाइस का LAN एड्रेस, जैसे 192.168.1.20।
लॉग #
क्लाइंट OpenWrt के सिस्टम लॉग में लिखता है। उसकी लाइनें दिखाएँ, या उन्हें लाइव फ़ॉलो करें:
logread -e localtonet
logread -f -e localtonet| लाइन | मतलब |
|---|---|
Localtonet - headless log | क्लाइंट शुरू हुआ। |
Connection: … | Localtonet से कनेक्शन की स्थिति। |
AuthTokenName: … | उस टोकन का नाम जिससे राउटर ने साइन इन किया। |
OPEN …, ADDED …, STATUS …, CLOSED … | इस टोकन का कोई टनल मिला, जोड़ा गया, उसकी स्थिति बदली या वह हटाया गया। |
Authentication failed: AuthToken was rejected. | Localtonet ने टोकन फ़ाइल का टोकन स्वीकार नहीं किया। |
AuthToken file missing | सर्विस चालू है, लेकिन टोकन फ़ाइल मौजूद नहीं है या खाली है। |
अपग्रेड और हटाना #
अपग्रेड करने के लिए पुराने पैकेज के ऊपर नया पैकेज इंस्टॉल करें और सर्विस रीस्टार्ट करें। टोकन फ़ाइल और UCI कॉन्फ़िगरेशन बने रहते हैं। दोनों फ़ाइलें उस सूची में भी हैं जिसे OpenWrt फ़र्मवेयर अपग्रेड के दौरान रखता है, लेकिन नया फ़र्मवेयर फ़्लैश करने के बाद पैकेज को खुद फिर से इंस्टॉल करना पड़ता है।
क्लाइंट हटाने के लिए:
OpenWrt 24.10 (opkg) #
opkg remove localtonetOpenWrt 25.12+ (apk)
apk del localtonetपैकेज हटाने से सर्विस रुक जाती है और बूट क्रम से बाहर हो जाती है।
OpenWrt पर VPN #
पैकेज राउटर पर VPN फ़ीचर के लिए ज़रूरी चीज़ें साथ लाता है: kmod-tun, ip-full, bash, iptables-nft और ip6tables-nft। रूटिंग और फ़ायरवॉल का व्यवहार आपके फ़र्मवेयर और आपके अपने फ़ायरवॉल नियमों पर निर्भर है, इसलिए VPN पर निर्भर होने से पहले उसे अपने डिवाइस पर टेस्ट करें। फ़ीचर के बारे में VPN मैनेजर देखें।
समस्या निवारण #
पैकेज मैनेजर आर्किटेक्चर के कारण पैकेज अस्वीकार कर देता है
पैकेज आपके फ़र्मवेयर से अलग आर्किटेक्चर के लिए बना है। opkg print-architecture या apk --print-arch के आउटपुट की तुलना पैकेज की निर्देश फ़ाइल में बताए आर्किटेक्चर से करें (डाउनलोड पेज पर पैकेज सेटअप निर्देश)। इंस्टॉलेशन ज़बरदस्ती न करें। MIPS, MIPSEL और ARMv7 राउटर समर्थित नहीं हैं।
apk फ़ाइल को अविश्वसनीय बताकर इंस्टॉल करने से मना कर देता है
APK पैकेज बिना हस्ताक्षर वाली लोकल फ़ाइलें हैं। इन्हें इंस्टॉल करने के लिए --allow-untrusted विकल्प चाहिए, जैसा पैकेज के सेटअप निर्देश में दिखाया गया है।
इंस्टॉलेशन इसलिए फ़ेल होती है कि कोई डिपेंडेंसी नहीं मिलती
पहले पैकेज सूचियाँ रिफ़्रेश करें (opkg update या apk update) और पक्का करें कि राउटर पर इंटरनेट है। डिपेंडेंसी आपके फ़र्मवेयर की अपनी फ़ीड से आती हैं।
सर्विस चालू है लेकिन लॉग में कुछ नहीं दिखता
uci show localtonet जाँचें। अगर enabled अब भी 0 है, तो उसे 1 करें, कमिट करें और सर्विस रीस्टार्ट करें। अगर लॉग में AuthToken file missing दिखे, तो अपना टोकन token_file में बताई फ़ाइल में डालें।
क्लाइंट शुरू नहीं होता या राउटर की मेमोरी खत्म हो जाती है
df -h और free से खाली फ़्लैश स्पेस और मेमोरी जाँचें। क्लाइंट को /usr/lib/localtonet और /tmp में जगह चाहिए।
संबंधित पेज #
OpenWrt
प्रायोगिक। OpenWrt 24.10 के लिए IPK या 25.12+ के लिए APK v3 चुनें। ये APK फ़ाइलें OpenWrt पैकेज हैं, Android ऐप नहीं।
केवल x64 और ARM64। पैकेज का आर्किटेक्चर आपके फ़र्मवेयर से मेल खाना चाहिए; पैकेज के सेटअप निर्देश और opkg print-architecture या apk --print-arch जाँचें। MIPS, MIPSEL और ARMv7 इन पैकेजों में सपोर्टेड नहीं हैं। इंस्टॉल करने से पहले उपलब्ध स्टोरेज और RAM जाँचें।
-
OpenWrt 24.10 · x64 · IPK
सेटअप निर्देश
1. डाउनलोड किया गया पैकेज इंस्टॉल करें।
localtonet-openwrt-24.10-x64.ipkवाली डायरेक्टरी में टर्मिनल खोलें।ये कमांड राउटर पर root के रूप में चलाएँ। इंस्टॉल करने से पहले पक्का करें कि पैकेज का आर्किटेक्चर आपके फ़र्मवेयर से मेल खाता है।
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk2. अपना AuthToken सेट करें। root के रूप में
/etc/localtonet/auth-tokenएडिट करें औरDUMMY_AUTH_TOKENको एक ही लाइन में अपने टोकन से बदलें। फिर फ़ाइल को सुरक्षित करें और कॉन्फ़िगरेशन जाँचें:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. सर्विस शुरू करें। कॉन्फ़िगरेशन जाँच सफल होने के बाद:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetअपग्रेड के लिए नया पैकेज इंस्टॉल करें और
/etc/init.d/localtonet restartचलाएँ। आपका कॉन्फ़िगरेशन बना रहता है। -
OpenWrt 24.10 · ARM64 · IPK
सेटअप निर्देश
1. डाउनलोड किया गया पैकेज इंस्टॉल करें।
localtonet-openwrt-24.10-arm64.ipkवाली डायरेक्टरी में टर्मिनल खोलें।ये कमांड राउटर पर root के रूप में चलाएँ। इंस्टॉल करने से पहले पक्का करें कि पैकेज का आर्किटेक्चर आपके फ़र्मवेयर से मेल खाता है।
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-arm64.ipk2. अपना AuthToken सेट करें। root के रूप में
/etc/localtonet/auth-tokenएडिट करें औरDUMMY_AUTH_TOKENको एक ही लाइन में अपने टोकन से बदलें। फिर फ़ाइल को सुरक्षित करें और कॉन्फ़िगरेशन जाँचें:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. सर्विस शुरू करें। कॉन्फ़िगरेशन जाँच सफल होने के बाद:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetअपग्रेड के लिए नया पैकेज इंस्टॉल करें और
/etc/init.d/localtonet restartचलाएँ। आपका कॉन्फ़िगरेशन बना रहता है। -
OpenWrt 25.12+ · x64 · APK v3
सेटअप निर्देश
1. डाउनलोड किया गया पैकेज इंस्टॉल करें।
localtonet-openwrt-25.12-x64.apkवाली डायरेक्टरी में टर्मिनल खोलें।ये कमांड राउटर पर root के रूप में चलाएँ। इंस्टॉल करने से पहले पक्का करें कि पैकेज का आर्किटेक्चर आपके फ़र्मवेयर से मेल खाता है।
यह लोकल APK पैकेज साइन किया हुआ नहीं है, इसलिए इंस्टॉलेशन के लिए
--allow-untrustedज़रूरी है।apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk2. अपना AuthToken सेट करें। root के रूप में
/etc/localtonet/auth-tokenएडिट करें औरDUMMY_AUTH_TOKENको एक ही लाइन में अपने टोकन से बदलें। फिर फ़ाइल को सुरक्षित करें और कॉन्फ़िगरेशन जाँचें:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. सर्विस शुरू करें। कॉन्फ़िगरेशन जाँच सफल होने के बाद:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetअपग्रेड के लिए नया पैकेज इंस्टॉल करें और
/etc/init.d/localtonet restartचलाएँ। आपका कॉन्फ़िगरेशन बना रहता है। -
OpenWrt 25.12+ · ARM64 · APK v3
सेटअप निर्देश
1. डाउनलोड किया गया पैकेज इंस्टॉल करें।
localtonet-openwrt-25.12-arm64.apkवाली डायरेक्टरी में टर्मिनल खोलें।ये कमांड राउटर पर root के रूप में चलाएँ। इंस्टॉल करने से पहले पक्का करें कि पैकेज का आर्किटेक्चर आपके फ़र्मवेयर से मेल खाता है।
यह लोकल APK पैकेज साइन किया हुआ नहीं है, इसलिए इंस्टॉलेशन के लिए
--allow-untrustedज़रूरी है।apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk2. अपना AuthToken सेट करें। root के रूप में
/etc/localtonet/auth-tokenएडिट करें औरDUMMY_AUTH_TOKENको एक ही लाइन में अपने टोकन से बदलें। फिर फ़ाइल को सुरक्षित करें और कॉन्फ़िगरेशन जाँचें:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. सर्विस शुरू करें। कॉन्फ़िगरेशन जाँच सफल होने के बाद:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetअपग्रेड के लिए नया पैकेज इंस्टॉल करें और
/etc/init.d/localtonet restartचलाएँ। आपका कॉन्फ़िगरेशन बना रहता है।
इंस्टॉल करने से पहले अपने पैकेज के सेटअप निर्देश पढ़ें। पैकेज साइन किए हुए नहीं हैं; फ़र्मवेयर कम्पैटिबिलिटी, टनल और VPN की जाँच इच्छित डिवाइस पर करनी होगी। कभी भी बेमेल आर्किटेक्चर ज़बरदस्ती इंस्टॉल न करें।