必须填127.0.0.1而非localhost,ssh隧道端口需与navicat端口一致,ssh页用户名为虚拟机系统账户名,mysql需授权远程访问并开放防火墙,navicat必须为原生arm64架构。

能连,但必须同时满足三个条件:SSH隧道配置正确、MySQL服务开放远程访问、Navicat运行在原生ARM64架构下。缺一不可,尤其容易忽略最后一点。
为什么填 localhost 就报 Can't connect to local MySQL server through socket
Navicat 在 macOS 上遇到 localhost 会强制走 Unix domain socket(比如 /tmp/mysql.sock),完全绕过 TCP 协议栈;而 SSH 转发只处理 TCP 流量。所以哪怕你开了 SSH 隧道,填 localhost 也压根不会经过它。
- 常规连接页的「主机」必须填
127.0.0.1(不能是localhost,也不能是虚拟机真实 IP) - 端口填你本地监听的端口(例如
3307),这个端口要和 SSH 隧道命令里的本地端口一致 - 如果虚拟机里 MySQL 实际跑在
10.0.2.15:3306,那 SSH 隧道命令得是ssh -L 3307:10.0.2.15:3306 user@192.168.56.101,Navicat 常规页仍填127.0.0.1:3307
SSH 页用户名填错是最常见的连接失败原因
SSH 页的 Username 是 Linux 虚拟机的操作系统账户名,不是 MySQL 的 root 或其他数据库用户。填反了,Navicat 根本连不上跳板机,更别说转发了。
- 先在虚拟机终端执行
whoami确认真实用户名(常见为ubuntu、centos、vagrant,极少是root) - 私钥文件路径不能含空格、中文或
~符号,推荐用绝对路径如/Users/you/.ssh/vm_id_rsa - 私钥权限必须是
600:chmod 600 /path/to/vm_id_rsa,否则 OpenSSH 底层直接拒绝加载 - 测试时若提示
Permission denied (publickey),90% 是用户名和私钥不匹配,或虚拟机/etc/ssh/sshd_config里PubkeyAuthentication yes没开
MySQL 必须显式授权远程访问,且防火墙要放行
默认 MySQL 只监听 127.0.0.1,虚拟机内部都连不上,更别说从 Mac 主机连了。光改 bind-address 不够,权限和网络策略都得动。
- 编辑 MySQL 配置文件(通常是
/etc/mysql/mysql.conf.d/mysqld.cnf),把bind-address改成0.0.0.0或注释掉 - 登录 MySQL 执行:
CREATE USER 'navicat_user'@'%' IDENTIFIED BY 'strong_pass';,再执行GRANT ALL ON *.* TO 'navicat_user'@'%'; FLUSH PRIVILEGES; - CentOS 7+/Rocky Linux 8+ 用
firewall-cmd --permanent --add-port=3306/tcp+firewall-cmd --reload;Ubuntu 用ufw allow 3306 - 确认虚拟机 IP 是桥接/NAT 模式下的可路由地址(
ip addr show查,别用docker0或veth*接口的 IP)
Navicat 必须是原生 ARM64 版,否则 SSH 隧道和 SSL 连接大概率失败
很多人装了 Navicat 却没注意架构——Universal 包或 Intel 包在 M 芯片上靠 Rosetta 2 模拟运行,SSH 密钥加载、OpenSSL 握手、甚至部分 UI 渲染都会异常。
- 右键 Navicat →「显示简介」→「通用」标签页里「架构」必须是
ARM64,不是Intel或Universal - 终端执行:
file /Applications/Navicat\ Premium.app/Contents/MacOS/Navicat,输出里必须含arm64 - 官网下载页要手动找带
ARM64字样的 dmg(例如Navicat_Premium_17.0.1_ARM64.dmg),别点默认推荐的 Universal 包 - 安装前务必杀掉所有 Navicat 进程(包括后台的
Navicat Helper),否则旧版配置残留会导致隧道认证失败
最常被忽略的是:SSH 隧道成功 ≠ MySQL 连接成功。隧道只是打通了 TCP 通路,后面 MySQL 用户权限、bind-address、防火墙、Navicat 架构这四关,任意一关卡住都会静默失败或报错错位。建议按顺序逐项验证,别跳步。











