Secure Pipes

ssh-add

既存のエージェントへの鍵の追加、一覧表示、削除。

実行前の確認

SSH_AUTH_SOCK を通じてエージェントに接続できる必要があります。「鍵がない」と「エージェントに接続できない」は異なる状態です。-t はエージェント内の有効期間を設定し、鍵ファイルの削除や鍵自体の失効は行いません。エージェントから削除しても、サーバーの認可やキーチェーンの保存項目は削除されません。

使用例

秘密鍵を 1 時間読み込み、必要に応じてパスフレーズを入力します。

ssh-add -t 1h ~/.ssh/id_ed25519

読み込まれている鍵の指紋を一覧表示します。

ssh-add -l

鍵ファイルを残したまま、エージェントからこの鍵を削除します。

ssh-add -d ~/.ssh/id_ed25519

オプションと使用例

identity_fileよく使う

秘密キーをエージェントに追加し、必要に応じてパスフレーズの入力を求めます。

使用例
ssh-add ~/.ssh/id_ed25519
-l / -Lよく使う

エージェントが現在保持しているフィンガープリントまたは公開キーをリストします。

使用例
ssh-add -l
-t lifeよく使う

ID がエージェントに保持される期間を制限します。これにより、キー自体が期限切れになったり取り消されたりすることはありません。

使用例
ssh-add -t 1h ~/.ssh/id_ed25519
-d identity_fileよく使う

エージェントから 1 つの ID を削除します。これにより、サーバー上でそれが取り消されるわけではありません。

使用例
ssh-add -d ~/.ssh/id_ed25519
-D

キーファイルを削除せずに、現在のエージェントからすべての ID を削除します。

使用例
ssh-add -D
-c

追加された ID を使用する前に確認を要求します。適切な確認プログラムが必要です。

使用例
ssh-add -c ~/.ssh/id_ed25519
-x / -X

エージェントを対話的にロックまたはロック解除します。

使用例
ssh-add -x
-T public_key

エージェントが対応する秘密キーを使用できるかどうかをテストします。

使用例
ssh-add -T ~/.ssh/id_ed25519.pub

公式リファレンス

確認日：2026年10月27日