直接拷贝connections.ncx不行,因mac版navicat(v15+)默认用绑定设备硬件指纹和系统凭证的本机密钥加密该文件,跨设备或重装后无法解密,导致连接列表空白、静默失败;必须通过「文件→导出连接」生成可迁移的.ncx文件,并在同大版本navicat中「文件→导入连接」完成迁移。
不能直接复制 connections.ncx 文件来“克隆”连接,mac 上必须用 navicat 自带的导出/导入流程,否则会提示“无效的连接文件”或连接列表为空。
为什么直接拷贝 ~/Library/Application Support/PremiumSoft/Navicat/connections.ncx 不行?
Mac 版 Navicat(v15+)默认对 connections.ncx 启用本机密钥加密,该密钥绑定当前设备的硬件指纹和系统凭证。把文件原样复制到另一台 Mac 或重装系统后,Navicat 无法解密,表现就是:启动后连接列表空白、双击无响应、控制台不报错——静默失败,极难排查。
- 即使两台 Mac 都是 macOS Sonoma + Navicat 17.2,只要不是同一台机器,
connections.ncx就不可复用 - 手动用文本编辑器打开该文件看到的是加密二进制或乱码 XML,不是可读配置
- Finder 中显示文件大小正常 ≠ 内容可用;Navicat 加载时校验失败就直接跳过
正确做法:用「导出连接」生成可迁移的 .ncx 文件
这不是备份,而是主动触发一次“解密 → 序列化 → 可选加密导出”的过程,生成跨设备安全的中间文件:
- 在源 Mac 的 Navicat 中,点击菜单栏
文件 → 导出连接,勾选全部连接(或按住 Cmd 多选) - 务必勾选
包含密码(v16+ 默认不勾,v15 灰色不可选但实际不带);若不勾,导入后每个连接都要重输密码 - 保存为
all_connections.ncx(后缀必须是.ncx,不能改.xml或.zip) - 导出文件是明文 XML(含 base64 编码的密码),传输后记得立刻删掉本地副本
导入时必须走「文件 → 导入连接」,不能双击打开
Mac 上双击 all_connections.ncx 文件,系统会尝试用默认程序打开(比如文本编辑器),Navicat 完全不会介入。必须在 Navicat 已运行状态下操作:
- 启动目标 Mac 上的 Navicat(版本需与源端同一大版本,如都是 v17.x;v16 导出的不能在 v17 直接导入)
- 菜单栏
文件 → 导入连接,定位并选中你传过来的all_connections.ncx - 导入成功后,连接列表会出现,但所有密码字段仍显示为星号——这是正常现象,不是失败
- 双击任一连接,在弹出的编辑窗口中点一下「测试连接」,它会自动调用已导入的密码解密并验证;若失败,才需要手动补输
SSH 和代理配置必须手动重设
导出的 .ncx 文件只存参数值,不存运行时依赖。Mac 到 Mac 迁移也一样要检查:
-
SSH 私钥路径:源 Mac 是~/.ssh/id_rsa,新 Mac 上该路径可能不存在,或权限不对(需chmod 600) -
HTTP 代理地址:公司统一代理在旧 Mac 上是127.0.0.1:7890,新 Mac 若用 ClashX,端口可能是7892 -
SSL 证书路径:相对路径(如./certs/client.pem)比绝对路径更稳妥,但需确保文件已同步到相同位置 - 改完任何一项后,一定要先点
保存,再点测试连接,否则修改不生效
最易被忽略的是:导入后不验证单个连接是否真能连通,只看列表里有没有名字。而 SSH 隧道不通、密码解密失败、代理超时这些,都表现为“连接图标转圈后断开”,不是红色报错——得执行一条 SELECT 1 才算真正克隆完成。











