はじめに
前提条件をインストールする
デフォルトのローカルトンネル設定では、コンピューターに次のツールをインストールします。
Node.js 20+
nodejs.org からダウンロードするか、パッケージマネージャーを使ってください。
シェル
# Check if installed
node --version
tmux
Termbridge セッションを支えるターミナルマルチプレクサです。
シェル
# macOS
brew install tmux
# Ubuntu/Debian
sudo apt install tmux
cloudflared
ターミナルへのセキュアなトンネルを作成します（サンドボックスのダイレクトモードでは不要です）。
シェル
# macOS
brew install cloudflared
# Linux - see cloudflare.com/downloads
Termbridge を実行する
シェル
npx termbridge
次のような出力が表示されます。
コード
┌─────────────────────────────────────────┐
│ Termbridge │
│ │
│ Local: http://127.0.0.1:51234 │
│ Public: https://abc123.trycloudflare.com │
│ │
│ ██████████████ │
│ ██ ██ <- Scan this QR code │
│ ██████████████ │
│ │
└─────────────────────────────────────────┘
注
trycloudflare.comURL は、アカウント不要ですぐ使えるトンネルです。Termbridge を頻繁に使う場合は、 レート制限を避けるため、名前付きCloudflareトンネルトークンを設定してください。
スマートフォンから接続する
- スマートフォンのカメラを開きます
- QR コードにかざします
- 表示されたリンクをタップします
- ブラウザーにターミナルが読み込まれます
これで接続完了です！
何が起きたのか
- Termbridge がマシン上でローカルサーバーを起動しました
- ターミナル用のtmuxセッションを作成しました
- Cloudflareがセキュアなトンネル（
trycloudflare.comURL）を作成しました - QR コードには、安全にアクセスするための一度限りのトークンが含まれています。1回だけ使用でき、起動から90秒で期限切れになります。速やかにスキャンしてください。期限が切れた場合は、Termbridge を再起動して新しいコードを取得してください
- スキャンするとセッションCookieが発行され、接続されます
試してみる
接続したら、いくつかコマンドを試してみましょう。
シェル
# See system info
htop
# Check a git repo
cd ~/your-project && git status
# Run any CLI tool
ターミナルはフルカラー、TUI、および一般的なキー操作に対応しています。
実行を続ける
接続を維持するには Termbridge を実行し続ける必要があります。終了するときは、次の操作を行います。
- Termbridge の実行中に、ターミナルで
Ctrl+Cを押します - トンネルが閉じ、接続が終了します
- tmuxセッションは維持されます（
--kill-on-exitを使用した場合を除く）
初回セッションの動作
- Termbridge はtmuxセッションを作成します（デフォルト名はポート番号から決まります）
- リストの先頭にあるターミナルが自動的に読み込まれます
TERMBRIDGE_SESSIONS=2を設定すると、起動時に複数のセッションを作成できます
既存のtmuxセッションを使う
--session <name> を渡し、そのセッションがすでに存在する場合、Termbridge は新しいセッションを作成せずに既存のセッションへ接続します。すでに起動している長時間実行プロセスを監視するのに便利です。
次のステップ
モバイル操作
スマートフォンやタブレットで Termbridge を使うためのヒント
複数のターミナル
複数のセッションを実行して切り替える
開発サーバープレビュー
ターミナルと並べてViteアプリをプレビューする
CLI リファレンス
利用可能なフラグとオプションをすべて確認する