Ubuntu 22.04 安装 DBeaver 26.2.3 指南

目标：在 Ubuntu 22.04 桌面机上从零安装 DBeaver Community 26.2.3（Apache 2.0 开源多数据库管理工具），覆盖「官方 deb 直装、官方 apt 仓库、tar.gz 免安装」三条实测路线，并给出升级/降级、多版本共存、卸载与排障的完整闭环。本文全部命令与回显均在 Ubuntu 22.04（x86_64）环境逐条实测通过（DBeaver 26.2.3，构建号 26.2.3.202610181708；deb 包 md5 实测校验通过）。

一、环境信息

操作系统：Ubuntu 22.04 LTS（x86_64），演示环境为最小化安装（无预装桌面组件）
安装对象：DBeaver Community Edition 26.2.3（2026-10-18 发布，构建号 26.2.3.202610181708）
安装包：dbeaver-ce-26.2.3-linux-x86_64.deb，大小 128128776 字节（约 122 MiB）
内置运行时：发行包自带 Eclipse Temurin JRE 25.0.4.1+1，无需系统预装 Java
运行时系统依赖：SWT 需要 GTK 3 运行库（桌面版 Ubuntu 22.04 已内置；最小化安装需手动补装，见「七、常见问题」实测排障）
数据目录：~/.local/share/DBeaverData/（工作区 workspace6/、驱动缓存 drivers/）
官方渠道：
- 官网下载页：https://dbeaver.io/download/
- 官方 apt 仓库：https://dbeaver.io/debs/dbeaver-ce（GPG 公钥 https://dbeaver.io/debs/dbeaver.gpg.key）
- GitHub Releases：https://github.com/dbeaver/dbeaver/releases

⚠️ 版本时效说明（2026-10-20 实查）：官网 dbeaver-ce-latest 直链当前指向 26.2.3；官方 apt 仓库内最新为 26.2.2（仓库同步滞后官网约一个补丁版）。追最新版请走方案 A 的 deb 直装；用仓库方式会得到 26.2.2，功能差异见 dbeaver.io 版本新闻页。

二、前置条件

一台 Ubuntu 22.04 桌面机（或带图形环境的服务器）：DBeaver 是桌面 GUI 应用，需要图形显示环境（X11/Wayland）才能打开主窗口；
具备 sudo 权限的普通用户；
网络可达 dbeaver.io（下载安装包/校验文件）与 repo.maven.apache.org（首次连接数据库时自动下载 JDBC 驱动）；
磁盘空间 ≥ 1.5 GiB（安装约 400 MiB + 驱动缓存 + 工作区）。

基础工具检查与准备：

lsb_release -ds && uname -m

实测回显：

Ubuntu 22.04.5 LTS
x86_64

三、版本选型说明

DBeaver 分社区版（Community Edition，dbeaver.io 分发，Apache 2.0）与商业版（Lite/Enterprise/Ultimate，dbeaver.com 分发）。本文安装社区版。可用版本与获取形态对照（2026-10-20 实查）：

获取形态	当前版本	说明
官网 deb 直装（方案 A）	26.2.3	`dbeaver-ce-latest` 直链始终指向最新稳定版，追新首选
官方 apt 仓库（方案 B）	26.2.2	仓库同步滞后，但可持续接收更新，运维托管友好
官网 tar.gz（方案 C）	26.2.3	免 root、免安装目录污染、可多版本并存

💡 说明：社区版更新节奏约每两周一个补丁版（26.2.2 于 2026-10-05、26.2.3 于 2026-10-18 发布）。历史版本可在官网 Archive（https://dbeaver.io/download/archives/ 或 https://dbeaver.io/files/<版本号>/ 路径）获取。

四、方案 A：官方 deb 直装（推荐，版本最新）

本方案直接安装官网最新 deb 包：版本最新、单命令完成、依赖自动处理；代价是升级需要重新下载 deb。适合绝大多数桌面用户。

4.1 下载安装包

cd ~
wget -O dbeaver-ce-latest-linux-x86_64.deb https://dbeaver.io/files/dbeaver-ce-latest-linux-x86_64.deb

实测回显（重定向链节选，完整过程为两次 302 跳转后落盘）：

--2026-10-20 04:01:31--  https://dbeaver.io/files/dbeaver-ce-latest-linux-x86_64.deb
HTTP request sent, awaiting response... 302 Found
Location: https://dbeaver.io/files/26.2.3/dbeaver-ce-26.2.3-linux-x86_64.deb [following]
--2026-10-20 04:01:31--  https://dbeaver.io/files/26.2.3/dbeaver-ce-26.2.3-linux-x86_64.deb
HTTP request sent, awaiting response... 302 Found
Location: https://github.com/dbeaver/dbeaver/releases/download/26.2.3/dbeaver-ce-26.2.3-linux-x86_64.deb [following]

⚠️ 注意：官方文件链最终落在 GitHub Releases（github.com/dbeaver/dbeaver/releases/download/26.2.3/...）。直连 GitHub 不畅的网络可先给终端配代理（export https_proxy=http://<代理地址>:<端口>）再执行 wget，或在本机浏览器下载后传到目标机；无论哪条路径，下载完都要按 4.2 校验 md5。

本文实测所用安装包落盘后校验值（与官方 md5 文件一致）：0cf92522d04ccfe82eb616b8122675ce，大小 128128776 字节（约 122 MiB）。

4.2 校验 md5

官方提供校验文件（内容为裸哈希），下载后与本地文件 md5 比对：

md5sum dbeaver-ce-latest-linux-x86_64.deb
curl -sSL https://dbeaver.io/files/checksum/dbeaver-ce-latest-linux-x86_64.deb.md5

实测回显：

0cf92522d04ccfe82eb616b8122675ce  dbeaver-ce-latest-linux-x86_64.deb
0cf92522d04ccfe82eb616b8122675ce

两个值一致，安装包完整。

4.3 安装

sudo apt install ./dbeaver-ce-latest-linux-x86_64.deb

实测回显（输出节选）：

Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'dbeaver-ce' instead of './dbeaver-ce-latest-linux-x86_64.deb'
Unpacking dbeaver-ce (26.2.3) ...
Setting up dbeaver-ce (26.2.3) ...

💡 说明：deb 包不带 Depends 依赖声明（dpkg -I 实查无 Depends 字段），JRE 与 SWT 库全部内置；但 SWT 运行时需要系统提供 GTK 3 运行库——Ubuntu 22.04 桌面版已内置，最小化安装的系统需要在安装后补装 libgtk-3-0 libgl1（排障实录见「七、常见问题」Q1）。

4.4 验证安装

dpkg -l dbeaver-ce

实测回显：

ii  dbeaver-ce     26.2.3       amd64        DBeaver Community

包内文件布局（dpkg -L dbeaver-ce 输出节选）：

/usr/bin/dbeaver
/usr/share/applications/dbeaver-ce.desktop
/usr/share/dbeaver-ce
/usr/share/dbeaver-ce/dbeaver
/usr/share/dbeaver-ce/dbeaver.ini
/usr/share/dbeaver-ce/dbeaver.png
/usr/share/dbeaver-ce/features
/usr/share/dbeaver-ce/jre
/usr/share/dbeaver-ce/licenses
/usr/share/dbeaver-ce/plugins

启动命令验证（需要图形环境；帮助信息不进主界面即可打印）：

dbeaver --help

实测回显（输出节选）：

DBeaver 26.2.3
Usage: dbeaver [-hqv] [-bringToFront=(boolean)] [-closeTabs=(boolean)] [--debug-logs=(boolean)] [-disconnectAll=(boolean)] [-dump=(boolean)] [-newInstance=(boolean)] [-nosplash=(boolean)] [-reuseWorkspace=(boolean)] [-stop=(boolean)] [-data=<data(string)>] [-nl=<nl(string)>] [--output-log=<outputLog(string)>] [-con=<connectionSpec>] [-q=(boolean)] [-source=<file>] [-f=<files>]... [filesToOpen...]

再确认版本号参数：

dbeaver -v

实测回显：

DBeaver 26.2.3.202610181708

4.5 桌面启动方式

安装包已注册桌面入口（/usr/share/applications/dbeaver-ce.desktop，实测内容）：

[Desktop Entry]
Version=1.0
Type=Application
Terminal=false
Name=dbeaver-ce
GenericName=Universal Database Manager
Comment=Universal Database Manager and SQL Client.
Path=/usr/share/dbeaver-ce/
Exec=env NO_AT_BRIDGE=1 /usr/share/dbeaver-ce/dbeaver %U
Icon=/usr/share/dbeaver-ce/dbeaver.png
Categories=IDE;Development
StartupWMClass=DBeaver
StartupNotify=true
Keywords=Database;SQL;IDE;JDBC;ODBC;MySQL;PostgreSQL;Oracle;DB2;MariaDB
MimeType=application/sql

在应用菜单搜索「dbeaver」即可启动；命令行启动等价于 Exec 行：env NO_AT_BRIDGE=1 /usr/share/dbeaver-ce/dbeaver。

五、方案 B：官方 apt 仓库（可持续更新，版本略滞后）

本方案把官方仓库加入 apt 源，之后用 apt upgrade 常态化升级，适合需要统一软件源管理的运维场景。注意仓库同步滞后官网（2026-10-20 实查为 26.2.2）。

5.1 导入官方 GPG 公钥

sudo apt install -y curl gnupg
curl -fsSL https://dbeaver.io/debs/dbeaver.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/dbeaver.gpg

实测回显：

key-ok

（--dearmor 转换为二进制密钥环，无报错即为成功；echo $? 返回 0 可二次确认。）

5.2 写入仓库源

echo "deb [signed-by=/usr/share/keyrings/dbeaver.gpg] https://dbeaver.io/debs/dbeaver-ce /" | sudo tee /etc/apt/sources.list.d/dbeaver.list

实测回显：

deb [signed-by=/usr/share/keyrings/dbeaver.gpg] https://dbeaver.io/debs/dbeaver-ce /

💡 说明：行尾的 / 表示该仓库是「flat 仓库」结构（InRelease/Packages 元数据直接位于仓库根目录，不使用 dists/<套件> 层级），这是 DBeaver 官方仓库的形态，照抄即可，不要改成 dists 风格。

5.3 更新索引并安装

sudo apt update

实测回显（输出节选，dbeaver 仓库相关行）：

Get:3 https://dbeaver.io/debs/dbeaver-ce  InRelease [2086 B]
Get:5 https://dbeaver.io/debs/dbeaver-ce  Packages [669 B]
Fetched 2755 B in 1s (1841 B/s)
Reading package lists...

💡 说明：flat 仓库的 InRelease（约 2 KB）与 Packages（数百字节）都很小，首次抓取后后续更新为 Hit: 状态行；行号（Get:3/Get:5）取决于系统里其他 apt 源的数量，属正常现象。

查看候选版本：

apt-cache policy dbeaver-ce

实测回显（未安装 deb 直装包时的原始状态）：

dbeaver-ce:
  Installed: (none)
  Candidate: 26.2.2
  Version table:
     26.2.2 500
        500 https://dbeaver.io/debs/dbeaver-ce  Packages

安装：

sudo apt install -y dbeaver-ce

实测回显（输出节选）：

Unpacking dbeaver-ce (26.2.2) ...
Setting up dbeaver-ce (26.2.2) ...

验证：

dpkg -l dbeaver-ce && dbeaver --help 2>&1 | head -1

实测回显：

ii  dbeaver-ce     26.2.2       amd64        DBeaver Community
DBeaver 26.2.2

5.4 仓库版升级到最新（以 26.2.3 为例）

仓库未同步新版时，直接用官网 deb 覆盖安装即可（dpkg 原生支持「over 升级」）：

wget -O /tmp/dbeaver-ce-26.2.3-linux-x86_64.deb https://dbeaver.io/files/26.2.3/dbeaver-ce-26.2.3-linux-x86_64.deb
sudo dpkg -i /tmp/dbeaver-ce-26.2.3-linux-x86_64.deb

实测回显（输出节选）：

Unpacking dbeaver-ce (26.2.3) over (26.2.2) ...
Setting up dbeaver-ce (26.2.3) ...
ii  dbeaver-ce     26.2.3       amd64        DBeaver Community

六、方案 C：tar.gz 免安装（免 root、多版本并存）

本方案下载官方 tar.gz 解压即用：不写系统目录、不需要 root、可按目录并存多个版本；代价是不注册桌面菜单、升级需手动换目录。适合无 sudo 权限的工位或需要并行验证多版本的场景。

6.1 下载并解压

cd /tmp
wget https://dbeaver.io/files/dbeaver-ce-latest-linux-x86_64.tar.gz
sudo tar -xzf dbeaver-ce-latest-linux-x86_64.tar.gz -C /opt
ls /opt/dbeaver

实测回显：

configuration
dbeaver
dbeaver.ini
dbeaver.png
features
jre
licenses
p2
plugins
readme.txt

6.2 确认内置 JRE

tar 包自带运行时，无系统 Java 也能跑：

/opt/dbeaver/jre/bin/java -version

实测回显：

openjdk version "25.0.4.1" 2026-08-18 LTS
OpenJDK Runtime Environment Temurin-25.0.4.1+1 (build 25.0.4.1+1-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.4.1+1 (build 25.0.4.1+1-LTS, mixed mode)

6.3 启动验证

cd /opt/dbeaver && ./dbeaver --help 2>&1 | head -1

实测回显：

DBeaver 26.2.3

主界面启动：桌面会话中直接执行 /opt/dbeaver/dbeaver（或双击目录内 dbeaver 图标）。

⚠️ 注意：tar 包的配置（Eclipse configuration/）保存在解压目录内；官方 readme 明确提示不要解压到旧版本所在目录（多版本并存时每个版本用独立目录，如 /opt/dbeaver-26.2.3）。

6.4 方案对比与选择建议

维度	A：deb 直装	B：apt 仓库	C：tar.gz
当前版本	26.2.3（最新）	26.2.2（滞后一个补丁）	26.2.3（最新）
是否需 root	需要	需要	不需要
升级方式	重新下载 deb	`sudo apt upgrade`	手动换目录
桌面菜单	自动注册	自动注册	无
卸载干净度	apt remove	apt remove	rm -rf 目录
适用	个人桌面首选	统一源管理/批量运维	无 sudo/多版本并存

选择建议：个人桌面机选 A（版本最新、一步到位）；需要纳入统一 apt 源管理或服务器批量部署选 B；无 sudo 权限或要并行跑多个版本选 C。

七、常见问题（FAQ）

Q1：启动或执行 dbeaver --help 报 SWT OS.java Error，提示 Failed to load swt-pi3？

最小化安装的 Ubuntu 22.04（无桌面组件）缺少 SWT 依赖的 GTK 运行库，实测报错如下：

SWT OS.java Error: Failed to load swt-pi3, loading swt-pi4 as fallback.
Error: Cant load library: /usr/share/dbeaver-ce/configuration/org.eclipse.osgi/589/0/.cp/libswt-pi4-gtk-4964r7.so
...
java.lang.UnsatisfiedLinkError: Could not load SWT library. Reasons:
	no swt-pi4-gtk-4964r7 in java.library.path
	...

解决：补装 GTK 运行库（桌面版已预装，无需此步）：

sudo apt install -y libgtk-3-0 libgl1

实测补装后 dbeaver --help 正常输出 DBeaver 26.2.3 / Usage: dbeaver ...。若还缺嵌入式浏览器组件（欢迎页/登录页加载），可再补 libwebkit2gtk-4.0-37。

Q2：SSH 终端里启动报 Cannot open display / SWTError: No more handles [gtk_init_check() failed]？

DBeaver 是 GUI 程序，进程必须能连到图形显示（X11/Wayland）。SSH 纯终端会话没有 DISPLAY，实测报错（工作区日志 .log 原文节选）：

!MESSAGE Application error
!STACK 1
org.eclipse.swt.SWTError: No more handles [gtk_init_check() failed]
        at org.eclipse.swt.SWT.error(SWT.java:4964)
        at org.eclipse.swt.widgets.Display.createDisplay(Display.java:1207)
        at org.eclipse.swt.widgets.Display.create(Display.java:1131)
        at org.eclipse.swt.graphics.Device.<init>(Device.java:188)
        at org.eclipse.swt.widgets.Display.<init>(Device.java:637)
        at org.eclipse.swt.widgets.Display.<init>(Device.java:628)

解决：在桌面会话的终端里启动；确实需要在 SSH 场景运行时，用 X11 转发（ssh -X）或虚拟显示（Xvfb）。DBeaver 没有「无界面/headless」运行模式——它的 CLI 参数（-con/-f 等）本质是「带参启动 GUI」，详见《DBeaver 26.2.3 配置与 CLI 参数详解》。

Q3：启动报 Permission denied ... /usr/share/dbeaver-ce/configuration/.../.fileTableLock？

Eclipse 体系要在 configuration/ 下写锁文件。若曾用 sudo dbeaver 启动过，该目录下会生成 root 属主的运行文件，普通用户再启动即报：

Error reading configuration: /usr/share/dbeaver-ce/configuration/org.eclipse.osgi/.manager/.fileTableLock (Permission denied)

解决：清掉 root 生成的运行态文件并保持「普通用户运行」习惯：

sudo rm -rf /usr/share/dbeaver-ce/configuration/org.eclipse.osgi/.manager

Q4：apt 仓库里怎么没有最新版？

官方仓库同步滞后官网是常态（2026-10-20 实查：仓库 26.2.2、官网 26.2.3）。apt-cache policy dbeaver-ce 看 Candidate 版本即可确认；追新版走方案 A 的 deb 直装，或按 5.4 节用 deb 覆盖仓库版。

Q5：首次连接数据库时弹出「Download driver files」怎么办？

内置的是驱动定义（139 个数据库驱动定义，2026-10-20 实查启动日志），JDBC jar 本体在首次连接时从 Maven Central 下载，弹出确认框点 Download 即可；离线环境通过 GUI 的 Driver Manager 手动导入 jar，下载缓存在 ~/.local/share/DBeaverData/drivers/（连接实战详解见《DBeaver 26.2.3 数据库连接与操作实战》）。

八、升级、降级与多版本管理

升级（deb 直装版）：重复方案 A，下载新版 deb 覆盖安装，用户数据（连接、脚本）在 ~/.local/share/DBeaverData/，升级不丢失。

升级（仓库版）：

sudo apt update && sudo apt upgrade dbeaver-ce

降级：先 apt-cache madison dbeaver-ce 查仓库内可用版本，再显式允许降级安装（实测从 26.2.3 降到仓库内的 26.2.2）：

apt-cache madison dbeaver-ce
sudo apt install -y --allow-downgrades dbeaver-ce=26.2.2

实测回显（输出节选）：

dbeaver-ce |     26.2.2 | https://dbeaver.io/debs/dbeaver-ce  Packages
Preparing to unpack .../dbeaver-ce_26.2.2_amd64.deb ...
Unpacking dbeaver-ce (26.2.2) over (26.2.3) ...
Setting up dbeaver-ce (26.2.2) ...
ii  dbeaver-ce     26.2.2       amd64        DBeaver Community

多版本并存：用方案 C，每个版本解压到独立目录（如 /opt/dbeaver-26.2.3、/opt/dbeaver-26.2.2），工作区可用 dbeaver -data <目录> 分开（避免不同版本共享同一工作区产生配置兼容问题）。

九、卸载与清理

# 卸载程序本体（deb/apt 两种安装形态通用）
sudo apt remove --purge dbeaver-ce

实测回显（输出节选）：

Removing dbeaver-ce (26.2.2) ...

# 清理仓库配置（用过方案 B 时）
sudo rm -f /etc/apt/sources.list.d/dbeaver.list /usr/share/keyrings/dbeaver.gpg
sudo apt update
# 清理用户数据（连接、脚本、驱动缓存；如需保留请先备份）
rm -rf ~/.local/share/DBeaverData
# tar 方案卸载
rm -rf /opt/dbeaver

十、参考链接

官方下载页（deb/tar/md5 校验文件）：https://dbeaver.io/download/
官方 Linux 安装文档：https://dbeaver.com/docs/dbeaver/install-on-linux-windows-mac-os/
官方 apt 仓库：https://dbeaver.io/debs/dbeaver-ce
历史版本归档：https://dbeaver.io/download/archives/
同专栏：《DBeaver 26.2.3 介绍与选型指南》《DBeaver 26.2.3 数据库连接与操作实战》《DBeaver 26.2.3 配置与 CLI 参数详解》