Navicat连接ClickHouse SSL失败主因是服务端未启用SSL或客户端缺少可信CA证书;需确认config.xml中openSSL配置、证书路径权限及本地clickhouse-client测试,再正确填写CA证书(非server.crt),慎用“允许无效主机名”,并确保使用0.4.6+ JDBC驱动及正确HTTPS端口。
Navicat连接ClickHouse时SSL失败的典型现象
点“测试连接”后弹出
、
或直接卡在握手阶段,甚至 navicat 无提示静默断连——这些都不是网络不通或密码错,而是 ssl 链路在证书验证环节被拦下了。
根本原因就两个:要么服务器没开 SSL(
里
段没配或注释了),要么 Navicat 拿不到可信的证书链来校验服务端身份。别急着改客户端,先确认服务端状态:
登录 ClickHouse 服务器,检查
是否启用
块,且
子节中
和
路径真实存在、权限可读(如
)
运行
(假设 HTTPS 端口是 9440)本地测试,能通说明服务端 OK;不通则优先排查服务端配置
Navicat里填什么证书?CA、server、client三者怎么分
Navicat 的 SSL 设置页(“高级” → “使用SSL”勾选后展开)有三个关键字段:
、
、
。它们不是随便塞文件就能用的:
:必须是签发服务端证书的根证书(
或
)。如果服务端用的是 Let’s Encrypt 或其他公共 CA,Navicat 通常自带信任,可留空;但绝大多数私有部署用的是自签名 CA,这时必须填上该
的绝对路径
+
:仅当 ClickHouse 配置了双向认证(
)才需要。普通单向加密传输(只校验服务端)不用填这两项,填了反而可能因格式/密码错误导致连接失败
常见错误:把服务端的
当成 CA 证书填进
字段——这会导致证书链无法构建,必然失败
SSL Mode和“允许无效主机名”到底要不要开
Navicat 没有显式叫
的下拉菜单,但它行为等效于 JDBC 的
(默认)或
。真正起作用的是两个勾选项:
勾选
:等效
,强制走 TLS 握手
勾选
:绕过证书中
或
与你填写的主机名/IP 是否匹配的检查。比如证书是为
签发的,但你 Navicat 里填的是 IP
,不勾这个就会报
生产环境慎用
:它等于关闭主机名验证,中间人攻击风险上升。正确做法是让证书 SAN 包含你实际连接用的域名或 IP(如
)
JDBC驱动版本和端口选择直接影响SSL是否生效
Navicat 连 ClickHouse 底层依赖 JDBC 驱动(
),而 SSL 支持深度绑定驱动版本:
必须用
及以上版本(推荐
),老版本(如
)对 TLS 1.2+ 和 SNI 支持不全,容易握手失败
端口不能硬写
:SSL 启用后,ClickHouse 默认监听 HTTPS 端口(通常是
或
),这个值由
中
决定。用错端口会直接返回连接拒绝,而非 SSL 错误
连接字符串示例(供排查参考):
最常被忽略的一点:Navicat Premium 15+ 虽支持 ClickHouse,但默认内置的 JDBC 驱动可能是旧版。务必手动替换为最新官方驱动,并在连接设置里指定驱动路径——否则所有 SSL 配置都白搭。
ssl handshake failedcertificate verify failedconfig.xmlopenSSL/etc/clickhouse-server/config.xmlcertificateFileprivateKeyFilechown clickhouse:clickhouse /path/to/cert.pemclickhouse-client --ssl-mode=strict --host=127.0.0.1 --port=9440CA证书客户端证书客户端密钥CA证书ca.crtca.pemca.crt客户端证书客户端密钥verificationMode="required"server.crtCA证书sslmodesslmode=strictsslmode=none使用SSLssl=true允许无效主机名Subject Alternative Name (SAN)Common Name (CN)clickhouse-prod.internal10.1.2.3HostnameVerifier exception允许无效主机名IP:10.1.2.3clickhouse-jdbc0.4.60.6.0+0.3.x900084439440config.xmljdbc:clickhouse://10.1.2.3:9440/default?ssl=true&sslmode=strict&sslrootcert=/path/to/ca.crt