Navicat 不同步私钥文件内容，仅同步本地绝对路径字符串，导致跨平台时路径失效；正确做法是统一密钥存放位置（如网络盘或Git子目录）并配置标准化路径，或通过符号链接将各系统.ssh目录映射至统一路径，且须严格校验权限、解除隔离属性并测试连接。
Navicat 本身不上传、不同步私钥文件内容，只同步配置里写的路径字符串——所以跨平台时“证书不见了”不是 Bug，是设计使然。
为什么 macOS 和 Windows 上的私钥路径总对不上
Navicat Cloud 或 On-Prem Server 同步的 connections.ncx 文件里，SSH 私钥字段存的是类似 /Users/alex/.ssh/id_rsa 或 C:Userslex.sshid_rsa 这样的本地绝对路径。这些路径在另一台系统上天然无效，Navicat 不会报错，而是静默跳过 SSH 隧道，导致连接走直连并失败。
- macOS 默认用
~/.ssh/，Windows 默认用%USERPROFILE%.ssh，Linux 又可能是/home/user/.ssh/，三者互不兼容 - 即使都写成相对路径（如
./ssh_keys/prod_key），Navicat 各平台版本对相对路径的支持程度不一：v16 macOS 支持，v17 Windows 某些小版本会忽略 - 私钥属于敏感凭证，Navicat 明确禁止上传密钥内容到云端，这是安全底线，不是功能缺失
统一存放位置必须由团队手动约定并落地
不能依赖 Navicat 自动处理，必须人为建立共享锚点。推荐两种可立即执行的方案：
-
方案一（推荐）：用团队共享网络盘或 Git 仓库子目录
把所有密钥文件集中放在一个大家都能访问的位置，比如
\server eam avicatssh_keys（Windows 网络驱动器映射为Z:），或 Git 仓库里的./configs/ssh_keys/（注意：Git 中只存测试密钥，生产密钥走内部密钥管理服务） -
方案二：用符号链接统一本地路径
在每台设备上，把各自
.ssh目录软链到一个标准化路径，例如 macOS 执行：ln -sf /Users/alex/team-ssh ~/.ssh
，Windows 用mklink /D "%USERPROFILE%.ssh" "Z: eam-ssh"。之后所有连接统一填~/.ssh/id_rsa即可
Navicat 里怎么填路径才真正生效
填错路径不会当场报错，但同步任务运行时就失效。关键操作节点必须卡死：
- 路径必须是 Navicat 启动时能立刻读取的——不能是 iCloud Drive、OneDrive 同步中、或需要输入密码解锁的加密卷
- 在连接设置的 SSH 标签页中，私钥路径字段填：
Z: eamssh_keysjumpbox_key（Windows 映射盘）或/Volumes/team/ssh_keys/jumpbox_key（macOS 网络挂载） - 填完后务必点击 Save → 再点 Test Connection，否则修改不写入
connections.ncx - 如果用便携版 Navicat，配置默认写进程序目录而非用户目录，所有成员必须统一安装路径，否则同步后路径又错位
容易被忽略的验证盲区
很多人只测“列表里有连接”和“点开能编辑”，但真正决定是否走隧道的是后台同步任务的执行环境：
- 测试连接成功 ≠ 同步任务走隧道：前者用当前机器上下文，后者用目标机器上的路径和权限
- macOS 上用 Finder 拖进密钥文件，可能被自动加上
com.apple.quarantine属性，Navicat 读取失败，需手动执行：xattr -d com.apple.quarantine /path/to/key
- 密钥文件权限必须严格：macOS/Linux 要
600（chmod 600 key），Windows 上若用 OpenSSH，也建议右键属性 → 安全 → 仅保留当前用户读取权限
真正麻烦的从来不是“怎么让一台电脑连上”，而是“怎么确保十个人在三套系统上每次触发同步时，都真实穿过隧道”。路径是静态字符串，人是动态变量——统一靠约定，落地靠检查，生效靠验证。
