इसे छोड़कर कंटेंट पर जाएं
Octoboard दस्तावेज़

Tailscale से ब्राउज़र

अपने Tailscale नेटवर्क के ज़रिए, SSH या रिमोट डेस्कटॉप के बिना, दूसरे कंप्यूटर के ब्राउज़र में Octoboard खोलें। होस्ट वह कंप्यूटर है जो Octoboard चलाता है: Mac, Windows PC या octoboardd चलाने वाला Linux सर्वर। SSH साइन-इन (macOS पर Remote Login) बंद रह सकता है।

पक्का नहीं है कि यही तरीका आपके लिए सही है? कनेक्ट करने का तरीका चुनें देखें।

आपके कंप्यूटर का ब्राउज़र → आपके कंप्यूटर पर रिले (127.0.0.1) ⟷ Tailscale ⟷ होस्ट पर रिले (127.0.0.1) → Octoboard

पहली बार है?
  • Tailscale: एक सेवा जो आपके डिवाइसों को, वे जहाँ भी हों, इंटरनेट पर एक निजी नेटवर्क में जोड़ देती है। आप उसमें अपने अकाउंट से साइन इन करते हैं।
  • Tailnet: आपका Tailscale नेटवर्क: आपके Tailscale अकाउंट में साइन इन किए हुए डिवाइस।
  • 127.0.0.1 (लूपबैक): ऐसा पता जिसका मतलब हमेशा “यही कंप्यूटर” होता है।
  • पोर्ट: एक नंबर जो कंप्यूटर पर किसी एक प्रोग्राम को चुनता है, दरवाज़े के नंबर की तरह। 127.0.0.1:3369 का मतलब है इसी कंप्यूटर का पोर्ट 3369।
  • socat: एक छोटा, मुफ़्त प्रोग्राम जो किसी कनेक्शन को एक जगह से दूसरी जगह पहुँचा देता है। यहाँ यही रिले है।
  • Tailscale Serve: Tailscale की एक कमांड जो किसी पोर्ट को सिर्फ़ आपके tailnet के साथ शेयर करती है। उसका जोड़ीदार Tailscale Funnel उसे पूरे इंटरनेट के साथ शेयर कर देता है; उसे यहाँ कभी इस्तेमाल न करें।
  • टर्मिनल: वह विंडो जिसमें आप कमांड टाइप करते हैं: macOS पर Terminal, Windows पर PowerShell।

ये अतिरिक्त चरण क्यों

Section titled “ये अतिरिक्त चरण क्यों”

सुरक्षा के लिए, Octoboard सिर्फ़ उसी ब्राउज़र को स्वीकार करता है जो उसे 127.0.0.1 पर खोलता है, यानी ऐसे पते पर जिसका मतलब हमेशा “यही कंप्यूटर” होता है (इसे लूपबैक भी कहते हैं)। इसलिए आप होस्ट का Tailscale पता सीधे ब्राउज़र में टाइप नहीं कर सकते। इसके बजाय, आप हर कंप्यूटर पर एक छोटा रिले प्रोग्राम चलाते हैं: आपके कंप्यूटर पर वह होस्ट को 127.0.0.1 पर लोकल जैसा दिखाता है; होस्ट पर वह कनेक्शन Octoboard को सौंप देता है। दोनों के बीच का ट्रैफ़िक Tailscale ले जाता है।

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

Section titled “शुरू करने से पहले”
  • दोनों कंप्यूटरों पर Tailscale, एक ही tailnet में साइन इन किया हुआ। ऐसा tailnet इस्तेमाल करें जिसमें सिर्फ़ आपके अपने डिवाइस हों: वह जिस भी डिवाइस को होस्ट तक पहुँचने देता है, वह आपके शेयर किए पोर्ट तक पहुँच सकता है।

  • हर उस कंप्यूटर पर socat जो Mac है या Linux चलाता है। Windows कंप्यूटर को इसकी ज़रूरत नहीं है।

    अगर Homebrew नहीं है तो पहले उसे इंस्टॉल करें (macOS में यह काम कर सकने वाला कोई टूल नहीं आता), फिर Terminal में यह चलाएँ:

    Terminal window
    brew install socat
  • काम करते समय दो या तीन विंडो खुली रखें: होस्ट पर रिले और Tailscale Serve (Windows पर रिले को छोड़कर), और आपके कंप्यूटर पर रिले (Windows को छोड़कर)।

  1. ब्राउज़र पता पाएँ, जिसमें वह कुंजी होती है जो ब्राउज़र को साइन इन कराती है।

    Octoboard में सेटिंग्स › रिमोट एक्सेस खोलें, रिमोट एक्सेस की अनुमति दें चालू करें और पुष्टि के लिए अनुमति दें चुनें। स्विच के नीचे दो टैब दिखाई देंगे। ब्राउज़र टैब पर चरण 2: ब्राउज़र पता के नीचे पता कॉपी करें चुनें।

    पता दूसरे कंप्यूटर तक ऐसे तरीके से पहुँचाएँ जिसे सिर्फ़ आप पढ़ सकें, जैसे खुद को भेजा गया नोट: यह पासवर्ड की तरह काम करता है।

    चरण 1: SSH फ़ॉरवर्ड को छोड़ दें। ऐप की सेटिंग्स में कई जगह SSH का ज़िक्र है; यहाँ उसे अनदेखा कर सकते हैं, क्योंकि यह गाइड सिर्फ़ ब्राउज़र पते का इस्तेमाल करती है।

    Octoboard को चालू रखें: इसे बंद करने पर रिमोट एक्सेस रुक जाता है।

  2. होस्ट पर रिले शुरू करें, जो होस्ट के 127.0.0.1 के एक पोर्ट को Octoboard से जोड़ता है। नीचे के चरणों में यही पोर्ट होस्ट पोर्ट है।

    इसे Terminal में चलाएँ और विंडो खुली रहने दें। यह सिर्फ़ 127.0.0.1:3370 पर सुनता है।

    Terminal window
    socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"

    होस्ट पोर्ट 3370 है।

  3. Tailscale Serve से होस्ट पोर्ट को अपने tailnet के साथ शेयर करें, और विंडो खुली रहने दें। Tailscale Funnel कभी इस्तेमाल न करें, क्योंकि वह इसे सार्वजनिक इंटरनेट पर रख देगा।

    Terminal window
    tailscale serve --tcp=3370 tcp://127.0.0.1:3370

    App Store के Tailscale ऐप के साथ, कमांड को tailscale की जगह /Applications/Tailscale.app/Contents/MacOS/Tailscale के रूप में चलाएँ। स्टैंडअलोन ऐप के साथ, पहले उसकी सेटिंग्स में CLI integration के नीचे से कमांड इंस्टॉल करें।

    जाँचने के लिए, किसी दूसरी विंडो में tailscale serve status चलाएँ: उसकी सूची में होस्ट पोर्ट दिखना चाहिए।

जिस कंप्यूटर से आप ब्राउज़ करेंगे उस पर

Section titled “जिस कंप्यूटर से आप ब्राउज़ करेंगे उस पर”
  1. इस कंप्यूटर के Tailscale ऐप में होस्ट को ढूँढें, और उसका नाम (जैसे my-mac) या पता (100.x.y.z जैसा नंबर) नोट करें।

  2. इस कंप्यूटर पर रिले शुरू करें, जो होस्ट को यहाँ 127.0.0.1:3369 पर दिखाता है। अगर इस कंप्यूटर पर पोर्ट 3369 पहले से लिया हुआ है, तो कोई दूसरा पोर्ट चुनें और उसे ब्राउज़र पते में भी बदलें।

    नीचे की कमांड में <host> की जगह होस्ट का नाम या पता लिखें, और <host port> की जगह होस्ट पोर्ट लिखें।

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>

    उदाहरण के लिए, my-mac नाम के Mac होस्ट के लिए:

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370

    इसे Terminal में चलाएँ और विंडो खुली रहने दें।

  3. होस्ट पर कॉपी किया हुआ ब्राउज़र पता खोलें। यह http://127.0.0.1:3369/ से शुरू होता है।

सफल होने का पता तब चलेगा जब Octoboard ब्राउज़र टैब में बिना साइन इन करने को कहे खुल जाए।

  • पेज लोड नहीं होता: कोई विंडो बंद हो गई थी, या उसकी कमांड रुक गई। जाँचें कि रिले और Tailscale Serve अब भी चल रहे हैं, और होस्ट पर tailscale serve status की सूची में होस्ट पोर्ट दिखता है।
  • socat “Address already in use” कहता है: उस कंप्यूटर पर वह पोर्ट पहले से लिया हुआ है। कोई दूसरा पोर्ट चुनें; अपने कंप्यूटर पर उसे ब्राउज़र पते में भी बदलें।
  • पेज रिफ़्यूज़ हो जाता है या खाली रहता है: जाँचें कि आपने पता 127.0.0.1 पर खोला है, होस्ट के Tailscale नाम या 100.x.y.z पते पर नहीं।
  • पेज खोलने पर होस्ट का रिले “Connection refused” या “No such file or directory” दिखाता है: रिमोट एक्सेस की अनुमति दें बंद है, या होस्ट पर Octoboard नहीं चल रहा (Linux पर, octoboardd नहीं चल रहा)।
  • जिस कंप्यूटर से आपने ब्राउज़ किया उस पर: socat को Ctrl+C से रोकें, या Windows पर एडमिनिस्ट्रेटर के रूप में चलाए गए PowerShell में फ़ॉरवर्ड हटाएँ:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • होस्ट पर: Tailscale Serve कमांड और socat को Ctrl+C से रोकें। tailscale serve status से जाँचें कि अब कुछ शेयर नहीं हो रहा; अगर पोर्ट अब भी सूची में है, तो उसे tailscale serve --tcp=3370 off से हटाएँ (Windows पर tailscale serve --tcp=3369 off)।

  • Mac या Windows होस्ट पर, जब ज़रूरत न रहे तो रिमोट एक्सेस की अनुमति दें बंद कर दें। इससे ब्राउज़र का प्रवेश बंद हो जाता है और उस कुंजी से खोला गया हर पेज डिस्कनेक्ट हो जाता है।

  • अगर पता लीक हो गया हो, तो ब्राउज़र टैब पर कुंजी बदलें से उसे नई कुंजी दें, या Linux पर octoboardd address --rotate से। पुराने पते से खुले पेज डिस्कनेक्ट हो जाते हैं।

  • पता ही पासवर्ड है: इसकी कुंजी होस्ट पर Octoboard का पूरा नियंत्रण देती है, किसी भी कमांड को चलाना भी। यह तब तक रहती है जब तक आप उसे बदल न दें। यह ब्राउज़र की हिस्ट्री और बुकमार्क में रह जाती है, और ब्राउज़र सिंक चालू होने पर आपके दूसरे डिवाइसों में भी सिंक हो जाती है।
  • कौन पहुँच सकता है: कोई भी जो होस्ट पोर्ट तक पहुँचे और जिसके पास कुंजी हो। रिले सिर्फ़ 127.0.0.1 पर सुनते हैं, इसलिए होस्ट के या आपके लोकल नेटवर्क के दूसरे डिवाइस उन तक नहीं पहुँच सकते; Tailscale Serve होस्ट पोर्ट को सिर्फ़ आपके tailnet से पहुँचने लायक बनाता है, उसके एक्सेस नियमों की सीमा तक।
  • सिर्फ़ ऐसे कंप्यूटरों पर जिन पर कोई और साइन इन नहीं करता: होस्ट या आपके कंप्यूटर पर कोई दूसरा यूज़र अकाउंट इन 127.0.0.1 पोर्ट से जुड़ सकता है, और जब कोई रिले नहीं चल रहा होता तब वह उसका पोर्ट ले सकता है और आपका ब्राउज़र दोबारा कनेक्ट होने पर कुंजी पा सकता है। SSH से कनेक्ट करने पर Mac या Linux होस्ट पर यह कमज़ोरी नहीं होती, और डेस्कटॉप ऐप इस्तेमाल करने पर आपके अपने कंप्यूटर पर भी नहीं होती। लेकिन ब्राउज़र में आपके कंप्यूटर पर यह कमज़ोरी अब भी रहती है, क्योंकि वहाँ SSH फ़ॉरवर्ड भी 127.0.0.1 पोर्ट पर सुनता है।
  • कभी Funnel नहीं: Tailscale Funnel पोर्ट को पूरे इंटरनेट पर प्रकाशित कर देगा।