
エンドツーエンド暗号化されたピアツーピアWebRTCを介して、インタラクティブシェル・ファイル転送・Webプロキシを備えたマシンへの安全なリモートアクセスを確立します。ブラウザまたはCLIを使用し、ポートフォワーディングやアカウントは不要です。
# BitBang CLI
[](https://github.com/richlegrand/bitbang-cli/actions/workflows/tests.yml)

`bitbang` は単一の静的バイナリによるリモートアクセスのマルチツールです。任意のブラウザから、リモートマシンへのインタラクティブシェルとファイルブラウザにアクセスできます。そのマシンのネットワーク上のWebアプリにも到達できます。ブラウザ以外にも、TCPポートフォワーディング、ファイルコピー、ターミナル共有を行えます。アカウントも設定も不要で、そのまま動作します。

接続先のマシン上で:
```
curl -sSfL bitba.ng/install | sh
bitbang serve
```
`serve` は URL を出力します。任意のブラウザで開くと、ターミナル、ファイルブラウザ、そしてそのマシンのネットワークへのプロキシが利用できます。あるいは別のターミナルから `bitbang connect <url>` で同じマシンに接続でき、ポート転送(`-L`)とファイルコピー(`bitbang cp`)が追加されます。接続はエンドツーエンドで暗号化されたピアツーピア方式です。`bitba.ng` サーバーは両端を引き合わせた後、身を引きます。
`bitbang` は単一の静的 Go バイナリです。[BitBang プロジェクト](https://github.com/richlegrand/bitbang)の一部であり、この[ホワイトペーパー](https://github.com/richlegrand/bitbang/blob/main/whitepaper.md)では設計を詳しく解説しています。
## 比較
| | ngrok | Tailscale | `bitbang` |
| ------------------------------ | ---------------------- | ------------------------------ | ------------------- |
| 初回利用前のセットアップ | アカウント + authtoken | アカウント + 各デバイスでのログイン | **コマンドを1つ実行するだけ** |
| 何かを共有するために実行するもの | Web サーバー、加えて ngrok | 両方のマシンでクライアントを実行 | **`bitbang serve`** |
| 遠隔側のブラウザが得るもの | すでに実行していた Web サーバー | 何もなし -- クライアントが必要 | **ターミナル、ファイルブラウザ、リモートネットワーク上の Web アプリ** |
| データ経路 | 彼らのサーバー | 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#show-someone-the-error-you-are-stuck-on)
- [期限付きのアクセス権を誰かに付与する](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) です。1 つのリスナー 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
```
それぞれが QR コード、URL、ペアリングコードを出力します。モードはリスナーがそもそも何を行えるかを決めます。`serve shell` には付与する転送機能がなく、転送専用リスナーはシェルを起動しないため、昇格できる対象は何もありません。
知っておくべきデフォルトが 1 つあります。**転送とプロキシは、リスナーが到達できる任意の host:port に到達します**。想定していた 1 つだけではありません。そのため、データベース用に発行したリンクは、そのネットワークの他の部分にも到達します。ターゲットをその語の後に指定すると範囲が狭まります。`forward db.internal:5432` はそこにのみ到達し、それ以外には到達しません。
### 実行中のセッションを共有する: `bitbang share`
`serve shell` は新しいシェルを起動します。`share` はすでに実行中の tmux セッションを公開します:
```
bitbang share # publish the current tmux session
bitbang share --read-only # publish without a control URL
bitbang share status|stop|rotate
```
コマンドは公開後に戻るため、すでに進行中のタスクに対して `Ctrl-Z`、`bitbang share`、`fg` が機能します。ホスティングには Unix または WSL 上の tmux 3.2+ が必要です。ネイティブ Windows クライアントは URL を開くことはできますが、共有をホストすることはできません。
デフォルトでは、コマンドは 2 つのベアラー URL を出力します:
- **Control URL** はローカルキーボードと同じ権限で入力できます。一度に接続できるコントローラーは 1 つです。
- **View 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 # 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
```
エントリは `~/.bitbang/bitbang/links.json` 内の JSON の 1 行です。コードなしで 1 つ書き込み、コンソールでリスナーをリロードすると、1 つ生成されます:
```json
[
{"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 人が同一の grant と有効期限を持つリンクを保持していても、一方に触れずに他方を失効させることができます。
失効と有効期限はすでに開いているセッションにも及びます。接続は閉じられ、保持者には理由が通知され、黙って落ちることはありません。また、期限切れのコードは一時停止ではなく廃止されます。エントリを更新すると新しいコードが発行されるため、すでに送信した URL は無効のままです。
### BitBang がファイルを保存する場所
BitBang が自身について保存するものはすべて 1 つのディレクトリにあります。URL を固定するアイデンティティキーペア、リンクテーブル、`connect` と `cp` が読み取る保存済みデバイステーブル、および共有状態です。デフォルトでは `~/.bitbang` です。
サービスはしばしば `~` を使用できません。`-home` でディレクトリを設定でき、`BITBANG_HOME` もすべてのコマンドでフラグを繰り返すことなく同じことを行います:
```
bitbang serve shell -home /var/lib/bitbang
BITBANG_HOME=/var/lib/bitbang bitbang link ls
```
フラグは `serve` だけでなくすべてのコマンドに付いています。というのも、このディレクトリは serve 専用のものではないからです。`bitbang link` で一度でも付け忘れると、別のテーブルを編集してしまうことになります。
完全な優先順位は次のとおりで、最初に一致したものが優先されます:
| 設定 | 使用されるディレクトリ |
|---|---|
| `-home <dir>` | まさにそのディレクトリ |
| `$BITBANG_HOME` | まさにそのディレクトリ |
| `$STATE_DIRECTORY` | まさにそのディレクトリ -- systemd が `StateDirectory=` から設定するため、ユニット側では何も必要ありません |
| `$XDG_STATE_HOME` | `$XDG_STATE_HOME/bitbang` |
| `$HOME` | `$HOME/.bitbang` |
| いずれもなし | 何もなし: BitBang は停止してその旨を通知します |
最初の3つはディレクトリそのものを指定し、最後の2つはそのディレクトリがぶら下がる親を指定します。
最後の行は、サービスユーザーにホームがないマシンで重要になります。以前のバージョンでは作業ディレクトリにフォールバックしていたため、`HOME` なしで起動したリスナーは、たまたま起動した場所に鍵ペアを書き込んでいました -- init スクリプトの場合は `/` です。現在は、誰も選んでいない場所に秘密鍵を置くのではなく、拒否するようになっています。
リスナーは起動時にディレクトリ名を表示するため、これらのうちどれが優先されたかを自分で判断する必要はありません:
```
Home: /home/you/.bitbang
Home: /var/lib/bitbang (STATE_DIRECTORY)
```
そのため、systemdユニットにはこのためのBitBang固有の設定はまったく必要ありません:
```ini
[Service]
StateDirectory=bitbang
ExecStart=/usr/local/bin/bitbang serve shell
```
### 6桁のコードによるペアリング
URLを貼り付けたりQRコードをスキャンしたりできない場合、たとえば電話中や声が届く距離にいる場合、`bitbang serve` は短い**ペアリングコード**も出力します。相手は `bitba.ng/<code>` を開くか(または `bitbang connect <code>` を実行するか)し、相手の画面に2つ目の6桁の数字が表示されるので、相手は*その*数字を読み上げてあなたに伝えます。あなたがそれを入力して承認します。中間者攻撃を行うマシンは2つの数字を一致させることができず、ペアリングによって次回のためにデバイス接続の認証情報が保存されます(例: `bitbang connect nas1`)。[Magic Wormhole](https://github.com/magic-wormhole/magic-wormhole) をご存じなら、形は似ています -- 2台のマシンを安全に引き合わせる、口頭で伝えるコードです。

### 独自のTURNを持ち込む
ほとんどの接続はピアツーピアで直接行われます。両端がホールパンチングできないNATの背後にある場合、トラフィックにはリレーが必要であり、デフォルトではそれは当社のものです。`-ice-servers` を使うと、リスナーを独自のリレーに向けられます:
```
bitbang serve -ice-servers ~/turn.json
```
リスナーは登録時に設定をシグナリングサーバーに渡し、サーバーはそれを接続してきた相手に渡します。つまり両端ともあなたのリレーを使用し、私たちのリレーは一切関与しません。coturn でも、Cloudflare や Twilio のようなホスト型プロバイダーでも動作します。
ファイルは JSON 形式で、プロバイダーから渡された次の3つの形式のいずれかになります:
```json
[{"urls": ["turn:turn.example.net:3478"], "username": "user", "credential": "pass"}]
```
```json
{"ice_servers": [{"urls": "stun:stun.example.net:3478"}]}
```
```json
{"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 を開きます。提供される内容に応じて、次のいずれかが得られます:
- **Shell** -- ページ内の完全なターミナル(色、リサイズ、コピー/ペースト)。
- **Files** -- 閲覧、プレビュー、ダウンロード、アップロード。
- **Proxy** -- LAN アドレス(`nas.local`、`192.168.1.10:8080`、`localhost:3000/admin`)を入力し、ローカルにいるかのようにアプリを使用できます。ログイン、Cookie、アップロード、ストリーミングはすべて機能します。
<!-- TODO: per-feature demos -->
<!-- Remote shell in a browser tab -->
<!-- Streaming Jellyfin through the proxy -->
### CLI からの接続
```
bitbang connect <url> # interactive shell
bitbang connect <url> -- tail -f /var/log/syslog # one-shot command
bitbang connect <url> -L 15432:db.internal:5432 # local TCP forwarding
bitbang connect <url> -L 14450:nas.local:445 -L 15900:[fd00::20]:5900
bitbang cp <url>:/var/log/app.log ./app.log # copy files, scp-style
bitbang cp - <url>:/tmp/firmware.bin < firmware.bin # stdin/stdout work too
```
`-L` は `ssh -L` と同様に **TCP のみ** を転送します。`-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
```
接続やペアリングに成功するたびに `~/.bitbang/devices.json` に保存されるため、以降は短い名前だけで済みます: `bitbang connect nas1`。
## プラットフォーム対応
プラットフォームごとに1つのバイナリで、ランタイム依存はありません。以下に挙げる2行を除き、すべての環境で動作します。
| | Linux | macOS | Windows |
| ---------------------------------------- | :---: | :---: | :-----: |
| シェル、ファイル、プロキシ (`bitbang serve`) | yes | yes | yes |
| TCP フォワーディング (`-L`) | yes | yes | yes |
| アクセスリンク -- 付与、有効期限、失効 | yes | yes | yes |
| 独自の TURN を持ち込む | yes | yes | yes |
| 6桁コードによるペアリング | yes | yes | yes |
| リスナーコンソール (Enter) | yes | yes | yes |
| `bitbang connect`、`bitbang cp` | yes | yes | yes |
| 共有セッションの閲覧 | yes | yes | yes |
| **共有のホスト** (`bitbang share`) | yes | yes | no * |
| **接続中のターミナルリサイズ** | yes | yes | no ** |
\* `bitbang share` は tmux セッションを公開するため、ホストするには tmux が必要です -- Linux、macOS、または WSL です。ネイティブ Windows でも `bitbang connect` で共有 URL を開くことはできます。
\*\* Windows のコネクタはターミナルのリサイズを検知しないため、リモートシェルは再接続するまで開始時のサイズを維持します。Unix ではこれを `SIGWINCH` から取得しますが、Windows にはこれに相当するものがありません。
## セキュリティ
- **自己証明型のアイデンティティ。** 初回実行時に、`bitbang` は `~/.bitbang/<program>/` の下に RSA 鍵ペアを生成します。デバイス UID は公開鍵から導出されるため、デバイスをなりすますにはその UID の第二原像を見つける必要があります。
- **シークレットはサーバーに一切渡りません。** アクセスコードは URL フラグメント (`#…`) 内に存在し、ブラウザはこれを送信しません -- `bitba.ng` は、それを認可する資格情報を一度も見ることなく接続を仲介します。
- **エンドツーエンド暗号化。** すべてのトラフィックは WebRTC の DTLS 上を流れます。シグナリングサーバーが見るのは公開鍵、導出された UID、および接続メタデータのみで、あなたのデータを見ることはありません。TURN リレーが必要な場合でも、それが見るのは暗号文のみです。
- **検証済みペアリング。** コードペアリングにおける読み上げ番号は短い認証文字列 (SAS) であり、ネゴシエートされた DTLS フィンガープリントと2つのコミット済みノンスから両端で独立に計算されます -- フィンガープリントが必然的に異なる中間者攻撃者は、2つの番号を一致させることはできません。
- **URL はベアラ資格情報です。** それを所持する者は誰でも、あなたが提供することを選んだもの -- `serve shell` を実行したならシェル -- を手に入れます。それに応じて共有してください。
- **オプションの PIN** (`--pin`) は常設またはヘッドレスなセットアップ向けで、**使い捨てモード** (`-ephemeral`) は実行ごとに新しいアイデンティティを生成します。
- **サーバーが依然として見るもの。** 何も見ないわけではありません。サーバーは紹介を仲介するため、
両端の IP アドレス、接続した時刻、そしてやり取りした量を観測します。エンドツーエンド暗号化は
あなたのデータからサーバーを締め出しますが、その周囲のメタデータから締め出すわけではありません --
*トラストレス* よりも *最小限の信頼* のほうが適切な表現です。
- **ブラウザは読み込んだページを信頼します。** ブラウザクライアントはシグナリングサーバーが配信する
JavaScript であるため、URL を開くことは、そのサーバーが誠実なコードを配信することを信頼することを意味します。
`bitbang connect` にはそのような依存はありません: それはあなたがインストールしチェックサムを検証した
バイナリです。この区別が重要な場合は、CLI で接続してください。
両端が互いを認証し、シグナリングサーバーが接続に割り込めないようにする仕組みの詳細は、こちらで解説しています: [*Trustless Signaling: Authentication Without a Central Authority*](https://github.com/richlegrand/bitbang/blob/main/trustless-signaling.md)。
## なぜ?
- **開いたり設定したりするものは何もありません。** NAT、CGNAT、またはロックダウンされたネットワークの背後からでも動作します -- ルーターの変更も、VPN も、トンネルデーモンも不要です。
- **接続する側にインストールするものは何もありません。** ブラウザだけで十分です。スクリプト、パイプ、ファイルコピーが必要なときには CLI も用意されています。
- **設計上プライベート。** トラフィックは WebRTC/DTLS のピアツーピアです。シグナリングサーバーがそれを目にすることはありません。直接経路が不可能な場合は、TURN リレーが暗号文のみを運びます。
- **アカウント不要、テレメトリなし。**
### 単に SSH を使えばいいのでは? あるいは Tailscale では?
短い答え: すでに SSH で接続できるマシン、または自分でインストールできる自分のデバイス群であれば、今お使いのものをそのまま使い続けてください。`bitbang` は、接続先がデバイスではなく人である場合や、今いる場所に何もインストールできない場合のためのものです。どちらの疑問についても、**[FAQ](https://github.com/richlegrand/bitbang-cli/blob/main/FAQ.md)** で詳しく回答しています。
## インストール
```
curl -sSfL bitba.ng/install | sh
```
Linux および macOS。OS とアーキテクチャ(`amd64`、`arm64`、Linux では `armv7`)を検出し、最新の [GitHub リリース](https://github.com/richlegrand/bitbang-cli/releases) からバイナリをダウンロードし、リリースの `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 はそれを隔離し、開くことを拒否します。これはリリース
バイナリが公証されていないためです。次のいずれかで解除できます:
```
xattr -d com.apple.quarantine ./bitbang-darwin-arm64
```
または Finder でファイルを右クリックして「開く」を選択すると、1 回限りの
上書きが可能になります。あるいは、ソースからビルドする方法では隔離が一切行われません。
**Windows と SmartScreen。** 同じ理由で、Windows でも同じことが起こります。ブラウザからのダウンロードには Mark-of-the-Web が付与されるため、初回実行時に
*「Windows によって PC が保護されました」* と表示されます -- **詳細情報** を選択し、次に **実行** をクリックしてください。リリースバイナリはコード署名されていないため、これは何か問題がある兆候ではなく想定内の動作です。`curl` や PowerShell の
---
[Read more](https://github.com/richlegrand/bitbang-cli)