需手动安装DBeaver以连接MySQL、达梦、OceanBase等数据库;推荐APT源安装,其次DEB包手动安装,最后可选解压即用版,所有方式均须前置配置匹配架构的JDK 11/17。

如果您在麒麟OS桌面系统中需要连接MySQL、达梦、OceanBase等多种数据库,但系统默认未预装图形化数据库管理工具,则需手动安装DBeaver这一跨平台开源客户端。以下是适用于银河麒麟V10及后续版本(含ARM64与x86_64架构)的多种安装方法:
一、通过APT源安装(推荐,适用于网络通畅且已配置有效软件源的Debian系麒麟OS)
该方法依赖麒麟OS官方或兼容的APT仓库,安装过程全自动,依赖由包管理器统一处理,无需手动干预Java环境或架构匹配问题,适合日常办公环境快速部署。
1、添加DBeaver官方APT仓库密钥与源地址:
sudo apt install curl gnupg -y && curl -fsSL https://dbeaver.io/debs/dbeaver.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/dbeaver.gpg
2、执行命令更新本地包索引:
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/dbeaver.gpg] https://dbeaver.io/debs/ stable main" | sudo tee /etc/apt/sources.list.d/dbeaver.list && sudo apt update
3、运行安装命令部署DBeaver社区版:
sudo apt install dbeaver-ce -y
4、安装完成后,在应用菜单中搜索DBeaver CE并点击启动,或在终端输入dbeaver运行。
二、下载DEB包手动安装(适用于离线环境、ARM64架构或需指定版本的场景)
当系统无法访问外部APT源,或需使用适配鲲鹏/飞腾处理器的aarch64版本(如v24.3.0)时,可直接获取官方构建的DEB安装包,规避源同步延迟与架构不匹配风险。
1、访问DBeaver官网下载页面,选择对应架构的最新DEB包:
https://dbeaver.io/download/ 务必确认架构为aarch64(ARM)或amd64(x86_64)
2、在麒麟OS中打开终端,切换至下载目录(例如~/Downloads):
cd ~/Downloads
3、使用dpkg命令安装DEB包:
sudo dpkg -i dbeaver-ce_*.deb
4、若提示依赖缺失,随后执行自动修复:
sudo apt --fix-broken install -y
5、验证安装是否成功:
which dbeaver && dbeaver --version
三、解压即用版安装(免root权限,适合受限环境或临时测试)
该方式不写入系统路径,所有文件保留在用户主目录下,无需管理员权限,启动前需手动指定JVM路径并确保Java环境就绪,适合快速验证连接能力。
1、从DBeaver官网下载Linux版tar.gz压缩包(标有“nojdk”字样):
https://dbeaver.io/files/ 必须选择与系统架构完全一致的-nojdk版本
2、解压至用户主目录下的~/Applications(可自定义):
mkdir -p ~/Applications && tar -xzf dbeaver-ce-*-linux.gtk.*-nojdk.tar.gz -C ~/Applications/
3、进入解压后目录,赋予可执行权限:
chmod +x ~/Applications/dbeaver/dbeaver
4、编辑dbeaver.ini文件,在首行插入JVM路径声明:
echo -e "-vm\n/usr/lib/jvm/java-17-openjdk-aarch64/bin" > ~/Applications/dbeaver/dbeaver.ini && echo "$(cat ~/Applications/dbeaver/dbeaver.ini)" >> ~/Applications/dbeaver/dbeaver.ini
5、直接运行启动脚本:
~/Applications/dbeaver/dbeaver
四、Java环境前置配置(关键依赖,所有安装方式均需满足)
DBeaver 24.x及以上版本强制要求JDK 11或JDK 17,且必须与系统CPU架构严格匹配;x86_64系统可直接apt安装openjdk-17-jdk,ARM64系统必须使用aarch64构建的OpenJDK 17或Oracle JDK 17。
1、执行命令检查当前Java版本:
java -version
2、若未安装或版本不符,x86_64系统执行:
sudo apt install openjdk-17-jdk -y
3、ARM64系统需手动安装aarch64版JDK 17:
wget https://download.oracle.com/java/17/latest/jdk-17_linux-aarch64_bin.tar.gz && sudo tar -xzf jdk-17_linux-aarch64_bin.tar.gz -C /usr/lib/jvm/ && sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-17/bin/java 1
4、验证Java路径是否生效:
update-alternatives --config java
5、确认JVM被DBeaver识别:
grep -A2 "^-vm$" ~/Applications/dbeaver/dbeaver.ini
五、桌面快捷方式与驱动补全(确保可从GNOME/UKUI菜单启动并支持MySQL等常用数据库)
仅安装二进制文件无法从应用菜单启动,且首次运行时DBeaver不会自动下载驱动;必须创建标准.desktop文件,并手动触发驱动下载或离线导入jar包,否则新建连接将失败。
1、创建标准.desktop文件:
sudo tee /usr/share/applications/dbeaver.desktop [Desktop Entry]
Version=1.0
Type=Application
Name=DBeaver Community
Comment=Universal Database Tool
Exec=/opt/dbeaver/dbeaver
Icon=/opt/dbeaver/icon.xpm
Terminal=false
StartupNotify=true
Categories=Development;Database;
Keywords=Database;SQL;IDE;JDBC;
StartupWMClass=DBeaver
MimeType=application/sql;
EOF
2、设置执行权限:
sudo chmod +x /usr/share/applications/dbeaver.desktop
3、启动DBeaver后,在数据库连接向导中选择MySQL,点击Download driver files按钮联网下载mysql-connector-j-8.2.0.jar
4、若内网无外网访问权限,需提前下载驱动jar包:
https://repo1.maven.org/maven2/com/mysql/mysql-connector-j/8.2.0/mysql-connector-j-8.2.0.jar
5、在DBeaver中进入Database → Driver Manager → MySQL → Edit → Libraries → Add File,导入该jar包。


















