先确认ClickHouse服务是否运行且8123端口已监听：执行systemctl status clickhouse-server检查状态，再用netstat -tulnp | grep :8123验证端口；若无输出，常见原因是被注释或为127.0.0.1，需改为0.0.0.0并开放防火墙。

为什么连不上8123端口？先确认服务端是否真在监听

绝大多数连接失败，不是DBeaver配错了，而是ClickHouse压根没开HTTP接口。别急着调客户端，先登录服务器跑两行命令：

• systemctl status clickhouse-server —— 看服务是不是 active (running)
• netstat -tulnp | grep :8123 —— 如果没输出，说明HTTP端口根本没启动

常见原因有两个： 被注释了，或者 写成了 127.0.0.1（只允许本机连）。必须改成 0.0.0.0 或具体外网IP，并且确保防火墙放行该端口。

驱动下载失败？手动指定Maven坐标更可靠

DBeaver内置的“自动下载驱动”经常卡在墙外仓库或版本过旧。直接填坐标比点“下载”按钮快得多：

• 打开 窗口 → 首选项 → 连接 → 驱动 → Maven
• 点击“添加”，填入阿里云镜像地址：https://maven.aliyun.com/repository/public
• 回到驱动列表，搜索 clickhouse-jdbc，选 4.0.0 或更高稳定版（3.x 在新版ClickHouse上会报 Unknown type: Decimal256）

如果公司内网禁Maven，就去 Maven Central 手动下jar包，用“添加文件”导入。

新建连接时关键参数不能乱填

选中ClickHouse驱动后，填连接信息这一步，三个字段最容易出错：

DrugBank 数据库

访问并分析来自 DrugBank 数据库的全面药物信息，包括药物属性、相互作用、靶点、通路、化学结构和药理学数据。用于药物数据、药物发现研究、药理学研究、药物-

下载

• 主机：填服务器IP，不是 localhost（除非你在服务端本机连）
• 端口：必须是 8123，不是 9000（TCP端口不走JDBC）
• 数据库：填 default 或你建好的库名；留空会连上但看不到表（DBeaver默认不自动列出系统库）

用户名密码默认是 default / 空，但如果改过 /etc/clickhouse-server/users.xml，就得按实际配置来。别信网上教程说“随便填”，权限不对会直接报 Code: 192. DB::Exception: user default is not allowed to connect。

连上了却查不了表？检查DBeaver的元数据加载设置

连接成功但左侧树形目录里只有“default”库、点不开表，大概率是元数据加载被限制了：

• 右键连接 → 编辑连接 → 初始化 → 取消勾选“仅加载当前数据库对象”
• 再右键连接 → 重新连接，等几秒，表结构就会刷出来
• 如果仍不显示，进 连接设置 → 高级，把 use_server_time_zone 设为 false（某些时区配置会导致元数据查询超时）

这个步骤常被忽略，尤其当ClickHouse开了 readonly=1 或用户权限受限时，DBeaver会静默跳过表结构拉取，而不是报错提示。