リモートインスタンス

デスクトップアプリは、作業サーバー、クラウドマシン、ホームラボなど、別マシン上で動く OpenChamber に SSH 経由で接続し、その UI をローカルのように画面へ表示できます。Settings → Remote Instances で設定します。

リモートインスタンスはデスクトップ専用機能です。Web または VS Code では、代わりに OpenCode サーバーの環境変数を使ってリモートサーバーに接続します。

リモートインスタンスを追加する

Settings → Remote Instances を開き、追加します。
そのマシンに接続するために普段使う SSH コマンドと、ニックネームを入力します。
そこで OpenChamber をどう実行するか選びます。
- managed — OpenChamber がリモートマシンに自分自身をインストールして起動します
- external — すでに実行中の OpenChamber に接続します
接続します。

OpenChamber は接続確認、リモートのセットアップ、サーバー起動、ポート転送の各ステップを進め、現在の段階を表示します。ready に到達すると、リモート UI がローカルに読み込まれます。

認証情報

SSH と UI のパスワードを保存するか、毎回入力するかを選べます。接続が落ちた場合、OpenChamber はどのステップで失敗したかを表示するため、修正できます。リモートアクセスを参照してください。

接続リンク

リモートマシンですでに OpenChamber が実行されている場合、デスクトップアプリを接続する最も簡単な方法はペアリングリンクです。リモートサーバーの UI で Settings → Remote Instances → このサーバーに接続 → デバイスを追加 を開いてリンクを作成し、デスクトップ側の Settings → Remote Instances → その他の OpenChamber サーバー → リンクをインポート で取り込みます。フローの詳細はデバイスを接続するを参照してください。

どこでも で作成したリンクには、直接アドレスと Private Relay 経路の両方が含まれます。デスクトップはサーバーに到達できるとき（同じネットワーク）は直接接続し、外出先ではエンドツーエンド暗号化リレーにフォールバックします。保存済みの各サーバーの横のステータスに、どちらの経路が使われているかが表示されます。

リモートマシンのターミナルからリンクを作成することもできます。

openchamber connect-url --port 3000 --server http://your-host:3000 --qr

connect-url は、そのポートで何も実行されていなければ先にサーバーを起動します。ヘッドレスサーバーには --api-only、起動時に LAN にバインドするには --lan、ブラウザアクセスを保護するには --ui-password、保存接続にラベルを付けるには --name を追加します。ローカルネットワークの外でも使えるリンクには --relay を追加します。デバイスは到達可能なときは直接接続を優先し、外出先では Private Relay にフォールバックします。リレーはインスタンスが自動的に立ち上げます。

生成されたリンクには 1 回限りのペアリングシークレットが含まれます。インポートすると、デバイスは専用のクライアントトークンを保持します。これはブラウザ UI パスワードとは別で、発行元サーバーで無効化するまでサーバー再起動後も残ります。

リモートインスタンス