SSHクライアントでトンネルを開始する
無料プラン HTTPおよびTCPトンネル
このページの内容 11セクション
Localtonetをインストールせずに、ローカルサービスを公開できます。ダッシュボードですぐに使えるsshコマンドが発行され、そのコマンドが実行されている間、HTTPまたはTCPトンネルが有効になります。
利用する場面 #
Localtonetクライアントをインストールできない、またはインストールしたくない環境でゼロインストールSSHを使います。たとえば、一時的にしかアクセスしないサーバー、制限の厳しい職場のマシン、ちょっとしたデモなどです。必要なのは、Windows、macOS、Linuxに標準で付属しているsshクライアントだけです。
SSHコマンドは、1つのトンネルについてLocaltonetクライアントの代わりになります。それ以外はすべてダッシュボードで管理します。トンネルのアドレス、設定、ログ、帯域幅などです。
| トンネルの種類 | SSHコマンド |
|---|---|
| HTTP / HTTPS | 利用可能 |
| TCP | 利用可能 |
| UDP、UDP / TCP Mixed、TLS、ファイルサーバー、プロキシサーバー、その他の種類 | 利用できません。Localtonetクライアントが必要です。 |
このページは、SSHサーバーに接続する方法を説明するものではありません。自分のSSHサーバーをトンネルで公開するには、LocaltonetでSSHを使うをご覧ください。ダッシュボードからデバイスのシェルを開くには、デバイスターミナルをご覧ください。
始める前に #
- Localtonetアカウントと、すでに起動しているサービス(たとえばポート3000で動作するWebアプリ)。
- サービスに接続できるマシン上の
sshクライアント。ssh -Vで確認できます。 - そのマシンのネットワークで、ポート
223への外向きTCP接続が許可されていること。 - 実行中のLocaltonetクライアントが使用していないAuthToken。トンネルは必ずいずれかのトークンに属しますが、SSHの場合はどのクライアントもそのトークンでサインインしません。トンネルのトークンでクライアントが接続されていると、ダッシュボードはコマンドを発行しません。
手順 #
-
HTTPまたはTCPトンネルを作成する #
マイトンネル › HTTPまたはマイトンネル › TCP - UDP(プロトコルはTCP)を開き、通常どおりトンネルを作成します。ローカルIPアドレスとローカルポートは、SSHクライアントがトラフィックを送る先です。サービスと同じマシンでコマンドを実行する場合は、
127.0.0.1とサービスのポートを指定します。トンネルは停止したままにしておきます。 -
SSHコマンドを開く #
トンネル一覧で、対象のトンネルの設定を選び、SSHコマンドを表示を選びます。SSHコマンドダイアログが開き、このトンネル用のコマンドが表示されます。コマンドを実行できる残り秒数が通知に表示されます。使われなかったコマンドは期限切れになり、その場合は同じ手順で新しいコマンドをリクエストします。
-
再接続するかどうかを選ぶ #
自動的に再接続をオフにすると、そのままの
sshコマンドが表示されます。オンにすると、接続が切れたときにコマンドを再度実行するループでコマンドが包まれます。続いて実行する環境で、ループを記述するシェルを選びます。PowerShell、コマンドプロンプト、macOSまたはLinuxから選べます。 -
コマンドを実行する #
コマンドの下に表示されているテキストをコピーします。サービスが動作しているコンピューターでターミナルを開き、コマンドを貼り付けてEnterを押します。パスワードは求められません。接続が確立されると、ターミナルにトンネルのエンドポイントが表示されます。
ターミナル+--------------------------------------------------------------+ | Welcome to Localtonet! | +--------------------------------------------------------------+ | Localtonet Tunnel Endpoints | +--------------------------------------------------------------+ | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000 | | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000 | +--------------------------------------------------------------+ | Server Time: ... | +--------------------------------------------------------------+ You can view your requests and configure your tunnel settings from the Localtonet Dashboard.TCPトンネルの場合は、代わりに次の1行が表示されます。
TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT> -
ウィンドウを開いたままにする #
トンネルは、コマンドが接続した時点で自動的に開始されます。開始を選ぶ必要はありません。コマンドが実行されている間、トンネルはオンラインです。ウィンドウを閉じると接続が終了し、公開アドレスは応答しなくなります。自分でコマンドを終了するには、
exitと入力してEnterを押すか、Ctrl + Cを押します。コマンドを終了しても、ダッシュボード上のトンネルは停止しません。同じコマンドで再接続できるように、トンネルは開始された状態のまま、接続はオフと表示されます。トンネルが不要になったら、ダッシュボードでそのトンネルの停止を選びます。ダッシュボードが新しいSSHコマンドを発行するのは、停止中のトンネルに対してだけです。
トンネルセットアップウィザードから使う #
ダッシュボードのトンネルセットアップウィザードでも同じコマンドを取得できます。プラットフォームを選ぶ最後のステップでSSHを選び、SSHコマンドを取得を選びます。SSHの選択肢が表示されるのは、HTTPおよびTCPトンネルの場合だけです。コマンドが接続するまで、ウィザードにはSSHを待機中と表示され、接続後はSSHで接続済みと表示されます。自動再接続を使うと同じ再接続ループが追加され、新しいコマンドを取得を使うと期限切れのコマンドを置き換えられます。
コマンドの内容 #
コマンドの形式は常に次のとおりです。値はダッシュボードがトンネルに合わせて入力します。
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>| 部分 | 動作 |
|---|---|
-p 223 | Localtonetがこの種のSSH接続を受け付けるポート223に接続します。 |
-l <COMMAND_KEY> | ログイン名です。ダッシュボードがこのトンネル用に生成するキーであり、AuthTokenでもアカウントのパスワードでもありません。これによってLocaltonetはどのトンネルを開始するかを判断するため、パスワードは求められません。 |
<TUNNEL_ADDRESS> | トンネルのアドレスです。SSH接続は、そのトンネルをホストしているサーバーに向かいます。 |
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT> | リモートフォワードです。サーバー上でトンネル宛てに届いた接続は、SSH接続を通って<LOCAL_IP>:<LOCAL_PORT>に送られます。最後の2つの値は、トンネルのローカルIPアドレスとローカルポートです。サーバー側のポートはLocaltonetが割り当てるため、変更しないでください。 |
-o ExitOnForwardFailure=yes | フォワードを設定できない場合に、動作するトンネルがないまま接続を保つのではなく、sshを終了させます。 |
-o ServerAliveInterval=15 -o ServerAliveCountMax=3 | 15秒ごとにキープアライブを送信し、応答のないものが3回続くと接続を終了します。そのため、切断された接続は約45秒以内に検出されます。 |
-o ConnectTimeout=15 | サーバーに到達できない場合、15秒後に接続を諦めます。 |
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null | ホストキーの確認を省略し、サーバーをknown_hostsファイルに書き込みません。 |
-o LogLevel=ERROR | sshの情報メッセージを非表示にします。エラーは引き続き表示されます。 |
<LOCAL_IP>はsshを実行するマシン上で解決されるため、サービスがそのマシン上にある必要はありません。192.168.1.20のようなローカルアドレスを指定すると、コマンドは同じネットワーク内の別のデバイスに転送します。
コマンドを共有しないでください。コマンドが有効な間にそれを実行した人が、あなたのトンネルへのトラフィックに応答することになります。
自動再接続 #
自動的に再接続をオンにすると、ダッシュボードは同じsshコマンドを、選択したシェル向けの小さなスクリプトで包みます。コマンドプロンプトの場合、スクリプトはpowershell -NoProfile -EncodedCommand …という1行で提供されます。スクリプトの動作はどのシェルでも同じです。
sshが終了すると、待機してから再度起動します。待機時間は約10秒から始まり、失敗するたびに2倍になって、最大で約2分になります。- 60秒以上続いた接続は成功とみなされ、待機時間がリセットされます。
- 60秒未満で終了した試行が8回連続すると停止し、
SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel.と表示します。
再接続では同じコマンドが再利用されます。そのため、ネットワークが一時的に途切れた場合には有効ですが、ダッシュボードでトンネルを停止した場合や上限に達した場合には機能しません。その場合、スクリプトは再試行を諦めるため、新しいコマンドが必要です。
コマンドの有効期間 #
- 初回使用前:コマンドは、発行時にダッシュボードが示す時間内に実行する必要があります。それを過ぎると、ポートの割り当ては期限切れになります。
- 使用中:1つのトンネルにつきSSHセッションは1つです。最初のコマンドが接続されている間は、同じコマンドの2つ目は拒否されます。
- 接続が終了した後:ダッシュボードでトンネルが停止されておらず、上限にも達していなければ、同じコマンドで再び接続できます。
- 停止後:ダッシュボードで、または上限によりトンネルが停止された場合、そのコマンドは使えなくなります。SSHコマンドを表示をもう一度開いて、新しいコマンドを取得してください。
ダッシュボードがコマンドを発行するのは、トンネルが停止しているときだけです。新しいコマンドでは、サーバーポートが変わることがあります。無料プランでは、新しいコマンドのたびに新しいポートが割り当てられます。TCPトンネルではそのポートが公開アドレスの一部になるため、新しいコマンドをリクエストした後は、ターミナルの出力かトンネル一覧でアドレスを確認してください。トンネルのアクティビティログには、この変更がServer port changed to "…" for SSH.として記録されます。
制限 #
- 無料プランのセッション制限。SSHで開始したトンネルにも、クライアントで開始したトンネルと同じルールが適用されます。無料プランでは、TCPトンネルは30分後に停止し、再度開始できます。HTTPトンネルに時間制限はありません。30分は、コマンドが最初に接続した時点から数えます。同じコマンドで再接続しても、カウントは最初からにはなりません。TCPセッションが制限に達すると、サーバーはメッセージ
Session time limit reached. Get a new SSH command from the panel.とともにSSH接続を閉じます。プランと残高をご覧ください。 - 帯域幅。トラフィックは、ほかのトンネルのトラフィックと同様に帯域幅として消費されます。残りの帯域幅がない場合、コマンドは発行されず、実行中のセッションもサーバーがメッセージ
Bandwidth limit reached. Get a new command after bandwidth is available.とともに閉じます。 - リバースフォワードのみ。SSHエンドポイントが受け付けるのは、コマンドに含まれる1つのフォワードだけです。Localtonetサーバー上のシェルや、ほかの種類のフォワードは利用できません。
- 1コマンドにつき1トンネル。複数のトンネルを実行するには、トンネルごとにコマンドをリクエストし、それぞれ別のターミナルで実行します。
ダッシュボードでの表示 #
コマンドが接続されている間、トンネルは開始済みと表示され、リクエストは通常どおりログに表示されます。コマンドが接続すると、トンネルのアクティビティログにTunnel started over SSH.と記録されます。ログと検査をご覧ください。
トラブルシューティング #
ダッシュボードのメッセージ #
| メッセージ | 対処方法 |
|---|---|
| SSHコマンドをリクエストする前に、トンネルを停止してください。 | トンネルがLocaltonetクライアントで実行されています。停止してから、もう一度SSHコマンドを表示を選んでください。 |
| 新しいコマンドをリクエストする前に、現在のSSHトンネルを停止してください。 | トンネルがまだSSHで開始されているか、直前までSSHセッションが有効でした。実行中のsshコマンドを終了し、トンネルの停止を選んでから、もう一度お試しください。 |
| 作成したAuthTokenで、このトンネルにクライアントが接続しています。新しいAuthTokenを作成してください。 | トンネルのトークンでLocaltonetクライアントがサインインしています。そのクライアントを停止するか、マイトークンで別のトークンを作成して、このトンネルに使用してください。 |
| トンネルを開始するための残り帯域幅が不足しています。 | 帯域幅を使い切っています。プランと残高をご覧ください。 |
| この機能はこのプロトコルの種類では利用できません。 | このトンネルはHTTPまたはTCPトンネルではありません。 |
| この機能はこのサーバーでは利用できません。トンネルを別のサーバーに移動してください。 | このトンネルのサーバーはSSHコマンドに対応していません。別のサーバーでトンネルを作成してください。 |
| トンネルの操作が進行中です。少し待ってから再度お試しください。 | 数秒待ってから、もう一度お試しください。 |
| 新しいサーバーポートを割り当てられませんでした。 | もう一度お試しください。それでも失敗する場合は、別のサーバーでトンネルを作成してください。 |
| SSHポートを保存できませんでした。もう一度お試しください。 | もう一度お試しください。 |
ターミナルのメッセージ #
サーバーがセッションを閉じるとき、理由として次のいずれかのメッセージを送信します。理由の表示のされ方は、お使いのsshクライアントによって異なります。
| メッセージまたは症状 | 原因と対処方法 |
|---|---|
sshがすぐに終了し、認証エラー(通常はPermission denied)が表示される | Localtonetがコマンドを受け付けませんでした。コマンドが時間内に実行されなかった、発行後にトンネルが停止された、または上限に達した、同じコマンドの別のセッションがすでに接続されている、コピー中にテキストが変更された、などが考えられます。ダッシュボードで新しいコマンドを取得し、そのまま貼り付けてください。 |
Port mismatch. Get a new SSH command from the panel. | -Rの後のサーバーポートが、Localtonetが割り当てたものと異なっています。コマンドは発行されたとおりに使用してください。 |
Session time limit reached. Get a new SSH command from the panel. | 無料プランでのTCPトンネルの30分セッションが終了しました。再び開始するには、新しいコマンドをリクエストしてください。 |
Bandwidth limit reached. Get a new command after bandwidth is available. | 帯域幅を使い切っています。 |
Session stopped. Get a new SSH command from the panel. | トンネルが停止されました。たとえば、ダッシュボードから停止されました。 |
接続のタイムアウト、またはConnection refused | マシンがポート223でサーバーに到達できません。ファイアウォールでポート223への外向きTCP接続を許可するか、別のネットワークから試してください。 |
| トンネルは有効だが、訪問者にエラーが表示される | sshは接続されていますが、サービスに到達できません。サービスが動作していること、トンネルのローカルIPアドレスとローカルポートが正しいことを確認してください。これらを変更した後は、古いコマンドに古い値が残っているため、新しいコマンドをリクエストしてください。 |