`serve` एक URL प्रिंट करता है। इसे किसी भी ब्राउज़र में खोलें और आपको एक टर्मिनल, एक फ़ाइल ब्राउज़र, और उस मशीन के नेटवर्क का एक प्रॉक्सी मिलता है — या `bitbang connect <url>` के साथ दूसरे टर्मिनल से उसी मशीन तक पहुँचें, जो पोर्ट फ़ॉरवर्डिंग (`-L`) और फ़ाइल कॉपी (`bitbang cp`) जोड़ता है। कनेक्शन एंड-टू-एंड एन्क्रिप्टेड और पीयर-टू-पीयर है; `bitba.ng` सर्वर दोनों सिरों को परिचित कराता है, फिर किनारे हट जाता है।

`bitbang` एक एकल स्थिर Go बाइनरी है। यह [BitBang प्रोजेक्ट](https://github.com/richlegrand/bitbang) का हिस्सा है; यह [whitepaper](https://github.com/richlegrand/bitbang/blob/main/whitepaper.md) डिज़ाइन को गहराई से कवर करता है।

## इसकी तुलना कैसे होती है

|                                | ngrok                  | Tailscale                      | `bitbang`           |
| ------------------------------ | ---------------------- | ------------------------------ | ------------------- |
| पहले उपयोग से पहले सेटअप         | खाता + authtoken    | खाता + हर डिवाइस पर लॉगिन | **एक कमांड चलाएँ** |
| कुछ साझा करने के लिए, आप चलाते हैं    | एक वेब सर्वर, साथ ही ngrok | दोनों मशीनों पर उनका क्लाइंट | **`bitbang serve`** |
| दूर के छोर पर ब्राउज़र को क्या मिलता है | वह वेब सर्वर जो आप पहले से चला रहे थे | कुछ नहीं — उसे उनके क्लाइंट की ज़रूरत है | **एक टर्मिनल, एक फ़ाइल ब्राउज़र, और रिमोट नेटवर्क पर वेब ऐप्स** |
| डेटा पथ                      | उनके सर्वर          | P2P (रिले फ़ॉलबैक)           | **P2P (रिले फ़ॉलबैक)** |
| एंड-टू-एंड एन्क्रिप्टेड           | डिफ़ॉल्ट रूप से नहीं         | हाँ                            | **हाँ**             |

## त्वरित रेसिपी

**घर पर किसी सेवा तक पहुँचें**

- [अपने होम NAS को कहीं से भी माउंट करें (SMB)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#mount-your-home-nas-from-anywhere-smb)
- [अपनी मीडिया लाइब्रेरी कहीं से भी देखें (Jellyfin)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#watch-your-media-library-from-anywhere-jellyfin)
- [अपना खुद का LLM कहीं से भी उपयोग करें (Ollama, Open WebUI)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#use-your-own-llm-from-anywhere-ollama-open-webui)
- [अपने सुरक्षा कैमरे जाँचें (Frigate)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#check-your-security-cameras-frigate)
- [अपने होम ऑटोमेशन तक बिना उजागर किए पहुँचें (Home Assistant)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#reach-your-home-automation-without-exposing-it-home-assistant)
- [अपने होम प्रिंटर पर प्रिंट करें (IPP, CUPS)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#print-to-your-home-printer-ipp-cups)

**किसी मशीन पर पहुँचें**

- [NAT के पीछे किसी मशीन पर शेल प्राप्त करें](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#get-a-shell-on-a-machine-behind-nat)
- [अपने फ़ोन से शेल प्राप्त करें](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#get-a-shell-from-your-phone)
- [Windows मशीन पर रिमोट डेस्कटॉप (RDP)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#remote-desktop-into-a-windows-machine-rdp)
- [Linux या Mac डेस्कटॉप तक पहुँचें (VNC)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#reach-a-linux-or-mac-desktop-vnc)
- [बिना खुले पोर्ट वाली मशीन पर SSH (OpenSSH)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#ssh-to-a-machine-with-no-open-port-openssh)
- [हेडलेस Raspberry Pi सेट अप करें](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#set-up-a-headless-raspberry-pi)

**किसी और के साथ साझा करें**

साझा करने का मतलब है किसी को एक अद्वितीय URL या QR कोड देना जो उन्हें पहुँच देता है। अनुमतियाँ अनुकूलित की जा सकती हैं और मिनटों, घंटों आदि में समाप्त होने के लिए सेट की जा सकती हैं।

- [फ़ाइलें बिना कहीं अपलोड किए साझा करें](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#share-files-without-uploading-them-anywhere)
- [किसी को अपना प्रोजेक्ट दिखाएँ](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#show-someone-your-project)
- [किसी को समाप्त होने वाली पहुँच दें](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#give-someone-access-that-expires)
- [अपने फ़ोन से अपना एजेंट सत्र जाँचें (Claude Code, tmux)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#check-your-agent-session-from-your-phone-claude-code-tmux)
- [किसी और का राउटर ठीक करें](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#fix-someone-elses-router)

**विकास और डिवाइस**

- [अपने डेव मशीन से डेटाबेस तक पहुँचें (Postgres, MySQL)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#reach-a-database-from-your-dev-machine-postgres-mysql)
- [ऐसे डिवाइस सिंक करें जो एक-दूसरे को नहीं ढूँढ सकते (Syncthing)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#sync-devices-that-cannot-find-each-other-syncthing)
- [ब्राउज़र से रोबोट देखें (ROS, Foxglove)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#watch-a-robot-from-a-browser-ros-foxglove)

**तकनीकें**

- [फ़ॉरवर्डिंग लिसनर क्या उजागर करता है](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#what-a-forwarding-listener-exposes)
- [अपने LAN पर अन्य मशीनों को फ़ॉरवर्ड का उपयोग करने दें](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#let-other-machines-on-your-lan-use-a-forward)
- [ज्ञात रूप से काम नहीं करता](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#known-not-to-work)

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

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

### लिसनर: `bitbang serve````
bitbang serve                    # everything: shell + proxy + files + forward
bitbang serve shell              # just a terminal
bitbang serve files ~/share      # just a directory (-files-upload to allow uploads)
bitbang serve proxy localhost:8080       # just one web app, straight at the URL
bitbang serve proxy a.lan:80,b.lan:80    # ...or several, chosen in the browser
bitbang serve forward 127.0.0.1:22       # just TCP, for `connect -L`

bitbang serve shell files ~/share proxy nas.lan:8096   # any combination

कमांड प्रकाशित करने के बाद लौटता है, इसलिए पहले से चल रहे कार्य के लिए `Ctrl-Z`, `bitbang share`, `fg` काम करता है। होस्टिंग के लिए Unix या WSL पर tmux 3.2+ की आवश्यकता होती है। नेटिव Windows क्लाइंट URL खोल सकते हैं लेकिन शेयर होस्ट नहीं कर सकते।

डिफ़ॉल्ट रूप से, कमांड दो bearer URL प्रिंट करता है:

- **Control URL** स्थानीय कीबोर्ड के समान अधिकार के साथ टाइप कर सकता है।
  एक समय में केवल एक नियंत्रक कनेक्ट हो सकता है।
- **View URL** केवल देखने के लिए है। इनपुट tmux तक पहुँचने से पहले ही छोड़ दिया जाता है, और
  एक साथ अधिकतम `--max-viewers` दर्शक कनेक्ट हो सकते हैं (डिफ़ॉल्ट 16)।

`--read-only` नियंत्रण क्रेडेंशियल को पूरी तरह से हटा देता है। दर्शक और नियंत्रक
सीमाएँ प्रत्येक कनेक्शन के जीवनकाल के लिए बनाए रखी जाती हैं, भले ही वह शेल खोलने से पहले ही क्यों न हो।

शेयर डिफ़ॉल्ट रूप से रुकने तक चलते हैं; `--ttl` एक जीवनकाल निर्धारित करता है (जैसे `--ttl 1h`)।
शेयर URL अस्थायी होते हैं और कभी भी `devices.json` में सहेजे नहीं जाते। `share stop`,
TTL समाप्ति, या स्रोत सत्र को हटाने से दूरस्थ पीयर डिस्कनेक्ट हो जाते हैं बिना
स्रोत सत्र को रोके।

`bitbang share` को फिर से चलाने से चल रहे शेयर के URL फिर से प्रिंट होते हैं। यदि आप
एक ऐसा फ्लैग पास करते हैं जो चल रहे शेयर से मेल नहीं खाता (जैसे किसी शेयर के खिलाफ `--read-only`
जिसमें control URL है), तो यह पुराने URL वापस देने के बजाय ऐसा कहता है;
`bitbang share rotate` शेयर को एक नए से बदल देता है जो नए फ्लैग का उपयोग करता है।

एक बैकग्राउंड वर्कर एक अलग `_bbshare_*` tmux प्रबंधन सत्र में चलता है,
इसलिए प्रबंधित करने के लिए कोई डेमॉन या PID फ़ाइल नहीं है।

शेयरिंग कोई tmux विकल्प नहीं बदलती। tmux के डिफ़ॉल्ट `window-size latest` के साथ,
विंडो सक्रिय read-write क्लाइंट का अनुसरण करती है; एक अकेला दर्शक फिर भी
एकमात्र उपलब्ध आकार प्रदान करता है। यदि `window-size` को ओवरराइड किया गया है, तो `share` इसकी रिपोर्ट करता है
लेकिन उपयोगकर्ता के कॉन्फ़िगरेशन को नहीं बदलता।

### सीमित पहुँच प्रदान करना: `bitbang link`

एक लिसनर, एक URL, और जितने चाहें उतने **access links**। प्रत्येक उसी URL पर एक
अलग कोड है, जो लिसनर द्वारा प्रदान की जाने वाली सुविधाओं का एक उपसमुच्चय प्रदान करता है
और वैकल्पिक रूप से एक निश्चित समय पर समाप्त हो जाता है:```
bitbang link edit                # add entries in $EDITOR
bitbang link ls                  # what you have handed out
bitbang link rm <label>          # revoke one
bitbang link qr <label>          # its URL and QR code

सुरक्षा अनुसंधान और विकास के लिए एक शक्तिशाली उपकरण, जो आपको विभिन्न प्रकार के साइबर हमलों का अनुकरण करने और अपने नेटवर्क की सुरक्षा का परीक्षण करने की अनुमति देता है। यह उपकरण विशेष रूप से पेनिट्रेशन टेस्टिंग और सुरक्षा ऑडिट के लिए डिज़ाइन किया गया है, जिससे आप अपने सिस्टम की कमजोरियों को पहचान सकते हैं और उन्हें दूर कर सकते हैं।```
  0) owner  files forward proxy shell
     https://bitba.ng/8ach_I7oQk2vBb9xYzT0Lw#_vtQ0JCPe7s
  1) ana    files  expires in 6d
     https://bitba.ng/8ach_I7oQk2vBb9xYzT0Lw#T-Ty_HhvLfY
  2) ben    files /srv/photos
     https://bitba.ng/8ach_I7oQk2vBb9xYzT0Lw#L6La8OzBO74
  3) dev    forward 127.0.0.1:5432 shell
     https://bitba.ng/8ach_I7oQk2vBb9xYzT0Lw#8kmI3LYzB7E

लिसनर रजिस्ट्रेशन के समय कॉन्फ़िग signaling सर्वर को सौंप देता है, और सर्वर
इसे जो भी कनेक्ट होता है उसे दे देता है — इसलिए दोनों सिरे आपके relay का उपयोग करते हैं और हमारा कभी शामिल नहीं होता।
कोई भी coturn, या Cloudflare या Twilio जैसा होस्टेड प्रदाता, काम करता है।

फ़ाइल JSON है, इन तीन आकृतियों में से जो भी आपके प्रदाता ने आपको दी हो:```json
[{"urls": ["turn:turn.example.net:3478"], "username": "user", "credential": "pass"}]

मैं आपकी मदद करने के लिए यहाँ हूँ, लेकिन आपने कोई इनपुट प्रदान नहीं किया है। कृपया वह Markdown सामग्री साझा करें जिसे आप अनुवाद करना चाहते हैं, और मैं इसे हिंदी में अनुवाद कर दूँगा।```json
{"iceServers": [{"urls": ["turn:turn.example.net:3478"], "username": "u", "credential": "p"}]}

`-L` केवल **TCP** को फॉरवर्ड करता है, जैसे `ssh -L`। `-L` `127.0.0.1` पर बाइंड करता है जब तक कि आप `-g` पास नहीं करते, जो फॉरवर्ड किए गए पोर्ट को आपके स्थानीय नेटवर्क से पहुंच योग्य बनाता है — और जो कोई भी उस तक पहुंचता है, उसे वही मिलता है जो टनल तक पहुंचता है, बिना उसके सामने किसी BitBang क्रेडेंशियल के।

लिसनर को `bitbang serve forward` या `bitbang serve` की आवश्यकता होती है। डिफ़ॉल्ट रूप से एक `forward` लिंक **किसी भी host:port तक पहुंचता है जिसे लिसनर पहुंच सकता है**, न कि केवल वह जो आपके मन में था, इसलिए डेटाबेस के लिए दिया गया लिंक उस नेटवर्क के बाकी हिस्सों तक भी पहुंचता है। इसे सीमित करने के लिए बताएं कि यह किस तक पहुंच सकता है:```
bitbang serve forward db.internal:5432        # this link reaches one service

Linux और macOS। यह आपके OS और arch (`amd64`, `arm64`, और Linux पर `armv7`) का पता लगाता है, नवीनतम [GitHub release](https://github.com/richlegrand/bitbang-cli/releases) से बाइनरी डाउनलोड करता है, release के `checksums.txt` के विरुद्ध इसकी SHA-256 सत्यापित करता है, और `~/.local/bin/bitbang` में इंस्टॉल करता है।

Windows बिल्ड `bitbang-windows-amd64.exe` और
`bitbang-windows-arm64.exe` के रूप में प्रकाशित होते हैं। Releases से उपयुक्त बाइनरी डाउनलोड करें,
इसका नाम बदलकर `bitbang.exe` करें, और इसे अपने `PATH` पर रखें।
**स्रोत से बिल्ड करें:** [नीचे](#building-from-source) देखें।

**macOS और Gatekeeper।** उपरोक्त इंस्टॉल वन-लाइनर अप्रभावित है: `curl`
`com.apple.quarantine` विशेषता सेट नहीं करता है, इसलिए यह जो बाइनरी लाता है वह सामान्य रूप से चलता है।
यदि आप इसके बजाय Releases पृष्ठ से ब्राउज़र में `bitbang-darwin-arm64` डाउनलोड करते हैं,
macOS इसे quarantine करता है और इसे खोलने से मना कर देता है, क्योंकि release
बाइनरी notarized नहीं हैं। इसे निम्न में से किसी एक से साफ़ करें:```
xattr -d com.apple.quarantine ./bitbang-darwin-arm64

रिलीज़ टैग में `v` उपसर्ग नहीं होता (`0.5.0`, `v0.5.0` नहीं)।

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

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

1. `curl` `https://bitba.ng/install` को हिट करता है, जो इस रिपो (में `main` पर) में [`install.sh`](https://github.com/richlegrand/bitbang-cli/blob/HEAD/install.sh) पर 302 करता है।
2. स्क्रिप्ट आपके शेल में चलती है, OS+arch का पता लगाती है, और `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)।

## कमांड संदर्भ

हर सबकमांड और फ्लैग **[CLI.md](https://github.com/richlegrand/bitbang-cli/blob/HEAD/CLI.md)** में है, और `bitbang <command>
--help` टर्मिनल पर वही चीज़ प्रिंट करता है।

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

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

# cross-compile:
GOOS=linux   GOARCH=arm64        go build -o bitbang-arm64 ./cmd/bitbang/
GOOS=linux   GOARCH=arm GOARM=7  go build -o bitbang-armv7 ./cmd/bitbang/
GOOS=windows GOARCH=amd64        go build -o bitbang.exe   ./cmd/bitbang/
GOOS=darwin  GOARCH=arm64        go build -o bitbang-macos ./cmd/bitbang/

शेल कमांड, फ़ाइल साझाकरण, प्रॉक्सीिंग, और CLI क्लाइंट Windows पर समर्थित हैं।
इंटरैक्टिव ब्राउज़र और CLI शेल Windows ConPTY का उपयोग करते हैं, जिसमें टर्मिनल इनपुट इको, लाइन एडिटिंग, VT आउटपुट, और रीसाइज़ इवेंट शामिल हैं। ConPTY के लिए Windows 10 संस्करण 1809 या Windows Server 2019 या उसके बाद का संस्करण आवश्यक है।

## आरेख

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/47068/d68fcddad62ab84f11a549906a2b5abf2330fb25f39b3c1a1266eac7257a080d.png" alt="bitbang CLI शेल और फ़ाइल साझाकरण" width="760">
  <img src="https://assets.kitploit.com/production/public/readmes/47068/55bb6866c22504a6434e3dee8cb998e747cd73cb9d0bfa5e0bc0ede7b90ce262.png" alt="bitbang CLI प्रॉक्सी संचालन" width="720">  
</p>

## रोडमैप

आज उपलब्ध: **शेल, फ़ाइलें, और प्रॉक्सी**, ब्राउज़र या CLI से पहुंच योग्य, साथ ही **TCP पोर्ट फ़ॉरवर्डिंग**, scp-शैली फ़ाइल कॉपी, सहेजी गई डिवाइस तालिका के साथ **एड-हॉक पेयरिंग**, **टर्मिनल साझाकरण** (`bitbang share`), और **एक्सेस लिंक** (`bitbang link`) जो URL द्वारा दी गई पहुंच को सीमित और समाप्त करते हैं। डिज़ाइन किया गया और आने वाला:

- **सीरियल ब्रिजिंग** -- स्थानीय वर्चुअल पोर्ट से दूरस्थ `/dev/ttyUSB0` चलाएं (जैसे इंटरनेट पर Arduino IDE चलाना)। एक इश्यू [यहाँ](https://github.com/richlegrand/bitbang-cli/issues/3) खोला गया है।
- **रिमोट डेस्कटॉप** -- WebRTC वीडियो ट्रैक पर स्क्रीन, डेटा चैनल पर कीबोर्ड/माउस।

## लाइसेंस

MIT -- देखें [LICENSE](https://github.com/richlegrand/bitbang-cli/blob/HEAD/LICENSE)।

## योगदान

इश्यू और PR का स्वागत है।

रेसिपी अलग हैं: वे [cookbook](https://github.com/richlegrand/bitbang/blob/main/cookbook.md) में रहती हैं,
[bitbang](https://github.com/richlegrand/bitbang) रिपॉजिटरी में, क्योंकि वे इस प्रोजेक्ट के बजाय हर प्रोजेक्ट में फैली हुई हैं। रेसिपी जोड़ना वहाँ एक PR है।

इसे *सूचीबद्ध* करवाना प्रति प्रोजेक्ट एक दूसरा, छोटा PR है जिसका README इसे सतह पर लाना चाहिए -- ऊपर दी गई [रेसिपी](#recipes) सूची यहाँ हाथ से बनाए रखी जाती है। यह जानबूझकर है: प्रत्येक प्रोजेक्ट तय करता है कि कौन सी रेसिपी अपने पाठकों के सामने रखने लायक हैं, बजाय हर README में हर रेसिपी जोड़ने के।