ssh -L の基本構文
ssh -L [ローカルのアドレス:]ローカルのポート:転送先ホスト:転送先ポート ユーザー@SSHサーバーポイントは、「転送先ホスト」はSSHサーバーから見た名前・アドレスだということだ。localhost と書けばSSHサーバー自身を指し、RDSのエンドポイント名を書けばSSHサーバーからRDSへ接続する。
| オプション | 意味 |
|---|---|
-N | リモートでコマンドを実行しない(転送専用にする) |
-f | 認証後にバックグラウンドへ回る(macOS / Linux) |
-i | 秘密鍵ファイルを指定する |
-o ServerAliveInterval=60 | 60秒ごとに生存確認を送り、無通信での切断を防ぐ |
-o ExitOnForwardFailure=yes | ローカルポートが使用中などで転送に失敗したら、接続を終了する |
踏み台サーバー経由でRDSへ
パブリックサブネットの踏み台EC2(パブリックIPあり、22番を自社のIPに限定して開放)を経由して、プライベートサブネットのRDSへ転送する例。
ssh -i ~/.ssh/bastion.pem -N \
-o ServerAliveInterval=60 -o ExitOnForwardFailure=yes \
-L 15432:mydb.xxxxxxxxxxxx.ap-northeast-1.rds.amazonaws.com:5432 \
ec2-user@203.0.113.10RDSのセキュリティグループでは、踏み台EC2のセキュリティグループからの5432番を許可しておく。
⚠️ 踏み台方式のリスク
- 22番がインターネットに見えるため、送信元IPの制限が緩いと総当たり攻撃の対象になる
- SSHキーを人に配る必要があり、退職者・異動者のキーの回収が漏れやすい
- 踏み台EC2のOSパッチ適用・監視という運用が増える
~/.ssh/config にまとめる
毎回長いコマンドを打たずに済むよう、設定ファイルに LocalForward として書いておく。
Host bastion-dev
HostName 203.0.113.10
User ec2-user
IdentityFile ~/.ssh/bastion.pem
ServerAliveInterval 60
ExitOnForwardFailure yes
LocalForward 15432 mydb.xxxxxxxxxxxx.ap-northeast-1.rds.amazonaws.com:5432ssh -N bastion-devSSH over SSM で22番を閉じる
SSHの使い勝手(scp、-L、VS Code の Remote-SSH など)を残しつつ、22番ポートの公開をやめる方法が「SSH over SSM」だ。SSHの通信を Session Manager のトンネル(SSMドキュメント AWS-StartSSHSession)に通す。
前提条件は PART 02 と同じ(SSM Agent・IAMロール・SSMへの経路・ローカルの Session Manager プラグイン)。踏み台EC2はプライベートサブネットに移し、パブリックIPとセキュリティグループの22番開放を削除できる。
Host i-* mi-*
ProxyCommand sh -c "aws ssm start-session --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"Host i-* mi-*
ProxyCommand C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe "aws ssm start-session --target %h --document-name AWS-StartSSHSession --parameters portNumber=%p"これで、ホスト名にインスタンスIDを指定すれば Session Manager 経由でSSHできる。-L もそのまま使える。
ssh -i ~/.ssh/app.pem -N \
-L 15432:mydb.xxxxxxxxxxxx.ap-northeast-1.rds.amazonaws.com:5432 \
ec2-user@i-0123456789abcdef0💡 IAMポリシーでドキュメントを許可する
接続するユーザーのIAMポリシーで、ssm:StartSession の対象に arn:aws:ssm:<region>::document/AWS-StartSSHSession を含める。SSHのキーとIAMの両方で二重に制御できる。
「ポートフォワードだけならSSMのリモートホスト転送で十分」なので、SSH over SSM が向いているのは scp や VS Code Remote-SSH も使いたい場合や、既存のSSH前提のツール・手順を活かしたい場合だ。
複数ポートを同時に転送する
SSHの利点は、1本の接続で複数のポートをまとめて転送できることだ。SSMのポートフォワードは1セッション1ポートなので、複数のDBやキャッシュを同時に使うなら SSH のほうが手間が少ない。
Host dev-tunnel
HostName i-0123456789abcdef0
User ec2-user
IdentityFile ~/.ssh/app.pem
ServerAliveInterval 60
ProxyCommand sh -c "aws ssm start-session --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"
LocalForward 15432 mydb.xxxxxxxxxxxx.ap-northeast-1.rds.amazonaws.com:5432
LocalForward 16379 my-redis.xxxxxx.0001.apne1.cache.amazonaws.com:6379
LocalForward 18080 localhost:8080Host の照合は ssh に渡した名前(ここでは dev-tunnel)で行われるため、HostName をインスタンスIDにしても上の Host i-* mi-* の ProxyCommand は適用されない。そのため、このブロックにも ProxyCommand を書いている(%h は HostName の値に置き換わる)。Windows では ProxyCommand を前述の PowerShell 版に置き換える。ssh -N dev-tunnel で3つのポートが同時に転送される。
Windowsで使うときの注意
- OpenSSHクライアントは標準搭載:Windows 10 / 11 では
sshコマンドがそのまま使える(設定は%USERPROFILE%\.ssh\config) - 秘密鍵のアクセス権エラー:
WARNING: UNPROTECTED PRIVATE KEY FILE!と出たら、鍵ファイルのアクセス権を自分だけに絞る
icacls .\app.pem /inheritance:r
icacls .\app.pem /grant:r "$($env:USERNAME):(R)"- バックグラウンド実行:Windowsの
sshでは-fが期待どおりに動かないことがあるため、専用のターミナルを開いて-Nで実行しておくのが確実