コンテンツにスキップ
Octoboard ドキュメント

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 をインストールするために使います。
  1. ブラウザのアドレスを手に入れます。このアドレスには、ブラウザをサインインさせるキーが含まれています。

    Octoboard で 設定 › リモートアクセス を開き、リモートアクセスを許可をオンにして、許可を選んで確定します。スイッチの下に 2 つのタブが現れます。ブラウザタブの 手順 2: ブラウザのアドレス で、アドレスをコピーを選びます。

    アドレスは、自分だけが読める方法でもう一方のコンピューターに渡してください。たとえば自分宛てのメモに貼り付けます。アドレスはパスワードと同じ働きをします。

    手順 1: SSH フォワードは飛ばします。アプリの設定には SSH の話が何か所か出てきますが、このガイドで使うのはブラウザのアドレスだけなので、気にしなくて大丈夫です。

    Octoboard は起動したままにしてください。終了すると、リモートアクセスも止まります。

  2. ホストの 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 です。

ブラウザを使うコンピューターでの操作

Section titled “ブラウザを使うコンピューターでの操作”
  1. UU Remote で、「マイデバイス(我的设备)」からホストを開き、そのカードの「その他(更多)」、続けて「ポートマッピング(端口映射)」を選んで、マッピングを追加します。

    項目値
    名前(名称)Octoboard
    ローカルポート(本地端口)3369
    ターゲットアドレス(目标地址)127.0.0.1
    ターゲットポート(目标端口)ホストのポート

    保存して有効にし、接続済みと表示されるまで待ちます。このコンピューターで 3369 がすでに使われている場合は、別のローカルポートを選び、ブラウザのアドレスのポートも同じように変えてください。

  2. このコンピューターだけがマッピングを使えることを確認します。このコンピューターでターミナル(macOS)または PowerShell(Windows)を開き、次のコマンドを実行します。

    Terminal window
    lsof -nP -iTCP:3369 -sTCP:LISTEN

    127.0.0.1:3369 と LISTEN を含む行が表示されるはずです。

    代わりに *:3369 や 0.0.0.0:3369 と表示された場合は、マッピングを削除してください。ネットワーク上のほかのデバイスが Octoboard に届いてしまいます。

  3. ホストでコピーしたブラウザのアドレスを開きます。http://127.0.0.1:3369/ で始まるアドレスです。

サインインを求められずに、ブラウザのタブで Octoboard が開けば成功です。

  • マッピングは接続済みと表示されるのに、ページが開かない: Mac のホストでは、socat のウィンドウが閉じられたか、コマンドが止まっています。または、リモートアクセスを許可がオフになっているか、ホストで Octoboard が動いていません。
  • マッピングが保存できない、または接続できない: このコンピューターで、ローカルポートがすでに使われている可能性があります。別のポートを選び、ブラウザのアドレスのポートも同じように変えてください。
  • ページが拒否される、または空白になる: 127.0.0.1 のアドレスで開いたことを確認してください。
  • ブラウザを使ったコンピューターで: UU Remote のポートマッピングの画面でマッピングをオフにするか、削除します。画面を閉じたり、接続を切ったりしても止まります。
  • Mac のホストで: Ctrl+C で socat を止めます。
  • ホストでは、使わなくなったらリモートアクセスを許可をオフにします。これでブラウザの入口が閉じ、そのキーで開いているページはすべて切断されます。
  • アドレスが漏れたかもしれないときは、ブラウザタブのキーを更新で新しいキーに替えます。古いアドレスで開いているページは切断されます。
  • アドレスはパスワードと同じ: アドレスに含まれるキーで、ホスト上の Octoboard をフルコントロールでき、任意のコマンドも実行できます。キーは更新するまで有効です。ブラウザの履歴やブックマークに残り、ブラウザの同期がオンなら、ほかのデバイスにも同期されます。
  • 誰が届くか: ホストのポートに届いて、キーを持っている人なら誰でも届きます。ホストでは 127.0.0.1 だけを待ち受けます。ただし、自分の UU Remote アカウントを使ってホストへのポートをマッピングできる人も届いてしまうので、そのアカウントを安全に保ってください。
  • 他の人がサインインしないコンピューターでだけ使う: ホストや自分のコンピューターにある別のユーザーアカウントは、これらの 127.0.0.1 のポートに接続できます。マッピングや socat が動いていない間は、そのポートを奪って、ブラウザが再接続したときにキーを受け取ってしまうこともあります。SSH で接続する方法では、Mac や Linux のホストにこの弱点はなく、デスクトップアプリを使う場合は自分のコンピューターにもありません。ただしブラウザを使う場合は、ブラウジングに使うコンピューターにこの弱点が残ります。そこでも SSH のフォワードが 127.0.0.1 のポートで待ち受けるためです。