UU Remote 経由のブラウザ
NetEase のリモート操作アプリ UU Remote のポートマッピングを通して、別のコンピューターのブラウザで Octoboard を開きます。SSH もリモートデスクトップも使いません。ホストとは Octoboard が動いているコンピューターのことです。SSH ログイン(macOS ではリモートログイン)はオフのままで構わず、リモートデスクトップのセッションも必要ありません。UU Remote の画面は中国語なので、このガイドでは日本語の名前に、画面に出る中国語の表示を添えています。
このガイドでは、自分のコンピューターのブラウザで Octoboard を開きます。リモートデスクトップより鮮明で反応がよい方法ですが、手順は多くなります。遅れやぼやけが気にならないなら、UU Remote のリモートデスクトップでホストを直接操作するだけで済みます。
この方法が自分に合っているかわからない場合は、接続方法を選ぶをご覧ください。
自分のコンピューターのブラウザ → 自分のコンピューターの 127.0.0.1 ⟷ UU Remote ⟷ ホストの 127.0.0.1 → Octoboard
はじめての方へ
- 127.0.0.1(ループバック): 常に「このコンピューター自身」を指すアドレスです。
- ポート: コンピューター上の 1 つのプログラムを選ぶための番号で、部屋番号のようなものです。
127.0.0.1:3369は、このコンピューターのポート 3369 を指します。 - ポートマッピング(端口映射): ホストのポートを、自分のコンピューターのポートとして見せる UU Remote の機能です。
- socat: 接続をある場所から別の場所へ受け渡す、小さな無料のプログラムです。Mac のホストでは、中継役として必要です。
- ターミナル: コマンドを入力するウィンドウです。macOS ではターミナル、Windows では PowerShell を使います。
UU Remote のポートマッピングを使うと、ホストの Octoboard が、自分のコンピューターの 127.0.0.1 にあるように見えます。Octoboard がブラウザを受け付けるのは、このアドレスだけです。
- 両方のコンピューターが Mac または Windows PC であること。UU Remote には Linux 向けのポートマッピングがありません。Linux サーバーには、代わりに Tailscale か SSH でつないでください。
- 両方に UU Remote が入っていて、同じアカウントでサインインしていること。バージョンは、Windows では 4.21.0 以降、macOS では 4.32.0 以降です。ポートマッピングは TCP だけに対応していて、Octoboard に必要なのはそれだけです。執筆時点では、UU Remote はポートマッピングを無料機能の 1 つとして挙げています。気になる場合は、現在のプランを確認してください。
- ブラウザを使うコンピューターの UU Remote で、ホストが「マイデバイス(我的设备)」に表示されていること。
- Mac のホストには Homebrew も必要です。下の手順で socat をインストールするために使います。
ホストでの操作
Section titled “ホストでの操作”-
ブラウザのアドレスを手に入れます。このアドレスには、ブラウザをサインインさせるキーが含まれています。
Octoboard で 設定 › リモートアクセス を開き、リモートアクセスを許可をオンにして、許可を選んで確定します。スイッチの下に 2 つのタブが現れます。ブラウザタブの 手順 2: ブラウザのアドレス で、アドレスをコピーを選びます。
アドレスは、自分だけが読める方法でもう一方のコンピューターに渡してください。たとえば自分宛てのメモに貼り付けます。アドレスはパスワードと同じ働きをします。
手順 1: SSH フォワードは飛ばします。アプリの設定には SSH の話が何か所か出てきますが、このガイドで使うのはブラウザのアドレスだけなので、気にしなくて大丈夫です。
Octoboard は起動したままにしてください。終了すると、リモートアクセスも止まります。
Octoboard で 設定 › リモートアクセス を開き、リモートアクセスを許可をオンにして、許可を選んで確定します。スイッチの下に 2 つのタブが現れます。ブラウザタブの 手順 2: ブラウザのアドレス で、アドレスをコピーを選びます。あわせて、ブラウザ用ポートの下に表示されている番号を控えておきます。
アドレスは、自分だけが読める方法でもう一方のコンピューターに渡してください。たとえば自分宛てのメモに貼り付けます。アドレスはパスワードと同じ働きをします。
手順 1: SSH フォワードは飛ばします。アプリの設定には SSH の話が何か所か出てきますが、このガイドで使うのはブラウザのアドレスだけなので、気にしなくて大丈夫です。
Octoboard は起動したままにしてください。終了すると、リモートアクセスも止まります。
-
ホストの
127.0.0.1に、Octoboard につながるポートを用意します。このポートが、以降の手順でいうホストのポートです。Mac は、UU Remote がマッピングできない形でブラウザ用の入口を提供しているため、中継として socat が必要です。ターミナルでインストールします。
Terminal window brew install socat続けて次のコマンドを実行し、ウィンドウは開いたままにします。待ち受けるのは
127.0.0.1:3370だけです。Terminal window socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"ホストのポートは
3370です。実行するものはありません。Octoboard 自身が、ブラウザ用ポートで
127.0.0.1だけを待ち受けています。ホストのポートは、ブラウザタブのブラウザ用ポートです(変更していなければ 3369)。
ブラウザを使うコンピューターでの操作
Section titled “ブラウザを使うコンピューターでの操作”-
UU Remote で、「マイデバイス(我的设备)」からホストを開き、そのカードの「その他(更多)」、続けて「ポートマッピング(端口映射)」を選んで、マッピングを追加します。
項目 値 名前(名称) Octoboard ローカルポート(本地端口) 3369ターゲットアドレス(目标地址) 127.0.0.1ターゲットポート(目标端口) ホストのポート 保存して有効にし、接続済みと表示されるまで待ちます。このコンピューターで 3369 がすでに使われている場合は、別のローカルポートを選び、ブラウザのアドレスのポートも同じように変えてください。
-
このコンピューターだけがマッピングを使えることを確認します。このコンピューターでターミナル(macOS)または PowerShell(Windows)を開き、次のコマンドを実行します。
Terminal window lsof -nP -iTCP:3369 -sTCP:LISTEN127.0.0.1:3369とLISTENを含む行が表示されるはずです。Terminal window netstat -ano | findstr :3369TCPで始まり、次に127.0.0.1:3369があり、LISTENINGと数字で終わる行が表示されるはずです。代わりに
*:3369や0.0.0.0:3369と表示された場合は、マッピングを削除してください。ネットワーク上のほかのデバイスが Octoboard に届いてしまいます。 -
ホストでコピーしたブラウザのアドレスを開きます。
http://127.0.0.1:3369/で始まるアドレスです。
サインインを求められずに、ブラウザのタブで Octoboard が開けば成功です。
うまくいかないとき
Section titled “うまくいかないとき”- マッピングは接続済みと表示されるのに、ページが開かない: Mac のホストでは、socat のウィンドウが閉じられたか、コマンドが止まっています。または、リモートアクセスを許可がオフになっているか、ホストで Octoboard が動いていません。
- マッピングが保存できない、または接続できない: このコンピューターで、ローカルポートがすでに使われている可能性があります。別のポートを選び、ブラウザのアドレスのポートも同じように変えてください。
- ページが拒否される、または空白になる:
127.0.0.1のアドレスで開いたことを確認してください。
使い終わったら止める
Section titled “使い終わったら止める”- ブラウザを使ったコンピューターで: UU Remote のポートマッピングの画面でマッピングをオフにするか、削除します。画面を閉じたり、接続を切ったりしても止まります。
- Mac のホストで: Ctrl+C で socat を止めます。
- ホストでは、使わなくなったらリモートアクセスを許可をオフにします。これでブラウザの入口が閉じ、そのキーで開いているページはすべて切断されます。
- アドレスが漏れたかもしれないときは、ブラウザタブのキーを更新で新しいキーに替えます。古いアドレスで開いているページは切断されます。
セキュリティ
Section titled “セキュリティ”- アドレスはパスワードと同じ: アドレスに含まれるキーで、ホスト上の Octoboard をフルコントロールでき、任意のコマンドも実行できます。キーは更新するまで有効です。ブラウザの履歴やブックマークに残り、ブラウザの同期がオンなら、ほかのデバイスにも同期されます。
- 誰が届くか: ホストのポートに届いて、キーを持っている人なら誰でも届きます。ホストでは
127.0.0.1だけを待ち受けます。ただし、自分の UU Remote アカウントを使ってホストへのポートをマッピングできる人も届いてしまうので、そのアカウントを安全に保ってください。 - 他の人がサインインしないコンピューターでだけ使う: ホストや自分のコンピューターにある別のユーザーアカウントは、これらの
127.0.0.1のポートに接続できます。マッピングや socat が動いていない間は、そのポートを奪って、ブラウザが再接続したときにキーを受け取ってしまうこともあります。SSH で接続する方法では、Mac や Linux のホストにこの弱点はなく、デスクトップアプリを使う場合は自分のコンピューターにもありません。ただしブラウザを使う場合は、ブラウジングに使うコンピューターにこの弱点が残ります。そこでも SSH のフォワードが127.0.0.1のポートで待ち受けるためです。