SSH-Pageant 技术文档

1. 安装指南

Cygwin 安装方式：

1. 使用 Cygwin 的标准 setup.exe 程序安装最新版本的 ssh-pageant。

2. 下载预编译的 32位 或 64位 版本。

3. 将 exe 文件复制到您的 PATH 目录下，并确保其可执行：

   $ cp ssh-pageant.exe /usr/bin/
   $ chmod 755 /usr/bin/ssh-pageant.exe
   

4. 可选地，复制手册页：

   $ cp ssh-pageant.1 /usr/share/man/man1/
   

MSYS2 安装方式：

运行以下命令安装 ssh-pageant：

$ pacman -S ssh-pageant

2. 项目使用说明

1. 确保 PuTTY 的 Pageant 正在运行并且持有您的 SSH 密钥。ssh-pageant 本身不会启动 Pageant。

2. 推荐将 Pageant 添加到 Windows 启动/自动启动配置中，以便始终可用。

3. 编辑 ~/.bashrc（或 ~/.bash_profile），添加以下内容：

   # ssh-pageant
   eval $(/usr/bin/ssh-pageant -r -a "/tmp/.ssh-pageant-$USERNAME")
   

   解释如下：

   • -r/--reuse 选项与 -a SOCKET 一起使用，仅当指定路径不接受连接时才启动新的守护进程。
   • -a 指定的路径是任意的，只要文件系统未挂载 noacl，socket 将被创建为只有用户可访问的权限。
   • 使用此方法时，ssh-pageant 守护进程将保持活动状态（在任务管理器中可见）。您不应杀死此进程，因为打开的 shell 可能仍在使用该 socket。
   • 使用 eval 将环境变量设置在当前 shell 中。

3. 项目 API 使用文档

ssh-pageant 旨在与 ssh-agent 选项兼容，并具有以下额外选项：

• -h, --help: 显示帮助信息。
• -v, --version: 显示版本信息。
• -c: 在标准输出上生成 C-Shell 命令。
• -s: 在标准输出上生成 Bourne-Shell 命令。
• -S SHELL: 为指定的 shell 类型（bourne、csh 或 fish）生成 shell 命令。
• -k: 杀死当前的 ssh-pageant。
• -d: 启用调试模式。
• -q: 启用静默模式。
• -a SOCKET: 在指定路径创建 socket。
• -r, --reuse: 允许重用现有的 -a SOCKET。
• -t TIME: 限制密钥的有效期（Pageant 不支持此选项）。

4. 项目安装方式

请参考上述“安装指南”部分。