दस्तावेज़
त्वरित शुरुआत + हर हिस्से और हर डिवाइस की सुविधाओं का विवरण (लगातार अपडेट हो रहा है)
टनल ऑप्स
यह लेख पैनल की “टनल ऑप्स” सुविधा बताता है — सार्वजनिक IP रहित सर्वर को पैनल से जोड़ना।
एक पंक्ति में समझें
सार्वजनिक IP रहित डिवाइस (इंटरनल मशीन, NAT के पीछे का डिवाइस, Android फ़ोन) तक आप बाहर से “खुद जुड़कर” नहीं पहुँच सकते। टनल ऑप्स इन डिवाइस को खुद “बाहर जुड़ने” देता है — पैनल सर्वर से, और फिर आप उन्हें सामान्य सर्वर की तरह चला सकते हैं।
सुविधा परिचय
जिन डिवाइस तक सार्वजनिक नेटवर्क से पहुँच ही नहीं (इंटरनल मशीन, NAT के पीछे का डिवाइस, Android फ़ोन आदि), उनसे सीधे SSH नहीं हो सकता। टनल ऑप्स रिवर्स टनल से इन डिवाइस को खुद पैनल सर्वर से जुड़वाता है, और फिर आप उन्हें सामान्य सर्वर की तरह चला सकते हैं।
सिद्धांत
- पैनल सर्वर (जिसका सार्वजनिक IP है) एक टनल सेवा चलाता है
- लक्ष्य डिवाइस पर एक हल्का Agent इंस्टॉल होता है, जो खुद “आउटबाउंड” जुड़कर पैनल सर्वर से जुड़ता है
- कनेक्शन बनने के बाद पैनल इस टनल से उल्टी दिशा में SSH करके लक्ष्य डिवाइस तक पहुँचता है
> आसान भाषा में: लक्ष्य डिवाइस “खुद फ़ोन मिलाता है” पैनल सर्वर को; कॉल जुड़ने के बाद पैनल इस “समर्पित लाइन” से उसे उल्टी दिशा में नियंत्रित कर सकता है।
कब उपयोगी है
- घर के इंटरनल डिवाइस प्रबंधित करना (Raspberry Pi, NAS, सॉफ़्ट राउटर)
- सार्वजनिक IP रहित सस्ते VPS (NAT सर्वर) प्रबंधित करना
- Android फ़ोन (Termux वातावरण) प्रबंधित करना
उपयोग कैसे करें (तीन चरण)
1. “टनल ऑप्स” खोलें और “एक-क्लिक इंस्टॉल स्क्रिप्ट” पर क्लिक करके एक स्वतंत्र कमांड बनाएँ
2. कमांड लक्ष्य डिवाइस पर एक बार चलाएँ (Agent अपने आप इंस्टॉल + बूट पर ऑटोस्टार्ट)
3. लगभग 10 सेकंड में डिवाइस पैनल पर अपने आप दिखता है; अब SSH कनेक्शन और सभी सुविधाएँ उपलब्ध
> इंस्टॉल कमांड जानबूझकर छोटी रखी गई है, ताकि इंस्टॉल से पहले हाथ से टाइप करना आसान हो:
> - Linux (curl): curl -sSL http://<your-server>:5501/i/<token> | sudo bash
> - Termux: curl -sSL http://<your-server>:5501/t/<token> | bash
> - पहले से root हो तो sudo हटा सकते हैं; Alpine में wget -qO- … | sudo bash, BSD में fetch -o - … | sudo bash
>
> इंस्टॉल स्थान: Linux में डिफ़ॉल्ट /opt/sshe-agent (/opt न हो या लिखने योग्य न हो तो स्क्रिप्ट अपने आप ~/sshe-agent पर लौटती है, कोई त्रुटि नहीं देती); Termux में ~/sshe-agent (Termux के साथ शुरू होता है)।
>
> बिना पासवर्ड कनेक्शन: इंस्टॉल के बाद पैनल पहले से डाली गई की से उस डिवाइस से बिना पासवर्ड जुड़ता है, हर बार पासवर्ड डालने की ज़रूरत नहीं।
Agent के समर्थित वातावरण
| वातावरण | इंस्टॉल का तरीका |
|---|---|
| Linux (apt/yum/dnf/apk) | एक-क्लिक स्क्रिप्ट, डिपेंडेंसी अपने आप + systemd ऑटोस्टार्ट |
| Android / Termux | विशेष स्क्रिप्ट (Agent अपने आप इंस्टॉल + Termux के साथ शुरू) |
> ⚠️ macOS अभी समर्थित नहीं: macOS के अलग-अलग संस्करणों में SSH प्रमाणीकरण काफ़ी अलग होता है, संस्करणों के बीच स्थिर कनेक्शन की गारंटी नहीं दी जा सकती, इसलिए इस संस्करण में macOS के लिए टनल इंटीग्रेशन नहीं दिया गया। कृपया Linux / Termux डिवाइस से टनल ऑप्स में जुड़ें।
Agent की ऑनलाइन स्थिति
- ऑनलाइन: टनल कनेक्शन सामान्य, कभी भी संचालन कर सकते हैं
- ऑफ़लाइन: डिवाइस डिस्कनेक्ट (बंद हो गया, नेटवर्क टूट गया, Agent रुक गया)। ऑफ़लाइन रिकॉर्ड कुछ समय तक रहता है, दोबारा जुड़ने पर अपने आप ऑनलाइन हो जाता है
> 📌 सर्वर कार्ड का निर्णय: टनल डिवाइस का “ऑनलाइन/ऑफ़लाइन” Agent हार्टबीट से तय होता है। Agent ऑनलाइन होने पर टनल से गतिशील रूप से SSH चैनल बनाकर असली हेल्थ डेटा (लोड/मेमोरी/डिस्क/अपटाइम/बैटरी/तापमान) लेता है, सामान्य सर्वर जैसा ही।
ध्यान देने योग्य बातें
1. Agent पैनल का एकमात्र प्रोग्राम है जिसे लक्ष्य डिवाइस पर इंस्टॉल करना पड़ता है (“ज़ीरो फ़ुटप्रिंट” विचार का अपवाद)। क्योंकि सार्वजनिक IP रहित डिवाइस से खुद जुड़ना संभव नहीं, वही खुद बाहर जुड़ सकता है।
2. Agent बहुत कम संसाधन लेता है (एक Python प्रोसेस + एक लंबा कनेक्शन)।
3. Agent एन्क्रिप्टेड टनल से डेटा भेजता है, संचार सुरक्षित है।
4. अगर डिवाइस का IP बदल जाए या Agent काम करना बंद कर दे, तो इंस्टॉल स्क्रिप्ट दोबारा चलाने से स्थिति ठीक हो जाती है।
पोर्ट टनलिंग से संबंध
टनल ऑप्स “डिवाइस को पैनल से जोड़ने” का काम करता है, पोर्ट टनलिंग “डिवाइस के ऐप पोर्ट को सार्वजनिक नेटवर्क पर खोलने” का। दोनों मिलकर काम करते हैं: पहले टनल ऑप्स से सार्वजनिक IP रहित डिवाइस जोड़ें, फिर पोर्ट टनलिंग से उसके ऐप (जैसे Navidrome, Nextcloud) को पैनल सर्वर के सार्वजनिक पोर्ट पर मैप करें।