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是否启用<openssl></openssl>块,且<server></server>子节中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 里填的是 IP10.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中<https_port></https_port>决定。用错端口会直接返回连接拒绝,而非 SSL 错误 - 连接字符串示例(供排查参考):
jdbc:clickhouse://10.1.2.3:9440/default?ssl=true&sslmode=strict&sslrootcert=/path/to/ca.crt
最常被忽略的一点:Navicat Premium 15+ 虽支持 ClickHouse,但默认内置的 JDBC 驱动可能是旧版。务必手动替换为最新官方驱动,并在连接设置里指定驱动路径——否则所有 SSL 配置都白搭。










