デバイス間接続：パブリックIP不要、ポートマッピングの手間なし、いつでもどこでも安全にデバイスに直接接続

こんな経験はありませんか？

会社の開発マシンでClaude Codeにタスクを実行させている最中に、外出先からスマホや自宅のPCで確認しようとしたら、まったく接続できなかった。そのマシンにはパブリックIPがなく、ルーターの内側に隠れている。ポートマッピングを開こうにもセキュリティが心配だし、ルーターの設定が面倒。frpや花生殻（DDNS）のような内網穿透（NAT越え）ツールを使うにしても、設定が多く、サーバーをレンタルする必要がある。

デバイス間接続（Connected Devices） はこの問題を解決します。PandaNpc デスクトップクライアントで「デバイス間接続を有効にする」をクリックするだけで、そのデバイスがあなた専用の暗号化仮想ネットワークに参加します。その後、あなたのすべてのデバイス間に固定のプライベートIP（例：100.64.0.2）が割り当てられ、それぞれがどこにいても、パブリックIPがなくても、同じローカルネットワークに接続しているかのように相互に直接接続できます。

一、なぜデバイス間接続が必要か

• 🏠 外出先から自宅/会社のマシンにアクセス：スマホやノートPCは外部ネットワーク、自宅の開発マシンは内部ネットワーク。Claude Code、SSH、内部サービスの確認などに接続したい——デバイス間接続で相互に到達可能になります。
• 🔌 ポートマッピングとパブリック露出から解放：ルーターでポートを開けたり、サービスをパブリックネットワークに露出する必要がなく、攻撃対象がゼロになります。
• 🧩 サーバー不要、複雑な設定不要：frpのようにパブリックIPを持つ中継サーバーをレンタルしたり、転送ルールを書いたりする必要はありません。クリックひとつで固定のプライベートIPを取得。
• 🔒 すべてのホップで暗号化：デバイス間のトラフィックはエンドツーエンドで暗号化され、中間者には内容が見えません。

二、どのように実現しているか

デバイス間接続の基盤は独自のWireGuard仮想ネットワークです（Tailscaleと同じ技術）：

• 各デバイスは参加時にコントロールプレーンから安定したプライベートIP（100.64.x.x セグメント）を割り当てられ、このIPはデバイスに固定され、ネットワーク環境が変わっても変わりません。
• デバイス間では優先的に直接接続：NAT越え（NAT traversal）により2つのマシン間にポイントツーポイントの暗号化トンネルを確立し、データは第三者を経由しません。
• NAT越えが失敗する一部のネットワーク環境（対称NATなど）では、自動的にリレー経由にフォールバックし、常に接続可能を保証します。
• 全体はWireGuardによるエンドツーエンド暗号化。コントロールプレーンは「誰が誰に接続できるか」の調整のみを行い、あなたのデータは見えません。

一言で言えば：あなたは自分だけの、暗号化され、いつでもどこでも到達可能なプライベートネットワークを手に入れます。

三、有効にする方法：デスクトップクライアントでワンクリック

PandaNpc デスクトップクライアント（Windows / macOS / Linux）がインストールされたマシンでは、次の1ステップで完了です。

クライアントを開く → 設定（Settings）→ デバイス間接続（Connected Devices）→ 「デバイス間接続を有効にする」（Enable Connected Devices）をクリック。

クリック後、クライアントが自動的にすべてを実行します：バックグラウンドのネットワークコンポーネントをダウンロードしてインストール、本機をあなたのアカウントに登録、ネットワークに参加。初回有効時にはシステム管理者の承認を求められます（バックグラウンドネットワークサービスのインストールに必要）。以降は完全自動で、通常数秒で完了します。

ネットワーク参加成功後、ステータスカードに Joined（参加済み） と表示され、本機の専用プライベートIPが表示されます——クリックしてコピーし、他のデバイスから接続する際に使用できます。

ヒント：

• ログイン後自動ペアリング：クライアント初回起動時に、バックグラウンドでコンポーネントがサイレントインストールされ、アカウントにログインすると自動的にペアリングされてネットワークに参加します。多くの場合、手動でスイッチを操作する必要はありません。
• 使わなくなったらいつでも削除：同じページで「デバイス間接続を削除」（Remove Connected Devices）をクリックすると、本機のネットワークサービスを停止できます（インストールは保持され、再開する際は瞬時に完了、再ダウンロード不要）。

四、すべてのデバイスを管理

ネットワーク参加後、設定ページ下部（またはブラウザで pandanpc.com/devices を開く）にデバイス管理パネルが表示されます。両方の内容は完全に同一です。

ここでできること：

• 🟢 オンライン状態を確認：緑の点はデバイスがオンラインであることを示し、どのデバイスが利用可能か一目でわかります。
• 📋 プライベートIPをコピー：各デバイスの 100.64.x.x IPをクリックしてコピーし、SSHやサービスアクセスに直接使用。
• 💻 システムタイプを識別：Windows / macOS / Linux のアイコンが一目瞭然。
• ✏️ 名前変更：デバイスに分かりやすい名前を付けられます（例：「Office Windows PC」「Home Server」）。
• 🗑️ 失効：不要になったデバイスはワンクリックで失効させると、即座に切断され、以降接続できなくなります。

五、サーバーとヘッドレスデバイス：1コマンドで自動参加

自宅のNAS、クラウドサーバー、開発コンテナなど、GUIがないマシンでは**認証キー（Auth Key）**を使用して参加します。今ではたった1コマンドで完了します。

最初のステップ：デバイス管理ページの Auth Keys セクションで「New key」をクリックしてキーを生成します。

生成時に設定可能：

• Reusable（再利用可能）：1つのキーで複数のマシンに使用可能。チェックしない場合は一回限りのキーで、使用後は無効。
• Expires in（有効期限）：空欄の場合は無期限、または数日後に自動失効するように設定可能。
• Description（メモ）：このキーをどのマシンに使用するかメモできます。

2番目のステップ：生成後、ポップアップにキーを含むワンコマンドインストールコマンドが直接表示されます。コピーボタンをクリックして取得します（キーの平文はこのときのみ表示）。

3番目のステップ：対象マシンで貼り付けて実行します。

macOS / Linux：

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxxxxxx

Windows（管理者PowerShell）：

$env:PANDANET_KEY="pnkey-xxxxxxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

この1コマンドで以下のすべてが自動完了します：

1. pandapaw（内蔵AIエンジン pandacode を含む）をインストール；
2. このマシンを自動的にあなたのアカウントにペアリング——Claude Codeの接続リストに表示され、他のデバイスからすぐにリモートでAIセッションを実行可能；
3. ネットワークシステムサービスをインストールし自動でネットワーク参加、完了時に本機が取得したプライベートIPを表示。

すべて手動操作不要、インストール完了後すぐに使用可能。

その他の方法（予備）：

• 既に pandapaw がインストールされているマシンをネットワークに追加：pandanet up --authkey=pnkey-xxxxxxxx；
• 常駐サービスとして設定：pandanetd.yaml の auth_key フィールドにキーを書き込み、pandanet install を実行；
• キーがない場合：pandanet up を直接実行すると、承認リンクが表示されるので、ブラウザでPandaNpcアカウントにログインして「承認」をクリックすると、そのデバイスがネットワークに参加します。

六、設定項目の説明

デバイス間接続に関する設定は、すべて 設定 → デバイス間接続 のページにまとめられています。

七、典型的な使用例

固定のプライベートIPを取得すれば、次のことが可能です。

• デバイス上のClaude Codeにリモートアクセス：参加したマシンは自動的にアカウントのClaude Code接続として登録されます（内蔵のpandacodeエンジンがそのまま使え、CLIを別途インストールする必要はありません）。開発マシンで実行中のセッションを、別のデバイスから再接続して操作を続けられます。人が離れてもマシンは停止しません。
• どこからでもSSH：ssh user@100.64.0.2 で、対象マシンが会社でも自宅でも関係ありません。
• 内部サービスへのアクセス：あるマシンで動作しているWebサービス、データベース、NASにプライベートIPで直接アクセス。パブリックネットワークに露出する必要はありません。
• リモートデスクトップ制御との連携：「本機のリモート操作を許可」を有効にすると、AIセッションがそのマシンのデスクトップをリモート操作できるようになります。

八、セキュリティについて

• エンドツーエンド暗号化：デバイス間のトラフィックはWireGuardで暗号化され、コントロールプレーンは内容を見ることができません。
• パブリック露出ゼロ：パブリックポートを一切開かず、サービスはあなたのプライベートネットワーク内でのみ到達可能です。
• 自分のデバイスのみ接続：ネットワークはアカウントごとに分離され、認証キーはあなたのアカウントに属します。他人のデバイスはあなたのネットワークに入れません。ブラウザで承認する際も、デバイス名の確認を促されます。
• いつでも取り消し可能：任意のデバイスやキーを管理ページでワンクリックで失効させ、即座に無効化できます。
• 既存のツールと共存：本機にTailscaleなどの類似ツールがインストールされていても問題なく、互いに干渉しません。

まとめ

デバイス間接続は、「外出先から自分のマシンにアクセスする」という面倒な作業を、クライアント内のワンクリックに簡略化します。パブリックIP不要、ポートマッピング不要、中継サーバーのレンタル不要で、エンドツーエンド暗号化された、いつでもどこでも到達可能なプライベートネットワークを手に入れられます。デスクトップデバイスはワンクリックで有効化、サーバーはキー付きのコマンドをコピーするだけで自動ペアリングと参加が完了し、すべてのデバイスを1つのページで統合管理できます。Claude Codeのリモートアクセスやリモートデスクトップ制御と組み合わせれば、開発マシンは「人が離れてもマシンは停止せず、どこからでも接続して続行できる」を実現します。