必须通过项目绑定新建连接并同步到服务端,不能直接共享本地配置;Navicat Cloud需先建项目再新建连接并点击“保存到云”,On-Prem Server则须在Web界面中为项目新建连接,且仅认组织域邮箱登录,密码由成员单独输入。
不能直接共享本地连接配置,必须通过项目绑定新建连接并同步到服务端。navicat 的协同功能不支持“拖一个已有的本地 mysql 连接进去就自动可用”,这是最常踩的坑——成员点开即报 connection refused (111) 或 access denied。
Navicat Cloud:连接保存到云后才可见
在 Navicat Cloud 中,数据库连接本身不是独立对象,而是作为「项目内资源」存在。你必须先创建项目,再在该项目下新建连接(而非复用本地连接):
- 打开
文件 > Navicat Cloud… > 新建项目,输入名称并确认 - 右键刚建好的项目 →
新建连接→ 选择数据库类型(如MySQL)→ 填写连接参数(主机、端口、用户名等) - 关键一步:连接配置完成后,必须点击工具栏的
保存到云按钮(或右键连接 →保存到云),并指定目标项目 - 未执行
保存到云的连接,只存在于你本地,其他成员完全看不到
Navicat On-Prem Server:连接必须走服务端统一管理
On-Prem Server 强制要求所有连接由服务端创建和维护,本地连接无法导入或同步:
- 登录 On-Prem Server Web 界面后,进入对应项目 → 点击
+新建→新建连接 - 填写完整连接信息时,
SSH 隧道和SSL参数需显式配置(不能依赖客户端本地设置) - 连接成功测试后,它会自动加密存储在
/opt/navicat-onprem目录下,并实时同步给所有有权限的成员 - 若你在本地 Navicat 客户端里双击该连接报错,检查是否用了个人账号登录 —— On-Prem Server 只认组织域邮箱(如
zhangsan@corp.internal),用 Gmail 登录会显示空连接列表
共享后仍连不上?重点查这三处
即使连接已成功保存到云或 On-Prem Server,成员仍可能连不上,常见原因集中在认证、网络和角色权限:
- Cloud 场景下:被邀请人未用注册邮箱完整登录过 Navicat(大小写敏感),导致项目里显示“已添加”但实际无访问权
- On-Prem 场景下:Nginx 反向代理缺
proxy_set_header X-Forwarded-Proto $scheme;,登录后跳转失败,表现为白屏或反复重定向 - 两者共性问题:Viewer 角色无法执行连接测试或打开查询编辑器,只有
可编辑或更高权限才能真正使用该连接
真正容易被忽略的是:连接参数里的密码字段在协同中不传输明文,而是由每个成员单独输入。也就是说,即使你建好了连接,别人首次使用时仍要手动填一次密码——这不是 bug,是设计上的安全强制项。


















