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 を使います。
手順が多い理由
Section titled “手順が多い理由”安全のため、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インストールするものはありません。Windows のホストは、すでにブラウザ用の
127.0.0.1のポートを提供していて、ブラウザを使う側の Windows コンピューターは、標準のコマンドで代用します。Terminal window sudo apt install socataptではないディストリビューションを使っている場合は、そのパッケージマネージャー(dnf、pacmanなど)を使ってください。 -
作業中は、ウィンドウを 2 つか 3 つ開いたままにします。ホストでは中継と Tailscale Serve(Windows では中継は不要)、自分のコンピューターでは中継(Windows では不要)です。
ホストでの操作
Section titled “ホストでの操作”-
ブラウザのアドレスを手に入れます。このアドレスには、ブラウザをサインインさせるキーが含まれています。
Octoboard で 設定 › リモートアクセス を開き、リモートアクセスを許可をオンにして、許可を選んで確定します。スイッチの下に 2 つのタブが現れます。ブラウザタブの 手順 2: ブラウザのアドレス で、アドレスをコピーを選びます。
アドレスは、自分だけが読める方法でもう一方のコンピューターに渡してください。たとえば自分宛てのメモに貼り付けます。アドレスはパスワードと同じ働きをします。
手順 1: SSH フォワードは飛ばします。アプリの設定には SSH の話が何か所か出てきますが、このガイドで使うのはブラウザのアドレスだけなので、気にしなくて大丈夫です。
Octoboard は起動したままにしてください。終了すると、リモートアクセスも止まります。
Octoboard で 設定 › リモートアクセス を開き、リモートアクセスを許可をオンにして、許可を選んで確定します。スイッチの下に 2 つのタブが現れます。ブラウザタブの 手順 2: ブラウザのアドレス で、アドレスをコピーを選びます。あわせて、ブラウザ用ポートの下に表示されている番号を控えておきます。
アドレスは、自分だけが読める方法でもう一方のコンピューターに渡してください。たとえば自分宛てのメモに貼り付けます。アドレスはパスワードと同じ働きをします。
手順 1: SSH フォワードは飛ばします。アプリの設定には SSH の話が何か所か出てきますが、このガイドで使うのはブラウザのアドレスだけなので、気にしなくて大丈夫です。
Octoboard は起動したままにしてください。終了すると、リモートアクセスも止まります。
octoboardd を動かしているユーザーとして次のコマンドを実行し、表示された、
http://127.0.0.1:3369/で始まるアドレスをコピーします。そのあとに表示される SSH コマンドは無視してください。Terminal window octoboardd address -
ホストで中継を起動します。ホストの
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です。実行するものはありません。Octoboard 自身が、ブラウザ用ポートで
127.0.0.1だけを待ち受けています。ホストのポートはブラウザ用ポートです(変更していなければ 3369)。同じユーザーとして次のコマンドを実行します。ターミナルか、開いたままにできる
tmuxセッションで実行してください。待ち受けるのは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です。 -
Tailscale Serve で、ホストのポートを自分の tailnet に共有します。ウィンドウは開いたままにします。Tailscale Funnel は絶対に使わないでください。ポートがインターネットに公開されてしまいます。
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370App Store 版の Tailscale アプリを使っている場合は、
tailscaleの代わりに/Applications/Tailscale.app/Contents/MacOS/Tailscaleでコマンドを実行します。単体版のアプリの場合は、先にアプリの設定の「CLI integration」の項目からコマンドをインストールしてください。PowerShell またはコマンドプロンプトで実行します。
Terminal window tailscale serve --tcp=3369 tcp://127.0.0.1:3369ブラウザ用ポートを変更している場合は、そのポートを使ってください。
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370Tailscale から権限がないと言われた場合は、
sudo tailscale set --operator="$USER"で自分のユーザーに管理を一度許可するか、コマンドをsudo付きで実行します。確認するには、別のウィンドウで
tailscale serve statusを実行します。ホストのポートが一覧に表示されるはずです。
ブラウザを使うコンピューターでの操作
Section titled “ブラウザを使うコンピューターでの操作”-
このコンピューターの Tailscale アプリでホストを見つけ、その名前(
my-macなど)またはアドレス(100.x.y.zのような数字)を控えます。 -
このコンピューターで中継を起動します。これで、ホストがこのコンピューターの
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ターミナルで実行し、ウィンドウは開いたままにします。
PowerShell を管理者として開きます。下のコマンドの
<host IP>をホストの100.x.y.zのアドレスに置き換え(このコマンドには数字が必要で、名前では動きません)、<host port>をホストのポートに置き換えます。Terminal window netsh interface portproxy add v4tov4 listenaddress=127.0.0.1 listenport=3369 connectaddress=<host IP> connectport=<host port>このフォワードは、再起動しても、削除する(下記参照)まで残ります。そのため、開いたままにしておくウィンドウはありません。標準で動いている IP Helper サービスが必要です。
-
ホストでコピーしたブラウザのアドレスを開きます。
http://127.0.0.1:3369/で始まるアドレスです。
サインインを求められずに、ブラウザのタブで Octoboard が開けば成功です。
うまくいかないとき
Section titled “うまくいかないとき”- ページが開かない: ウィンドウのどれかが閉じられたか、コマンドが止まっています。中継と 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 が動いていません)。
使い終わったら止める
Section titled “使い終わったら止める”-
ブラウザを使ったコンピューターで: 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を使います。古いアドレスで開いているページは切断されます。
セキュリティ
Section titled “セキュリティ”- アドレスはパスワードと同じ: アドレスに含まれるキーで、ホスト上の Octoboard をフルコントロールでき、任意のコマンドも実行できます。キーは更新するまで有効です。ブラウザの履歴やブックマークに残り、ブラウザの同期がオンなら、ほかのデバイスにも同期されます。
- 誰が届くか: ホストのポートに届いて、キーを持っている人なら誰でも届きます。中継は
127.0.0.1だけを待ち受けるので、ホストや自分のローカルネットワークにあるほかのデバイスからは届きません。Tailscale Serve は、アクセスルールで許される範囲で、ホストのポートを自分の tailnet からだけ届くようにします。 - 他の人がサインインしないコンピューターでだけ使う: ホストや自分のコンピューターにある別のユーザーアカウントは、これらの
127.0.0.1のポートに接続できます。中継が動いていない間は、そのポートを奪って、ブラウザが再接続したときにキーを受け取ってしまうこともあります。SSH で接続する方法では、Mac や Linux のホストにこの弱点はなく、デスクトップアプリを使う場合は自分のコンピューターにもありません。ただしブラウザを使う場合は、ブラウジングに使うコンピューターにこの弱点が残ります。そこでも SSH のフォワードが127.0.0.1のポートで待ち受けるためです。 - Funnel は使わない: Tailscale Funnel は、ポートをインターネット全体に公開してしまいます。