>

把 SSH 密码短语存入 macOS 钥匙串

苹果版 ssh-add 专属参数 --apple-use-keychain 可以记住密码短语，让 ssh-agent 自动加载密钥，重启后依然有效。

macOSSSH 远程连接ssh-add 密钥添加钥匙串低风险
运行一次 `ssh-add --apple-use-keychain ~/.ssh/id_ed25519` 即可把密码短语存入钥匙串。

01命令

命令
$ ssh-add --apple-use-keychain ~/.ssh/id_ed25519

02作用说明

这个参数只存在于 macOS 自带的 ssh-add 中，通用 OpenSSH 文档完全不会提到，所以经常被忘记。存入后密码短语在重启后依然生效：只要 ~/.ssh/config 里有 `UseKeychain yes` 和 `AddKeysToAgent yes`，ssh-agent 会在首次使用密钥时自动从钥匙串读取。旧的短参数 -K 已被弃用；ssh-add -D 只清除已加载的密钥，不影响钥匙串中的记录。

03风险

风险低风险
!注意: 密码短语保存在登录钥匙串中——能进入你已解锁用户会话的人都能使用它。

04撤销

撤销
$ ssh-add -D && ssh-add --apple-use-keychain ~/.ssh/id_ed25519 (re-add without passphrase by regenerating the key)

05来源

  • ssh-add(1) — macOS man page
    Xcode Man Pages (mirror) · technical · 2026-09-17
    依据: Documents --apple-use-keychain: the passphrase is added to the keychain and later loaded automatically by ssh-agent.
  • ssh-add(1) — macOS man page
    manpagez · technical · 2026-09-17
    依据: Apple's ssh-add variant supports --apple-use-keychain (formerly -K) to persist passphrases in the macOS keychain.

最后验证: 2026-09-17 · 分类: 安全与隐私