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

Tailscale 経由のブラウザ

自分の Tailscale ネットワークを通して、別のコンピューターのブラウザで Octoboard を開きます。SSH もリモートデスクトップも使いません。ホストとは Octoboard が動いているコンピューターのことで、Mac、Windows PC、または octoboardd を動かしている Linux サーバーです。SSH ログイン(macOS ではリモートログイン)はオフのままで構いません。

この方法が自分に合っているかわからない場合は、接続方法を選ぶをご覧ください。

自分のコンピューターのブラウザ → 自分のコンピューターの中継(127.0.0.1) ⟷ Tailscale ⟷ ホストの中継(127.0.0.1) → Octoboard

はじめての方へ
  • Tailscale: 自分のデバイスを、どこにあってもインターネット越しに 1 つのプライベートなネットワークにつなぐサービスです。自分のアカウントでサインインして使います。
  • Tailnet: 自分の Tailscale ネットワークのことで、自分の Tailscale アカウントにサインインしているデバイスの集まりです。
  • 127.0.0.1(ループバック): 常に「このコンピューター自身」を指すアドレスです。
  • ポート: コンピューター上の 1 つのプログラムを選ぶための番号で、部屋番号のようなものです。127.0.0.1:3369 は、このコンピューターのポート 3369 を指します。
  • socat: 接続をある場所から別の場所へ受け渡す、小さな無料のプログラムです。ここでは中継の役目をします。
  • Tailscale Serve: ポートを自分の tailnet の中だけに共有する Tailscale のコマンドです。似た機能の Tailscale Funnel はインターネット全体に共有してしまうので、ここでは絶対に使わないでください。
  • ターミナル: コマンドを入力するウィンドウです。macOS ではターミナル、Windows では PowerShell を使います。

安全のため、Octoboard が受け付けるのは、127.0.0.1 で開いたブラウザだけです。これは常に「このコンピューター自身」を指すアドレスで、ループバックとも呼ばれます。そのため、ホストの Tailscale アドレスをブラウザにそのまま入力しても開けません。代わりに、それぞれのコンピューターで小さな中継プログラムを動かします。自分のコンピューターでは、ホストが 127.0.0.1 にあるかのように見せ、ホストでは、受け取った接続を Octoboard に渡します。2 台の間の通信は Tailscale が運びます。

  • 両方のコンピューターに Tailscale が入っていて、同じ tailnet にサインインしていること。自分のデバイスだけが入っている tailnet を使ってください。ホストに届くことを許可されたデバイスは、共有したポートにも届きます。

  • Mac、または Linux が動いているコンピューターには、それぞれ socat が必要です。Windows のコンピューターには不要です。

    まだ入っていなければ、先に Homebrew をインストールしてください(macOS には、この役目を果たせる標準のツールがありません)。そのうえで、ターミナルで次のコマンドを実行します。

    Terminal window
    brew install socat
  • 作業中は、ウィンドウを 2 つか 3 つ開いたままにします。ホストでは中継と Tailscale Serve(Windows では中継は不要)、自分のコンピューターでは中継(Windows では不要)です。

  1. ブラウザのアドレスを手に入れます。このアドレスには、ブラウザをサインインさせるキーが含まれています。

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

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

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

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

  2. ホストで中継を起動します。ホストの 127.0.0.1 にあるポートを Octoboard につなぐものです。このポートが、以降の手順でいうホストのポートです。

    ターミナルで次のコマンドを実行し、ウィンドウは開いたままにします。待ち受けるのは 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 です。

  3. Tailscale Serve で、ホストのポートを自分の tailnet に共有します。ウィンドウは開いたままにします。Tailscale Funnel は絶対に使わないでください。ポートがインターネットに公開されてしまいます。

    Terminal window
    tailscale serve --tcp=3370 tcp://127.0.0.1:3370

    App Store 版の Tailscale アプリを使っている場合は、tailscale の代わりに /Applications/Tailscale.app/Contents/MacOS/Tailscale でコマンドを実行します。単体版のアプリの場合は、先にアプリの設定の「CLI integration」の項目からコマンドをインストールしてください。

    確認するには、別のウィンドウで tailscale serve status を実行します。ホストのポートが一覧に表示されるはずです。

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

Section titled “ブラウザを使うコンピューターでの操作”
  1. このコンピューターの Tailscale アプリでホストを見つけ、その名前(my-mac など)またはアドレス(100.x.y.z のような数字)を控えます。

  2. このコンピューターで中継を起動します。これで、ホストがこのコンピューターの 127.0.0.1:3369 にあるように見えます。このコンピューターですでにポート 3369 が使われている場合は、別のポートを選び、ブラウザのアドレスのポートも同じように変えてください。

    下のコマンドの <host> をホストの名前またはアドレスに、<host port> をホストのポートに置き換えます。

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>

    たとえば、my-mac という名前の Mac がホストの場合は次のとおりです。

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370

    ターミナルで実行し、ウィンドウは開いたままにします。

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

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

  • ページが開かない: ウィンドウのどれかが閉じられたか、コマンドが止まっています。中継と Tailscale Serve がまだ動いていることと、ホストで tailscale serve status を実行すると、ホストのポートが一覧に出ることを確認してください。
  • socat が「Address already in use」と表示する: そのコンピューターで、そのポートはすでに使われています。別のポートを選んでください。自分のコンピューターの場合は、ブラウザのアドレスのポートも変えます。
  • ページが拒否される、または空白になる: ホストの Tailscale の名前や 100.x.y.z のアドレスではなく、127.0.0.1 のアドレスで開いたことを確認してください。
  • ページを開いたとき、ホストの中継が「Connection refused」または「No such file or directory」と表示する: リモートアクセスを許可がオフになっているか、ホストで Octoboard が動いていません(Linux では octoboardd が動いていません)。
  • ブラウザを使ったコンピューターで: Ctrl+C で socat を止めます。Windows では、管理者として開いた PowerShell でフォワードを削除します。

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • ホストで: Tailscale Serve のコマンドと socat を、Ctrl+C で止めます。tailscale serve status で、何も共有されていないことを確認します。ポートがまだ一覧に残っている場合は、tailscale serve --tcp=3370 off で削除します(Windows では tailscale serve --tcp=3369 off)。

  • Mac または Windows のホストでは、使わなくなったらリモートアクセスを許可をオフにします。これでブラウザの入口が閉じ、そのキーで開いているページはすべて切断されます。

  • アドレスが漏れたかもしれないときは、ブラウザタブのキーを更新で新しいキーに替えます。Linux では octoboardd address --rotate を使います。古いアドレスで開いているページは切断されます。

  • アドレスはパスワードと同じ: アドレスに含まれるキーで、ホスト上の Octoboard をフルコントロールでき、任意のコマンドも実行できます。キーは更新するまで有効です。ブラウザの履歴やブックマークに残り、ブラウザの同期がオンなら、ほかのデバイスにも同期されます。
  • 誰が届くか: ホストのポートに届いて、キーを持っている人なら誰でも届きます。中継は 127.0.0.1 だけを待ち受けるので、ホストや自分のローカルネットワークにあるほかのデバイスからは届きません。Tailscale Serve は、アクセスルールで許される範囲で、ホストのポートを自分の tailnet からだけ届くようにします。
  • 他の人がサインインしないコンピューターでだけ使う: ホストや自分のコンピューターにある別のユーザーアカウントは、これらの 127.0.0.1 のポートに接続できます。中継が動いていない間は、そのポートを奪って、ブラウザが再接続したときにキーを受け取ってしまうこともあります。SSH で接続する方法では、Mac や Linux のホストにこの弱点はなく、デスクトップアプリを使う場合は自分のコンピューターにもありません。ただしブラウザを使う場合は、ブラウジングに使うコンピューターにこの弱点が残ります。そこでも SSH のフォワードが 127.0.0.1 のポートで待ち受けるためです。
  • Funnel は使わない: Tailscale Funnel は、ポートをインターネット全体に公開してしまいます。