Secure Pipes

~/.ssh/config

よく使う接続オプションをクライアント設定ファイルに保存。

実行前の確認

最初のブロックはシェルコマンドではなく、手元の ~/.ssh/config に記述する内容です。通常は最初に得た値が使われるため、個別の Host を汎用の Host * より前に置きます。ファイルを適切な権限で保護し（通常 chmod 600 ~/.ssh/config）、パスワードや秘密鍵の内容を書かないでください。ServerAlive は SSH 接続先の応答を確認するもので、全アプリケーションの障害は検出しません。ssh -G は接続せず有効な設定を表示し、内部アドレスやパスが含まれる場合があります。

使用例

lab エイリアスにポート、鍵ファイル、SSH の生存確認を設定します。

Host lab
    HostName server.example.com
    User alice
    Port 2222
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
    ServerAliveInterval 30
    ServerAliveCountMax 3

エイリアスで接続するか、適用される設定を確認します。

ssh lab
ssh -G lab

オプションと使用例

Host patternよく使う

SSH エイリアスまたはホスト パターンに一致するブロックを開始します。特定のブロックを一般的なブロックの前に置きます。最初に取得した値が使用されます。

使用例
Host lab
    HostName server.example.com
HostName / User / Portよく使う

一致するホストの実際のサーバー アドレス、ログイン名、SSH ポートを設定します。

使用例
Host lab
    HostName server.example.com
    User alice
    Port 2222
IdentityFile / IdentitiesOnlyよく使う

秘密キーを選択し、「はい」に設定すると、提供される ID が構成された ID に制限されます。

使用例
Host lab
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
ProxyJumpよく使う

1 つ以上の SSH ジャンプ ホストを介して接続します。

使用例
Host lab
    ProxyJump alice@bastion.example.com
LocalForward

SSH サーバーから到達した宛先に転送されるローカル リスナーを構成します。

使用例
Host lab
    LocalForward 127.0.0.1:15432 db.internal.example.com:5432
RemoteForward

ローカル コンピューターから到達した宛先に転送されるリモート リスナーを構成します。サーバーポリシーが適用されます。

使用例
Host lab
    RemoteForward 127.0.0.1:18080 127.0.0.1:8080
DynamicForward

ローカル SOCKS リスナーを構成します。クライアントは個別に構成する必要があります。

使用例
Host lab
    DynamicForward 127.0.0.1:1080
ExitOnForwardFailure

要求された初期転送リスナーを確立できない場合は、SSH 接続に失敗します。

使用例
Host lab
    ExitOnForwardFailure yes
ServerAliveInterval / ServerAliveCountMaxよく使う

SSH レベルのピア チェックと、切断するまでの未回答のチェックの数を構成します。

使用例
Host lab
    ServerAliveInterval 30
    ServerAliveCountMax 3
ConnectTimeout

接続タイムアウトを秒単位で設定します。

使用例
Host lab
    ConnectTimeout 10
ForwardAgent

エージェント転送を制御します。侵害されたリモート ホストは署名を要求する可能性があります。信頼できるホストに対してのみ有効にします。

使用例
Host lab
    ForwardAgent no
Include

追加の SSH 構成ファイルを含めます。順序は、どの値が選択されるかに影響します。

使用例
Include ~/.ssh/config.d/*.conf

公式リファレンス

確認日：2026年10月27日