Obsidian Git插件在Mac系统下SSH密钥密码验证配置指南

背景介绍

Obsidian Git是Obsidian笔记软件的一个核心插件，它允许用户通过Git版本控制系统来同步和管理笔记库。在Linux系统中，用户可以通过ksshaskpass等工具实现SSH密钥密码的交互式输入，但在Mac系统上这一功能的配置方法在官方文档中尚未明确说明。

问题分析

当用户使用SSH协议连接Git远程仓库时，如果私钥设置了密码保护，系统需要一种机制来提示用户输入密码。在Mac系统中，这一功能需要通过ssh-agent及其密钥链管理功能来实现，这与Linux系统下的ksshaskpass方案有显著差异。

解决方案

1. 确认SSH密钥配置

首先确保已在Mac系统上生成并配置了SSH密钥对。可以通过终端执行以下命令检查：

ls -al ~/.ssh

正常应该能看到id_rsa(私钥)和id_rsa.pub(公钥)文件。

2. 将SSH密钥添加到ssh-agent

Mac系统自带了ssh-agent服务，可以安全地存储解密的私钥。执行以下步骤：

# 启动ssh-agent
eval "$(ssh-agent -s)"

# 将SSH私钥添加到agent，会提示输入密码
ssh-add ~/.ssh/id_rsa

3. 启用密钥链集成（关键步骤）

为了让Mac系统记住SSH密钥密码，需要修改SSH配置文件：

nano ~/.ssh/config

添加以下内容：

Host *
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_rsa

这个配置实现了三个重要功能：

1. 自动将使用的密钥添加到ssh-agent
2. 使用Mac的密钥链存储密码
3. 指定默认使用的私钥文件

4. 验证配置

执行以下命令测试SSH连接：

ssh -T [e-mail]

首次连接会提示输入密码，之后密码会被安全地存储在Mac的密钥链中。

高级配置建议

1. 多密钥管理：如果使用多个SSH密钥，可以在~/.ssh/config中为不同主机指定不同密钥。

2. 自动启动ssh-agent：可以将以下内容添加到~/.zshrc或~/.bashrc中，确保终端启动时自动加载ssh-agent：

if [ -z "$SSH_AUTH_SOCK" ]; then
   eval "$(ssh-agent -s)"
   ssh-add --apple-use-keychain ~/.ssh/id_rsa
fi

3. 安全性考虑：虽然密钥链提供了便利，但在公共计算机上使用时应当谨慎，可以考虑设置较短的超时时间。

常见问题排查

1. 权限问题：确保~/.ssh目录权限为700，密钥文件权限为600。

2. 密钥链提示：如果系统不断要求输入密码，检查UseKeychain配置是否正确。

3. Obsidian插件配置：确保仓库远程URL使用SSH协议格式([e-mail]:user/repo.git)。

通过以上配置，Obsidian Git插件在Mac系统下就能像在终端中一样正确处理SSH密钥密码验证，实现无缝的版本控制操作。这种方案不仅解决了密码提示问题，还充分利用了Mac系统的安全特性，在便利性和安全性之间取得了良好平衡。