navicat协同模式不同步私钥文件，只同步路径引用，跨平台路径失效导致静默跳过ssh隧道；解决方法是将私钥统一存入团队共享目录，并在各设备配置为标准化绝对路径或受支持的相对路径。
navicat 协同模式本身不同步私钥文件，只同步连接配置中的路径引用——路径失效是常态，不是故障。
为什么私钥在团队间“消失”了
Navicat Cloud 同步的是 connections.ncx 里的 XML 配置，其中 SSH 私钥字段存的只是本地文件路径（如 C:Userslice.sshid_rsa），不是密钥内容本身。Mac 上的 /Users/bob/.ssh/id_ed25519 到 Windows 上根本打不开，Navicat 也不会报错，而是静默跳过 SSH 隧道设置，导致后续同步走直连并失败。
- 私钥属于敏感凭证，Navicat 明确不上传、不同步密钥文件内容
- 路径写死在加密配置里，跨设备迁移后不会自动替换或提示
- 你看到“连接测试成功”，但那是本地测试；同步任务运行时用的是目标机器上的路径，大概率不存在
怎么让团队成员都能连上带 SSH 的库
核心思路：把私钥文件纳入团队可共享的路径，再统一配置为相对路径或标准化绝对路径。
- 在团队约定的共享目录下建
ssh_keys/子文件夹（如\server eam avicatssh_keys或 Git 仓库里的./configs/ssh_keys/） - 每个成员把私钥复制进去，并重命名为统一名称（如
jumpbox_key），避免版本混乱 - 在 Navicat 连接设置的 SSH 标签页中，私钥路径填
./ssh_keys/jumpbox_key（部分版本支持相对路径）或明确写成该共享位置的本地映射路径（如Z: eam avicatssh_keysjumpbox_key） - 配置完务必点
Save再点Test Connection，否则修改不生效
哪些操作会悄悄破坏 SSH 连接
这些细节不注意，同步任务就会在无人察觉时退化为明文直连。
- 用 Mac 导出的连接配置直接导入 Windows，路径仍保留
~/.ssh/...，Navicat 不校验也不警告 - 在多用户 Windows 系统中切换账号，
%APPDATA%指向不同位置，connections.ncx可能读错配置源 - 勾选了「使用 SSH 隧道」但私钥路径为空或指向不存在的文件，Navicat 仍允许保存连接，同步时才暴露问题
- 用便携版 Navicat 同步后，配置实际写入程序目录而非用户目录，团队成员安装路径不一致就彻底失联
真正麻烦的从来不是“怎么配一次”，而是“怎么确保十个人在三台系统上每次打开都走隧道”。路径必须显式、可验证、与机器解耦——否则所谓协同，不过是各自为政的幻觉。
