HN 日本語サマリー

← 一覧へ戻る
インフラ・DevOps

SSHトンネルの実践ガイド: ローカルおよびリモートポートフォワーディング

A Practical Guide to SSH Tunnels: Local and Remote Port Forwarding (labs.iximiuz.com)

42 pointsby signa1112 コメント

要約

このガイドは、SSHトンネルの基本的な概念と、ローカルポートフォワーディングおよびリモートポートフォワーディングの具体的な使用方法を視覚的に分かりやすく解説しています。SSHが今日の開発環境でどのように内部VPCエンドポイントへのアクセス、リモート開発VMのポート公開、ローカルサーバーの外部公開などに役立つかを、実用的なコマンド例とともに紹介しています。

全文翻訳

SSHトンネルの実践ガイド:ローカルおよびリモートポートフォワーディング

SSHは、今日でも広く使われている古い技術のもう一つの例です。来四半期には廃止される運命にある多数のクラウドネイティブツールやAIエージェントフレームワークを習得するよりも、いくつかのSSHのトリックを学ぶ方が、長期的にはより有益かもしれません。

この技術で私が最も気に入っている部分の一つがSSHトンネルです。標準的なツールだけを使って、しばしば単一のコマンドで、以下のことが実現できます。

そして、もっとたくさん 😍

しかし、SSHトンネルを毎日使っているにもかかわらず、正しいコマンドを思い出すのにいつも時間がかかります。ローカルトンネルかリモートトンネルか?フラグは何を使うのか?local_port:remote_portなのか、それとも逆か?そこで、これを完全に理解することに決め、一連のラボとビジュアルチートシートを作成しました。

[画像: SSH Port Forwarding Cheat Sheet.]

注意

このチュートリアルのラボは、4つのホストが3つのネットワークに接続されたアタッチされたプレイグラウンドで実行されます。

  • internal - ホームネットワーク 192.168.0.0/24 上のデバイス(ホームラボボックス、NAS、プリンター)。パブリックネットワークからは到達できません。
  • local - あなたのワークステーション。ホームネットワーク 192.168.0.0/24 とパブリックネットワーク 203.0.113.0/24 の両方に接続されています。
  • remote - パブリックネットワーク 203.0.113.0/24 上の公開されているバステーション/ゲートウェイで、プライベートVPC 172.16.0.0/24 にも接続されています。
  • private - VPC 172.16.0.0/24 上の内部専用サービス(データベース、OpenSearchクラスターなど)。パブリックネットワークからは到達できません。

localからremoteへは、ホスト名またはIPアドレスでsshできます。localのホストキーはremoteマシンですでに信頼されています。

ssh remote
ssh 203.0.113.30

ローカルポートフォワーディング

最もよく使うものから始めましょう。多くの場合、リモートマシンのlocalhostまたはプライベートインターフェイスでリッスンしているサービスに、パブリックIP経由でSSH接続できるものの、ローカルマシンからそのポートにアクセスする必要があることがあります。典型的な例をいくつか挙げます。

  • お気に入りのUIツールを使って、ラップトップからプライベートなリモートデータベース(MySQL、Postgres、Redisなど)にアクセスする。
  • ブラウザを使って、プライベートネットワークにのみ公開されているWebアプリケーションにアクセスする。
  • サーバーのパブリックインターフェイスに公開せずに、ラップトップからコンテナのポートにアクセスする。

上記のすべてのユースケースは、単一のsshコマンドで解決できます。

ssh -L [local_addr:]local_port:remote_addr:remote_port [user@]sshd_addr

-Lフラグは、ローカルポートフォワーディングを開始することを示します。実際には次のことを意味します。

  • あなたのローカルマシン上で、SSHクライアントはlocal_portでリッスンを開始します(おそらくlocalhostですが、それは設定によります - GatewayPorts 設定を確認してください)。
  • このポートへのすべてのトラフィックは、SSH接続したリモートマシンから到達するremote_addr:remote_portに転送されます。

これは図で示すと以下のようになります。

[画像: SSH Tunnels visualized - local port forwarding.]

ヒント

ポートフォワーディングセッションをバックグラウンドで実行するには、ssh -f -N -Lを使用します。

ラボ1:ローカルポートフォワーディングのためのSSHトンネルの使用 👨‍🔬

このラボでは、上記の図のセットアップを再現します。remoteホストは127.0.0.1:80にバインドされたWebサーバーを実行しており、それをlocalワークステーションからアクセスしたいと考えています。

サービスはループバックインターフェイスにバインドされているため、ネットワーク経由ではアクセスできません。ローカルホストから、remoteホストのパブリックアドレスにアクセスしてみてください。

curl 203.0.113.30:80  # remote.public
curl: (7) Failed to connect to 203.0.113.30 port 80 after 0 ms: Could not connect to server

しかし、リモートホストの内部からは、全く同じサービスが正常に動作します。

curl localhost:80
Hello from the remote host (localhost-only service).

そして、ここがトリックです: ローカルホストに戻り、リモートのlocalhost:80をローカルのlocalhost:8080にローカルポートフォワーディングを使用してバインドします。

ssh -f -N -L 8080:localhost:80 203.0.113.30

これで、ワークステーションのローカルポートでWebサービスにアクセスできます。

curl localhost:8080
Hello from the remote host (localhost-only service).

より冗長ですが(より明示的で柔軟な)同じ目標を達成する方法です。

ssh -f -N -L localhost:8080:localhost:80 203.0.113.30
#            local          remote       via

読むだけでなく、やって学ぶ

無料アカウントにサインアップして、このページで直接VMプレイグラウンドを開始し、進捗を追跡し、新しい学習教材の通知を受け取りましょう。

無料サインアップ

バスティオンホストを使用したローカルポートフォワーディング

最初は明白ではないかもしれませんが、ssh -Lコマンドは、ローカルポートをSSHサーバー自体だけでなく、任意のマシン上のリモートポートに転送することを許可します。remote_addrとsshd_addrが同じ値である場合とそうでない場合があることに注意してください。

ssh -L [local_addr:]local_port:remote_addr:remote_port [user@]sshd_addr

プライベートな宛先にアクセスするために使用されるリモートSSHサーバーは、通常バスティオンまたはジャンプホストと呼ばれます。これが、私がこのシナリオを頭の中で視覚化する方法です。

[画像: SSH Tunnels visualized - local port forwarding with a bastion host.]

私は上記のトリックを、私のラップトップからはアクセスできないがバスティオンホストからはアクセス可能なエンドポイントを呼び出すために頻繁に使用します(例:VPC内に完全にデプロイされたOpenSearchクラスターやその他のサービスに接続するために、プライベートインターフェイスとパブリックインターフェイスを持つEC2インスタンスを使用する)。

ラボ2:バスティオンホストを使用したローカルポートフォワーディング 👨‍🔬

このラボでは、上記の図のセットアップを再現します。リモートターゲットサービスは、即席のVPCネットワーク(172.16.0.40:80)内のprivateホストで実行されており、以前のremoteホストがそれに到達できる公開されているバスティオン(ジャンプホスト)として機能します。

localワークステーションはVPCへのルートを持っていないため、privateホストに直接通信できません。ローカルホストから:

curl --connect-timeout 3 172.16.0.40:80  # private.vpc
curl: (28) Connection timed out after 3002 milliseconds

一方、remoteバスティオンはVPCに接続されており、privateホストに到達できます。そのため、ローカルポートをバスティオン経由でプライベートサービスに直接転送します。ローカルホストから:

ssh -f -N -L 8081:172.16.0.40:80 203.0.113.30

それが機能することを確認します - まだローカルホストで:

curl localhost:8081
Hello from the private VPC host (172.16.0.40).

転送ターゲット(172.16.0.40)とSSHサーバー(203.0.113.30)が異なるマシンであることに注意してください。 バスティオンは接続を受け入れ、私たちの代わりにプライベートホストへの2番目のホップを開きます。


より冗長ですが(より明示的で柔軟な)同じ目標を達成する方法です。

ssh -f -N -L localhost:8081:172.16.0.40:80 203.0.113.30
#            local          remote         via

ジャンプホスト経由でループバックポートへのローカルポートフォワーディング

ラボ2のバスティオントリックは便利で、コマンドも(比較的)覚えやすいですが、重大な制限があります。ssh -L local_port:remote_host:remote_port bastion_hostでは、SSHセッションはバスティオンで終了し、バスティオンがremote_host:remote_portへの2番目のホップを開きます。これは、プライベートサービスがバスティオンの外部ネットワークインターフェイスにバインドされている場合にのみ機能します(つまり、バスティオンが外部からそれに到達できる場合)。

しかし、サービスは127.0.0.1にバインドされることもあります - データベース管理コンソール、メトリクスまたはプロファイリングエンドポイント、アプリケーションのデバッグポートなど。ループバックにバインドされたポートは、ホスト自身のループバックでのみ応答するため、バスティオンもネットワーク上の他のどのマシンもそれに到達できません。転送はリモートホスト自体で解決される必要があります。

その方法は、ssh -Lコマンドでremote_hostを宛先アドレスとして使用することですが、リモートがバスティオン経由でのみ到達可能な場合、追加のフラグ -J bastion_host が必要になります。

SSHセッションをバスティオンで終了する代わりに、-J (ProxyJump)はバスティオンを経由してジャンプし、セッションをリモートホストで終了します。その後、-Lの宛先はリモートの観点から解決されるため、localhostはリモート自身のループバックを意味します。

ssh -J [user@]jumphost -L [local_addr:]local_port:localhost:remote_port [user@]remote_host

バスティオンはジャンプのためのバイトをリレーするだけです - あなたの実際のSSHセッションはローカルとリモートホスト間で確立され、リモートのループバックにアクセスできるようになります。

[画像: SSH Tunnels visualized - local port forwarding to a loopback port via a jump host.]

これは、サービスが127.0.0.1にバインドする、ネットワークからは見えないデバッグまたは管理ポートにアクセスする方法です。ポートはネットワーク全体から見えなくても、ラップトップからの単一のssh -J ... -Lコマンドで、あたかもサービスがすぐ隣で実行されているかのようにローカルマシンのローカルポートに表示されます。

ラボ3:ジャンプホスト経由でループバックポートへのローカルポートフォワーディング 👨‍🔬

このラボでは、ラボ2のバスティオントポロジーを再利用しますが、今回はprivateホストはループバック 127.0.0.1:9000にバインドされた2番目のWebサーバーも実行しています - ネットワークに公開されるべきではない内部デバッグまたはメトリクスポートと考えてください。

ラボ2のアプローチは、プライベートホストの外部ネットワークアドレスに転送します。バスティオンはそのホップを開くことができますが、172.16.0.40:9000でリッスンしているものはありません - デバッグポートはネットワークインターフェイスではなくループバック上にあります。そのため、バスティオン経由の-L 8082:172.16.0.40:9000転送では、接続拒否しか得られません。

代わりに、SSHセッションをバスティオンを経由して(-J bastionを使用)ジャンプさせ、privateホストで終了させ、localhost:9000に転送する必要があります。これは、privateホストが自身のループバックに解決します。ローカルホストから:

ssh -f -N -J 203.0.113.30 -L 8082:localhost:9000 172.16.0.40
#            jump host            target_port    target_host

それが機能することを確認します - まだローカルホストで:

curl localhost:8082
Hello from the private VPC host's loopback-only debug port (127.0.0.1:9000).

リモートポートフォワーディング

もう一つの一般的な(しかしかなり逆の)シナリオは、ローカルサービスを一時的に外部に公開したい場合です。もちろん、そのためには公開されているイングレスゲートウェイサーバーが必要です。そして良いニュースは、SSHデーモンが動作している公開されているサーバーならどれでも、そのようなゲートウェイとして使用できるということです。

ssh -R [remote_addr:]remote_port:local_addr:local_port [user@]gateway_addr

上記のコマンドは、ssh -Lの対応物よりも複雑に見えません。しかし、落とし穴があります...

デフォルトでは、上記のSSHトンネルはゲートウェイのlocalhostのみをリモートアドレスとして使用することを許可します。 言い換えれば、あなたのローカルポートはゲートウェイサーバーの内部からのみアクセス可能になり、これはおそらくあなたが実際に必要としているものではありません。例えば、私は通常、ローカルサービスをパブリックインターネットに公開するためにゲートウェイのパブリックアドレスをリモートアドレスとして使用したいと考えています。そのためには、SSHサーバーはGatewayPorts yes設定で構成されている必要があります。

リモートポートフォワーディングが使用できるのは次のとおりです。

リモートポートフォワーディングは次のように視覚化できます。

[画像: SSH Tunnels visualized - remote port forwarding.]

ヒント

ポートフォワーディングセッションをバックグラウンドで実行するには、ssh -f -N -Rを使用します。

ラボ4:リモートポートフォワーディングのためのSSHトンネルの使用 👨‍🔬

このラボでは、上記の図のセットアップを再現します。localワークステーションは127.0.0.1:80にバインドされたWebサーバーを実行しており、それを公開されているremoteゲートウェイ経由で外部に公開したいと考えています。

サービスはループバックインターフェイスにバインドされているため、現時点ではlocalマシン自身以外は誰もそれにアクセスできません。リモートマシンからアクセスしてみてください。

curl --connect-timeout 3 203.0.113.20:80  # local.public
curl: (7) Failed to connect to 203.0.113.20 port 80 after 0 ms: Could not connect to server

リモートゲートウェイを介して公開し、privateホストから消費したいと考えています。remoteゲートウェイのsshd_configにはすでにGatewayPorts yesが含まれているため、すべてのインターフェイス(0.0.0.0)でリッスンするように依頼し、トラフィックを私たちに転送させることができます。ただし、localマシンが最初にトンネルを確立する必要があります。

ローカルホストから、リモートポートフォワーディングを開始します。

ssh -f -N -R 0.0.0.0:8080:localhost:80 203.0.113.30
#            remote       local        via

これでローカルWebサービスがゲートウェイのインターフェイスに公開されました。VPC経由でremoteゲートウェイに到達できる3番目のマシンであるプライベートホストから確認してみましょう。

curl 172.16.0.30:8080  # remote.vpc
Hello from your local workstation (localhost-only service).

ホームまたはプライベートネットワークへのリモートポートフォワーディング

ローカルポートフォワーディングと同様に、リモートポートフォワーディングにもバスティオンまたはジャンプホストモードがあります。しかし今回は、SSHクライアント(例:開発用ラップトップ)を持つマシンがジャンプホストの役割を果たします。特に、リモートSSHサーバー(イングレスゲートウェイとして機能)を通じて、自宅(またはプライベート)ネットワークのポートを外部に公開することを可能にします。

ssh -R [remote_addr:]remote_port:local_addr:local_port [user@]gateway_addr

単純なリモートSSHトンネルとほぼ同じように見えますが、local_addr:local_portのペアは、自宅ネットワーク内のデバイスのアドレスになります。これは、図で次のように描画できます。

[画像: SSH Tunnels visualized - remote port forwarding to home network.]

私は通常、ラップトップをシンクライアントとして使用し、実際の開発はリモートサーバーで行います。時々、そのようなリモートサーバーは自宅のネットワーク内にあり、インターネットへのアクセスがないか制限されている(追加の分離のため)場合があります。その場合、ラップトップが内部開発サーバーとリモートSSHサーバー(イングレスゲートウェイ)の両方にアクセスできることを利用して、自宅サーバーのサービスをパブリックインターネットに公開するためにリモートポートフォワーディングに依存することがあります。

ラボ5:ホーム/プライベートネットワークからのリモートポートフォワーディング 👨‍🔬

このラボでは、上記の図のセットアップを再現します。公開したいサービスは、隔離されたホームネットワーク(192.168.0.10:80)内のinternalホストで実行されています。私たちのlocalワークステーションはホームネットワークに到達でき、公開されているremoteゲートウェイへのSSHアクセスも持っているため、ジャンプホストの役割を果たします。

localホストはホームネットワーク経由でinternalサービスに到達できます。ローカルホストから:

curl 192.168.0.10:80  # internal.home
Hello from the internal home-network host (192.168.0.10).

しかし、外部からはinternalデバイスは見えません。リモートホストからアクセスしてみてください。

curl --connect-timeout 3 192.168.0.10:80  # internal.home
curl: (28) Connection timed out after 3001 milliseconds

remoteホストはホームネットワークへのルートを持っていないため、リクエストは単純にタイムアウトします。

次に、ローカルホストから、remoteゲートウェイからinternalデバイスへのリモートポートフォワーディングを開始します。転送ターゲット(192.168.0.10)はSSHクライアント、つまりlocalホストの観点から解決されます。

ssh -f -N -R 0.0.0.0:8081:192.168.0.10:80 203.0.113.30
#            remote       local           via

最後に、ホームネットワークサービスがゲートウェイでアクセス可能になったことを確認します - VPC経由でゲートウェイに到達するプライベートホストから:

curl 172.16.0.30:8081  # remote.vpc
Hello from the internal home-network host (192.168.0.10).

ダイナミックローカルポートフォワーディング

このフォワーディングモードはクライアントにとって透過性は低いですが、通常のローカルポートフォワーディングよりも大幅に柔軟性があります。ローカルポートを単一のリモート宛先に接続する(ssh -Lが行うように)のではなく、ダイナミック(ローカル)ポートフォワーディングはSSHクライアントをローカルのSOCKSプロキシに変えます。SOCKSを話せるアプリケーションは、接続ごとに実際の宛先ホストとポートを選択して、それを介してトラフィックを送信できます。これらのトラフィックはSSHサーバーに送信され、そこで宛先が解決され、接続が確立されます。

ssh -D [local_addr:]local_port [user@]sshd_addr

-Dフラグが使用されると、あなたのマシンのSSHクライアントはlocal_port(デフォルトではlocalhost上)でリッスンするSOCKSプロキシを開始します。プロキシを介して行われる各接続は、SOCKSクライアントが要求する任意の場所に転送され、sshd_addrマシンから到達します。

言い換えれば、ssh -Lのようなものですが、remote_addr:remote_portを事前に指定する必要はありません。なぜなら、SOCKSプロトコルでは、各接続の開始時(ペイロードの直前に送信される数バイトを介して)に宛先を指定できるからです。1つの(ローカル)プロキシポートで、リモートSSHサーバーから到達可能なすべてのホストとポートにアクセスできます。

[画像: SSH Tunnels visualized - dynamic local port forwarding (SOCKS proxy).]

ダイナミックポートフォワーディングは次のように使用できます。

  • 個別のサービスごとのトンネルをセットアップせずに、バスティオン経由でプライベートネットワーク内のAPIを呼び出す。
  • 単一のジャンプホストを介して、リモートネットワーク内の内部Webアプリケーションを閲覧する。
  • 1つのEC2インスタンスを介して、ラップトップからVPCエンドポイントのフリートに到達する。

ヒント

SOCKSプロキシをバックグラウンドで実行するには、ssh -f -N -Dを使用します。

ラボ6:ダイナミックポートフォワーディングのためのSSHトンネルの使用 👨‍🔬

これはラボ2のバスティオンシナリオですが、今回はトンネルを単一の宛先にピン留めしません。

まず、ローカルマシンからprivate宛先に到達できないことを確認しましょう。

curl --connect-timeout 3 172.16.0.40:80  # private.vpc
curl: (28) Connection timed out after 3002 milliseconds

次に、ローカルホストで、remoteホスト経由でSOCKSプロキシを開始します。

ssh -f -N -D 1080 203.0.113.30  # remote.public

curlをプロキシに向けてprivate VPCサービスに到達させると、リクエストが通過します。

curl --socks5-hostname localhost:1080 172.16.0.40:80
#                      via            private.vpc
Hello from the private VPC host (172.16.0.40).

ssh -Lとは異なり、クライアント(この場合はcurl)はSOCKSを話せる必要があります(--socks5-hostnameフラグを参照)。

同じSOCKSプロキシは、remoteマシンが到達できる任意のホストに到達できます - 別のVPCホストを含みます - 個別のトンネルをセットアップせずに、private-2マシンに到達してみてください。

curl --socks5-hostname localhost:1080 172.16.0.50:80
#                      via            private-2.vpc
Hello from the second private VPC host (172.16.0.50).

ssh -Lを使用した場合、両方のプライベートホストに到達するには、2つの個別のトンネル(remote_addr:remote_portごとに1つ)が必要でした。単一のssh -Dプロキシは、バスティオンの後ろにあるネットワーク全体をカバーします。

ダイナミックリモートポートフォワーディング

ssh -Lにssh -Dというダイナミックな兄弟がいるのと同様に、ssh -Rコマンドにも独自のダイナミックモードがあります。-Rから固定の宛先を削除してポートのみを渡すと、OpenSSHはSSHサーバー自体をSOCKSプロキシに変えます。これは-Dの完全な鏡像です。今回はプロキシがゲートウェイ上にあり、それを介して行われる各接続はSSHクライアントにトンネルバックされ、クライアント側から到達する任意の場所に解決されます。

ssh -R [bind_address:]port [user@]gateway_addr

宛先のない-Rフラグは次のことを意味します。

  • リモートゲートウェイ上で、SSHサーバーはport(デフォルトではゲートウェイのlocalhost上、またはGatewayPorts yesがあればすべてのインターフェイス上)でリッスンするSOCKSプロキシを開始します。
  • プロキシを介して行われる各接続はSSHクライアントにトンネルバックされ、SOCKSクライアントが要求する任意の場所に転送され、クライアント側から到達します。

これは通常のssh -Rに似ていますが、local_addr:local_portを事前に選択する必要はありません。ゲートウェイ上の1つのプロキシは、SSHクライアントから到達可能なすべてのホストとポート(例えば、ホームネットワーク全体)を公開します。

[画像: SSH Tunnels visualized - dynamic remote port forwarding (SOCKS proxy).]

注意

リモートダイナミックフォワーディングには、クライアントでOpenSSH 7.6以降が必要です。通常のssh -Rと同様に、プロキシをゲートウェイの非ループバックアドレスにバインドするには、sshd_configでGatewayPorts yesが必要です。

ヒント

SOCKSプロキシをバックグラウンドで実行するには、ssh -f -N -Rを使用します。

ラボ7:リモートダイナミックポートフォワーディングのためのSSHトンネルの使用 👨‍🔬

これはラボ5のホームネットワークシナリオです。今回は単一のプロキシですべてをカバーしながら、localのみが到達できるデバイスを公開したいと考えています。

まず、プライベートマシンからinternalホストに到達できないことを確認しましょう。

curl 192.168.0.10:80  # internal.home
curl: (7) Failed to connect to 192.168.0.10 port 80 after 0 ms: Could not connect to server

次に、ローカルホストから、remoteゲートウェイをSOCKSプロキシに変え、それとのトンネルを確立します。

ssh -f -N -R 0.0.0.0:1080 203.0.113.30  # remote.public

接続を確認するために、プライベートホストから再度、ゲートウェイのプロキシを使用してinternalホームデバイスにアクセスします。

curl --socks5-hostname 172.16.0.30:1080 192.168.0.10:80
#                      via              internal.home
Hello from the internal home-network host (192.168.0.10).

同じプロキシは、SSHクライアント(local)が到達できるものすべてに到達できます - 自身のループバックサービスを含みます。

curl --socks5-hostname 172.16.0.30:1080 127.0.0.1:80
#                      via              local's localhost
Hello from your local workstation (localhost-only service).

まとめ

以下は簡単な要約と、SSHトンネリングコマンドを記憶するのに役立ついくつかの記憶術です。

  • ローカルポートフォワーディング (ssh -L) は、リモートサービスをローカルポートで利用可能にします。
  • リモートポートフォワーディング (ssh -R) は、ローカルサービスをリモートポートで利用可能にします。
  • ダイナミックローカルポートフォワーディング (ssh -D) は、ローカルsshクライアントをSOCKSプロキシに変えます。
  • ダイナミックリモートポートフォワーディング(宛先なしのssh -R)は、sshdサーバーをSOCKSプロキシに変えます。
  • ローカルポートフォワーディング (ssh -L) は、SSHクライアントが新しいポートでリッスンを開始することを意味します。
  • リモートポートフォワーディング (ssh -R) は、sshdサーバーが追加のポートでリッスンを開始することを意味します。
  • ローカルという言葉は、SSHクライアントマシンまたはそれにアクセス可能な内部ホストのいずれかを意味する場合があります。
  • リモートという言葉は、SSHサーバーマシン(sshd)またはそれにアクセス可能な任意のホストのいずれかを意味する場合があります。
  • 記憶術は、ssh -L local:remote と ssh -R remote:local であり、常に左側が新しいポートを開きます。

上記の資料が、SSHトンネルのマスターになるのに少しでも役立ったことを願っています 🧙

実践

これらの実践的な課題を解決して学習を強化しましょう。

リソース