Ubuntu 22.04 安装 Beekeeper Studio 6.1.6 指南

目标：在 Ubuntu 22.04 桌面环境从零安装 Beekeeper Studio 6.1.6 并完成启动验证。本文覆盖官方 apt 仓库、离线 deb 包、AppImage、Snap 四种安装方案的完整命令与实测回显，并给出降级/升级、排障与卸载方法。全部命令已在 Ubuntu 22.04（x86_64）实测通过。

一、环境信息

本文所有命令与回显均在以下环境实测采集：

项目	内容
操作系统	Ubuntu 22.04（x86_64，amd64 架构）
安装版本	Beekeeper Studio 6.1.6（官方当前最新稳定版，2026-10-07 发布）
官方 apt 源	`https://deb.beekeeperstudio.io`（stable/main）
官方 Snap	`snap install beekeeper-studio`（latest/stable，Rev 536）
AppImage	`Beekeeper-Studio-6.1.6.AppImage`（约 352MB）
离线 deb	`beekeeper-studio_6.1.6_amd64.deb`（约 281MB）
实测数据库（用于安装后验证）	MySQL 8.0.46、PostgreSQL 18.6、SQLite 3.37.2

💡 说明：Beekeeper Studio 是桌面 GUI 应用，无守护进程与服务端口；「安装完成」的标志是桌面应用可启动并呈现主界面。ARM64 设备（如树莓派）官方同样提供 deb/rpm/AppImage/Flatpak 包，命令相同、包名带 arm64 后缀（来源：docs.beekeeperstudio.io/installation/linux/，查询日期 2026-10-20）。

二、前置条件

安装前确认系统满足以下条件（每条给出核对命令）：

确认系统版本为 22.04 或更高（官方仓库声明支持 Debian/Ubuntu 22.04+）：

lsb_release -rs

实测回显：

22.04

确认架构（x86_64 或 aarch64 均受支持）：

uname -m

实测回显：

x86_64

安装基础下载工具（导入 GPG 密钥需要 curl 与 gnupg，最小化安装的系统可能缺失）：

sudo apt update
sudo apt install -y curl ca-certificates gnupg

实测回显（输出节选，实测首尾）：

正在读取软件包列表... 完成
正在分析软件包的依赖关系树... 完成
正在读取状态信息... 完成
下列软件包是自动安装的并且现在不再需要了：
  ...（中间依赖列表省略）
升级了 0 个软件包，新安装了 0 个软件包，要卸载 0 个软件包，未升级 0 个软件包。

⚠️ 注意：桌面版 Ubuntu 22.04 通常已自带上述工具，重复安装无副作用；服务器版/最小化安装必须先执行，否则下一步导入密钥会报 curl: command not found 或 gpg: command not found。

三、版本选型说明

Beekeeper Studio 官方 apt 仓库的 stable 渠道提供完整历史版本，可用以下命令查看可安装版本（决定「装哪个」与「回滚到哪个」）：

apt-cache madison beekeeper-studio | head -5

实测回显：

beekeeper-studio |      6.1.6 | https://deb.beekeeperstudio.io stable/main amd64 Packages
beekeeper-studio |      6.1.5 | https://deb.beekeeperstudio.io stable/main amd64 Packages
beekeeper-studio |      6.1.4 | https://deb.beekeeperstudio.io stable/main amd64 Packages
beekeeper-studio |      6.1.2 | https://deb.beekeeperstudio.io stable/main amd64 Packages
beekeeper-studio |      6.1.1 | https://deb.beekeeperstudio.io stable/main amd64 Packages

apt-cache policy beekeeper-studio | head -5

实测回显：

beekeeper-studio:
  Installed: (none)
  Candidate: 6.1.6
  Version table:
     6.1.6 500
        500 https://deb.beekeeperstudio.io stable/main amd64 Packages
     6.1.5 500
        500 https://deb.beekeeperstudio.io stable/main amd64 Packages

版本选择结论：

全新安装：直接装 Candidate 指向的最新稳定版 6.1.6（与 GitHub Releases 最新 tag 一致，实查日期 2026-10-20）；
追求稳定：官方 stable 渠道只收录稳定版，beta/rc 不会进入该源；
历史版本对照：v6.1.0 起连接文件夹与只读模式开源进社区版，低于 6.1.0 的版本无这两个社区功能（来源：GitHub v6.1.0 Release Notes，查询日期 2026-10-20）。

四、方案 A：官方 apt 仓库安装（推荐）

4.1 方案说明

官方为 Debian/Ubuntu 维护专属 apt 仓库，安装后可随 apt upgrade 自动更新。这是官方文档给出的首选方式，也是本节实测的主线。整个过程分三步：导入 GPG 签名密钥 → 写入仓库源文件 → 安装。

4.2 导入官方 GPG 密钥并配置仓库

按官方文档原样执行（来源：docs.beekeeperstudio.io/installation/linux/，查询日期 2026-10-20）：

curl -fsSL https://deb.beekeeperstudio.io/beekeeper.key | sudo gpg --dearmor --output /usr/share/keyrings/beekeeper.gpg \
  && sudo chmod go+r /usr/share/keyrings/beekeeper.gpg \
  && echo "deb [signed-by=/usr/share/keyrings/beekeeper.gpg] https://deb.beekeeperstudio.io stable main" \
  | sudo tee /etc/apt/sources.list.d/beekeeper-studio-app.list > /dev/null

实测回显（命令无输出即成功；逐项核对产物）：

file /usr/share/keyrings/beekeeper.gpg
cat /etc/apt/sources.list.d/beekeeper-studio-app.list

实测回显：

/usr/share/keyrings/beekeeper.gpg: OpenPGP Public Key Version 4
deb [signed-by=/usr/share/keyrings/beekeeper.gpg] https://deb.beekeeperstudio.io stable main

配置项说明：

项	值	说明
密钥文件	`/usr/share/keyrings/beekeeper.gpg`	dearmor 后的二进制公钥，`chmod go+r` 保证 apt 可读
源文件	`/etc/apt/sources.list.d/beekeeper-studio-app.list`	只对 Beekeeper 仓库使用这把密钥验签
渠道	`stable main`	稳定版渠道，`apt upgrade` 时自动获得更新

4.3 更新索引并安装

sudo apt update

实测回显（输出节选，实测首尾）：

命中:1 http://archive.ubuntu.com/ubuntu jammy InRelease
...
获取:4 https://deb.beekeeperstudio.io stable InRelease [3,068 B]
获取:6 https://deb.beekeeperstudio.io stable/main amd64 Packages [7,352 B]
...
所有软件包均为最新。

sudo apt install -y beekeeper-studio

实测回显（输出节选，实测首尾）：

正在读取软件包列表... 完成
正在分析软件包的依赖关系树... 完成
正在读取状态信息... 完成
将会同时安装下列软件包：
  ...（依赖包列表省略，含图形运行库与字体包）
下列【新】软件包将被安装：
  beekeeper-studio ...
正在设置 beekeeper-studio (6.1.6) ...
正在处理用于 libc-bin (2.35-0ubuntu3.15) 的触发器 ...

4.4 验证安装

dpkg -l beekeeper-studio | tail -1
which beekeeper-studio
dpkg -L beekeeper-studio | grep -E 'bin|desktop'

实测回显：

ii  beekeeper-studio 6.1.6                              amd64        Cross platform SQL editor and database manager
/usr/bin/beekeeper-studio
/opt/Beekeeper Studio/beekeeper-studio-bin
/usr/share/applications/beekeeper-studio.desktop
/opt/Beekeeper Studio/beekeeper-studio

4.5 启动验证

从桌面应用菜单（Development 分类）点击 Beekeeper Studio，或在终端执行：

beekeeper-studio &

启动成功后应呈现主界面：左侧连接侧栏（+ New Connection 按钮、SAVED 保存连接区、RECENT 最近连接区），中部欢迎区提供 New Connection 与 Import from URL 两个入口，底部状态栏显示 Beekeeper Studio 6.1.6 版本号。

⚠️ 注意：beekeeper-studio 没有实现 --version 命令行开关——在无图形会话的终端执行它会直接报 Missing X server or $DISPLAY（Electron 图形应用特性）。版本以 dpkg -l 输出与应用底部状态栏为准。

五、方案 B：离线 deb 包安装（dpkg -i）

5.1 方案说明

适用于无外网或受限网络的服务器/桌面：先在有网环境下载官方 deb 包，拷贝到目标机器用 dpkg -i 安装。本节用官方 apt 仓库内的同名 deb 做离线安装实测（与 GitHub Releases 提供的 deb 为同一构建产物）。

5.2 下载离线 deb 包

apt-get download beekeeper-studio
ls -la beekeeper-studio_*.deb

实测回显：

获取:1 https://deb.beekeeperstudio.io stable/main amd64 beekeeper-studio amd64 6.1.6 [281,298,876 B]
下载 281 MB，用时 12s (22.8 MB/s)
-rw-r--r-- 1 root root 281298876 Oct  7 22:23 beekeeper-studio_6.1.6_amd64.deb

💡 说明：apt-get download 下载的是仓库当前版本的 deb 原包；也可从 GitHub Releases 页（github.com/beekeeper-studio/beekeeper-studio/releases/latest）下载对应版本资产，文件名形如 beekeeper-studio_6.1.6_amd64.deb。

5.3 卸载现有版本并离线重装

先卸载（已装仓库版时验证离线包可独立重装）：

sudo apt-get remove -y beekeeper-studio
dpkg -l beekeeper-studio | tail -1

实测回显：

rc  beekeeper-studio 6.1.6  amd64  Cross platform SQL editor and database manager

rc 状态表示配置残留但程序已删除。随后用 dpkg 离线安装：

sudo DEBIAN_FRONTEND=noninteractive dpkg -i beekeeper-studio_6.1.6_amd64.deb

实测回显（输出节选，实测首尾）：

Selecting previously unselected package beekeeper-studio.
(正在读取数据库 ... 系统当前共安装有 XXXXXX 个文件和目录。)
准备解压 beekeeper-studio_6.1.6_amd64.deb  ...
正在解压 beekeeper-studio (6.1.6) ...
正在设置 beekeeper-studio (6.1.6) ...
正在处理用于 hicolor-icon-theme (0.17-2) 的触发器 ...
正在处理用于 shared-mime-info (2.1-2) 的触发器 ...

5.4 验证与依赖排障

dpkg -l beekeeper-studio | tail -1

实测回显：

ii  beekeeper-studio 6.1.6  amd64  Cross platform SQL editor and database manager

ii 即安装成功。若 dpkg -i 过程提示依赖缺失（最小化系统可能出现），用以下命令让 apt 自动补齐：

sudo apt-get install -f -y

⚠️ 注意：离线 deb 不包含官方 apt 源配置。想保留 apt upgrade 自动更新，仍需按第四章 4.2 节配置仓库源。

六、方案 C：AppImage 免安装运行

6.1 方案说明

AppImage 是官方推荐的 Linux 分发形态：单文件、免安装、无需 root、支持应用内自动更新，适合没有 sudo 权限或不想改动系统的用户（来源：docs.beekeeperstudio.io/installation/linux/，查询日期 2026-10-20）。

6.2 安装 FUSE 前置

Ubuntu 22.04 起默认不带 FUSE 运行库，AppImage 启动需要 libfuse2（官方文档明确要求）：

sudo apt install -y libfuse2

实测回显（输出节选）：

正在读取软件包列表... 完成
正在设置 libfuse2:amd64 (2.9.9-5ubuntu3) ...

⚠️ 注意：未装 libfuse2 直接运行 AppImage 会报错。实测报错如下（输出节选）：
dlopen(): error loading libfuse.so.2
...
if you run it with the --appimage-extract option.
See https://github.com/AppImage/AppImageKit/wiki/FUSE
for more information
两解法：装 libfuse2（推荐），或用免 FUSE 方式 ./Beekeeper-Studio-6.1.6.AppImage --appimage-extract 解包后运行解压目录内的 AppRun。

6.3 下载并运行

从官方下载页或 GitHub Releases 获取 AppImage（v6.1.6 资产名如下）：

wget https://github.com/beekeeper-studio/beekeeper-studio/releases/download/v6.1.6/Beekeeper-Studio-6.1.6.AppImage
chmod +x Beekeeper-Studio-6.1.6.AppImage
ls -la Beekeeper-Studio-6.1.6.AppImage

实测回显：

-rw-r--r-- 1 root root 369664148 Oct 20 03:35 Beekeeper-Studio-6.1.6.AppImage

赋予执行权限后直接运行：

./Beekeeper-Studio-6.1.6.AppImage &

启动后与 deb 版完全一致的主界面出现（窗口标题 Beekeeper Studio - Free Version）。进程层面可见 AppImage 挂载点内的主程序：

ps aux | grep [b]eekeeper-studio-bin | awk '{print $11}'

实测回显（AppImage 挂载点路径，每次启动随机挂载目录名）：

/opt/Beekeeper Studio/beekeeper-studio-bin

6.4 桌面集成（可选）

希望 AppImage 出现在系统应用菜单，可安装 AppImageLauncher 并在首次运行时选择「Integrate and run」（来源：官方 Linux 安装文档推荐做法）。不集成也可为文件建立桌面快捷方式，指向 AppImage 完整路径。

七、方案 D：Snap 安装

7.1 方案说明

Beekeeper Studio 发布在 Snap Store（snapcraft.io/beekeeper-studio），Ubuntu 16.04+ 预装 snapd。官方同时提示：受 Snap 安全模型限制，Snap 版部分功能不可用（详见 7.4 节）。

7.2 确认 snapd 并安装

snap version | head -2

实测回显：

snap    2.76.3+ubuntu22.04.1
snapd   2.76.3+ubuntu22.04.1

sudo snap install beekeeper-studio

实测回显：

beekeeper-studio 6.1.6 from Beekeeper Studio (matthew-rathbone) installed

7.3 验证安装

snap list beekeeper-studio

实测回显：

Name              Version  Rev  Tracking       Notes
beekeeper-studio  6.1.6    536  latest/stable  -

snap info beekeeper-studio | grep -A3 'stable:'

实测回显：

  latest/stable:    6.1.6 2026-10-07 (536) 446MB -
  latest/candidate: ^
  latest/beta:      ^
  latest/edge:      6.1.6 2026-10-07 (536) 446MB -

Snap 版安装位置在 /snap/beekeeper-studio/current/（内含 app、etc、meta、snap、usr 目录），从应用菜单或 snap run beekeeper-studio 启动。

7.4 Snap 版功能授权

官方文档提示 Snap 安全模型带来的两个限制（来源：docs.beekeeperstudio.io/installation/linux/，查询日期 2026-10-20），使用 SSH 隧道功能前需手动授权 .ssh 目录访问：

sudo snap connect beekeeper-studio:ssh-keys :ssh-keys

实测执行成功（接口连接成功无输出）。另注意：

SSH Agent 不可用：Snap 沙箱无法访问用户 SSH Agent，依赖 agent 转发的用户建议改用 deb 或 AppImage 版；
字体渲染：Gnome 3.38+ 下 Snap 版文件选择器可能出现字体渲染异常，官方建议遇此问题改用 AppImage 版。

八、方案对比与选择建议

四种方案的实测对照：

维度	A 官方 apt 仓库	B 离线 deb	C AppImage	D Snap
需要联网	配置时一次	仅下载机	仅下载	安装时
需要 root	是	是	否	是
安装体积	约 281MB（deb）	约 281MB	约 352MB	446MB
自动更新	apt upgrade	无（需手动重装）	应用内自动更新	snap refresh
SSH Agent	✅	✅	✅	❌ 沙箱限制
SSH 密钥访问	✅ 默认	✅ 默认	✅ 默认	需 `snap connect` 授权
多版本并存	可装历史版本（=版本号）	手动管理	保留多个文件即可	仅一个版本（渠道切换）
适用场景	长期使用的桌面机	断网环境部署	无 root/免安装/便携	习惯 Snap 生态的用户

选择建议：日常桌面机选 A（apt 仓库，更新无感）；无 root 或想随身携带选 C（AppImage，官方推荐形态）；内网隔离环境选 B（离线 deb）；已在用 Snap 生态选 D，但需接受 SSH Agent 缺失。本章四种方案均指向同一版本 6.1.6，功能主体一致。

九、安装后配置说明

9.1 启动旗标文件 bks-flags.conf

Beekeeper Studio 支持通过 ~/.config/bks-flags.conf 传入 Electron/Chromium 启动旗标，每行一个（来源：官方 Linux 安装文档，查询日期 2026-10-20）。最常用的场景是 Wayland 原生模式与分数缩放：

touch ~/.config/bks-flags.conf
echo "--ozone-platform-hint=auto" >> ~/.config/bks-flags.conf
echo "--enable-features=UseOzonePlatform" >> ~/.config/bks-flags.conf

Wayland 下出现颜色异常（橙色偏黄、灰色发黑）时，官方给出修复旗标：

echo "--disable-features=WaylandWpColorManagerV1" >> ~/.config/bks-flags.conf

修改后重启 Beekeeper Studio 生效。X11 用户无需配置此文件。

9.2 用户数据目录

首次启动后生成 ~/.config/beekeeper-studio/ 目录，保存连接、查询历史与应用设置。备份该目录即可整体迁移配置到新机器；删除该目录即恢复出厂状态。目录结构与配置文件详解见本专栏《Beekeeper Studio 6.1.6 配置与 CLI 参数详解》。

9.3 应用级配置文件

应用内置三层 ini 配置：安装目录 resources/default.config.ini（默认值）→ system.config.ini（系统覆盖）→ user.config.ini（用户覆盖），控制界面行为、连接池与快捷键等。逐项参数说明见本专栏《Beekeeper Studio 6.1.6 配置与 CLI 参数详解》。

十、常见问题（FAQ）

Q1：启动报 error while loading shared libraries: libgbm.so.1？

最小化安装/服务器版桌面组件不全导致（实测报错如下）：

/opt/Beekeeper Studio/beekeeper-studio-bin: error while loading shared libraries: libgbm.so.1: cannot open shared object file: No such file or directory

补齐 Electron 运行库即可（桌面版 Ubuntu 通常已自带）：

sudo apt install -y libgbm1 libgtk-3-0 libnss3 libasound2 libxss1 libxtst6 \
  libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 \
  libxdamage1 libxrandr2 libpango-1.0-0 libcairo2

实测补装后应用可正常启动。

Q2：终端执行 beekeeper-studio --version 报 Missing X server or $DISPLAY？

这是正常现象：该命令行未实现版本开关，程序按图形应用启动。版本确认用 dpkg -l beekeeper-studio（deb/apt 版）、snap list beekeeper-studio（Snap 版）或应用底部状态栏。远程 SSH 会话里想验证 GUI，需在本机桌面终端运行，或配置 X11 转发。

Q3：apt update 报 GPG 签名校验失败（NO_PUBKEY）？

多为密钥文件权限或路径不对。按 4.2 节重新执行密钥导入命令，并确认 /usr/share/keyrings/beekeeper.gpg 存在且 go+r 权限已加（file 命令应显示 OpenPGP Public Key）。不要用 apt-key add 老方式，Ubuntu 22.04 已弃用。

Q4：如何降级到旧版本？

apt 版直接指定版本号安装（实测从 6.1.6 降级到 6.1.5 再升回）：

sudo apt install -y --allow-downgrades beekeeper-studio=6.1.5
dpkg -l beekeeper-studio | tail -1

实测回显：

ii  beekeeper-studio 6.1.5  amd64  Cross platform SQL editor and database manager

升回最新：

sudo apt install -y beekeeper-studio=6.1.6

AppImage 版保留旧版本文件即可随时切回；Snap 版不支持同渠道降级，只能等待渠道内版本更新。

Q5：Snap 版连不上 SSH 隧道？

先执行 sudo snap connect beekeeper-studio:ssh-keys :ssh-keys 授权密钥目录访问（见 7.4 节）；若依赖 ssh-agent，Snap 沙箱无法访问，请改用 deb 或 AppImage 版本。

Q6：Flatpak 版打不开本地 SQLite 文件（Permission denied）？

Flatpak 沙箱默认限制文件系统访问，按官方文档放行：

sudo flatpak override io.beekeeperstudio.Studio --filesystem=host

十一、卸载与清理

按安装方式对应卸载（命令均已实测）：

# 卸载 apt/deb 版
sudo apt-get purge -y beekeeper-studio

实测回显（输出节选）：

正在读取软件包列表... 完成
正在卸载 beekeeper-studio (6.1.6) ...
正在清除 beekeeper-studio (6.1.6) 的配置文件 ...

# 卸载 Snap 版
sudo snap remove beekeeper-studio

实测回显：

beekeeper-studio removed

# AppImage 版：直接删除文件
rm -f ~/Beekeeper-Studio-6.1.6.AppImage

清理用户数据（连接、查询历史与全部个人配置，删除后应用回到首次启动状态）：

rm -rf ~/.config/beekeeper-studio ~/.config/bks-flags.conf

清理 apt 仓库源（不再使用官方仓库时）：

sudo rm /etc/apt/sources.list.d/beekeeper-studio-app.list
sudo rm /usr/share/keyrings/beekeeper.gpg
sudo apt update

十二、参考链接

官方 Linux 安装文档：https://docs.beekeeperstudio.io/installation/linux/
官方下载页：https://www.beekeeperstudio.io/
GitHub Releases：https://github.com/beekeeper-studio/beekeeper-studio/releases
Snap Store 页面：https://snapcraft.io/beekeeper-studio
本专栏姊妹篇：《Beekeeper Studio 6.1.6 介绍与选型指南》、《Beekeeper Studio 6.1.6 数据库连接与操作实战》、《Beekeeper Studio 6.1.6 配置与 CLI 参数详解》