bitbang एक एकल स्थैतिक Go बाइनरी है। यह BitBang प्रोजेक्ट का हिस्सा है; यह श्वेतपत्र डिज़ाइन को गहराई से कवर करता है।

6-अंकीय कोड के साथ पेयरिंग

जब आप URL पेस्ट नहीं कर सकते या QR कोड स्कैन नहीं कर सकते, जैसे कि जब आप फ़ोन पर हों, या आवाज़ की दूरी के भीतर हों, तो bitbang serve एक छोटा पेयरिंग कोड भी प्रिंट करता है। दूसरा पक्ष bitba.ng/<code> खोलता है (या bitbang connect <code> चलाता है), उनकी स्क्रीन पर एक दूसरा 6-अंकीय नंबर दिखाई देता है, और वे उसे आपको वापस पढ़कर सुनाते हैं। अनुमोदन के लिए आप उसे टाइप करते हैं। एक मशीन-इन-द-मिडल दोनों नंबरों को मेल नहीं खिला सकता, और पेयरिंग अगली बार के लिए डिवाइस कनेक्शन क्रेडेंशियल सहेज लेती है, जैसे bitbang connect nas1। यदि आप Magic Wormhole जानते हैं, तो आकार समान है -- एक बोला गया कोड जो दो मशीनों का सुरक्षित रूप से परिचय कराता है।

क्यों?

• फ़ॉरवर्ड या कॉन्फ़िगर करने के लिए कुछ नहीं। NAT, CGNAT, या कड़े प्रतिबंधित नेटवर्क के पीछे से काम करता है -- कोई राउटर बदलाव नहीं, कोई VPN नहीं, कोई टनल डेमन नहीं।
• कनेक्ट करने वाले पक्ष पर स्थापित करने के लिए कुछ नहीं। एक ब्राउज़र पर्याप्त है। जब आप स्क्रिप्टिंग, पाइप और फ़ाइल कॉपी चाहते हैं तो CLI उपलब्ध है।
• डिज़ाइन से निजी। ट्रैफ़िक WebRTC/DTLS है, पीयर-टू-पीयर। सिग्नलिंग सर्वर इसे कभी नहीं देखता; यदि सीधा पथ संभव नहीं है, तो TURN रिले केवल सिफरटेक्स्ट ले जाता है।
• कोई खाता नहीं, कोई टेलीमेट्री नहीं।

केवल SSH का उपयोग क्यों नहीं?

bitbang ssh की तरह आकारित है: serve, connect, और cp क्रमशः sshd, ssh, और scp से मेल खाते हैं, जिसमें TCP के बजाय WebRTC परिवहन है। ऐसी मशीन के लिए जिसमें आप पहले से आराम से SSH कर सकते हैं, यह अंतर आपको ज़्यादा नहीं देता। लेकिन bitbang का अधिकांश हिस्सा उन परेशानियों से निकला है जो मुझे जितनी बार होनी चाहिए उससे कहीं ज़्यादा बार मिलती हैं:

पहुँच। रिमोट SSH एक्सेस के लिए एक इनबाउंड पथ की आवश्यकता होती है, और अधिकांश नेटवर्क पर एक खोलना आपके हाथ में नहीं है -- CGNAT (सेल्युलर, Starlink, कई ISP), कॉर्पोरेट, विश्वविद्यालय, नगरपालिका। इसलिए व्यवहार में आप एक दूसरी प्रणाली जोड़ते हैं: Tailscale, एक VPN, ngrok -- एक और इंस्टॉल, एक और खाता, चालू रखने के लिए एक और डेमन। bitbang serve को कोई खुला पोर्ट नहीं चाहिए और यह कहीं से भी काम करता है।

सेटअप। SSH को आपको अंदर आने देने से पहले सक्षम और कॉन्फ़िगर किया जाना चाहिए। यह Raspberry Pi OS पर डिफ़ॉल्ट रूप से अक्षम है, और अक्सर केवल-कुंजी होता है, जिसका अर्थ है पहले अपनी सार्वजनिक कुंजी मशीन पर पहुँचाना। और आप ऐसा कैसे करते हैं? ईमेल या USB स्टिक आमतौर पर सबसे आसान विकल्प हैं। bitbang इसके बजाय 6-अंकीय कोड विनिमय के साथ कनेक्शन स्थापित करता है -- कुछ ऐसा जो आप फ़ोन पर सुरक्षित रूप से कर सकते हैं, या कमरे के पार चिल्लाकर कह सकते हैं। यह एक सामान्य उपयोगकर्ता के रूप में भी चलता है -- कोई root नहीं, कोई डेमन नहीं, कोई कॉन्फ़िग फ़ाइल नहीं।

प्रॉक्सी। यदि आप उस मशीन के नेटवर्क पर कोई वेब ऐप चाहते हैं, तो SSH आपको प्रत्येक ऐप के लिए एक अलग टनल देता है, जिसे पहले से नामित किया जाता है। bitbang प्रॉक्सी सामान्य है: कनेक्शन के समय वेब ऐप का URL निर्दिष्ट करें।

ब्राउज़र क्लाइंट। SSH को कनेक्ट करने वाले पक्ष पर एक SSH क्लाइंट और एक कुंजी या पासवर्ड की आवश्यकता होती है। bitbang को एक ब्राउज़र चाहिए -- जिसका अर्थ है एक फ़ोन, एक उधार लिया गया लैपटॉप, या कोई ऐसा व्यक्ति जिसने कभी टर्मिनल नहीं खोला। उन्हें URL दें और उन्हें वही पहुँच मिलती है जो आपने उन्हें दी है।

bitbang का उपयोग करना

हर कनेक्शन के दो सिरे होते हैं: एक लिसनर (bitbang serve, जिस मशीन तक पहुँचा जा रहा है उस पर चलता है) और एक कनेक्टर (पहुँच बनाने वाली मशीन पर एक ब्राउज़र, या bitbang CLI)। एक लिसनर URL दोनों प्रकार के कनेक्टर के लिए काम करता है।

लिसनर: bitbang serve

प्रत्येक एक QR कोड, URL और एक पेयरिंग कोड प्रिंट करता है।

ब्राउज़र से कनेक्ट करना

URL खोलें। जो परोसा जा रहा है उसके आधार पर, आपको मिलता है:

• शेल -- पृष्ठ में एक पूर्ण टर्मिनल (रंग, आकार बदलना, कॉपी/पेस्ट)।
• फ़ाइलें -- ब्राउज़ करें, पूर्वावलोकन करें, डाउनलोड करें और अपलोड करें।
• प्रॉक्सी -- एक LAN पता टाइप करें (nas.local, 192.168.1.10:8080, localhost:3000/admin) और ऐप का उपयोग ऐसे करें जैसे आप स्थानीय हों। लॉगिन, कुकीज़, अपलोड और स्ट्रीमिंग सभी काम करते हैं।

CLI से कनेक्ट करना

हर सफल कनेक्ट या पेयरिंग ~/.bitbang/devices.json में सहेज ली जाती है, इसलिए उसके बाद एक छोटा नाम पर्याप्त है: bitbang connect nas1।

इंस्टॉल

वन-लाइनर आपका आर्किटेक्चर (amd64, arm64, armv7) पहचानता है, नवीनतम GitHub रिलीज़ से बाइनरी डाउनलोड करता है, रिलीज़ की checksums.txt के विरुद्ध उसके SHA-256 को सत्यापित करता है, और ~/.local/bin/bitbang में इंस्टॉल करता है।

कोई विशेष संस्करण पिन करें, स्थान बदलें, या पहले स्क्रिप्ट का ऑडिट करें:

macOS और Windows बिल्ड आ रहे हैं -- प्रत्येक के लिए issues बनाए गए हैं (macOS, windows), बस react या पोस्ट करके बताएँ कि आप रुचि रखते हैं। मैन्युअल इंस्टॉल: Releases से बाइनरी डाउनलोड करें और इसे अपने PATH पर रखें। स्रोत से बिल्ड: नीचे देखें।

इंस्टॉल URL कैसे काम करता है

bitba.ng/install एक रीडायरेक्ट है, कोई होस्ट की गई स्क्रिप्ट नहीं। श्रृंखला:

1. curl https://bitba.ng/install पर पहुँचता है, जो इस रेपो में (main पर) install.sh पर 302 करता है।
2. स्क्रिप्ट आपके शेल में चलती है, OS+आर्किटेक्चर पहचानती है, और https://github.com/richlegrand/bitbang-cli/releases/latest/download/bitbang-linux-<arch> से बाइनरी एसेट डाउनलोड करती है।
3. यह उसी रिलीज़ से checksums.txt प्राप्त करती है और बाइनरी के SHA-256 को सत्यापित करती है।
4. ~/.local/bin में इंस्टॉल करती है (बदला जा सकता है)।

इंस्टॉल स्क्रिप्ट इस रेपो में, उस कोड के पास रहती है जिसे यह इंस्टॉल करती है -- इसलिए आप इसे बाइनरी के साथ समीक्षा कर सकते हैं, और कैननिकल bitba.ng होस्ट के पास केवल छोटा URL होता है। सेल्फ-होस्टर अपने होस्ट के /install को अपनी भेजी गई किसी भी स्क्रिप्ट पर इंगित कर सकते हैं: सिग्नलिंग सर्वर का INSTALL_URL env var रीडायरेक्ट लक्ष्य को नियंत्रित करता है (खाली → 404)।

सुरक्षा

• स्व-प्रमाणित पहचान। पहली बार चलाने पर, bitbang ~/.bitbang/<program>/ के अंतर्गत एक RSA कुंजी-जोड़ी उत्पन्न करता है; डिवाइस UID सार्वजनिक कुंजी से व्युत्पन्न होता है, इसलिए किसी डिवाइस का प्रतिरूपण करने का अर्थ है उसके UID का दूसरा प्रीइमेज ढूँढना।
• गुप्त जानकारी सर्वर को कभी नहीं छूती। एक्सेस कोड URL फ्रैगमेंट (#…) में रहता है, जिसे ब्राउज़र कभी नहीं भेजते -- bitba.ng कनेक्शन की मध्यस्थता करता है बिना कभी वह क्रेडेंशियल देखे जो इसे अधिकृत करता है।
• एंड-टू-एंड एन्क्रिप्शन। सभी ट्रैफ़िक WebRTC के DTLS पर चलता है। सिग्नलिंग सर्वर केवल सार्वजनिक कुंजी, व्युत्पन्न UID और कनेक्शन मेटाडेटा देखता है -- आपका डेटा कभी नहीं। यदि किसी TURN रिले की आवश्यकता होती है, तो वह केवल सिफरटेक्स्ट देखता है।
• सत्यापित पेयरिंग। कोड पेयरिंग में ज़ोर से पढ़ा जाने वाला नंबर एक छोटी प्रमाणीकरण स्ट्रिंग (SAS) है, जिसकी गणना दोनों सिरों पर स्वतंत्र रूप से बातचीत किए गए DTLS फ़िंगरप्रिंट्स और दो प्रतिबद्ध nonce से की जाती है -- एक मशीन-इन-द-मिडल, जिसके फ़िंगरप्रिंट अनिवार्य रूप से भिन्न होते हैं, दोनों नंबरों को मेल नहीं खिला सकती।
• ऐच्छिक PIN (--pin) स्थायी या हेडलेस सेटअप के लिए, और थ्रोअवे मोड (-ephemeral) हर बार चलाने पर एक नई पहचान के लिए।

सिग्नलिंग सर्वर पर भरोसा किए बिना दोनों सिरे एक-दूसरे को कैसे प्रमाणित करते हैं, यह यहाँ विस्तार से कवर किया गया है: Trustless Signaling: केंद्रीय प्राधिकरण के बिना प्रमाणीकरण।

तुलना

कमांड संदर्भ

फ़्लैग दोनों रूप स्वीकार करते हैं (-pin या --pin)। बूलियन फ़्लैग डिफ़ॉल्ट रूप से बंद होते हैं जब तक कि अन्यथा न कहा जाए।

bitbang serve -- लिसनर चलाना

साझा फ़्लैग (सभी चार serve रूपों के लिए):

शेल फ़्लैग (serve और serve shell):

फ़ाइल फ़्लैग:

(उन्नत: -video-fd N एक इनहेरिटेड socketpair FD को बाहरी वीडियो सहायक को भेजता है; आंतरिक/एम्बेडिंग उपयोग के लिए।)

bitbang connect <target> [-- command …] -- क्लाइंट शेल

<target> इनमें से कोई भी हो सकता है:

• एक सहेजा गया नाम -- जैसे nas1; known-hosts तालिका से हल किया जाता है (नीचे देखें)
• एक 6-अंकीय पेयर कोड -- जैसे 482731; पेयरिंग प्रक्रिया चलाता है, फिर कनेक्ट करता है
• एक URL -- https://bitba.ng/<id>#<code>, bitba.ng/<id>#<code>, या केवल <id>#<code>

-- command के बिना, एक इंटरैक्टिव शेल खोलता है (जब stdin एक टर्मिनल हो तो एक PTY)। -- command args… के साथ, उस एकल कमांड को गैर-इंटरैक्टिव रूप से चलाता है और उसकी स्थिति के साथ बाहर निकलता है (सिग्नल से बाहर निकलने पर 128 रिपोर्ट होता है)।

bitbang cp <src> <dst> -- फ़ाइलें कॉपी करना

<src> / <dst> में से ठीक एक रिमोट होता है, जिसे <URL>:/path लिखा जाता है (URL किसी भी रूप में जिसे connect स्वीकार करता है)। - का अर्थ stdin/stdout है, इसलिए cp <URL>:/f - stdout पर स्ट्रीम करता है और cp - <URL>:/f stdin से अपलोड करता है। स्थानीय पक्ष पर एक अनुगामी / या . रिमोट बेसनाम बनाए रखता है (scp-शैली)।

डिवाइस नाम और known-hosts तालिका

हर सफल कनेक्ट या पेयरिंग ~/.bitbang/devices.json (मोड 0600) में याद रखी जाती है, इसलिए आप URL या कोड के बजाय एक छोटे नाम से पुनः कनेक्ट कर सकते हैं:

• -name NAME नाम चुनता है; यह केवल एक नए होस्ट पर लागू होता है। इसके बिना, एक स्वतः नाम (device1, device2, …) निर्दिष्ट और प्रिंट किया जाता है (Saved as "device1".)।
• नामकरण नियम: एक नाम एक अक्षर से शुरू होना चाहिए और उसमें केवल अक्षर, अंक, -, या _ हो सकते हैं। यह सुनिश्चित करता है कि इसे कभी 6-अंकीय कोड या URL नहीं समझा जा सकता। लुकअप और विशिष्टता केस-असंवेदनशील हैं।
• connect के माध्यम से नाम बदलना नहीं: bitbang connect nas1 -name nas2 अस्वीकार कर दिया जाता है -- -name केवल पहली बार सहेजने के लिए है।
• कब सहेजा जाता है: SAS सत्यापित होते ही एक पेयरिंग दर्ज कर ली जाती है (ताकि एक अस्थिर पुनः-कनेक्शन इसे खो न दे); एक URL कनेक्ट कनेक्ट होते ही दर्ज कर लिया जाता है।
• प्रत्येक प्रविष्टि {name, uid, access_code, server, paired_at} संग्रहीत करती है। किसी ज्ञात होस्ट से पुनः कनेक्ट करना (नाम या URL द्वारा) उसे उसी स्थान पर ताज़ा करता है और नाम बनाए रखता है।

स्रोत से बिल्ड करना

Go 1.25+ आवश्यक है। शुद्ध Go, स्थैतिक रूप से लिंक्ड (CGO_ENABLED=0) -- आसान क्रॉस-कंपाइलेशन, कोई रनटाइम निर्भरता नहीं।

आरेख

रोडमैप

आज उपलब्ध: शेल, फ़ाइलें और प्रॉक्सी, ब्राउज़र या CLI से पहुँच योग्य, साथ ही scp-शैली फ़ाइल कॉपी और सहेजी गई डिवाइस तालिका के साथ एड-हॉक पेयरिंग। डिज़ाइन किया गया और आ रहा है:

• सीरियल ब्रिजिंग -- स्थानीय वर्चुअल पोर्ट से रिमोट /dev/ttyUSB0 चलाएँ (जैसे इंटरनेट पर Arduino IDE चलाना)। एक issue यहाँ खोला गया है।
• TCP पोर्ट फ़ॉरवर्डिंग -- केवल LAN वाली सेवाओं तक पहुँचने के लिए -L 5432:db.internal:5432। एक issue यहाँ खोला गया है।
• रिमोट डेस्कटॉप -- WebRTC वीडियो ट्रैक पर स्क्रीन, डेटा चैनल पर कीबोर्ड/माउस।

लाइसेंस

MIT -- LICENSE देखें।

योगदान

Issues और PRs स्वागत योग्य हैं।