跨平台 SSH Agent(Windows / macOS),用纯 Go 编写,UI 基于 MyGo 原生 ui 包绘制。支持从 Bitwarden / Vaultwarden 导入密钥。
- SSH Agent — Windows 使用
\\.\pipe\openssh-ssh-agent命名管道,与 OpenSSH 原生兼容;macOS 使用~/.sshkeygate/agent.sockUnix socket。支持 Ed25519 / RSA / ECDSA,含rsa-sha2-256/rsa-sha2-512签名算法 - 密钥导入 — 文本粘贴、拖拽文件、
~/.ssh目录扫描(识别加密密钥并可填口令)、Bitwarden / Vaultwarden 同步 - 策略审批 — 每次确认 / 会话授权 / 定时授权 / 信任进程 四种模式
- 签名确认弹窗 — 可配置倒计时(10–120 秒,默认 30),超时自动拒绝;并发请求排队,一次只展示一个
- 进程识别 — Windows 走
GetNamedPipeClientProcessId+QueryFullProcessImageNameW;macOS 走LOCAL_PEERPID+kern.procargs2。无法识别来源时永不自动放行 - 信任程序校验 — 以可执行文件路径为身份,可选校验最后修改时间与 SHA-256
- 操作日志 — JSONL 持久化,最多 500 条,锁定状态下也可记录
- 系统托盘常驻 — 关窗最小化到托盘,Agent 持续可用
- 单实例 — 重复启动会退出新进程,并把已运行的窗口还原到前台
- 开机启动 / 锁屏自动锁定
- 浅色 / 深色 / 跟随系统 — 配置页可切换,配色随主题整体变化
- 中英双语 — 跟随系统或手动切换,覆盖全部界面文案
主题与语言默认跟随系统:外观取系统深浅色,语言按首选语言在中文/英文中匹配。系统设置变化时界面即时跟随;在「配置 → 外观」里选定后则以所选为准。
从 Releases 获取最新版本:
| 平台 | 文件 |
|---|---|
| Windows x64 | sshkeygate-<version>-windows-amd64.exe |
| macOS 11+(Intel + Apple Silicon) | sshkeygate-<version>.dmg |
macOS 包目前未签名(ad hoc 签名),首次打开需要「右键 → 打开」,或执行:
xattr -dr com.apple.quarantine /Applications/sshkeygate.appmacOS 包支持 11.0(Big Sur)及以上。Go 1.27 本身要求 macOS 13,
且其 crypto/x509 硬引用了 macOS 12 才有的 SecTrustCopyCertificateChain,
所以包里附带一个小型兼容层:Contents/Frameworks/libsectrust_compat.dylib
用 macOS 11 仍可用的旧 API 实现该函数,由启动脚本注入。详见
tools/sectrustcompat。
- Windows:
ssh.exe默认连接\\.\pipe\openssh-ssh-agent,无需额外配置 - macOS:把 socket 路径告诉客户端
export SSH_AUTH_SOCK="$HOME/.sshkeygate/agent.sock"
需要 Go 1.27.3+(go.mod 已声明,GOTOOLCHAIN=auto 会自动获取)。
# Windows:-H windowsgui 让程序不带控制台窗口
go build -ldflags "-H windowsgui -s -w" -o dist/sshkeygate.exe .
# macOS
go build -o dist/sshkeygate .验证:
go test ./... # 单元测试 + Windows 命名管道集成测试
go vet ./...
gofmt -l . # 应为空
GOOS=darwin GOARCH=arm64 go build ./... # 交叉编译校验(MyGo 无 cgo)macOS 的 .app 与 DMG 由 mygo build 产出,配置在 mygo.json:
# 双架构 .app(arm64 + amd64 由 lipo 合并)与 DMG,需在 macOS 上执行
MYGO_LDFLAGS="-macos 11.0" \
go run github.com/egoist/mygo/cmd/mygo@latest build -platform darwin/universal-macos 11.0 不能省:Go 1.27 的链接器默认按 macOS 13 链接,dyld 会拒绝在
11/12 上加载,即使 Info.plist 写的是 11.0。可以用 tools/machoinfo 核对产物:
go run tools/machoinfo/main.go \
dist/darwin-universal/sshkeygate.app/Contents/MacOS/sshkeygate
# arm64 minos=11.0 sdk=26.2
# x86_64 minos=11.0 sdk=26.2darwin/universal 分别编译 arm64 与 amd64 再合成,一个包同时支持 Apple Silicon 与 Intel。
DMG 生成与代码签名需要 macOS;签名与公证的完整步骤见 TODO.md。
图标由 tools/genicon 生成,不手工编辑:
go run tools/genicon/main.go # tools/genicon/source.png → app/assets/icon.png + icon.ico
# 更新 exe 内嵌图标(Windows 资源),随后重新 go build
go run github.com/akavel/rsrc@latest -ico app/assets/icon.ico -o rsrc_windows_amd64.syso- 源图
tools/genicon/source.png为 1024² 透明底 PNG - 缩放用盒式滤波并按预乘 alpha 平均,避免透明边缘渗色
- 窗口与托盘图标在运行时从
app/assets/icon.png读取(go:embed);登录页与侧边栏也直接绘制它 - 资源管理器 / 任务栏的 exe 图标来自
rsrc_windows_amd64.syso .ico含 16–256 共 9 种尺寸
main.go # 单实例锁、服务装配、窗口/托盘、锁屏钩子
app/
app.go # 服务聚合 + 状态 + 动作(解锁/导入/设置)
views.go # 全部界面(侧边栏 + 5 个页面 + 弹窗)
theme.go # 浅色/深色配色 + MyGo 主题
i18n.go # 中英文案表
icons.go # 线性 SVG 图标
confirm.go # 签名确认队列(串行展示 + 倒计时)
tray.go # 托盘菜单
icon.go # 内嵌应用图标
internal/
vault/ # 加密存储(PBKDF2 + AES-256-GCM,原子写,改密可回滚)
keystore/ # 密钥元数据 + 按需解密签名
sshkey/ # 密钥解析 / 指纹 / RSA flags 签名
agent/ # SSH Agent 协议 + 管道/socket 传输 + peer 识别
policy/ # 4 种策略 + 信任校验
auditlog/ # JSONL 审计日志
bitwarden/ # prelogin → token → sync → 解密
tools/genicon/ # 图标生成器
enc_key = PBKDF2-SHA256(用户密码 ‖ device_key, salt, 100000 轮)
vault = AES-256-GCM(元数据 JSON, enc_key)
keys/<id> = AES-256-GCM(私钥 PEM, enc_key)
device_key(32 字节)保存在系统凭据库:Windows Credential Manager / macOS Keychain。只有它进凭据库,其余全部加密落盘,因此不受凭据库单条 2560 字节上限约束- 每把私钥单独加密成一个文件,不进入 vault 元数据
- 所有写入先写临时文件再
rename,避免半写状态 - 修改密码分两阶段:先写迁移记录,重加密成功后才删除;进程中断后启动时自动回滚
- 锁定态:内存中无密钥材料,SSH 请求直接失败
- 解锁后:内存仅保留元数据与公钥 blob
- 签名时:解密单条私钥 → 签名 → 清零并丢弃
导入加密密钥时用口令解密,存储解密后的私钥,不保存口令。
信任记录同时保存路径、修改时间与 SHA-256;设置项只决定校验哪些字段,不决定存哪些。任一字段不匹配即视为不可信。
| 文件 | Windows | macOS |
|---|---|---|
| 数据目录 | %APPDATA%\sshkeygate |
~/Library/Application Support/sshkeygate |
vault.json |
盐值 + 加密元数据 | 同左 |
keys/<id>.bin |
单独加密的私钥 | 同左 |
agent.log |
JSONL 审计日志 | 同左 |
prefs.json |
主题与语言 | 同左 |
| device key | Credential Manager | Keychain |
app/ # UI(ui.NewTester 无窗口渲染)、确认队列、主题、i18n、图标、窗口尺寸
internal/agent # 协议响应、异常帧、并发、真实 Windows 管道与 peer 识别
internal/sshkey # 夹具指纹、三种 RSA flags、加密私钥往返
internal/vault # 创建/解锁/改密/中断恢复/密文不含明文
internal/policy # 4 种策略、mtime/SHA-256 失效、未识别进程
internal/keystore # 导入去重/启停/改名/删除/签名
internal/auditlog # 追加、重载、500 条上限、清除
internal/bitwarden # EncString v2、MAC 篡改、HKDF 展开、换半重试
- 仅 Windows 与 macOS(Linux 尚未实现)
- 不支持一个文件包含多把私钥,不支持 SSH 证书签名
- macOS 包未签名公证,需手动移除 quarantine 属性