跳转到主内容
新派编程网 - 新潮编程理念,全新技术课堂!

Navicat连接ClickHouse如何配置SSL证书_加密传输开启方法

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

相关文章