如何用HeidiSQL连接WSL部署的GridDB？连接失败求助
2026-7-7
解决主机HeidiSQL连接WSL中GridDB的问题
一、调整GridDB监听配置
GridDB默认只监听本地回环地址，得改配置让它对外提供服务：
- 找到GridDB配置文件，一般在
/var/lib/gridstore/conf/gs_cluster.json或者/opt/griddb/conf/gs_cluster.json - 修改
notificationAddress和notificationMember里的IP为WSL的实际局域网IP（WSL里输hostname -I就能查），或者直接设为0.0.0.0允许所有地址访问 - 重启GridDB服务：
sudo systemctl restart gridstore
二、确认网络连通性
- 先在WSL里检查端口监听：
netstat -tulpn | grep 20001，确认GridDB的SQL服务（默认端口20001）在正常监听 - 主机端用telnet测试：
telnet <你的WSL_IP> 20001，能通说明网络没问题；不通的话检查WSL和Windows的防火墙：- WSL里关闭防火墙测试：
sudo ufw disable - Windows里打开 Defender 防火墙的“高级设置”，添加入站规则允许20001端口
- WSL里关闭防火墙测试：
三、HeidiSQL连接参数设置
- 连接类型选
MySQL（GridDB兼容MySQL协议） - 主机地址填WSL的实际IP别用localhost（localhost指向主机本身，不是WSL）
- 端口填
20001 - 用户名默认是
admin，密码默认是admin - 数据库栏可以留空，连接成功后再选择对应的库
四、Docker部署额外注意（如果用容器跑GridDB）
要是在WSL里用Docker部署，除了加--network host，还要：
- 确保容器内的GridDB配置监听
0.0.0.0 - 启动容器时可以显式映射端口：
docker run -p 20001:20001 ...（和host模式二选一即可）
GridDB对SQL客户端的支持
GridDB兼容MySQL协议，所以支持绝大多数主流SQL客户端，包括：
- HeidiSQL、Navicat、DBeaver这类GUI工具
- mysql命令行客户端
- 支持JDBC/ODBC连接的各类应用程序
注意：GridDB的SQL语法和MySQL存在部分差异，但基础的连接、查询、增删改操作都能通过标准SQL客户端正常执行。
内容的提问来源于stack exchange，提问作者Hassan Ubaid
相关产品推荐
相关产品推荐
