トンネル設定リファレンス
このページの内容 15セクション
すべてのトンネルには、ダッシュボードに設定パネルがあります。このページでは、設定パネルの開き方、各設定の一覧、設定が使えるトンネルタイプ、詳しい説明のページへのリンクを紹介します。
トンネルの設定を開く #
-
トンネルタイプのページを開く #
ダッシュボードのメニューでマイトンネルを開き、タイプを選びます。マイトンネル › HTTP、TCP - UDP、TLS、ファイルサーバー、プロキシサーバー、ローテーティングプロキシ、MCPゲートウェイから選べます。
-
トンネルの行で「設定」を選ぶ #
あなたのトンネルの中から対象のトンネルを探し、操作列の設定を選びます。ページの横にトンネル設定パネルが開きます。
-
設定を変更する #
パネルは次の部分で構成されています。
- トンネルの詳細:トンネルのアドレス、作成日、AuthTokenの名前などの詳細です。値を選ぶと編集できます。すべてのトンネルタイプでタイトルを編集でき、HTTP、TCP - UDP、TLSのトンネルではローカルアドレスとローカルポートも編集できます。
- トンネルの負荷分散ターゲットです。対応しているトンネルタイプにのみ表示されます。負荷分散をご覧ください。
- SSHコマンドを表示:通常のSSHで開始できるトンネルタイプに表示されます。インストール不要のSSHをご覧ください。
- 設定:設定ごとに1行です。各行には、はい / いいえのスイッチか、ダイアログを開くボタン(管理、変更、表示、クリア)があります。ラベルの横にある情報アイコンで、その設定が1文で説明されます。
ほとんどのスイッチは、変更前に確認を求めます。たとえばHTTPSのみをオンにしますか?では、オンにするとキャンセルのボタンが表示されます。Basic認証またはパスの書き換えをオンにするとダイアログが開きます。実行中のトンネルで予約ポートをオンにした場合は、確認なしでポートが予約されます。
変更が適用される仕組み #
一部の設定は、実行中のトンネルを中断せずに適用されます。それ以外の設定は、トンネルをいったん停止し、新しい値で再開始します。この場合は少し時間がかかり、開いている接続は切断されます。
| 再起動なしで適用 | 実行中のトンネルを再起動 |
|---|---|
| HTTPSのみ、パスの書き換え、HTTP/3を有効化、予約ポート、ヘッダー、HTTPタイムアウト、トンネルメモ、IP制限、有効期限、アウトバウンドポート、帯域幅制限、帯域幅使用量、WAFスイッチ | トンネルの詳細のタイトル、ローカルアドレス、ローカルポート、Basic認証、SslStream、PROXYプロトコル、レガシー接続、サーバーポート、引数、ローカルサーバーIP、速度制限、サーバーの変更、AuthTokenの変更 |
トンネルの再起動が必要な設定は、そのデバイスのLocaltonetアプリが接続されている場合にのみ、実行中のトンネルで保存できます。接続されていない場合、ダッシュボードは「デバイスの接続を確認してください。」と応答し、古い値のままになります。停止中のトンネルでは値が保存され、次回の開始時に使われます。
トンネルタイプごとの設定 #
ラベルは設定セクションに表示されるものです。「はい」は、そのトンネルタイプにその行があることを意味します。
| 設定 | HTTP | TCP - UDP | TLS | ファイルサーバー | プロキシサーバー | ローテーティングプロキシ | MCPゲートウェイ |
|---|---|---|---|---|---|---|---|
| HTTPSのみ | はい | – | – | – | – | – | はい |
| パスの書き換え | はい | – | – | – | – | – | – |
| Basic認証 | はい | – | – | はい(タイプはDefault) | – | – | はい |
| SslStream | はい | はい(UDPを除く) | はい | – | – | – | – |
| HTTP/3を有効化 | はい | – | – | – | – | – | はい |
| 予約ポート | – | はい | – | – | はい | はい | – |
| PROXYプロトコル | – | はい(UDPを除く) | – | – | – | – | – |
| レガシー接続 | はい | はい | はい | はい | はい | – | はい |
| SSLモード | – | – | はい | – | – | – | – |
| SSOプロバイダー | はい(チームのトンネルを除く) | – | – | – | – | – | – |
| ゲートウェイトークン | – | – | – | – | – | – | はい |
| ヘッダー | はい | – | – | – | – | – | – |
| HTTPタイムアウト | はい | – | – | – | – | – | はい |
| サーバーポート | – | はい | – | – | はい(VLESSを除く) | はい | – |
| トンネルメモ | はい | はい | はい | はい | はい | はい | はい |
| ローカルサーバーIP | ローカルサーバーのみ | ローカルサーバーのみ | ローカルサーバーのみ | – | ローカルサーバーのみ | – | ローカルサーバーのみ |
| 引数 | はい | はい | はい | – | はい | – | – |
| IP制限 | はい | はい | はい | はい | はい | はい | はい |
| 有効期限 | はい | はい | はい | はい | はい | – | はい |
| 速度制限 | はい | はい | はい | はい | はい | – | はい |
| アウトバウンドポート | はい | はい | はい | はい | はい | はい | はい |
| 帯域幅制限 | はい | はい | はい | はい | はい | – | はい |
| 帯域幅トラフィック | はい | はい | はい | はい | はい | はい | はい |
| 帯域幅使用量 | はい | はい | はい | はい | はい | – | はい |
| トンネルIP | – | はい | はい | – | はい | はい | – |
| リクエストログ | はい | はい | はい | はい | はい | – | はい |
| アクティビティログ | はい | はい | はい | はい | はい | はい | はい |
| トンネルのヘルス | はい | はい | はい | – | はい | はい | はい |
プロキシサーバーとローテーティングプロキシのページには、プロキシ認証、アクセス制御、アップストリーム設定、VPNアクセス、スピードテスト、トンネルトークン、IPv4のみで接続?など、専用の行がさらにあります。これらはプロキシサーバーとローテーティングプロキシで説明しています。ローカルサーバーを使うトンネルにはアウトバウンドポートの行がありません。「ローカルサーバーのみ」には、サーバー列にVPNと表示されるトンネルも含まれます。
各設定の内容 #
| 設定 | 動作 | 詳細 |
|---|---|---|
| HTTPSのみ | 公開URLをHTTPSのみで提供します。 | ヘッダーと書き換え |
| パスの書き換え | ローカルサービスに届く前に、すべてのリクエストの先頭にパスを追加します。 | ヘッダーと書き換え |
| Basic認証 | 訪問者にユーザー名とパスワードを求めます。 | アクセス制御 |
| SslStream | ローカルサービス自体がHTTPSまたはTLSを使っていることをトンネルに伝えます。 | このページ |
| HTTP/3を有効化 | クライアントが公開URLにHTTP/3でアクセスできるようにします。 | ヘッダーと書き換え |
| 予約ポート | トンネルを再起動しても同じサーバーポートを維持します。 | ポート |
| PROXYプロトコル | 元のクライアントアドレスを、PROXYプロトコルのヘッダーでサービスに渡します。 | このページ |
| レガシー接続 | 通常の方法でトンネルが接続できないときに試す、代替の接続方法です。 | このページ |
| SSLモード | TLSトンネルで、LocaltonetがHTTPSを処理するか、暗号化されたトラフィックをそのままサービスに渡すかを選びます。 | TLS |
| SSOプロバイダー | 訪問者がトンネルを開く前に、いずれかのIDプロバイダーでサインインするようにします。 | シングルサインオン |
| ゲートウェイトークン | MCPクライアントがゲートウェイに接続するときに送信するトークンを表示します。 | MCPゲートウェイ |
| ヘッダー | 固定のリクエストヘッダーとレスポンスヘッダーを追加します。 | ヘッダーと書き換え |
| HTTPタイムアウト | トンネルがリクエストに対するサービスの応答を待つ時間を設定します。 | ヘッダーと書き換え |
| サーバーポート | Localtonetサーバー上で、接続に使うポートを変更します。 | ポート |
| トンネルメモ | トンネルの用途を自分用に書き留めておくメモです。 | このページ |
| ローカルサーバーIP | ローカルサーバーに到達できるアドレスです。 | このページ |
| 引数 | デバイスの特定のネットワーク経由でトンネルを通します。 | ネットワーク選択 |
| IP制限 | トンネルに接続できるIPアドレスを選びます。 | アクセス制御 |
| 有効期限 | 指定した日にトンネルを停止します。 | 制限と有効期限 |
| 速度制限 | アップロードとダウンロードの速度に上限を設けます。 | 制限と有効期限 |
| アウトバウンドポート | 厳しいファイアウォール向けに、Localtonetアプリが外部へ接続するポートを固定します。 | ポート |
| 帯域幅制限 | 一定量のデータが転送された時点でトンネルを停止します。 | 制限と有効期限 |
| 帯域幅トラフィック | トンネルを通過したデータをグラフで表示します。 | 制限と有効期限 |
| 帯域幅使用量 | トンネルのデータカウンターを0にリセットします。 | 制限と有効期限 |
| トンネルIP | トンネルが動作しているサーバーのIPアドレスを表示します。 | このページ |
| リクエストログ | トンネルで記録されたリクエストまたは接続を表示します。 | ログと検査 |
| アクティビティログ | 開始、停止、設定変更を一覧表示します。 | ログと検査 |
| トンネルのヘルス | 定期的なヘルスチェックの結果を表示します。 | ログと検査 |
トンネルの詳細 #
トンネルの詳細の値を選ぶと編集できます。3つのどれを保存しても、実行中のトンネルは再起動されます。ローカルアドレスとローカルポートはHTTP、TCP - UDP、TLSのトンネルで編集できます。それ以外のトンネルタイプにはタイトルだけが表示されます。
| ダイアログ | 入力する内容 | ルール |
|---|---|---|
| トンネル名を変更 | トンネル一覧で見分けやすい名前です。例:「Office NAS」。 | 必須です。30文字以内:ダイアログは100文字までカウントしますが、30文字を超えるタイトルは「タイトルは30文字以内で入力してください。」というメッセージで拒否されます。 |
| ローカルアドレス | Localtonetアプリがサービスを見つける場所です。サービスがアプリと同じデバイスで動作している場合は127.0.0.1を使います。ネットワーク上の別のデバイスに接続するには、そのアドレスを入力します。例:192.168.1.20。 | IPv4アドレス、IPv6アドレス、またはホスト名です。http://、パス、ポートは含めません。 |
| ローカルポート | サービスを実行しているデバイスで、サービスが待ち受けているポートです。 | 1〜65535の数値です。 |
トンネルメモ #
トンネルメモ › 管理を選ぶとメモダイアログが開きます。メモはトンネルの用途を書き留めるもので、あなたのアカウントにのみ表示されます。
- メモは499文字まで入力できます。入力中に文字数がカウントされます。
- ラベルの選択肢を使うと、メモの先頭にラベルが付きます。本番、ステージング、テスト、デモ、一時的から選べます。メモは、たとえば
Staging -で始まります。別のラベルを選ぶと、付いているラベルが置き換わります。
SslStream #
ローカルサービス自体がHTTPSまたはTLSを使っている場合は、SslStreamをオンにします。たとえば、https://localhostでのみ待ち受ける開発サーバーなどです。プレーンなHTTPまたはプレーンなTCPのサービスでは、オフのままにします。HTTP、TCP、TLSのトンネルにはこのスイッチがあります。UDPトンネルにはありません。
PROXYプロトコル #
PROXYプロトコルをオンにすると、トンネルは元のクライアントアドレスをPROXYプロトコルのヘッダーでサービスに渡します。サービスがこのヘッダーを読み取るように設定されている場合にのみオンにしてください。想定していないサービスでは、すべての接続の先頭に未知のバイトが現れます。TCPトンネルにはこのスイッチがあります。UDPトンネルにはありません。
レガシー接続 #
レガシー接続は、トンネルを代替の接続方法に切り替えます。通常の方法でトンネルが接続できない場合に試してください。効果がなければ、再びオフにします。
ローカルサーバーIP #
この行は、サーバー列にローカルまたはVPNと表示されるトンネルにのみ表示されます。ローカルサーバーIPダイアログには、ローカルサーバーに到達できるアドレスを入力します。IPv4アドレスと、必要に応じてIPv6アドレスです。IPv6を使わない場合は空のままにします。少なくとも1つのアドレスが必要です。127.0.0.1、0.0.0.0、::1のように、デバイス自身でしか使えないアドレスは、「ローカルサーバーのIPは外部から到達可能である必要があります。」というメッセージで拒否されます。
トンネルIP #
トンネルIP › 表示を選ぶとサーバーIPダイアログが開き、トンネルが動作しているサーバーのIPv4アドレスと、あればIPv6アドレスが表示されます。クライアントは、ドメイン名の代わりにこのアドレスでトンネルに接続できます。
サーバーのIPアドレスは変更されることがあります。アプリやスクリプトでは、できるだけドメイン名を使ってください。
トンネル一覧での設定 #
2つの設定は、パネルではなくトンネル一覧から変更します。
サーバーを変更する #
サーバー列のサーバーコードを選び、サーバーの変更ダイアログで別のサーバーを選んで送信を選びます。実行中のトンネルは新しいサーバーで再起動されます。
- サーバーの変更には残高が必要です。残高がない場合、ダッシュボードは「この機能を利用するには残高の購入が必要です。」と応答します。
- 新しいサーバーですでにトンネルのサーバーポートが使われている場合は、「トンネルのポート(PORT)は選択したサーバーでは利用できません。先にポートを変更してください。」と表示されます。ポートの手順でポートを変更してから、もう一度お試しください。
- サーバー列にローカルまたはVPNと表示されるトンネルは、移動できません。
サーバーを変更すると、DNSの更新に最大3時間かかることがあります。
AuthTokenを変更する #
AuthToken列のトークン名を選んでAuthTokenを変更を開き、別のAuthTokenを選んで送信を選びます。これで、そのトークンを使うLocaltonetアプリが動作しているデバイスにトンネルが移ります。
- 実行中のトンネルは停止し、2秒待ってから、選択したAuthTokenで再開始します。停止中のトンネルは停止したままです。
- 新しいトークンのアプリが接続されていない場合でも、トークンは変更され、「AuthTokenは更新されましたが、トンネルを再起動できませんでした。選択したトークンでLocaltonetアプリを接続し、トンネルを開始してください。」と表示されます。
- ローテーティングプロキシのトンネルはAuthTokenグループを使います。代わりにグループを変更してください。
AuthTokenについてはAuthTokenで説明しています。
Webアプリケーションファイアウォール #
HTTPとMCPゲートウェイのトンネルには、操作列に盾のボタンもあります。これでトンネルのファイアウォールを開きます。Webアプリケーションファイアウォールをご覧ください。
APIでの同じ設定 #
ほとんどの設定は、トンネルのパスの下でAPIを使って読み取りや変更もできます。認証と完全なリファレンスはAPIにあります。
| 設定 | /api/v2/tunnels/<TUNNEL_ID>/の後のパス |
|---|---|
| IP制限 | ip-restrictions |
| ヘッダー | headers, host-header |
| Basic認証 | authentication |
| 有効期限 | expiration |
| サーバーポート | server-port |
| HTTPタイムアウト | http-timeout |
| 速度制限 | rate-limit |
| 帯域幅制限と使用量 | bandwidth-limit, bandwidth-usage, bandwidth-usage/reset |
| 引数 | arguments |
| HTTPSのみ、HTTP/3を有効化、パスの書き換え | https-only, http3, path-rewrite |
| SslStream、PROXYプロトコル、SSLモード | ssl-stream, proxy-protocol, pass-through |
| トンネルメモ | note |
| サーバー | server |
トラブルシューティング #
「デバイスの接続を確認してください。」
この設定はトンネルの再起動が必要ですが、トンネルのデバイスのLocaltonetアプリが接続されていません。デバイスでアプリを起動し、接続列にオンと表示されるまで待ってから、もう一度保存してください。先にトンネルを停止する方法もあります。停止中のトンネルでは、再起動なしで値が保存されます。
「この機能を利用するには残高の購入が必要です。」
この設定には、アカウントの残高が必要です。予約ポート、カスタムサーバーポート、固定のアウトバウンドポート、IP制限、サーバーの変更が該当します。プランと残高をご覧ください。
「このトンネルを更新する権限がありません。」
チームで作業していて、あなたのロールにトンネルの変更が含まれていません。チームのオーナーに権限を付与してもらってください。チーム管理をご覧ください。
表にある行がパネルに表示されない
パネルには、そのトンネルのタイプの行だけが表示されます。一部の行はトンネル自体にも左右されます。ローカルサーバーIPにはローカルまたはVPNのサーバーが必要で、SSOプロバイダーはチームのトンネルには表示されず、UDPトンネルにはSslStreamとPROXYプロトコルがありません。