Navicat On-Prem Server 必须部署在企业内网或私有云（如VMware、阿里云VPC），绑定固定内网IP，通过Nginx反向代理暴露HTTPS，并配置X-Forwarded-Proto头；所有成员须使用组织域邮箱（如zhangsan@corp.internal）统一注册并分配角色，数据库连接需在服务端新建并加密同步，BI工作区等对象须通过复制粘贴方式共享。
Navicat On-Prem Server 必须独立部署在内网或私有云，不能用公网直连
直接把 on-prem server 装在开发机或笔记本上，对外暴露 80/443 端口，是常见错误。它会立刻触发防火墙拦截、ssl 证书不匹配、跨域请求失败等现象，导致成员点击“管理账户”后白屏或报 err_connection_refused。
正确做法是：在企业自有 IDC 或私有云（如 VMware vSphere、OpenStack、阿里云专有网络 VPC）中部署一台 Linux 服务器（推荐 Ubuntu 22.04 LTS 或 CentOS 7.9+），绑定固定内网 IP，并通过反向代理（Nginx）暴露 HTTPS 端口。域名需提前配置好（例如 navicat-onprem.corp.internal），且所有团队成员的 Navicat 客户端必须能解析该域名。
- 安装包从 Navicat 官网下载
Navicat_OnPrem_Server_Linux_x64.tar.gz，解压后运行./start.sh - Nginx 配置中必须包含
proxy_set_header X-Forwarded-Proto $scheme;，否则登录页会反复跳转 - 不要修改默认的
/opt/navicat-onprem数据目录路径，否则升级时可能丢失项目元数据
成员添加和权限分配必须通过组织账户统一管理，不能本地账号直登
如果让成员用自己的 Navicat Cloud 账号（比如个人 Gmail 注册的）直接登录 On-Prem Server，会出现“项目不可见”“对象无法拖拽共享”等问题——因为 On-Prem Server 默认只信任其所属组织域下的账户。
必须在 On-Prem Server 后台进入 高级配置 → 组织账户 → 所有用户，手动添加成员邮箱（如 zhangsan@corp.internal），并为其分配角色（Project Admin / Developer / Viewer）。角色决定能否拖拽共享 BI 工作区、能否编辑代码段 SQL 内容、能否导出查询执行计划等。
- 新成员添加后，需等 2–3 分钟同步完成，立即登录可能仍显示空项目列表
-
Viewer角色无法右键导出查询结果为 Excel，但可以双击打开并复制表格内容 - 删除成员不会自动清除其创建的代码段，需由
Project Admin进入项目 → “代码段” → 手动删掉归属为该用户的条目
数据库连接必须走项目绑定，不能直接复用本地连接配置
很多用户以为把本地已配好的 MySQL 连接（含 SSH 隧道或 SSL 参数）拖进 On-Prem Server 就能共享，结果其他成员点开就报 Connection refused (111) 或 Access denied for user。这是因为连接凭据未加密同步，且 SSH 密钥、SSL 证书路径等本地绝对路径在他人机器上根本不存在。
正确流程是：在 On-Prem Server 中新建连接（所有项目 → 项目名 → + 新建连接），填写目标库的 IP、端口、用户名、密码（密码由 On-Prem Server 加密存储），并显式开启 使用 SSH 隧道 或 启用 SSL 开关——此时系统会引导上传公钥文件或 PEM 证书，这些资源将随连接一同同步给所有成员。
- MySQL 8.0+ 的 caching_sha2_password 插件需在连接属性中勾选
使用旧版认证协议，否则部分成员客户端会卡在登录界面 - PostgreSQL 连接若启用了
SSL mode = require，则必须上传root.crt，否则 Navicat 客户端报server certificate verification failed - 连接测试成功后，才可将其关联到具体项目；未关联的连接对成员不可见
BI 工作区和模型对象共享需绕过导航窗格，用“复制→粘贴”方式导入
BI 工作区、ER 图、数据模型这类对象不会出现在 Navicat 客户端左侧导航窗格里，因此无法像“查询”或“代码段”那样直接拖拽到 On-Prem Server 下的同名节点。强行拖拽只会无响应或弹出“不支持的操作”提示。
必须先在本地 Navicat 中打开对应对象（例如双击一个 BI 工作区），点击顶部菜单栏 编辑 → 复制（快捷键 Ctrl+C），然后在 On-Prem Server 项目的对象窗格中右键 → 粘贴。粘贴后对象即刻入库，并在所有成员的 BI Viewer 中可见。
- 复制前请确认当前 BI 工作区未处于“正在运行查询”状态，否则粘贴内容为空白画布
- 粘贴后的 BI 工作区默认名称带时间戳（如
sales_dashboard_20260421_1523），建议右键重命名为语义化名称 - 若工作区引用了本地 CSV 文件路径，粘贴后该数据源会失效，需由成员在自己机器上重新绑定同名 CSV（On-Prem Server 不同步文件内容）
跨地域协同真正卡点不在部署，而在 DNS 解析一致性与组织账户域的强制对齐——哪怕上海和法兰克福的成员都装了最新版 Navicat Premium 17，只要其中一人本地 hosts 文件把 navicat-onprem.corp.internal 指向了错误 IP，整个项目的对象同步就会静默中断。
