# はじめに

## 前提条件をインストールする

デフォルトのローカルトンネル設定では、コンピューターに次のツールをインストールします。

### Node.js 20+

[nodejs.org](https://nodejs.org) からダウンロードするか、パッケージマネージャーを使ってください。

```bash
# Check if installed
node --version
```

### tmux

Termbridge セッションを支えるターミナルマルチプレクサです。

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

ターミナルへのセキュアなトンネルを作成します（サンドボックスのダイレクトモードでは不要です）。

```bash
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads
```

[cloudflaredをダウンロード](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## Termbridge を実行する

```bash
npx termbridge
```

次のような出力が表示されます。

```
┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘
```

> **注**
> `trycloudflare.com` URL は、アカウント不要ですぐ使えるトンネルです。Termbridge を頻繁に使う場合は、
> レート制限を避けるため、名前付きCloudflareトンネルトークンを設定してください。


## スマートフォンから接続する

1. スマートフォンのカメラを開きます
2. QR コードにかざします
3. 表示されたリンクをタップします
4. ブラウザーにターミナルが読み込まれます

これで接続完了です！

## 何が起きたのか

1. Termbridge がマシン上でローカルサーバーを起動しました
2. ターミナル用のtmuxセッションを作成しました
3. Cloudflareがセキュアなトンネル（`trycloudflare.com` URL）を作成しました
4. QR コードには、安全にアクセスするための一度限りのトークンが含まれています。1回だけ使用でき、起動から90秒で期限切れになります。速やかにスキャンしてください。期限が切れた場合は、Termbridge を再起動して新しいコードを取得してください
5. スキャンするとセッションCookieが発行され、接続されます

## 試してみる

接続したら、いくつかコマンドを試してみましょう。

```bash
# 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 は新しいセッションを作成せずに既存のセッションへ接続します。すでに起動している長時間実行プロセスを監視するのに便利です。

## 次のステップ

### [モバイル操作](https://termbridge.inline0.dev/ja/docs/usage/mobile-controls)

スマートフォンやタブレットで Termbridge を使うためのヒント

### [複数のターミナル](https://termbridge.inline0.dev/ja/docs/usage/multiple-terminals)

複数のセッションを実行して切り替える

### [開発サーバープレビュー](https://termbridge.inline0.dev/ja/docs/usage/dev-server-preview)

ターミナルと並べてViteアプリをプレビューする

### [CLI リファレンス](https://termbridge.inline0.dev/ja/docs/cli)

利用可能なフラグとオプションをすべて確認する