Navicat for Mac 不支持 .ppk 格式密钥,必须转换为无密码的 OpenSSH PEM 格式(开头为 -----BEGIN RSA PRIVATE KEY----- 或 -----BEGIN OPENSSH PRIVATE KEY-----),使用绝对路径、chmod 600 权限,并授予 Navicat 完全磁盘访问权限。

Navicat for Mac 读不到 Windows 生成的 .ppk 文件
Mac 版 Navicat(包括 v15–v17)**完全不支持 PuTTY 格式的 .ppk 密钥**,这是硬性限制,不是权限或路径问题。当你在 Windows 上用 PuTTYgen 生成 id_rsa.ppk,再复制到 Mac 并在 Navicat 连接设置里指定该路径,点击测试时大概率静默失败,或报错 Authentication failed / Permission denied (publickey)——但 Navicat 不会提示“不支持 .ppk”,只会当作无效文件跳过。
必须转成 OpenSSH 格式(PEM),且满足三要素
Mac 版 Navicat 只认标准 OpenSSH 私钥格式(即 PEM 编码、无密码或已解密、开头为 -----BEGIN RSA PRIVATE KEY----- 或 -----BEGIN OPENSSH PRIVATE KEY-----)。转换时需同时满足:
- 用
puttygen(Windows)或ssh-keygen(Mac)导出为OpenSSH格式,**不能选 “SSH-2 RSA” 文本块直接保存**(那是公钥) - 导出时**不要设密码**(Navicat for Mac 不支持交互式密码输入;若必须加密,请先用
ssh-keygen -p -f key.pem移除密码) - 保存后的文件扩展名建议用
.pem或无后缀,**避免.ppk、.key等误导性后缀**(Navicat 不按后缀判断格式,但人容易选错)
Mac 上验证私钥是否有效:两行命令定生死
别依赖 Navicat 的“测试连接”来排查。在终端执行以下命令,能立刻确认密钥本身是否被系统识别:
Navicat Premium 17.1 Windows x64 历史系列获取入口。该系列扩展 Garnet、PolarDB 等连接支持,并增强可视化查询解释与 Redis 树视图;未核实到公开固定安装包直链。
ssh-keygen -l -f ~/Downloads/id_rsa.pem
如果返回类似 2048 SHA256:abc123... (RSA),说明格式正确;若报 invalid format 或 no such file,则要么路径错、要么格式没转对、要么文件有隐藏 BOM(常见于 Windows 记事本另存)。此时应重做转换,并用 VS Code 打开检查首尾是否有 U+FEFF 或多余空行。
路径和权限:Mac 上最容易被忽略的两个坑
即使密钥格式完全正确,Navicat for Mac 仍可能读取失败,原因集中在:
-
~/.ssh/id_rsa这类路径中~**不会被 Navicat 展开**,必须写成完整绝对路径,例如/Users/alex/.ssh/id_rsa.pem - 私钥文件权限必须是
600(仅所有者可读写),执行chmod 600 /path/to/id_rsa.pem;macOS 13+ 默认挂载外置盘为只读,若密钥放在移动硬盘或 iCloud 同步目录,Navicat 会静默拒绝加载 - Navicat 进程需有 Full Disk Access 权限(系统设置 → 隐私与安全性 → 完全磁盘访问),否则连
/Users/xxx/.ssh/都打不开
Mac 上的私钥问题从来不是“能不能用”,而是“Navicat 能不能看见它”——格式、路径、权限、系统授权,四者缺一不可。尤其注意:PuTTYgen 导出界面里那个“Export OpenSSH key”按钮,点完还得手动删掉文件末尾多出来的空行,否则 ssh-keygen -l 就会失败。










