~/.ssh/configで踏み台経由のSSH接続を楽にする設定メモとWindowsの権限エラー対策

~/.ssh/configで踏み台経由のSSH接続を楽にする設定メモとWindowsの権限エラー対策

公開: 2026/07/18
更新: 2026/11/18
目次
開閉

検証環境やステージングサーバーに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:~$
Lowom 編集長 編集長
CAUTION 踏み台サーバーに秘密鍵を置かない
踏み台へログインしてから内部に入る運用だと、つい踏み台のディスクに内部サーバー用の秘密鍵を置きたくなりますが、踏み台が侵害されたときのリスクが大きくなります。ProxyJumpを使えば、秘密鍵は手元のPCだけに置いたまま安全に多段接続できます。

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での設定統一は以下の記事にまとめています。

Lowom 編集長
この記事を書いた人:Lowom 編集長 現役Webエンジニア

都内IT企業に勤める業界20年のWebエンジニア。業務効率化・自動化スクリプトや快適な開発環境の構築、厳選したツール・ガジェットの活用法など、手元で実際に検証したリアルな一次情報をお届けします。