ssh-add
向既有驗證代理程式新增、查看或移除身分。
執行前須知
須能透過 SSH_AUTH_SOCK 存取代理程式。「沒有身分」與「無法連線至代理程式」是不同狀況。-t 限定身分在代理程式中的存留時間，不會刪除金鑰檔案或使金鑰本身到期。移除代理程式中的身分，不會撤銷伺服器授權，亦不會刪除鑰匙圈中儲存的項目。
使用範例
載入私鑰一小時；需要時輸入私鑰通行片語。
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常用限制身分在代理程式中保留的時間；這不會過期或撤銷金鑰本身。
範例
ssh-add -t 1h ~/.ssh/id_ed25519-d identity_file常用刪除代理人的一個身分；這不會在伺服器上撤銷它。
範例
ssh-add -d ~/.ssh/id_ed25519-D刪除目前代理的所有身份，而不刪除金鑰檔案。
範例
ssh-add -D-c在使用新增的身份之前需要確認；需要適當的確認程序。
範例
ssh-add -c ~/.ssh/id_ed25519-x / -X以互動方式鎖定或解鎖代理。
範例
ssh-add -x-T public_key測試代理是否可以使用對應的私鑰。
範例
ssh-add -T ~/.ssh/id_ed25519.pub權威參考
核對日期：2026 年 10 月 27 日