termal.in

← ブログ

~/.ssh/config ファイル:同じ SSH フラグを二度と打たない

· 更新 2026年11月12日 · Termalin Team sshssh-configproductivitytutorial

手短な答え: ~/.ssh/config を作り(chmod 600 しておく)、サーバーごとに HostName、User、Port、IdentityFile を書いた Host ブロックを用意します。これで ssh web1 が丸ごとのコマンドに展開され、scp、sftp、rsync、git も同じ別名を読みます。最初に一致した設定が使われるので、個別のホストを先に、広い Host * のデフォルトを最後に並べます。ProxyJump は踏み台ホスト(bastion)の向こうのホストに届き、ServerAliveInterval 30 はアイドルのセッションが切れるのを防ぎ、IdentitiesOnly yes は鍵を 1 つに固定して、厳格なサーバーに接続を拒まれないようにします。

ssh -i ~/.ssh/work_ed25519 -p 2222 -o ServerAliveInterval=30 deploy@203.0.113.10 を 2 回以上打ったことがあるなら、ssh_config を覚えるのにかかる 10 分はもう取り戻せています。これは SSH 環境のなかで最も効果の大きい 1 ファイルです。あの長い 1 行を ssh web1 に変え、ssh、scp/sftp/rsync のファイル転送ツール(英語)、git、その他 SSH を内部で呼び出すものすべてが自動で読み込みます。

ここからは実践的なツアーです。本当に書く価値のあるディレクティブと、知っておくべき落とし穴を見ていきます。

どこに置き、どう読まれるか

個人用の設定は ~/.ssh/config です(なければ作成し、chmod 600 を忘れずに)。システム全体向けの /etc/ssh/ssh_config もあります。人がつまずきやすいルールはこうです。

  • 最初に一致した設定が使われます(最も具体的な設定ではありません)。 SSH は上から下へ読み、各オプションについて最初に見つけた値を使います。個別のホストを上に、広い Host * のデフォルトを下に置いてください。
  • どの設定も Host ブロック(パターン)の下に書き、慣習としてインデントします(インデントは必須ではありませんが、見やすくしておけば将来の自分が感謝します)。

基本単位:ホストの別名

Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

これで ssh web1 が完全なコマンドに展開されます。scp file.tar web1:/srv/、sftp web1、rsync -a ./dist/ web1:/var/www/ も同様です。別名こそが肝心で、サーバーに一度名前を付ければ、どこでもその名前が使えます。

書く価値のあるディレクティブ

ProxyJump——踏み台ホスト経由でサーバーに届く。 古い ProxyCommand ... netcat の呪文に代わる、現代的な書き方です。

Host db1
    HostName 10.0.0.5          # プライベートアドレス、踏み台からのみ到達可能
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump

これで ssh db1 は bastion を透過的に経由し、パブリックアドレスを持たないホストに到達します。より深いネットワークでは、カンマでつなげます(ProxyJump a,b,c)。

キープアライブ——アイドルのセッションが落ちるのを防ぐ。 少し目を離したときに出る client_loop: send disconnect: Broken pipe の対策です。

Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4

30 秒ごとのパケットが、NAT ルーターやファイアウォールに接続を忘れさせません。応答が 4 回途切れる(2 分間)とあきらめます。

IdentitiesOnly——正しい鍵だけを提示する。 複数の鍵を持っていると、SSH はそれらをすべて提示し、厳格なサーバーは Too many authentication failures を返します。ホストごとに鍵を 1 つに固定して、総当たりをやめさせましょう。

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

AddKeysToAgent——パスフレーズ付きの鍵を一度だけ解錠する。

Host *
    AddKeysToAgent yes

パターンとワイルドカード——サーバー群を 1 つのブロックで設定する。

Host *.staging.example.com
    User deploy
    IdentityFile ~/.ssh/staging_ed25519

Host 10.0.*
    ProxyJump bastion

現実的な設定を、上から下まで

# 個別のホストを先に(最初に一致した設定が使われる)
Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

Host db1
    HostName 10.0.0.5
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump
    IdentityFile ~/.ssh/work_ed25519

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

# 広いデフォルトは最後に
Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4
    AddKeysToAgent yes

大きくなってきたら分割します。ファイルの先頭に Include ~/.ssh/config.d/* を書けば、プロジェクトや取引先ごとに 1 ファイルに分けて管理できます。

2 つの落とし穴

  • 「最初に一致した設定が使われる」で痛い目を見るのは、先頭近くの Host * ブロックが、下で上書きするつもりだった値を設定しているときです。すでに先の値が勝っているため、上書きされません。デフォルトは最後に置きます。
  • コメントは行頭の # です。 値のうしろに付けた行末コメントは、一部のオプションでは値の一部として解釈されることがあります。コメントは独立した行に書きましょう。

設定ファイルだけでは足りなくなるとき

ssh_config は優秀で、誰もが 1 つ持っておくべきです。そのほころびが見えてくるのは、構成がテキストファイルの手に負えない規模になったとき——マシン間で手作業で同期したり、整理した版をチームメイトと共有したり、どのパスフレーズがどの鍵のものだったか思い出したり、40 台のホストのうちどれが起動しているのかをひと目で把握しようとしたりするときです。

そこを埋めるのが Termalin です。ホストごとの同じ設定——ホスト名、ユーザー、ポート、鍵、踏み台ホスト、キープアライブ——を保ちつつ、それらをフォルダーやタグで整理できる構造化データとしてホストに紐づけます。内蔵のエージェントで鍵を一度だけ解錠し、初回接続時に各サーバーを検証し、一覧内のすべてのホストのライブステータスを表示します。既存の PuTTY セッションをインポートでき、ホスト一覧はエンドツーエンド暗号化でマシン間を同期します。ファイルはある規模までは通用しますが、状態を代わりに保持してくれるクライアントは、その先まで通用します。

いずれにせよ、原則は変わりません。サーバーに一度名前を付ければ、そのコマンドラインフラグを二度と打ち直さずに済みます。


Termalin は無料・クロスプラットフォームの SSH クライアントで、ホストごとの設定、鍵、踏み台ホストをあなたの代わりに管理します。ダウンロードするか、鍵を安全に扱う仕組みをお読みください。

まずは 1 台のホストで試してみてください。

Termalin は、あなたとあなたのエージェントのための高速な SSH クライアントです。

無料プラン · Pro を 14 日間お試し · 料金

Google で Termalin を優先する情報源に追加