~/.ssh/configで踏み台経由のSSH接続を楽にする設定メモとWindowsの権限エラー対策
目次
開閉
検証環境やステージングサーバーにSSH接続するとき、ターミナルで毎回こういう長いコマンドを打ち直したり、コマンド履歴から掘り起こしたりするのは地味に面倒です。
ssh -i ~/.ssh/my-special-key.pem -p 2222 ec2-user@198.51.100.42
さらに踏み台サーバー(Bastion)を経由しないと入れない構成だと、踏み台にログインしてからもう一度内部サーバーへSSHするという二段階の手間がかかります。
こういう接続情報は一度 ~/.ssh/config(Windowsなら %USERPROFILE%\.ssh\config)にまとめておくと、ssh dev-web みたいな短い名前だけで繋がるようになります。手元のMac(macOS 15.0 Sequoia)とWindows(Windows 11 Pro 24H2 / OpenSSH 9.x)の両方で普段使っている設定と、Windowsで必ず一度は引っかかる権限エラーの直し方をまとめました。
$ ssh -V
OpenSSH_for_Windows_9.5p2, LibreSSL 3.8.2
基本のエイリアスと IdentitiesOnly yes
まずは接続先に短い名前を付けて、IPアドレス・ユーザー名・ポート・秘密鍵を紐づける基本形です。
Host dev-web
HostName 198.51.100.42
User ec2-user
Port 2222
IdentityFile ~/.ssh/id_ed25519_company
IdentitiesOnly yes
これで ssh dev-web だけで繋がるようになります。地味に大事なのが最後の IdentitiesOnly yes で、これを入れ忘れるとSSHエージェントが持っている鍵を片っ端から試してしまい、サーバー側から Too many authentication failures で弾かれることがあります。秘密鍵を複数使い分けている環境ではほぼ必須の1行です。
踏み台経由を1コマンドにする ProxyJump
プライベートサブネット内のDBサーバーなど、踏み台サーバーを経由しないと入れない環境では ProxyJump を使います。昔は ProxyCommand ssh -W %h:%p bastion のように書いていましたが、OpenSSH 7.3以降なら ProxyJump だけで済みます。
# 踏み台サーバー
Host bastion
HostName bastion.example.com
User admin
IdentityFile ~/.ssh/id_ed25519_bastion
IdentitiesOnly yes
# 踏み台経由で入る内部DBサーバー
Host internal-db
HostName 10.0.2.15
User postgres
IdentityFile ~/.ssh/id_ed25519_internal
ProxyJump bastion
IdentitiesOnly yes
この状態で ssh internal-db を叩くと、手元のOpenSSHが自動で踏み台へのトンネルを張って内部サーバーまで繋いでくれます。実際に -v を付けて確認すると、踏み台認証のあとそのまま内部へ転送されているのが分かります。
$ ssh -v internal-db
OpenSSH_for_Windows_9.5p2, LibreSSL 3.8.2
debug1: Connecting to internal-db [10.0.2.15] via proxyjump "bastion"
debug1: Setting up proxy jump to bastion.example.com:22
debug1: Authenticated to bastion.example.com using "publickey".
debug1: Connection to port 22 forwarding to 10.0.2.15 port 22
debug1: Authenticated to 10.0.2.15 using "publickey".
Welcome to PostgreSQL Internal Node (Ubuntu 24.04 LTS)
postgres@internal-node:~$Windowsでよく出る「Bad permissions」エラーの直し方
自宅のWindowsマシンで新しく .ssh/config や秘密鍵を作ったとき、よくこのエラーで止められます。
Bad owner or permissions on C:\\Users\\devuser/.ssh/config
fatal: Could not read from remote repository.
あるいは秘密鍵側でこんなエラーが出ます。
Permissions for 'id_ed25519' are too open.
It is required that your private key files are NOT accessible by others.
Linuxの chmod 600 と同じ理由で、「自分以外のユーザー(EveryoneやAuthenticated Users等)に読み取り権限が付いたままのファイル」をOpenSSHが拒否している状態です。Windowsは親フォルダのACLを継承してしまうため、PowerShellから icacls で継承を切って自分のユーザーだけに権限を絞り直すのが一番手っ取り早いです。
# 親フォルダからの権限継承を切る
icacls "$HOME\.ssh\config" /inheritance:r
icacls "$HOME\.ssh\id_ed25519_*" /inheritance:r
# 現在のユーザーだけにフルコントロールを付ける
icacls "$HOME\.ssh\config" /grant:r "$($env:USERNAME):(F)"
icacls "$HOME\.ssh\id_ed25519_*" /grant:r "$($env:USERNAME):(F)"
これだけで、MacやLinuxと同じようにエラーなくSSHが通るようになります。
放置したときのタイムアウト切断を防ぐ共通設定
ドキュメントを調べたり少し席を外したりして戻ってきたとき、Write failed: Broken pipe で接続が切れている地味なストレスも、Host * の共通設定でかなり減らせます。
Host *
ServerAliveInterval 60
ServerAliveCountMax 3
TCPKeepAlive yes
AddKeysToAgent yes
ServerAliveInterval 60 で60秒ごとに応答確認パケットを送り、ServerAliveCountMax 3 で3回無応答なら切断とみなします。AddKeysToAgent yes も入れておくと、一度使った秘密鍵が ssh-agent に乗るのでパスフレーズを何度も打たずに済みます。
まとめ
~/.ssh/config は一度ベースを作っておけば、新しいサーバーが増えたときも数行足すだけで済みます。
- 長いオプションやIPはエイリアス化し、
IdentitiesOnly yesを忘れない - 踏み台経由は
ProxyJumpを使って手元の鍵だけで繋ぐ - Windowsで権限エラーが出たら
icaclsで継承を切って自分専用にする - 末尾の
Host *にServerAliveIntervalを入れて無通信切断を防ぐ
MacとWindowsを行き来するときは、SSH設定と一緒にターミナル自体の設定も揃えておくと切り替えが楽になります。WezTermでの設定統一は以下の記事にまとめています。
関連記事(開発環境)
「開発環境」の記事をもっと見るリンク切れや画像肥大化をデプロイ前に防ぐ静的サイトの自動品質チェック設計
2026/11/18
Playwrightでレスポンシブとダークモードを一括撮影し比較レポートを生成する
2026/11/15
本番DBをそのまま使わない。開発・ステージング環境向けデータマスキング自動化パイプライン
2026/11/05