HTTPトンネルを作成する
このページの内容 10セクション
HTTPトンネルを使うと、お使いのデバイス上のWebアプリ、API、Webhookレシーバーに公開HTTPSアドレスを割り当てられます。証明書はLocaltonetが提供するため、ローカルサービスはHTTPのままで構いません。
始める前に #
- Localtonetクライアントがデバイスにインストールされ、AuthTokenで接続されていること。まだの場合はクイックスタートに従ってください。
- Webサービスが起動していて、そのポートがわかっていること(例:
3000)。 - カスタムサブドメインまたはカスタムドメインを使う場合:アカウントの残高が必要です。カスタムドメインでは、DNSマネージャーに追加したドメインも必要です。詳しくはカスタムドメインをご覧ください。
手順 #
-
HTTPページを開く #
マイトンネル › HTTPを開き、HTTPトンネルを作成を選択してフォームを開きます。
-
URLの種類を選ぶ #
URLの種類 取得するアドレス 必要なもの ランダムサブドメイン 選択したドメイン上に生成される名前。例: https://<RANDOM_NAME>.localto.net。追加の要件なし カスタムサブドメイン サブドメインに入力した名前。例: https://myapp.localto.net。英字、数字、ハイフンを使用できます。残高 カスタムドメイン ドメインで選択した、ご自身のドメイン。 残高と、DNSマネージャー内のドメイン -
デバイスとリージョンを選ぶ #
デバイストークンで、デバイス上のLocaltonetアプリが使用しているトークンを選択します。サーバーリージョンでは、遅延を抑えるためにデバイスに近いリージョンを選びます。
-
ローカルアドレスを入力する #
項目 入力する内容 ドメイン localto.net、またはご自身のドメイン。カスタムドメインでは、リストにご自身のドメインのみが表示されます。サブドメイン カスタムサブドメインの場合のみ:ドメインの前に付ける名前。 ローカルIPアドレス デバイス上のサービスのアドレス。このデバイス自身の場合は 127.0.0.1を使用します。フォームはIPv4アドレス、IPv6アドレス、またはlocalhostを受け付けます。ローカルポート ローカルサービスが待ち受けているポート。1~65535の範囲です。 トンネルを作成を選択します。トンネルはあなたのトンネルに、
Tunnel #とIDの形式で表示されます。 -
トンネルを開始する #
操作列の開始ボタンを選択します。トンネルが動作中になると、URL列のアドレスがリンクになります。ブラウザーで開いてください。このアドレスへのリクエストが、デバイス上のサービスに届くようになります。
そのトークンのLocaltonetアプリがオフラインの場合は、ダイアログでお知らせします。アプリを起動するか、このまま開始を選択すると、アプリの接続時にトンネルが公開されます。
公開アドレス #
- アドレスは、
https://の後にURL列のホスト名を続けたものです。 - HTTPトンネルのサブドメインは、トンネルを削除するまで変わりません。停止や再開始をしても変更されません。
- アドレスにポート番号は付きません。訪問者は他のWebサイトと同じように開けます。
- WebSocket接続はHTTPトンネルを通過できます。
HTTPSと証明書 #
訪問者は、Localtonetが提供・更新する証明書を使ってHTTPS経由でHTTPトンネルにアクセスします。TLSはLocaltonetサーバーで終端されます。そこからリクエストはトンネルを通ってデバイスに届き、Localtonetアプリがサービスに引き渡します。
| 設定 | 動作 | 利用する場面 |
|---|---|---|
| HTTPSのみ | 公開URLをHTTPSのみで提供します。http://へのリクエストは、https://の同じアドレスにリダイレクトされます。オフの間は、どちらでも応答します。 | ログイン情報や非公開データを扱う場合はオンにしてください。 |
| HTTP/3を有効化 | クライアントがHTTP/3で公開URLにアクセスできるようにします。新しいトンネルではオンになっています。 | クライアントでHTTP/3に問題がある場合のみ、オフにしてください。 |
| SslStream | Localtonetアプリに、ローカルサービスへTLSで接続するよう指示します。アプリはローカルサービスの証明書をそのまま受け入れるため、自己署名証明書でも動作します。 | ローカルサービス自体がHTTPSを使う場合にオンにします。例:https://localhost:5001の開発サーバー。 |
| レガシー接続 | 通常の方法ではなく、レガシーの方法でトンネルを接続します。 | 通常の方法でトンネルが接続できない場合に試してください。 |
これらのスイッチは、トンネル設定パネルの設定にあります。実行中のトンネルでSslStreamまたはレガシー接続を変更するとトンネルが再起動するため、Localtonetアプリが接続されている必要があります。
ご自身のサービスまで暗号化が必要ですか?HTTPトンネルでは、トラフィックはLocaltonetサーバーで復号されます。サービス自身の証明書を提示する必要がある場合は、TLSトンネルを使用してください。
Hostヘッダー #
サービスには、訪問者が使用したホスト名、つまりトンネルのアドレスが渡されます。ローカルのWebサーバーの中には、ホスト名でサイトを選択するため、誤ったサイトやエラーを返すものがあります。その場合は、トンネル設定のヘッダーを開き、サーバーが期待するホスト名を値としてHostという名前のリクエストヘッダーを追加します。すると、サービスにはトンネルのアドレスの代わりにこのホスト名が渡されます。ヘッダーと書き換えおよびバーチャルホストもご覧ください。
HTTPトンネルの設定 #
操作列の設定ボタンを選択すると、トンネル設定パネルが開きます。トンネルの詳細では、トンネル名の変更や、ローカルIPアドレスとローカルポートの変更ができます。下の表に、HTTPトンネルで利用できるその他の機能と、解説ページをまとめています。
| 設定 | 動作 | 詳細 |
|---|---|---|
| 負荷分散 | トラフィックを複数のデバイスに分散したり、バックアップ先を使用したりします。 | 負荷分散 |
| SSHコマンドを表示 | Localtonetアプリをインストールせずに、通常のSSHでこのトンネルを開始します。 | インストール不要のSSH |
| HTTPSのみ、HTTP/3を有効化、SslStream、レガシー接続 | 訪問者とサービスの接続方法です。 | このページの上部 |
| パスの書き換え | リクエストがローカルサービスに届く前に、リクエストのパスを変更します。 | ヘッダーと書き換え |
| ヘッダー | このトンネルのカスタムHTTPリクエストヘッダーとレスポンスヘッダーを管理します。 | ヘッダーと書き換え |
| HTTPタイムアウト | ローカルアプリケーションからの応答をサーバーが待つ時間を、1~600秒で設定します。 | ヘッダーと書き換え |
| Basic認証 | 訪問者にユーザー名とパスワードを求めます。 | アクセス制御 |
| IP制限 | このトンネルにアクセスできるクライアントIPアドレスを制御します。 | アクセス制御 |
| SSOプロバイダー | 訪問者は、トンネルを開く前にIDプロバイダーのいずれかでサインインします。ページ上部のSSOボタンでプロバイダーを管理します。 | シングルサインオン |
| 操作列のWAFボタン | WAF設定を開きます。このボタンには、Webアプリケーションファイアウォールが未設定か、有効か、無効かが表示されます。 | Webアプリケーションファイアウォール |
| 有効期限、速度制限、帯域幅制限、帯域幅使用量、帯域幅トラフィック | 指定した日にトンネルを停止する、速度を制限する、データ量を制限する、データカウンターをリセットする、トラフィックの推移を確認する、といった操作ができます。 | 制限と有効期限 |
| リクエストログ、アクティビティログ、トンネルのヘルス | リクエストの確認、開始・停止・設定変更の履歴の確認、ヘルスチェックの確認ができます。 | ログと検査 |
| 引数 | このトンネルを、デバイス上の特定のネットワーク経由で通します。 | ネットワーク選択 |
| アウトバウンドポート | 厳格なファイアウォール向けに、Localtonetアプリのサーバー接続で固定のアウトバウンドポートを使用します。 | ポート |
| トンネルメモ | このトンネルを識別しやすくするための非公開メモを保存します。 | 設定リファレンス |
チームに属するトンネルでは、SSOプロバイダーは表示されません。
例 #
Webアプリを共有する #
アプリはLocaltonetクライアントと同じコンピューターで動作し、ポート3000で待ち受けています。
| 項目 | 値 |
|---|---|
| URLの種類 | ランダムサブドメイン |
| ドメイン | localto.net |
| ローカルIPアドレス | 127.0.0.1 |
| ローカルポート | 3000 |
トンネルを作成して開始し、URL列のアドレスをアプリを見せたい相手に送ります。先にパスワードを求めたい場合は、Basic認証をオンにしてください。
アプリがネットワーク内の別のマシンで動作している場合は、ローカルIPアドレスにそのマシンのアドレスを入力します。例:192.168.1.20。Localtonetクライアントを実行しているデバイスから、そのマシンに到達できる必要があります。
Webhookを受信する #
Webhookプロバイダーがイベントを送信するには、公開HTTPSアドレスが必要です。レシーバーのポートに対するHTTPトンネルを作成して開始し、トンネルのアドレスにエンドポイントのパスを加えたものを、プロバイダー側に入力します。
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>任意のコンピューターからテストします。
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
-H "Content-Type: application/json" \
-d '{"event":"test"}'届いた内容を確認するには、トンネルのWebhook列のアイコン(リクエストとレスポンスのログを表示)を選択します。事前にトンネルを開始しておく必要があります。ログと検査をご覧ください。
無料プランでは、Webhookに頼る前に残高を追加してください。無料アカウントのHTTPトンネルへのリクエストには、まず警告ページが表示され、Webhookプロバイダーはそれをクリックして通過できません。次のセクションをご覧ください。
無料プランの警告ページ #
アカウントの残高がない場合、そのHTTPトンネルを初めて訪れた人には、「You are about to navigate to:」というタイトルのLocaltonetのページが表示され、CancelとVisit Siteのボタンが並びます。このページは不正利用を防ぐためのものです。Visit Siteを押すと訪問者のブラウザーにCookieが保存され、サイトが開きます。ブラウザーがそのCookieを保持している間は、再度表示されません。
ページ自体にも、これを解除する2つの方法が示されています。
localtonet-skip-warningという名前のリクエストヘッダーを、任意の値で送信します。ご自身のスクリプトやAPIクライアントに適しています。- アカウントに残高を追加します。プランと残高をご覧ください。
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/トラブルシューティング #
トークンがオフラインというダイアログが表示される、または「AuthToken「…」のLocaltonetアプリが接続されていません。」と表示される
このトンネルのトークンを使用するLocaltonetクライアントが起動していないか、Localtonetに接続できません。同じトークンでデバイス上のクライアントを起動してください。ダイアログで開始した場合、アプリが接続されると自動的にトンネルが開始されます。このまま開始を選ぶとトンネルはオンになり、後から公開されます。
「Localtonetアプリを起動または更新してください。」
デバイス上でトンネルを開始できませんでした。クライアントが起動していることを確認し、バージョンが古い場合はダウンロードページから最新版をインストールしてください。
ブラウザーに「Tunnel Recently Started or Stopped」と表示される
リクエストはLocaltonetに届いていますが、トンネルが接続を受け付けていません。トンネルが開始された直後か、停止しています。トンネルが開始されていて、接続列にオンと表示されていることを確認してから、ページを再読み込みしてください。
ブラウザーに、ローカルアドレスを示すLocaltonetのエラーページが表示される
ページには、トラフィックはLocaltonetエージェントにトンネリングされたものの、エージェントがローカルIPとポートのアップストリームサービスに接続できなかった、と表示されます。見出しがエラー内容です。例:ConnectionRefused。そのアドレスで待ち受けているものがありません。サービスを起動してから、トンネルの詳細のローカルIPアドレスとローカルポートを確認してください。デバイス上でブラウザーからローカルアドレスを開いて、サービスをテストすることもできます。
「この機能を利用するには残高の購入が必要です。」
カスタムサブドメインとカスタムドメインには残高が必要です。ランダムサブドメインを使うか、残高で残高を追加してください。
「You need a total balance of … to create another tunnel of this type.」
残高では、もう1つトンネルを作成できません。無料プランでは、種類を問わずトンネルを合計1つしか作成できません。既存のトンネルを削除してから新しく作成するか、残高を追加してください。
「… はすでに存在します。」または「… は使用できません。」
そのサブドメインを別のトンネルが使用しているか、Localtonetによって予約されている名前です。別のサブドメインを選んでください。
「警告:ドメインがありません!」
カスタムドメインを選択しましたが、ドメインがまだ追加されていません。先にDNSマネージャーで追加してください。「… はすでに別のトンネルで使用されています。」と表示された場合、そのドメインはすでにご自身のトンネルのいずれかに割り当てられています。カスタムドメインで提供できるトンネルは1つだけです。
「帯域幅制限を更新するか、帯域幅使用量をクリアしてください。」または「有効期限日を更新してください。」
トンネルが自身の帯域幅制限または有効期限に達したため、開始できません。トンネル設定で制限または日付を変更するか、帯域幅使用量でカウンターをリセットしてください。制限と有効期限をご覧ください。
「デバイスの接続を確認してください。」
Localtonetアプリがオフラインの間に、実行中のトンネルが再起動される設定を変更しました。アプリを接続して設定を再度保存するか、先にトンネルを停止してください。
アプリが誤ったサイトを返す、またはhttp://のリンクやリダイレクトが生成される
アプリは、受け取ったホスト名またはスキームで判断しています。アプリが固定のホスト名を期待する場合は、ヘッダーでHostリクエストヘッダーを追加してください。訪問者がHTTPSを使っていることをアプリに伝えるには、値をhttpsにしたX-Forwarded-Protoリクエストヘッダーを追加します。これにより、アプリはhttps://のリンクとリダイレクトを生成します。