BuzzbeeSCD/openchamber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: centralize device connection guides, add private relay docs

Browse Source 
- new Connect a Device page: one-time QR pairing, transport choices, device management
- new Private Relay page: E2EE guarantees, demand-driven lifecycle, relay vs tunnel
- rewrite mobile page around the native iOS/Android apps (TestFlight + APK)
- update remote-instances, security, tunnels, and remote-access troubleshooting to point at the new pairing flow
- translate everything across all 8 locales and update the sidebar
This commit is contained in:
Bohdan Triapitsyn
2026-07-10 15:30:50 +03:00
parent b3fa19fe3e
commit 7ea974d89b
64 changed files with 1452 additions and 190 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/docs/content/docs/ja/connect-devices.mdx
+56
View File
@@ -0,0 +1,56 @@
---
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
```
出力されるリンクと QR コードは、設定ダイアログから作成したものとまったく同じように機能します。
## 関連
- [Private Relay](/private-relay/) — 「どこでも」接続の仕組みと、リレーに見えるもの・見えないもの
- [モバイルアプリ](/mobile/) — iOS または Android アプリをインストールする
- [リモートインスタンス](/remote-instances/) — デスクトップアプリを SSH やリンクでサーバーに接続する
- [リモートアクセス](/troubleshooting/remote-access/) — デバイスが接続できない場合
packages/docs/content/docs/ja/mobile.mdx
+25 -13
View File
@@ -1,31 +1,43 @@
---
title: PWA とモバイルアクセス
description: OpenChamber をアプリとしてインストールし、スマートフォンから使います。
title: モバイルアプリと PWA
description: iOS または Android に OpenChamber アプリをインストールし、サーバーに接続します。
---
# PWA とモバイルアクセス
# モバイルアプリと PWA
OpenChamber の Web アプリはスマートフォンアプリのようにインストールできます（PWA）。ホーム画面に置いて全画面で使えます。[トンネル](/tunnels/) と組み合わせると、どこからでもセッションを確認できます。
OpenChamber には iPhone と Android のネイティブアプリがあり、セッションの確認、エージェントへの返信、作業の管理をスマートフォンから行えます。自宅では Wi-Fi 経由、外出先では [Private Relay](/private-relay/) 経由でどこからでも使えます。
## インストールする
## アプリをインストールする
OpenChamber はブラウザ組み込みのインストール機能を使うため、別途ダウンロードは不要です。
- **iPhone/iPad** — [TestFlight ベータ](https://testflight.apple.com/join/5ek6GU1E) に参加します
- **Android** — [最新リリース](https://github.com/openchamber/openchamber/releases/latest) から APK をダウンロードします
## サーバーに接続する
1. OpenChamber が動いているコンピューターで **Settings → Remote Instances → このサーバーに接続** を開き、**デバイスを追加** を押します。
2. **どこでも** を選び（自宅でしか使わないなら **自宅ネットワークのみ** でも可）、**QRコードを作成** を押します。
3. モバイルアプリで **QR コードをスキャン** をタップし、カメラをコードに向けます。
アプリが接続し、サーバーを記憶します。QR コードは 1 回限りで、各デバイスには無効化可能な専用トークンが発行されます。ペアリングが安全な理由は [デバイスを接続する](/connect-devices/) を参照してください。
アプリは複数のサーバーとペアリングでき、インスタンス一覧から切り替えられます。各サーバーについて、到達可能かどうか、ローカルネットワーク経由かリレー経由かが表示されます。
## PWA（ブラウザからのインストール）
アプリストアを一切使いたくない場合は、Web アプリをブラウザから直接インストールできます。
- **デスクトップブラウザ** — アドレスバーの **Install** オプションを使います
- **iPhone/iPad (Safari)** — 共有 → **ホーム画面に追加**
- **Android (Chrome)** — メニュー → **アプリをインストール** / **ホーム画面に追加**
インストール後は、ブラウザの枠がない専用ウィンドウで開きます。
## スマートフォンからアクセスする
サーバーがコンピューター上で動いている OpenChamber をスマートフォンで開くには、[トンネル](/tunnels/) を開始し、スマートフォンでリンクを開く（または QR コードをスキャンする）だけです。この操作をするときは必ず強力な [UI パスワード](/security/) を使ってください。
ネットワークの外から PWA に到達するには、[トンネル](/tunnels/) と強力な [UI パスワード](/security/) が必要です。ネイティブアプリならリレー経由でこれらを自動的に処理します。
## モバイル設定
**Settings → OpenChamber** には、モバイルやインストール済みアプリの体験を調整するいくつかのオプションがあります。インストール名、画面の向き、オンスクリーンキーボードの動作などです。
**Settings → OpenChamber** には、モバイルやインストール済みアプリの体験を調整するいくつかのオプションがあります。アプリのインストール名、画面の向き、オンスクリーンキーボードの動作などです。
## 関連
- [トンネル](/tunnels/) — 別ネットワークからインスタンスにアクセスする
- [デバイスを接続する](/connect-devices/) — ペアリング、1 回限りの QR コード、デバイス管理
- [Private Relay](/private-relay/) — 「どこでも」アクセスの仕組み
- [セキュリティ](/security/) — 公開する前に UI を保護する
packages/docs/content/docs/ja/private-relay.mdx
+44
View File
@@ -0,0 +1,44 @@
---
title: Private Relay
description: エンドツーエンド暗号化リレー経由で、どこからでも OpenChamber サーバーに到達できます。ポート開放もトンネルもセットアップも不要です。
---
# Private Relay
OpenChamber Private Relay を使うと、ペアリング済みのデバイスから、モバイル回線、カフェの Wi-Fi、別の都市など、どこからでもサーバーに到達できます。ポートを開けたり、トンネルを設定したり、マシンをインターネットに公開したりする必要はありません。リレーは自己管理型です。[デバイスを接続する](/connect-devices/) で **どこでも** を選んでデバイスをペアリングするだけで使えます。
## 仕組み
サーバーは OpenChamber のリレーインフラへアウトバウンド接続を張り、維持し続けます。デバイスが自宅ネットワークの外にあるときは、デバイスもリレーに接続し、リレーが両者の間で暗号化された通信を中継します。あなたのマシン上でインターネットからの着信接続を待ち受けるものは何もありません。
直接接続が可能なとき — 自宅に戻って同じ Wi-Fi にいるとき — は、デバイスは直接接続を優先し、リレーを完全にスキップします。
## リレーに見えるもの・見えないもの
リレーは中間者ではなく、中身の見えない配達人です。
- **エンドツーエンドで暗号化されます。** 暗号化キーはデバイスとサーバーが直接合意します。リレーはキーを持たない封印済みの通信を転送するだけで、コード、プロンプト、パスワードを読むことはできません。
- **接続できるのはあなたのデバイスだけです。** デバイスは、[1 回限りのペアリング](/connect-devices/) を通じて*あなたの*サーバーが発行したトークンを持っている必要があります。リレー経由であなたのサーバーを発見したり、あなたが作成したトークンなしで接続したりすることは誰にもできません。トークンはいつでも無効化できます。
- **ペアリングリンクは 1 回限りです。** ペアリング用 QR コードは 1 回だけ機能し、未使用なら期限切れになるため、古いリンクが漏れても無価値です。
- **オプトインするまで何も共有されません。** リレーは、あなたが有効にするかリレー経由でデバイスをペアリングするまでオフのままです。いつでも無効にでき、その場合リレー経由で接続中のデバイスは即座に切断されます。
## いつ動くのか
リレーは自分でライフサイクルを管理します。オン / オフのスイッチを覚えておく必要はありません。
- **必要になると起動します。** **どこでも** のペアリングを作成するとリレーがオンになり、ペアリング済みのデバイスがリレーを必要としている限り、再起動後も自動的に復帰します。
- **自動で停止します。** リレーを使うデバイスや保留中のペアリングがなくなると — たとえば最後のリレー経由デバイスを無効化した後 — 自動的にシャットダウンします。
**Settings → Remote Instances → OpenChamber Relay** には、ライブステータス（接続済み、再接続中など）と、現在リレー経由で接続中のデバイス数が表示されます。そこで **無効にする** を押せば、リレー経由のアクセスを即座に遮断することもできます。ローカルネットワーク上のデバイスには影響しません。
## リレーとトンネル、どちらを使う?
- 自分のペアリング済みデバイスから自分のサーバーに到達するには **リレー** を使います。セットアップ不要で、何も公開されません。
- 通常の **公開 URL** が必要なときは [トンネル](/tunnels/) を使います。たとえば、ペアリングできないマシンの普通のブラウザで OpenChamber を開きたい場合や、[UI パスワード](/security/) の背後でアクセスを共有したい場合です。
## 関連
- [デバイスを接続する](/connect-devices/) — 1 回限りの QR コードでデバイスをペアリングする
- [モバイルアプリ](/mobile/) — iOS または Android アプリをインストールする
- [セキュリティ](/security/) — パスワード、パスキー、公開時の基本
- [リモートアクセス](/troubleshooting/remote-access/) — 接続が完了しない場合
packages/docs/content/docs/ja/remote-instances.mdx
+9 -3
View File
@@ -24,9 +24,13 @@ OpenChamber は接続確認、リモートのセットアップ、サーバー
SSH と UI のパスワードを保存するか、毎回入力するかを選べます。接続が落ちた場合、OpenChamber はどのステップで失敗したかを表示するため、修正できます。[リモートアクセス](/troubleshooting/remote-access/) を参照してください。
## 直接接続リンク
## 接続リンク
リモートマシンですでに OpenChamber が実行されている場合は、そこで接続リンクを作成し、**Settings → Remote Instances → Server links** でインポートします。
リモートマシンですでに 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
@@ -34,9 +38,11 @@ openchamber connect-url --port 3000 --server http://your-host:3000 --qr
`connect-url` は、そのポートで何も実行されていなければ先にサーバーを起動します。ヘッドレスサーバーには `--api-only`、起動時に LAN にバインドするには `--lan`、ブラウザアクセスを保護するには `--ui-password`、保存接続にラベルを付けるには `--name` を追加します。
生成されたリンクには OpenChamber アプリ用のクライアントトークンが含まれます。このトークンはブラウザ UI パスワードとは別で、取り消すか削除するまでサーバー再起動後も残ります。
生成されたリンクには 1 回限りのペアリングシークレットが含まれます。インポートすると、デバイスは専用のクライアントトークンを保持します。これはブラウザ UI パスワードとは別で、発行元サーバーで無効化するまでサーバー再起動後も残ります。
## 関連
- [デバイスを接続する](/connect-devices/) — ペアリングリンク、QR コード、デバイス管理
- [Private Relay](/private-relay/) — 「どこでも」接続の仕組み
- [OpenCode サーバー](/opencode-server/) — Web または VS Code でリモートサーバーに接続する
- [リモートアクセス](/troubleshooting/remote-access/) — 接続が完了しない場合
packages/docs/content/docs/ja/security.mdx
+9 -2
View File
@@ -25,13 +25,20 @@ openchamber --ui-password be-creative-here
パスキーは現在のパスワードに紐づきます。パスワードを変更または削除すると、保存済みパスキーは消去され、再追加が必要になります。
## デバイストークン
[デバイスを接続する](/connect-devices/) でペアリングしたデバイスは、UI パスワードではなく、デバイスごとの専用トークンで認証します。ペアリングリンクは 1 回限りで、未使用なら期限切れになります。ペアリング済みのデバイスはすべて **Settings → Remote Instances → このサーバーに接続** に一覧表示され、いつでも無効化できます。外出先からの接続は [Private Relay](/private-relay/) を経由します。リレーはエンドツーエンドで暗号化されており、通信内容を読むことはできません。
## 公開する前に
- デフォルトでは、OpenChamber はあなたのマシン上（`127.0.0.1`）でのみ待ち受けます。より広く待ち受けるには明示的な変更が必要で、その前にパスワードを設定するべきです。
- インターネットにポートを開けるより、[トンネル](/tunnels/) または VPN のようなプライベートネットワークを推奨します。
- 自分のデバイスなら、[Private Relay](/private-relay/) を使った [ペアリング](/connect-devices/) を推奨します。何も公開されません。
- 公開 URL が必要な場合は、インターネットにポートを開けるより、[トンネル](/tunnels/) または VPN のようなプライベートネットワークを推奨します。
- OpenChamber を自分の HTTPS サーバーの背後に置く場合は、[リバースプロキシ](/reverse-proxy/) を参照してください。
## 関連
- [トンネル](/tunnels/) — インスタンスへリモートアクセスする推奨方法
- [デバイスを接続する](/connect-devices/) — 1 回限りのペアリングとデバイスごとのトークン
- [Private Relay](/private-relay/) — どこからでも使えるエンドツーエンド暗号化アクセス
- [トンネル](/tunnels/) — 必要なときに公開 URL を用意する
- [リバースプロキシ](/reverse-proxy/) — OpenChamber を自分のサーバー背後で実行する
packages/docs/content/docs/ja/troubleshooting/remote-access.mdx
+10 -1
View File
@@ -12,6 +12,15 @@ description: トンネル、リモートインスタンス、別デバイスか
- 同じコンピューターで先に `http://localhost:3000` を開きます。失敗する場合はリモートの問題ではありません。[OpenCode 接続](/troubleshooting/opencode-connection/) を参照してください
- `openchamber status` でサーバーが実行中であることを確認します
## ペアリング済みデバイスが接続しない
- QR コード / ペアリングリンクは **1 回限り** です。すでにスキャン済み（または期限切れ）の場合は、**デバイスを追加** から新しいものを作成してください
- デバイスを **自宅ネットワークのみ** でペアリングした場合、そのネットワークの外からは接続できません。**どこでも** で再ペアリングしてください
- **どこでも** のペアリングでは、サーバー側の **Settings → Remote Instances → OpenChamber Relay** を確認してください。**接続済み** と表示されているはずです。そうでなければ、いったん無効にしてから再度有効にします
- デバイスを **無効化** した場合、そのトークンは完全に失効しています。新しい QR コードで再ペアリングしてください
これらの接続の仕組みは [デバイスを接続する](/connect-devices/) と [Private Relay](/private-relay/) を参照してください。
## トンネルリンクが動かない
- `openchamber tunnel status --all` を実行します
@@ -34,5 +43,5 @@ OpenChamber をリバースプロキシの背後に置いていて、表示が
## 関連
- [トンネル](/tunnels/) · [リモートインスタンス](/remote-instances/) · [リバースプロキシ](/reverse-proxy/)
- [デバイスを接続する](/connect-devices/) · [Private Relay](/private-relay/) · [トンネル](/tunnels/) · [リモートインスタンス](/remote-instances/) · [リバースプロキシ](/reverse-proxy/)
- [セキュリティ](/security/) — 公開する前に UI を保護する
packages/docs/content/docs/ja/tunnels.mdx
+5 -2
View File
@@ -5,7 +5,9 @@ description: リモートおよびモバイルアクセス向けに OpenChamber
# トンネル
トンネルは OpenChamber への公開リンクです。スマートフォンや別ネットワークからアクセスできます。実行中のインスタンスに対して作成するには `openchamber tunnel` を使います。
トンネルは OpenChamber への公開リンクです。別ネットワークの普通のブラウザからアクセスできます。実行中のインスタンスに対して作成するには `openchamber tunnel` を使います。
> **自分のデバイス**（モバイルアプリ、別のデスクトップ）の接続には、通常トンネルは不要です。代わりに [ペアリング](/connect-devices/) して、エンドツーエンド暗号化の [Private Relay](/private-relay/) にセットアップ不要で外出先アクセスを任せましょう。
## 前提条件
@@ -111,7 +113,8 @@ openchamber tunnel stop --port 3000
## 関連
- [デバイスを接続する](/connect-devices/) — 公開 URL なしで自分のデバイスをペアリングする
- [セキュリティ](/security/) — 公開する前に UI を保護する
- [デスクトップトンネル](/desktop-tunnels/) — CLI 起動なしでデスクトップアプリからトンネルを設定する
- [PWA とモバイル](/mobile/) — スマートフォンから OpenChamber にアクセスする
- [モバイルアプリと PWA](/mobile/) — スマートフォンから OpenChamber にアクセスする
- [トラブルシューティング](/troubleshooting/) — トンネルリンクが動かない場合