Bohdan Triapitsyn
6ec1797583
- --relay links now carry both routes: direct LAN plus relay fallback, matching the UI's Anywhere pairing; devices prefer the direct route - pairing sessions created by the CLI are marked with usesRelay, and the server reconciles relay demand on a timer, so a headless instance brings the relay up on its own after connect-url --relay - warn with LAN_UNREACHABLE when the link's direct route points at loopback and other devices cannot use it - document the --relay flow and the --lan binding caveat in Connect a Device and Remote Instances across all locales
69 lines
5.8 KiB
Plaintext
69 lines
5.8 KiB
Plaintext
---
|
|
title: デバイスを接続する
|
|
description: 1 回限りの QR コードで、スマートフォン、デスクトップ、別のブラウザを OpenChamber サーバーとペアリングします。
|
|
---
|
|
|
|
# デバイスを接続する
|
|
|
|
モバイルアプリ、デスクトップアプリ、別マシンのブラウザなど、別のデバイスを 1 回限りの QR コードのスキャンで OpenChamber サーバーとペアリングできます。これがデバイス接続の推奨方法です。ポートを開ける必要も、アドレスを入力する必要もありません。
|
|
|
|
## デバイスをペアリングする
|
|
|
|
1. OpenChamber が動いているマシンで **Settings → Remote Instances → このサーバーに接続** を開き、**デバイスを追加** を押します。
|
|
2. 後で見分けられるように、デバイスに名前を付けます（例: *My iPhone*）。
|
|
3. デバイスをどこで使うか選びます。
|
|
- **このコンピュータのみ** — 同じマシン上で動くアプリ用
|
|
- **自宅ネットワークのみ** — Wi-Fi 経由で直接接続します。このネットワークの外では使えません
|
|
- **どこでも** — 自宅でも外出先でも使えます。外出先の通信は、設定不要のエンドツーエンド暗号化トンネルである [Private Relay](/private-relay/) を経由します
|
|
4. **QRコードを作成** を押します。
|
|
5. もう一方のデバイスでコードをスキャンします。
|
|
- **モバイルアプリ** — 接続画面（またはインスタンス一覧）で **QR コードをスキャン** をタップします
|
|
- **デスクトップアプリ** — 代わりに接続リンクをコピーし、**Settings → Remote Instances → その他の OpenChamber サーバー → リンクをインポート** に貼り付けます
|
|
|
|
デバイスが接続されるとダイアログは自動で閉じ、デバイスがライブステータス付きで一覧に表示されます。これでペアリング完了です。
|
|
|
|
## ペアリングが安全な理由
|
|
|
|
- **QR コードは 1 回限りです。** デバイスが使用した瞬間に無効になり、未使用のままでも自動的に期限切れになります。
|
|
- **各デバイスに専用のトークンが発行されます。** コードをスキャンしても UI パスワードが漏れることはなく、あるデバイスのトークンで別のデバイスになりすますこともできません。
|
|
- **主導権は常にあなたにあります。** ペアリング済みのデバイスはすべて名前、プラットフォーム、接続状態とともに一覧表示され、いつでも無効化できます。
|
|
- **外出先の通信はエンドツーエンドで暗号化されます。** **どこでも** を選ぶと、ネットワーク外の通信は [Private Relay](/private-relay/) を経由します。リレーは通過する内容を読むことができません。
|
|
|
|
## ペアリング済みデバイスを管理する
|
|
|
|
**Settings → Remote Instances → このサーバーに接続** には、このサーバーに到達できるすべてのデバイスが表示されます。オンラインなら緑のドットが付き、ローカルネットワーク経由かリレー経由かも分かります。
|
|
|
|
- **無効化** はデバイスを即座に切断します。気が変わったら、新しい QR コードで再ペアリングしてください。
|
|
- **無効化済みをクリア** で一覧を整理できます。
|
|
|
|
同じ物理デバイスは後で再サインインしてもエントリは 1 つのまま維持されるため、重複がたまることはありません。
|
|
|
|
## コマンドラインから接続する
|
|
|
|
サーバーがヘッドレス（UI を開いていない状態）で動いている場合は、そのマシンのターミナルから接続リンクを作成できます。
|
|
|
|
同じネットワーク上のデバイス用にはこちらです。
|
|
|
|
```bash
|
|
openchamber connect-url --port 3000 --qr
|
|
```
|
|
|
|
**どこからでも**接続するデバイス用 — ダイアログで **どこでも** を選ぶのと同等 — にはこちらです。
|
|
|
|
```bash
|
|
openchamber connect-url --relay --qr
|
|
```
|
|
|
|
`--relay` リンクには、ダイアログと同様に両方の経路が含まれます。デバイスはサーバーに到達できるときはローカルネットワーク経由で直接接続し、外出先では [Private Relay](/private-relay/) にフォールバックします。リレーは自動的に起動します。実行中のインスタンスは 1 分以内にリンクを拾い、停止中のインスタンスは次回の起動時に拾います。
|
|
|
|
> 直接経路は、サーバーが実際にネットワーク上で待ち受けている場合にのみ機能します。デフォルトでは OpenChamber はそのマシン上でのみ待ち受けます。Wi-Fi 経由で到達できるようにするには `--lan` を付けて起動してください。リンクの直接経路が他のデバイスから使えない場合、コマンドは警告（`[LAN_UNREACHABLE]`）を表示します。その場合でも `--relay` リンクは機能しますが、常にリレー経由になります。
|
|
|
|
出力されるリンクと QR コードは、設定ダイアログから作成したものとまったく同じように機能します — 1 回限りで、期限切れになり、無効化できます。
|
|
|
|
## 関連
|
|
|
|
- [Private Relay](/private-relay/) — 「どこでも」接続の仕組みと、リレーに見えるもの・見えないもの
|
|
- [モバイルアプリ](/mobile/) — iOS または Android アプリをインストールする
|
|
- [リモートインスタンス](/remote-instances/) — デスクトップアプリを SSH やリンクでサーバーに接続する
|
|
- [リモートアクセス](/troubleshooting/remote-access/) — デバイスが接続できない場合
|