Navicat跨平台迁移必须勾选Include password并设临时主密码,否则密码为空;SSH私钥路径、代理、SSL等配置不自动迁移,需手动重填并注意路径与编码差异。

导出必须勾选 Include password,否则密码字段为空
Navicat for MySQL 在 Windows 上默认不导出密码,哪怕连接里显示“已保存”,导出的 connections.ncx 文件中密码仍是星号或空值。v16+ 版本导出弹窗底部有明确复选框 Include password,必须手动勾选;勾选后会强制设置一个临时主密码(如 temp123),该密码仅用于本次加密解密,导入时需再次输入。v15 及更早版本不显示该选项,实际也不包含密码,导入 Ubuntu 后仍需逐个重输。
导入后 SSH 私钥路径 100% 失效,必须手动重填
Windows 上保存的私钥路径类似 C:\Users\Alice\.ssh\id_rsa,Ubuntu 上对应路径是 /home/alice/.ssh/id_rsa —— 导入后 Navicat 不会自动转换或提示缺失,连接测试直接卡在「SSH 连接失败」。操作步骤如下:
- 双击目标连接 → 切到「SSH」选项卡
- 点击「Browse…」重新选择本地私钥文件(确保 Ubuntu 上已有且权限正确:
chmod 600 ~/.ssh/id_rsa) - 检查「SSH 用户名」和「SSH 密码」字段:这两个不随常规密码导出,即使用了密钥认证,也要确认用户名是否为空
跨平台中文名乱码?优先用 v16+ 并避免手动改 .ncx 文件
v14 及以下版本在 Windows 上读取 UTF-8 编码的 connections.ncx 时可能误用 GBK 解码,导致中文连接名变方块或截断。v16+ 已修复此问题,但前提是:
Navicat Premium 17.1 Windows x64 历史系列获取入口。该系列扩展 Garnet、PolarDB 等连接支持,并增强可视化查询解释与 Redis 树视图;未核实到公开固定安装包直链。
- Windows 和 Ubuntu 两端都使用 v16.x(如 16.3 → 16.5),小版本差安全;主版本差(如 16 → 17)大概率解析失败
- 绝不双击打开
.ncx文件,必须在 Ubuntu 版 Navicat 内执行文件 → 导入连接 - 不要用文本编辑器修改
.ncx,它是二进制加密格式,改坏即 invalid connection file
代理、SSL、字符集配置不会迁移,得靠截图或笔记补全
Navicat 导出的 connections.ncx 只含基础连接参数(主机、端口、用户、数据库名等),以下内容全部丢失且无提示:
- HTTP/SOCKS 代理设置(路径、端口、认证)
- SSL 配置中的 CA/Cert/Key 文件路径(Ubuntu 上路径结构与 Windows 完全不同)
- 连接级字符集(如
utf8mb4)和超时参数,需在连接编辑页手动核对
建议导出前在 Windows 上截一张完整连接配置页(含「高级」「SSL」「SSH」各标签页),导入 Ubuntu 后对照填写。最容易被忽略的是 SSL 模式——若源端设为 Require 但没导出证书路径,连接会静默失败,日志里只显示「Connection refused」。










