HN 日本語サマリー

← 一覧へ戻る
Web開発

Show HN: BitBang – NATの背後にあるマシンにブラウザからアクセス、アカウント不要

Show HN: BitBang – Reach machines behind NAT from a browser, no account (github.com)

61 pointsby narragansett15 コメント

要約

BitBang CLIは、ポートフォワーディングや設定、アカウント登録なしに、ブラウザからリモートマシンへのインタラクティブシェル、ファイルブラウジング、Webアプリへのアクセスを可能にするツールです。Go言語で書かれた単一の静的バイナリで、WebRTC/DTLSによるエンドツーエンド暗号化されたP2P接続を提供します。SSHの代替として、特にNATやCGNAT環境下でのリモートアクセスを容易にし、電話越しでも可能な6桁のコードによるペアリング機能も備えています。

全文翻訳

BitBang CLI

[画像: Tests] [画像: License]

bitbangは、単一の静的バイナリで動作するリモートアクセス用マルチツールです。どのブラウザからでも、リモートマシンへのインタラクティブなシェルとファイルブラウザアクセスが可能です。そのマシンのネットワーク上にあるWebアプリケーションにもアクセスできます。ブラウザ以外にも、TCPポートフォワーディング、ファイルコピー、ターミナル共有などの機能を提供します。アカウントや設定は一切不要で、すぐに動作します。

[画像: Install bitbang, run bitbang serve, and open the printed URL in a browser to get a shell, a file browser, and a proxy to the machine's network]

アクセスしたいマシン上で、以下を実行します。

curl -sSfL bitba.ng/install | sh
bitbang serve

serveコマンドはURLを出力します。それを任意のブラウザで開くと、ターミナル、ファイルブラウザ、そしてそのマシンのネットワークへのプロキシにアクセスできます。または、別のターミナルからbitbang connect <url>で同じマシンに接続することもでき、ポートフォワーディング(-L)やファイルコピー(bitbang cp)も追加できます。接続はエンドツーエンドで暗号化され、ピアツーピアです。bitba.ngサーバーは両端を仲介するだけで、その後は関与しません。

bitbangは単一の静的なGoバイナリです。BitBangプロジェクトの一部であり、このホワイトペーパーで設計について詳しく解説しています。

比較

ngrokTailscalebitbang
初回使用前のセットアップアカウント + authtokenアカウント + 各デバイスでのログインコマンド1つで実行
何かを共有するために実行するのはWebサーバー、およびngrok両方のマシンにクライアントをインストールbitbang serve
遠端のブラウザが得られるもの実行中のWebサーバーなし -- クライアントが必要ターミナル、ファイルブラウザ、リモートネットワーク上のWebアプリ
データパスサーバー経由P2P(リレーフォールバック)P2P(リレーフォールバック)
エンドツーエンド暗号化デフォルトではなしありあり

クイックレシピ

自宅のサービスにアクセスする

マシンに接続する

他の人と共有する

共有は、アクセス権を与えるユニークなURLまたはQRコードを渡すだけです。権限はカスタマイズでき、数分または数時間で期限切れに設定することも可能です。

開発とデバイス

テクニック

bitbangの使用

すべての接続には2つのエンドポイントがあります:リスナー(アクセスされるマシンで実行されるbitbang serve)とコネクタ(アクセスするマシン上のブラウザまたはbitbang CLI)。1つのリスナーURLが両方のコネクタタイプを提供します。

リスナー: bitbang serve
bitbang serve                    # 全て: シェル + プロキシ + ファイル + フォワード
bitbang serve shell              # シェルのみ
bitbang serve files ~/share      # ディレクトリのみ(アップロードを許可するには -files-upload)
bitbang serve proxy localhost:8080       # 1つのWebアプリのみ、URLに直接
bitbang serve proxy a.lan:80,b.lan:80    # または複数、ブラウザで選択
bitbang serve forward 127.0.0.1:22       # TCPのみ、`connect -L`用

bitbang serve shell files ~/share proxy nas.lan:8096   # 任意の組み合わせ

それぞれQRコード、URL、ペアリングコードを出力します。モードによってリスナーが何を提供できるかが決まります。serve shellはフォワードを提供せず、フォワード専用リスナーはシェルを開始しないため、エスカレーションできるものはありません。

知っておくと便利なデフォルト設定:フォワーディングとプロキシは、指定したホストだけでなく、リスナーが到達できる任意のホスト:ポートにアクセスできます。そのため、データベース用に発行されたリンクは、そのネットワークの他の部分にもアクセスできます。ターゲットをforward db.internal:5432のように単語で指定すると、そのサービスのみに限定されます。

実行中のセッションの共有: bitbang share

serve shellは新しいシェルを開始します。shareは既に実行中のtmuxセッションを公開します。

bitbang share                    # 現在のtmuxセッションを公開
bitbang share --read-only        # コントロールURLなしで公開
bitbang share status|stop|rotate

コマンドは公開後に返されるため、Ctrl-Z、bitbang share、fgの順で実行すると、進行中のタスクを共有できます。ホスティングにはUnixまたはWSLでtmux 3.2以上が必要です。ネイティブWindowsクライアントはURLを開くことはできますが、共有をホストすることはできません。

デフォルトでは、コマンドは2つのベアラートークンURLを出力します。

  • コントロールURL:ローカルキーボードと同じ権限で入力できます。一度に1人のコントローラーが接続できます。
  • 表示URL:閲覧専用です。入力はtmuxに到達する前に破棄され、最大--max-viewers(デフォルト16)のビューアが同時に接続できます。

--read-onlyはコントロール認証情報を完全に省略します。ビューアとコントローラーの制限は、シェルが開かれる前であっても、各接続の有効期間中に保持されます。

共有はデフォルトで停止されるまで実行されます。--ttlで有効期間を設定できます(例:--ttl 1h)。共有URLは一時的なもので、devices.jsonには保存されません。share stop、TTLの期限切れ、またはソースセッションの削除により、リモートピアはソースセッションを停止せずに切断されます。

bitbang shareを再度実行すると、実行中の共有のURLが再表示されます。実行中の設定と異なるフラグを渡した場合(例:コントロールURLを持つ共有に対して--read-only)、古いURLを返すのではなく、その旨が表示されます。bitbang share rotateは、新しいフラグを使用する共有に置き換えます。

バックグラウンドワーカーは分離された_bbshare_* tmux管理セッションで実行されるため、デーモンやPIDファイルは管理不要です。

共有はtmuxオプションを変更しません。tmuxのデフォルトwindow-size latestでは、ウィンドウはアクティブな読み書きクライアントに従いますが、ビューアのみの場合でも利用可能なサイズが提供されます。window-sizeがオーバーライドされている場合、shareはそのことを報告しますが、ユーザーの設定は変更しません。

限定的なアクセス権の付与: bitbang link

1つのリスナー、1つのURL、そして必要な数のアクセスリンク。それぞれが同じURL上の個別のコードであり、リスナーが提供する機能の一部を付与し、オプションで固定時間に失効します。

bitbang link edit                # $EDITORでエントリを追加
bitbang link ls                  # 現在付与されているもの一覧
bitbang link rm <label>          # 1つを無効化
bitbang link qr <label>          # そのURLとQRコード

エントリは~/.bitbang/bitbang/links.json内のJSON行です。コードなしで1つ記述し、リスナーをコンソールでリロードすると、それが生成されます。

[
  {"label": "ana",  "grant": "files", "expires": "2026-09-01T00:00:00Z"},
  {"label": "ben",  "grant": "files /srv/photos"},
  {"label": "dev",  "grant": "shell forward 127.0.0.1:5432"}
]
  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

ownerは自身のコードであり、リスナーが提供する全てを付与します。他のものを代わりに送信してください。コンソールはラベルまたはその横の番号を受け付けるため、rm 2とrm benは同じことを行います。

grantはserveが受け付ける言葉で書かれ、リスナーが既に提供しているものに限定することしかできません。つまり、リンクは機能を選択するだけでなく、共有フォルダのサブディレクトリ、フォワードターゲットのサブセット、またはshell用の単一コマンドを指定できます。grantを省略すると、リンクはリスナーが提供する全てを付与します。リスナーの範囲外のものを要求すると、コンソールはserveと同じメッセージで拒否します。

ラベルはリンクを識別するものであり、その条件ではありません。そのため、2人が同じ付与内容と有効期限を持つリンクを持っていても、一方をもう一方に影響を与えることなく取り消すことができます。

取り消しと有効期限は既に開いているセッションにも適用されます。接続は閉じられ、保持者には理由が通知されます。また、期限切れのコードは一時停止ではなく廃止されるため、既に送信したURLは無効なままです。更新すると新しいコードが生成されます。

6桁のコードによるペアリング

URLを貼り付けたりQRコードをスキャンしたりできない場合(電話中や、叫べる距離にいる場合など)、bitbang serveは短いペアリングコードも出力します。相手がbitba.ng/<code>を開くか(またはbitbang connect <code>を実行する)と、画面に2番目の6桁の数字が表示され、それをあなたに読み上げます。あなたがそれを入力して承認します。中間者攻撃者は2つの数字を一致させることができず、ペアリングは次回のためにデバイス接続認証情報を保存します(例:bitbang connect nas1)。Magic Wormholeに慣れているなら、形状は似ています――話されたコードが2台のマシンを安全に紹介します。

[画像: Server prints a 5-minute pairing code; the other party enters it at bitba.ng, their screen shows a 6-digit challenge to read aloud, and typing it back on the serving machine approves the connection]

独自のTURNサーバーを使用する

ほとんどの接続は直接ピアツーピアで行われます。両端がNATの背後にあり、ホールパンチングができない場合、トラフィックはリレーを必要とします。デフォルトでは、それは私たちのリレーです。-ice-serversはリスナーを独自のサーバーに向けるようにします。

bitbang serve -ice-servers ~/turn.json

リスナーは登録時に設定をシグナリングサーバーに渡し、サーバーはそれを接続する人に渡します。これにより、両端があなたのリレーを使用し、私たちのリレーは決して関与しません。coturnまたはCloudflareやTwilioのようなホスト型プロバイダーが利用可能です。

ファイルはJSON形式で、プロバイダーから提供された3つの形式のいずれかです。

[{"urls": ["turn:turn.example.net:3478"], "username": "user", "credential": "pass"}]
{"ice_servers": [{"urls": "stun:stun.example.net:3478"}]}
{"iceServers": [{"urls": ["turn:turn.example.net:3478"], "username": "u", "credential": "p"}]}

urlsは文字列またはリストを受け付けます。usernameとcredentialはTURN用であり、STUNのみのエントリからは省略できます。パスは絶対パス、相対パス、または~で始まるパスでも構いません。解析できないファイルは、サイレントフォールバックではなく、起動時にリスナーを停止させます。

要求されずにリレーが使用された場合、bitbang connectは遅く感じる理由を推測させるのではなく、その旨を表示します。リスナーはどちらの場合もログに記録します(via RELAY)。-relay / -norelayは、パスの診断時に一方の方向に強制します。

言及する価値があるのは、これはバイトを誰が運ぶかであり、誰がそれを読めるかではないということです。リレーはDTLS暗号化されたデータしか見ません。より多くのTURNが必要な場合は、独自のものを実行してください(現在、時間は制限されています)。

ブラウザからの接続

URLを開きます。提供されているものに応じて、以下が得られます。

  • シェル:ページ内の完全なターミナル(色、リサイズ、コピー/ペースト)。
  • ファイル:参照、プレビュー、ダウンロード、アップロード。
  • プロキシ:LANアドレス(nas.local、192.168.1.10:8080、localhost:3000/admin)を入力し、ローカルにいるかのようにアプリを使用します。ログイン、クッキー、アップロード、ストリーミングはすべて機能します。
CLIからの接続
bitbang connect <url>                                   # インタラクティブシェル
bitbang connect <url> -- tail -f /var/log/syslog        # 単発コマンド
bitbang connect <url> -L 15432:db.internal:5432         # ローカルTCPフォワーディング
bitbang connect <url> -L 14450:nas.local:445 -L 15900:[fd00::20]:5900
bitbang cp <url>:/var/log/app.log ./app.log             # ファイルコピー、scp風
bitbang cp - <url>:/tmp/firmware.bin < firmware.bin     # stdin/stdoutも可能

-LはTCPのみをフォワードします、ssh -Lのように。-Lは127.0.0.1にバインドしますが、-gを渡すとフォワードされたポートがローカルネットワークから到達可能になります。そして、それに到達した誰もが、BitBang認証情報なしでトンネルが到達するものを取得します。

リスナーはbitbang serve forwardまたはbitbang serveを必要とします。デフォルトでは、forwardリンクは指定したホストだけでなく、リスナーが到達できる任意のホスト:ポートにアクセスできます。そのため、データベース用に発行されたリンクは、そのネットワークの他の部分にもアクセスできます。到達できるものを指定することで、範囲を狭めることができます。

bitbang serve forward db.internal:5432        # このリンクは1つのサービスに到達します

成功した接続またはペアリングはすべて~/.bitbang/devices.jsonに保存されるため、それ以降は短い名前で十分です:bitbang connect nas1。

プラットフォームサポート

プラットフォームごとに1つのバイナリ、ランタイム依存関係なし。以下で言及されている2行を除き、すべてどこでも動作します。

LinuxmacOSWindows
シェル、ファイル、プロキシ (bitbang serve)はいはいはい
TCPフォワーディング (-L)はいはいはい
アクセスリンク -- 付与、有効期限、取り消しはいはいはい
独自のTURNサーバーを使用はいはいはい
6桁コードによるペアリングはいはいはい
リスナーコンソール (Enter)はいはいはい
bitbang connect, bitbang cpはいはいはい
共有セッションの表示はいはいはい
共有のホスティング (bitbang share)はいはいいいえ *
接続中のターミナルリサイズはいはいいいえ **
  • bitbang shareはtmuxセッションを公開するため、ホストするにはtmuxが必要です -- Linux、macOS、またはWSL。ネイティブWindowsでも共有URLをbitbang connectで開くことはできます。
    ** Windowsコネクタはターミナルがリサイズされたことを認識しないため、リモートシェルは再接続されるまで開始時のサイズを維持します。UnixはSIGWINCHからこれを得ますが、Windowsには同等のものはありません。

セキュリティ

  • 自己証明型ID。初回実行時、bitbangは~/.bitbang/<program>/の下にRSAキーペアを生成します。デバイスUIDはその公開鍵から派生するため、デバイスをなりすますにはそのUIDのセカンドプリイメージを見つける必要があります。
  • 秘密鍵はサーバーに触れない。アクセスコードはURLフラグメント(#…)にあり、ブラウザはそれを送信しません。bitba.ngは認証資格情報を見ることなく接続を仲介します。
  • エンドツーエンド暗号化。すべてのトラフィックはWebRTCのDTLSに乗ります。シグナリングサーバーは公開鍵、派生UID、接続メタデータのみを観察します――あなたのデータは観察しません。TURNリレーが必要な場合でも、暗号化されたデータのみを扱います。
  • 検証済みペアリング。コードペアリングで読み上げられる数字は、ネゴシエートされたDTLSフィンガープリントと2つのコミットされたノンスから独立して両端で計算されたショートオーセンティケーションストリング(SAS)です。フィンガープリントが異なる中間者攻撃者は、2つの数字を一致させることができません。
  • URLはベアラートークン。それを持っている人は誰でも、あなたが提供することを選択したものを取得します――あなたがserve shellを実行した場合、シェルなど。それに応じて共有してください。
  • オプションのPIN(--pin)は永続的またはヘッドレスセットアップ用、使い捨てモード(-ephemeral)は実行ごとに新しいID用です。
  • サーバーがまだ見ているもの。全く何も見ないわけではありません。紹介を仲介するため、両端のIPアドレス、接続時間、交換量などを観察します。エンドツーエンド暗号化はデータを保護しますが、その周りのメタデータからは保護しません――最小限の信頼が信頼なしよりも適切な説明です。
  • ブラウザは読み込んだページを信頼する。ブラウザクライアントはシグナリングサーバーから提供されるJavaScriptであるため、URLを開くことは、そのサーバーが正直なコードを提供することを信頼することを意味します。bitbang connectにはそのような依存関係はありません。インストールしてチェックサムを確認したバイナリです。この区別があなたにとって重要であれば、CLIで接続してください。

両端がシグナリングサーバーを接続に挿入できないように互いを認証する方法は、ここで詳細に説明されています:Trustless Signaling: Authentication Without a Central Authority。

なぜ?

  • 開いたり設定したりするものが何もない。NAT、CGNAT、またはロックダウンされたネットワークの後ろからでも動作します――ルーターの変更、VPN、トンネルデーモンは不要です。
  • 接続側には何もインストールする必要がない。ブラウザがあれば十分です。スクリプティング、パイプ、ファイルコピーが必要な場合はCLIがあります。
  • 設計上プライベート。トラフィックはWebRTC/DTLS、ピアツーピアです。シグナリングサーバーはそれを決して見ません。直接パスが不可能な場合、TURNリレーが暗号化されたデータのみを運びます。
  • アカウントなし、テレメトリなし。
なぜSSHやTailscaleを使わないのか?

短い答え:既にSSHできるマシンや、インストールできる自身のデバイスのフリートがある場合は、使い慣れたものを使用してください。bitbangは、相手がデバイスではなく人の場合、またはあなたが座っている場所に何もインストールできない場合のためです。両方の質問はFAQで詳しく説明されています。

インストール

curl -sSfL bitba.ng/install | sh

LinuxとmacOS。OSとアーキテクチャ(Linuxではamd64、arm64、armv7)を検出し、最新のGitHubリリースからバイナリをダウンロードし、リリースにあるchecksums.txtに対してSHA-256を検証し、~/.local/bin/bitbangにインストールします。

Windowsビルドはbitbang-windows-amd64.exeおよびbitbang-windows-arm64.exeとして公開されています。Releasesから適切なバイナリをダウンロードし、bitbang.exeにリネームしてPATHに配置してください。ソースからビルド:下記を参照してください。

macOSとGatekeeper。上記のインストールワンライナーは影響を受けません。curlはcom.apple.quarantine属性を設定しないため、ダウンロードしたバイナリは通常通り実行されます。代わりにReleasesページからブラウザでbitbang-darwin-arm64をダウンロードした場合、macOSはそれを検疫し、実行を拒否します。なぜなら、リリースバイナリは署名されていないからです。以下のいずれかでクリアしてください。

xattr -d com.apple.quarantine ./bitbang-darwin-arm64

またはFinderでファイルを右クリックして「開く」を選択し、一度限りのオーバーライドを提供します。または、ソースからビルドします。これは決して検疫されません。

WindowsとSmartScreen。同じ理由でWindowsでも同様のことが起こります。ブラウザからのダウンロードはMark-of-the-Webを付与するため、初回実行時に「WindowsによってPCが保護されました」と表示されます。「詳細情報」を選択し、「実行する」をクリックしてください。リリースバイナリはコード署名されていないため、これは予期される動作であり、問題がある兆候ではありません。curlまたはPowerShellのInvoke-WebRequestで.exeを取得しても、それは付与されず、ソースからビルドしても同様です。

インストールオプション

バージョンをピン留めしたり、場所を変更したり、実行前にスクリプトを読んだりできます。

curl -sSfL bitba.ng/install | sh -s -- --version 0.5.0
curl -sSfL bitba.ng/install | sh -s -- --prefix /usr/local/bin

curl -sSfL bitba.ng/install -o install.sh && less install.sh && sh install.sh

リリースタグにはvプレフィックスはありません(v0.5.0ではなく0.5.0)。

インストールURLの仕組み

bitba.ng/installはホストされたスクリプトではなく、リダイレクトです。チェーン:

  1. curlがhttps://bitba.ng/installにアクセスし、このリポジトリのinstall.sh(mainブランチ)に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環境変数はリダイレクトターゲットを制御します(空の場合は404)。

コマンドリファレンス

すべてのサブコマンドとフラグはCLI.mdにあり、bitbang <command> --helpでターミナルに同じものが表示されます。

ソースからのビルド

Go 1.25+が必要です。純粋なGo、静的リンク(CGO_ENABLED=0)――クロスコンパイルが容易で、ランタイム依存関係はありません。

go build ./cmd/bitbang/

# クロスコンパイル:
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/

Windowsコマンドプロンプトから:

go build -o bitbang.exe .\cmd\bitbang
go test .\...
run_tests.cmd unit

シェルコマンド、ファイル共有、プロキシ、CLIクライアントはWindowsでサポートされています。インタラクティブなブラウザおよびCLIシェルは、Windows ConPTYを使用します。これには、ターミナル入力エコー、行編集、VT出力、リサイズイベントが含まれます。ConPTYはWindows 10バージョン1809またはWindows Server 2019以降が必要です。

図

[画像: bitbang CLI shell and file sharing] [画像: bitbang CLI proxy operation]

ロードマップ

本日リリース:シェル、ファイル、プロキシ(ブラウザまたはCLIからアクセス可能)、さらにTCPポートフォワーディング、scp風ファイルコピー、保存されたデバイステーブルを持つアドホックペアリング、ターミナル共有(bitbang share)、およびURLが付与するものを絞り込み、期限切れにするアクセスリンク(bitbang link)。設計済みで開発中の機能:

  • シリアルブリッジ -- ローカル仮想ポートからリモート/dev/ttyUSB0を駆動する(例:インターネット経由でArduino IDEを実行)。問題がここに開かれています。
  • リモートデスクトップ -- WebRTCビデオトラック経由の画面、データチャネル経由のキーボード/マウス。

ライセンス

MIT -- LICENSEを参照してください。

貢献

IssueとPRを歓迎します。

レシピは異なります。これらはcookbookのbitbangリポジトリにあり、プロジェクト全体にまたがるため、このプロジェクトだけのものではありません。レシピの追加は、そちらへのPRです。

リストに載せることは、各プロジェクトからの小さなPRです。そのREADMEにはそれが表示されるべきです――上記のレシピリストはここで手動で維持されています。これは意図的です:各プロジェクトは、すべてのREADMEにすべてのレシピを追加するのではなく、自身の読者に提示する価値のあるレシピを決定します。