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
49 lines
4.4 KiB
Plaintext
49 lines
4.4 KiB
Plaintext
---
|
|
title: リモートインスタンス
|
|
description: デスクトップアプリを SSH 経由で別マシン上の OpenChamber に接続します。
|
|
---
|
|
|
|
# リモートインスタンス
|
|
|
|
デスクトップアプリは、作業サーバー、クラウドマシン、ホームラボなど、別マシン上で動く OpenChamber に SSH 経由で接続し、その UI をローカルのように画面へ表示できます。**Settings → Remote Instances** で設定します。
|
|
|
|
> リモートインスタンスは**デスクトップ専用**機能です。Web または VS Code では、代わりに [OpenCode サーバー](/opencode-server/) の環境変数を使ってリモートサーバーに接続します。
|
|
|
|
## リモートインスタンスを追加する
|
|
|
|
1. **Settings → Remote Instances** を開き、追加します。
|
|
2. そのマシンに接続するために普段使う SSH コマンドと、ニックネームを入力します。
|
|
3. そこで OpenChamber をどう実行するか選びます。
|
|
- **managed** — OpenChamber がリモートマシンに自分自身をインストールして起動します
|
|
- **external** — すでに実行中の OpenChamber に接続します
|
|
4. 接続します。
|
|
|
|
OpenChamber は接続確認、リモートのセットアップ、サーバー起動、ポート転送の各ステップを進め、現在の段階を表示します。**ready** に到達すると、リモート UI がローカルに読み込まれます。
|
|
|
|
## 認証情報
|
|
|
|
SSH と UI のパスワードを保存するか、毎回入力するかを選べます。接続が落ちた場合、OpenChamber はどのステップで失敗したかを表示するため、修正できます。[リモートアクセス](/troubleshooting/remote-access/) を参照してください。
|
|
|
|
## 接続リンク
|
|
|
|
リモートマシンですでに OpenChamber が実行されている場合、デスクトップアプリを接続する最も簡単な方法はペアリングリンクです。リモートサーバーの UI で **Settings → Remote Instances → このサーバーに接続 → デバイスを追加** を開いてリンクを作成し、デスクトップ側の **Settings → Remote Instances → その他の OpenChamber サーバー → リンクをインポート** で取り込みます。フローの詳細は [デバイスを接続する](/connect-devices/) を参照してください。
|
|
|
|
**どこでも** で作成したリンクには、直接アドレスと [Private Relay](/private-relay/) 経路の両方が含まれます。デスクトップはサーバーに到達できるとき（同じネットワーク）は直接接続し、外出先ではエンドツーエンド暗号化リレーにフォールバックします。保存済みの各サーバーの横のステータスに、どちらの経路が使われているかが表示されます。
|
|
|
|
リモートマシンのターミナルからリンクを作成することもできます。
|
|
|
|
```bash
|
|
openchamber connect-url --port 3000 --server http://your-host:3000 --qr
|
|
```
|
|
|
|
`connect-url` は、そのポートで何も実行されていなければ先にサーバーを起動します。ヘッドレスサーバーには `--api-only`、起動時に LAN にバインドするには `--lan`、ブラウザアクセスを保護するには `--ui-password`、保存接続にラベルを付けるには `--name` を追加します。ローカルネットワークの外でも使えるリンクには `--relay` を追加します。デバイスは到達可能なときは直接接続を優先し、外出先では [Private Relay](/private-relay/) にフォールバックします。リレーはインスタンスが自動的に立ち上げます。
|
|
|
|
生成されたリンクには 1 回限りのペアリングシークレットが含まれます。インポートすると、デバイスは専用のクライアントトークンを保持します。これはブラウザ UI パスワードとは別で、発行元サーバーで無効化するまでサーバー再起動後も残ります。
|
|
|
|
## 関連
|
|
|
|
- [デバイスを接続する](/connect-devices/) — ペアリングリンク、QR コード、デバイス管理
|
|
- [Private Relay](/private-relay/) — 「どこでも」接続の仕組み
|
|
- [OpenCode サーバー](/opencode-server/) — Web または VS Code でリモートサーバーに接続する
|
|
- [リモートアクセス](/troubleshooting/remote-access/) — 接続が完了しない場合
|