Localtonetの仕組み
このページの内容 10セクション
デバイス上のLocaltonetクライアントは、Localtonetサーバーへのアウトバウンドの暗号化トンネルを開きます。サーバーはサービスにパブリックアドレスを割り当て、そのトンネルを通じて、指定したローカルIPアドレスとポートにトラフィックを転送します。
リクエストの経路 #
- 訪問者は、トンネルのパブリックアドレスに接続します。このアドレスは、選択したリージョンにあるLocaltonetサーバーのものです。
- Localtonetサーバーは、デバイス上のクライアントがすでに開いているトンネルにトラフィックを送ります。
- Localtonetクライアントがトラフィックを受け取り、トンネルに設定されたローカルIPアドレスとポート(例:
127.0.0.1:3000)に接続します。 - サービスが応答し、レスポンスは同じ経路を逆にたどって返ります。
ポートフォワーディングもパブリックIPも不要 #
接続を開始するのはデバイス側なので、インバウンドのポートを開ける必要はありません。パブリックIPアドレスも、ルーターの設定変更も不要です。ポートフォワーディングができない家庭用回線やモバイル回線でも、NATやCGNATの内側で動作します。
ただし、ネットワークがアウトバウンド接続を許可している必要があります。ファイアウォールやエンドポイントセキュリティ製品によってブロックされる場合があります。
HTTPトンネルとTCPトンネルでは、クライアントを使わずに済ませることもできます。トンネルの設定にSSHコマンドが表示され、SSHクライアントのある任意のマシンからトンネルを開けます。インストール不要のSSHをご覧ください。
デバイスとAuthToken #
AuthTokenは、1台のデバイスをアカウントに接続します。クライアントをこのトークンで起動すると、以降はトンネルの作成時にそのデバイスを選べるようになります。
- デバイスごとに1つのトークン。マイトークンで、デバイスごとにトークンを作成し、
Office-PCのようにわかりやすい名前を付けます。名前は単なるラベルです。トークン自体はLocaltonetが生成します。 - トークンごとに1つの接続。同じトークンを使った新しい接続は、以前の接続を置き換えます。同じトークンで2台のデバイスを起動しないでください。
- オンラインとオフライン。マイトークンでは、Localtonetアプリが接続されている間は各デバイスがオンラインと表示され、切断されるとトンネルが設定されたままでもオフラインと表示されます。
- 他人に知られないようにしてください。トークンを知っている人は誰でも、そのデバイスとしてアプリにログインできます。
AuthTokenはトンネルを保護しません。AuthTokenが識別するのはお使いのデバイスであり、訪問者ではありません。新しいトンネルは、アドレスを知っている人なら誰でもアクセスできます。訪問者を制限するには、アクセス制御をご覧ください。
トークンの詳細:AuthToken。
トンネル #
トンネルは、パブリックアドレスと1台のデバイス上のサービスを結び付ける、保存済みの設定のまとまりです。各トンネルには次の内容が保存されます。
| 設定 | 決まる内容 |
|---|---|
| トンネルの種類 | プロトコルです:HTTP、TCP、UDP、TLS、ファイルサーバー、プロキシサーバーなど。トンネルの種類をご覧ください。 |
| デバイストークン | トラフィックを受け取るデバイスです。そのデバイス上のクライアントを起動したときのトークンになります。 |
| サーバーリージョン | パブリックアドレスをホストするLocaltonetサーバーの場所です。 |
| URLの種類 | パブリックアドレスの決め方です。 |
| ローカルIPアドレスとローカルポート | クライアントがトラフィックを送る先です。クライアントと同じデバイス上のサービスには127.0.0.1を使用します。 |
1台のデバイスで、複数のトンネルを扱えます。マイトークンには、各トークンに紐づくトンネルのアクティブ数と合計数が表示されます。トンネルを別のデバイスに移すには、トンネル一覧でトークン名を選択し、AuthTokenを変更で別のトークンを選びます。実行中のトンネルは停止し、選択したトークンで再起動します。ローテーティングプロキシのトンネルは例外で、単一のトークンではなくトークングループを使用します。
作成からライブになるまで #
- 作成。トンネルを作成は設定を保存するだけです。この時点ではまだオンラインになりません。
- 開始。開始を選択します。トンネルのトークンのクライアントが接続されていれば、トンネルがライブになります。
- デバイスがオフラインのときの開始。ダッシュボードにトークンがオフラインであることが表示され、アプリの接続を待ちます。このまま開始を選ぶと、トンネルをすぐにオンにします。トンネルはアクティブとして扱われ、アプリが接続されるとライブになります。
- 停止。パブリックアドレスが応答しなくなります。トンネルと設定は、後で使うために保持されます。
- 削除。トンネルのエンドポイントと設定が削除されます。
トークンを削除すると、そのトンネルも削除されます。そのトークンを使用しているトンネルは、停止されて削除されます。
サーバーリージョン #
サーバーリージョン欄は、トンネルのパブリックアドレスをどこでホストするかを決めます。ダッシュボードのヒントは「デバイスに近いリージョンを選ぶと、レイテンシーが小さくなります」です。
一覧はアカウントごとに作られ、次の項目が含まれます。
- Localtonetのリージョン:国ごとに1項目です。場所は、ホームページのネットワークマップで確認できます。
- 自分のサーバー:サーバーマネージャーで追加した場合に表示されます。見えるのはお使いのアカウントだけで、一覧ではデフォルトでそのサーバーが選択されます。
- ローカルをサーバーとして使用:対応するトンネルの種類で表示されます。下記をご覧ください。
既存のトンネルを移動することもできます。トンネル一覧でトンネルのサーバーを選択するとサーバーの変更が開きます。この操作には残高が必要で、サーバーを変更した場合、DNSの更新に最大3時間かかることがあります。
パブリックアドレスとURLの種類 #
トンネルを作成するとき、URLの種類によってパブリックアドレスの決め方が変わります。
| URLの種類 | 得られるもの | プラン |
|---|---|---|
| ランダムサブドメイン | Localtonetがサブドメインを生成します。アドレスはすぐに得られます。 | 無料プラン |
| カスタムサブドメイン | サブドメインを自分で入力し、所属するドメインを選びます。 | 残高が必要 |
| カスタムドメイン | DNSマネージャーで追加した、自分のドメインを使用します。カスタムドメインをご覧ください。 | 残高が必要 |
すべてのトンネルの種類で、すべてのURLの種類が使えるわけではありません。
| トンネルの種類 | ランダムサブドメイン | カスタムサブドメイン | カスタムドメイン |
|---|---|---|---|
| HTTP | はい | はい | はい |
| ファイルサーバー | はい | はい | はい |
| MCPゲートウェイ | はい | はい | はい |
| TLS | はい | はい | いいえ |
| TCP、UDP、UDP / TCP混合 | はい | はい | いいえ |
| プロキシサーバー | はい | はい | いいえ |
| ローテーティングプロキシ | はい | はい | いいえ |
TCP、UDP、プロキシのトンネルには、ホスト名とサーバーポートで接続します。
アドレスは変わらないか #
- HTTPトンネルは、トンネルを削除するまでサブドメインを保持します。
- TCP、UDP、プロキシのトンネルでは、残高のあるアカウントで作成したトンネルは予約ポートがオンの状態で始まり、再起動しても同じポートが維持されます。トンネルごとに切り替えられます。ポートをご覧ください。
- 無料プランでは、トンネルが停止するとポートが解放されるため、アドレスが変わることがあります。
エンドツーエンド暗号化 #
デバイスとLocaltonetサーバーの間のトンネルは暗号化されています。ただし、これは訪問者とサービスの間のエンドツーエンド暗号化とは異なります。
- 訪問者は、Localtonetが管理する証明書を使って、HTTPSでHTTPトンネルに接続します。このHTTPSはサービスではなくLocaltonetサーバーで終端されます。そこから先、トラフィックは暗号化されたトンネルを通ってデバイスに届きます。
- エンドツーエンド暗号化が必要な場合は、サービスが自前の証明書を提示するパススルーモードのTLSトンネルか、SSHのようにもともと暗号化されているプロトコルを使用してください。
クライアントが切断されたとき #
トンネルが動作するのは、デバイス、Localtonetクライアント、ローカルサービスの3つがすべて動いている間だけです。クライアントが接続を失った場合や、クライアントを閉じた場合は次のようになります。
- 訪問者は、パブリックアドレス経由でサービスに接続できなくなります。
- マイトークンで、デバイスがオフラインと表示されます。トンネル自体は開始された状態のままです。
- クライアントは自動で再接続を試み続けます。開始済みのトンネルは、アプリが接続されるとすぐに再びライブになります。
- 開始済みのトンネルは、デバイスがオフラインでも、開始している間は課金されます。課金を止めるには、トンネルを停止してください。プランと残高をご覧ください。
ログアウトや再起動の後もクライアントを動かし続けるには、サービスとしてインストールします:サービスとして実行。トンネルやトークンが切断されたときに通知を受け取るには、Webhookを設定します。
ローカルをサーバーとして使用 #
ローカルをサーバーとして使用は、サーバーリージョンの一覧にある項目です。これを選ぶと、パブリックアドレスをホストするLocaltonetサーバーは使われません。デバイス上のLocaltonetクライアントが自らリスナーを開き、訪問者はデバイスに直接接続します。ダッシュボードでは、このトンネルをClient Relayとも呼びます。
- HTTP、TCP、UDP、TLS、プロキシサーバー、MCPゲートウェイのトンネルを作成するときに選べます。ファイルサーバーとローテーティングプロキシでは選べません。
- これを選ぶと、フォームにリレーサーバーIPの入力欄が表示されます。訪問者が接続する、お使いのデバイスのIPアドレスです。
- リスナーをホストするデバイスは、接続したままにしておく必要があります。
- Client Relayのトンネルには、より低い専用の料金が設定されています。プランと残高をご覧ください。
| メッセージ | 対処方法 |
|---|---|
| ローカルサーバーのIPを入力してください。 | リレーサーバーIPを入力します。 |
| ローカルサーバーのIPは外部から到達可能である必要があります。 | 127.0.0.1のようなループバックアドレスなど、ローカル専用のアドレスを入力しています。訪問者が到達できるアドレスを入力してください。 |