Mac版Navicat不支持SSH隧道配置,必须通过系统级ssh -L端口转发将远程数据库映射至localhost端口,再以localhost:端口方式连接,并确保跳板机AllowTcpForwarding开启、数据库账号授权跳板机IP、防火墙放行且SSH进程持续运行。

Mac版Navicat不支持SSH隧道配置,但能用系统级端口转发绕过
Mac版Navicat(包括Premium、MySQL等所有版本)**没有SSH配置页**,连接设置里根本看不到“SSH通道”选项。你填了SSH参数、导入Windows配置、甚至改plist文件,它都直接忽略——连接仍是纯TCP直连,而远程Linux虚拟机通常只允许跳板机或内网访问。
唯一可靠路径是:用macOS终端执行ssh -L把每台虚拟机的数据库端口映射到本地不同端口,再让Navicat连localhost:3307、localhost:3308这类地址。这不是“替代方案”,而是必须步骤。
- 确保每台Linux虚拟机已开启
sshd,且/etc/ssh/sshd_config中AllowTcpForwarding yes已启用 - 跳板机(或目标虚拟机本身)需允许你的Mac IP SSH登录;若用密钥登录,提前运行
ssh-add ~/.ssh/id_rsa - 端口别冲突:比如第一台映射
ssh -L 3307:192.168.56.101:3306 user@vm1,第二台就用3308,不能都用3306 - 加
-N -f后台运行:ssh -L 3307:192.168.56.101:3306 user@vm1 -N -f,否则关掉终端就断连
连接名、分组与颜色标记要按虚拟机角色来设计
Mac版Navicat 17+ 的“管理连接”界面不是装饰——它是管理多台虚拟机的核心操作区。靠连接名写“test-db-01”这种命名毫无意义,容易混淆哪台对应哪个环境。
正确做法是:右键连接 → “管理组” → 新建组,命名为dev-vms、staging-vms或docker-hosts;再为每组内连接指定颜色(比如红色=生产类虚拟机,黄色=测试环境),并打星标标出日常高频使用的那1–2台。
- 组名避免模糊词如“my-servers”,用能体现网络拓扑或职责的词,例如
aws-ec2-centos7、vbox-ubuntu22-dev - 颜色标记后,导航窗格一眼识别风险等级:红色组里的连接双击前会下意识停顿确认
- 不要给所有连接都打星标——星标失去筛选意义;只标真正每天要连的那几个
测试连接前必须用telnet或nc验证本地端口是否通
很多人点“测试连接”失败就反复改Navicat里的用户名密码,其实问题根本不在这儿。Navicat报Connection refused或Can't connect to MySQL server,90%是ssh -L没生效,或转发链路中途被中断。
Navicat Premium 17.1 Windows x64 历史系列获取入口。该系列扩展 Garnet、PolarDB 等连接支持,并增强可视化查询解释与 Redis 树视图;未核实到公开固定安装包直链。
在Mac终端执行:telnet localhost 3307(或nc -zv localhost 3307)。如果返回Connected to localhost,说明端口映射成功;如果报Connection refused,说明SSH进程已退出、目标虚拟机宕机、或防火墙拦截了跳板机到数据库的3306端口。
-
ps aux | grep "ssh -L 3307"确认SSH转发进程还在运行 - 若用
-f后台运行但没配免密,进程会卡在密码提示,导致转发失败 - 某些企业网络会重置空闲SSH连接,加
-o ServerAliveInterval=60保活
数据库账号权限必须授权跳板机IP,不是你的Mac IP
这是最常被跳过的权限检查点。你在Navicat里填的是localhost,但实际数据流是:Navicat → Mac本地端口 → SSH转发 → 跳板机 → 内网虚拟机数据库。所以数据库的GRANT语句里,host必须是跳板机的内网IP(比如'appuser'@'10.0.2.15'),而不是'appuser'@'%'或'appuser'@'192.168.x.x'(你的Mac局域网IP)。
登录目标虚拟机MySQL执行:SELECT host, user FROM mysql.user;,确认该账号host列匹配跳板机IP。不匹配就立刻改:
GRANT SELECT,INSERT ON mydb.* TO 'appuser'@'10.0.2.15' IDENTIFIED BY 'pwd123';
- 改完执行
FLUSH PRIVILEGES; - 若跳板机有多网卡(如同时有eth0和docker0),确认用的是它访问虚拟机时实际走的那张网卡IP
- PostgreSQL同理,检查
pg_hba.conf里host行的CIDR是否包含跳板机IP
复杂点在于:端口转发、数据库权限、SSH保活、Navicat分组这四层必须全部对齐,漏掉任何一层都会表现为“连不上”,但错误信息完全一样。调试时别从Navicat开始,先从telnet localhost:端口这一步切进去。

















