ssh-agent

SSH クライアントが署名に利用する鍵をエージェントで管理。

実行前の確認

macOS ではエージェントが既に用意されている場合があります。まず ssh-add -l で確認してください。eval の例は zsh／bash 用で、PowerShell 用ではありません。必要な場合のみ別のエージェントを起動し、自分が起動したものだけを停止します。環境変数は現在のシェルと子プロセスに適用されます。エージェント転送（-A）を安易に有効にしないでください。侵害されたリモートホストから、転送中のエージェントを認証に悪用されるおそれがあります。

使用例

別のエージェントを起動し、現在のシェルに環境変数を設定します。

eval "$(ssh-agent -s)"

上で起動したエージェントを停止し、対応するシェル変数を解除します。

eval "$(ssh-agent -k)"

オプションと使用例

-sよく使う

Bourne 互換のシェルコマンドを出力して、エージェント環境変数を設定します。この例は sh 互換シェルの場合です。

使用例

eval "$(ssh-agent -s)"

-c

Bourne シェルコマンドの代わりに C シェルコマンドを出力します。

使用例

ssh-agent -c

-kよく使う

現在の環境で識別されたエージェントを停止するコマンドを出力します。自分が開始したエージェントのみを停止します。

使用例

eval "$(ssh-agent -k)"

-t life

ssh-add によってオーバーライドされない限り、このエージェントに追加される ID のデフォルトの存続期間を設定します。

使用例

ssh-agent -t 1h

-a bind_address

エージェントを指定された Unix ソケットパスにバインドします。そのソケットへのアクセスを保護します。

使用例

ssh-agent -a /tmp/example-ssh-agent.sock

-D

エージェントをフォアグラウンドで実行します。監督に役立ちます。

使用例

ssh-agent -D

公式リファレンス

確認日：2026年10月27日