HTTP通道本质是将数据库请求封装为HTTP请求,经80/443端口转发至服务器端PHP脚本(如ntunnel_mysql.php),该脚本再本地连接MySQL;需上传脚本、配置正确参数并启用Base64编码。

HTTP通道不是“绕过”防火墙,而是换了一条路走
Navicat 的 HTTP 通道本质是让数据库操作请求不走 3306(或其他数据库端口),而是封装成 HTTP 请求,发给服务器上一个 PHP 脚本(如 ntunnel_mysql.php)。这个脚本在 Web 服务里运行,只依赖 80 或 443 端口——这两个端口通常默认开放,不像数据库端口那样被防火墙拦死。
所以它不破解防火墙规则,也不需要你去改 iptables 或云安全组放行 3306。只要你能用浏览器打开 http://your-domain.com/ntunnel_mysql.php 并看到空白页或提示“Invalid request”,就说明这条路通了。
必须上传并验证 ntunnel_mysql.php 脚本
Navicat 安装目录里自带这个文件(Windows 默认在 C:\Program Files\PremiumSoft\Navicat 17 Premium\ntunnel\,macOS 在 /Applications/Navicat Premium.app/Contents/Resources/tunnel/),但你不能直接用本地路径。必须:
- 把它上传到服务器 Web 根目录(如
/var/www/html/)或子目录(如/var/www/html/dbproxy/) - 确保 PHP 已安装且能执行 MySQL 扩展(
mysqli或pdo_mysql) - 用浏览器访问该地址,返回非 404 即可;若报错
500,检查 PHP 错误日志,常见原因是mysqli没启用或脚本里数据库连接参数写错了 - 脚本默认用
127.0.0.1:3306连本地 MySQL,如果你的数据库监听的是localhost或其他 IP,得手动改$host、$port、$user、$pass四个变量
Navicat 17 中 HTTP 通道设置的关键细节
新建 MySQL 连接时,选中「通过 HTTP 通道」,然后切换到「HTTP」选项卡。这里容易出错的地方有:
-
通道网址必须是完整 URL,以http://或https://开头,结尾不要加斜杠,例如:http://example.com/ntunnel_mysql.php - 务必勾选「使用 Base64 编码传出查询」,否则在读取表结构或数据库列表时大概率触发
700 Invalid response: 500错误——这和某些 WAF(如 Cloudflare、宝塔防火墙)拦截原始 SQL 字符串有关 - 「常规」选项卡里的
主机名/IP 地址填127.0.0.1(不是你的服务器公网 IP),因为 PHP 脚本是在服务器本地连库的 - 用户名和密码填数据库真实账号,不是 Web 服务器账号;端口也填数据库实际端口(如
3306),不是 HTTP 端口
为什么测试连接失败?先看这三类错误
常见错误现象和对应排查点:
-
Connection refused:脚本 URL 访问不通,检查是否上传成功、Web 服务是否运行、路径是否拼错(比如漏了.php后缀) -
700 Invalid response: 500:PHP 脚本执行出错,打开服务器 PHP 错误日志(如/var/log/apache2/error.log或/var/log/php-fpm/www-error.log),重点查 mysqli 连接失败或权限不足 -
Access denied for user:脚本里写的数据库账号密码不对,或该账号没被授权从localhost登录(注意:不是从 Navicat 所在机器登录,而是从 PHP 所在服务器本地登录)
HTTP 通道的瓶颈不在 Navicat,而在那个 PHP 脚本的执行环境——它既是桥梁,也是单点故障源。任何对 Web 服务、PHP 配置或数据库本地连接的改动,都可能让整个通道突然失效,这点比 SSH 隧道更隐蔽。


















