ssh -L の基本構文

構文
ssh -L [ローカルのアドレス:]ローカルのポート:転送先ホスト:転送先ポート ユーザー@SSHサーバー

ポイントは、「転送先ホスト」はSSHサーバーから見た名前・アドレスだということだ。localhost と書けばSSHサーバー自身を指し、RDSのエンドポイント名を書けばSSHサーバーからRDSへ接続する。

オプション意味
-Nリモートでコマンドを実行しない(転送専用にする)
-f認証後にバックグラウンドへ回る(macOS / Linux)
-i秘密鍵ファイルを指定する
-o ServerAliveInterval=6060秒ごとに生存確認を送り、無通信での切断を防ぐ
-o ExitOnForwardFailure=yesローカルポートが使用中などで転送に失敗したら、接続を終了する

踏み台サーバー経由でRDSへ

パブリックサブネットの踏み台EC2(パブリックIPあり、22番を自社のIPに限定して開放)を経由して、プライベートサブネットのRDSへ転送する例。

RDS for PostgreSQL を localhost:15432 に転送
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.10

RDSのセキュリティグループでは、踏み台EC2のセキュリティグループからの5432番を許可しておく。

⚠️ 踏み台方式のリスク

  • 22番がインターネットに見えるため、送信元IPの制限が緩いと総当たり攻撃の対象になる
  • SSHキーを人に配る必要があり、退職者・異動者のキーの回収が漏れやすい
  • 踏み台EC2のOSパッチ適用・監視という運用が増える

~/.ssh/config にまとめる

毎回長いコマンドを打たずに済むよう、設定ファイルに LocalForward として書いておく。

~/.ssh/config
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:5432
使い方
ssh -N bastion-dev

SSH 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番開放を削除できる。

~/.ssh/config(macOS / Linux)
Host i-* mi-*
    ProxyCommand sh -c "aws ssm start-session --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"
%USERPROFILE%\.ssh\config(Windows)
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 もそのまま使える。

インスタンスID宛てにSSHしつつRDSを転送
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 のほうが手間が少ない。

~/.ssh/config(SSH over SSM + 複数転送)
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:8080

Host の照合は 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! と出たら、鍵ファイルのアクセス権を自分だけに絞る
PowerShell:鍵ファイルのアクセス権を自分だけにする
icacls .\app.pem /inheritance:r
icacls .\app.pem /grant:r "$($env:USERNAME):(R)"
  • バックグラウンド実行:Windowsの ssh では -f が期待どおりに動かないことがあるため、専用のターミナルを開いて -N で実行しておくのが確実

どれを選ぶか

Q. 22番をインターネットに公開している踏み台があるか?
 ├─ Yes → SSH over SSM へ移行し、パブリックIPと22番開放を削除
 └─ No → Q2 へ

Q2. 必要なのはDBなどへのポートフォワードだけか?
 ├─ Yes(1〜2ポート)→ SSMのリモートホスト転送(PART 02)
 └─ scp・Remote-SSH・多数ポートの同時転送も必要 → SSH over SSM

✅ 次の記事では…

PART 05 では、つながらないときのエラー別の対処法と、チームで運用するためのTipsをまとめる。

→ PART 05 — トラブルシューティングと運用Tipsへ